用途:把生成的 Wiki Markdown 页面转换打包成可浏览的 VitePress 静态站点,产出 HTML 构建结果。
主要能力:在 wiki-site/ 目录生成 VitePress 脚手架(.vitepress/config.mts、theme/index.ts、custom.css、public/、package.json、index.md)。config.mts 使用 vitepress-plugin-mermaid 的 withMermaid 包装器,设置 appearance: 'dark' 深色主题,并按目录结构配置 themeConfig.nav 与 sidebar,同时设置 Mermaid 深色主题变量。
暗色 Mermaid 采用三层修复:主题变量、custom.css 中带 !important 的 CSS 覆盖、theme/index.ts 内 onMounted 轮询替换 Mermaid 内联 style。点击放大通过遍历 .mermaid 容器添加点击监听,创建全屏 .mermaid-zoom-modal 模态框实现。构建前扫描 .md 文件做后处理:将 <br/> 替换为 <br>,把代码围栏外的裸 <T> 泛型参数用反引号包裹,确保每个页面有含 title 和 description 的 YAML frontmatter。
使用方式:由用户请求建站或打包为 VitePress、运行 /deep-wiki:build 命令,或希望获得可浏览 HTML 输出时触发;构建命令为 cd wiki-site && npm install && npm run docs:build,输出到 wiki-site/.vitepress/dist/。
限制与注意事项:Mermaid 异步渲染,onMounted 触发时 SVG 尚不存在,必须轮询;不要使用 isCustomElement 编译选项处理裸 <T>,会导致更严重的崩溃;Mermaid 节点文本使用内联样式且特异性最高,仅靠 CSS 无法修复;enhanceApp() 在 SSR 期间运行,此时 document 不存在,应只用 setup()。用户数据与官方资料未提供的收费、价格或平台信息暂未提供。