电子姬舞台 · 官方例子
一张完整的舞台卡（galgame「电子姬的同居日常」，卡 dzj-stage-example），用 npm 上的舞台 SDK（@dianziji/stage 等）做成。
从这里起步：跑起来看它能做到什么，再把游戏换成你自己的。
React 19 + Vite + Tailwind CSS v4。电脑、手机都适配（只做竖屏）。
舞台＝一张卡的画面：AI 照常按卡的提示词和分区写剧情，舞台把分区渲染成画面，聊天、存档、计费都走电子姬平台。舞台是网站页面里的一个 iframe，和网站之间只靠 postMessage 说话（舞台桥），不连后端、没有凭证。
三分钟跑起来
-
npm install
npm run dev
- 网站上进入你的卡（新游戏走完开场），工具行 「开发」→ 本地开发，填
http://localhost:5173 开启。
- 网站里这张卡的舞台就换成了你本机的页面，改代码立刻热更新。聊天、存档、换模型、MOD 都是网站真实那一套。（只认本机地址；直接打开 localhost 会提示「请在网站里打开」。）
★例子的代码是照着官方例子卡的分区和存档结构写的。用自己的卡跑，先照 官方例子卡 建好 8 个分区、把 src/game/state.schema.json 粘进编辑器「舞台 → ② 存档结构」，不然对话框是空的。上线：npm run pack 生成 stage.zip；目前由平台管理员上传（把 zip 和卡 id 发给管理员），见 上线。
目录
开发手册（docs/）
用 AI 开发
- AGENTS.md：给 AI 的总规则（开工流程、铁律、技能索引）。Claude Code 读
CLAUDE.md（就是引用它）。
- .claude/skills/：分主题的开发技能（流程、React、适配、素材、性能、游戏逻辑、播放设置、上线、踩过的坑）。
项目结构
src/ 你的游戏（只改这里和 public/）
docs/ 开发手册
.claude/skills/ AI 开发技能
AGENTS.md AI 总规则
舞台 SDK 是 npm 包（@dianziji/stage、@dianziji/stage-panel…，npm install 装进 node_modules/，源码在 dzj-stage-sdk）。怎么查 API、怎么升级见 docs/sdk.md。
命令
| 命令 | 作用 |
|---|
npm run dev | 本地开发（在网站里打开：工具行「开发」→ 本地开发） |
npm test | 游戏自己的测试 |
npm outdated / npm update | 看 SDK 有没有新版 / 升到范围内最新（见 docs/sdk.md） |
npm run lint | 代码检查 |
npm run pack | 打包成 stage.zip（加载页底部显示构建号 BUILD 时间戳）。注意是 npm run pack，不是 npm 自带的 npm pack |
版权
本仓库（官方例子、舞台协议与文档、美术与音频素材）和舞台 SDK（@dianziji/stage 等）是电子姬的专有软件，不是开源软件。
只允许用来给电子姬平台上的卡开发舞台、并在电子姬平台发布；不得用于其他网站或产品，不得再分发、转售，不得照着舞台协议给别的平台做兼容实现。详见 LICENSE。
