diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f437054
--- /dev/null
+++ b/README.md
@@ -0,0 +1,59 @@
+# OneinAI 文档站
+
+基于 VitePress 构建的文档站点。
+
+## 本地启动
+
+```bash
+# 安装依赖
+npm install
+
+# 启动开发服务器
+npm run docs:dev
+```
+
+访问 http://localhost:5173 查看效果。
+
+## 构建
+
+```bash
+npm run docs:build
+```
+
+构建产物在 `apidoc/.vitepress/dist/` 目录。
+
+## 部署到宝塔
+
+### 1. 本地构建
+
+```bash
+npm run docs:build
+```
+
+### 2. 宝塔添加站点
+
+1. 宝塔面板 → **网站** → **添加站点**
+2. 填写域名，PHP 版本选 **纯静态**
+3. 记住站点根目录路径（如 `/www/wwwroot/你的域名/`）
+
+### 3. 上传文件
+
+将本地 `apidoc/.vitepress/dist/` 目录下的**所有文件**上传到站点根目录。
+
+可使用宝塔文件管理器或 FTP 工具上传。
+
+### 4. 配置 Nginx
+
+进入站点 **设置 → 配置文件**，找到 `location /` 块，修改为：
+
+```nginx
+location / {
+    try_files $uri $uri/ /index.html;
+}
+```
+
+保存后重载 Nginx，站点即可正常访问。
+
+### 5. 后续更新
+
+每次修改文档后重新执行构建，将新的 `dist/` 内容覆盖上传即可。