---
type: pointer
title: 进度与优先级
summary: 当前版本要做什么、顺序和状态；原文在仓库根目录 BACKLOG.md
source: ../../../../BACKLOG.md
updated: 2026-10-06
---

# 进度与优先级

原文是仓库根目录的 [BACKLOG.md](https://github.com/StephenQiu30/Ripplesight/blob/main/BACKLOG.md)。网站会把它的全文嵌入到下方，在 Obsidian 中请点上面的链接查看。

# Ripplesight BACKLOG

## 当前：CI生产底线与main交付（2026-10-08）

- [x] 修复远端runtime文档快照依赖Git元数据、后端17项真实集成失败；保留许可、预算、历史和过滤断言。
- [x] 移除旧卷名兼容检查及重复全套测试；锁定实际运行版本，保留静态检查、全量数据库/Redis/Kafka/MinIO集成、契约漂移、生产镜像启动/会话/CSP与公开文档发布。
- [x] 独立subagent审查、规定检查通过后提交推送main，核对最终SHA的远端CI结果；跳过项按实际环境明确记录。

代码已推送main：c8f2f1f8；同一SHA五条远端工作流全部通过。后端2584个唯一用例中2578通过、6项专门浏览器沙箱跳过、零失败/错误；JUnit分片无重叠。Web1028项、contract53项通过。完整链接及边界见workspace/VERIFICATION.md；最终仅归档文档的提交继续按受影响工作流验证。

## 当前：subagent独立审查与全站验收（2026-10-08）

本人允许独立subagent替代Claude审查，继续使用agent-browser验收全站并修复发现的问题。前次记录中的Claude登录过期保留为历史，不再是本轮门槛。

- [x] 独立审查上一轮修复和全站共用布局、状态、交互，逐项复核并处理可复现缺陷。
- [x] 52个页面在1440/390下检查布局、可访问性、导航和适用状态；静态说明与无数据依赖的页面记录不适用，固定样本与真实服务证据分开。
- [x] 按Figma桌面导出稿核对核心页面，真实接口缺失字段保持明确空态；验收证据、发现及修复持久化到现有页面需求与records。
- [x] 完成规定检查、审查复核并提交推送main；5项历史数据库失败与服务能力缺口继续如实记录，不以浏览器样本通过代替真实能力。

- [ ] 完整视觉和真实服务能力仍未通过：原稿统计/情感/曲线等数据、运营管理真实读写、所有动态参数及长期运行/送达/恢复待独立切片；本轮不编造样本或宣称完美还原。

## 当前：修复设计审查问题（2026-10-08）

- [x] 探索侧栏仅展示6个紧凑专题；结果数进入筛选行，两列顶部对齐，空态不受辅栏高度拉伸。
- [x] 公开事件进展合并进唯一时间线，保留引用、分页、取消与冲突重读；修正提醒对比度、登录页顶层页脚和导航/图例语义。
- [x] 无发布轮次返回leaderboard_not_published 404空态，真正依赖故障保留503；开发缓存移出tmpfs并复核逐页编译稳定性。
- [x] 本轮Web规定检查、后端静态/普通pytest和独立数据库15项专项回归通过；受控浏览器10个状态用例及8组核心布局已核对，记录已登记。普通pytest的953个数据库项明确跳过，不等于全量集成通过。
- [ ] 原稿缺失服务数据、全站最终视觉/真实业务验收与Claude独立审查仍待完成；CLI返回登录过期，不能记正式代码完成或能力可用。
- [x] 扩展数据库检查曾发现5项历史失败：采集覆盖分析状态、资料可见性/media_only/annotation投影和检索analysis_state；原58817e7d快照也失败。本轮CI切片已修复实际缺陷、补齐输入证明并按生效删除规范纠正冲突旧断言；全量独立服务回归已通过，详见workspace/VERIFICATION.md。

## 当前：agent-browser 全站还原审查（2026-10-08）

- [x] 审查前核对并推送main，origin/main已同步e7e886a4；使用agent-browser逐个访问52个代表路由，另核对8类核心窄屏与首页空/错误/无权限状态、本机收藏备注键盘保存和刷新。
- [x] 按本人允许使用隔离合成会话，保留登录页面；同构建预览连接真实后端补查公开入口，区分样本布局、运营令牌入口与真实业务结果。未创建真实用户，未更改实际认证。
- [ ] 设计还原审查未通过：探索38专题导致空态/辅栏过长、结果数占行；事件保留旧“事实与进展”；提醒对比度及登录地标需修正。详见[逐页审查](workspace/content/records/2026-10-08-agent-browser设计还原审查.md)。
- [ ] 开发前端2GB容器在编译时发生OOM重启；真实模型榜返回database_unavailable 503。需要分别修复服务稳定性与榜单依赖，不能以样本正常或健康检查成功认定通过。
- [ ] 原稿数据/交互缺口、无单页原稿的辅助页面重建、完整五状态与真实业务验收仍未完成；本轮仅审查并记录，不把上一轮重建条目当作完整视觉验收。

## 当前：按 Figma 从基础重新复现（2026-10-08）

本人明确否定现有前端的视觉还原。下方原“Figma重建”完成项仅是历史执行记录，不代表用户认可或本轮视觉验收；现有页面不是设计基线。

- [x] 按桌面原稿重建固定侧栏、正文、排版和语义组件；移除旧侧栏折叠状态与全局快捷键干扰。
- [x] 重建首页、探索、事件、日报、模型榜、监控、收藏、登录及共用页面状态，替换旧展示组合；收藏增加本机备注及排序，监控默认改为连续详情，既有结果与设置保留入口。
- [x] 同步需求入口、8个核心页面需求、API/数据库/非功能/验收与收敛方案；原稿所需统计、情感、曲线、关注和已读保留为待接入需求，不能因旧 UI 没有而撤销。
- [x] Web lint、typecheck、format:check、124文件970项测试和生产构建通过；文档check（26项测试及TypeScript）和107页构建通过。末次记录更新后重验文档，结果见 workspace/VERIFICATION.md。
- [x] 核对8类主页面的1440px/390px正常布局、横向范围；首页共用空/加载/错误/无权限状态及筛选键盘、收藏备注保存可用。真实8666只读核对已有监控主题和5条结果；隔离固定样本不算真实业务验收。
- [ ] 全站逐路由五状态浏览器矩阵、用户最终视觉评审仍待完成；Claude CLI再次返回登录过期，未获得独立审查，按§6不标记“代码完成”或“能力可用”。
- [ ] 全站公开统计、情感观测/历史曲线、X趋势、事件/评论搜索、云关注与告警已读等服务缺口按页面合同逐项实现；本轮未修改业务schema、生成API、来源采集或冻结App。

## 当前页面驱动的需求收敛与报错修复（2026-10-08）

本人纠正：不盘点文档数量，而要根据前端当前展示数据、需求和操作反推数据库与接口，替换历史冗余设计和实现。当前依据为[页面PRD](workspace/content/product/prd/03-PRD-全站页面需求.md)与[收敛方案](workspace/content/product/reference/14-页面驱动的收敛方案.md)。下方之前的“当前”段落均为历史，不作为新一轮扩建派发。

- [x] 开始时 main 与 origin/main 均为 67df5ab1、工作区干净；执行 push 结果 Everything up-to-date，没有制造空提交。
- [x] 原 Chrome 复现根元素多出的翻译扩展属性，服务端 HTML 没有该属性。只在 DocumentRoot 容忍不可控属性差异，回归证明正文不一致仍报告；删除无调用者的旧 PageContainer header 分支。
- [x] 原位替换逐页字段、数量、操作、接口、存储和取舍；总纲/数据库/非功能/验收/入口同步收敛。撤销云收藏/关注/账本/批次/情感快照/已读等预设新表和接口建议，旧前端 8 卡计划退出当前派发。
- [x] 内部清单登记当前页面需求及依赖；只读构建仓库快照验证页面跳转，无实际初始化、账号授权或业务库写入。
- [x] Web lint、类型、格式、973 项测试及生产构建通过。
- [x] 文档索引、26 项工具测试、类型检查、构建和 8668 HTTP/原文/检索核对通过；浏览器从总表读收藏/Codex 页面需求，搜索进入收敛方案。修复带空格文件名的 Markdown 链接并补逐页跳转回归。
- [x] 登录页实际检查 1440px/390px、初始加载、空表单提示、键盘切换与匿名回跳；未执行真实登录/邮件，也未重验全站五状态。
- [ ] Claude 独立审查未完成：本轮 CLI 返回登录过期；按 AGENTS §6 不标记“代码完成”或“能力可用”。本轮修改按独立提交归档到 main，提交/推送结果以 Git 与交付回复为准；详细证据见 workspace/VERIFICATION.md。
- [ ] 内部真实账号/Obsidian 发布、真实来源/自然持续运行、送达、生产容量和数据库恢复不属于本轮通过证据；后台模块/表退役仍需消费者与迁移验证。

## 当前全站页面需求与工程设计（2026-10-08）

本人要求先提交当前代码到 main 并推送，再使用 pm-execution 整理逐页功能表、需求分析、数据库、接口、功能/非功能与验收，持久化进现有项目。当前切片为需求设计，不执行新增业务功能。

- [x] 现有 Figma 重建与监控工作台接入代码提交为 `4489b400`（88文件），推送 origin/main；没有把未完成的 Claude 审查或真实业务验收写成通过。
- [x] 静态盘点52个页面、185项主要行为、247个生成API函数、123张schema表；新增逐页文档、专项PRD、接口/数据库设计、非功能和跨页验收、现状字典。
- [x] 文档索引、命名/链接、25项工具测试与类型检查通过；106页静态构建、HTTP正文/原文/AI导出及中文搜索通过；浏览器从总表进入首页需求、搜索“监控主题”进入主题工作区需求。详见 workspace/VERIFICATION.md。
- [ ] 后续业务实施、真实来源/恢复/送达验收、用户体验及工程审查按独立切片推进；新增表、API、云收藏、公开聚合与阈值均为提案，不据本文自动执行。

入口：[页面需求总纲](workspace/content/product/prd/03-PRD-全站页面需求.md)。

## 当前 Figma 桌面稿重建（2026-10-08）

本人要求直接使用 Figma 桌面端，清理当前设计和实现，完全按照 `DfWRfnw965ocH6lmlSYGgs` 展开重建；同时遵循 shadcn 与 Vercel React Best Practices。此指令覆盖旧版外壳视觉规则，不覆盖真实接口、权限、收藏许可与已有监控业务。

- [x] 从 Figma 桌面端完整导出 10 页 PDF，逐页核对首页、事件、探索、日报、榜单、监控、收藏、登录、状态和移动稿；原稿证据保存在本地 `.tools/figma-shadcn-review/`，MCP 额度限制已由桌面导出解决。
- [x] 替换旧外壳：302px 侧栏、中文品牌、40px 导航项、页内标题、48/16px 留白、666:357 两栏、390px 顶部与底部导航；移除阅读页旧固定面包屑条与全局页脚。既有管理入口保留在“更多”。
- [x] 重建首页概览与事件列表、探索紧凑筛选、事件／日报／榜单分栏、监控窄列、收藏搜索与选择导出、登录涟漪双栏；统一标题、输入控件、分段筛选、空态与错误提示。收藏导出仅含可读条目的标题、原文链接、来源和时间。
- [x] shadcn 组件分组、语义颜色、动态类名、间距和按钮图标由 ESLint 规则约束；Vercel 规则核对并行读取、动态加载和服务端／客户端边界。未增加产品依赖，已有监控结果、页签与草稿行为保留。
- [x] Web lint、类型、格式、生产构建通过；122 个测试文件的 971 项测试通过，后续控件与布局修复追加 143 项回归，标题点击区域修正追加 11 项回归。文档 25 项检查与 47 页构建通过。
- [x] 1440px / 390px 下核对首页、探索、事件、日报、榜单、收藏与登录布局；隔离固定样本验证正常、空、加载、错误、未登录跳转，以及菜单／选择器键盘操作、深色主题恢复和收藏选择导出。实际下载只含选中资讯的标题、来源、原文链接与时间。截图和原稿均在 `.tools/figma-shadcn-review/`；固定样本不计作真实业务验收。
- [x] Chrome 复核同一生产构建的首页／事件往返与探索导航；当前 8666 登录账号下，监控主题与 5 条已有帖子／评论正常显示。本轮只读取既有结果，没有触发采集或修改主题；独立验收服务结束后关闭，原有 Docker 服务继续运行。
- [ ] 原稿中的情感比例、历史热度曲线、X 趋势、全球统计、收藏备注和部分监控分析没有当前公开接口支持；不能用示例值冒充，也不能据本轮外观改版认定这些能力已完成。真实业务完整验收、用户视觉评审与 Claude 审查待完成。代码已在2026-10-08归档推送为4489b400。

## 当前 UI/UX 接入（2026-10-07）

本人在提交推送后要求继续；按已归档设计接入真实监控核心流程。验收：默认结果、页签 URL 与键盘操作、草稿及手动运行状态不因切换丢失、窄列/移动主题选择、真实结果时间与失败状态可辨认；保留既有权限、版本冲突、来源预算语义。本轮不扩建定时历史接口。

- [x] 真实页面结果前置、URL 页签、保留草稿/运行状态、窄列与移动收起、结果类型与过期提示已实现；960 项测试及 Web 工程检查通过。
- [x] 桌面与 390px 真实正常结果、草稿及键盘交互通过；结果区域空/加载/错误/无权限采用独立标签页受控响应验证，结束已恢复。
- [x] 知识库 25 项检查及 47 页构建通过；末次标签修正后追加 4 项结果回归及 Web 静态检查/构建通过。
- [ ] Claude 审查因登录过期未执行；用户体验评审及完整能力验收待完成，见[接入记录](workspace/content/records/2026-10-07-监控工作台体验接入.md)。代码已在2026-10-08随4489b400归档推送。

## 前一轮 UI/UX 设计（2026-10-07）

本人明确“不是要 pagecontainer，是参考设计”，并要求重新启动项目。已覆盖前一轮“保持 Docker 停止”的运行约束；本轮先交付监控核心流程的设计稿，保留已有业务代码。设计依据、用户旅程、能力契约及验收场景见[监控工作台体验设计](workspace/content/research/2026-10-07-监控工作台体验设计.md)。

- [x] 恢复前端 8666、后端 8667 与知识库 8668；后端就绪 200，Chrome 主题页可读既有两条真实结果。
- [x] 交互稿保存在 `workspace/designs/monitor-workbench.html`；结果前置、四页签、内容/评论、来源说明、五状态和窄屏布局。
- [x] 桌面与 390px 五状态、页签键盘操作、搜索无结果/清除、设置预览、评论弹层及焦点返回通过；窄屏正文宽 375px、滚动宽 375px，正文底与底栏顶均为 784px。截图在 `.tools/uiux-design/desktop.png`、`mobile.png`。
- [x] 文档 25 项检查、类型检查、46 页生产构建与搜索索引通过；`git diff --check` 通过。正式业务代码本轮未修改，未重跑业务全量测试，未提交、未推送。
- [ ] 用户体验评审及正式前端接入；原型使用明确标注的固定实采样本，不代表新增采集或业务能力验收。

## 前一轮页面容器修复（2026-10-07）

上一轮将用户要求理解为参考 Ant Design Pro PageContainer，把固定的内容展示区纳入 layout；用户本轮已纠正为参考设计、进行 UI/UX 设计，不能以该组件作为需求交付。本轮复用 shadcn/Radix，将 PageContainer 接入 BasicLayout 的所有路由，统一位置栏、正文滚动、宽度与页脚；保留业务请求、会话与原有页面状态。

- [x] 固定导航/位置栏，正文占满剩余高度独立滚动，长内容与页脚不相互覆盖。
- [x] 桌面与 390px、侧栏折叠、键盘滚动与页脚可达性实测；路由切换及阅读进度自动化回归通过。
- [ ] 完整错误/无权限状态矩阵与 Claude 审查；本人要求保持 Docker 停止、只做代码检查，Claude 登录过期，见[验收记录](workspace/content/records/2026-10-07-PageContainer布局修复.md)。
- [x] Web lint、类型、格式、955 项测试及构建通过；末次滚动修正后追加 66 项回归通过。文档 25 项测试与 45 页构建通过；未提交、未推送。

## 当前接入任务（2026-10-07）

本人最新指令：demo 跑通后接入真实前后端。验收沿用 pm-execution:test-scenarios：本人账号在来源页启用 Chrome 预设、创建 DeepSeek 小时主题、立即采集后在主题页看到带原文链接的帖子与根评论；后台到期再次执行，同 ID 去重；暂停/登录失效/预算耗尽可见且停止外发；其他账号不能使用本机 Chrome。

- [x] Chrome SourceAdapter、来源预设和账号绑定接入现有持久化任务；独立库固定样本跑通帖子与评论。
- [x] 来源页操作及主题结果/评论入口使用生成客户端；950 项前端测试通过。
- [x] 修复已确认的注册流程缺口（新注册真实交互待本人复核）：仅 GitHub/邮箱验证可创建账号；首次统一设置用户名和密码，未完成时返回设置页，既有账号三种登录及安全回跳可用。
- [x] 当前 Chrome 账号绑定、正式主题和定时运行器接管；实采 2 帖，本轮根评论为 0；旧 demo 已停且当日预算已承接。
- [ ] 下一小时自然到期、真实评论新增与持续稳定性验收。
- [x] 独立库定向回归 1729 项通过、2 项跳过，前端 950 项通过；真实主题结果及评论空态/错误重试已核对。
- [ ] 完整工程与页面验收：全量后端存在 5 项基线失败；桌面/390px 完整五状态、真实新注册与 Claude 审查待完成，详见接入与注册验收记录。



更新：2026-10-07。这是唯一记录进度和优先级的地方。为什么做、版本怎么划分，见 [PRD](workspace/content/product/prd/01-PRD.md)；每项功能怎样算完成，见对应的能力文档。

## 当前检查点：先核对需求，再做最小验证

最新指令：开始真实、定时关键词监控 demo，直接复用 Chrome 登录。当前执行国内首个平台 B 站、DeepSeek 示例，先交付本机可复跑结果与定时证据；平台接入和长期质量仍逐项验收。此指令取代下方历史的“暂不实现”。

- [x] Chrome 会话桥接、免费有界采集与停止机制：真实 B 站登录和首轮搜索成功。
- [x] 首个平台真实帖子/根评论、去重、采集记录和可读 demo：两轮累计 4 个帖、1 条根评论；[实采记录](workspace/content/records/2026-10-07-Chrome关键词demo验收.md)。
- [x] 持久化定时状态、真实调度执行及复跑说明：16:25 后台自动实采成功，下次 17:25；[运行说明](workspace/content/research/2026-10-07-Chrome关键词demo运行说明.md)。

- [ ] 完整工程与产品验收：1593 项单元/架构通过，既有覆盖率集成用例失败；正式账号、连续小时稳定性、语义质量和评论增量仍待验收。

2026-10-07 本人指出文档与真实执行存在理解和实现偏差，范围总做得又大又全，要求先搭 workspace，暂不实现业务代码；真实验证应先跑通 POC 和 demo。原话与阅读入口见[需求与验证入口](workspace/content/product/reference/04-需求与验证入口.md)。

较早一轮仅整理文档入口、AI 阅读约定、验证卡和本机阅读验证；当时业务场景未选定。随后用户已明确下方的关键词帖子与评论监控方向；目前仍没有业务编码或业务验证结果。阅读工具检查见 [workspace 验证记录](workspace/VERIFICATION.md)。

此前阅读工具状态：需求入口、AI 协议、验证卡和本机预览已搭好；文档校验、构建、34 页 HTTP/原文导出及浏览器 POC 搜索通过。业务场景已按下方新指令澄清；本人对阅读体验的反馈、正式账号知识库和双端编辑仍未验收。

随后按本人要求统一名称为 Ripplesight：GitHub 仓库已改名，本机 origin 已更新；页面、文档、包、镜像默认名称与 Pages 路径已调整并在本机验证。本人明确授权提交并推送 main 后，主仓库改动已在 `002c6206` 推送；文档站由 Workspace site 工作流发布，远端运行与线上检查结果见上述验证记录。改名不迁移既有数据库、登录或导出数据，也不代表业务 POC 已通过。

同日补齐文件夹与描述：父工作区迁为 `Ripplesight/`，主仓库与冻结客户端分别为 `ripplesight-server/`、`ripplesight-app/`；App 远端改为 `Ripplesight-app`。GitHub About、README、页面与包描述同步当前用途，App 明确仍冻结。旧路径以兼容链接保留；当前 Codex 已有名为 Ripplesight、指向新父目录的项目，旧 HotKey 项目仍保留。新路径下工程、文档与 App 说明检查通过；App 改动已在 `b9447bf` 推送 main，远端文档 CI 通过。既有 8666/8667 业务服务未重新部署。

### 关键词事件监控 POC 需求整理（2026-10-07）

用户确认：按配置关键词获取相关帖子和评论，考虑相似度/相关性及时效性；最终支持国内主流及 X、Instagram 等海外平台，POC 只验证国内主流平台，并请 AI 举例。随后明确要求使用 pm-market-research 详细调研及其他 PM 技能分析。本轮范围是产品分析与知识体系整理，需求唯一原文在[总 PRD](workspace/content/product/prd/01-PRD.md)。

选型依据：用户要求重心转向 GitHub 上实时热点、关键词与评论爬虫项目，关注 star、可复用功能，取数必须免费、没有付费 API。现已完成只读调研；上一阶段基于这些项目使用 pm-execution 统一需求、功能/非功能规格、架构、数据库与验收设计；最新 POC 实施进度以上方为准。商业竞品保留背景，不据此采购服务。

| 工作 | 当前状态与下一步 |
|---|---|
| 用户目标、平台工作清单、关键词示例及相关性/时间口径 | 已写入总 PRD；AI 提案与用户已确认范围分别标注 |
| 核对现有实现、四类假设及验收方法 | 已完成只读源码核对，见[需求核对](workspace/content/research/2026-10-07-热点事件需求核对.md)；没有真实平台/模型结论 |
| GitHub 免费取数方案调研 | 已核验 15 项主要候选与 2 项排除样本的 star、维护、许可及关键源码，见[专项调研](workspace/content/research/2026-10-07-GitHub免费热点与评论采集调研.md)；提出国内采集/热榜补充/海外后续取舍，公众号、视频号、头条完整链路仍缺合格证据，尚未安装或实采 |
| pm-execution 需求与工程设计（上阶段） | 总 PRD 已统一功能/非功能条款；[PROJECT §12](PROJECT.md#12-关键词监控工程设计提案)整理处理流程、预算、状态和接口边界；[数据库设计](workspace/content/product/reference/07-关键词监控数据库设计.md)核对现有表并提出最小差量；[交付与验证设计](workspace/content/research/2026-10-07-关键词监控验证与交付设计.md)连接阶段、需求追踪、风险和场景。均为设计产物，未改 DDL/ORM/API，未连接数据库或派发实现 |
| 市场调研、用户旅程与优先级 | 已完成[五家商业产品及四类开源方案调研](workspace/content/research/2026-10-07-热点监控市场与竞品调研.md)和[用户旅程、优先级及生命周期门槛](workspace/content/research/2026-10-07-用户细分旅程与POC优先级.md)；官方桌面调研未试用，用户画像和排序为待验证提案 |
| 准备国内首平台 POC | [验证卡](workspace/content/research/2026-10-07-国内平台关键词监控POC验证.md)已备；平台清单、首平台、主题、窗口和阈值待核对，尚未派发实现 |
| 文档阅读与检索验证 | 本轮结果见 [VERIFICATION](workspace/VERIFICATION.md)；文档通过不计作业务 POC 通过 |
| 国内其余平台及海外 | 国内按清单逐项验证，未开始；X/Instagram 等为后续目标，本轮不接入 |

本轮设计修正：统一 UTC 半开时间窗；四档相关性与可选情感解耦；区分真实刷新评论和读取旧 JSONL；有界保留过滤前候选；运行/来源预算跨查询分片、详情与评论共享；暂停、取消、窗口部分完成及来源风控停止分别建模。执行前只需冻结首卡实际输入、版本、预算、留存与模型条件；已确认的产品方向和零费用底线无需重新确认。验证记录继续引用 workspace/VERIFICATION，不用文档检查宣称业务通过。

下列 V1/V2、知识库和前端计划及历史状态原样保留，供逐项核对；当前阶段不据这些列表继续派发业务实现。§7 中记载的 heartbeat 是历史运行方式，本轮没有修改其配置；读到这里的后续任务也应遵守本轮范围与最新用户指令。

## 1. V1 每日舆情（当前版本）

完成标志：KR1、KR3、KR4 达成；KR2 达到 3 个平台。

| 顺序 | 工作 | 能力文档 | 完成条件 | 状态 |
|---|---|---|---|---|
| 1 | 启用本机 Codex 分析，并完成 200 条样本的情感评测 | [04](workspace/content/capabilities/04-评论舆情.md) | 04 验收第 2 条（KR3） | 待本人提供模型名 |
| 2 | X 每日趋势（方案 A），日报增加“今日社媒热点” | [03](workspace/content/capabilities/03-每日社媒热点.md) | 03 验收第 1、2 条（KR1） | 待派发 |
| 3 | 修复 B 站评论试点，接入微博评论 | [04](workspace/content/capabilities/04-评论舆情.md) | 04 验收第 1、4 条中的这两个平台 | 待本人在 MediaCrawler 浏览器中登录 |
| 4 | 4 个搜索来源 + 6 个热榜的真实短窗验证 | [02](workspace/content/capabilities/02-关键词热点.md) | 02 验收第 2 条 | 待派发 |
| 5 | 舆情告警（评论突增、负面占比超阈值） | [04](workspace/content/capabilities/04-评论舆情.md) | 04 验收第 3 条（KR4） | 等第 1、3 项完成 |
| 6 | 日报连续 7 天真实运行 | [05](workspace/content/capabilities/05-报告推送与知识库.md) | 05 验收第 1 条（KR1） | 等第 2 项完成 |
| 7 | 记录每天手动搜索用时的基线 | [PRD](workspace/content/product/prd/01-PRD.md) | 第一周每天都有记录（KR5 基线） | 本人记录 |

## 2. V2 完整舆情

完成标志：KR2、KR5、KR6、KR7 达成。

| 工作 | 能力文档 | 前置 |
|---|---|---|
| 抖音、小红书评论 | [04](workspace/content/capabilities/04-评论舆情.md) | V1 第 3 项；本人登录 |
| X 账号试点（方案 B） | [03](workspace/content/capabilities/03-每日社媒热点.md) | 本人提供 token |
| 舆情看板与主题热点页 | [04](workspace/content/capabilities/04-评论舆情.md)、[02](workspace/content/capabilities/02-关键词热点.md) | V1 第 1、3 项 |
| 采集连续 72 小时稳定运行 | [02](workspace/content/capabilities/02-关键词热点.md) | V1 第 4 项 |
| 公开阅读稳定运行与抽查 | [01](workspace/content/capabilities/01-公开资讯阅读.md) | V1 第 1 项 |
| 周报真实周期、邮件真实收件 | [05](workspace/content/capabilities/05-报告推送与知识库.md) | 本人提供 SMTP |

## 3. 以后

知识库问答、模型榜真实发布、Codex 公告真实数据（依赖 X 账号试点）、Reddit（需要官方 API 获批）、补充更多热榜、登录方式的真实验收（GitHub OAuth、验证码邮件）。

## 4. 需要本人提供

| 事项 | 解锁 | 方式 |
|---|---|---|
| Codex 模型名 | V1 第 1 项 | 告诉 Claude 模型名，由开发任务写进本机配置 |
| B 站、微博、抖音、小红书登录 | V1 第 3 项、V2 | 本人在 MediaCrawler 的独立浏览器中登录 |
| X 账号 `auth_token` | V2 | 本人写进本机 `.env`，不要发给 AI |
| 通知邮件的 SMTP 凭据 | V2 | 本人写进本机 `.env` |
| GitHub OAuth App、验证码邮件 | 以后 | 同上 |
| Reddit 官方 API | 以后 | 本人申请 |

## 5. 冻结

对外分发（RSS/只读 API/MCP/Agent Markdown、SEO/IndexNow、分享海报）、Instagram/Facebook/Threads、Flutter App、通用浏览器采集、飞书推送。见 [冻结范围](workspace/content/decisions/11-冻结范围.md)。

## 6. 工作方式

由 Claude 写任务卡并派给 Codex 开发，Claude 审查和验收，分工见 [AGENTS](AGENTS.md) §1。每项工作完成后，在 `workspace/content/records/` 新建验收记录，更新对应能力文档的 `status`，并更新这里的状态。

## 7. 项目文档知识库（独立排期）

需求见[workspace 项目知识库专项 PRD](workspace/content/product/prd/02-PRD-workspace项目知识库.md)，任务验收、负责人、估算与依赖见[执行计划](workspace/content/product/plan/01-PLAN-workspace项目知识库.md)。当前聊天已启用全天每两小时推进一次的 heartbeat（`hotkey`）；业务 V1/V2 的优先级保持现有顺序。

首个 Sprint 的启动包为工具修复与方案收敛，共 16 理想小时，已开始工具修复与方案收敛；其余是待前置完成后滚动准入的候选。按计划初值，首个 Sprint 全部候选合计 128 小时，后续编辑 Sprint 116 小时。真实容量在前 12 个窗口后校准。

本次范围为开发过程的内部知识库：现有 frontend 内接入 Nextra，网页编辑采用 Editor.js 与 Markdown 原文视图，管理 PRD、决策、计划及关联；不采用 GitBook。内部调研记录 `workspace/content/research/2026-10-06-workspace成熟方案调研.md` 包含作者 workspace 范式与 Notion 替代路线，Notion 尚未采用。目标环境已确认只在本机运行，框架与格式适配复用现有实现；不安装 Fumadocs，不删除现有 Nextra。

### 首个 Sprint：阅读与 AI

| 顺序 | 工作与任务卡 | 完成条件 | 状态 |
|---|---|---|---|
| 1 | [文档工具修复](workspace/content/product/plan/01-PLAN-workspace项目知识库.md#文档工具修复) | 当前文档校验与构建可重复通过，支持 plan 元数据 | 工程检查与本地浏览器复核通过，待 Claude 审查；证据见 [VERIFICATION](workspace/VERIFICATION.md#本轮工具修复与编号复核) |
| 2 | [方案收敛](workspace/content/product/plan/01-PLAN-workspace项目知识库.md#方案收敛) | 技术方案、能力归属、环境与身份缺口明确 | 源码核对与方案草案已整理至 [PROJECT §11](PROJECT.md#11-项目文档知识库接入方案待审查)，已建立 [07 能力](workspace/content/capabilities/07-项目文档知识库.md)；仅本机环境已确认；待 Claude 审查及本人账号配置 |
| 3 | [来源清单与版本快照](workspace/content/product/plan/01-PLAN-workspace项目知识库.md#来源清单与版本快照) | 唯一原文、文件 hash、可重建的同版本快照 | 本机工具已实现，确定性与完整性测试通过；待审查与真实初始化 |
| 4 | [统一权限与读取接口](workspace/content/product/plan/01-PLAN-workspace项目知识库.md#统一权限与读取接口) | 全读取出口授权与路径校验，生成契约通过 | 接口与生成客户端已实现，受控权限检查通过；待本人 UUID 与真实身份验收 |
| 5 | [工作台阅读界面](workspace/content/product/plan/01-PLAN-workspace项目知识库.md#工作台阅读界面) | 同布局文档显示、链接与五种页面状态正确；Nextra 保留且内部快照隔离 | Nextra 入口已实现；桌面、390px 五种状态与键盘受控验证通过；待审查与真实验收 |
| 6 | [Obsidian 离线阅读](workspace/content/product/plan/01-PLAN-workspace项目知识库.md#obsidian-离线阅读) | 实际 vault 离线阅读，根文件定位正确 | 专用副本、根文件映射与使用说明已准备；实际 Obsidian 尚未验收 |
| 7 | [目标环境读取验证](workspace/content/product/plan/01-PLAN-workspace项目知识库.md#目标环境读取验证) | KR1、KR2 真实验收与冷启动、恢复记录 | 本机隔离样本已验证；真实账号配置、冷启动及正式 KR 验收待完成 |
| 8 | [中文检索](workspace/content/product/plan/01-PLAN-workspace项目知识库.md#中文检索) | KR3 固定 20 条至少 18 条在前 5 命中 | 同快照关键词检索与浏览器冒烟已实现；固定 20 条查询尚未验收 |
| 9 | [AI 原文读取与引用](workspace/content/product/plan/01-PLAN-workspace项目知识库.md#ai-原文读取与引用) | 授权逐页或章节读取，同版本引用可打开 | 授权 API、本机只读 CLI 与章节定位已实现；真实本机 Codex 问题集尚未验收 |
| 10 | [阅读与 AI 验收](workspace/content/product/plan/01-PLAN-workspace项目知识库.md#阅读与-ai-验收) | KR1—KR4；真实 Codex、查询和边界问题记录 | 待前述产物及验收时间；候选 |

### 后续 Sprint：双端编辑

| 顺序 | 工作与任务卡 | 完成条件 | 状态 |
|---|---|---|---|
| 1 | [编辑与同步设计](workspace/content/product/plan/01-PLAN-workspace项目知识库.md#编辑与同步设计) | 草稿、Git 副本、写入位置、确认与恢复明确 | 本机方案与实现见 PROJECT §11、LOCAL；待 Claude 审查 |
| 2 | [草稿接口](workspace/content/product/plan/01-PLAN-workspace项目知识库.md#草稿接口) | 原文保存、CSRF、版本校验与重启恢复 | 已实现，受控版本、CSRF 与持久恢复检查通过；待真实账号验收 |
| 3 | [Markdown 编辑界面](workspace/content/product/plan/01-PLAN-workspace项目知识库.md#markdown-编辑界面) | 富文本与原文共用草稿，差异与发布状态清楚，格式保留 | Editor.js、原文、预览与对比已实现，真实编辑器保存及格式测试通过；待实际双端与输入法验收 |
| 4 | [确认发布](workspace/content/product/plan/01-PLAN-workspace项目知识库.md#确认发布) | 限定路径发布，同版本切换与未知结果核对 | 独立 Git 发布、决策替代与结果核对已实现；隔离副本浏览器发布通过，待审查与真实授权验收 |
| 5 | [版本冲突处理](workspace/content/product/plan/01-PLAN-workspace项目知识库.md#版本冲突处理) | 双方差异保留，无静默覆盖 | 隔离样本验证保存冲突、保留双方、显式合并后发布；待真实验收 |
| 6 | [Obsidian 双端同步](workspace/content/product/plan/01-PLAN-workspace项目知识库.md#obsidian-双端同步) | 五类样本十条往返，原文与元数据不丢失 | 文件同步工具已实现；实际 Obsidian 的五类十条往返尚未验收 |
| 7 | [历史恢复](workspace/content/product/plan/01-PLAN-workspace项目知识库.md#历史恢复) | 确认后恢复已知版本，历史与草稿保留 | 版本历史、加载新草稿与历史只读入口已实现；待完整恢复场景验收 |
| 8 | [编辑验收](workspace/content/product/plan/01-PLAN-workspace项目知识库.md#编辑验收) | KR5、KR6 真实双端往返与全部异常恢复 | 待写入任务、真实环境及验收时间；候选 |

远程只读 MCP 按具体客户端需求单独估算与派发，不作为首期前提；不恢复业务公开分发范围。更新任务状态时同时记录证据与阻塞条件，不将候选任务、受控测试或周期运行次数当作已完成。


### 外部条件与下一检查点

| 条件 | 负责人 | 当前影响与检查点 |
|---|---|---|
| 工具与接入方案审查 | Claude | 已尝试本机只读审查，Claude 登录过期，审查未执行；重新登录后复核当前修改，不能将工程通过记为代码完成 |
| 正式验收环境及允许的本人账号 | Stephen | 本机环境已确认；已请求现有账号 UUID，核对后只写本机配置，不记入公开文档。无配置时读取关闭 |
| 私密作者目录与文档专用 Git 工作副本 | Stephen 确认；Codex 配置 | 现有公开资料可准备本地样本；初始化在 .tools/workspace/source 建立独立来源，移除远端；待本人配置账号与实际使用验收 |
| 目标快照挂载与持久草稿存储 | Stephen 确认；Codex 实现 | §11 提供本机持久快照和草稿方案；冷启动、恢复和真实写入需在确认的目标环境验证 |
| 实际 Obsidian vault | Stephen；Claude 验收 | 工程文件校验不代表离线操作与双端往返已验收 |

当前检查点：`286e4dbe` 的分类与编号、`8d562ced` 的文档工具已推送 main。本轮新增本机授权接口、Nextra 阅读入口、Editor.js 与原文草稿、隔离 Git 发布、决策替代及操作核对。启动说明见 [本机知识库](workspace/LOCAL.md)，工程证据见 [本机接入验证](workspace/VERIFICATION.md#本机知识库接入验证)。工程与受控浏览器检查通过；真实账号、Obsidian、本机 Codex 和 Claude 审查未完成，不将实现记为能力可用。

## 8. 前端重新设计（独立排期）

依据 2026-10 高保真稿（[Claude 画布](https://claude.ai/artifact/ERFs389e9sFhhp11U5cviY)、[Figma](https://www.figma.com/design/DfWRfnw965ocH6lmlSYGgs)）与 [DESIGN](frontend/DESIGN.md) 重做 Web 外壳和主要页面，只用现有接口与真实数据。任务卡、数据缺口与验收见[执行计划](workspace/content/product/plan/02-PLAN-前端重新设计.md)。一次只派一张卡，与其他 frontend 写入任务串行。

| 顺序 | 工作与任务卡 | 完成条件 | 状态 |
|---|---|---|---|
| 1 | [外壳与公共状态](workspace/content/product/plan/02-PLAN-前端重新设计.md#实施顺序) | 新侧栏、底部导航、PageState；全部一级路由在新外壳下正常 | 2026-10-07 完成，见[验收记录](workspace/content/records/2026-10-06-前端重新设计验收.md) |
| 2 | [首页](workspace/content/product/plan/02-PLAN-前端重新设计.md#实施顺序) | 真实数据下各块正确，单块失败不影响整页 | 2026-10-07 完成，见[验收记录](workspace/content/records/2026-10-06-前端重新设计验收.md) |
| 3 | [事件详情](workspace/content/product/plan/02-PLAN-前端重新设计.md#实施顺序) | 公开与工作台入口、有无代表评论两类事件均正确 | 2026-10-07 完成，见[验收记录](workspace/content/records/2026-10-06-前端重新设计验收.md)；真实事件数据待有后复核 |
| 4 | [探索与收藏](workspace/content/product/plan/02-PLAN-前端重新设计.md#实施顺序) | 筛选可分享，本机收藏刷新后保持 | 2026-10-07 完成，见[验收记录](workspace/content/records/2026-10-06-前端重新设计验收.md) |
| 5 | [日周月刊阅读](workspace/content/product/plan/02-PLAN-前端重新设计.md#实施顺序) | 最新与归档各一期、打印预览正确 | 2026-10-07 完成，见[验收记录](workspace/content/records/2026-10-06-前端重新设计验收.md) |
| 6 | [工作台：监控主题与告警](workspace/content/product/plan/02-PLAN-前端重新设计.md#实施顺序) | 真实会话下主题与告警增改停复各一次 | 2026-10-07 完成，见[验收记录](workspace/content/records/2026-10-06-前端重新设计验收.md)；告警创建待通知目标配置 |
| 7 | [模型榜](workspace/content/product/plan/02-PLAN-前端重新设计.md#实施顺序) | 各维度与子页可用，空数据有空状态 | 2026-10-07 完成，见[验收记录](workspace/content/records/2026-10-06-前端重新设计验收.md) |
| 8 | [登录页](workspace/content/product/plan/02-PLAN-前端重新设计.md#实施顺序) | 三种方式在已配置与未配置下显示正确 | 2026-10-07 完成，见[验收记录](workspace/content/records/2026-10-06-前端重新设计验收.md) |