|
|
@@ -135,12 +135,25 @@ tiku-server/
|
|
|
|------|------|------|
|
|
|
| GET | `/api/admin/backup-config` | 查看 WebDAV 配置 |
|
|
|
| PUT | `/api/admin/backup-config` | 设置 WebDAV（JSON: `url`, `username`, `password`） |
|
|
|
-| POST | `/api/admin/backup/trigger` | 手动触发备份 |
|
|
|
+| POST | `/api/admin/backup/trigger` | 增量备份（bank.db + 变更的 docx） |
|
|
|
+| POST | `/api/admin/full-backup` | 全量备份（bank.db + 全部 docx） |
|
|
|
| GET | `/api/admin/backup/history` | 备份历史 |
|
|
|
+| POST | `/api/admin/clear-all` | 清空题库（删除所有题目） |
|
|
|
| POST | `/api/admin/rebuild-index` | 增量重建索引 |
|
|
|
| POST | `/api/admin/knowledge-build` | 重建知识点编码 |
|
|
|
| POST | `/api/admin/git-update` | `git pull` + 自动重启 |
|
|
|
|
|
|
+## 备份策略
|
|
|
+
|
|
|
+- **增量备份**：导入/编辑元数据时自动备份 `bank.db` + 被修改的 docx
|
|
|
+- **全量备份**：`POST /api/admin/full-backup`，备份全部 docx
|
|
|
+- **WebDAV**：配置后每次本地备份自动推送到远程（坚果云/NextCloud）
|
|
|
+- **保留 30 个快照**，自动清理旧备份
|
|
|
+
|
|
|
+## 导入队列
|
|
|
+
|
|
|
+导入使用单线程队列处理，避免并发写入 SQLite 导致数据库损坏。`/api/health` 返回 `queue_depth` 可查看队列长度。
|
|
|
+
|
|
|
## 单题 docx 格式
|
|
|
|
|
|
```
|
