fix(storage): preserve transfer contents and cleanup identities (#7142)

docs/mcp-api.md

@@ -26,6 +26,18 @@
 升级前历史没有来源标记，界面显示“未记录”，不会按当前订阅设置追溯推断。
 普通订阅的首次提交与洗版订阅补缺在活动中都标记为首次订阅。
 
+### 文件整理与恢复
+
+整理成功历史保存 `episode_group`；批量复用历史时仅恢复所有记录共同的剧集组，
+不同剧集组应分别提交。目录整理的叶子文件同样遵守冻结的覆盖策略，
+`overwrite_skipped` 表示策略拒绝，不能当作文件已导入。
+
+`FileItem` 的可选 `modify_time_ns` 和 `change_time_ns` 保存本地纳秒版本证据，
+JSON 使用十进制字符串避免浏览器数字精度丢失，客户端应原样保留查询返回值，不自行生成。
+恢复清理发现本地源或目标版本变化时会保留副本并转人工复核；
+云盘时间戳变化仍按大小与稳定文件标识核验。OpenList 中断或大小不符的下载不会作为移动成功结果删除源文件。
+`storage.rename` 的 `recursive=true` 会识别并重命名所有子目录内媒体，随后重命名所选目录。
+
 ## 1. 连接与认证
 
 | 配置项 | 值与含义 |