跳转至

Specs(功能规格)

介于 raw(原始想法) 和 wiki(已实现的沉淀) 之间的工程契约层。 这是多人协作的核心交付物 — 后端/前端打开就知道做什么。

子目录

路径 含义
active/ 正在开发的 spec — status: approved / in-progress
done/ 已实现的 spec — status: done(保留作历史,连同 wiki 更新一起看)
parked/ 评估后暂缓的 spec — status: parked,含暂缓理由

命名约定

SPEC-<3位数序号>-<中文短标题>.md

例: - SPEC-001-knowledge-base-refactor.md - SPEC-002-定时导出Excel.md - SPEC-003-多账号管理.md

序号全局唯一、永不重用。状态变化时只动 status frontmatter,不动文件名。

当前 spec

🚀 Active

ID 标题 状态 负责人 目标版本
SPEC-007 抓取响应快照(FetchSnapshots)云端共享协议 draft tony v0.10.121(客户端)+ future(服务端)
SPEC-008 文档与功能同步治理升级 in-progress tony v0.10.125

✅ Done

ID 标题 完成版本 链接
001 知识库改造(raw+specs+frontmatter) v0.10.22 SPEC-001
002 Watchdog 核弹重启后自动恢复 v0.10.23 SPEC-002

💤 Parked

ID 标题 暂缓理由
— — —

状态流转

                  ┌──> parked(评估后暂缓 / 优先级低)
                  │
draft ─> approved ─> in-progress ─> done
  ↑          ↑
来源 raw   团队评审
状态 含义 谁能改
draft 起草中,待评审 作者
approved 评审通过,准备开干 团队
in-progress 正在实现 实施者
done 已完成 + wiki 已更 实施者
parked 暂缓(标明理由) 作者 / 团队

多人协作工作流

1. 需求来源 → docs/raw/inbox/ 或 docs/raw/feedback/
2. 评估通过 → 用 _template.md 起手写 SPEC-XXX,存到 active/
   - 后端关注:数据模型 / API 接口 / 后端任务
   - 前端关注:UI 设计 / 前端任务
3. 实施 → 按任务拆分推进,frontmatter 改 in-progress
4. 完成 → 移 done/ + 更新 wiki/ + 关联 issues 中遇到的 bug

与 issues / wiki 的边界

层 时间维度 关注
specs 要做什么(未来 / 进行中) 数据模型 + API + 任务拆分
issues 修过什么(过去) 根因 + 修法 + 教训
wiki 是什么(当前事实) 架构 + 字段语义 + 组件用法

一个新功能的全生命周期:

raw/feedback/  →  specs/active/  →  实现  →  specs/done/
                                            ↘ wiki/  更新架构
                                            ↘ issues/ 实施中的 bug

全部 specs(按 status)

draft

ID 标题 目标版本 链接
— SPEC-007 — 抓取响应快照(FetchSnapshots)云端共享协议 v0.10.121 (客户端) + future (服务端) 打开
— 云端同步身份模型与契约实现差距 — 打开
— 电话三阶段管线 —— 识别 / 格式规范化 / 固话手机分类 TBD 打开
— ContactPool 云端合并契约 —— 给后端开发的接口需求 待定 打开
— 社区共享接口并入来发信主 API —— 给服务端的实现清单 TBD(服务端实现后客户端半天接线) 打开
— 插件内收发邮件 —— 走 IMAP/SMTP 中转(Tony 定案) TBD 打开
— 集成 WhatsApp —— 扫码登录与凭据迁移的真实代价 TBD(Tony 2026-09-17:先梳理不做) 打开
— 跨渠道知识库 —— 把采集、邮件、WhatsApp、官网正文喂给 AI TBD(Tony 2026-09-17:先梳理不做) 打开
— 把插件的数据做成 MCP —— 让 Claude / Codex 直接查 TBD(Tony 2026-09-17:先梳理不做) 打开
— Contact 数据池重做 —— 让它讲得清、省得出、上得了线 — 打开
— SPEC-025 组合表 —— 把「关键词 × 地区」提升为一等实体 — 打开
SPEC-010 当前缺陷止损清单(SPEC-009 的实施前置) TBD 打开

approved

ID 标题 目标版本 链接
— SPEC-027 「采到多少」的唯一事实源与物化投影 — 打开
SPEC-004-Phase3-API SPEC-004 Phase 3 — 云端 API 契约(客户端先就绪 / 服务端待实现) v0.10.95 (client) / TBD (server) 打开

in-progress

ID 标题 目标版本 链接
— 整页 Markdown 本地存储与上传契约 —— 给后端开发的接口需求 0.10.138 打开
— 插件内置 AI —— 关键词分析 + 商家匹配度 v0.13.1(自带 Key 直连) 打开
SPEC-008 文档与功能同步治理升级 v0.10.125 打开

done

ID 标题 目标版本 链接
— SPEC-024 照这个再建一个 —— 任务跑完之后的补充采集 — 打开
— SPEC-004 — 网站采集多阶段优化 + 云端协同 + 贡献度 v0.10.87+ 打开
— 设置页重排 —— 按「用户来这里要干什么」排,不按字段属于哪个模块排 v0.10.183 (阶段一) / v0.10.190 (顺序) / v0.10.191 (切分) 打开
— 设置导入导出 —— 换机器还原配置 v0.10.194 打开
— SPEC-026 把快速筛选做成内置视图 — 打开
SPEC-000 SPEC-000 — v2 UI 改版说明(v0.8.58 → v0.9.x → v0.10.x) v0.10.0 打开
SPEC-001 知识库改造 — 借鉴卡帕西的四层漏斗 v0.10.22 打开
SPEC-002 Watchdog 核弹重启后自动恢复(带上限保护) v0.10.23 打开
SPEC-003 文档治理自动化(docs:check + docs:rebuild + _overview) v0.10.25 打开
SPEC-006 SPEC-006 — task delete 时二选一 confirm 商家数据去留 v0.10.102 打开

parked

ID 标题 目标版本 链接
SPEC-005 SPEC-005 — React 前端 lifecycle 系统性扫描 + 修复 TBD 打开

| SPEC-026 | ✅ 把快速筛选做成内置视图(默认固定·可取消·不占配额) | done |