04 · 技术架构与当前代码基线

基线时间：2026-10-27 00:45 ｜ 只读核实，未改任何代码 金额/配额口径：Cloudflare Workers 免费版 KV = 每天 1000 次 list、1000 次写、10 万次读（账户级，北京时间 08:00 重置）

1. 仓库与工作区

2. 文件与职责

3. 构建链

index.html ─┐
            ├─ node build.js ─► cat-chat-all-in-one.js ─┐
worker.js ──┘                                           ├─ wrangler deploy (v2)  → zhai-v2
                                                        └─ wrangler deploy --config wrangler.v1.toml → zhai

index.html ──► deploy-web/server.js 运行时读取（注入令牌/WEB_MODE/sharecode 垫片）
worker.js ──► cp 成 deploy-web/worker.mjs ──► Node 动态 import

已知脆弱点： - wrangler deploy --config wrangler.v1.toml 不会自动构建 → 忘记 node build.js 就部署旧产物； - deploy-web/worker.mjs 没有自动同步步骤（当前一致，靠人工）； - worker.js 单独 import 会因 serveFrontend 未定义在 GET / 时报错。

4. 运行时拓扑

┌──────────────── 浏览器（手机） ────────────────┐
│ index.html（单页，内联 CSS/JS）                 │
│ localStorage：设置/外观/模型 Key/worker_url     │
│ IndexedDB(cat_chat_db/kv)：聊天记录、设备快照    │
└───────┬─────────────────────────────┬──────────┘
        │ 聊天：CONFIG.WORKER_URL      │ 记忆/档案/删除：相对路径（同源）
        ▼                             ▼
┌──────────────────┐          ┌──────────────────────┐
│ Cloudflare Worker │          │ Node 垫片(server.js)  │
│ v1: zhai          │          │ + SQLite(/tmp/...db)  │
│ v2: zhai-v2       │          │ 复用同一 worker.js    │
└────────┬──────────┘          └──────────┬───────────┘
         ▼                                ▼
   Cloudflare KV                    SQLite（WAL）
   v1 ec1a / v2 0a4c                652 键
         │
         ▼
   大模型 API（OpenAI 兼容，Key 由前端提供 → Worker 代理）

5. 路由表（worker.js，三端共用）

6. KV / SQLite 键位图

<profile> 默认 owner，校验 ^[a-z0-9_]{1,32}$。

7. 三端配置现状（值已脱敏）

8. 数据面（截至 2026-10-27 00:45）

8.1 国内版 SQLite（/tmp/cat-chat-data/chat.db，652 键）

被删状态：320 条中 279 条带 deleted_at（10-23 22 点 68 条、10-24 13 点 211 条），有效 41 条。 迁移来源：307 条的 mid 前缀 = local_ 217 / c_ 44 / a_ 39 / u_ 7 → 大多数来自本机历史的「云端同步」上传，不是服务端实时聊天记录。 时间跨度：2026-10-14 02:40 → 2026-10-25 22:37。

8.2 Cloudflare KV

精确键数无法枚举：免费版 list 配额已耗尽（code 10048），REST keys 同样被拒。以上为抽样结论，不是全量统计。

8.3 浏览器

每一台设备各有一份 IndexedDB（cat_chat_db/kv，键 messages），含图片 base64；云端不存图。

9. 测试覆盖

未覆盖：CORS 跨源、令牌注入、WORKER_URL 覆盖、三端联调、真实上游、浏览器 E2E、配额恢复后的行为。

10. 依赖与成本

11. 与原设计的偏差