⚙️ 配置说明
站点配置
站点配置文件位于 docs/.vitepress/config.mts，主要配置项：
| 配置 | 说明 |
|---|---|
title | 站点标题 |
description | 站点描述（SEO） |
themeConfig.nav | 导航栏 |
themeConfig.sidebar | 侧边栏 |
themeConfig.search | 本地全文搜索 |
themeConfig.logo | 站点 Logo |
同步脚本配置
sync-weknora.mjs 中的关键配置：
javascript
const WEKNORA_DB = '/www/WeKnora/data/weknora.db'
const OUTPUT_DIR = '/opt/VitePress/docs/weknora'
const SIDEBAR_PATH = '/opt/VitePress/.weknora-sidebar.json'
const KB_NAMES_PATH = '/opt/VitePress/.weknora-kb-names.json'修改后重新运行 npm run sync 即可生效。
自定义样式
主题样式位于 docs/.vitepress/theme/style.css，使用 CSS 变量覆盖 VitePress 默认主题：
css
:root {
--vp-c-brand-1: #0f7b7b; /* 品牌主色 */
--vp-c-brand-2: #0d9e9e; /* 品牌色 (悬停) */
--vp-c-brand-3: #0fb5b5; /* 品牌色 (激活) */
}构建部署
bash
# 构建为静态文件
npm run docs:build
# 输出在 docs/.vitepress/dist/
# 可直接部署到 Nginx / Vercel / Netlify 等