diff --git a/docs/api/admin/data-migration.md b/docs/api/admin/data-migration.md index 149f31b..81669ea 100644 --- a/docs/api/admin/data-migration.md +++ b/docs/api/admin/data-migration.md @@ -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" } ] }