PRD：Ripplesight
本文只维护产品目标和已确认边界。当前页面的字段、数量、操作、接口、数据库和验收统一在页面专项PRD及单页需求；不在总纲复制第二套功能清单。2026-10-08用户最新明确旧前端属于冗余实现，须按Figma从layout重建；旧页面不能作为需求权威，旧V1/V2整包目标和无依据预建表仍不生效，历史原文可由Git与既有记录追溯。
1. 摘要
Ripplesight用于个人非商业的公开资讯阅读与关键词事件监控。用户能从热点、事件和日报沿来源阅读，也能设置关键词取得相关帖子及评论，分清相关性、发布时间、采集覆盖和分析状态。页面好看或表结构齐全都不等于这些链路已经真实可用。
2. 联系人
| 角色 | 职责 |
|---|---|
| Stephen Qiu | 提出需求、决定取舍、核对真实体验，提供必要账号和模型配置 |
| Codex | 按授权分析需求、收敛设计、实现与测试 |
| 独立审查者 | 本轮按用户授权使用subagent替代Claude，核查实现与验收证据；未执行不得写通过 |
3. 背景
重复搜索、噪声、评论上下文和时效不明是核心问题。现有前端已有公开阅读、监控和维护入口；本轮不把每个历史入口都扩建成完整子产品。功能必要性由Figma页面和已确认用户操作证明，存储必要性由业务事实、运行可靠性和数据依赖证明。
4. 目标
当前 POC：找到相关帖子，并读到可追溯的评论
用户已明确：按配置关键词获取相关帖子/评论，考虑相似度或相关性和时效性；长期希望覆盖国内主流以及X、Instagram等海外平台；POC先验证国内平台。AI行业/DeepSeek只是例子，不是产品只能监控AI行业的限制。
当前实施从已经接入的一个来源和一条用户路径起步：配置→受理→帖子→评论→再次运行→新增/去重→停止。来源范围、稳定性、真实评论新增与分析质量分别验收；历史B站小样本证据不推广为国内全覆盖或持续SLA。来源/真实进度见BACKLOG和既有验收记录。
成功的产品结果是：每条材料能追到来源和时间；相关/无关/未知不混淆；用户能解释为什么没有结果、为什么停止、怎样恢复。没有证据时明确未知，而非填充图表。
5. 用户群
公开读者发现和阅读资料；个人跟踪者配置主题与检查结果；维护者在来源/许可/任务异常时使用辅助入口；项目维护者使用Markdown需求支持开发。不增加企业多租户、收费套餐或原生客户端。
6. 价值主张
少做重复搜索，保留可追溯证据；一次主题配置对应一套规则与结果；阅读、采集、分析和推送的状态透明。优先让一条真实路径可用，避免以大而全的数据平台代替产品结果。
7. 方案
功能性需求与优先级
| 场景 | 当前必要能力 | 取舍 |
|---|---|---|
| 公开阅读 | 有界资讯/事件列表、来源/时间/许可、正文、固定刊期、榜单证据 | 保留原稿全站统计/趋势需求；当前合同缺失就显示未知，优先查询复用 |
| 本机收藏 | 收藏/已读ID、搜索、选择导出、主动本机搬迁 | 本机备注已实现；多类型收藏/事件关注保留待接入；不预建云同步平台 |
| 个人监控 | 主题规则、来源准入、运行/停止、最近结果、完整帖子/评论 | 复用现有jobs/content；不新增第二套运行批次 |
| 分析与告警 | 当前已有逐条相关性/情感、热度、规则/评估/投递状态 | 未验证情感比例留空；原稿有已读操作，需最小用户—评估状态关系 |
| 辅助管理 | 当前来源/任务/刊期/模型/许可/反馈/文档入口 | 维护现有服务，不默认扩建运营平台 |
当前平台范围
来源页的能力目录不是全部接通证明；关键词搜索、详情、根评论、回复和增量都需分别验证。取数不能依赖收费API；验证码/风控停止，不绕过；只采公开或本人可见内容。Instagram等长期目标不自动解除冻结范围。
相关性、相似度与去重
当前读取实际分析合同：bool相关性、情感、错误/未知和规则版本；不把旧bool转换为四档。身份去重按平台对象，不能用相似文字合并不同作者/平台/评论。四档相关性、候选留存和新模型质量指标仅在具体样本证明需要时再设计。
评论范围与时间约定
原帖、根、父、回复目标分别保留；父缺失显示未知上下文。来源发布时间、观察时间、接收时间分开；UTC存储、带时区接口、页面按约定展示。窗口左闭右开；第二轮新增与重复分开，0条/失败/部分覆盖不同。不能由抓取时间声称内容刚发布。
工程设计与非功能性需求
接口和数据库由页面读写推导；非功能以真实页大小、权限、错误恢复和可访问性为准；验收连接成用户路径。性能、容量、恢复时限、准确率没有实测就不写达标，不预设百万行平台门槛。
收敛方案说明哪些设计已撤销，哪些依赖仍需保留。唯一schema、授权、版本、许可和数据恢复仍遵守工程规范；物理删表先验证消费者和数据迁移。
8. 发布
先按Figma重建布局、组件和页面，删除旧视觉组合，统一逐页合同；再补一条已证实的真实用户路径；按实际瓶颈处理分页/批读/索引和辅助模块退役。冻结功能只保持兼容，不自动外发或扩权；既有市场/开源调研作为背景，不能自动生成接入任务。
每项结论区分源码存在、受控测试、独立库、真实平台、自然持续运行、用户体验和独立审查。实际优先级/完成状态只在BACKLOG，原能力文档中的历史KR与计划仅供追溯，不自动成为当前任务。