用途:为 VitePress 文档项目接入 @yunyoujun/docs 预设,在不破坏现有配置的前提下完成依赖安装与配置合并。
主要能力:集成 getViteConfig()(Vite 插件链路)与 getVitepressConfig()(VitePress 默认站点配置);在主题入口引入 uno.css 与 virtual:group-icons.css;按锁文件选择包管理器(pnpm-lock.yaml > package-lock.json > yarn.lock,默认 pnpm)安装依赖。
使用方式:先识别文档目录(docs/ 或仓库根目录)与候选配置文件(vite.config.ts/mts、.vitepress/config.ts/mts 等)。安装命令示例:pnpm add -D @yunyoujun/docs unocss unplugin-vue-components vite-plugin-vue-devtools @shikijs/vitepress-twoslash;子目录用 pnpm -C docs add -D 同参数。Vite 配置中引入 getViteConfig 并与现有配置合并;VitePress 配置中引入 getVitepressConfig 与 defineConfig,展开 vpConfig 并保留 title、description、themeConfig,可传 repo 生成 editLink 与 socialLinks。主题入口确保包含 import 'uno.css' 与 import 'virtual:group-icons.css'。最后执行 pnpm lint、pnpm typecheck、pnpm docs:build 等验证。
限制与注意:需增量合并,保留用户注释、插件与业务配置;配置文件不存在时按参考模板创建;monorepo 需说明改动所在 package;仅装 @yunyoujun/docs 而漏装 unocss 等会报模块缺失;themeConfig 合并漏掉 ...vpConfig.themeConfig 会丢失默认搜索/大纲;pnpm workspace 多实例可能出现 TS2345,可先断言为 unknown 再断言为 UserConfig。具体模板与参考文件内容暂未提供。