docs: 更新数据迁移文档以反映导入流程变化

- 移除手动数据转换说明,改为推荐使用管理后台的导入功能
- 在示例数据中添加缺失的 site_id 字段以保持一致性
This commit is contained in:
anghunk
2026-02-09 16:53:41 +08:00
parent ac87af705f
commit cf068a6dc1

View File

@@ -52,7 +52,8 @@ GET /admin/comments/export
"content_text": "很棒的文章!",
"content_html": "很棒的文章!",
"parent_id": null,
"status": "approved"
"status": "approved",
"site_id": "blog"
}
]
```
@@ -109,11 +110,8 @@ POST /admin/comments/import
说明:
- 若从 CWD 自身导出的评论数据进行恢复,可直接将 `/admin/comments/export` 接口导出的 JSON 原样提交到本接口;
- 若从 **Twikoo** / **Artalk** 等其他评论系统迁移数据,本接口会自动识别并转换数据格式:
- **Twikoo**: 自动映射 `nick` → `name`, `mail` → `email`, `href` → `post_slug`, `comment` → `content_text` 等字段
- **Artalk**: 自动映射 `nick` → `name`, `page_key` → `post_slug`, `content` → `content_text` 等字段
- 时间字段自动转换为时间戳格式
- 非数字 ID 会自动丢弃,由数据库重新生成自增 ID
- 若从 Twikoo / Artalk 等其他评论系统迁移数据,可通过管理后台「评论数据导入」功能
- 上传对应的 JSON 文件,前端会自动转换为上述结构后调用本接口。
- 数据导入采用 `INSERT OR REPLACE` 策略,若提供 `id` 字段且存在则会覆盖原有数据
**成功响应**
@@ -301,7 +299,8 @@ GET /admin/export/stats
"domain": "example.com",
"count": 50,
"created_at": 1738060800000,
"updated_at": 1738147200000
"updated_at": 1738147200000,
"site_id": "blog"
}
],
"likes": [
@@ -309,7 +308,8 @@ GET /admin/export/stats
"id": 1,
"page_slug": "https://example.com/blog/hello-world",
"user_id": "some-user-id",
"created_at": 1738060800000
"created_at": 1738060800000,
"site_id": "blog"
}
]
}