vitepress/README.md

OneinAI 文档站

基于 VitePress 构建的文档站点。

本地启动

# 安装依赖
npm install

# 启动开发服务器
npm run docs:dev

访问 http://localhost:5173 查看效果。

构建

npm run docs:build

构建产物在 apidoc/.vitepress/dist/ 目录。

部署到宝塔

1. 本地构建

npm run docs:build

2. 宝塔添加站点

1. 宝塔面板 → 网站 → 添加站点
2. 填写域名，PHP 版本选 纯静态
3. 记住站点根目录路径（如 /www/wwwroot/你的域名/）

3. 上传文件

将本地 apidoc/.vitepress/dist/ 目录下的所有文件上传到站点根目录。

可使用宝塔文件管理器或 FTP 工具上传。

4. 配置 Nginx

进入站点 设置 → 配置文件，找到 location / 块，修改为：

location / {
    try_files $uri $uri/ /index.html;
}

保存后重载 Nginx，站点即可正常访问。

5. 后续更新

每次修改文档后重新执行构建，将新的 dist/ 内容覆盖上传即可。