文档: 按 Ant/Arco Design 风格重构官网首页，修正 API 参考，完善 i18n (#41)

重构： - 首页 Hero 重设计：双列布局（标题+CTA+指标 / macOS 风代码窗口） - 引入渐变文字、pulse 徽章、悬停带动画的主按钮 - 功能卡片加 SVG 图标、悬停提升效果、部分卡片变成可点击链接 - 新增 HomepageShowcase 截图轮播区：Tab 切换四个核心页面（仪表盘/任务/存储/多节点） - 全站换 Arco 蓝 (#165dff) 作为主色，紫色 (#8f4bff) 作为辅助 - 导航栏加毛玻璃效果、表格加圆角与边框、菜单项圆角化 - 深色模式配色整体收敛内容修正： - API 参考补全遗漏的端点：auth logout/profile、records batch-delete、 storage-targets star/usage/google-drive、notifications test、dashboard timeline、settings - 把 API 表格改为"方法/端点/说明"三列，加响应结构说明 - 中英文 API 文档同步更新 i18n： - code.json 补充 Hero、Features、Showcase 全部新翻译键 - 校对：16 个中英文档 frontmatter 完全对齐，无漏译构建：双语 build 通过、产物 3.3MB
2026-06-07 02:39:32 +08:00 · 2026-04-17 13:39:27 +08:00
parent a6dd8033ed
commit 3a4c2edd9b
14 changed files with 1373 additions and 183 deletions
--- a/docs-site/i18n/zh-Hans/code.json
+++ b/docs-site/i18n/zh-Hans/code.json
@@ -1,26 +1,82 @@
 {
+  "home.badge": {
+    "message": "开源 · v1.6.0",
+    "description": "Version badge on the hero"
+  },
+  "home.title.part1": {
+    "message": "为每一台服务器提供",
+    "description": "Hero title, first line"
+  },
+  "home.title.part2": {
+    "message": "自托管备份管理。",
+    "description": "Hero title accent second line"
+  },
  "home.tagline": {
-    "message": "自托管服务器备份管理 — 一个二进制，一条命令，管好所有备份",
+    "message": "一个二进制，一条命令。文件 / 数据库 / SAP HANA 备份直送 70+ 存储后端。",
    "description": "Tagline on the home page"
  },
+  "home.pageTitle": {
+    "message": "自托管备份管理",
+    "description": "Page <title> element on the home page"
+  },
  "home.getStarted": {
    "message": "快速开始",
    "description": "Primary CTA on the home page"
  },
-  "home.title": {
-    "message": "自托管备份管理",
-    "description": "Title on the home page"
+  "home.metric.backends": {
+    "message": "存储后端",
+    "description": "Hero metric label: storage backends"
  },
+  "home.metric.backupTypes": {
+    "message": "备份类型",
+    "description": "Hero metric label: backup types"
+  },
+  "home.metric.license": {
+    "message": "开源协议",
+    "description": "Hero metric label: license"
+  },
+
+  "section.features.tag": {
+    "message": "核心能力",
+    "description": "FEATURES section tag"
+  },
+  "section.features.title": {
+    "message": "该有的都有，多余的没有",
+    "description": "Features section title"
+  },
+  "section.features.subtitle": {
+    "message": "备份 Runner、存储 Provider、调度、集群 — 每一块都经过打磨。",
+    "description": "Features section subtitle"
+  },
+
  "feat.types.title": {"message": "多种备份类型"},
  "feat.types.desc": {"message": "文件与目录（支持多源路径），以及 MySQL、PostgreSQL、SQLite、SAP HANA 统一管理。"},
  "feat.storage.title": {"message": "70+ 存储后端"},
-  "feat.storage.desc": {"message": "内置阿里云 OSS、腾讯云 COS、七牛、S3、Google Drive、WebDAV、FTP，以及通过 rclone 接入的 SFTP、Azure Blob、Dropbox、OneDrive 等数十种。"},
+  "feat.storage.desc": {"message": "内置阿里云 OSS、腾讯云 COS、七牛、S3、Google Drive、WebDAV、FTP，以及 SFTP、Azure Blob、Dropbox 等 rclone 后端。"},
  "feat.scheduling.title": {"message": "调度与保留策略"},
  "feat.scheduling.desc": {"message": "基于 Cron 的可视化调度编辑器，支持按天数/份数自动保留和空目录清理。"},
  "feat.cluster.title": {"message": "多节点集群"},
-  "feat.cluster.desc": {"message": "Master-Agent 模式跨多台服务器管理备份，Agent 在本地执行任务并直接上传到存储，无需反向连通性。"},
+  "feat.cluster.desc": {"message": "Master-Agent 基于 HTTP 长轮询。Agent 在本地执行任务并直接上传到存储 — 无需反向连通性。"},
  "feat.security.title": {"message": "默认安全"},
  "feat.security.desc": {"message": "JWT 认证、bcrypt、AES-256-GCM 加密配置、可选备份加密、完整审计日志。"},
  "feat.deploy.title": {"message": "部署轻量"},
-  "feat.deploy.desc": {"message": "单个静态二进制 + 内嵌 SQLite。Docker 一键启动或通过 install.sh 裸机部署 — 零外部依赖。"}
+  "feat.deploy.desc": {"message": "单个静态二进制 + 内嵌 SQLite。Docker 一键启动或裸机 — 零外部依赖。"},
+  "feat.learnMore": {"message": "了解更多"},
+
+  "showcase.tag": {"message": "产品界面"},
+  "showcase.title": {"message": "精心打磨的控制台，而非 DIY 脚本"},
+  "showcase.subtitle": {"message": "每个页面都为运维而生 — 可观测优先，可配置次之。"},
+  "showcase.tab.dashboard": {"message": "仪表盘"},
+  "showcase.tab.tasks": {"message": "备份任务"},
+  "showcase.tab.storage": {"message": "存储目标"},
+  "showcase.tab.nodes": {"message": "多节点"},
+  "showcase.dashboard.title": {"message": "一眼掌握全局"},
+  "showcase.dashboard.desc": {"message": "备份成功率、存储使用量、最近执行记录、即将触发的计划 — 一页实时数据。"},
+  "showcase.tasks.title": {"message": "可视化任务编辑器"},
+  "showcase.tasks.desc": {"message": "文件、MySQL、PostgreSQL、SQLite、SAP HANA — 三步完成。Cron 编辑器、多目标分发、保留策略、压缩、加密 — 点击即用。"},
+  "showcase.storage.title": {"message": "70+ 后端，统一体验"},
+  "showcase.storage.desc": {"message": "阿里云 OSS、腾讯云 COS、S3、Google Drive、WebDAV — 加上每一种 rclone 后端。测试连接、收藏、查看实时容量。"},
+  "showcase.nodes.title": {"message": "几分钟搭起 Master-Agent"},
+  "showcase.nodes.desc": {"message": "创建节点、复制令牌、在任意远程主机启动 Agent。路由到节点的任务在本地执行并直接上传到存储 — 无需反向连通性。"},
+  "showcase.cta": {"message": "开始阅读文档"}
 }
--- a/docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/api.md
+++ b/docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/api.md
@@ -10,74 +10,126 @@ description: REST API 端点 — 统一以 /api 为前缀，使用 JWT Bearer

 ## 认证

-| 端点 | 说明 |
-|------|------|
-| `POST /api/auth/setup` | 初始化首个管理员（仅当系统无任何用户时） |
-| `POST /api/auth/login` | 登录，返回 JWT |
-| `PUT  /api/auth/password` | 修改密码 |
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| `GET` | `/api/auth/setup/status` | 查询是否需要初始化管理员 |
+| `POST` | `/api/auth/setup` | 初始化首个管理员（仅当系统无任何用户时） |
+| `POST` | `/api/auth/login` | 登录，返回 JWT |
+| `POST` | `/api/auth/logout` | 登出（使当前 Token 失效） |
+| `GET`  | `/api/auth/profile` | 当前用户信息 |
+| `PUT`  | `/api/auth/password` | 修改密码 |

 ## 备份任务

-| 端点 | 说明 |
-|------|------|
-| `GET /api/backup/tasks` | 列表 |
-| `POST /api/backup/tasks` | 创建 |
-| `GET /api/backup/tasks/:id` | 详情 |
-| `PUT /api/backup/tasks/:id` | 更新 |
-| `DELETE /api/backup/tasks/:id` | 删除 |
-| `PUT /api/backup/tasks/:id/toggle` | 启用 / 禁用 |
-| `POST /api/backup/tasks/:id/run` | 手动执行 |
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| `GET` | `/api/backup/tasks` | 列表 |
+| `POST` | `/api/backup/tasks` | 创建 |
+| `GET` | `/api/backup/tasks/:id` | 详情 |
+| `PUT` | `/api/backup/tasks/:id` | 更新 |
+| `DELETE` | `/api/backup/tasks/:id` | 删除 |
+| `PUT` | `/api/backup/tasks/:id/toggle` | 启用 / 禁用 |
+| `POST` | `/api/backup/tasks/:id/run` | 手动触发一次执行 |

 ## 备份记录

-| 端点 | 说明 |
-|------|------|
-| `GET /api/backup/records` | 列表（支持筛选） |
-| `GET /api/backup/records/:id/logs/stream` | 实时日志（SSE） |
-| `GET /api/backup/records/:id/download` | 下载备份 |
-| `POST /api/backup/records/:id/restore` | 恢复到原始源 |
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| `GET` | `/api/backup/records` | 列表（支持筛选） |
+| `GET` | `/api/backup/records/:id` | 记录详情 |
+| `GET` | `/api/backup/records/:id/logs/stream` | 实时日志（SSE） |
+| `GET` | `/api/backup/records/:id/download` | 下载备份产物 |
+| `POST` | `/api/backup/records/:id/restore` | 恢复到原始源 |
+| `DELETE` | `/api/backup/records/:id` | 删除记录 |
+| `POST` | `/api/backup/records/batch-delete` | 批量删除 |

 ## 存储目标

-| 端点 | 说明 |
-|------|------|
-| `GET /api/storage-targets` | 列表 |
-| `POST /api/storage-targets` | 添加 |
-| `POST /api/storage-targets/test` | 用待审核配置测试连接 |
-| `GET /api/storage-targets/rclone/backends` | 列出可用 rclone 后端 |
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| `GET` | `/api/storage-targets` | 列表 |
+| `POST` | `/api/storage-targets` | 创建 |
+| `GET` | `/api/storage-targets/:id` | 详情 |
+| `PUT` | `/api/storage-targets/:id` | 更新 |
+| `DELETE` | `/api/storage-targets/:id` | 删除 |
+| `POST` | `/api/storage-targets/test` | 用待审核配置测试连接 |
+| `POST` | `/api/storage-targets/:id/test` | 重测已保存的目标 |
+| `PUT` | `/api/storage-targets/:id/star` | 切换收藏状态 |
+| `GET` | `/api/storage-targets/:id/usage` | 查询远端存储用量（支持此能力的后端） |
+| `GET` | `/api/storage-targets/rclone/backends` | 列出可用的 rclone 后端 |
+| `POST` | `/api/storage-targets/google-drive/auth-url` | 启动 Google Drive OAuth |
+| `POST` | `/api/storage-targets/google-drive/complete` | 完成 OAuth 流程 |

 ## 节点（集群）

-| 端点 | 说明 |
-|------|------|
-| `GET /api/nodes` | 节点列表 |
-| `POST /api/nodes` | 创建节点并返回 Token |
-| `PUT /api/nodes/:id` | 重命名 |
-| `DELETE /api/nodes/:id` | 删除（有关联任务时会被拒绝） |
-| `GET /api/nodes/:id/fs/list` | 浏览目录（远程节点走异步 RPC） |
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| `GET` | `/api/nodes` | 节点列表 |
+| `POST` | `/api/nodes` | 创建节点并返回 Token |
+| `GET` | `/api/nodes/:id` | 节点详情 |
+| `PUT` | `/api/nodes/:id` | 重命名 |
+| `DELETE` | `/api/nodes/:id` | 删除（有关联任务时会被拒绝） |
+| `GET` | `/api/nodes/:id/fs/list` | 浏览目录（远程节点走 Agent 异步 RPC） |

 ## Agent 协议（X-Agent-Token）

-| 端点 | 说明 |
-|------|------|
-| `POST /api/agent/heartbeat` | 上报心跳 |
-| `POST /api/agent/commands/poll` | 领取一条待执行命令 |
-| `POST /api/agent/commands/:id/result` | 上报命令结果 |
-| `GET /api/agent/tasks/:id` | 拉取任务规格（含解密后的存储配置） |
-| `POST /api/agent/records/:id` | 追加日志 / 更新记录状态 |
+Agent CLI 专用端点，通过 `X-Agent-Token` 头认证而非 JWT。
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| `POST` | `/api/agent/heartbeat` | 上报心跳（返回节点 ID） |
+| `POST` | `/api/agent/commands/poll` | 领取一条待执行命令 |
+| `POST` | `/api/agent/commands/:id/result` | 上报命令结果 |
+| `GET` | `/api/agent/tasks/:id` | 拉取任务规格（含解密后的存储配置） |
+| `POST` | `/api/agent/records/:id` | 追加日志 / 更新记录状态 |

 ## 通知

-| 端点 | 说明 |
-|------|------|
-| `GET /api/notifications` | 列表 |
-| `POST /api/notifications` | 创建 |
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| `GET` | `/api/notifications` | 列表 |
+| `POST` | `/api/notifications` | 创建 |
+| `GET` | `/api/notifications/:id` | 详情 |
+| `PUT` | `/api/notifications/:id` | 更新 |
+| `DELETE` | `/api/notifications/:id` | 删除 |
+| `POST` | `/api/notifications/test` | 用待审核配置测试 |
+| `POST` | `/api/notifications/:id/test` | 重测已保存的通知器 |

-## 仪表盘 / 审计 / 系统
+## 仪表盘

-| 端点 | 说明 |
-|------|------|
-| `GET /api/dashboard/stats` | 概览统计 |
-| `GET /api/audit-logs` | 审计日志 |
-| `GET /api/system/info` | 系统信息 |
-| `GET /api/system/update-check` | 检查是否有新版本 |
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| `GET` | `/api/dashboard/stats` | 概览统计 |
+| `GET` | `/api/dashboard/timeline` | 最近活动时间线 |
+
+## 审计 / 系统 / 设置
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| `GET` | `/api/audit-logs` | 审计日志 |
+| `GET` | `/api/system/info` | 系统信息 |
+| `GET` | `/api/system/update-check` | 检查新版本 |
+| `GET` | `/api/settings` | 系统级设置 |
+| `PUT` | `/api/settings` | 更新系统设置 |
+
+## 响应结构
+
+成功响应统一为：
+
+```json
+{
+  "code": "OK",
+  "message": "",
+  "data": { /* 实际数据 */ }
+}
+```
+
+错误返回 HTTP 4xx/5xx，并带：
+
+```json
+{
+  "code": "BACKUP_TASK_NOT_FOUND",
+  "message": "备份任务不存在",
+  "data": null
+}
+```