---
type: prd
title: PRD：全站页面需求
summary: 以当前页面字段、展示数量和操作反推需求，复用必要存储并撤销无页面依据的扩展
status: 生效
updated: 2026-10-08
---

# PRD：全站页面需求

## 1. 摘要

当前任务以Figma桌面稿为页面依据，从layout、基础组件到首页、探索、事件、日报、榜单、监控、收藏和登录重新实现。旧前端已被用户明确否定，不能作为保留视觉或撤销需求的基线。源码/生成API/schema只负责证明哪些服务可复用、哪些数据尚未开放。

逐页文档分别列出原稿字段/展示数量、现有合同、需要持久化的用户动作及缺口。统计/情感/关注/已读是设计需求，不因旧页面没有而删除；但不预建通用平台，也不把设计示例写入产品。

## 2. 联系人与职责

| 角色 | 职责 |
|---|---|
| 需求提出者 | 决定产品取舍、核对实际页面体验，提供必要账号/模型配置 |
| Codex | 从页面和服务核对字段、状态、数据依赖；实现已授权修复、精简与测试 |
| Claude | 沿用工程规范的独立代码审查与真实验收；未执行时不得记为通过 |

## 3. 背景与机会

现有主流程是公开阅读和个人关键词监控。过去设计把云同步、操作账本、情感聚合、批次系统等当成默认前置，容易先建设大量页面没有使用的数据结构。现在把每个控件连接到现有响应字段，把查询派生值和持久业务事实分开，优先维护能工作的最小闭环。

## 4. 目标与可衡量结果

| 目标 | 验收依据 |
|---|---|
| 每个主页面的数据有出处 | 任一显示字段可定位实际组件、API响应和存储或派生计算；数量注明本页、窗口或全量 |
| 每个写操作有明确结果 | 输入、持久字段、授权、冲突和结果未知的处理可解释；保存/受理/完成不混淆 |
| 消除无依据扩展 | 由原稿交互推导最小合同；每个新增或保留结构有明确读写方 |
| 不破坏正在使用的服务 | 正常/空/加载/错误/撤权，旧链接、权限、版本和运行恢复仍有验收依据 |

不以文档、表或接口数量考核完成，不将固定样本通过等同真实采集可用。

## 5. 用户细分与任务

公开读者需要从热点找到可信材料并沿来源阅读；个人跟踪者需要配置关键词、知道运行是否有效、读到帖子与评论；维护者只在来源失败、许可撤回或配置变化时使用辅助管理；项目维护者通过同一份Markdown需求支持开发。没有新增企业租户、付费订阅或原生客户端需求。

## 6. 价值主张与完整旅程

| 旅程 | 最小成功结果 |
|---|---|
| 首页/探索 → 事件/文章 → 原文 | 标题、摘要、来源、时间与许可一致，缺数据不编造统计 |
| 收藏 → 搜索 → 所选导出 | 本机ID可恢复，只导出选择且仍可公开的信息 |
| 登录 → 来源 → 新建主题 → 运行 → 结果 → 评论 | 配置保存、任务受理、实际采集、分析就绪分别可辨；失败能定位和恢复 |
| 日报/榜单 → 固定期/模型 → 引用证据 | 同一修订或计算轮次可追溯，不把历史版本拼成当前结果 |
| 页面需求 → 接口/数据 → 单个实施切片 | 需求能约束实现，历史扩展不能反过来扩大范围 |

## 7. 解决方案

### 页面总表

“当前主流程”表示原稿阅读/监控页面和必要配套；未重建的辅助页面只登记兼容合同；“现有辅助入口”记录兼容需要，不表示本轮继续扩大；“冻结兼容”保持已有决策。每个链接内包含具体展示字段、数量、动作、接口、存储取舍和验收。

