给 Claude Code 的项目导航。SullyOS 是装在浏览器里的虚拟手机系统（React + TS + Vite，local-first，IndexedDB 存储）。详细介绍见 README.md。
这份文件只做一件事：告诉你遇到某类问题该去翻哪份文档，别在代码里瞎逛。
包管理器统一用 pnpm：装依赖
pnpm install、跑测试pnpm vitest run、跑脚本pnpm <script>。别用 npm / yarn（仓库里是pnpm-lock.yaml）。
| 主题 | 文档 | 什么时候看 |
|---|---|---|
| 开发调试面板 / 开关 | docs/dev-debug.md |
加 dev-only 开关、加调试日志、排查"角色怎么又不说话了"。含逐步指南 |
| 记忆系统 | docs/memory-system-overview.md |
涉及长期记忆、月度总结、向量化记忆宫殿、情感空间。改记忆相关逻辑前必读 |
| Instant Push SSE↔Push 契约 | docs/instant-push-dual-channel.md |
改 instant push 路径或排查「报错但收到消息」类 bug 前必读。SSE ≠ 送达判定通道、catch 不能直接判 send-failed |
| Instant Push 通道 | docs/instant-push-branch-notes.md、worker/instant-push/README.md |
LLM-driven Web Push、worker 端 agentic loop / reasoning / 副作用 directive |
| 二改 / 加 App / 数据流 / 后端 Worker | README.md 「给想二改的人」一节 |
新增 App、build badge、sfworker 代理替换、开源协议 |
README 的「给想二改的人」区域信息量很大（数据流、ContextBuilder、Instant Push Phase 2、sfworker 清单），动后端 / 加功能前先扫一遍。