4.9 KiB

Raw Blame History

个人主页子页面化能力评审设计（导航中枢模式）

1. 背景与目标

当前项目已经具备公开主页与多个公开子页面能力，用户可以从个人主页进入文章、时光机、阅读（RSS）等模块。
本次评审目标是将 @slug 主页明确定位为“导航中枢”，避免主页继续演化为内容聚合长页。

目标如下：

@slug 仅承担入口分发职责，不承担长内容阅读。
文章、时光机、阅读均为一等子页面，具备独立列表与分页能力。
公开、仅链接、私密三种可见性在公开侧严格边界清晰。
新增模块可按统一规范接入，保持长期可扩展性。

2. 方案结论

本次评审采用 方案 1：导航中枢。

主页只展示身份信息、模块入口卡片、每模块 1-2 条预览和“查看全部”。
子页面承载完整列表、详情跳转与后续模块特有能力。
首页不引入模块专属复杂交互（例如筛选、排序、阅读模式）。

3. 信息架构

3.1 页面定位

@slug：个人站首页（目录页 / 导航中枢）
@slug/posts：文章列表页
@slug/timeline：时光机列表页
@slug/reading：阅读（RSS）列表页

3.2 入口层级

一级入口：文章 / 时光机 / 阅读模块卡片
二级入口：卡片内最近 1-2 条预览
三级入口：统一“查看全部”按钮进入子页

3.3 内容边界

首页每模块最多展示 2 条预览（建议可配置，默认 2）。
首页不展示完整正文，不承载深度浏览流程。
详情阅读、历史翻页、重度交互全部下沉到子页面。

3.4 可扩展约束

新增公开模块必须满足：

提供 @slug/<module> 独立子页
在 @slug 提供模块卡片入口
提供统一“查看全部”跳转

4. 入口组件规范

4.1 卡片结构（统一骨架）

每个模块卡片应包含：

标题行：模块名 + 公开总数（如“文章 · 24”）
描述行：模块价值说明（10-18 字）
预览区：最近 1-2 条（标题 + 日期/来源）
操作区：主按钮“查看全部”，次按钮按需配置

4.2 文案规范

文章：查看全部文章
时光机：查看全部动态
阅读：查看阅读清单

文案采用“动作 + 对象”，避免“更多”等弱语义措辞。

4.3 状态规范

正常态：展示预览条目
空态：显示“暂无公开内容”并给出轻提示
异常态：显示“暂时不可用”，不暴露技术细节

4.4 一致性规则

固定顺序：文章 → 时光机 → 阅读
预览排序：统一按时间倒序
交互一致：卡片整体可点、预览可点、CTA 始终可见

5. 可见性与数据口径

5.1 公开侧展示规则

@slug 主页仅展示 public 内容。
@slug/posts、@slug/timeline、@slug/reading 公开访问仅返回 public 内容。
首页卡片计数与子页总数均以 public 口径计算。

5.2 仅链接（unlisted）规则

不进入 @slug 首页预览与计数。
不进入公开子页列表。
仅允许通过 token 链接访问（例如 /p/:publicSlug/t/:shareToken）。

5.3 私密（private）规则

仅后台站主可见。
不进入任何公开 API 返回。
不进入 sitemap 与公开聚合统计。

5.4 口径一致性要求

同一模块在以下位置的“数量与内容范围”必须一致：

首页卡片总数
子页分页总数
公开 SEO/结构化数据中的条目数

6. 风险评审结论

6.1 高风险

统计口径不一致导致用户信任受损
unlisted 意外进入公开列表导致泄漏

6.2 中风险

主页功能膨胀回归为内容聚合页
主页与子页 SEO 信号冲突
新模块接入方式不统一导致维护复杂度上升

6.3 低风险

首页聚合请求过重影响首屏性能

7. 验收标准（最小集）

访客访问 @slug 仅看到公开模块与公开预览。
unlisted 内容无法通过首页与公开子页列表发现，仅 token 可达。
子页分页总数与首页模块计数口径一致。
模块空态与异常态表现统一，不影响其他模块。
主页与子页 canonical 各自独立，unlisted 不进入 sitemap。
新模块可按“卡片入口 + 独立子页 + 查看全部”模板接入。

8. 实施边界（本次仅设计评审）

本文件仅确认信息架构与评审结论，不直接包含代码改造。
下一步应进入实现规划阶段，将本设计拆分为可执行任务（路由、数据聚合、组件抽象、SEO 与测试）。

9. 规格自检（已完成）

已检查：无 TBD/TODO 占位符。
已检查：信息架构、可见性规则、验收标准之间无明显冲突。
已检查：范围聚焦于“导航中枢化评审”，未引入无关重构。
已检查：关键术语（公开/仅链接/私密）定义明确，口径一致。

4.9 KiB Raw Blame History