nex_animation/scripts/dev.sh

428 lines
20 KiB
Bash
Raw Normal View History

2026-11-01 08:18:07 +00:00
#!/usr/bin/env bash
# ============================================================
# Nex Animation Studio · 一键启停(单机开发模式:SQLite + 进程内调度)
#
# ./scripts/dev.sh 启动前后端
# ./scripts/dev.sh stop 停止
# ./scripts/dev.sh restart 重启
# ./scripts/dev.sh status 端口 / 健康 / 当前模型 / ComfyUI 连通性
# ./scripts/dev.sh logs 同时跟踪前后端日志
# ./scripts/dev.sh logs backend 只看后端日志
# ./scripts/dev.sh start --reload 后端热重载
#
# 选项:--backend-only --frontend-only --reload --no-install
# --backend-port N --frontend-port N --host ADDR(默认 0.0.0.0,局域网可直接访问)
#
# 手工启动反复踩到的四个坑,本脚本已逐一处理:
模型配置全部交给数据库,.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 10:17:47 +00:00
# 1) 后端必须在能读到仓库根 .env 的位置启动。读不到时 DATABASE_URL / MEDIA_ROOT 退回代码默认值
# (库和产物各落另一处),平台照旧起来且不报错——这里统一用 --app-dir 从仓库根启动,路径永远唯一。
前端四项调整:输入框去掉光晕、账号菜单收口、逐页删开发期说明书、登录页重做成左右分栏 用户这一轮提了四条,其中三条是同一件事的三个面——**界面上残留着写给开发者自己的话**。 逐条落地的口径与取舍: **1)所有输入框聚焦时的蓝色外框** 量出来其实是三层叠在一起:antd 组件 token 的 `activeShadow`(2px 主色光晕)、 `genFocusStyle` 画的 `outline`、站内 `app.css` 给自绘表面准备的全站 `:focus-visible` 兜底。 第二层没有独立 token,而它依赖的 `lineWidthFocus` 还被 Upload 拖拽区复用,动 token 会连带改上传框, 所以分两刀收:`theme/antd.ts` 关 token(`Input`/`InputNumber` 的 `activeShadow` = `none`、 `Select.activeOutlineColor` = `transparent`),`styles/app.css` 用 `:where(...):focus-visible { outline: none }` 关那圈 outline——用 `:where()` 是为了把特异度归零, 它只是一份选择器清单而不是新加一层优先级,将来谁要恢复焦点环不必先赢过一条 `!important` (app.css 本身不在 `@layer` 里,压得住被 Tailwind 放进 `@layer antd` 的那份,本来就不需要 `!important`)。 **焦点指示没有被删**:antd 的 `activeBorderColor` + 加粗边框仍在,键盘用户看得见焦点; 自绘表面继续吃全站那条兜底。实测聚焦 `#login-user`:`box-shadow: none`、`outline: none 3px`、 `border-color` 浅 rgb(22,119,255) / 深 rgb(22,104,220)。 **2)账号胶囊:菜单去重、项上不留副标题** 「设置新密码」和「我的账号」是同一件事,且首启时登录页已经直接把人的带到 `/account?must=1`, 重复排队只让菜单变长——删掉,待办语义留着头像上的 Badge 红点。 菜单项不再写「账号信息 · 密码 · 登录设备」这类预演式说明;顺手把胶囊第二行的 `第 N 次登录` 也去了:那是「用户管理」表格里逐人登记的数据,挂在人人都要看的顶栏里等于把统计搬进导航。 现在菜单就是三项:我的账号 / 用户管理 / 退出登录。 **3)逐页去开发时冗余说明**(`Dashboard` / `AssetLibrary` / `ModelCenter` / `AgentConsole` / `project/{Library,Overview,Storyboard,Timeline,Review,Delivery}` / `ProjectBriefDrawer`) 三类处置,已写进 UI规范 §14 G2: - 常驻说明书删掉可见文字,信息进 `title`/`desc`:IndexTTS2 那四行论文式介绍(两处重复, 含「下面这条预告会说清楚:」)、总控台「期间页面不会推进,属正常现象」; - 开发者口径翻成「会怎样」:ffmpeg libass 提示只留降级后果,`FFMPEG_BIN` / `brew install ffmpeg-full` / 当前探测路径收进 `title`;`Delivery` 卡头「媒体由后端 `/media` 直出,下载走 `/api/exports/:id/download`」整条删; 「每一站的汇总状态由它覆盖的那几个节点折算而来」→「点一行直接跳到对应环节」; - 内部词不许漏到版面:`mock/Mock` → 站内既有的**演练通道**(四处)、「未匹配的列在 `unmatched_images`」 → 翻成人话;**一个物件只有一个名字**,`/models` 曾同时叫「模型中心 / 模型控制台 / 调度中心 → 模型中心」, 全站统一成侧栏那一项的写法 **模型管理中心**(含 `.env` 注释、`dev.sh`/`server.sh`/`seed.py` 的引导语、 后端四条给用户的报错文案、README、docs、探针页面名),并修掉不存在的入口路径「调度中心 → 模型中心」。 有意保留:单位与取值口径的括号(`(秒)(毫秒)(可选)(0=自动)(dB)`——读数不该依赖悬停)、 条件出现的 `Notice`/`LineHint`/`ErrorText`、`confirmAction` 的 `desc`、`Stat hint`、`nav.hint`、 `PageHead sub`(kit 既定槽位的一句话职责说明)、`Help.tsx` 整页(登记在册的产品手册)。 配套给 `OptionGrid` 单开 `labelTitle`,让组标签的括号补充有地方去而不额外占一行。 **4)登录页重做**(UI规范新增 §13.4) 左右分栏:左栏 `w-[46%] max-w-[620px]` 写平台自述(品牌行 →「把一条长视频,做成一条流水线」+ 三条能力点 → 角色可见范围),底色用 `color-mix` 把主色掺进 `color-bg-layout`,**零新 hex**; 右栏卡片保留原生 `<form>` 包在 `<Panel>` 外(Enter 提交与密码自动填充都挂在 form 上)。 窄于 `lg` 左栏整列收起,品牌行回到卡片顶部,任何宽度都认得出登的是哪个系统。 去掉后端下发的种子账号预填(`login_hint` 字段本身保留,`test_auth.py` 与 `e2e_selfcheck.py` 还在用它判首启), placeholder 回到「用户名」「密码」;新增**记住我**:键 `nex-login`,账号+口令一起记一起清 (只清口令留账号的话勾选框就不算数了),只在登录成功后落盘,取消勾选当场 `writeLocal(key, null)`, 默认不勾(本机明文口令)。 文档同步:UI规范 §8.4(`labelTitle`)、§9.3(焦点轮廓三层口径)、§13.4(登录页)、 §14 G2(三类处置 + 一个物件一个名字)与 §14 例外登记(登录页左栏、`Help.tsx` 整页豁免); README 鉴权一节补登录页与记住我;命名统一顺带扫了 `.env.example` / 三个脚本 / 后端文案。 验证:`npx tsc --noEmit`、`npm run build` 全绿;`node scripts/ui/classaudit.mjs` 七道闸门 0/0/0/0/0/0/0; 后端 + 前端起在 :8010/:5199 后跑完 §15 全部探针,退出码全 0——visualcheck 1440×明暗 15 路由 (console 0 / HTTP 失败 0 / 断言 0)、tableaudit 0、gridcheck 0、rhythmcheck 0、tagcheck 0/0、 btnrowcheck 0(413 组)、aligncheck 0、symmetrycheck 0、feedbackcheck 通过、footercheck 0(30 处吸底条)、 btnclustercheck 0(159 簇);gateprobe 11/11 反向验证;`pytest -q` 全量 502 passed 1 skipped (后端改了四条用户可见文案,对应 3 处断言同步更新)。记住我三条路径(勾上存 / 不勾清空 / 取消即清)实测过。
2026-11-05 14:09:16 +00:00
# 注意模型配置不在 .env 里(v0.1.1 起全在数据库 model_specs):换模型去左侧栏「模型管理中心」,改完即生效。
2026-11-01 08:18:07 +00:00
# 2) 后台进程必须自成会话,否则启动它的终端一退出就把 uvicorn/vite 一起带走(macOS 无 setsid,
# 改用 python start_new_session)。
# 3) vite 端口被占会静默换端口,前端代理与 e2e 自检随之失效——这里用 --strictPort 直接报错。
# 4) 相对 media / SQLite 路径会随启动目录漂移,导致已生成的镜头在新进程里全部 404。
# ============================================================
set -euo pipefail
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
RUN_DIR="$ROOT/.local/run"
LOG_DIR="$ROOT/.local/logs"
PYBIN="$ROOT/.venv/bin/python"
# 监听地址:默认 0.0.0.0 —— 同一网段的手机/其他设备可直接访问;
# 早先默认 127.0.0.1 时,`npm run dev` 里已有的 --host 0.0.0.0 会被本脚本追加的
# --host 覆盖,前后端只绑回环,局域网访问必然连不上。
HOST="${NEX_HOST:-0.0.0.0}"
# 自检 / Vite 代理用的地址:绑 0.0.0.0 时不能拿 0.0.0.0 去 curl,回退到回环。
case "$HOST" in
0.0.0.0|""|::|\[::\]) PROBE_HOST=127.0.0.1 ;;
*) PROBE_HOST="$HOST" ;;
esac
# 本机局域网 IP(macOS:默认路由网卡 → ipconfig getifaddr),取不到就只打印回环地址。
LAN_IP="$( { iface="$(route -n get default 2>/dev/null | awk '/^[[:space:]]*interface:/{print $2; exit}')"
[ -n "$iface" ] && ipconfig getifaddr "$iface" 2>/dev/null; } || true )"
端口按形态分键:HOST_PORT 只管部署对外,BACKEND_PORT/FRONTEND_PORT 只管开发;.env.example 与 compose 去噪音 一、端口三个键,各管一种形态,键名自带场景 上一轮我把它收敛成单一的 PORT,方向收得太狠:一个键被三种形态共用,等于把「这是给谁看的」 又塞回 README 里——同一个 HOST_PORT 在 Docker 下指对外映射、在裸机下指监听、在开发下指后端, 不翻文档的人分不出来。按形态分回去,判据从来不是键的个数,而是含义的唯一性: 一个键只能有一种含义、同一个 socket 不能有两个键。 HOST_PORT 部署形态对外暴露的端口:compose 拿它插值做端口映射,server.sh 回读它做监听端口 BACKEND_PORT 开发形态的后端 uvicorn(dev.sh 回读,并同步 Vite 代理目标) FRONTEND_PORT 开发形态的前端 Vite(独立进程,必须与后端错开) compose 的 ports 回到 "${HOST_PORT:-8000}:8000",并删掉上一轮为兼容 PORT 加的 environment.PORT="8000" 钉子(键名分开之后没有歧义要钉了)。server.sh 的取值链改成 命令行 --port > 环境变量 HOST_PORT/PORT > .env 的 HOST_PORT > 8000, 旧键 PORT 留一版兼容;dev.sh 只认 BACKEND_PORT/FRONTEND_PORT(PORT 作旧键回退)。 实测:.env 写 HOST_PORT=8010 → compose published=8010、server.sh status 打 :8010; HOST_PORT=9301 环境变量覆盖 → :9301;BACKEND_PORT=8000/FRONTEND_PORT=5173 → dev.sh 两个进程端口正确。 二、.env.example 按 .env 的样式重写,噪音清掉 它是运维唯一被要求编辑的文件,之前 100 行里 65 行是注释与说明,还有一批在 Docker 形态下 根本没人读的键。现在 32 个生效键 / 11 行注释,键位与本机 .env 一一对应,只放配置本身: - 删掉 compose 覆盖掉的那几行的误导(SERVE_FRONTEND 不再列;DATABASE_URL/MEDIA_ROOT 只留一行说明 「Docker 形态 compose 会指到挂载点」),长篇「为什么不在这里」全部搬到 README §3 与工程规范 §5, .env 头部三行指路。 - 删掉只在叠加 scale.yml 时才有人读的 POSTGRES_*/REDIS_URL/CELERY_*(默认值写在 scale.yml 里)。 - 删掉与代码默认值同值的长尾键(上传白名单、COOKIE_NAME、FRONTEND_DIST_DIR、QC 细项等), 需要的人按 Settings 字段名加一行即可(文件头写明键名 = 字段大写下划线)。 - 默认值改成单容器真相:SQLite + inline,不再是 postgresql+…@db:5432 + celery。 本机 .env 同步精简成 11 键 / 8 行注释,并把容器对外端口定成 HOST_PORT=8010(8000 坐着开发后端)。 三、docker-compose.yml 114 行 → 77 行 头部 34 行的架构论证压成 16 行只留「常用命令 + 配置来源 + 四个挂载点 + 指路 README」, 正文注释每条最多一行;为什么单容器、模型配置为什么不在这份文件里、扩容层怎么叠, 都指向 README §3.2 / §4.0。顺手把上一轮的教训留住:改 .env 之后必须重跑 up -d, restart 沿用旧容器配置、不换端口映射,这条写进了命令清单。 env_value() 补上「去随行注释与尾部空白」:三种解析器(python-dotenv、compose env_file、 本仓的 sed 回读)里只有前者会剥行内注释,漏了它 server.sh 会把 「HOST_PORT=8010 # 本机跑容器…」整串当端口用。 四、文档同步:README §3.2 加端口三键表与「改了没反应的四个键」,§3.1 前端代理、§3.2 命令、 常用改动表、§3.4 server.sh 注释全部改口径;docs/工程规范.md §5 把规则从「端口只有一个键」 改写成「按形态分键 + 含义唯一」,并把两次反复的教训写进正文。 验证:bash -n 两个脚本通过;docker compose config --services 仍只有 app,published 随 HOST_PORT 变化, 容器内四个覆盖值仍是挂载点那套;deploy.sh --check 全绿(19 项入口齐全); 两份 env 0 未知键 0 模型键;backend 全量 502 passed / 1 skipped。
2026-11-05 11:01:32 +00:00
env_value() { # 从仓库根 .env 读一个键(最后一行为准;去引号、去随行注释、去尾部空白)
端口收成一个键 PORT,.env 里的模型说明清零,apt 源也能换 一、端口:HOST_PORT / PORT / BACKEND_PORT 三个键砍成一个 上一轮把端口小节加回 .env.example 时,我按「三种部署形态」列了三个键: Docker 用 HOST_PORT、裸机 server.sh 用 PORT、开发 dev.sh 用 BACKEND_PORT+FRONTEND_PORT。 听起来各管一摊,实际上它们指的是同一件事——「这个应用对外听在哪个端口」。 一份要交给运维编辑的文件里出现三个同义键,他的第一反应必然是「我该改哪个」, 而改错那个的表现还是「服务起来了但端口没变」,跟没改一样。所以这次收到一个: PORT = 应用对外端口。Docker 对外的映射读它、裸机 server.sh 的监听端口读它、 开发态的后端也读它。 - docker-compose.yml:ports 改成 "${PORT:-${HOST_PORT:-8000}}:8000",旧键留一版回退; 另外在 environment 里显式写死 PORT: "8000",因为容器内永远监听 8000 (EXPOSE 与健康检查都按 8000 写死),宿主 .env 注进来的那份不能让它漂—— 今天应用不读 PORT 没事,将来谁加一行 os.environ["PORT"] 就会变成 「映射 9000:8000 但进程监听 9000」,容器直接不通。 - server.sh / dev.sh:加 env_value() 回读仓库根 .env(上一轮删掉过,是倒退)。 取值优先级统一 命令行 > 环境变量 > .env > 默认值;旧键 HOST_PORT / BACKEND_PORT 只作兼容回退。回读 .env 是有意的:.env 是运维唯一被要求编辑的文件, 写进去的键必须真的生效,否则就是本仓最忌讳的「写了不生效」。 - 开发态仍保留 FRONTEND_PORT,这不是同义键:Vite 是独立进程,必须和后端错开端口。 - 实测:.env 写 PORT=8211 → server.sh status 打印 server :8211、dev.sh status 打印 backend :8211;PORT=9000 docker compose config 的 published 变 9000 而容器内 PORT 仍是 8000;HOST_PORT=9100(.env 无 PORT 时)仍能回退到 9100。 二、.env / .env.example:只留配置本身 模型相关的配置和说明全部删净——现在两份文件里 VIDEO_* / COMFYUI_* / TTS_* / IMAGE_* / LLM_* 一个键都没有,原先三段「模型配置为什么不在这里」的长说明压成头部两行指引 (去页面「调度中心 → 模型中心」改,服务器初值随 scripts/seed/ 导入)。 .env.example 55 行注释对 45 个生效键,每条最多两行;本机 .env 10 键 10 行注释。 顺带确认:本机 .env 没被删过,它是 gitignored 的,所以从来不出现在提交里。 APP_DATABASE_URL / APP_MEDIA_ROOT 归到 Docker 小节(它们只在容器里成立)。 键名逐个对过 Settings 字段:两份文件 0 个未知键(多余键本身会被 extra="ignore" 吞掉, 但写错字得能立刻看出来)。 三、ffmpeg:镜像里装了,而且源现在可换 回答提问:装了。Dockerfile 运行阶段(python:3.12-slim 没有 ffmpeg)apt 装它, 时间线合成、抽帧、时长/码率质检全调它(app/services/ffmpeg.py); 缺它的表现是「导出成片一路 500」而不是起不来,所以没做成可选层。 实测容器 /health 报 ffmpeg=true(/usr/bin/ffmpeg 5.1.9-0+deb12u1, libass/xfade/subtitles/loudnorm 全 true)。 但这一段以前是唯一没做国内镜像的装包层,README 却写着「三段都走公网镜像源」—— 名不副实,且上次该层在构建机上跑了约 221 s。补上 ARG APT_MIRROR(默认 deb.debian.org, 不传参等于原行为),bookworm 的 /debian 与 /debian-security 同在 deb.debian.org 下, 一次 sed 覆盖 deb822 与老式 sources.list 两种文件;compose 侧透出同名 build-arg。 四、文档同步:README §3.2 端口行与构建源行、§3.4、前端代理那条; docs/工程规范.md §5 补「一件事只有一个键」,并把三键同义列为回归。 backend/tests 全量 502 passed / 1 skipped;bash -n 两个脚本通过; docker compose config 只有一个服务 app,端口映射与 APT_MIRROR 注入均已核对。
2026-11-05 10:44:30 +00:00
[ -f "$ROOT/.env" ] || return 0
端口按形态分键:HOST_PORT 只管部署对外,BACKEND_PORT/FRONTEND_PORT 只管开发;.env.example 与 compose 去噪音 一、端口三个键,各管一种形态,键名自带场景 上一轮我把它收敛成单一的 PORT,方向收得太狠:一个键被三种形态共用,等于把「这是给谁看的」 又塞回 README 里——同一个 HOST_PORT 在 Docker 下指对外映射、在裸机下指监听、在开发下指后端, 不翻文档的人分不出来。按形态分回去,判据从来不是键的个数,而是含义的唯一性: 一个键只能有一种含义、同一个 socket 不能有两个键。 HOST_PORT 部署形态对外暴露的端口:compose 拿它插值做端口映射,server.sh 回读它做监听端口 BACKEND_PORT 开发形态的后端 uvicorn(dev.sh 回读,并同步 Vite 代理目标) FRONTEND_PORT 开发形态的前端 Vite(独立进程,必须与后端错开) compose 的 ports 回到 "${HOST_PORT:-8000}:8000",并删掉上一轮为兼容 PORT 加的 environment.PORT="8000" 钉子(键名分开之后没有歧义要钉了)。server.sh 的取值链改成 命令行 --port > 环境变量 HOST_PORT/PORT > .env 的 HOST_PORT > 8000, 旧键 PORT 留一版兼容;dev.sh 只认 BACKEND_PORT/FRONTEND_PORT(PORT 作旧键回退)。 实测:.env 写 HOST_PORT=8010 → compose published=8010、server.sh status 打 :8010; HOST_PORT=9301 环境变量覆盖 → :9301;BACKEND_PORT=8000/FRONTEND_PORT=5173 → dev.sh 两个进程端口正确。 二、.env.example 按 .env 的样式重写,噪音清掉 它是运维唯一被要求编辑的文件,之前 100 行里 65 行是注释与说明,还有一批在 Docker 形态下 根本没人读的键。现在 32 个生效键 / 11 行注释,键位与本机 .env 一一对应,只放配置本身: - 删掉 compose 覆盖掉的那几行的误导(SERVE_FRONTEND 不再列;DATABASE_URL/MEDIA_ROOT 只留一行说明 「Docker 形态 compose 会指到挂载点」),长篇「为什么不在这里」全部搬到 README §3 与工程规范 §5, .env 头部三行指路。 - 删掉只在叠加 scale.yml 时才有人读的 POSTGRES_*/REDIS_URL/CELERY_*(默认值写在 scale.yml 里)。 - 删掉与代码默认值同值的长尾键(上传白名单、COOKIE_NAME、FRONTEND_DIST_DIR、QC 细项等), 需要的人按 Settings 字段名加一行即可(文件头写明键名 = 字段大写下划线)。 - 默认值改成单容器真相:SQLite + inline,不再是 postgresql+…@db:5432 + celery。 本机 .env 同步精简成 11 键 / 8 行注释,并把容器对外端口定成 HOST_PORT=8010(8000 坐着开发后端)。 三、docker-compose.yml 114 行 → 77 行 头部 34 行的架构论证压成 16 行只留「常用命令 + 配置来源 + 四个挂载点 + 指路 README」, 正文注释每条最多一行;为什么单容器、模型配置为什么不在这份文件里、扩容层怎么叠, 都指向 README §3.2 / §4.0。顺手把上一轮的教训留住:改 .env 之后必须重跑 up -d, restart 沿用旧容器配置、不换端口映射,这条写进了命令清单。 env_value() 补上「去随行注释与尾部空白」:三种解析器(python-dotenv、compose env_file、 本仓的 sed 回读)里只有前者会剥行内注释,漏了它 server.sh 会把 「HOST_PORT=8010 # 本机跑容器…」整串当端口用。 四、文档同步:README §3.2 加端口三键表与「改了没反应的四个键」,§3.1 前端代理、§3.2 命令、 常用改动表、§3.4 server.sh 注释全部改口径;docs/工程规范.md §5 把规则从「端口只有一个键」 改写成「按形态分键 + 含义唯一」,并把两次反复的教训写进正文。 验证:bash -n 两个脚本通过;docker compose config --services 仍只有 app,published 随 HOST_PORT 变化, 容器内四个覆盖值仍是挂载点那套;deploy.sh --check 全绿(19 项入口齐全); 两份 env 0 未知键 0 模型键;backend 全量 502 passed / 1 skipped。
2026-11-05 11:01:32 +00:00
sed -n "s/^[[:space:]]*$1=//p" "$ROOT/.env" | tail -1 \
| sed -E 's/[[:space:]]+#.*$//; s/[[:space:]]+$//' | tr -d '\r"'"'"'' || true
端口收成一个键 PORT,.env 里的模型说明清零,apt 源也能换 一、端口:HOST_PORT / PORT / BACKEND_PORT 三个键砍成一个 上一轮把端口小节加回 .env.example 时,我按「三种部署形态」列了三个键: Docker 用 HOST_PORT、裸机 server.sh 用 PORT、开发 dev.sh 用 BACKEND_PORT+FRONTEND_PORT。 听起来各管一摊,实际上它们指的是同一件事——「这个应用对外听在哪个端口」。 一份要交给运维编辑的文件里出现三个同义键,他的第一反应必然是「我该改哪个」, 而改错那个的表现还是「服务起来了但端口没变」,跟没改一样。所以这次收到一个: PORT = 应用对外端口。Docker 对外的映射读它、裸机 server.sh 的监听端口读它、 开发态的后端也读它。 - docker-compose.yml:ports 改成 "${PORT:-${HOST_PORT:-8000}}:8000",旧键留一版回退; 另外在 environment 里显式写死 PORT: "8000",因为容器内永远监听 8000 (EXPOSE 与健康检查都按 8000 写死),宿主 .env 注进来的那份不能让它漂—— 今天应用不读 PORT 没事,将来谁加一行 os.environ["PORT"] 就会变成 「映射 9000:8000 但进程监听 9000」,容器直接不通。 - server.sh / dev.sh:加 env_value() 回读仓库根 .env(上一轮删掉过,是倒退)。 取值优先级统一 命令行 > 环境变量 > .env > 默认值;旧键 HOST_PORT / BACKEND_PORT 只作兼容回退。回读 .env 是有意的:.env 是运维唯一被要求编辑的文件, 写进去的键必须真的生效,否则就是本仓最忌讳的「写了不生效」。 - 开发态仍保留 FRONTEND_PORT,这不是同义键:Vite 是独立进程,必须和后端错开端口。 - 实测:.env 写 PORT=8211 → server.sh status 打印 server :8211、dev.sh status 打印 backend :8211;PORT=9000 docker compose config 的 published 变 9000 而容器内 PORT 仍是 8000;HOST_PORT=9100(.env 无 PORT 时)仍能回退到 9100。 二、.env / .env.example:只留配置本身 模型相关的配置和说明全部删净——现在两份文件里 VIDEO_* / COMFYUI_* / TTS_* / IMAGE_* / LLM_* 一个键都没有,原先三段「模型配置为什么不在这里」的长说明压成头部两行指引 (去页面「调度中心 → 模型中心」改,服务器初值随 scripts/seed/ 导入)。 .env.example 55 行注释对 45 个生效键,每条最多两行;本机 .env 10 键 10 行注释。 顺带确认:本机 .env 没被删过,它是 gitignored 的,所以从来不出现在提交里。 APP_DATABASE_URL / APP_MEDIA_ROOT 归到 Docker 小节(它们只在容器里成立)。 键名逐个对过 Settings 字段:两份文件 0 个未知键(多余键本身会被 extra="ignore" 吞掉, 但写错字得能立刻看出来)。 三、ffmpeg:镜像里装了,而且源现在可换 回答提问:装了。Dockerfile 运行阶段(python:3.12-slim 没有 ffmpeg)apt 装它, 时间线合成、抽帧、时长/码率质检全调它(app/services/ffmpeg.py); 缺它的表现是「导出成片一路 500」而不是起不来,所以没做成可选层。 实测容器 /health 报 ffmpeg=true(/usr/bin/ffmpeg 5.1.9-0+deb12u1, libass/xfade/subtitles/loudnorm 全 true)。 但这一段以前是唯一没做国内镜像的装包层,README 却写着「三段都走公网镜像源」—— 名不副实,且上次该层在构建机上跑了约 221 s。补上 ARG APT_MIRROR(默认 deb.debian.org, 不传参等于原行为),bookworm 的 /debian 与 /debian-security 同在 deb.debian.org 下, 一次 sed 覆盖 deb822 与老式 sources.list 两种文件;compose 侧透出同名 build-arg。 四、文档同步:README §3.2 端口行与构建源行、§3.4、前端代理那条; docs/工程规范.md §5 补「一件事只有一个键」,并把三键同义列为回归。 backend/tests 全量 502 passed / 1 skipped;bash -n 两个脚本通过; docker compose config 只有一个服务 app,端口映射与 APT_MIRROR 注入均已核对。
2026-11-05 10:44:30 +00:00
}
端口按形态分键:HOST_PORT 只管部署对外,BACKEND_PORT/FRONTEND_PORT 只管开发;.env.example 与 compose 去噪音 一、端口三个键,各管一种形态,键名自带场景 上一轮我把它收敛成单一的 PORT,方向收得太狠:一个键被三种形态共用,等于把「这是给谁看的」 又塞回 README 里——同一个 HOST_PORT 在 Docker 下指对外映射、在裸机下指监听、在开发下指后端, 不翻文档的人分不出来。按形态分回去,判据从来不是键的个数,而是含义的唯一性: 一个键只能有一种含义、同一个 socket 不能有两个键。 HOST_PORT 部署形态对外暴露的端口:compose 拿它插值做端口映射,server.sh 回读它做监听端口 BACKEND_PORT 开发形态的后端 uvicorn(dev.sh 回读,并同步 Vite 代理目标) FRONTEND_PORT 开发形态的前端 Vite(独立进程,必须与后端错开) compose 的 ports 回到 "${HOST_PORT:-8000}:8000",并删掉上一轮为兼容 PORT 加的 environment.PORT="8000" 钉子(键名分开之后没有歧义要钉了)。server.sh 的取值链改成 命令行 --port > 环境变量 HOST_PORT/PORT > .env 的 HOST_PORT > 8000, 旧键 PORT 留一版兼容;dev.sh 只认 BACKEND_PORT/FRONTEND_PORT(PORT 作旧键回退)。 实测:.env 写 HOST_PORT=8010 → compose published=8010、server.sh status 打 :8010; HOST_PORT=9301 环境变量覆盖 → :9301;BACKEND_PORT=8000/FRONTEND_PORT=5173 → dev.sh 两个进程端口正确。 二、.env.example 按 .env 的样式重写,噪音清掉 它是运维唯一被要求编辑的文件,之前 100 行里 65 行是注释与说明,还有一批在 Docker 形态下 根本没人读的键。现在 32 个生效键 / 11 行注释,键位与本机 .env 一一对应,只放配置本身: - 删掉 compose 覆盖掉的那几行的误导(SERVE_FRONTEND 不再列;DATABASE_URL/MEDIA_ROOT 只留一行说明 「Docker 形态 compose 会指到挂载点」),长篇「为什么不在这里」全部搬到 README §3 与工程规范 §5, .env 头部三行指路。 - 删掉只在叠加 scale.yml 时才有人读的 POSTGRES_*/REDIS_URL/CELERY_*(默认值写在 scale.yml 里)。 - 删掉与代码默认值同值的长尾键(上传白名单、COOKIE_NAME、FRONTEND_DIST_DIR、QC 细项等), 需要的人按 Settings 字段名加一行即可(文件头写明键名 = 字段大写下划线)。 - 默认值改成单容器真相:SQLite + inline,不再是 postgresql+…@db:5432 + celery。 本机 .env 同步精简成 11 键 / 8 行注释,并把容器对外端口定成 HOST_PORT=8010(8000 坐着开发后端)。 三、docker-compose.yml 114 行 → 77 行 头部 34 行的架构论证压成 16 行只留「常用命令 + 配置来源 + 四个挂载点 + 指路 README」, 正文注释每条最多一行;为什么单容器、模型配置为什么不在这份文件里、扩容层怎么叠, 都指向 README §3.2 / §4.0。顺手把上一轮的教训留住:改 .env 之后必须重跑 up -d, restart 沿用旧容器配置、不换端口映射,这条写进了命令清单。 env_value() 补上「去随行注释与尾部空白」:三种解析器(python-dotenv、compose env_file、 本仓的 sed 回读)里只有前者会剥行内注释,漏了它 server.sh 会把 「HOST_PORT=8010 # 本机跑容器…」整串当端口用。 四、文档同步:README §3.2 加端口三键表与「改了没反应的四个键」,§3.1 前端代理、§3.2 命令、 常用改动表、§3.4 server.sh 注释全部改口径;docs/工程规范.md §5 把规则从「端口只有一个键」 改写成「按形态分键 + 含义唯一」,并把两次反复的教训写进正文。 验证:bash -n 两个脚本通过;docker compose config --services 仍只有 app,published 随 HOST_PORT 变化, 容器内四个覆盖值仍是挂载点那套;deploy.sh --check 全绿(19 项入口齐全); 两份 env 0 未知键 0 模型键;backend 全量 502 passed / 1 skipped。
2026-11-05 11:01:32 +00:00
# 开发形态两个进程各一个键:BACKEND_PORT(uvicorn)/ FRONTEND_PORT(Vite)。
# 部署形态的对外端口是另一个键 HOST_PORT,跟这里无关(见 .env.example 的端口一节)。
# 取值优先级:命令行 --backend-port/--frontend-port > 同名环境变量 > .env > 默认值,
# 和 scripts/server.sh 是同一条约定:.env 写进去的键必须真的生效
端口收成一个键 PORT,.env 里的模型说明清零,apt 源也能换 一、端口:HOST_PORT / PORT / BACKEND_PORT 三个键砍成一个 上一轮把端口小节加回 .env.example 时,我按「三种部署形态」列了三个键: Docker 用 HOST_PORT、裸机 server.sh 用 PORT、开发 dev.sh 用 BACKEND_PORT+FRONTEND_PORT。 听起来各管一摊,实际上它们指的是同一件事——「这个应用对外听在哪个端口」。 一份要交给运维编辑的文件里出现三个同义键,他的第一反应必然是「我该改哪个」, 而改错那个的表现还是「服务起来了但端口没变」,跟没改一样。所以这次收到一个: PORT = 应用对外端口。Docker 对外的映射读它、裸机 server.sh 的监听端口读它、 开发态的后端也读它。 - docker-compose.yml:ports 改成 "${PORT:-${HOST_PORT:-8000}}:8000",旧键留一版回退; 另外在 environment 里显式写死 PORT: "8000",因为容器内永远监听 8000 (EXPOSE 与健康检查都按 8000 写死),宿主 .env 注进来的那份不能让它漂—— 今天应用不读 PORT 没事,将来谁加一行 os.environ["PORT"] 就会变成 「映射 9000:8000 但进程监听 9000」,容器直接不通。 - server.sh / dev.sh:加 env_value() 回读仓库根 .env(上一轮删掉过,是倒退)。 取值优先级统一 命令行 > 环境变量 > .env > 默认值;旧键 HOST_PORT / BACKEND_PORT 只作兼容回退。回读 .env 是有意的:.env 是运维唯一被要求编辑的文件, 写进去的键必须真的生效,否则就是本仓最忌讳的「写了不生效」。 - 开发态仍保留 FRONTEND_PORT,这不是同义键:Vite 是独立进程,必须和后端错开端口。 - 实测:.env 写 PORT=8211 → server.sh status 打印 server :8211、dev.sh status 打印 backend :8211;PORT=9000 docker compose config 的 published 变 9000 而容器内 PORT 仍是 8000;HOST_PORT=9100(.env 无 PORT 时)仍能回退到 9100。 二、.env / .env.example:只留配置本身 模型相关的配置和说明全部删净——现在两份文件里 VIDEO_* / COMFYUI_* / TTS_* / IMAGE_* / LLM_* 一个键都没有,原先三段「模型配置为什么不在这里」的长说明压成头部两行指引 (去页面「调度中心 → 模型中心」改,服务器初值随 scripts/seed/ 导入)。 .env.example 55 行注释对 45 个生效键,每条最多两行;本机 .env 10 键 10 行注释。 顺带确认:本机 .env 没被删过,它是 gitignored 的,所以从来不出现在提交里。 APP_DATABASE_URL / APP_MEDIA_ROOT 归到 Docker 小节(它们只在容器里成立)。 键名逐个对过 Settings 字段:两份文件 0 个未知键(多余键本身会被 extra="ignore" 吞掉, 但写错字得能立刻看出来)。 三、ffmpeg:镜像里装了,而且源现在可换 回答提问:装了。Dockerfile 运行阶段(python:3.12-slim 没有 ffmpeg)apt 装它, 时间线合成、抽帧、时长/码率质检全调它(app/services/ffmpeg.py); 缺它的表现是「导出成片一路 500」而不是起不来,所以没做成可选层。 实测容器 /health 报 ffmpeg=true(/usr/bin/ffmpeg 5.1.9-0+deb12u1, libass/xfade/subtitles/loudnorm 全 true)。 但这一段以前是唯一没做国内镜像的装包层,README 却写着「三段都走公网镜像源」—— 名不副实,且上次该层在构建机上跑了约 221 s。补上 ARG APT_MIRROR(默认 deb.debian.org, 不传参等于原行为),bookworm 的 /debian 与 /debian-security 同在 deb.debian.org 下, 一次 sed 覆盖 deb822 与老式 sources.list 两种文件;compose 侧透出同名 build-arg。 四、文档同步:README §3.2 端口行与构建源行、§3.4、前端代理那条; docs/工程规范.md §5 补「一件事只有一个键」,并把三键同义列为回归。 backend/tests 全量 502 passed / 1 skipped;bash -n 两个脚本通过; docker compose config 只有一个服务 app,端口映射与 APT_MIRROR 注入均已核对。
2026-11-05 10:44:30 +00:00
# (后端换端口时下面还会把 NEX_BACKEND 一起带着走,代理不会掉队)。
端口按形态分键:HOST_PORT 只管部署对外,BACKEND_PORT/FRONTEND_PORT 只管开发;.env.example 与 compose 去噪音 一、端口三个键,各管一种形态,键名自带场景 上一轮我把它收敛成单一的 PORT,方向收得太狠:一个键被三种形态共用,等于把「这是给谁看的」 又塞回 README 里——同一个 HOST_PORT 在 Docker 下指对外映射、在裸机下指监听、在开发下指后端, 不翻文档的人分不出来。按形态分回去,判据从来不是键的个数,而是含义的唯一性: 一个键只能有一种含义、同一个 socket 不能有两个键。 HOST_PORT 部署形态对外暴露的端口:compose 拿它插值做端口映射,server.sh 回读它做监听端口 BACKEND_PORT 开发形态的后端 uvicorn(dev.sh 回读,并同步 Vite 代理目标) FRONTEND_PORT 开发形态的前端 Vite(独立进程,必须与后端错开) compose 的 ports 回到 "${HOST_PORT:-8000}:8000",并删掉上一轮为兼容 PORT 加的 environment.PORT="8000" 钉子(键名分开之后没有歧义要钉了)。server.sh 的取值链改成 命令行 --port > 环境变量 HOST_PORT/PORT > .env 的 HOST_PORT > 8000, 旧键 PORT 留一版兼容;dev.sh 只认 BACKEND_PORT/FRONTEND_PORT(PORT 作旧键回退)。 实测:.env 写 HOST_PORT=8010 → compose published=8010、server.sh status 打 :8010; HOST_PORT=9301 环境变量覆盖 → :9301;BACKEND_PORT=8000/FRONTEND_PORT=5173 → dev.sh 两个进程端口正确。 二、.env.example 按 .env 的样式重写,噪音清掉 它是运维唯一被要求编辑的文件,之前 100 行里 65 行是注释与说明,还有一批在 Docker 形态下 根本没人读的键。现在 32 个生效键 / 11 行注释,键位与本机 .env 一一对应,只放配置本身: - 删掉 compose 覆盖掉的那几行的误导(SERVE_FRONTEND 不再列;DATABASE_URL/MEDIA_ROOT 只留一行说明 「Docker 形态 compose 会指到挂载点」),长篇「为什么不在这里」全部搬到 README §3 与工程规范 §5, .env 头部三行指路。 - 删掉只在叠加 scale.yml 时才有人读的 POSTGRES_*/REDIS_URL/CELERY_*(默认值写在 scale.yml 里)。 - 删掉与代码默认值同值的长尾键(上传白名单、COOKIE_NAME、FRONTEND_DIST_DIR、QC 细项等), 需要的人按 Settings 字段名加一行即可(文件头写明键名 = 字段大写下划线)。 - 默认值改成单容器真相:SQLite + inline,不再是 postgresql+…@db:5432 + celery。 本机 .env 同步精简成 11 键 / 8 行注释,并把容器对外端口定成 HOST_PORT=8010(8000 坐着开发后端)。 三、docker-compose.yml 114 行 → 77 行 头部 34 行的架构论证压成 16 行只留「常用命令 + 配置来源 + 四个挂载点 + 指路 README」, 正文注释每条最多一行;为什么单容器、模型配置为什么不在这份文件里、扩容层怎么叠, 都指向 README §3.2 / §4.0。顺手把上一轮的教训留住:改 .env 之后必须重跑 up -d, restart 沿用旧容器配置、不换端口映射,这条写进了命令清单。 env_value() 补上「去随行注释与尾部空白」:三种解析器(python-dotenv、compose env_file、 本仓的 sed 回读)里只有前者会剥行内注释,漏了它 server.sh 会把 「HOST_PORT=8010 # 本机跑容器…」整串当端口用。 四、文档同步:README §3.2 加端口三键表与「改了没反应的四个键」,§3.1 前端代理、§3.2 命令、 常用改动表、§3.4 server.sh 注释全部改口径;docs/工程规范.md §5 把规则从「端口只有一个键」 改写成「按形态分键 + 含义唯一」,并把两次反复的教训写进正文。 验证:bash -n 两个脚本通过;docker compose config --services 仍只有 app,published 随 HOST_PORT 变化, 容器内四个覆盖值仍是挂载点那套;deploy.sh --check 全绿(19 项入口齐全); 两份 env 0 未知键 0 模型键;backend 全量 502 passed / 1 skipped。
2026-11-05 11:01:32 +00:00
BACKEND_PORT="${BACKEND_PORT:-$(env_value BACKEND_PORT)}"
BACKEND_PORT="${BACKEND_PORT:-$(env_value PORT)}" # 旧键兼容
2026-11-01 08:18:07 +00:00
BACKEND_PORT="${BACKEND_PORT:-8000}"
端口收成一个键 PORT,.env 里的模型说明清零,apt 源也能换 一、端口:HOST_PORT / PORT / BACKEND_PORT 三个键砍成一个 上一轮把端口小节加回 .env.example 时,我按「三种部署形态」列了三个键: Docker 用 HOST_PORT、裸机 server.sh 用 PORT、开发 dev.sh 用 BACKEND_PORT+FRONTEND_PORT。 听起来各管一摊,实际上它们指的是同一件事——「这个应用对外听在哪个端口」。 一份要交给运维编辑的文件里出现三个同义键,他的第一反应必然是「我该改哪个」, 而改错那个的表现还是「服务起来了但端口没变」,跟没改一样。所以这次收到一个: PORT = 应用对外端口。Docker 对外的映射读它、裸机 server.sh 的监听端口读它、 开发态的后端也读它。 - docker-compose.yml:ports 改成 "${PORT:-${HOST_PORT:-8000}}:8000",旧键留一版回退; 另外在 environment 里显式写死 PORT: "8000",因为容器内永远监听 8000 (EXPOSE 与健康检查都按 8000 写死),宿主 .env 注进来的那份不能让它漂—— 今天应用不读 PORT 没事,将来谁加一行 os.environ["PORT"] 就会变成 「映射 9000:8000 但进程监听 9000」,容器直接不通。 - server.sh / dev.sh:加 env_value() 回读仓库根 .env(上一轮删掉过,是倒退)。 取值优先级统一 命令行 > 环境变量 > .env > 默认值;旧键 HOST_PORT / BACKEND_PORT 只作兼容回退。回读 .env 是有意的:.env 是运维唯一被要求编辑的文件, 写进去的键必须真的生效,否则就是本仓最忌讳的「写了不生效」。 - 开发态仍保留 FRONTEND_PORT,这不是同义键:Vite 是独立进程,必须和后端错开端口。 - 实测:.env 写 PORT=8211 → server.sh status 打印 server :8211、dev.sh status 打印 backend :8211;PORT=9000 docker compose config 的 published 变 9000 而容器内 PORT 仍是 8000;HOST_PORT=9100(.env 无 PORT 时)仍能回退到 9100。 二、.env / .env.example:只留配置本身 模型相关的配置和说明全部删净——现在两份文件里 VIDEO_* / COMFYUI_* / TTS_* / IMAGE_* / LLM_* 一个键都没有,原先三段「模型配置为什么不在这里」的长说明压成头部两行指引 (去页面「调度中心 → 模型中心」改,服务器初值随 scripts/seed/ 导入)。 .env.example 55 行注释对 45 个生效键,每条最多两行;本机 .env 10 键 10 行注释。 顺带确认:本机 .env 没被删过,它是 gitignored 的,所以从来不出现在提交里。 APP_DATABASE_URL / APP_MEDIA_ROOT 归到 Docker 小节(它们只在容器里成立)。 键名逐个对过 Settings 字段:两份文件 0 个未知键(多余键本身会被 extra="ignore" 吞掉, 但写错字得能立刻看出来)。 三、ffmpeg:镜像里装了,而且源现在可换 回答提问:装了。Dockerfile 运行阶段(python:3.12-slim 没有 ffmpeg)apt 装它, 时间线合成、抽帧、时长/码率质检全调它(app/services/ffmpeg.py); 缺它的表现是「导出成片一路 500」而不是起不来,所以没做成可选层。 实测容器 /health 报 ffmpeg=true(/usr/bin/ffmpeg 5.1.9-0+deb12u1, libass/xfade/subtitles/loudnorm 全 true)。 但这一段以前是唯一没做国内镜像的装包层,README 却写着「三段都走公网镜像源」—— 名不副实,且上次该层在构建机上跑了约 221 s。补上 ARG APT_MIRROR(默认 deb.debian.org, 不传参等于原行为),bookworm 的 /debian 与 /debian-security 同在 deb.debian.org 下, 一次 sed 覆盖 deb822 与老式 sources.list 两种文件;compose 侧透出同名 build-arg。 四、文档同步:README §3.2 端口行与构建源行、§3.4、前端代理那条; docs/工程规范.md §5 补「一件事只有一个键」,并把三键同义列为回归。 backend/tests 全量 502 passed / 1 skipped;bash -n 两个脚本通过; docker compose config 只有一个服务 app,端口映射与 APT_MIRROR 注入均已核对。
2026-11-05 10:44:30 +00:00
FRONTEND_PORT="${FRONTEND_PORT:-$(env_value FRONTEND_PORT)}"
2026-11-01 08:18:07 +00:00
FRONTEND_PORT="${FRONTEND_PORT:-5173}"
依赖下载点全部配国内源,并修掉「镜像里没有中文字体」这个字幕坑 用户诉求是「镜像已有,其它依赖考虑国内加速」。先把全链路的外部下载点摸了一遍, 结论:**构建镜像不需要 huggingface**——唯一的 HF 地址在 scripts/server.sh, 只在裸机 install 的 fetch_asr_model() 里用到,而且容器里根本没有 whisper-cli, 那条 curl 在 Docker 路径下永远不会执行;requirements.txt 只有 8 个包(没有任何 whisper/hub 依赖),models/ 也被 .dockerignore 排掉。构建期真正的下载点只有 npm / apt / pip 三个,此前 npm 与 pip 已是国内源,只有 apt 还默认 deb.debian.org (实测这一层要 200+ 秒,清华 0.24 秒拿到 Release)。 改动: - Dockerfile:APT_MIRROR 默认改清华(境外显式传回 deb.debian.org);apt 清单 ffmpeg → ffmpeg fontconfig fonts-noto-cjk。后两个是真 bug 修复——slim + --no-install-recommends 连 DejaVu 都不带,libass 找不到中文字形**不报错**, 直接把烧的字幕画成一片豆腐块;services/ffmpeg.py 又要靠 fc-list/fc-scan 按 charset 反查字体,所以 fontconfig 也一并装上。装完代码零改动: _FONT_FILE_CANDIDATES 里已写着 fonts-noto-cjk 的落盘路径。嫌 +120MB 可换 fonts-wqy-microhei(+10MB)。 - server.sh / dev.sh:新增 PIP_INDEX_URL / NPM_REGISTRY / ASR_DOWNLOAD_URL 三组 可覆盖变量,优先级 环境变量 > .env > 内置默认,键名与 Dockerfile 的 --build-arg 完全一致(容器和裸机同一套口径);pip 一律带 -i、npm 一律带 --registry; ASR 权重默认走 hf-mirror(huggingface.co 国内实测 0.04s 直接连接重置)。 - server.sh install 新增中文字体探测:复用 app.services.ffmpeg.cjk_font_catalog(), 查不到就 warn,别等出片了才发现字幕是方块。 - 四处默认值对齐(Dockerfile / docker-compose.yml / server.sh / dev.sh)。 - README §3.2 新增「依赖下载点与国内源」表:五个下载点各自发生在什么时候、 用哪个键、默认值是什么,并点明浏览器侧 Google Fonts 是最后一处外部依赖 (只影响访问者,要彻底离线需自托管);工程规范 §5 补一条「依赖源只有一套键、 默认即国内,判据是新机器零配置能装起来」。 验证:bash -n 两个脚本通过;字体探针正反向都跑过(本机 49 个中文字体 → exit 0); docker compose config 服务仍只有 app、args 渲染出新默认值;deploy.sh --check 19 项全绿; pytest -k "ffmpeg or subtitle or font or asr or speech or quality" 35 passed 1 skipped (未改后端代码,故未跑全量)。docker build 本机验证不了(Docker daemon 没起), 需在服务器上构建确认。
2026-11-05 11:36:32 +00:00
# 依赖下载源:和 server.sh / Dockerfile 同一套键(PIP_INDEX_URL / NPM_REGISTRY),
# 默认国内源,优先级 环境变量 > .env > 内置默认。
PIP_INDEX="${PIP_INDEX_URL:-$(env_value PIP_INDEX_URL)}"
PIP_INDEX="${PIP_INDEX:-https://pypi.tuna.tsinghua.edu.cn/simple}"
NPM_REGISTRY="${NPM_REGISTRY:-$(env_value NPM_REGISTRY)}"
NPM_REGISTRY="${NPM_REGISTRY:-https://registry.npmmirror.com}"
2026-11-01 08:18:07 +00:00
RELOAD=0
AUTO_INSTALL=1
WANT_BACKEND=1
WANT_FRONTEND=1
if [ -t 1 ]; then C_G=$'\033[32m'; C_Y=$'\033[33m'; C_R=$'\033[31m'; C_B=$'\033[36m'; C_D=$'\033[2m'; C_0=$'\033[0m'
else C_G=""; C_Y=""; C_R=""; C_B=""; C_D=""; C_0=""; fi
ok() { printf ' %sok%s %s\n' "$C_G" "$C_0" "$*"; }
info() { printf ' %s\n' "$*"; }
warn() { printf ' %s!%s %s\n' "$C_Y" "$C_0" "$*"; }
die() { printf ' %sXX%s %s\n' "$C_R" "$C_0" "$*" >&2; exit 1; }
head2() { printf '\n%s%s%s\n' "$C_B" "$*" "$C_0"; }
# ------------------------------------------------------------------ 基础工具
port_pids() { # 谁在监听这个端口(可能为空)
lsof -nP -iTCP:"$1" -sTCP:LISTEN -t 2>/dev/null | tr '\n' ' ' | sed 's/[[:space:]]*$//' || true
}
pid_of() { [ -f "$RUN_DIR/$1.pid" ] && cat "$RUN_DIR/$1.pid" 2>/dev/null || true; }
alive() { local p="${1:-}"; [ -n "$p" ] && kill -0 "$p" 2>/dev/null; }
# 在独立会话里拉起进程:stdout/stderr 落日志,返回 pid。
# 不能只写 `cmd &`——脚本一退出,整个进程组会被一起回收。
spawn() { # spawn <name> <cwd> <cmd...>
local name="$1" cwd="$2"; shift 2
mkdir -p "$RUN_DIR" "$LOG_DIR"
local pid
pid="$("$PYBIN" - "$LOG_DIR/$name.log" "$cwd" "$@" <<'PY'
import subprocess, sys
log_path, cwd, cmd = sys.argv[1], sys.argv[2], sys.argv[3:]
log = open(log_path, "ab", buffering=0)
p = subprocess.Popen(cmd, stdin=subprocess.DEVNULL, stdout=log, stderr=log,
cwd=cwd, start_new_session=True, close_fds=True)
print(p.pid)
PY
)"
printf '%s\n' "$pid" > "$RUN_DIR/$name.pid"
printf '%s\n' "$pid"
}
wait_http() { # wait_http <url> <超时秒>
local url="$1" limit="${2:-90}" i=0
while [ "$i" -lt "$limit" ]; do
if curl -fsS --max-time 2 -o /dev/null "$url" 2>/dev/null; then return 0; fi
sleep 1; i=$((i + 1))
done
return 1
}
# ------------------------------------------------------------------ 依赖自检
prepare() {
head2 "环境自检"
command -v curl >/dev/null || die "缺少 curl"
# .env:缺失就从模板复制,避免第一次跑的人对着 404 猜半天
if [ ! -f "$ROOT/.env" ]; then
if [ -f "$ROOT/.env.example" ]; then
cp "$ROOT/.env.example" "$ROOT/.env"
前端四项调整:输入框去掉光晕、账号菜单收口、逐页删开发期说明书、登录页重做成左右分栏 用户这一轮提了四条,其中三条是同一件事的三个面——**界面上残留着写给开发者自己的话**。 逐条落地的口径与取舍: **1)所有输入框聚焦时的蓝色外框** 量出来其实是三层叠在一起:antd 组件 token 的 `activeShadow`(2px 主色光晕)、 `genFocusStyle` 画的 `outline`、站内 `app.css` 给自绘表面准备的全站 `:focus-visible` 兜底。 第二层没有独立 token,而它依赖的 `lineWidthFocus` 还被 Upload 拖拽区复用,动 token 会连带改上传框, 所以分两刀收:`theme/antd.ts` 关 token(`Input`/`InputNumber` 的 `activeShadow` = `none`、 `Select.activeOutlineColor` = `transparent`),`styles/app.css` 用 `:where(...):focus-visible { outline: none }` 关那圈 outline——用 `:where()` 是为了把特异度归零, 它只是一份选择器清单而不是新加一层优先级,将来谁要恢复焦点环不必先赢过一条 `!important` (app.css 本身不在 `@layer` 里,压得住被 Tailwind 放进 `@layer antd` 的那份,本来就不需要 `!important`)。 **焦点指示没有被删**:antd 的 `activeBorderColor` + 加粗边框仍在,键盘用户看得见焦点; 自绘表面继续吃全站那条兜底。实测聚焦 `#login-user`:`box-shadow: none`、`outline: none 3px`、 `border-color` 浅 rgb(22,119,255) / 深 rgb(22,104,220)。 **2)账号胶囊:菜单去重、项上不留副标题** 「设置新密码」和「我的账号」是同一件事,且首启时登录页已经直接把人的带到 `/account?must=1`, 重复排队只让菜单变长——删掉,待办语义留着头像上的 Badge 红点。 菜单项不再写「账号信息 · 密码 · 登录设备」这类预演式说明;顺手把胶囊第二行的 `第 N 次登录` 也去了:那是「用户管理」表格里逐人登记的数据,挂在人人都要看的顶栏里等于把统计搬进导航。 现在菜单就是三项:我的账号 / 用户管理 / 退出登录。 **3)逐页去开发时冗余说明**(`Dashboard` / `AssetLibrary` / `ModelCenter` / `AgentConsole` / `project/{Library,Overview,Storyboard,Timeline,Review,Delivery}` / `ProjectBriefDrawer`) 三类处置,已写进 UI规范 §14 G2: - 常驻说明书删掉可见文字,信息进 `title`/`desc`:IndexTTS2 那四行论文式介绍(两处重复, 含「下面这条预告会说清楚:」)、总控台「期间页面不会推进,属正常现象」; - 开发者口径翻成「会怎样」:ffmpeg libass 提示只留降级后果,`FFMPEG_BIN` / `brew install ffmpeg-full` / 当前探测路径收进 `title`;`Delivery` 卡头「媒体由后端 `/media` 直出,下载走 `/api/exports/:id/download`」整条删; 「每一站的汇总状态由它覆盖的那几个节点折算而来」→「点一行直接跳到对应环节」; - 内部词不许漏到版面:`mock/Mock` → 站内既有的**演练通道**(四处)、「未匹配的列在 `unmatched_images`」 → 翻成人话;**一个物件只有一个名字**,`/models` 曾同时叫「模型中心 / 模型控制台 / 调度中心 → 模型中心」, 全站统一成侧栏那一项的写法 **模型管理中心**(含 `.env` 注释、`dev.sh`/`server.sh`/`seed.py` 的引导语、 后端四条给用户的报错文案、README、docs、探针页面名),并修掉不存在的入口路径「调度中心 → 模型中心」。 有意保留:单位与取值口径的括号(`(秒)(毫秒)(可选)(0=自动)(dB)`——读数不该依赖悬停)、 条件出现的 `Notice`/`LineHint`/`ErrorText`、`confirmAction` 的 `desc`、`Stat hint`、`nav.hint`、 `PageHead sub`(kit 既定槽位的一句话职责说明)、`Help.tsx` 整页(登记在册的产品手册)。 配套给 `OptionGrid` 单开 `labelTitle`,让组标签的括号补充有地方去而不额外占一行。 **4)登录页重做**(UI规范新增 §13.4) 左右分栏:左栏 `w-[46%] max-w-[620px]` 写平台自述(品牌行 →「把一条长视频,做成一条流水线」+ 三条能力点 → 角色可见范围),底色用 `color-mix` 把主色掺进 `color-bg-layout`,**零新 hex**; 右栏卡片保留原生 `<form>` 包在 `<Panel>` 外(Enter 提交与密码自动填充都挂在 form 上)。 窄于 `lg` 左栏整列收起,品牌行回到卡片顶部,任何宽度都认得出登的是哪个系统。 去掉后端下发的种子账号预填(`login_hint` 字段本身保留,`test_auth.py` 与 `e2e_selfcheck.py` 还在用它判首启), placeholder 回到「用户名」「密码」;新增**记住我**:键 `nex-login`,账号+口令一起记一起清 (只清口令留账号的话勾选框就不算数了),只在登录成功后落盘,取消勾选当场 `writeLocal(key, null)`, 默认不勾(本机明文口令)。 文档同步:UI规范 §8.4(`labelTitle`)、§9.3(焦点轮廓三层口径)、§13.4(登录页)、 §14 G2(三类处置 + 一个物件一个名字)与 §14 例外登记(登录页左栏、`Help.tsx` 整页豁免); README 鉴权一节补登录页与记住我;命名统一顺带扫了 `.env.example` / 三个脚本 / 后端文案。 验证:`npx tsc --noEmit`、`npm run build` 全绿;`node scripts/ui/classaudit.mjs` 七道闸门 0/0/0/0/0/0/0; 后端 + 前端起在 :8010/:5199 后跑完 §15 全部探针,退出码全 0——visualcheck 1440×明暗 15 路由 (console 0 / HTTP 失败 0 / 断言 0)、tableaudit 0、gridcheck 0、rhythmcheck 0、tagcheck 0/0、 btnrowcheck 0(413 组)、aligncheck 0、symmetrycheck 0、feedbackcheck 通过、footercheck 0(30 处吸底条)、 btnclustercheck 0(159 簇);gateprobe 11/11 反向验证;`pytest -q` 全量 502 passed 1 skipped (后端改了四条用户可见文案,对应 3 处断言同步更新)。记住我三条路径(勾上存 / 不勾清空 / 取消即清)实测过。
2026-11-05 14:09:16 +00:00
warn "已从 .env.example 生成 .env(空库只有 mock 模型可用);真实模型在「模型管理中心」登记,"
模型配置全部交给数据库,.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 10:17:47 +00:00
warn " 或导入数据包:.venv/bin/python scripts/seed.py install --only-missing(模型配置不在 .env 里)"
2026-11-01 08:18:07 +00:00
else
die "缺少 .env 且没有 .env.example"
fi
else
ok ".env 就绪"
fi
# 后端虚拟环境
if [ ! -x "$PYBIN" ]; then
[ "$AUTO_INSTALL" = 1 ] || die "缺少 .venv(加 --no-install 时不会自动创建):python3 -m venv .venv && .venv/bin/pip install -r backend/requirements.txt"
info "创建虚拟环境并安装后端依赖(首次约 1~2 分钟)…"
command -v python3 >/dev/null || die "缺少 python3"
python3 -m venv "$ROOT/.venv" || die "venv 创建失败"
依赖下载点全部配国内源,并修掉「镜像里没有中文字体」这个字幕坑 用户诉求是「镜像已有,其它依赖考虑国内加速」。先把全链路的外部下载点摸了一遍, 结论:**构建镜像不需要 huggingface**——唯一的 HF 地址在 scripts/server.sh, 只在裸机 install 的 fetch_asr_model() 里用到,而且容器里根本没有 whisper-cli, 那条 curl 在 Docker 路径下永远不会执行;requirements.txt 只有 8 个包(没有任何 whisper/hub 依赖),models/ 也被 .dockerignore 排掉。构建期真正的下载点只有 npm / apt / pip 三个,此前 npm 与 pip 已是国内源,只有 apt 还默认 deb.debian.org (实测这一层要 200+ 秒,清华 0.24 秒拿到 Release)。 改动: - Dockerfile:APT_MIRROR 默认改清华(境外显式传回 deb.debian.org);apt 清单 ffmpeg → ffmpeg fontconfig fonts-noto-cjk。后两个是真 bug 修复——slim + --no-install-recommends 连 DejaVu 都不带,libass 找不到中文字形**不报错**, 直接把烧的字幕画成一片豆腐块;services/ffmpeg.py 又要靠 fc-list/fc-scan 按 charset 反查字体,所以 fontconfig 也一并装上。装完代码零改动: _FONT_FILE_CANDIDATES 里已写着 fonts-noto-cjk 的落盘路径。嫌 +120MB 可换 fonts-wqy-microhei(+10MB)。 - server.sh / dev.sh:新增 PIP_INDEX_URL / NPM_REGISTRY / ASR_DOWNLOAD_URL 三组 可覆盖变量,优先级 环境变量 > .env > 内置默认,键名与 Dockerfile 的 --build-arg 完全一致(容器和裸机同一套口径);pip 一律带 -i、npm 一律带 --registry; ASR 权重默认走 hf-mirror(huggingface.co 国内实测 0.04s 直接连接重置)。 - server.sh install 新增中文字体探测:复用 app.services.ffmpeg.cjk_font_catalog(), 查不到就 warn,别等出片了才发现字幕是方块。 - 四处默认值对齐(Dockerfile / docker-compose.yml / server.sh / dev.sh)。 - README §3.2 新增「依赖下载点与国内源」表:五个下载点各自发生在什么时候、 用哪个键、默认值是什么,并点明浏览器侧 Google Fonts 是最后一处外部依赖 (只影响访问者,要彻底离线需自托管);工程规范 §5 补一条「依赖源只有一套键、 默认即国内,判据是新机器零配置能装起来」。 验证:bash -n 两个脚本通过;字体探针正反向都跑过(本机 49 个中文字体 → exit 0); docker compose config 服务仍只有 app、args 渲染出新默认值;deploy.sh --check 19 项全绿; pytest -k "ffmpeg or subtitle or font or asr or speech or quality" 35 passed 1 skipped (未改后端代码,故未跑全量)。docker build 本机验证不了(Docker daemon 没起), 需在服务器上构建确认。
2026-11-05 11:36:32 +00:00
"$PYBIN" -m pip install -q -i "$PIP_INDEX" --upgrade pip
"$PYBIN" -m pip install -q -i "$PIP_INDEX" -r "$ROOT/backend/requirements.txt" \
|| die "后端依赖安装失败(换源:PIP_INDEX_URL=https://…)"
ok "后端依赖已安装(pip 源 ${PIP_INDEX})"
2026-11-01 08:18:07 +00:00
elif ! "$PYBIN" -c "import uvicorn, fastapi" 2>/dev/null; then
[ "$AUTO_INSTALL" = 1 ] || die "后端依赖不完整(缺 uvicorn/fastapi),且指定了 --no-install"
info "补齐后端依赖…"
依赖下载点全部配国内源,并修掉「镜像里没有中文字体」这个字幕坑 用户诉求是「镜像已有,其它依赖考虑国内加速」。先把全链路的外部下载点摸了一遍, 结论:**构建镜像不需要 huggingface**——唯一的 HF 地址在 scripts/server.sh, 只在裸机 install 的 fetch_asr_model() 里用到,而且容器里根本没有 whisper-cli, 那条 curl 在 Docker 路径下永远不会执行;requirements.txt 只有 8 个包(没有任何 whisper/hub 依赖),models/ 也被 .dockerignore 排掉。构建期真正的下载点只有 npm / apt / pip 三个,此前 npm 与 pip 已是国内源,只有 apt 还默认 deb.debian.org (实测这一层要 200+ 秒,清华 0.24 秒拿到 Release)。 改动: - Dockerfile:APT_MIRROR 默认改清华(境外显式传回 deb.debian.org);apt 清单 ffmpeg → ffmpeg fontconfig fonts-noto-cjk。后两个是真 bug 修复——slim + --no-install-recommends 连 DejaVu 都不带,libass 找不到中文字形**不报错**, 直接把烧的字幕画成一片豆腐块;services/ffmpeg.py 又要靠 fc-list/fc-scan 按 charset 反查字体,所以 fontconfig 也一并装上。装完代码零改动: _FONT_FILE_CANDIDATES 里已写着 fonts-noto-cjk 的落盘路径。嫌 +120MB 可换 fonts-wqy-microhei(+10MB)。 - server.sh / dev.sh:新增 PIP_INDEX_URL / NPM_REGISTRY / ASR_DOWNLOAD_URL 三组 可覆盖变量,优先级 环境变量 > .env > 内置默认,键名与 Dockerfile 的 --build-arg 完全一致(容器和裸机同一套口径);pip 一律带 -i、npm 一律带 --registry; ASR 权重默认走 hf-mirror(huggingface.co 国内实测 0.04s 直接连接重置)。 - server.sh install 新增中文字体探测:复用 app.services.ffmpeg.cjk_font_catalog(), 查不到就 warn,别等出片了才发现字幕是方块。 - 四处默认值对齐(Dockerfile / docker-compose.yml / server.sh / dev.sh)。 - README §3.2 新增「依赖下载点与国内源」表:五个下载点各自发生在什么时候、 用哪个键、默认值是什么,并点明浏览器侧 Google Fonts 是最后一处外部依赖 (只影响访问者,要彻底离线需自托管);工程规范 §5 补一条「依赖源只有一套键、 默认即国内,判据是新机器零配置能装起来」。 验证:bash -n 两个脚本通过;字体探针正反向都跑过(本机 49 个中文字体 → exit 0); docker compose config 服务仍只有 app、args 渲染出新默认值;deploy.sh --check 19 项全绿; pytest -k "ffmpeg or subtitle or font or asr or speech or quality" 35 passed 1 skipped (未改后端代码,故未跑全量)。docker build 本机验证不了(Docker daemon 没起), 需在服务器上构建确认。
2026-11-05 11:36:32 +00:00
"$PYBIN" -m pip install -q -i "$PIP_INDEX" -r "$ROOT/backend/requirements.txt" \
|| die "后端依赖安装失败(换源:PIP_INDEX_URL=https://…)"
ok "后端依赖已补齐(pip 源 ${PIP_INDEX})"
2026-11-01 08:18:07 +00:00
else
ok "后端依赖就绪($("$PYBIN" -V 2>&1))"
fi
# 前端依赖(--backend-only 时跳过:新机器上能省掉一次 npm install)
if [ "$WANT_FRONTEND" != 1 ]; then
info "${C_D}跳过前端依赖检查(--backend-only)${C_0}"
elif [ ! -d "$ROOT/frontend/node_modules" ]; then
command -v npm >/dev/null || die "缺少 npm(前端需要)"
[ "$AUTO_INSTALL" = 1 ] || die "缺少 frontend/node_modules,且指定了 --no-install:cd frontend && npm install"
info "安装前端依赖…"
依赖下载点全部配国内源,并修掉「镜像里没有中文字体」这个字幕坑 用户诉求是「镜像已有,其它依赖考虑国内加速」。先把全链路的外部下载点摸了一遍, 结论:**构建镜像不需要 huggingface**——唯一的 HF 地址在 scripts/server.sh, 只在裸机 install 的 fetch_asr_model() 里用到,而且容器里根本没有 whisper-cli, 那条 curl 在 Docker 路径下永远不会执行;requirements.txt 只有 8 个包(没有任何 whisper/hub 依赖),models/ 也被 .dockerignore 排掉。构建期真正的下载点只有 npm / apt / pip 三个,此前 npm 与 pip 已是国内源,只有 apt 还默认 deb.debian.org (实测这一层要 200+ 秒,清华 0.24 秒拿到 Release)。 改动: - Dockerfile:APT_MIRROR 默认改清华(境外显式传回 deb.debian.org);apt 清单 ffmpeg → ffmpeg fontconfig fonts-noto-cjk。后两个是真 bug 修复——slim + --no-install-recommends 连 DejaVu 都不带,libass 找不到中文字形**不报错**, 直接把烧的字幕画成一片豆腐块;services/ffmpeg.py 又要靠 fc-list/fc-scan 按 charset 反查字体,所以 fontconfig 也一并装上。装完代码零改动: _FONT_FILE_CANDIDATES 里已写着 fonts-noto-cjk 的落盘路径。嫌 +120MB 可换 fonts-wqy-microhei(+10MB)。 - server.sh / dev.sh:新增 PIP_INDEX_URL / NPM_REGISTRY / ASR_DOWNLOAD_URL 三组 可覆盖变量,优先级 环境变量 > .env > 内置默认,键名与 Dockerfile 的 --build-arg 完全一致(容器和裸机同一套口径);pip 一律带 -i、npm 一律带 --registry; ASR 权重默认走 hf-mirror(huggingface.co 国内实测 0.04s 直接连接重置)。 - server.sh install 新增中文字体探测:复用 app.services.ffmpeg.cjk_font_catalog(), 查不到就 warn,别等出片了才发现字幕是方块。 - 四处默认值对齐(Dockerfile / docker-compose.yml / server.sh / dev.sh)。 - README §3.2 新增「依赖下载点与国内源」表:五个下载点各自发生在什么时候、 用哪个键、默认值是什么,并点明浏览器侧 Google Fonts 是最后一处外部依赖 (只影响访问者,要彻底离线需自托管);工程规范 §5 补一条「依赖源只有一套键、 默认即国内,判据是新机器零配置能装起来」。 验证:bash -n 两个脚本通过;字体探针正反向都跑过(本机 49 个中文字体 → exit 0); docker compose config 服务仍只有 app、args 渲染出新默认值;deploy.sh --check 19 项全绿; pytest -k "ffmpeg or subtitle or font or asr or speech or quality" 35 passed 1 skipped (未改后端代码,故未跑全量)。docker build 本机验证不了(Docker daemon 没起), 需在服务器上构建确认。
2026-11-05 11:36:32 +00:00
(cd "$ROOT/frontend" && npm install --registry "$NPM_REGISTRY" --no-audit --no-fund) > "$LOG_DIR/npm-install.log" 2>&1 \
2026-11-01 08:18:07 +00:00
|| die "npm install 失败,详见 .local/logs/npm-install.log"
ok "前端依赖已安装"
else
ok "前端依赖就绪"
fi
# ffmpeg 只影响质检/合成,缺失不挡启动,但要说清楚
if command -v ffmpeg >/dev/null && command -v ffprobe >/dev/null; then
ok "ffmpeg 就绪"
else
warn "未找到 ffmpeg/ffprobe:质检与合成导出会不可用(brew install ffmpeg)"
fi
}
# ------------------------------------------------------------------ 启动
start_backend() {
head2 "后端 FastAPI :$BACKEND_PORT"
local existing busy
existing="$(pid_of backend)"
if alive "$existing"; then
ok "已在运行 pid=${existing}(跳过启动)"
return 0
fi
busy="$(port_pids "$BACKEND_PORT")"
[ -z "$busy" ] || die "端口 $BACKEND_PORT 被进程 $busy 占用;先 ./scripts/dev.sh stop 或用 --backend-port 换端口"
local pid
# 从仓库根启动 + --app-dir 指向 backend/:.env、media、SQLite 相对路径都锚定仓库根,
# 换目录启动不会再出现「两拨 media」「找不到已生成镜头」。
local cmd=("$PYBIN" -m uvicorn app.main:app --app-dir "$ROOT/backend" --host "$HOST" --port "$BACKEND_PORT")
[ "$RELOAD" = 1 ] && cmd+=(--reload)
pid="$(spawn backend "$ROOT" "${cmd[@]}")"
if wait_http "http://$PROBE_HOST:$BACKEND_PORT/health" 90; then
ok "健康检查通过 pid=$pid"
else
warn "90s 内 /health 未就绪,最后 30 行日志:"
tail -30 "$LOG_DIR/backend.log" 2>/dev/null || true
die "后端启动失败"
fi
}
start_frontend() {
head2 "前端 Vite :$FRONTEND_PORT"
local existing busy
existing="$(pid_of frontend)"
if alive "$existing"; then
ok "已在运行 pid=${existing}(跳过启动)"
return 0
fi
busy="$(port_pids "$FRONTEND_PORT")"
[ -z "$busy" ] || die "端口 $FRONTEND_PORT 被进程 $busy 占用;先 ./scripts/dev.sh stop 或用 --frontend-port 换端口"
# 代理目标跟着后端端口走(vite.config.ts 读 NEX_BACKEND);
# --strictPort 让端口冲突直接失败,而不是悄悄换一个端口让自检脚本打空。
export NEX_BACKEND="http://$PROBE_HOST:$BACKEND_PORT"
local pid
pid="$(spawn frontend "$ROOT/frontend" npm run dev -- --host "$HOST" --port "$FRONTEND_PORT" --strictPort)"
if wait_http "http://$PROBE_HOST:$FRONTEND_PORT/" 60; then
ok "开发服务器就绪 pid=$pid"
else
warn "60s 内前端未就绪,最后 30 行日志:"
tail -30 "$LOG_DIR/frontend.log" 2>/dev/null || true
die "前端启动失败"
fi
}
report() {
head2 "已启动"
[ "$WANT_FRONTEND" = 1 ] && info "${C_B}界面${C_0} http://$PROBE_HOST:$FRONTEND_PORT ${C_D}(Vite → 代理 /api、/media 到后端)${C_0}"
[ "$WANT_BACKEND" = 1 ] && info "${C_B}接口${C_0} http://$PROBE_HOST:$BACKEND_PORT/docs"
if [ -n "$LAN_IP" ] && [ "$PROBE_HOST" = "127.0.0.1" ]; then
[ "$WANT_FRONTEND" = 1 ] && info "${C_B}局域网${C_0} http://$LAN_IP:$FRONTEND_PORT ${C_D}(同网段设备可直接打开)${C_0}"
[ "$WANT_BACKEND" = 1 ] && info "${C_B}局域网${C_0} http://$LAN_IP:$BACKEND_PORT/docs"
fi
info "${C_B}日志${C_0} .local/logs/backend.log .local/logs/frontend.log ${C_D}跟踪:./scripts/dev.sh logs${C_0}"
info "${C_B}停止${C_0} ./scripts/dev.sh stop"
前端四项调整:输入框去掉光晕、账号菜单收口、逐页删开发期说明书、登录页重做成左右分栏 用户这一轮提了四条,其中三条是同一件事的三个面——**界面上残留着写给开发者自己的话**。 逐条落地的口径与取舍: **1)所有输入框聚焦时的蓝色外框** 量出来其实是三层叠在一起:antd 组件 token 的 `activeShadow`(2px 主色光晕)、 `genFocusStyle` 画的 `outline`、站内 `app.css` 给自绘表面准备的全站 `:focus-visible` 兜底。 第二层没有独立 token,而它依赖的 `lineWidthFocus` 还被 Upload 拖拽区复用,动 token 会连带改上传框, 所以分两刀收:`theme/antd.ts` 关 token(`Input`/`InputNumber` 的 `activeShadow` = `none`、 `Select.activeOutlineColor` = `transparent`),`styles/app.css` 用 `:where(...):focus-visible { outline: none }` 关那圈 outline——用 `:where()` 是为了把特异度归零, 它只是一份选择器清单而不是新加一层优先级,将来谁要恢复焦点环不必先赢过一条 `!important` (app.css 本身不在 `@layer` 里,压得住被 Tailwind 放进 `@layer antd` 的那份,本来就不需要 `!important`)。 **焦点指示没有被删**:antd 的 `activeBorderColor` + 加粗边框仍在,键盘用户看得见焦点; 自绘表面继续吃全站那条兜底。实测聚焦 `#login-user`:`box-shadow: none`、`outline: none 3px`、 `border-color` 浅 rgb(22,119,255) / 深 rgb(22,104,220)。 **2)账号胶囊:菜单去重、项上不留副标题** 「设置新密码」和「我的账号」是同一件事,且首启时登录页已经直接把人的带到 `/account?must=1`, 重复排队只让菜单变长——删掉,待办语义留着头像上的 Badge 红点。 菜单项不再写「账号信息 · 密码 · 登录设备」这类预演式说明;顺手把胶囊第二行的 `第 N 次登录` 也去了:那是「用户管理」表格里逐人登记的数据,挂在人人都要看的顶栏里等于把统计搬进导航。 现在菜单就是三项:我的账号 / 用户管理 / 退出登录。 **3)逐页去开发时冗余说明**(`Dashboard` / `AssetLibrary` / `ModelCenter` / `AgentConsole` / `project/{Library,Overview,Storyboard,Timeline,Review,Delivery}` / `ProjectBriefDrawer`) 三类处置,已写进 UI规范 §14 G2: - 常驻说明书删掉可见文字,信息进 `title`/`desc`:IndexTTS2 那四行论文式介绍(两处重复, 含「下面这条预告会说清楚:」)、总控台「期间页面不会推进,属正常现象」; - 开发者口径翻成「会怎样」:ffmpeg libass 提示只留降级后果,`FFMPEG_BIN` / `brew install ffmpeg-full` / 当前探测路径收进 `title`;`Delivery` 卡头「媒体由后端 `/media` 直出,下载走 `/api/exports/:id/download`」整条删; 「每一站的汇总状态由它覆盖的那几个节点折算而来」→「点一行直接跳到对应环节」; - 内部词不许漏到版面:`mock/Mock` → 站内既有的**演练通道**(四处)、「未匹配的列在 `unmatched_images`」 → 翻成人话;**一个物件只有一个名字**,`/models` 曾同时叫「模型中心 / 模型控制台 / 调度中心 → 模型中心」, 全站统一成侧栏那一项的写法 **模型管理中心**(含 `.env` 注释、`dev.sh`/`server.sh`/`seed.py` 的引导语、 后端四条给用户的报错文案、README、docs、探针页面名),并修掉不存在的入口路径「调度中心 → 模型中心」。 有意保留:单位与取值口径的括号(`(秒)(毫秒)(可选)(0=自动)(dB)`——读数不该依赖悬停)、 条件出现的 `Notice`/`LineHint`/`ErrorText`、`confirmAction` 的 `desc`、`Stat hint`、`nav.hint`、 `PageHead sub`(kit 既定槽位的一句话职责说明)、`Help.tsx` 整页(登记在册的产品手册)。 配套给 `OptionGrid` 单开 `labelTitle`,让组标签的括号补充有地方去而不额外占一行。 **4)登录页重做**(UI规范新增 §13.4) 左右分栏:左栏 `w-[46%] max-w-[620px]` 写平台自述(品牌行 →「把一条长视频,做成一条流水线」+ 三条能力点 → 角色可见范围),底色用 `color-mix` 把主色掺进 `color-bg-layout`,**零新 hex**; 右栏卡片保留原生 `<form>` 包在 `<Panel>` 外(Enter 提交与密码自动填充都挂在 form 上)。 窄于 `lg` 左栏整列收起,品牌行回到卡片顶部,任何宽度都认得出登的是哪个系统。 去掉后端下发的种子账号预填(`login_hint` 字段本身保留,`test_auth.py` 与 `e2e_selfcheck.py` 还在用它判首启), placeholder 回到「用户名」「密码」;新增**记住我**:键 `nex-login`,账号+口令一起记一起清 (只清口令留账号的话勾选框就不算数了),只在登录成功后落盘,取消勾选当场 `writeLocal(key, null)`, 默认不勾(本机明文口令)。 文档同步:UI规范 §8.4(`labelTitle`)、§9.3(焦点轮廓三层口径)、§13.4(登录页)、 §14 G2(三类处置 + 一个物件一个名字)与 §14 例外登记(登录页左栏、`Help.tsx` 整页豁免); README 鉴权一节补登录页与记住我;命名统一顺带扫了 `.env.example` / 三个脚本 / 后端文案。 验证:`npx tsc --noEmit`、`npm run build` 全绿;`node scripts/ui/classaudit.mjs` 七道闸门 0/0/0/0/0/0/0; 后端 + 前端起在 :8010/:5199 后跑完 §15 全部探针,退出码全 0——visualcheck 1440×明暗 15 路由 (console 0 / HTTP 失败 0 / 断言 0)、tableaudit 0、gridcheck 0、rhythmcheck 0、tagcheck 0/0、 btnrowcheck 0(413 组)、aligncheck 0、symmetrycheck 0、feedbackcheck 通过、footercheck 0(30 处吸底条)、 btnclustercheck 0(159 簇);gateprobe 11/11 反向验证;`pytest -q` 全量 502 passed 1 skipped (后端改了四条用户可见文案,对应 3 处断言同步更新)。记住我三条路径(勾上存 / 不勾清空 / 取消即清)实测过。
2026-11-05 14:09:16 +00:00
info "${C_B}模型${C_0} 默认位在数据库 ${C_D}model_specs${C_0};换模型走「模型管理中心」,改完即生效不用重启"
2026-11-01 08:18:07 +00:00
status_runtime
}
# ------------------------------------------------------------------ 运行状态
status_runtime() {
head2 "运行状态"
local row name port pid p http
for row in "backend:$BACKEND_PORT" "frontend:$FRONTEND_PORT"; do
name="${row%%:*}"; port="${row##*:}"
pid="$(pid_of "$name")"
if alive "$pid"; then
printf ' %srunning%s %-9s :%-6s pid=%s\n' "$C_G" "$C_0" "$name" "$port" "$pid"
elif [ -n "$(port_pids "$port")" ]; then
printf ' %sbusy%s %-9s :%-6s 被本脚本之外的进程占用 (pid=%s)\n' \
"$C_Y" "$C_0" "$name" "$port" "$(port_pids "$port")"
else
printf ' %sstopped%s %-9s :%s\n' "$C_D" "$C_0" "$name" "$port"
fi
done
模型配置全部交给数据库,.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 10:17:47 +00:00
# 后端细节:执行后端 / 当前默认模型 / 模型端点连通性——这三项决定「是不是真在跑真实模型」。
# 端点地址存在 model_specs.config_json 里(.env 早就不放了),所以只能问进程:
# 以前这里 curl 的是 .env 里的 COMFYUI_BASE_URL,改过地址后探的是废弃端点,绿字反而误导。
2026-11-01 08:18:07 +00:00
if curl -fsS --max-time 3 -o /dev/null "http://$PROBE_HOST:$BACKEND_PORT/health" 2>/dev/null; then
模型配置全部交给数据库,.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 10:17:47 +00:00
NEX_STATUS_BASE="http://$PROBE_HOST:$BACKEND_PORT" "$PYBIN" - <<'PY' || true
import http.cookiejar
import json
import os
import sys
import urllib.error
import urllib.request
base = os.environ["NEX_STATUS_BASE"].rstrip("/")
GREEN, YELLOW, DIM, RESET = (("\033[32m", "\033[33m", "\033[2m", "\033[0m")
if sys.stdout.isatty() else ("", "", "", ""))
_jar = http.cookiejar.CookieJar()
_opener = urllib.request.build_opener(urllib.request.HTTPCookieProcessor(_jar))
2026-11-01 08:18:07 +00:00
模型配置全部交给数据库,.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 10:17:47 +00:00
def call(path, payload=None, timeout=8):
url = base + path
data = json.dumps(payload).encode() if payload is not None else None
req = urllib.request.Request(url, data=data,
headers={"Content-Type": "application/json"} if data else {})
with _opener.open(req, timeout=timeout) as r:
2026-11-01 08:18:07 +00:00
return json.loads(r.read().decode())
try:
模型配置全部交给数据库,.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 10:17:47 +00:00
h = call("/health")
2026-11-01 08:18:07 +00:00
caps = h.get("ffmpeg_capabilities") or {}
print(f" executor={h.get('executor')} database={h.get('database')} "
f"ffmpeg={h.get('ffmpeg')} xfade={caps.get('xfade')} model_specs={h.get('model_specs')}")
except Exception as exc:
print(f" 健康检查失败:{type(exc).__name__}: {exc}")
raise SystemExit(0)
try:
模型配置全部交给数据库,.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 10:17:47 +00:00
# AUTH_ENABLED 默认 true,未登录时 /api/providers 是 401——上一版把异常打成
# 「模型注册表读取失败」,看起来像没配模型,其实只是没带会话。开发机口令见 .env.example。
state = call("/api/auth/state")
if state.get("auth_enabled") and not state.get("authenticated"):
call("/api/auth/login", {
"username": os.environ.get("NEX_USER")
or (state.get("login_hint") or {}).get("username") or "admin",
"password": os.environ.get("NEX_PASS") or "admin1234"})
providers = call("/api/providers")["providers"]
2026-11-01 08:18:07 +00:00
except Exception as exc:
print(f" 模型注册表读取失败:{type(exc).__name__}: {exc}")
模型配置全部交给数据库,.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 10:17:47 +00:00
raise SystemExit(0)
2026-11-01 08:18:07 +00:00
模型配置全部交给数据库,.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 10:17:47 +00:00
for p in providers:
if p.get("media_type") != "video":
continue
flag = "默认" if p.get("is_default") else " "
print(f" [{flag}] {p['provider']}/{p['model']} adapter={p['adapter']} "
f"时长 {p['min_duration']}-{p['max_duration']}s 可用={p.get('available')}")
for p in providers:
if p.get("is_default") and p.get("media_type") != "video":
print(f" [默认] {p['media_type']:5s} {p['provider']}/{p['model']} "
f"可用={p.get('available')}")
# 端点连通性:库里在册且启用的地址逐个探(真实模型未注册时这里应该什么都不显示)。
# 一台 GPU 机同时挂视频/图像/配音三条是常态,去重后只探一次,否则会刷三行同样的结果。
endpoints = {}
for p in providers:
if not p.get("enabled"):
continue
url = str((p.get("config") or {}).get("base_url") or "").rstrip("/")
if url and not p.get("uses_mock"):
endpoints.setdefault(url, []).append(f"{p['provider']}/{p['model']}")
for url, users in sorted(endpoints.items()):
probe = f"{url}/system_stats" if "comfy" in url.lower() else url
try:
urllib.request.urlopen(probe, timeout=4)
print(f" {GREEN}reachable{RESET} {url} ← {', '.join(sorted(users))}")
except urllib.error.HTTPError as exc:
# 有 HTTP 应答就算机器活着:LLM 的 base_url 直接 GET 多半回 401/404
# (没带 key、根路径没有路由),urllib 把非 2xx 当异常抛,这里不能据此判死。
# 真正的鉴权与模型可用性看页面 🔌 探测(它打的是各自适配器认得的接口)。
color, tag = (GREEN, "reachable ") if exc.code < 500 else (YELLOW, "error ")
print(f" {color}{tag}{RESET} {url} ← {', '.join(sorted(users))}"
f" {DIM}(HTTP {exc.code}){RESET}")
except Exception:
print(f" {YELLOW}unreachable{RESET} {url} ← {', '.join(sorted(users))}"
f" {DIM}(这几条模型真实出片会失败,页面点 🔌 探测看细节){RESET}")
PY
2026-11-01 08:18:07 +00:00
fi
}
# ------------------------------------------------------------------ 停止
stop_one() {
local name="$1" pid
pid="$(pid_of "$name")"
if ! alive "$pid"; then
rm -f "$RUN_DIR/$name.pid"
info "$name 未在运行"
return 0
fi
# pid 就是会话组长:按进程组回收,npm → vite 这种父子链才不会留下孤儿 vite
kill -TERM -- "-$pid" 2>/dev/null || kill -TERM "$pid" 2>/dev/null || true
local i=0
while alive "$pid" && [ "$i" -lt 20 ]; do sleep 0.5; i=$((i + 1)); done
if alive "$pid"; then
kill -KILL -- "-$pid" 2>/dev/null || kill -KILL "$pid" 2>/dev/null || true
fi
rm -f "$RUN_DIR/$name.pid"
ok "$name 已停止(pid=${pid})"
}
usage() {
sed -n '3,22p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'
}
# ------------------------------------------------------------------ 入口
# 命令与选项顺序随意:`dev.sh start --reload`、`dev.sh --reload`、`dev.sh --reload start` 都对。
# 早先只认「第一个参数是命令」,`dev.sh --backend-only` 会被当成未知命令直接退出。
ACTION="start"
EXTRA=()
while [ $# -gt 0 ]; do
case "$1" in
start|stop|restart|status|logs) ACTION="$1" ;;
--backend-only) WANT_FRONTEND=0 ;;
--frontend-only) WANT_BACKEND=0 ;;
--reload) RELOAD=1 ;;
--no-install) AUTO_INSTALL=0 ;;
--backend-port) BACKEND_PORT="${2:?--backend-port 需要端口}"; shift ;;
--frontend-port) FRONTEND_PORT="${2:?--frontend-port 需要端口}"; shift ;;
--host) HOST="${2:?--host 需要地址}"; shift ;;
-h|--help) usage; exit 0 ;;
--*) die "未知选项:${1}(--help 看用法)" ;;
# 只有 logs 需要位置参数(backend / frontend);其余情况的多余参数一律当命令写错了,
# 否则 `dev.sh strt` 这种手误会静默变成「启动」,用户还以为命令生效了。
*) EXTRA+=("$1") ;;
esac
shift
done
if [ "${#EXTRA[@]}" -gt 0 ] && [ "$ACTION" != "logs" ]; then
die "未知命令:${EXTRA[0]}(./scripts/dev.sh --help)"
fi
do_start() {
printf 'Nex Animation Studio · 单机开发模式(cwd=%s)\n' "$ROOT"
[ "$WANT_FRONTEND" = 1 ] || [ "$WANT_BACKEND" = 1 ] || die "前后端都被关掉了"
prepare
[ "$WANT_BACKEND" = 1 ] && start_backend
[ "$WANT_FRONTEND" = 1 ] && start_frontend
report
}
case "$ACTION" in
start) do_start ;;
stop) stop_one frontend; stop_one backend ;;
restart) stop_one frontend; stop_one backend; do_start ;;
status) status_runtime ;;
logs)
case "${EXTRA[0]:-}" in
backend|frontend) FILES=("$LOG_DIR/${EXTRA[0]}.log") ;;
"") FILES=("$LOG_DIR/backend.log" "$LOG_DIR/frontend.log") ;;
*) die "logs 只支持 backend / frontend" ;;
esac
for f in "${FILES[@]}"; do [ -f "$f" ] || : > "$f"; done
exec tail -n 60 -F "${FILES[@]}"
;;
*) die "未知命令:${ACTION}(./scripts/dev.sh --help)" ;;
esac