--- type: index title: Ripplesight 需求 workspace summary: 先核对需求，再用最小 POC 与 demo 验证；人和 AI 共用的阅读入口 updated: 2026-10-08 --- # Ripplesight 需求 workspace **当前阶段：以 Figma 桌面稿为准，从 layout、组件和页面重新复现。当前前端本身是待替换的历史实现。** 页面/API/表数量不是交付目标；先回答用户要看到什么、操作什么、为什么要保存，再决定是否改接口与数据库。实际任务进度只在BACKLOG。 | 当前入口 | 用途 | |---|---| | [页面需求总纲](product/prd/03-PRD-全站页面需求.md) | 按主流程、辅助入口、冻结兼容组织页面，逐页定义字段、数量和操作 | | [页面驱动的收敛方案](product/reference/14-页面驱动的收敛方案.md) | 哪些设计已撤销、为什么保留必要依赖、怎样退役旧实现 | | [页面接口设计](product/reference/08-全站页面接口设计.md) | 当前读写合同、版本/权限/失败恢复，不预建新接口平台 | | [页面数据库设计](product/reference/09-全站页面数据库设计.md) | 必要持久字段、派生查询、本机状态、关系/约束和删除迁移 | | [非功能要求](product/reference/10-全站非功能需求.md) · [验收场景](product/reference/11-全站验收场景.md) | 当前页大小、状态、权限、可靠性和用户路径，实测结论另记 | | [产品总纲](product/prd/01-PRD.md) · [需求来源](product/reference/04-需求与验证入口.md) | 用户目标、零费用和已确认边界；历史原话不自动派发 | | [进度与优先级](product/reference/01-进度与优先级.md) | BACKLOG顶部的当前任务及证据 | GitHub/市场调研、旧执行计划和验收记录按需追溯，不再作为当前入口的必读扩建清单。旧版本KR和提案不因为仍能检索就成为当前需求。Figma视觉、现有接口与真实平台可用性分别核对。 ## 阅读顺序 给人和 AI 的建议顺序： 1. [需求与验证入口](product/reference/04-需求与验证入口.md) → [AI 任务协议](product/reference/05-AI任务协议.md) → [进度与优先级](product/reference/01-进度与优先级.md)的当前检查点。 2. 先核对 Figma 原稿与 frontend/DESIGN.md，再按实际接口依赖阅读[页面需求](product/prd/03-PRD-全站页面需求.md#页面总表)、[收敛结论](product/reference/14-页面驱动的收敛方案.md)及源码，核对输入、输出与数量。 3. 阅读相关[决策](#决策)与[工程规范](product/reference/03-工程规范.md)，只补充当前场景需要的边界。 4. 获准验证后，用一张 POC 卡限定范围；需要核对实现时再读源码、[技术架构](product/reference/02-技术架构.md)和实际证据。 5. 原执行计划（`product/plan/`）作为历史执行依据按需查阅；当前阶段不据大计划自动推进实现。 原工作台文档知识库需求，见[workspace 项目知识库专项 PRD](product/prd/02-PRD-workspace项目知识库.md)与[执行计划](product/plan/01-PLAN-workspace项目知识库.md)。它们保留原文；本轮只复用已有阅读工具，不扩建文档平台。 每份文档开头都有元数据（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 的页面信息层级，以监控结果为默认入口的桌面与移动交互设计 | 交互设计提案，待用户体验评审 | 另有[术语表](01-术语表.md)；新建文档用 `templates/`，Obsidian 看板在 `views/`。 ## 写作规则 1. **一份文件只讲一件事**：能力文档控制在约 6000 字符以内，决策和记录各控制在约 2000 字符以内，PRD 与执行计划各控制在约 12000 字符以内。 2. **用模板新建**：`templates/` 有能力、决策、验收记录、调研、[执行计划](templates/05-执行计划.md)模板；[POC 验证卡](product/reference/06-POC验证卡.md)直接在阅读入口提供，元数据字段不能少。当前优先用验证卡描述一个场景，避免先扩写整份方案。PRD 使用 `type: prd`，保存到 `product/prd/`；执行计划使用 `type: plan`，保存到 `product/plan/`，记录任务验收、容量和依赖，不另记任务进度。 3. **规则只写一处**：产品规则写在 `decisions/`，技术约定写在根目录的 PROJECT/AGENTS，进度只写在根目录的 BACKLOG。 4. **改决策要本人同意**：旧决策不删除，把 `status` 改成 `废弃`，并新建一条决策替代它。 5. **验收结果一次一份**：放在 `records/`，用 `capability` 字段指向对应能力，并同步更新该能力文档的 `status`。 6. **命名**：文件夹用英文（`product/prd/`、`product/plan/`、`product/reference/`、`capabilities/`、`decisions/`、`records/`、`research/`、`templates/`、`views/`）；文档用“两位编号-中文名”，例如 `capabilities/04-评论舆情.md`；验收记录和调研以日期开头，例如 `research/2026-10-06-开源方案调研.md`。**编号按所在目录独立从 01 顺排，不跨 PRD、PLAN 或产品参考共用序列**。新文档取本目录下一个未用的编号；完成本次分类编号修正后，已有编号不随排序或版本变动，不复用已删除编号。目录迁移或编号调整需同时更新所有链接、元数据关联与索引。 7. **链接用标准相对路径** `[文字](路径.md)`，不用 `[[双链]]`。 8. 用简单的话写；除文件名编号和 PRD 中的 KR 外，不另起编号体系。标清用户原话、AI 提案、源码事实与运行结论；未执行不写成通过，待核对不写成已确认。