Skip to content

项目地图

这份地图解决什么问题

这个知识库的目标不是收集一切资料,而是让常用信息有固定入口,回来就能找到。

当前分层

层级作用典型内容
项目入口快速进入项目启动方式、目录结构、常用命令
开发笔记记录理解和判断背景、结论、限制、待补内容
操作手册固化高频流程发布步骤、检查清单、写作流程
工具提供可直接使用的网页能力图标转换、浏览器本地处理工具
Demo 页面给后续写作提供模板主题页、笔记页、操作页、复盘页
归档收住旧内容历史实验、旧草稿、未整理材料

这次改造后的主入口

  • 首页负责总览和入口分发。
  • start 负责“怎么开始”。
  • notes 负责“理解和记录”。
  • playbooks 负责“照着执行”。
  • toolbox 负责“打开就能用”的稳定网页工具。
  • demo 负责“给出样例”。
  • archive 负责“把旧内容收住,不干扰主路径”。

后续补充建议

  1. 先补高频问题,例如环境配置、发版步骤、常见报错。
  2. 再补业务理解,例如模块说明、关键流程、权限规则。
  3. 低频旧资料不要删,统一收进归档说明。

TIP

如果一篇内容既像笔记又像步骤,把“结论”写进 notes,把“执行方法”写进 playbooks,不要混在同一页。

基于 VitePress 的个人知识库骨架