From cf068a6dc14751b488e8a71a85f62f498d401514 Mon Sep 17 00:00:00 2001
From: anghunk <anghunk@gmail.com>
Date: Mon, 9 Feb 2026 16:53:41 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E6=95=B0=E6=8D=AE?=
 =?UTF-8?q?=E8=BF=81=E7=A7=BB=E6=96=87=E6=A1=A3=E4=BB=A5=E5=8F=8D=E6=98=A0?=
 =?UTF-8?q?=E5=AF=BC=E5=85=A5=E6=B5=81=E7=A8=8B=E5=8F=98=E5=8C=96?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 移除手动数据转换说明，改为推荐使用管理后台的导入功能
- 在示例数据中添加缺失的 site_id 字段以保持一致性
---
 docs/api/admin/data-migration.md | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

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"
 		}
 	]
 }