docs: record multilingual asr deployment

.memory/assistant-handoff.md

@@ -1,6 +1,6 @@
 # 项目接力
 
-- 生成时间：May 21, 2026 at 17:15
+- 生成时间：May 22, 2026 at 09:01
 - 项目：SKG Marketing Studio / SKG 营销内容工作台
 - 路径：/Users/kangwan/Projects/business/20260512-20260512-skg-tk-二创验证
 - 状态：active
@@ -9,7 +9,7 @@
 ## 最近助手会话概览
 
 - Claude：a9e0449c-d9cb-4a2a-bb16-16596dfb552a · 时间未知
-- Codex：019e4913-d34e-7943-925e-ec1b60ddf937 · 时间未知
+- Codex：019e49d1-d114-7d52-8cf0-fbb4585f5ce6 · 时间未知
 - Cursor：未找到匹配当前项目的最近会话
 
 ## Claude 最近会话
@@ -92,51 +92,57 @@
 
 ## Codex 最近会话
 
-- Session ID：019e4913-d34e-7943-925e-ec1b60ddf937
+- Session ID：019e49d1-d114-7d52-8cf0-fbb4585f5ce6
-- Transcript：/Users/kangwan/.codex/sessions/2026/05/21/rollout-2026-05-21T13-48-16-019e4913-d34e-7943-925e-ec1b60ddf937.jsonl
+- Transcript：/Users/kangwan/.codex/sessions/2026/05/21/rollout-2026-05-21T17-15-47-019e49d1-d114-7d52-8cf0-fbb4585f5ce6.jsonl
 - 工作目录：/Users/kangwan/Projects/business/20260512-20260512-skg-tk-二创验证
 - 分支：main
 - 敏感字段：已对 token / key / password / secret 做脱敏
 
 ### 最近用户要求
 
-- 那我现在直接给你个服务器，你来弄好，api什么的都配好公司的  界面设计也弄好  你能行么
+- 分镜这个板块，我每次点击视频 都变成了选择 其实我就是想打开看下而已 你这个逻辑不太对  你看下
-- 上来就是1分钟的  没事
+- 为什么要选择呢  你给我点击下载的按钮不就好了
-- https://www.figma.com/design/petlyV2zio31BdZghC1alb/iOS-15-UI-Kit-for-Figma--Community-?node-id=5-54&p=f&t=l1NYiFeSZNk5bWtp-0   设计都在这里找，ssh root@2.24.28.41  根密码应该可以在记忆里看到
+- 而且每个生成的视频当然是自动保存呀  还需要我点击保存干啥
 
 ### Codex 最近回复
 
-> 推送第一次被沙箱拦住了，我按规则用提升权限重试 `git push origin main`。`.memory/worklog.json` 又被会话心跳改了一次，这类辅助日志我先不再反复追提交，避免变成无限心跳提交。
+> 生产部署正在跑第二轮，远端备份和同步已经完成，Web 镜像在构建；我等脚本验证结束。
 
-> 已上线。页面我已经打开了，公网入口是：
+> 对，这个点你说得对。生成的视频本来就会写进当前 job 的 `generated_videos`，完成后自动回填 mp4，不应该让用户理解成还要点“保存视频”。
 > 
-> `http://2.24.28.41:4290/agent/`
+> 我已经改完并上线：
 > 
-> 现在流程是你要的极简形态：左侧只放 TikTok 链接和产品图上传，中间是 Agent Terminal 实时日志，右侧是成片播放器、分镜 contact sheet 和下载入口。后端不是“裸 Codex 乱跑”，而是 `AgentRun` 状态机：下载、素材准备、12 段 x 5 秒规划、生成、失败重试、审片、合成，最终约 1 分钟。
+> - 分镜视频候选轨现在显示 `自动保存`
+> - 视频候选普通点击只负责打开预览
+> - 右上角提供显式 `下载` 按钮
+> - “保存全部 / 保存本条规划”改成了“同步规划 / 同步本条规划”，只表达同步三字段文案规划，不再像保存视频
+> - 源码解析页也同步更新了这条交互语义
 > 
-> 已验证：
+> 验证和发布：
-> - 远端 `skg-agent-api` / `skg-agent-web` 容器正常运行
-> - 未登录 `/agent/` 正确跳 `/login/`
-> - 登录后 `/agent/` 返回 200
-> - `/api/agent-runs` 返回数组
-> - 容器内 `/health` 为 `ok:true` 且 `auth_configured:true`
-> - 本地 `python3 -m py_compile api/main.py` 通过
-> - 本地 `web/npm run build` 通过
 > 
