Commit Graph

2 Commits (890f1ee589ed80e3110b8b8eb6273f4a4d3ca7f7)

Author SHA1 Message Date
mula.liu 890f1ee589 模型配置全部交给数据库,.env 只管进程参数;media 从库里搬出来单独一个挂载点
上一版把容器收成一个之后,剩下的口径不一致是「模型配在哪」有两处说法:
.env 里能写 COMFYUI_BASE_URL / VIDEO_PROVIDER / TTS_*,模型中心页面也能改,
而运行时 config_json 优先——于是"改了没生效"和"到底哪条说了算"变成日常问题。
搬家的判据写成一句话放进工程规范:**换模型要不要重启进程**。要,就说明它站错了队。
另外三条理由:① 换 GPU 机是日常操作,不该要求改 .env 再 up --force-recreate;
② API / worker / beat 三个进程必须读同一份模型事实,写 .env 就是三份;
③ 地址与 Key 进库才有审计(谁改的、什么时候)与探测记录。
media 分家是同一批的诉求:产物只涨不跌,会长到几十上百 GB,迟早要单独挪大盘、
做增量备份、被 rsync 与剪辑软件直接读,和"一个不能写坏的 SQLite"绑在同一个挂载点
就得整目录停服拷走。代价说清楚:备份清单从一条变两条。

改动
   · 划界:.env / .env.example 里 VIDEO_* / COMFYUI_* / TTS_* 一律清零(脚本核对过,
     43 个键全部对应 Settings 字段或 compose 插值键,无未知键、无模型键),模板头部
     写明"为什么这里没有模型配置"与新的排障口径(先去页面点 🔌 探测)。补回四个
     原本漏在模板外的进程参数 FFMPEG_BIN/FFPROBE_BIN/QC_VISUAL_*/QC_ASR_ENABLED。
   · Dockerfile / docker-compose.yml / docker-compose.scale.yml:MEDIA_ROOT 从
     /app/data/media 改成 /app/media 并新增 ./media 挂载;worker 同步挂两个目录
     (否则「worker 写完了页面看不到」),beat 不读写产物所以不挂;compose 里删掉
     COMFYUI_BASE_URL 透传,注释说明"去模型中心改 base_url,改完即生效"。
   · 后端三处悄悄降级要一起清掉,否则 env 一空就把真实默认位打回 Mock:
     api/system.py 不再用 settings.video_provider/tts_provider 覆盖页面默认位;
     services/audio.py 的 resolve_tts_spec 候选去掉 settings.tts_provider(未设供应商的
     声线会静默 Mock 配音,只有听成片才发现);providers/registry.py 的 _dedupe_defaults
     改按「真实模型 > 启用 > 登记顺序」裁决,两条 mock 行的 is_default 交给
     _has_real_spec 闸门而不是 env。config.py 的模型字段保留为代码级兜底并写明两个用处。
   · 两个启停脚本原来都是 curl .env 里的 COMFYUI_BASE_URL 探活——现在探的是废弃地址,
     绿字反而误导:dev.sh / server.sh 的 status 改成登录取 /api/providers,
     把库里在册且启用的 base_url 去重后逐个探(comfy 探 /system_stats)。
     dev.sh 顺带修两处历史问题:/api/providers 在 AUTH_ENABLED=true 下 401 被打印成
     "模型注册表读取失败"(现在先登录);非 2xx 被 urllib 当异常抛,LLM 根路径 404
     会误判 unreachable(有 HTTP 应答即算机器活着,真可用性以页面探测为准)。env_value
     随之无人引用,两个脚本各删一份。
   · 文档:README §3.2 挂载表 3 行→4 行(含"少挂 media 会怎样")+ 备份清单两条、
     「常用改动」表把 ComfyUI 一行改成页面操作、§4.0 重写(事实源 + 三条理由 +
     三种接入路径 + COMFYUI_BASE_URL 逃生门 + 排障顺序);工程规范 §5 加"配置分两层"、
     硬约束 #3 与数据边界表同步;deploy.sh / dev.sh 提示语同步。

验证(真跑)
   · 全量后端用例 502 passed / 1 skipped;conftest 新增钉住 COMFYUI_BASE_URL,
     否则 comfyui 三条不登记,断言会跟着开发机 .env 漂(这正是删完 .env 才暴露的隐性污染)。
   · HOST_PORT=8010 docker compose up -d --build → 12 秒 healthy;容器里没有任何模型 env,
     /api/providers 仍是 8 条、默认位四条全真(comfyui/minimax-h3 · qwen-image-2.1-turbo ·
     indextts2 · qwen/qwen3.7-plus),默认位是 entrypoint 从 ./scripts/seed 灌进去的。
   · media 挂载双向实测:容器内写 /app/media/_mount_probe.txt → 宿主 media/ 立即可见;
     宿主已有 1.8G 产物经容器读回 200(/media/1/generated/shot-02-task2.mp4 2.8MB video/mp4);
     走真实接口 POST /api/projects/1/assets 上传,落盘 media/1/reference/*.png 并能在页面直出。
   · ./scripts/deploy.sh --check 19 项全绿;seed.py doctor/boundary 通过;
     dev.sh status 与 server.sh status 均正确报出 http://10.100.53.199:9200 reachable、
     dashscope 报 HTTP 404(有应答)。冒烟产生的 media 两个探针文件与 ./data 移入
     .trash/2026-11-05/smoke-media-mount/,宿主库与产物未留垃圾。
2026-11-05 18:18:00 +08:00
mula.liu 9467e1bb97 v 0.1.0 2026-11-01 16:18:07 +08:00