Ripplesight 需求 workspace
当前阶段：以 Figma 桌面稿为准，从 layout、组件和页面重新复现。当前前端本身是待替换的历史实现。 页面/API/表数量不是交付目标；先回答用户要看到什么、操作什么、为什么要保存，再决定是否改接口与数据库。实际任务进度只在BACKLOG。
| 当前入口 | 用途 |
|---|---|
| 页面需求总纲 | 按主流程、辅助入口、冻结兼容组织页面，逐页定义字段、数量和操作 |
| 页面驱动的收敛方案 | 哪些设计已撤销、为什么保留必要依赖、怎样退役旧实现 |
| 页面接口设计 | 当前读写合同、版本/权限/失败恢复，不预建新接口平台 |
| 页面数据库设计 | 必要持久字段、派生查询、本机状态、关系/约束和删除迁移 |
| 非功能要求 · 验收场景 | 当前页大小、状态、权限、可靠性和用户路径，实测结论另记 |
| 产品总纲 · 需求来源 | 用户目标、零费用和已确认边界；历史原话不自动派发 |
| 进度与优先级 | BACKLOG顶部的当前任务及证据 |
GitHub/市场调研、旧执行计划和验收记录按需追溯，不再作为当前入口的必读扩建清单。旧版本KR和提案不因为仍能检索就成为当前需求。Figma视觉、现有接口与真实平台可用性分别核对。
阅读顺序
给人和 AI 的建议顺序：
- 需求与验证入口 → AI 任务协议 → 进度与优先级的当前检查点。
- 先核对 Figma 原稿与 frontend/DESIGN.md，再按实际接口依赖阅读页面需求、收敛结论及源码，核对输入、输出与数量。
- 阅读相关决策与工程规范，只补充当前场景需要的边界。
- 获准验证后，用一张 POC 卡限定范围；需要核对实现时再读源码、技术架构和实际证据。
- 原执行计划（
product/plan/）作为历史执行依据按需查阅；当前阶段不据大计划自动推进实现。
原工作台文档知识库需求，见workspace 项目知识库专项 PRD与执行计划。它们保留原文；本轮只复用已有阅读工具，不扩建文档平台。
每份文档开头都有元数据（frontmatter）：type、title、summary、status、updated 等。AI 可以先读元数据，再决定打开哪份文档。
产品文档分类
| 位置 | 文档职责 | 内容 |
|---|---|---|
product/prd/ | 产品需求（type: prd） | 为什么做、为谁做、目标、范围与验收要求 |
product/plan/ | 执行计划（type: plan） | 如何交付、任务拆解、容量、负责人、依赖与发布门槛 |
product/pages/ | 页面需求（type: pointer） | 专项 PRD 的52个单页功能、数据、接口和验收细节 |
product/reference/ | 产品参考（type: pointer） | 需求核对入口、AI 约定、验证卡；进度、架构与规范通过指针嵌入根文件 |
PRD 定义需求，PLAN 组织执行；实际优先级、派发与完成状态只维护在 BACKLOG。每份专项计划链接对应 PRD，专项 PRD 链接其计划，方便人和 AI 按需阅读。
全部文档
产品
产品需求（PRD）
| 文档 | 摘要 | 状态 |
|---|---|---|
| PRD：Ripplesight | 公开阅读与个人关键词监控的产品目标和已确认边界；实施以Figma页面需求和真实服务合同为准 | 生效 |
| PRD：workspace 项目知识库 | 在 frontend 工作台统一阅读、检索和编辑项目文档，共用样式与权限，供 AI 和 Obsidian 使用 | 生效 |
| PRD：全站页面需求 | 以当前页面字段、展示数量和操作反推需求，复用必要存储并撤销无页面依据的扩展 | 生效 |
执行计划（PLAN）
| 文档 | 摘要 | 状态 |
|---|---|---|
| PLAN：workspace 项目知识库 | 全天每两小时推进一轮，按依赖交付工作台阅读、AI 检索和网页与 Obsidian 编辑 | 生效 |
| PLAN：前端重新设计 | 按Figma从layout重建主页面，替换历史八张任务卡 | 生效 |
页面需求
| 文档 | 摘要 | 状态 |
|---|---|---|
| 今日热点页面需求 | 按Figma定义今日热点的字段、数量、操作与服务缺口，替换历史视觉基线 | — |
| 探索资讯页面需求 | 按Figma定义探索资讯的字段、数量、操作与服务缺口，替换历史视觉基线 | — |
| 公开专题目录页面需求 | 从 /discover/topics 当前展示和操作推导字段、数量、存储与取舍 | — |
| 公开专题详情页面需求 | 从 /discover/topics/[slug] 当前展示和操作推导字段、数量、存储与取舍 | — |
| 公开事件目录页面需求 | 从 /discover/stories 当前展示和操作推导字段、数量、存储与取舍 | — |
| 公开事件详情页面需求 | 按Figma定义公开事件详情的字段、数量、操作与服务缺口，替换历史视觉基线 | — |
| 公开资讯阅读页面需求 | 从 /items/[contentId] 当前展示和操作推导字段、数量、存储与取舍 | — |
| 收藏与阅读记录页面需求 | 按Figma定义收藏与阅读记录的字段、数量、操作与服务缺口，替换历史视觉基线 | — |
| 最新公开刊物与个人报告详情页面需求 | 从 /reports/[reportId] 当前展示和操作推导字段、数量、存储与取舍 | — |
| 公开固定刊期阅读页面需求 | 按Figma定义公开固定刊期阅读的字段、数量、操作与服务缺口，替换历史视觉基线 | — |
| 公开刊物归档页面需求 | 从 /reports/[reportId]/archive 当前展示和操作推导字段、数量、存储与取舍 | — |
| 模型综合榜页面需求 | 按Figma定义模型综合榜的字段、数量、操作与服务缺口，替换历史视觉基线 | — |
| 模型分项榜页面需求 | 从 /leaderboard/category/[board] 当前展示和操作推导字段、数量、存储与取舍 | — |
| 模型详情页面需求 | 从 /leaderboard/models/[slug] 当前展示和操作推导字段、数量、存储与取舍 | — |
| 评测来源目录页面需求 | 从 /leaderboard/sources 当前展示和操作推导字段、数量、存储与取舍 | — |
| 评测来源详情页面需求 | 从 /leaderboard/sources/[sourceKey] 当前展示和操作推导字段、数量、存储与取舍 | — |
| 模型榜计算规则页面需求 | 从 /leaderboard/rules 当前展示和操作推导字段、数量、存储与取舍 | — |
| 登录与验证注册页面需求 | 按Figma定义登录与验证注册的字段、数量、操作与服务缺口，替换历史视觉基线 | — |
| 账户与订阅设置页面需求 | 从 /account 当前展示和操作推导字段、数量、存储与取舍 | — |
| 个人工作台入口页面需求 | 复用Figma监控工作区与现有主题合同，保留兼容入口 | — |
| 监控主题工作区页面需求 | 按Figma定义监控主题工作区的字段、数量、操作与服务缺口，替换历史视觉基线 | — |
| 新建监控主题页面需求 | 从 /monitors/new 当前展示和操作推导字段、数量、存储与取舍 | — |
| 监控主题详情页面需求 | 复用Figma监控工作区与现有主题合同，保留兼容入口 | — |
| 个人告警页面需求 | 从 /alerts 当前展示和操作推导字段、数量、存储与取舍 | — |
| 私有资料列表页面需求 | 从 /content 当前展示和操作推导字段、数量、存储与取舍 | — |
| 私有资料与评论页面需求 | 从 /content/[contentId] 当前展示和操作推导字段、数量、存储与取舍 | — |
| 个人事件列表页面需求 | 从 /events 当前展示和操作推导字段、数量、存储与取舍 | — |
| 个人事件分析页面需求 | 从 /events/[eventId] 当前展示和操作推导字段、数量、存储与取舍 | — |
| 平台热榜快照页面需求 | 从 /hotlists 当前展示和操作推导字段、数量、存储与取舍 | — |
| 个人报告列表页面需求 | 从 /reports 当前展示和操作推导字段、数量、存储与取舍 | — |
| 刊期生产档案页面需求 | 从 /editions 当前展示和操作推导字段、数量、存储与取舍 | — |
| 刊期内部详情与修订页面需求 | 从 /editions/[editionId] 当前展示和操作推导字段、数量、存储与取舍 | — |
| 来源连接与采集覆盖页面需求 | 从 /sources 当前展示和操作推导字段、数量、存储与取舍 | — |
| 编辑来源配置页面需求 | 从 /editorial-sources 当前展示和操作推导字段、数量、存储与取舍 | — |
| 任务记录页面需求 | 从 /jobs 当前展示和操作推导字段、数量、存储与取舍 | — |
| 任务详情与恢复页面需求 | 从 /jobs/[jobId] 当前展示和操作推导字段、数量、存储与取舍 | — |
| 公开许可与发布管理页面需求 | 从 /publication/manage 当前展示和操作推导字段、数量、存储与取舍 | — |
| 运营工作区页面需求 | 从 /operations 当前展示和操作推导字段、数量、存储与取舍 | — |
| 模型配置与成本页面需求 | 从 /operations/models 当前展示和操作推导字段、数量、存储与取舍 | — |
| 站点联系配置页面需求 | 从 /site/manage 当前展示和操作推导字段、数量、存储与取舍 | — |
| Codex 公告日历页面需求 | 从 /codex-resets 当前展示和操作推导字段、数量、存储与取舍 | — |
| Codex 公告监控管理页面需求 | 从 /codex-resets/manage 当前展示和操作推导字段、数量、存储与取舍 | — |
| 项目文档目录页面需求 | 从 /workspace/docs 当前展示和操作推导字段、数量、存储与取舍 | — |
| 项目文档阅读与编辑页面需求 | 从 /workspace/docs/[…path] 当前展示和操作推导字段、数量、存储与取舍 | — |
| 意见反馈页面需求 | 从 /feedback 当前展示和操作推导字段、数量、存储与取舍 | — |
| 关于页面需求 | 从 /about 当前展示和操作推导字段、数量、存储与取舍 | — |
| 隐私说明页面需求 | 从 /privacy 当前展示和操作推导字段、数量、存储与取舍 | — |
| 使用条款页面需求 | 从 /terms 当前展示和操作推导字段、数量、存储与取舍 | — |
| 联系页面需求 | 从 /contact 当前展示和操作推导字段、数量、存储与取舍 | — |
| 变更记录页面需求 | 从 /changelog 当前展示和操作推导字段、数量、存储与取舍 | — |
| 订阅与导出入口页面需求 | 从 /feeds 当前展示和操作推导字段、数量、存储与取舍 | — |
| Agent 读取说明页面需求 | 从 /agent 当前展示和操作推导字段、数量、存储与取舍 | — |
产品参考
| 文档 | 摘要 | 状态 |
|---|---|---|
| 进度与优先级 | 当前版本要做什么、顺序和状态；原文在仓库根目录 BACKLOG.md | — |
| 技术架构 | 技术栈、进程、目录、领域分层、数据库与 API 约定；原文在仓库根目录 PROJECT.md | — |
| 工程规范 | 开始改动、代码约定、检查与完成标准；唯一原文在仓库根目录 AGENTS.md | — |
| 需求与验证入口 | 当前指令、需求来源与核对方式；一次用最小 POC 和可操作 demo 验证一个场景 | 需求核对中 |
| AI 任务协议 | AI 先定位需求来源，再核对事实；按一张验证卡执行并交付能复跑的证据 | 当前执行约定 |
| POC 验证卡模板 | 一张卡记录需求出处、唯一假设、最小输入输出、复跑证据与下一步 | 模板 |
| 关键词监控数据库设计 | 监控页面的存储入口；旧候选关联、四档相关性和批次扩展已从当前实施建议撤出 | — |
| 全站页面接口设计 | 按当前页面读取与提交路径复用合同，明确输入输出、分页、授权、失败恢复及不新增的接口 | — |
| 全站页面数据库设计 | 从页面数据和写入动作反推必要字段、关系、约束与查询，撤销无页面依据的新表设计 | — |
| 全站非功能需求 | 围绕当前页面的读取规模、响应状态、权限、可靠写入和可访问性定义可验证要求 | — |
| 全站验收场景 | 以当前页面主路径、真实输入输出和异常恢复验收，撤销未实现扩展的默认测试前置 | — |
| 现有接口清单 | 从生成客户端和后端路由核对 247 个函数；作为页面接口现状索引，不代表能力已验收 | — |
| 现有数据库字典 | 123 张现有表的字段、键与查询索引；SQL 仍以 backend/database/schema.sql 为唯一来源 | — |
| 页面驱动的收敛方案 | 以Figma页面为需求依据，从基础布局替换旧视觉，按最小合同承接真实服务 | — |
| 全站设计还原审查明细 | agent-browser逐页审查的52路由结果、7项问题与真实数据及合成会话证据边界 | — |
| 全站验收矩阵 | 52个代表路由的双尺寸状态证据、独立审查与Figma数据缺口，区分固定样本和真实服务 | — |
能力
| 文档 | 摘要 | 状态 | 版本 |
|---|---|---|---|
| 公开资讯阅读 | 不登录即可读到持续更新、去重、有出处的资讯、事件与刊物 | 部分可用 | V2 |
| 关键词热点 | 免费关键词发现、相关性与时间解释；当前国内 POC，后续每小时监控与热点汇总 | 部分可用 | V1 |
| 每日社媒热点 | 每天看到 X 与国内热榜上最热的事件，并附新闻报道 | 部分可用 | V1, V2 |
| 评论舆情 | 当前验证免费评论取样、父链、相关性和增量；情感、观点、告警与看板后置 | 部分可用 | V1, V2 |
| 报告、推送与知识库 | 日报周报、邮件推送与 Obsidian 知识库问答 | 部分可用 | V1, V2, 以后 |
| 模型榜与 Codex 公告 | AI 模型排名与 Codex 额度重置公告 | 部分可用 | 以后 |
| 项目文档知识库 | 工作台与 AI 共用可核对来源的项目文档，网页和 Obsidian 修改安全汇合 | 未开始 |
决策
| 文档 | 摘要 | 状态 |
|---|---|---|
| 个人非商业使用 | Ripplesight 仅供个人非商业使用 | 生效 |
| 第三方费用为零 | 不购买任何 API、代理、打码或云端模型 | 生效 |
| 模型只用本机 Codex | 相关性、情感、观点、写作、问答都走本机 Codex app-server | 生效 |
| 只采公开或本人可见内容 | 不发帖、不互动、不读私密内容 | 生效 |
| 登录平台用本人单账号 | B 站、微博、抖音、小红书、X 都用本人单账号低频采集 | 生效 |
| X 不用官方 API | X 每日热点读公开趋势页，推文和回复走本人账号试点 | 生效 |
| Reddit 只走官方 API | Reddit 获批之前不发任何请求 | 生效 |
| 优先复用开源项目 | MIT 可改编并署名，GPL 只参考，无许可证不用 | 生效 |
| 凭据只留在本机 | token 与 Cookie 不进日志、数据库明文、证据或前端 | 生效 |
| 数据库结构只有一个来源 | schema.sql 是唯一建表来源，测试只用独立库 | 生效 |
| 冻结范围 | 对外分发、Instagram/Facebook/Threads、Flutter App、通用浏览器采集暂不推进 | 生效 |
| “可用”的定义 | 只有真实数据跑通、页面可见才算可用 | 生效 |
验收记录
| 文档 | 摘要 | 状态 |
|---|---|---|
| 前端重新设计验收 | 8 张任务卡合入后在本机 8666 部署，用真实数据检查外壳、公开页面与工作台写入 | 2026-10-06 |
| Chrome 关键词 demo 真实与定时验收 | 复用 Chrome 登录，手动首轮与后台定时实采取得累计 4 帖 1 条根评论；长期稳定性未验收 | 2026-10-07 |
| Chrome 采集接入工作台验收 | 独立库回归与正式账号实采；定时运行器取得两帖，本轮根评论为空，持续稳定性待验收 | 2026-10-07 |
| PageContainer 全局内容区修复 | 固定位置栏与正文滚动边界已接入全站；桌面和390px实测，完整状态与审查待补 | 2026-10-07 |
| 登录注册流程修复 | 按用户要求统一邮箱和 GitHub 注册后的用户名密码设置，保留已有账号与会话 | 2026-10-07 |
| 监控工作台体验接入 | 真实监控页面结果前置、页签保留草稿与运行上下文，完成工程和受控页面检查；Claude 审查未完成 | 2026-10-07 |
| agent-browser 全站设计还原审查 | 逐路由核对桌面与核心窄屏，确认探索布局和事件旧区块偏差，区分真实服务故障与合成会话样本 | 2026-10-08 |
| subagent独立审查与全站验收 | 独立审查替代Claude，双尺寸扫描52路由并修复筛选、权限、加载和语义；真实能力及原稿数据缺口仍未通过 | 2026-10-08 |
| 设计审查问题修复 | 收敛探索辅栏和事件时间线，修正榜单空态、页面语义与开发服务断连 | 2026-10-08 |
调研
| 文档 | 摘要 | 状态 |
|---|---|---|
| 舆情监控开源方案调研 | 评论采集、X 获取、热榜、情感分析可复用的开源项目及许可 | 2026-10-06 |
| Chrome 关键词 demo 运行说明 | 复用本机 Chrome 登录的 B 站真实采集、结果页、小时调度与停止恢复操作 | 真实与定时实采通过，长期运行与评论增量待观察 |
| GitHub 免费热点与评论采集调研 | 以零付费取数为门槛，对比 GitHub 项目的 star、维护、许可、关键词与评论能力，明确可复用功能及国内覆盖缺口 | 源码桌面调研，未实测采集 |
| 关键词监控验证与交付设计 | 将免费国内关键词监控需求连接到分阶段工作包、设计追踪、验收场景与风险关口，不派发实现 | 设计提案，未派发 |
| 国内平台关键词监控 POC 验证卡 | 按国内平台逐项验证关键词到帖子、评论、相关性与时效性的完整链路；首轮进入实现 | 执行中 |
| 热点事件需求核对 | 国内平台关键词监控的源码差距、关键假设、评估协议与验收场景；业务尚未执行 | 需求已澄清，方案待验证 |
| 热点监控市场与竞品调研 | 五家商业产品与四类开源方案的官方资料对照，明确国内 POC 的差异化假设和覆盖验证问题 | 桌面调研，未试用 |
| 用户细分旅程与 POC 优先级 | 以本人主题跟踪任务为中心，分析四类需求、完整用户旅程、五项优先能力与生命周期门槛 | 产品分析提案，待用户验证 |
| 监控工作台体验设计 | 参考 Ant Design Pro 的页面信息层级，以监控结果为默认入口的桌面与移动交互设计 | 交互设计提案，待用户体验评审 |
另有术语表；新建文档用 templates/，Obsidian 看板在 views/。
写作规则
- 一份文件只讲一件事：能力文档控制在约 6000 字符以内，决策和记录各控制在约 2000 字符以内，PRD 与执行计划各控制在约 12000 字符以内。
- 用模板新建：
templates/有能力、决策、验收记录、调研、执行计划 模板；POC 验证卡直接在阅读入口提供，元数据字段不能少。当前优先用验证卡描述一个场景，避免先扩写整份方案。PRD 使用type: prd，保存到product/prd/；执行计划使用type: plan，保存到product/plan/，记录任务验收、容量和依赖，不另记任务进度。 - 规则只写一处：产品规则写在
decisions/，技术约定写在根目录的 PROJECT/AGENTS，进度只写在根目录的 BACKLOG。 - 改决策要本人同意：旧决策不删除，把
status改成废弃，并新建一条决策替代它。 - 验收结果一次一份：放在
records/，用capability字段指向对应能力，并同步更新该能力文档的status。 - 命名：文件夹用英文（
product/prd/、product/plan/、product/reference/、capabilities/、decisions/、records/、research/、templates/、views/）；文档用“两位编号-中文名”，例如capabilities/04-评论舆情.md；验收记录和调研以日期开头，例如research/2026-10-06-开源方案调研.md。编号按所在目录独立从 01 顺排，不跨 PRD、PLAN 或产品参考共用序列。新文档取本目录下一个未用的编号；完成本次分类编号修正后，已有编号不随排序或版本变动，不复用已删除编号。目录迁移或编号调整需同时更新所有链接、元数据关联与索引。 - 链接用标准相对路径
[文字](路径.md)，不用[[双链]]。 - 用简单的话写；除文件名编号和 PRD 中的 KR 外，不另起编号体系。标清用户原话、AI 提案、源码事实与运行结论；未执行不写成通过，待核对不写成已确认。