-> 已推送到 Gitea：`77d23a0 feat: add one-click agent cut terminal`
+> - `web/npm run build` 通过
+> - 已推送 Gitea：
+>   - `4efb2ce fix: make storyboard video clicks previewable`
+>   - `eb4347a fix: clarify storyboard videos auto-save`
+> - 已执行 `./scripts/deploy-prod-safe.sh` 上线，生产验证通过：`/login/ 200`、`/api/health 401`、容器内 `api:health ok`
 > 
-> 最后状态：`git status -sb` 显示 `main...origin/main` 已同步；只剩 `.memory/worklog.json` 被会话心跳再次改动，我没有继续追提交这个自动日志，避免无限心跳提交。
+> 当前 `git status -sb`：
 > 
-> 我没有额外代你点一次真实 1 分钟生成，因为那会立刻消耗视频 API；现在页面已经可以你上传产品图后直接触发。
+> ```text
+> ## main...origin/main
+>  M .memory/worklog.json
+> ```
+> 
+> 只剩自动日志 `.memory/worklog.json`，业务代码和文档都已提交并推送。
+> 
+> 补充：`npm run lint` 现在跑不了，因为项目里没有可执行的 `eslint`；`tsc --noEmit` 仍有一批既有的 dashboard/ui 旧类型错误，不是这次改动引入的。
 > 
 > <oai-mem-citation>
 > <citation_entries>
-> MEMORY.md:72-85|note=[used host context pointer for 2.24.28.41]
+> MEMORY.md:214-286|note=[used SKG worktable context and docs update expectation]
 > </citation_entries>
 > <rollout_ids>
-> 019e44c6-d8fe-7090-949d-f57d527a6f36
+> 019e2fef-97a7-7523-a1ff-051a8c6…
-> </rollout_ids>
-> </…
 
 ## Cursor 最近会话
 
@@ -146,7 +152,7 @@
 
 - 当前分支：main
 - 未提交变更：1 项
-- 最近提交：feat: add one-click agent cut terminal
+- 最近提交：fix: clarify storyboard videos auto-save
 - 变更文件：
 -    M .memory/worklog.json
 

RULES.md

@@ -18,6 +18,7 @@
 - Agent Cut 独立预览服务器：`2.24.28.41`（Ubuntu 24.04 / Docker Compose / 裸端口 `4290`），部署目录 `/opt/skg-marketing-studio`，Compose 入口 `docker-compose.standalone.yml`，访问地址 `http://2.24.28.41:4290/agent/`。该入口用于“一分钟二创出片终端”预览：用户只提交 TikTok 链接和产品图，后端 `AgentRun` 状态机负责下载、抽帧、规划、生成、自动重跑、审片和合成。
 - Agent Cut 独立预览验证（2026-05-21）：已在 `2.24.28.41` 的 `/opt/skg-marketing-studio` 用 `docker-compose.standalone.yml` 启动 `skg-agent-api` / `skg-agent-web`；独立 compose 通过网络别名兼容 Nginx 的 `skg-marketing-api` upstream。该裸 IP HTTP 入口的服务器 `deploy/.env.production` 需要 `WEB_AUTH_COOKIE_SECURE=false`；本次已补齐 `WEB_AUTH_*` 后重启验证通过：未登录 `/agent/` 返回 302 到 `/login/`，登录后 `/agent/` 返回 200，`/api/agent-runs` 返回数组，容器内 `/health` 返回 `ok:true` 且 `auth_configured:true`。
 - 发布状态：已部署并验证（2026-05-20，主体元素按套图文件夹分组展示，主体生成接口提交后立即返回 queued 占位并后台逐视角生成、逐张回填；工作台外层取消 1800x1000 固定画布和应用层 `zoom` 缩放，改为正常流式桌面容器，最低操作宽度 1280px；源视频工作区主体链路为上方竖向参考帧池 + 宽幅对话式转换层、下方主体元素结果栏；转换层通过参考帧 `+` 加入、参考图分析、生图对话，英文 prompt 就绪后由发送区主按钮切换为确认生成，点击后才触发主体套图生成；转换层不再固定 640px 长高，按内容自然高度显示，仅以 560px 最大高度兜底内部滚动；下方主体元素结果栏的套图输出、轮询、文件夹分组、单张重生、删除和 hover 预览逻辑保持不变；胶片双击/拖拽加入参考帧池 + 胶片缓存复用 + 音频解析失败可重试，参考帧缩略图保持小尺寸 9:16 比例 + hover 左侧紧凑预览，旧主体模板区移出主路径 + 逐句时间轴移到原版视频下方并支持双行文案 + 波形同框时间对齐画面胶片 + 胶片密度按钮上移波形顶部 + 去分隔线 + 胶片上下错落 + body 顶层原位大放大 + 隐藏源视频工作区音频解析摘要卡 + 隐藏工作区顶部状态提示条 + 三字段候选生成工作流 + 折叠紧凑候选区）；`https://marketing.skg.com` 已启用应用内登录页，未登录 API 返回 401，认证后首页 200；容器内 `/health` 返回 `ok:true`
