VitePress

VitePress 在企业版架构里被定位为 人类可读层 / 静态渲染层。

它负责什么

• 把 /opt/wiki-vault/canon/ 下的 markdown 渲染成可浏览静态站
• 提供 wikilink 跳转（通过 markdown-it-wikilinks 插件）
• 提供 local search（无需外部依赖）
• 输出 dist/ 静态产物，由 1Panel nginx 通过 wiki.86lux.net 暴露

它不负责什么

• 不负责真相源存储（那是 GitHub）
• 不负责 agent 阅读（agent 直接走文件系统挂载，不经过 HTTP）
• 不负责写入（VitePress 是只读视图）

为什么选 VitePress 不选其他

• markdown-first，对 Obsidian 风格 wikilink 友好
• 30s 内完成 build，可以接 5 分钟 cron 滚动重建
• 无运行时数据库，完全静态产物，nginx 即可服务
• 与 Hermes 物理解耦：站点挂了不影响 agent 运行

在整体架构中的位置

/opt/wiki-vault/canon/*.md
  -> VitePress build (cron 每 5min)
  -> /opt/wiki-site/dist/
  -> 1Panel nginx (wiki.86lux.net + Let's Encrypt SSL)
  -> 团队浏览器

关联

• GitHub — 真相源
• Gitee — 原选型，已 SUPERSEDED
• wikilink 插件 — 自研 markdown-it 插件，让 <span class="wikilink-dead" title="未找到: xxx" style="color:#c33;border-bottom:1px dashed #c33">xxx</span> 可点
• Git LFS — 二进制资产
• Docs-as-Code 发布架构
• Docs-as-Code over Feishu Publishing