| 页面／路由 | 范围 | 当前需要展示的数据和操作 |
|---|---|---|
| [今日热点](../pages/01-今日热点.md) · `/` | 当前主流程 | 四项全站指标（当前未知）；首屏6个事件，读取最多50条逐批展示；上升5项、X趋势6项与最新日报；窗口不混用 |
| [探索资讯](../pages/02-探索资讯.md) · `/discover` | 当前主流程 | 搜索与筛选：URL保存条件；搜索40条，普通30条，精选时间线20条；结果与专题：服务端过滤；下一页cursor；专题独立读取 |
| [公开专题目录](../pages/03-公开专题目录.md) · `/discover/topics` | 现有辅助入口 | 专题目录：当前返回目录；后端按许可计算计数 |
| [公开专题详情](../pages/04-公开专题详情.md) · `/discover/topics/[slug]` | 现有辅助入口 | 专题说明：单专题；精选列表：服务端每页20条，页码导航 |
| [公开事件目录](../pages/05-公开事件目录.md) · `/discover/stories` | 当前主流程 | 事件目录：一次最多20个热点，当前没有翻页控件 |
| [公开事件详情](../pages/06-公开事件详情.md) · `/discover/stories/[eventId]` | 当前主流程 | 事件概览：单事件及已有reports；进展与证据：进展每页20条，7天窗口 |
| [公开资讯阅读](../pages/07-公开资讯阅读.md) · `/items/[contentId]` | 当前主流程 | 文章与许可：单条正文；目录由正文生成；阅读状态：单条交互；滚动位置按id+revision在本机保存；上下文：按需读取关联组，每批20 |
| [收藏与阅读记录](../pages/08-收藏与阅读记录.md) · `/discover/starred` | 当前主流程 | 类型/最近或最早排序、20条/页本机回读、2000字备注、选择/取消/Markdown导出；多类型与关注仍待接入 |
| [最新公开刊物与个人报告详情](../pages/09-最新公开刊物与个人报告详情.md) · `/reports/[reportId]` | 当前主流程 | 公开最新刊物分支：目录最多6期，取最新详情和前后期；元数据另取最新1期；个人报告分支：单报告详情及显式导出 |
| [公开固定刊期阅读](../pages/10-公开固定刊期阅读.md) · `/reports/[reportId]/[key]` | 当前主流程 | 固定刊期：一份冻结刊期，正文一次读取；导航：并行读取，独立失败 |
| [公开刊物归档](../pages/11-公开刊物归档.md) · `/reports/[reportId]/archive` | 当前主流程 | 归档列表：每页20期，before_key翻页；日历：daily分支按月；周/月刊不虚构日历 |
| [模型综合榜](../pages/12-模型综合榜.md) · `/leaderboard` | 当前主流程 | 4维度、同一run排名/类型/支持指数/变化、每周动态与公告；长上下文/变化暂无合同 |
| [模型分项榜](../pages/13-模型分项榜.md) · `/leaderboard/category/[board]` | 当前主流程 | 分项榜：一份现有board响应，复用综合榜组件 |
| [模型详情](../pages/14-模型详情.md) · `/leaderboard/models/[slug]` | 当前主流程 | 模型概览：单模型；证据与比较：响应分组，比较内容折叠展开 |
| [评测来源目录](../pages/15-评测来源目录.md) · `/leaderboard/sources` | 当前主流程 | 来源目录：完整配置目录；按返回组显示 |
| [评测来源详情](../pages/16-评测来源详情.md) · `/leaderboard/sources/[sourceKey]` | 当前主流程 | 来源说明：单来源；原始成绩：当前快照行，表格内滚动 |
| [模型榜计算规则](../pages/17-模型榜计算规则.md) · `/leaderboard/rules` | 当前主流程 | 规则：一份随run版本固定的规则 |
| [登录与验证注册](../pages/18-登录与验证注册.md) · `/login` | 当前主流程 | 登录表单：一次认证动作；仅服务器公布已配置方式；登录能力和侧栏：登录选项1次；热点最多3条且失败独立 |
| [账户与订阅设置](../pages/19-账户与订阅设置.md) · `/account` | 当前主流程 | 账号资料：当前账户1份；更新后读回；凭据与订阅：明确保存或绑定，不自动提交 |
| [个人工作台入口](../pages/20-个人工作台入口.md) · `/workspace` | 现有辅助入口 | 复用监控主题工作区；管理入口收进更多 |
| [监控主题工作区](../pages/21-监控主题工作区.md) · `/topics` | 当前主流程 | 330px主题列表，连续关键词/小时命中/采集平台/规则/最近告警；结果、运行和设置次级展开，保留草稿和幂等 |
| [新建监控主题](../pages/22-新建监控主题.md) · `/monitors/new` | 当前主流程 | 新主题表单：一次创建；来源选择来自可用能力；规则预览：按按钮预览，输入改变后旧预览失效 |
| [监控主题详情](../pages/23-监控主题详情.md) · `/monitors/[topicId]` | 当前主流程 | 复用监控主题工作区，深链接选择主题，权限与版本冲突保留 |
| [个人告警](../pages/24-个人告警.md) · `/alerts` | 当前主流程 | 规则表单/列表：规则列表当前未分页；主题50/页、事件100/页读取选项；评估历史：每规则最多50条 |
| [私有资料列表](../pages/25-私有资料列表.md) · `/content` | 当前主流程 | 筛选列表：20条/页cursor；选择项来源独立读取；网页采集入口：用户显式动作；后端域名准入 |
| [私有资料与评论](../pages/26-私有资料与评论.md) · `/content/[contentId]` | 当前主流程 | 资料正文与出处：单身份及当前可读版本历史；评论树：根评论20条/页，回复另按20条加载；分析及刷新：切主题/版本读取；刷新评论明确点击 |
| [个人事件列表](../pages/27-个人事件列表.md) · `/events` | 现有辅助入口 | 事件列表：20条/页；热点另读；热点摘要：当前服务返回热点集合 |
| [个人事件分析](../pages/28-个人事件分析.md) · `/events/[eventId]` | 现有辅助入口 | 概览与固定修订：单事件，可选择已有revision；成员/事实/关联：成员20条/页；事实/关联按当前响应；热度与修订动作：历史最多48点；操作使用预期revision |
| [平台热榜快照](../pages/29-平台热榜快照.md) · `/hotlists` | 现有辅助入口 | 来源和快照：快照20条/页；选择一个快照；榜单条目：每批20条，继续加载 |
| [个人报告列表](../pages/30-个人报告列表.md) · `/reports` | 现有辅助入口 | 报告过滤与列表：20条/页cursor |
| [刊期生产档案](../pages/31-刊期生产档案.md) · `/editions` | 现有辅助入口 | 刊期档案：20期/页，按kind/before_key；申请编选：一次显式申请，完成窗口才可编选 |
| [刊期内部详情与修订](../pages/32-刊期内部详情与修订.md) · `/editions/[editionId]` | 现有辅助入口 | 内部刊物与修订：单期和修订列表；编辑：显式提交新修订 |
| [来源连接与采集覆盖](../pages/33-来源连接与采集覆盖.md) · `/sources` | 当前主流程 | 来源连接：来源目录及选中连接；采集覆盖：窗口20条/页；详情单独读；固定时间窗；Chrome绑定：明确启用操作；不在页面存Cookie |
| [编辑来源配置](../pages/34-编辑来源配置.md) · `/editorial-sources` | 现有辅助入口 | 编辑来源配置：现有运营列表和表单；预览/材料/运行：材料20条/页；运行最多100条；先选来源；准入与图标：显式维护动作；令牌仅内存 |
| [任务记录](../pages/35-任务记录.md) · `/jobs` | 当前主流程 | 任务列表：20条/页cursor；连续失败：独立失败汇总 |
| [任务详情与恢复](../pages/36-任务详情与恢复.md) · `/jobs/[jobId]` | 当前主流程 | 执行详情：单job，显式刷新；有界窗口响应；恢复与取消：仅服务器允许状态可操作 |
| [公开许可与发布管理](../pages/37-公开许可与发布管理.md) · `/publication/manage` | 现有辅助入口 | 许可管理：运营逐来源或逐内容修改；分析与恢复：按需查询单任务 |
| [运营工作区](../pages/38-运营工作区.md) · `/operations` | 现有辅助入口 | 健康与维护：按当前API聚合；反馈与审计：反馈和审计20条/页；通知与评测：通知50条/页；评测明细50条/页 |
| [模型配置与成本](../pages/39-模型配置与成本.md) · `/operations/models` | 现有辅助入口 | 模型配置：一份配置；逐能力显式切换；成本与熔断：按天窗口汇总，确认成本异常需原因 |
| [站点联系配置](../pages/40-站点联系配置.md) · `/site/manage` | 现有辅助入口 | 联系配置：一份站点配置，显式保存 |
| [Codex 公告日历](<../pages/41-Codex 公告日历.md>) · `/codex-resets` | 现有辅助入口 | 日历与事件：按当前日历范围，60秒版本探测见源码；不新采集；健康与原帖：原帖按既有page参数 |
| [Codex 公告监控管理](<../pages/42-Codex 公告监控管理.md>) · `/codex-resets/manage` | 现有辅助入口 | 监控配置与复核：按需读取/保存；人工触发须显式操作 |
| [项目文档目录](../pages/43-项目文档目录.md) · `/workspace/docs` | 现有辅助入口 | 文档目录：读取允许清单目录；搜索命中返回snippet/section/anchor；检索：只检索当前允许快照 |
| [项目文档阅读与编辑](../pages/44-项目文档阅读与编辑.md) · `/workspace/docs/[...path]` | 现有辅助入口 | 阅读：1文档+目录；历史显式选择；草稿与发布：读、写、发布各按允许清单；发布原子切换 |
| [意见反馈](../pages/45-意见反馈.md) · `/feedback` | 现有辅助入口 | 反馈表单：一次主动提交；限制以现有输入合同为准 |
| [关于](../pages/46-关于.md) · `/about` | 现有辅助入口 | 产品说明：静态正文 |
| [隐私说明](../pages/47-隐私说明.md) · `/privacy` | 现有辅助入口 | 隐私说明：静态正文 |
| [使用条款](../pages/48-使用条款.md) · `/terms` | 现有辅助入口 | 使用条款：静态正文 |
| [联系](../pages/49-联系.md) · `/contact` | 现有辅助入口 | 公开联系：一份可公开联系配置；未配置给说明 |
| [变更记录](../pages/50-变更记录.md) · `/changelog` | 现有辅助入口 | 变更说明：静态发布说明 |
| [订阅与导出入口](../pages/51-订阅与导出入口.md) · `/feeds` | 冻结兼容 | 订阅说明：静态链接；不触发采集 |
| [Agent 读取说明](<../pages/52-Agent 读取说明.md>) · `/agent` | 冻结兼容 | Agent说明与快照：说明1份；快照用户主动下载 |

