PRD：全站页面需求
1. 摘要
当前任务以Figma桌面稿为页面依据，从layout、基础组件到首页、探索、事件、日报、榜单、监控、收藏和登录重新实现。旧前端已被用户明确否定，不能作为保留视觉或撤销需求的基线。源码/生成API/schema只负责证明哪些服务可复用、哪些数据尚未开放。
逐页文档分别列出原稿字段/展示数量、现有合同、需要持久化的用户动作及缺口。统计/情感/关注/已读是设计需求，不因旧页面没有而删除；但不预建通用平台，也不把设计示例写入产品。
2. 联系人与职责
| 角色 | 职责 |
|---|---|
| 需求提出者 | 决定产品取舍、核对实际页面体验，提供必要账号/模型配置 |
| Codex | 从页面和服务核对字段、状态、数据依赖；实现已授权修复、精简与测试 |
| Claude | 沿用工程规范的独立代码审查与真实验收；未执行时不得记为通过 |
3. 背景与机会
现有主流程是公开阅读和个人关键词监控。过去设计把云同步、操作账本、情感聚合、批次系统等当成默认前置，容易先建设大量页面没有使用的数据结构。现在把每个控件连接到现有响应字段，把查询派生值和持久业务事实分开，优先维护能工作的最小闭环。
4. 目标与可衡量结果
| 目标 | 验收依据 |
|---|---|
| 每个主页面的数据有出处 | 任一显示字段可定位实际组件、API响应和存储或派生计算；数量注明本页、窗口或全量 |
| 每个写操作有明确结果 | 输入、持久字段、授权、冲突和结果未知的处理可解释；保存/受理/完成不混淆 |
| 消除无依据扩展 | 由原稿交互推导最小合同；每个新增或保留结构有明确读写方 |
| 不破坏正在使用的服务 | 正常/空/加载/错误/撤权，旧链接、权限、版本和运行恢复仍有验收依据 |
不以文档、表或接口数量考核完成，不将固定样本通过等同真实采集可用。
5. 用户细分与任务
公开读者需要从热点找到可信材料并沿来源阅读；个人跟踪者需要配置关键词、知道运行是否有效、读到帖子与评论；维护者只在来源失败、许可撤回或配置变化时使用辅助管理；项目维护者通过同一份Markdown需求支持开发。没有新增企业租户、付费订阅或原生客户端需求。
6. 价值主张与完整旅程
| 旅程 | 最小成功结果 |
|---|---|
| 首页/探索 → 事件/文章 → 原文 | 标题、摘要、来源、时间与许可一致，缺数据不编造统计 |
| 收藏 → 搜索 → 所选导出 | 本机ID可恢复，只导出选择且仍可公开的信息 |
| 登录 → 来源 → 新建主题 → 运行 → 结果 → 评论 | 配置保存、任务受理、实际采集、分析就绪分别可辨；失败能定位和恢复 |
| 日报/榜单 → 固定期/模型 → 引用证据 | 同一修订或计算轮次可追溯，不把历史版本拼成当前结果 |
| 页面需求 → 接口/数据 → 单个实施切片 | 需求能约束实现，历史扩展不能反过来扩大范围 |
7. 解决方案
页面总表
“当前主流程”表示原稿阅读/监控页面和必要配套；未重建的辅助页面只登记兼容合同；“现有辅助入口”记录兼容需要，不表示本轮继续扩大；“冻结兼容”保持已有决策。每个链接内包含具体展示字段、数量、动作、接口、存储取舍和验收。
| 页面／路由 | 范围 | 当前需要展示的数据和操作 |
|---|---|---|
今日热点 · / | 当前主流程 | 四项全站指标（当前未知）；首屏6个事件，读取最多50条逐批展示；上升5项、X趋势6项与最新日报；窗口不混用 |
探索资讯 · /discover | 当前主流程 | 搜索与筛选：URL保存条件；搜索40条，普通30条，精选时间线20条；结果与专题：服务端过滤；下一页cursor；专题独立读取 |
公开专题目录 · /discover/topics | 现有辅助入口 | 专题目录：当前返回目录；后端按许可计算计数 |
公开专题详情 · /discover/topics/[slug] | 现有辅助入口 | 专题说明：单专题；精选列表：服务端每页20条，页码导航 |
公开事件目录 · /discover/stories | 当前主流程 | 事件目录：一次最多20个热点，当前没有翻页控件 |
公开事件详情 · /discover/stories/[eventId] | 当前主流程 | 事件概览：单事件及已有reports；进展与证据：进展每页20条，7天窗口 |
公开资讯阅读 · /items/[contentId] | 当前主流程 | 文章与许可：单条正文；目录由正文生成；阅读状态：单条交互；滚动位置按id+revision在本机保存；上下文：按需读取关联组，每批20 |
收藏与阅读记录 · /discover/starred | 当前主流程 | 类型/最近或最早排序、20条/页本机回读、2000字备注、选择/取消/Markdown导出；多类型与关注仍待接入 |
最新公开刊物与个人报告详情 · /reports/[reportId] | 当前主流程 | 公开最新刊物分支：目录最多6期，取最新详情和前后期；元数据另取最新1期；个人报告分支：单报告详情及显式导出 |
公开固定刊期阅读 · /reports/[reportId]/[key] | 当前主流程 | 固定刊期：一份冻结刊期，正文一次读取；导航：并行读取，独立失败 |
公开刊物归档 · /reports/[reportId]/archive | 当前主流程 | 归档列表：每页20期，before_key翻页；日历：daily分支按月；周/月刊不虚构日历 |
模型综合榜 · /leaderboard | 当前主流程 | 4维度、同一run排名/类型/支持指数/变化、每周动态与公告；长上下文/变化暂无合同 |
模型分项榜 · /leaderboard/category/[board] | 当前主流程 | 分项榜：一份现有board响应，复用综合榜组件 |
模型详情 · /leaderboard/models/[slug] | 当前主流程 | 模型概览：单模型；证据与比较：响应分组，比较内容折叠展开 |
评测来源目录 · /leaderboard/sources | 当前主流程 | 来源目录：完整配置目录；按返回组显示 |
评测来源详情 · /leaderboard/sources/[sourceKey] | 当前主流程 | 来源说明：单来源；原始成绩：当前快照行，表格内滚动 |
模型榜计算规则 · /leaderboard/rules | 当前主流程 | 规则：一份随run版本固定的规则 |
登录与验证注册 · /login | 当前主流程 | 登录表单：一次认证动作；仅服务器公布已配置方式；登录能力和侧栏：登录选项1次；热点最多3条且失败独立 |
账户与订阅设置 · /account | 当前主流程 | 账号资料：当前账户1份；更新后读回；凭据与订阅：明确保存或绑定，不自动提交 |
个人工作台入口 · /workspace | 现有辅助入口 | 复用监控主题工作区；管理入口收进更多 |
监控主题工作区 · /topics | 当前主流程 | 330px主题列表，连续关键词/小时命中/采集平台/规则/最近告警；结果、运行和设置次级展开，保留草稿和幂等 |
新建监控主题 · /monitors/new | 当前主流程 | 新主题表单：一次创建；来源选择来自可用能力；规则预览：按按钮预览，输入改变后旧预览失效 |
监控主题详情 · /monitors/[topicId] | 当前主流程 | 复用监控主题工作区，深链接选择主题，权限与版本冲突保留 |
个人告警 · /alerts | 当前主流程 | 规则表单/列表：规则列表当前未分页；主题50/页、事件100/页读取选项；评估历史：每规则最多50条 |
私有资料列表 · /content | 当前主流程 | 筛选列表：20条/页cursor；选择项来源独立读取；网页采集入口：用户显式动作；后端域名准入 |
私有资料与评论 · /content/[contentId] | 当前主流程 | 资料正文与出处：单身份及当前可读版本历史；评论树：根评论20条/页，回复另按20条加载；分析及刷新：切主题/版本读取；刷新评论明确点击 |
个人事件列表 · /events | 现有辅助入口 | 事件列表：20条/页；热点另读；热点摘要：当前服务返回热点集合 |
个人事件分析 · /events/[eventId] | 现有辅助入口 | 概览与固定修订：单事件，可选择已有revision；成员/事实/关联：成员20条/页；事实/关联按当前响应；热度与修订动作：历史最多48点；操作使用预期revision |
平台热榜快照 · /hotlists | 现有辅助入口 | 来源和快照：快照20条/页；选择一个快照；榜单条目：每批20条，继续加载 |
个人报告列表 · /reports | 现有辅助入口 | 报告过滤与列表：20条/页cursor |
刊期生产档案 · /editions | 现有辅助入口 | 刊期档案：20期/页，按kind/before_key；申请编选：一次显式申请，完成窗口才可编选 |
刊期内部详情与修订 · /editions/[editionId] | 现有辅助入口 | 内部刊物与修订：单期和修订列表；编辑：显式提交新修订 |
来源连接与采集覆盖 · /sources | 当前主流程 | 来源连接：来源目录及选中连接；采集覆盖：窗口20条/页；详情单独读；固定时间窗；Chrome绑定：明确启用操作；不在页面存Cookie |
编辑来源配置 · /editorial-sources | 现有辅助入口 | 编辑来源配置：现有运营列表和表单；预览/材料/运行：材料20条/页；运行最多100条；先选来源；准入与图标：显式维护动作；令牌仅内存 |
任务记录 · /jobs | 当前主流程 | 任务列表：20条/页cursor；连续失败：独立失败汇总 |
任务详情与恢复 · /jobs/[jobId] | 当前主流程 | 执行详情：单job，显式刷新；有界窗口响应；恢复与取消：仅服务器允许状态可操作 |
公开许可与发布管理 · /publication/manage | 现有辅助入口 | 许可管理：运营逐来源或逐内容修改；分析与恢复：按需查询单任务 |
运营工作区 · /operations | 现有辅助入口 | 健康与维护：按当前API聚合；反馈与审计：反馈和审计20条/页；通知与评测：通知50条/页；评测明细50条/页 |
模型配置与成本 · /operations/models | 现有辅助入口 | 模型配置：一份配置；逐能力显式切换；成本与熔断：按天窗口汇总，确认成本异常需原因 |
站点联系配置 · /site/manage | 现有辅助入口 | 联系配置：一份站点配置，显式保存 |
Codex 公告日历 · /codex-resets | 现有辅助入口 | 日历与事件：按当前日历范围，60秒版本探测见源码；不新采集；健康与原帖：原帖按既有page参数 |
Codex 公告监控管理 · /codex-resets/manage | 现有辅助入口 | 监控配置与复核：按需读取/保存；人工触发须显式操作 |
项目文档目录 · /workspace/docs | 现有辅助入口 | 文档目录：读取允许清单目录；搜索命中返回snippet/section/anchor；检索：只检索当前允许快照 |
项目文档阅读与编辑 · /workspace/docs/[...path] | 现有辅助入口 | 阅读：1文档+目录；历史显式选择；草稿与发布：读、写、发布各按允许清单；发布原子切换 |
意见反馈 · /feedback | 现有辅助入口 | 反馈表单：一次主动提交；限制以现有输入合同为准 |
关于 · /about | 现有辅助入口 | 产品说明：静态正文 |
隐私说明 · /privacy | 现有辅助入口 | 隐私说明：静态正文 |
使用条款 · /terms | 现有辅助入口 | 使用条款：静态正文 |
联系 · /contact | 现有辅助入口 | 公开联系：一份可公开联系配置；未配置给说明 |
变更记录 · /changelog | 现有辅助入口 | 变更说明：静态发布说明 |
订阅与导出入口 · /feeds | 冻结兼容 | 订阅说明：静态链接；不触发采集 |
Agent 读取说明 · /agent | 冻结兼容 | Agent说明与快照：说明1份；快照用户主动下载 |
共用功能和业务规则
- 页面布局用现有shadcn/Radix和语义组件；各页使用同一标题、输入、错误和空态规范。不为旧固定header保留未使用分支。
- 公开列表只读许可投影；个人资料按会话owner隔离。公私详情相似不能合并授权边界。
- 主题三个入口共用TopicsWorkspace；资料正文、评论、事件和报告引用共用内容身份与版本，不按页面复制。
- URL保存查询/页签；临时选择和草稿在组件；本机收藏/阅读位置在localStorage；业务配置和结果才写持久库。
- 统计用当前查询范围，不把首页50事件上限或主题最近5条外推为全站总量；null和真实0不同。
- RSS、MCP/Agent、海报等仍受冻结决策约束。源码已有入口只表示兼容存在，不代表重新授权扩建。
数据与接口交付
接口设计按当前读取/写入路径定义合同；数据库设计给出字段、关系、键、查询与删除要求；非功能要求定义有界性能和错误/权限行为；验收场景覆盖真实用户旅程。现有接口与表字典仅为查证材料，不是建设清单。
能力追踪、取舍和假设
Figma的全站统计、24小时曲线、情感、关注、多类型收藏和告警已读仍是需求；现有服务缺失时保留对应空态，按最小合同分切片接入。通用账本、并行批次状态机和默认云同步不作为前置。具体取舍见收敛方案。物理删表须核对消费者、迁移与恢复，不因前端重建直接执行。
8. 发布顺序与关口
先按原稿重建布局和主页面、用Figma单页合同替换旧视觉方案；再按阅读/监控的一条真实路径修补已证实缺口；最后根据实际瓶颈决定按需聚合、批量读取或辅助模块退役。没有固定日期和整包V1/V2扩建承诺。
每次只交付一个可以独立验证、回滚的变化。源码检查、受控样本、独立库、真实平台、连续运行和用户体验分别记录；进度唯一来源为BACKLOG，不在本PRD另建执行账本。