+- 最近部署验证（2026-05-22）：`6427935` 已通过 `./scripts/deploy-prod-safe.sh` 部署到 `/opt/skg-marketing-studio`；部署前备份为 `/opt/skg-marketing-studio-backups/skg-marketing-preserve-20260522012756.tgz`，生产 Docker 重建后脚本内验证通过（web/API 容器 Up、`/` 302、`/login/` 200、缺失 `_next` 资源 404、未登录 `/api/health` 401、容器内 `api:health ok`、`api:ytdlp_cookie_args []`）。部署后已把生产私有 `deploy/.env.production` 明确固定为多语言本地 ASR 路径并重启 API：`ASR_LANGUAGE=auto`、`FASTER_WHISPER_MODEL=base`、`ASR_REMOTE_ENABLED=false`、`ASR_LOCAL_FALLBACK_ENABLED=true`、`ASR_AUDIO_FALLBACK_ENABLED=false`；复验 `./scripts/verify-prod-docker.sh root@76.13.31.179` 通过，容器内 `/health` 确认 `asr_language=auto`、`faster_whisper=base`。
 - 最近部署验证（2026-05-21）：`8458dac` 已按“先本地 Docker、再上传部署”流程上线。上线前在本机 Docker 构建 `skg-marketing-studio-web:latest` / `skg-marketing-studio-api:latest`，并用本地 Compose 容器验证通过：`web:/ 302`、`web:/login/ 200`、`web:/_next/does-not-exist.js 404`、`web:/api/health 401`、`api:health ok`、`api:ytdlp_cookie_args []`、静态 bundle 包含 `未来健康 · 营销内容工作台` 和 `信息流广告复刻生产`，且未发现本地 API/dev URL 泄漏。随后通过 `./scripts/deploy-prod-safe.sh` 部署到 `/opt/skg-marketing-studio`；部署前备份为 `/opt/skg-marketing-studio-backups/skg-marketing-preserve-20260521070327.tgz`，生产 Docker 重建后脚本内验证通过（web/API 容器 Up、`/` 302、`/login/` 200、缺失 `_next` 资源 404、未登录 `/api/health` 401、容器内 `api:health ok`）。
 - 最近部署验证（2026-05-20）：`6597db3` 已通过 `./scripts/deploy-prod-safe.sh` 部署到 `/opt/skg-marketing-studio`；部署前备份为 `/opt/skg-marketing-studio-backups/skg-marketing-preserve-20260520151033.tgz`，生产 Docker 重建后脚本内验证通过（`web:/login/ 200`、`web:/api/health 401`、`api:health ok`）。线上登录后检查首页静态资源，当前加载 chunk `/_next/static/chunks/c48f07b9aef1cd29.js` 已包含 `min-w-[1280px]` 和 `max-w-[1920px]`，未再命中旧的 `h-[1000px]`、`w-[1800px]`、`BOARD_SCALE_PRESETS` 或 `boardScale`；对应工作台取消固定画布缩放，按浏览器正常流式布局渲染。
 - 最近部署验证（2026-05-20）：`2b842fd` 已通过 `./scripts/deploy-prod-safe.sh` 部署到 `/opt/skg-marketing-studio`；部署前备份为 `/opt/skg-marketing-studio-backups/skg-marketing-preserve-20260520145223.tgz`，生产 Docker 重建后脚本内验证通过（`web:/login/ 200`、`web:/api/health 401`、`api:health ok`）。线上登录后检查首页静态资源，当前加载 chunk `/_next/static/chunks/743b82648dfa9db9.js` 已包含 `h-32`、`maxHeight:560`、`提示词就绪` 和 `确认生成`，且未再命中旧的 `height:640` / `h-40`；对应转换层取消固定长高，生成要求输入区回到 128px，底部仍由发送区主按钮确认生成。