SKG AI 素材管线 - TK 二创验证

启动

后台启动（不弹 Terminal）：./scripts/start-dev-background.sh（通过 macOS launchd 后台托管；前端 4290 + 后端 4291，日志写入 .logs/）
后台停止：./scripts/stop-dev-background.sh
前端 dev：cd web && pnpm dev（Next.js 16，端口 4290）
后端 dev：cd api && uvicorn main:app --host 127.0.0.1 --port 4291（FastAPI，端口 4291，重任务用）
注意：后端不要带 --reload 跑长下载 / 抽帧 / 音频任务；reload 会等待后台任务结束，导致 4291 端口占用但新请求卡住。

详见 CLAUDE.md 立项决策段 + .memory/plan.md 七步管线拆解
风格：04-Dark-Gallery-Ambient（路径：~/Projects/research/20260305-网页风格库/04-Dark-Gallery-Ambient.md）
第一冲刺：步骤 1-4（下载 / 拆轨 / 关键帧 / ASR+翻译）
当前产品方向（2026-05-17 确认）：优先做信息流广告快速复刻产出，不再把主界面做成可视化流程节点；主界面为四列横向生产看板：素材输入列（一个素材就是一次文件任务）→ 音频解析 / 新分镜文案列 → 视频关键元素 / 抽帧生成列 → 视频合成列。

平台：VPS 76.13.31.179（Ubuntu 24.04 / Docker Compose / Coolify Traefik）
发布状态：已部署并验证（2026-05-15）；https://marketing.skg.com 已启用应用内登录页，认证后首页 200，/api/health 返回 ok:true
主站 / 前端：https://marketing.skg.com
API / 后端：https://marketing.skg.com/api
代码仓库 / Gitea：https://git.kang-kang.com/kangwan/20260512-skg-tk
文档 / 解析：docs/source-analysis.html（项目内独立文档，不公开挂主应用路由）
管理后台：待定
服务器目录：/opt/skg-marketing-studio
生产启动：docker compose -f docker-compose.prod.yml --env-file deploy/.env.production up -d --build
生产架构：web 容器用 Nginx 承载 Next 静态导出；/login/、/_next/、/assets/、/skg-logo-black.svg、/oasis-source/ 等登录页必需静态资源公开访问；未登录访问工作台跳转 /login/，/api/ 通过 Nginx auth_request 校验 FastAPI 会话 Cookie 后反代到 skg-marketing-api:4291；Traefik 通过 coolify 外部网络接入 80/443
持久化目录：服务器 ./data/jobs 挂载到后端 /data/jobs
登录凭证：用户名写下方快捷登录；密码明文备份只放服务器 /root/skg-marketing-studio-login.txt，生产环境变量 WEB_AUTH_PASSWORD / WEB_AUTH_SESSION_SECRET 只放服务器 deploy/.env.production

新增或变更公网地址后，必须同步更新 .project.json.urls
如果有网页后台登录：
- 可直接入库：写 .project.json.quick_login
- 不应入库：写 .project.json.credentials 引用
部署完成后，RULES.md 和 .project.json 必须同一次任务一起更新

工作看板全局规则适用于本项目：/Users/kangwan/Projects/code/20260317-rules-dashboard/RULES.md、SCHEMA.md、rules/03-Git约定.md、rules/04-版本发布规则.md
主分支：main
主远端：origin → ssh://git@git.kang-kang.com:22222/kangwan/20260512-skg-tk.git
Gitea 网页仓库：https://git.kang-kang.com/kangwan/20260512-skg-tk
每次开发结束前必须执行并汇报 git status -sb 和变更范围
代码、规则、部署或元数据变更必须形成 feat:、fix:、docs:、chore:、release: 等人工语义 commit；auto-save 只算安全快照
能联网和鉴权时必须 git push origin main；如果不能推送，最终回复必须写清楚当前分支、领先/落后数量、最新未推送 commit 和失败原因

LLM_BASE_URL / LLM_API_KEY：OpenAI 兼容网关，用于 ASR、翻译、文案改写、图像等模型调用
ASR_MODEL：OpenAI Audio Transcriptions 音频转写模型，默认 whisper-1
ASR_FALLBACK_MODEL：当当前网关没有 /audio/transcriptions 时，用 Gemini 多模态 chat 直接识别 wav，默认 gemini-2.5-flash
TRANSLATE_MODEL：字幕翻译模型，默认 gemini-2.5-flash
REWRITE_MODEL：通用改写/分镜描述模型，默认 gemini-2.5-pro
AUDIO_REWRITE_MODEL：音频口播改写模型，默认跟随 REWRITE_MODEL；当前产物要求按原音频时长输出英文 SKG 产品介绍 voice-over
AUDIO_PRODUCT_BRIEF：音频口播改写时注入的 SKG 产品卖点
MINIMAX_API_KEY：MiniMax T2A 配音 Key，只能放本地 api/.env，不能入库
MINIMAX_TTS_BASE_URL / MINIMAX_TTS_MODEL / MINIMAX_TTS_VOICE_ID：MiniMax 配音端点、模型和兜底音色配置
MINIMAX_TTS_VOICE_POOL：MiniMax 英文随机音色池；当前默认男声 English_magnetic_voiced_man、女声 English_Upbeat_Woman、成熟声 English_MaturePartner
POE_API_KEY / VIDEO_API_KEY：视频生成通道 Key，只能放本地环境变量
WEB_AUTH_USERNAME / WEB_AUTH_PASSWORD / WEB_AUTH_SESSION_SECRET：生产网页登录和会话签名配置；密码和 session secret 只放服务器环境变量，不入库
生产环境变量：服务器只使用 deploy/.env.production，模板为 deploy/.env.production.example；真实 Key 不入库