### 共用功能和业务规则

- 页面布局用现有shadcn/Radix和语义组件；各页使用同一标题、输入、错误和空态规范。不为旧固定header保留未使用分支。
- 公开列表只读许可投影；个人资料按会话owner隔离。公私详情相似不能合并授权边界。
- 主题三个入口共用TopicsWorkspace；资料正文、评论、事件和报告引用共用内容身份与版本，不按页面复制。
- URL保存查询/页签；临时选择和草稿在组件；本机收藏/阅读位置在localStorage；业务配置和结果才写持久库。
- 统计用当前查询范围，不把首页50事件上限或主题最近5条外推为全站总量；null和真实0不同。
- RSS、MCP/Agent、海报等仍受冻结决策约束。源码已有入口只表示兼容存在，不代表重新授权扩建。

### 数据与接口交付

[接口设计](../reference/08-全站页面接口设计.md)按当前读取/写入路径定义合同；[数据库设计](../reference/09-全站页面数据库设计.md)给出字段、关系、键、查询与删除要求；[非功能要求](../reference/10-全站非功能需求.md)定义有界性能和错误/权限行为；[验收场景](../reference/11-全站验收场景.md)覆盖真实用户旅程。现有接口与表字典仅为查证材料，不是建设清单。

### 能力追踪、取舍和假设

Figma的全站统计、24小时曲线、情感、关注、多类型收藏和告警已读仍是需求；现有服务缺失时保留对应空态，按最小合同分切片接入。通用账本、并行批次状态机和默认云同步不作为前置。具体取舍见[收敛方案](../reference/14-页面驱动的收敛方案.md)。物理删表须核对消费者、迁移与恢复，不因前端重建直接执行。

## 8. 发布顺序与关口

先按原稿重建布局和主页面、用Figma单页合同替换旧视觉方案；再按阅读/监控的一条真实路径修补已证实缺口；最后根据实际瓶颈决定按需聚合、批量读取或辅助模块退役。没有固定日期和整包V1/V2扩建承诺。

每次只交付一个可以独立验证、回滚的变化。源码检查、受控样本、独立库、真实平台、连续运行和用户体验分别记录；进度唯一来源为BACKLOG，不在本PRD另建执行账本。
