docs(media-core): record Sonarr4K cutover

servers/media-core/media-core/README.md

@@ -1,32 +1,44 @@
 # media-core
 
-Media automation services on `media-core` (`192.168.50.46`), with the Compose
-source prepared for Arcane management.
+`media-core`（`192.168.50.46`）上的媒体自动化服务，由 Arcane Project
+`media-core` 和 Git Sync `e4b38e59-1676-41a9-babf-aa2af4cdea76` 管理。
+Auto Sync、同步后拉镜像和自动 redeploy 均关闭；Git push 后必须显式同步与部署。
 
-This first migration group contains NZBHydra2, Lidarr, and Whisparr. Download
-clients remain on unRaid; Lidarr and Whisparr use the unRaid SABnzbd instance.
+## 当前服务
 
-Host prerequisites:
+- NZBHydra2 `8.9.0-ls103`
+- Lidarr `3.1.0.4875-ls40`
+- Whisparr `2.2.0-release.231`
+- Sonarr4K `4.0.19.2979-ls319`
 
-- `/mnt/truenas/multimedia` mounted read-write from TrueNAS.
-- `/mnt/unraid/downloads` mounted read-write from unRaid
-  `/mnt/user/downloads` before Lidarr or Whisparr is enabled.
-- Application data restored under `/opt/media-core/appdata/<service>`.
+下载器保留在 unRaid。Lidarr、Whisparr 和 Sonarr4K 当前使用 unRaid SABnzbd；
+Sonarr4K 的容器路径 `/mnt/unRaid/downloads` 与 SAB 报告路径一致。
 
-The image digests were refreshed on 2026-09-05 after the initial migration:
-NZBHydra2 `v8.9.0-ls103`, Lidarr `3.1.0.4875-ls40`, and Whisparr
-`2.2.0-release.231`. A consistent pre-upgrade Appdata backup is retained at
-`/opt/media-core/backups/pre-upgrade-20260905-1550.tar`.
+## 宿主机前置条件
 
-Whisparr uses only the Compose-internal NZBHydra2 Newznab endpoint
-`http://nzbhydra2:5076`; its former direct indexers were removed after the
-aggregate endpoint passed Whisparr's built-in test.
+- `/mnt/truenas/multimedia`：TrueNAS 可读写 NFS。
+- `/mnt/unraid/downloads`：unRaid `/mnt/user/downloads` 可读写 NFS。
+- `/mnt/unraid/tv4k`：unRaid `/mnt/user/tv4k` 可读写 NFS。
+- Appdata：`/opt/media-core/appdata/<service>`。
+- 备份：`/opt/media-core/backups`，归档文件必须为 `root:root 0600`。
 
-The initial cutover was deployed from `/opt/media-core/compose.yaml`. Arcane
-currently sees the containers but does not yet hold a Project record. A first
-Git Sync registration was rolled back because Arcane v2.9.0 incorrectly bound
-it to Environment `0` and the Manager-side repository clone timed out. Do not
-assume Git pushes redeploy this stack until that control-plane issue is fixed.
-For LAN onboarding, create a separate Arcane repository record using
-`ssh://git@192.168.50.45:222/kai/infra-docker-configs.git`; `media-core` cannot
-reach the repository's Tailnet address.
+systemd automount 遇到 `Stale file handle` 时，不能直接反复部署 Docker。先确认没有
+容器占用对应挂载，完整停止 `.automount`、卸载残留 NFS、重新启动 automount，并连续
+验证读写稳定后再部署。
+
+## Sonarr4K 迁移说明
+
+Sonarr4K 于 2026-09-07 从 unRaid 迁入。源容器已停止但保留，冷备位于：
+
+```text
+/opt/media-core/backups/sonarr4k-config-cold-20260907-070232.tar
+```
+
+源镜像的 registry manifest 已不可用，因此从 unRaid 导出正在运行的精确镜像，导入
+`media-core` 后标记为 `local/sonarr:4.0.19.2979-ls319`，Compose 使用
+`pull_policy: never`。迁移后不要运行会清除未引用镜像的全局 prune。后续升级必须先做
+新备份，再把 Compose 改回可拉取的 registry digest，并作为独立变更执行。
+
+验收基线：332 部受监控剧集、7,136 个 episode files、队列 0；SABnzbd 与
+NZBHydra2 内建测试通过，Import List 和历史完整。旧 unRaid Sonarr4K 地址不得继续
+作为 API 入口。