《捡手机》是一个可以通过 AI 添加剧情的交互式虚拟手机框架。你不需要重新制作手机界面，只需要准备人物设定、聊天记录和剧情要求，让 AI 填入故事数据。
默认打开完整 App 测试预览：49 个 App 已安装，内页只有中性的测试文字，不含剧情或真实账号。桌面底部为四个 App。/?preview=test 也可进入相同测试版本；纯空白入口为 /?template=blank。
- 使用现成的锁屏、桌面、App Store、通知、控制中心和手机 App 页面。
- 长按桌面调整图标、文件夹和小组件；在手机 App Store 中选择安装 App。
- 添加微信、KakaoTalk 聊天，以及 Instagram、X 等社交内容。
- 添加联系人、照片、备忘录、通知、模拟来电、密码、互动选项和多个结局。
- 通过事件连接不同 App，并在浏览器中保存玩家进度。
- 生成静态网站，分享给朋友；首次加载并完成缓存后，核心剧情可离线运行。
App 库目前有 49 个注册入口。各 App 的页面覆盖不同，并非真实服务客户端，也不代表所有功能或界面均已完整还原。
- 登录 GitHub。
- 打开本项目仓库，点击右上角 Fork，复制到自己的账号。若已启用模板，也可以选择 Use this template。
- 用支持读取和修改项目的 AI 编程工具打开自己的副本，例如 Codex、WorkBuddy 或 Claude Code。
- 复制下面的提示词，把故事发给 AI。让它先阅读
AGENTS.md，优先修改stories/template/story.json。 - 请 AI 启动预览，亲自测试聊天、密码、电话和每个结局。
- 按部署教程发布网页。
- 把生成的网址分享给朋友。
我想基于《捡手机》制作自己的互动手机故事。请先指导我 Fork 原仓库，在我的 Fork 中阅读 AGENTS.md 和剧情脚本规范，然后根据下面的故事内容自动生成角色、聊天、App 数据、时间线和剧情事件，运行校验并修复错误。尽量只修改故事数据，不要重写手机 UI。我的故事是：【填写故事】。
也可以提供图片、聊天记录和具体触发要求。请只使用你有权公开的素材，不要提交真实账号密码或私人聊天。
先安装 Node.js 22，然后在项目目录执行：
npm ci
npm run story:validate
npm run story:test
npm run story:preview打开终端显示的本地网址。正式构建：
npm run build
npm run preview上传 dist/ 的内容即可部署。不能直接双击 HTML 文件运行。
默认故事位于 stories/template/story.json；纯空白手机位于 stories/blank/story.json，可用 /?template=blank 查看。你可以替换演示数据，也可以通过环境变量 STORY_FILE 选择其他作品。故事数据与界面代码分离，作品运行时不需要 AI 在线。
| 桌面 | 设置 | 聊天 |
|---|---|---|
 |
 |
 |
不会写代码怎么办？ 把上面的提示词和故事发给能够修改项目文件的 AI。普通聊天工具若无法访问文件，需要你手动保存它生成的脚本。
为什么没有全部 App？ 新手机只安装少量 App。打开手机里的 App Store 获取其他 App；作者也可以在脚本的 installedApps 中配置。
为什么修改后还看到旧进度？ 玩家存档与故事分开保存。剧情有较大变化时，让 AI 增加脚本的 revision，再重新构建。
数据保存在哪里？ 玩家进度保存在当前浏览器。换浏览器、清理网站数据可能导致进度丢失；源码 ZIP 不包含浏览器存档。
能直接填写自然语言吗？ 自然语言由创作阶段的 AI 转成 JSON。框架本身不在运行时调用模型，也不会自动执行脚本中的 HTML 或 JavaScript。
Fork 后如何上线？ 见GitHub Pages 教程。首次需要在自己仓库中启用 Actions 和 Pages。
验证命令：npm run typecheck、npm run lint、npm test、npm run story:validate、npm run story:test、npm run build。浏览器回归使用 npm run test:e2e。
项目许可见 LICENSE。故事与素材的权利由其作者确认。安装、启动和构建不会自动 Fork、Star 或推送仓库。