docs: 同步生成媒体部署说明 (#72)

docs/10-deployment-and-operations.md

@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Deployment-and-Operations
 wiki_url: https://git.ilapage.cn/OPC/chorus/wiki/Deployment-and-Operations.-
-wiki_revision: 0d4ce672c3b159fb67327314ab2073a7c5b39e03
-synchronized_at: 2026-08-25T07:10:02Z
+wiki_revision: a55afb67eb65d59803990015ac8634af786cd4e2
+synchronized_at: 2026-08-27T01:59:02Z
 <!-- gitea-wiki-mirror:end -->
 
 # 部署与运维
@@ -227,3 +227,20 @@ D:\supervisor\supervisord.exe ctl /c D:\supervisor\supervisord.conf status
 - 队列延后使用 `generations.available_at`，部署 #44 前必须已经完成迁移 `000006`。
 - 监控应区分本地 `local_rate_limit` 延后事件与真实 Provider 429；本地限流不得计入 Provider 失败率、熔断或真实 attempt。
 - 发布验证使用 mock Provider 检查：用户/API Key 429 与 `Retry-After`、Provider 限流不触发上游、全部候选受限后可在 `available_at` 到期重新认领。不得用真实 Provider 额度反复验证。
+
+<!-- issue-72-admin-media-deployment:start -->
+## Admin 生成媒体配置（#72）
+
+Admin API 需要对 Portal 使用的同一生成物目录拥有只读权限：
+
+```yaml
+settings:
+  extend:
+    chorus:
+      storage_root: ../var/storage
+```
+
+`storage_root` 按 Admin API 进程的工作目录解析。Supervisor 本机实例从 `admin/` 启动，因此项目内默认目录写为 `../var/storage`；也可以配置绝对路径。目录必须已经存在，Admin 启动不会创建或写入该目录。
+
+部署顺序：备份并确认数据库版本与 dirty 状态，执行 migration 10，安装新的 Admin API 与 Admin UI 制品，再重启 `chorus-admin-api` 和 `chorus-admin-ui`。migration 10 只登记四个 GET API、菜单关联和 `chorus_operator` Casbin 权限，不修改生成记录或媒体对象。回退时先回退 UI/API 制品，再执行 migration 10 down。
+<!-- issue-72-admin-media-deployment:end -->