docs(ai): 添加 RAGFlow MCP 部署文档与 AI 栏目整理

- 新增 Windows 11 RAGFlow + MCP 完整部署记录
- 添加 AI 栏目首页与免费模型 API 文档
- 更新 VuePress 配置与 collections 结构
- 添加缓存清理和文档同步脚本
This commit is contained in:
祀梦
2026-03-29 13:21:46 +08:00
parent de14950045
commit 5578a63c1d
13 changed files with 2365 additions and 7 deletions

View File

@@ -1,5 +1,5 @@
---
description: 每次站点相关修改后须本地构建/启动并验证Git 提交默认策略(除非用户明确要提交
description: 每次站点相关修改后须本地构建/启动并验证Git 仅在被用户明确要求时提交
alwaysApply: true
---
@@ -20,11 +20,12 @@ alwaysApply: true
`--clean-cache --clean-temp` 可避免 **Vite 预构建缓存** 仍指向旧版 `@vuepress/helper`,从而触发 **`encodeSVG` 导出缺失、整站白屏**。)
在浏览器打开本地地址,确认首页 hero 与导航正常。
**白屏常见原因速记**`@vuepress/plugin-markdown-chart` 等依赖需要 `@vuepress/helper/client` 导出 `encodeSVG`;若 `docs/.vuepress/.cache` 里预打包了过旧的 helper会出现 **仅 dev 白屏、build 正常**。处理:删缓存或用 `docs:dev-clean` / `docs:build`(脚本已带 clean
**白屏常见原因速记**`@vuepress/plugin-markdown-chart` 等依赖需要 `@vuepress/helper/client` 导出 `encodeSVG`;若 `docs/.vuepress/.cache` 里预打包了过旧的 helper会出现 **仅 dev 白屏、build 正常**。处理:执行 **`npm run docs:clear-cache`** 后重启 dev或 **`npm run docs:dev-clean`** / **`npm run docs:build`**(后两者会 clean项目已在 `config.ts` 的 Vite `optimizeDeps.include` 中强制包含 `@vuepress/helper/client`,以降低复发概率。
## Git 提交策略
- **默认**:在用户**未**于本轮对话中明确要求 **「不要提交」「暂不 commit」「仅改代码不要 git」** 等前提下,在 **验证通过** 后 **应执行 `git add` + `git commit`**,用清晰的中文说明提交内容
- **例外**:用户明确只要改代码、**由其本人审核后再提交**时,**不执行** commit。
- **禁止自作主张提交****仅当用户在本轮对话中明确说出要提交**(例如「提交一下」「帮我 commit」「推到 git」等执行 `git add` / `git commit` / `git push`
- **未要求提交时**:改完代码、做完验证即可结束;**不要**替用户 commit。
- **用户若说不要提交**:同样不执行任何 git 写入操作。
**注意**:构建产物目录 **`docs/.vuepress/dist`**、缓存 **`.cache` / `.temp`** 已在 `.gitignore` 中,**不要**将编译输出提交进源码仓。