Wiki VitePress 打包器
将生成的 Wiki Markdown 打包成可浏览的深色 VitePress 站点。
技能仅描述生成 VitePress 站点、写入 wiki-site 并运行 npm install/npm run docs:build，未显示凭据窃取、隐蔽外传或恶意行为；MIT 许可证、仓库安全政策和构建权限信息提供了一定治理依据。扣分在于没有最小权限说明、用户确认、数据流/网络访问披露、失败回滚、依赖锁定或依赖安全策略。
文档覆盖主要配置、Mermaid 修复、点击放大、预处理和构建路径，并说明 SSR 与异步渲染陷阱。扣分在于示例代码不是完整可运行实现，未给出输入校验、构建失败诊断、依赖版本、重复运行行为或异常 Mermaid/Markdown 的处理；静态评估且无针对该技能的提交测试证据，不能超过 10 分。
触发条件、目标用户场景和输出目录基本明确，适用于将已生成的 wiki Markdown 打包为 VitePress 网站。扣分在于未声明输入目录/目录结构、VitePress 与插件版本、非适用场景、平台要求或中文内容限制；npm 依赖和相关服务的网络可达性也未说明，因此环境适配证据有限。
SKILL.md 有 YAML 元数据、分层章节、配置示例、已知陷阱、MIT 许可证和版本号，阅读路径清晰。扣分在于缺少安装前提、完整 package.json 示例、参数契约、FAQ、变更日志、维护负责人/更新路径和版本兼容矩阵；仓库处于 Work in Progress，不能据此补足治理细节。
技能明确产出 wiki-site/.vitepress/dist，并覆盖暗色主题、Mermaid 可读性和前置 Markdown 修复，核心目标可理解且可能完成基本打包任务。扣分在于没有代表性最终输出、验证截图/构建日志或完整脚手架文件，示例仍需用户整合和审查；静态评估限制 effectiveness 不得超过 7。
证据包括目标 SKILL.md 的具体代码片段、README 的仓库说明、MIT LICENSE、安全政策、CI 工作流和提交测试文件，具备有限可审计性。扣分在于这些 CI/测试并未证明 wiki-vitepress 的关键路径，且本次未执行任何复现；没有该技能专属测试、构建产物或第三方交叉验证，静态评估不得超过 5。
- 该评估仅基于提供的源文件，未执行安装、脚本或 VitePress 构建；不要将示例片段视为已验证的完整实现。
- npm install 会引入外部依赖，但技能未声明版本、锁文件、网络需求或供应链审查；在受限网络或生产环境中应先审查并固定依赖。
- 点击放大代码直接复制 outerHTML 并绑定事件，未说明键盘可访问性、重复初始化、事件清理或大型/恶意 Markdown 的处理。
- 技能未说明输入目录约束、中文内容兼容性、失败恢复和清理策略，建议先在隔离目录中运行并保留原始 Markdown。
它能做什么 & 适用场景
该技能把生成的 Wiki Markdown 文件组织成 VitePress 静态网站。它会生成站点目录、VitePress 配置、主题文件和首页，并配置深色主题与 Mermaid 图表交互。它还会在构建前修复部分 Markdown 和 Vue 模板兼容性问题。适合已经拥有 Wiki 页面、希望发布可浏览 HTML 文档的开发者。
在 wiki-site/ 中生成 VitePress 站点结构，包括 .vitepress/config.mts、主题文件、public/、Markdown 页面、package.json 和 index.md；使用 vitepress-plugin-mermaid 配置深色 Mermaid 图表；通过 CSS 和客户端轮询修复 Mermaid 样式；为 Mermaid 图表添加点击放大弹窗；构建前处理 <br/>、裸露的 <T> 泛型和 YAML frontmatter；运行 npm install 和 npm run docs:build，产物写入 wiki-site/.vitepress/dist/。
- 负责技术文档的开发者，需要把已生成的 Wiki Markdown 发布为静态网站。
- 使用 /deep-wiki:build 命令、希望将深度 Wiki 输出打包成 VitePress 站点的用户。
- 需要深色主题 Mermaid 图表，并希望读者可以点击图表放大的文档维护者。
- 需要统一补充页面标题和描述、修复 Vue 模板兼容性问题的文档工程师。
优缺点一览
- 覆盖从 VitePress 脚手架生成到生产构建的完整流程。
- 明确处理深色 Mermaid 的主题变量、CSS 覆盖和内联样式覆盖。
- 包含 Mermaid 点击放大、Markdown 预处理和 frontmatter 检查。
- MIT 许可，并由 Microsoft 发布。
- 依赖 Node.js/npm、VitePress 和 vitepress-plugin-mermaid，源材料未说明版本要求。
- 要求已有生成的 Wiki Markdown；不负责生成 Wiki 内容本身。
- 源材料没有提供该单项技能的独立测试结果或平台兼容性验证。
- README 将其作为包含约 190 个技能的单一仓库的一部分，单独分发方式未说明。
如何安装
仓库 README 支持使用 npx skills add microsoft/skills 安装技能集合，然后在向导中选择需要的技能。该技能位于 .github/plugins/deep-wiki/skills/wiki-vitepress/SKILL.md；源材料未提供单独安装此技能的命令。
如何使用
在已安装该技能的编码代理中提出“把这些生成的 Wiki Markdown 打包成 VitePress 站点”或“build a site”，也可以运行 /deep-wiki:build。技能会按要求生成 wiki-site/，然后执行：cd wiki-site && npm install && npm run docs:build。