DataMind 的文档站点,基于 VuePress 2 + vuepress-theme-plume 构建。
npm i# 启动开发服务(热更新,编辑 markdown 后自动刷新)
npm run docs:dev
# 构建生产包(上传 GitHub Pages 前测试有无 bug)
npm run docs:build
# 本地预览生产服务
npm run docs:previewdocs/
├── en/notes/guide/ # 英文文档
│ ├── basicinfo/ # 简介、安装、架构
│ ├── modules/ # RAG、GraphRAG、Database、Skills、Memory
│ ├── benchmark/ # 测评运行、答案评估
│ └── advanced/ # 配置说明、数据格式
├── zh/notes/guide/ # 中文文档(同上镜像结构)
└── .vuepress/
├── config.ts # VuePress 主配置
├── plume.config.ts # 主题配置(热更新)
├── navbars/ # 导航栏配置
└── notes/ # 侧边栏配置
英文和中文文档一一对应,内容保持一致。
每个 Markdown 文件头部的配置:
---
title: 页面标题 # 侧边栏显示的标题
icon: carbon:idea # 侧边栏小图标(从 https://icon-sets.iconify.design/ 选取)
permalink: /zh/guide/... # 永久链接(不能与其他页面重复)
---参见 VuePress 部署文档。
关键配置:
docs/.vuepress/config.ts中base设为'/DataMind-Doc/'(或你的 repo 名)- GitHub 仓库 → Settings → Pages → Source 选
Deploy from a branch→gh-pages