Appearance
网站功能路线图（Roadmap）
内部维护清单：跟踪 geek-doc.cn 后续要加入的功能，按「流量 / 互动 / 留存 / 运营」四维度评估。 静态站红线：不引入后端 / 数据库 / 构建复杂度，优先第三方服务 + 构建期脚本生成。 更新记录：2026-08-23 初版建立。
现状基线（2026-08-23 核对）
| 项目 | 现状 |
|---|---|
| 技术栈 | Docsify 静态站，hash 路由，vue.css 亮色主题，CDN 加载，无构建步骤（git push → rsync） |
| 已有功能 | 站内搜索、上一篇/下一篇、TOC、字数统计+阅读时长、代码复制、PlantUML/kroki 渲染、图片缩放、9 个在线小工具、sitemap + IndexNow |
| 明确缺失 | 访客统计、评论区、反馈/纠错渠道、暗色模式、全文搜索、订阅、相关文章、更新日志、标签体系 |
优先级总览
| 优先级 | 功能 | 维度 | 成本 | 状态 |
|---|---|---|---|---|
| P0 | 访客统计（Umami 自托管） | 运营 | 低 | 🔲 |
| P0 | Giscus 评论区 | 互动 | 低 | 🔲（方案已出） |
| P0 | 结构化数据 JSON-LD | 流量 | 低 | 🔲 |
| P0 | 「本文是否有帮助」投票 | 互动/留存 | 低 | 🔲 |
| P0 | 纠错/反馈按钮 | 互动/留存 | 低 | 🔲 |
| P1 | 全文搜索增强 | 流量/留存 | 中 | 🔲 |
| P1 | 相关文章推荐 | 留存 | 中 | 🔲 |
| P1 | 暗色模式 | 留存 | 低 | 🔲 |
| P1 | 阅读进度追踪（学习路径） | 留存 | 中 | 🔲 |
| P1 | 更新日志 / 最近更新页 | 运营/留存 | 低 | 🔲 |
| P1 | RSS 订阅源 | 流量/留存 | 低 | 🔲 |
| P2 | 标签体系与标签索引页 | 流量 | 中 | 🔲 |
| P2 | 邮件订阅入口 | 运营 | 中 | 🔲 |
| P2 | 书签/收藏（localStorage） | 留存 | 低 | 🔲 |
| P2 | 打赏 / 公众号引流入口 | 运营 | 低 | 🔲 |
| P2 | 读者投稿 / 贡献指南页 | 运营/互动 | 低 | 🔲 |
P0 快速见效（单项 ≤ 1 天，建议先做）
1. 访客统计（Umami 自托管）——⚙️ 运营
- 现状：站内完全无统计，不知道访客来源、热门页面、跳出率，一切运营决策没有数据支撑。
- 方案：已有
tools/history/umami.md文档，在现有服务器 docker 部署 Umami（轻量、可自托管、无 Cookie 弹窗负担），index.html底部加 2 行跟踪脚本；同时用 nginx access log + GoAccess 做补充（文档已存在）。 - 产出：PV/UV、来源渠道、热门页面 Top20、文档留存曲线。
- 依赖：服务器 docker。改造点：
index.html一处。
2. Giscus 评论区——💬 互动
- 现状：技术文档站无任何互动渠道，读者无法提问/纠错/讨论。
- 方案：已出完整方案（见会话记录），docsify 适配版，仅改
index.html。 - 前置：确认 GitHub 仓库公开 + 开启 Discussions（若仓库私有则改走 Waline）。
3. 结构化数据 JSON-LD——🚦 流量
- 现状：seo/ 体系已有动态 title/description、sitemap、IndexNow，但缺结构化数据，搜索富摘要（FAQ/Article/Breadcrumb）拿不到。
- 方案：在 SEO
doneEach钩子里按当前页动态注入BreadcrumbList+Article+FAQPage（文档里已有 FAQ 块格式可解析）。纯前端，零成本。 - 产出：Bing/Google 搜索结果可展示面包屑与问答摘要，提升点击率。
4. 「本文是否有帮助」投票——💬 互动 / 🔁 留存
- 现状：无法感知哪些文档有用/无用，内容优化只能靠猜。
- 方案：正文底部两枚按钮（有帮助 / 需改进），localStorage 记录避免重复，汇总走第三方表单（腾讯问卷）或 Giscus 评论自动提交；对运营而言比评论更轻量、数据更干净。
- 产出：每篇文档的有用率排序 → 驱动内容改写优先级。
5. 纠错/反馈按钮——💬 互动 / 🔁 留存
- 现状：390+ 文档，读者发现命令错/原理错无渠道反馈。
- 方案：正文底部「发现错误？提交反馈」链接 → 第三方表单 iframe（腾讯问卷/飞书表单，结果推邮箱/IM）；同时附「在 GitHub 上编辑此页」直链（文档站标配，开源感强）。
- 依赖：表单平台账号。改造点：
index.html+ 插件doneEach。
P1 中期增强（单项 1-3 天）
6. 全文搜索增强——🚦 流量 / 🔁 留存
- 现状：docsify search 只索引标题+关键词字段，内容深埋在正文里，390+ 文档靠它找不到答案。
- 方案（二选一）：
- a) Algolia DocSearch：官方对文档站免费，抓取文档建全文索引，替换前端搜索框（需申请并等审核）；
- b) Pagefind：构建期生成全文索引（
ui-optimizeVitePress 分支天然支持），Docsify 主站引入会打破"无构建"红线，需权衡。
- 产出：命中正文内容的搜索结果，长尾流量转化。
7. 相关文章推荐——🔁 留存
- 现状：只有上一篇/下一篇线性导航，读者看完一篇不知道下一步读什么。
- 方案：构建期脚本（或前端按目录层级+关键词）生成每篇 3 条「延伸阅读」，插在正文末尾评论区之前；纯静态，可基于目录树就近匹配先上线。
- 产出：平均阅读页数提升，跨专题导流（如 top → 进程原理 → 微架构）。
8. 暗色模式——🔁 留存
- 现状：vue.css 亮色主题，技术向读者深夜阅读/终端习惯深色。
- 方案：docsify darkmode 插件（社区成熟，2 行配置），主题变量适配现有
index.html自定义 CSS（注意现有样式硬编码了部分浅色值，需逐条核对）；Giscus 评论区可随prefers-color-scheme同步 theme。 - 注意：现有
index.html里已有.dark-mode-toggle残留样式（未启用），可复用。
9. 阅读进度追踪（学习路径）——🔁 留存
- 现状：教程站读者按「五层知识金字塔」路径学习，但无法看到自己学到哪、还剩多少。
- 方案：localStorage 记录已读页面（按目录前缀分组，如
/concepts/microarch/），侧栏或首页显示各模块完成度进度条。 - 产出：回访动机（"还差 3 篇读完缓存专题"），适合教程站留存。
10. 更新日志 / 最近更新页——⚙️ 运营 / 🔁 留存
- 现状：内容持续更新，但读者感知不到"站上有什么新的"。
- 方案：构建期脚本从
git log生成最近 30 天更新列表页（/updates.md），侧栏加入口；与 sitemap 生成脚本共用机制（已有gen_sitemap.sh可参照）。 - 产出：老读者回访理由，内容更新的可见化。
11. RSS 订阅源——🚦 流量 / 🔁 留存
- 现状：纯静态站无订阅出口。
- 方案：构建期脚本从 git log/目录结构生成
public/feeds.xml（RSS 2.0），覆盖更新日志数据；RSS 读者是高粘性技术人群。 - 产出：稳定的长尾回流流量。
P2 长期运营（按需推进）
12. 标签体系与标签索引页——🚦 流量
- 390+ 文档无标签，跨目录检索弱。构建期脚本解析各文档 frontmatter/关键词生成
tags/索引页（如「epoll」「NUMA」「缓存一致性」），插入侧栏与站内互链。中成本，可放在 ui-optimize 分支验证。
13. 邮件订阅入口——⚙️ 运营
- 用第三方表单（腾讯问卷/飞书）+ 邮件推送做周刊/更新通知，
about页加订阅入口。静态站可行，依赖订阅平台稳定性和读者的邮箱转化。
14. 书签 / 收藏（localStorage）——🔁 留存
- 每页「收藏」按钮 + 收藏列表页，localStorage 纯前端实现，成本极低；对学习型读者是轻量增强，优先级低于 9。
15. 打赏 / 公众号引流——⚙️ 运营
about页与正文底部加赞赏码、公众号二维码、GitHub Star 按钮。零开发成本，运营转化入口。
16. 读者投稿 / 贡献指南页——⚙️ 运营 / 💬 互动
- 建「如何贡献」文档（GitHub PR 流程、写作规范、认领目录），把读者的勘误/投稿沉淀为 UGC，降低内容生产压力。
决策备忘
- 数据先行：P0-1（统计）是其余所有决策的前提，建议最先做。
- 评论区与投票二选一冲突：Giscus 评论 + 投票按钮可共存，但投票汇总别依赖 Giscus 评论（会被拆散），用独立表单通道。
- 「无构建」红线：主站 Docsify 保持零构建；涉及构建期的功能（7/10/11/12）先在
ui-optimizeVitePress 分支验证，再决定是否回灌主站。 - 每个功能上线后观察 1-2 周统计：无效功能及时下线，避免页面越堆越重。
- 先做的小闭环：P0 五项完成后，站点即具备「来流量（结构化数据/搜索）→ 留下（阅读/投票）→ 反馈（评论/纠错）→ 运营迭代（统计）」的最小运营闭环。