交接档案
README · 小手机（猫爪聊天）交接索引
生成时间：2026-10-27 00:45（北京时间） 生成方式：只读整理。未修改任何代码、未部署、未写入/迁移/删除任何生产数据。 适用对象：接手本项目的新 AI / 开发者。
1. 这份档案是什么
把 2026-10-05 ~ 10-27 的全部可访问历史（对话摘要、任务书、源码、提交、测试、部署、数据面）整理成 10 个文件，让接手者尽量不需要再问用户「以前做过什么」。
它不是：项目宣传稿、完整源码包、或对未来的承诺。它是「现状 + 历史 + 坑 + 待办」的底账。
2. 阅读顺序
| 顺序 | 文件 | 什么时候读 |
|---|---|---|
| 1 | README_交接索引.md（本文） |
先读，知道资料边界 |
| 2 | 01_项目总览与长期目标.md |
建立全貌：是什么、要变成什么 |
| 3 | 04_技术架构与当前代码基线.md |
知道代码怎么跑、数据在哪 |
| 4 | 07_问题风险与失败经验.md |
动手前必读：哪里会炸、哪些事别重做 |
| 5 | 03_任务清单与真实进度.md |
知道做到哪、哪些只是雏形 |
| 6 | 05_长期记忆与收藏系统历史档案.md |
要动记忆/删除/检索时必读 |
| 7 | 06_决策记录与版本变化.md |
想知道「为什么是这样」时查 |
| 8 | 02_历史需求与设计构想.md |
要还原原始需求、找「提过但没做」的东西 |
| 9 | 09_缺失资料与待确认事项.md |
准备问用户之前先看，避免重复问 |
| 10 | 08_下一阶段执行路线.md |
决定要开工时按它排期 |
3. 文件清单与作用
| 文件 | 内容 | 关键结论 |
|---|---|---|
01_项目总览与长期目标.md |
项目是什么、最初需求、12 项长期目标、三端入口、状态快照 | 三端跑同一份修复版；数据四份副本 |
02_历史需求与设计构想.md |
按主题整理的全部需求（UI/安全/任务书/记忆/托管）+ 禁止事项 + 提过没做的 | 阶段 5–9 全未开始 |
03_任务清单与真实进度.md |
30+ 任务的状态、证据、缺口 | 只有 Mock 测试，无生产 E2E |
04_技术架构与当前代码基线.md |
仓库/文件/构建链/路由/键位/三端配置/数据量/测试/成本 | v1 = 历史主库；v2 = 全新空库 |
05_长期记忆与收藏系统历史档案.md |
记忆五代演进、当前实现、设计差距、必须保留的约定 | 双写 mem:+msg: 是最大冗余 |
06_决策记录与版本变化.md |
20 条决策（区分用户确认/AI 建议）+ 版本时间线 + 冲突 | v2 空库是设计，不是故障 |
07_问题风险与失败经验.md |
14 个事故档案（含根因与教训）+ P0–P3 风险 + 别重做的清单 | P0 三项：寻址分裂、删不彻底、令牌公开 |
08_下一阶段执行路线.md |
阶段 0/A–F 的依赖排序、验收、回滚、审批 | 先止血，再修数据，最后做阶段 5–9 |
09_缺失资料与待确认事项.md |
资料三分类、冲突、要用户补的材料、7 个待确认决定 | 先定「主数据源」与「279 条删不删」 |
4. 资料来源与核实等级
4.1 实际读取过
- 本会话全部对话 + 30 个阶段压缩摘要（覆盖 10-05 ~ 10-25）
/root/uploads/的任务书 v1.0（27KB）与原始前端v6.html（56KB）worker.js全文、index.html全部逻辑区、deploy-web/*全文、build.js、两份 wrangler 配置tests/10 个文件（说明与断言数）、tools/关键行小手机-完整交付文档.md、任务交接说明.md、模块索引.md、安全说明.md、修复记录-P0-P1.md、国内版落库迁移方案.md、小手机-全新后端环境说明.md- 国内版 SQLite（只读查询）、v1/v2 KV（抽样读）、Cloudflare API（worker/secret/bundle）、国内版
/与/health
4.2 知道存在但未读全
猫爪聊天-完整项目.md（304KB）、handoff-public.md / 小手机-交接-公开版.md（40KB×2）、替换指南.md、给其他AI-代码包/、小手机-审计草案/01–04、17 张截图、小手机交接/index.html。
4.3 无法访问
GitHub 远端实时状态、Cloudflare 线上日志、KV 精确键列表（配额耗尽）、secret 明文、用户浏览器数据、平台控制台、10-22 之前的逐字对话（仅存摘要）、部分已过期的截图链接。
4.4 证据标注
【源码】读代码可得【测试】本地跑过（Mock，不等于线上）【部署】线上版本已确认【实测】我亲自执行并取得结果【线上核验】通过 Cloudflare API / 线上页面核对【推断】有间接证据但未闭环【未验证】无证据【待确认】需用户拍板
5. 三句话结论
- 代码是好的，架构有三处硬伤：前后端两套寻址规则（聊天走设置、记忆走同源）、消息存两份但只删一份、页面公开下发令牌。
- 数据是散的：v1 KV（历史主库，含 279 条软删）、v2 KV（全新空库）、国内版 SQLite（307 条导入+13 条新聊）、每台浏览器 IndexedDB（图只在这），四份互不同步。
- 长期目标只完成了前四阶段：阶段 5 人设版本、6 成长分析、7 后台、8 沈屿迁移、9 清理，全部未开始。
6. 交接时的最小动作清单
接手者第一小时建议只做这些（全部只读）：
cd /workspace/chat
git log --oneline -20
git status
ls -la
wc -l worker.js index.html build.js deploy-web/server.js deploy-web/kv-sqlite.js
然后：
- 读 01 → 04 → 07；
- 用 Cloudflare API 核对 v1/v2 线上版本（不要
wrangler deploy）； - 用只读方式查国内版
GET /health； - 把
09里的三个问题问用户； - 得到答复后再看
08，不要直接开工。
7. 红线（写在这里，防止新 AI 一上来就踩）
- 不改用户没点名的区域；不重构、不改 UI 风格。
- 不手工编辑
cat-chat-all-in-one.js；改完worker.js/index.html必须node build.js。 - 不部署、不清库、不改密钥，除非用户明确说「可以」。
- 不批量删除；任何清理 ≤200 条/批、先导出、跨天做。
- 不把「Mock 测试通过」说成「线上可用」。
- 不把 AI 的建议写成「用户已同意」。
- 不在文档里写任何真实密钥/令牌/密码。
本页由交接包内的 Markdown 原样转换；内容未改动。源码与完整包请回目录页下载。