进度与优先级

原文是仓库根目录的 BACKLOG.md 。网站会把它的全文嵌入到下方，在 Obsidian 中请点上面的链接查看。

Ripplesight BACKLOG

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

• 修复远端runtime文档快照依赖Git元数据、后端17项真实集成失败；保留许可、预算、历史和过滤断言。
• 移除旧卷名兼容检查及重复全套测试；锁定实际运行版本，保留静态检查、全量数据库/Redis/Kafka/MinIO集成、契约漂移、生产镜像启动/会话/CSP与公开文档发布。
• 独立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登录过期保留为历史，不再是本轮门槛。

• 独立审查上一轮修复和全站共用布局、状态、交互，逐项复核并处理可复现缺陷。

• 52个页面在1440/390下检查布局、可访问性、导航和适用状态；静态说明与无数据依赖的页面记录不适用，固定样本与真实服务证据分开。

• 按Figma桌面导出稿核对核心页面，真实接口缺失字段保持明确空态；验收证据、发现及修复持久化到现有页面需求与records。

• 完成规定检查、审查复核并提交推送main；5项历史数据库失败与服务能力缺口继续如实记录，不以浏览器样本通过代替真实能力。

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

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

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

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

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

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

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

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

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

本人纠正：不盘点文档数量，而要根据前端当前展示数据、需求和操作反推数据库与接口，替换历史冗余设计和实现。当前依据为页面PRD与收敛方案。下方之前的“当前”段落均为历史，不作为新一轮扩建派发。

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

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

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

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

入口：页面需求总纲。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Chrome 会话桥接、免费有界采集与停止机制：真实 B 站登录和首轮搜索成功。

• 首个平台真实帖子/根评论、去重、采集记录和可读 demo：两轮累计 4 个帖、1 条根评论；实采记录。

• 持久化定时状态、真实调度执行及复跑说明：16:25 后台自动实采成功，下次 17:25；运行说明。

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

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

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

此前阅读工具状态：需求入口、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。

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

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

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

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

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

2. V2 完整舆情

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

3. 以后

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

4. 需要本人提供

5. 冻结

对外分发（RSS/只读 API/MCP/Agent Markdown、SEO/IndexNow、分享海报）、Instagram/Facebook/Threads、Flutter App、通用浏览器采集、飞书推送。见 冻结范围。

6. 工作方式

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

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

需求见workspace 项目知识库专项 PRD，任务验收、负责人、估算与依赖见执行计划。当前聊天已启用全天每两小时推进一次的 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

后续 Sprint：双端编辑

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

外部条件与下一检查点

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

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

依据 2026-10 高保真稿（Claude 画布 、Figma ）与 DESIGN  重做 Web 外壳和主要页面，只用现有接口与真实数据。任务卡、数据缺口与验收见执行计划。一次只派一张卡，与其他 frontend 写入任务串行。