📌 待办聚合¶
⚙️ 本文件由
pnpm docs:rebuild自动生成 — 手改无效。 数据源:扫所有 frontmatter 的status字段,未完结的全在这。
当前总数:24 条待办(specs 18 / issues 3 / raw 3)
如何登记新待办¶
详见 rules/todo-registration.md。简版:
| 想做但先不做的是什么 | 去哪 |
|---|---|
| 大功能 / 需要设计 | specs/active/SPEC-XXX.md (draft → approved → in-progress) |
| 评估后暂缓的大功能 | specs/parked/(写 parked 理由) |
| 已知 bug 但没修 | issues/XXXX-*.md 加 status: in-progress |
| 反复出现的坑 | issues/XXXX-*.md 加 status: recurring |
| 现象在但根因未明 | issues/XXXX-*.md 加 status: observing |
| 用户提的小想法 | raw/inbox/YYYY-MM-DD-xxx.md(不立刻评估) |
| 灵感 / 未来可能做 | raw/ideas/YYYY-MM-DD-xxx.md |
🎯 specs 待办(18)¶
🔧 进行中(3)¶
- SPEC-008 文档与功能同步治理升级 — 目标版本
v0.10.125 - 用产品文档试点、显式 Docs-Impact 声明和只读门禁降低功能与文档漂移
- — 整页 Markdown 本地存储与上传契约 —— 给后端开发的接口需求 — 目标版本
0.10.138 - 本地 PageMarkdown 表已落地;上传通道待后端,客户端只留接口面不接线
- — 插件内置 AI —— 关键词分析 + 商家匹配度 — 目标版本
v0.13.1(自带 Key 直连) - 用户自带 Key 直连厂商;新增账号/同步模型/测试;多提示词
✅ 已批准(待开工)(2)¶
- SPEC-004-Phase3-API SPEC-004 Phase 3 — 云端 API 契约(客户端先就绪 / 服务端待实现) — 目标版本
v0.10.95 (client) / TBD (server) - — SPEC-027 「采到多少」的唯一事实源与物化投影 — 目标版本
— - 换基元——组合行状态为唯一事实源,显示端只读物化投影,读不到即未知
📝 草稿(待评审)(12)¶
- — SPEC-007 — 抓取响应快照(FetchSnapshots)云端共享协议 — 目标版本
v0.10.121 (客户端) + future (服务端) - 命中反爬/可疑响应时记录前 N 字符;本地分析 + 未来上传服务端聚合派生新规则
- SPEC-010 当前缺陷止损清单(SPEC-009 的实施前置) — 目标版本
TBD - 当前代码正在生效的破坏 + 14 项规则裁决;SPEC-009 落地前必须先止血的部分
- — 云端同步身份模型与契约实现差距 — 目标版本
— - 两套并存云端通道、契约与实现的差距清单、身份绑定移交开发说明
- — 电话三阶段管线 —— 识别 / 格式规范化 / 固话手机分类 — 目标版本
TBD - Tony 提出的三阶段架构,三路对抗后的选型结论与落地顺序
- — ContactPool 云端合并契约 —— 给后端开发的接口需求 — 目标版本
待定 - 客户端已锁死本地优先;要让云端数据回流,后端需提供三样东西
- — 社区共享接口并入来发信主 API —— 给服务端的实现清单 — 目标版本
TBD(服务端实现后客户端半天接线) - 服务端实现 8 个端点(含 health),砍匿名身份 —— 客户端 ensureAuth 必须同批改
- — 插件内收发邮件 —— 走 IMAP/SMTP 中转(Tony 定案) — 目标版本
TBD - 不走 OAuth 走 IMAP/SMTP;代价从「审核周期」换成「凭据托管 + 服务器 IP 声誉」
- — 集成 WhatsApp —— 扫码登录与凭据迁移的真实代价 — 目标版本
TBD(Tony 2026-09-17:先梳理不做) - 三条技术路径、凭据迁移为什么最危险、封的是用户的号不是你的服务
- — 跨渠道知识库 —— 把采集、邮件、WhatsApp、官网正文喂给 AI — 目标版本
TBD(Tony 2026-09-17:先梳理不做) - 这是前面所有功能的归宿,也是唯一越用越值钱的那部分
- — 把插件的数据做成 MCP —— 让 Claude / Codex 直接查 — 目标版本
TBD(Tony 2026-09-17:先梳理不做) - 扩展开不了监听端口,三条可行路径;最小可行只要几十行,不用动扩展架构
- — Contact 数据池重做 —— 让它讲得清、省得出、上得了线 — 目标版本
— - 不改存储模型,改「用户看得见什么」;补淘汰与首同步分批
- — SPEC-025 组合表 —— 把「关键词 × 地区」提升为一等实体 — 目标版本
— - Tony 指出该用表而非 storage;这是前三轮方案反复撞墙的病根;跳过要带时间窗且默认关
⏸️ 暂缓(1)¶
- SPEC-005 SPEC-005 — React 前端 lifecycle 系统性扫描 + 修复 — 目标版本
TBD - 334 处 useEffect/setState 全量审 — 找裸异步、unmount race、setState-on-unmounted;分 3 期推进
🔧 issues 待办(3)¶
👁️ 观察中(根因未明)(3)¶
- 0093-unreachable-results-and-settings-windows.md — results / settings 两个独立窗口入口不可达,仍打包进扩展(severity: low)
- 0148-source-inferred-flag-order-dependent.md — sourceInferred 随来源处理顺序变化 —— 行级布尔压不住 per-source 的语义(severity: low)
- 0223-large-db-full-mode-dual-scrollbar-and-pagination-unpinned.md — 大库完整模式双滚动条回归 + 数据页分页不钉底 — 0069 翻档条款首触发(severity: high)
🗒️ raw 未处理(3)¶
用户原话已归档但未评估去向(→ spec / wiki / issue / discarded)。
inbox/(3)¶
2026-10-02AI 配置「自动同步到云端」归属与形态质疑2026-09-20获取 DeepSeek Key 的引导链接现在借用 ZCode 的,需要写地图版2026-05-28嵌套滚动条又出现 — 截图位置未标注,待复现
给 AI 的提示¶
- 新会话开始 → 先看本文件,了解当前未完事项
- 用户提到「以前提过的XX」 → 在这里搜(specs/issues/raw 都包含)
- 完成一项 → 改对应文件的
status(issue 改 fixed / spec 移 done/ / raw 改 spec-ed)→ 跑pnpm docs:rebuild - 新增小待办 → 优先去
raw/inbox/粘贴(不需要立刻评估)