知识页面的维护与发布
本流程用于把可复用的理解整理成知识,并选择适合读者的内容进入官网。内容类型与状态的含义见知识、文章与视图。
先理解已有内容
先查相关主题与已有页面,再回到资料或实际代码核对。优先修正已有知识;如果解决的是不同问题,再建立新页。一次聊天不必自动成为知识。
写清依据与边界
新页用日期前缀命名,并设置稳定 ID、标题、类型、主题、状态、置信度、更新时间和来源类型。来源写在正文 Sources 或元数据中。新页默认内部可见,避免把尚未完成的推测直接发布。
同一个 ID 始终代表同一个知识页面。移动文件时保持 ID,并修正源文件之间的相对链接。现有官网 URL 可以通过视图配置继续保留。
按内容维护主题
主题不限定技术领域。阅读正文后选取 1–3 个简洁的名称,例如“图形渲染”“诗词”“职场感悟”;优先复用语义相同的已有主题。文章内容改变时同步复核主题,避免根据文件名或作者给文章套上不相关的类别。
知识库会汇总当前目录中各页面的主题:新主题有文章进入目录时出现,最后一篇相关内容撤下或改类时消失。不需要修改前端分类表。AI 或维护者在内容维护阶段完成语义归类,网站构建只读取已经确定的主题。
选择阅读入口
准备公开时,将页面标为 public,再在官网视图中按 ID 选入,指定地址、分组和顺序。一个页面可以通过不同主题找到,正文不会因此复制多份。
公开页面的引用目标也应有明确的公开版本。遇到内部资料,应整理可公开的引用说明,不能为了让链接通过而自动公开原始材料。
验证后发布
维护者依次进行知识校验、发布规则测试和全站构建,并检查页面、图片、引用与搜索。预览确认后,再沿用项目既有的上线流程。
知识有效性变化时更新状态和说明;重要变化进入知识日志。撤下公开页面需要同时检查引用它的其他页面,避免留下断链。
Sources
- 01Joy 在 2026-09-10 确定的知识维护与官网发布流程。
- VitePress frontmatter。