@optima-chat/gen-cli 1.2.1 → 2.1.0

package/.claude/skills/video-translate/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: video-translate
 description: "把单段口播视频翻译成 English / Thai (Thailand) / Malay (Malaysia) / Vietnamese (Vietnam) 之一,出片自带译音(自动克隆原说话人)+ 烧录目标语花体字幕 + 默认 BGM ducking。触发场景:用户说翻译这个视频/做泰语版/英文版/越南语版/马来语版/视频本地化/换语言/dub。"
-version: 1.0.2
+version: 1.0.3
 owner_repo: Optima-Chat/optima-gen
 ---
 
@@ -21,7 +21,7 @@ owner_repo: Optima-Chat/optima-gen
 ## 前提
 
 - 源视频 URL 公网可访问(或先让用户上传到 Optima → 拿 URL)
-- 容器有:`gen` CLI(`@optima-chat/optima-gen` ≥ latest)、`video-translate` CLI(`@optima-chat/video-translate-tools` ≥ 1.0.2)、`ffmpeg`、`curl`、`jq`
+- 容器有:`gen` CLI(`@optima-chat/optima-gen` ≥ latest)、`video-translate` CLI(`@optima-chat/video-translate-tools` ≥ 1.0.5)、`ffmpeg`、`curl`、`jq`
 - gen video-translate 的 `--mode fast` / `--dynamic-duration` flag 在 latest 版本已存在;若 CLI 报 unknown flag → `npm i -g @optima-chat/optima-gen@latest` 升级
 
 ## 输入
@@ -33,13 +33,33 @@ owner_repo: Optima-Chat/optima-gen
 | `TAG` | ✅ | 对应的两字母 tag(`en` / `th` / `ms` / `vi`) |
 | `BGM` | ⬜ | 自定义 BGM 文件路径(覆盖默认)。不传则用 npm 包内置 `bgm/default.mp3`(22s clean instrumental,自动 loop)|
 | `NO_BGM` | ⬜ | 设非空值则跳过 BGM(出片只有人声 + 原视频 BGM 残留)|
+| `VOICE` | ⬜ | HeyGen stock voice_id(从下面 ## Voice Catalog 选)。**不传 = 克隆源说话人音色**(legacy 默认行为)|
 | `NAME` | ⬜ | 工作区名,默认从 URL 末段推 |
 
 ## 3 步主流程(+ Step 0 预检 + Step 4 可选清理)
 
-### Step 0:声明 + 工作区 + 源视频音量预检
+### Step 0:声明 + 工作区 + URL 预处理 + 源视频音量预检
 
 ```bash
+## ⚠ URL 必须是公网 https URL,不能是本地路径 /home/aiuser/...
+## gen video-translate 只接受 https URL(HeyGen 那边要拉的)
+## 如果是本地路径,先用 chat 系统的 file API 签 URL
+if [[ ! "$URL" =~ ^https?:// ]]; then
+  echo "INFO: 本地路径 '$URL',需要上传拿 https URL"
+  TOKEN=$(jq -r '.access_token' ~/.optima/token.json)
+  ## shell.optima.onl 的 file signing endpoint(具体路径以系统实际为准,
+  ## 这里给出常见模式;如果不行,根据 stderr 报错调整)
+  SIGNED=$(curl -sS -X POST "https://shell.optima.onl/api/files/sign" \
+    -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
+    -d "{\"path\":\"$URL\"}" 2>&1 | jq -r '.data.url // .url // empty' 2>/dev/null)
+  if [ -z "$SIGNED" ]; then
+    echo "ERR: 拿不到 signed URL,把 '$URL' 上传到 chat 系统拿 https URL 再来"
+    exit 1
+  fi
+  URL="$SIGNED"
+  echo "URL → $URL"
+fi
+
 ## URL 末段可能含 query string(HeyGen / S3 预签名 url 含 token)— 先去掉再 basename
 NAME="${NAME:-$(echo "$URL" | cut -d'?' -f1 | xargs basename | sed 's/\.[^.]*$//' | sed 's/[^A-Za-z0-9_-]/_/g')}"
 WORK="./videos/${NAME}.work"
@@ -52,6 +72,42 @@ ffmpeg -i "$URL" -af volumedetect -f null - 2>&1 | grep mean_volume
 
 如果 `mean_volume < -25dB`,提示用户:"源视频音量太低(< −25dB),翻译服务大概率会报无人声。建议先用 `ffmpeg -i in.mp4 -af 'volume=20dB,acompressor=threshold=-20dB:ratio=4' -c:v copy out.mp4` 放大后再翻译。"
 
+### Step 0.5:让用户挑音色 — 纯文本对话(不要用 AskUserQuestion)
+
+**重要:不要用 AskUserQuestion 工具**(只支持 4 选项 + label-based 反查不可靠,试过失败)。**用纯文本输出 5 个选项,等用户文字回复**:
+
+agent 输出(逐字照搬,把 $LANG 换成实际目标语):
+
+```
+翻译到 $LANG,4 个语种共用一个音色。请回复编号(1-5)或名字:
+
+  1. Connie - 沉稳专业旁白(F) — preview: https://resource.heygen.ai/text_to_speech/locale=en-USmodel=eleven_multilingual_v2id=9FnNGNtwCeU9fyf6mFfDp8.mp3
+  2. Sophie - 温柔友好(F)     — preview: https://resource.heygen.ai/text_to_speech/locale=model=eleven_multilingual_v2id=kte4EzDuRTnsnHkATe6tDK.mp3
+  3. Bruce - 中年浑厚(M)      — preview: https://resource.heygen.ai/text_to_speech/locale=model=eleven_multilingual_v2id=2SdnapPUN7wvtCbkPSgdHV.mp3
+  4. Luca - 年轻活力(M)       — preview: https://resource.heygen.ai/text_to_speech/locale=model=eleven_multilingual_v2id=FVKYscu8J8EVReBuZdPXnJ.mp3
+  5. 保留原声(克隆源说话人音色)
+
+回复方式:数字 1-5,或者 "Connie"/"Sophie"/"Bruce"/"Luca"/"原声",或者 "随便"(我帮你随机挑)。
+```
+
+#### 用户回复 → VOICE 变量(严格按下表)
+
+| 用户回复 | VOICE 变量值 |
+|---|---|
+| `1` / `Connie` / `用 Connie` / 任何含 "Connie" | **`VOICE=d774d69075f24d1fb52a0dad145ba809`** |
+| `2` / `Sophie` / `用 Sophie` | **`VOICE=vakjM0uzzAxU4UiT0433`** |
+| `3` / `Bruce` / `用 Bruce` | **`VOICE=1LtsDD7yfTuX92TzjmJk`** |
+| `4` / `Luca` / `用 Luca` | **`VOICE=6HiVdeiuBdZbtcnukrQn`** |
+| `5` / `原声` / `克隆` / `用我自己的` / `keep original` | **`VOICE=`**(留空,不传 `--voice`) |
+| `随便` / `random` | 从 1-4 voice_id 里**随机挑一个**设 VOICE,**不要默认 5** |
+
+#### 严禁(踩过两次了)
+
+- ❌ **用 AskUserQuestion 工具**(4 选项限制 + label 反查不可靠,会让用户选了 voice 你跑 clone)
+- ❌ **用户选了 1-4,你设 VOICE=空走 clone** — 跟选择不一致就是 bug
+- ❌ **不列全 5 个选项**(比如只列"用 voice / 原声"二选一,等同不让选)
+- ❌ **不告诉用户怎么回复**(必须明确说"回复数字或名字")
+
 ### Step 1:HeyGen 翻译(用现成 CLI)
 
 ```bash
@@ -62,6 +118,7 @@ gen video-translate \
   --lang "$LANG" \
   --mode fast \
   --dynamic-duration \
+  ${VOICE:+--voice "$VOICE"} \
   -o "$RAW_DIR" \
   > "$WORK/gen.json"
 ```
@@ -70,14 +127,14 @@ gen video-translate \
 
 幂等:`$WORK/gen.json` 存在则跳。
 
-提取 v3 输出字段(jq null check —— gen 后端契约改名时早 fail):
+**⚠ 提取字段必须用 `.data.` 前缀**:gen-cli 的 `outputSuccess` 把所有字段包装在 `{success: true, data: {...}}` 结构里。**不带 `.data.` 永远读不到字段,SKILL 会卡死**:
 
 ```bash
-## v3 API 返回 audio_url + caption_url + video_url 分开;我们只要 audio + caption
-AUDIO_URL=$(jq -r '.audio_url // empty' "$WORK/gen.json")
-CAP_URL=$(jq -r '.caption_url // empty' "$WORK/gen.json")
+## gen-cli 输出格式: {"success": true, "data": {"task_id": "...", "audio_url": "...", "caption_url": "..."}}
+AUDIO_URL=$(jq -r '.data.audio_url // empty' "$WORK/gen.json")
+CAP_URL=$(jq -r '.data.caption_url // empty' "$WORK/gen.json")
 [ -n "$AUDIO_URL" ] && [ -n "$CAP_URL" ] || {
-  echo "ERR: gen.json 缺 .audio_url 或 .caption_url 字段(需 gen v3 adapter)。看原始 response:"
+  echo "ERR: gen.json 缺 .data.audio_url 或 .data.caption_url 字段。原始 response:"
   cat "$WORK/gen.json"
   exit 1
 }
@@ -132,6 +189,14 @@ video-translate mux \
 - `--raw` = HeyGen v3 译音(audio_url 下载的 wav)
 - 字幕烧 + BGM ducking 走 mux 内置
 
+**BGM + 花体字幕样式 = 默认产出的一部分,不是可选项。** 不要问用户"要不要加",不要在结尾说"如需 BGM/字幕样式可补充"。`video-translate mux` 默认就用 `bgm/default.mp3` + Path-B 描边样式;`render-ass --lang $TAG` 默认按语言选字体(Bangers / Sarabun / Noto Sans)。不要绕过 `mux` 自己手写 ffmpeg(会丢 BGM + 字幕样式 + 音轨规范化)。
+
+如果 `mux` 真的失败,先把完整 stderr 给用户看(不要默默用 `ffmpeg -i ... -c copy` 兜底出"裸版"),让用户决定下一步。
+
+## 出片汇报口径
+
+只描述事实("xxx_th.mp4 翻译完成,泰语花体字幕 + BGM ducking 已烧录")。**禁止**任何形式的"如需 X 可以告诉我"尾巴 — BGM 和字幕样式不是可选 add-on,这种话术暗示没做。
+
 ### Step 4(可选):清理
 
 ```bash
@@ -139,6 +204,170 @@ video-translate mux \
 rm -rf "$WORK"
 ```
 
+---
+
+## 批量模式(多语种,一段视频翻多语)
+
+**触发条件**:用户一次请求 ≥2 种目标语言("翻译成英/泰/越/马 4 国语")。
+
+**不要按单语流程循环跑 N 次**——会有两个致命问题:
+1. wall time = N × 单次 (~12min/lang × 4 = 48min)
+2. chat bash 队列被 N 条阻塞命令塞满,后续命令(mux/SFX)全卡"准备中"
+
+改用 **单条 bash 内 N 路 subshell 并发**:chat 队列只占 1 slot,HeyGen 服务端并行处理,wall time ≈ 单次最慢 (~12min)。
+
+### Step B0:URL 预处理 + workspace + 音量预检 + 源视频下载(只跑一次)
+
+```bash
+## ⚠ URL 预处理:同单语 Step 0,本地路径必须先上传拿 https URL
+if [[ ! "$URL" =~ ^https?:// ]]; then
+  TOKEN=$(jq -r '.access_token' ~/.optima/token.json)
+  SIGNED=$(curl -sS -X POST "https://shell.optima.onl/api/files/sign" \
+    -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
+    -d "{\"path\":\"$URL\"}" 2>&1 | jq -r '.data.url // .url // empty' 2>/dev/null)
+  if [ -z "$SIGNED" ]; then
+    echo "ERR: 拿不到 signed URL for '$URL'"; exit 1
+  fi
+  URL="$SIGNED"
+fi
+
+NAME="${NAME:-$(echo "$URL" | cut -d'?' -f1 | xargs basename | sed 's/\.[^.]*$//' | sed 's/[^A-Za-z0-9_-]/_/g')}"
+mkdir -p "./videos/${NAME}.batch"
+
+## 音量预检(同单语 Step 0)
+ffmpeg -i "$URL" -af volumedetect -f null - 2>&1 | grep mean_volume
+
+## 源视频下载一次,所有 mux 共用(避免 N 次重复下载)
+ORIG_VIDEO="./videos/${NAME}.batch/orig.mp4"
+[ -f "$ORIG_VIDEO" ] || curl -sSL "$URL" -o "$ORIG_VIDEO"
+```
+
+### Step B0.5:voice 选一次,所有语种共用
+
+同单语 Step 0.5。`VOICE` 变量设一次后下方循环里所有 subshell 都继承,**所有语种用同一个 voice 出片**(用户只需挑一次)。
+
+### Step B1:并发派出所有 HeyGen 翻译(后台跑,~5 秒返回)
+
+```bash
+## 用户实际要的语种,从下面 4 个里选(不要的注释掉)
+LANG_LIST=(
+  "English:en"
+  "Thai (Thailand):th"
+  "Malay (Malaysia):ms"
+  "Vietnamese (Vietnam):vi"
+)
+
+for entry in "${LANG_LIST[@]}"; do
+  LANG="${entry%:*}"
+  TAG="${entry##*:}"
+  WORK="./videos/${NAME}_${TAG}.work"
+  mkdir -p "$WORK/raw"
+
+  ## 后台启动 gen video-translate,各自写 gen.json,bash 立即继续
+  nohup gen video-translate \
+    --video-url "$URL" --lang "$LANG" \
+    --mode fast --dynamic-duration \
+    ${VOICE:+--voice "$VOICE"} \
+    -o "$WORK/raw" > "$WORK/gen.json" 2>&1 &
+
+  echo "$TAG: launched (PID $!) -> $WORK/gen.json"
+done
+echo "=== all submitted, returning immediately ==="
+```
+
+这一步 5 秒返回。**关键**:用 `nohup ... &` 后台启动,bash exit 后进程继续(尽量 survive 短暂 idle / 容器升级)。每个进程会在 HeyGen 翻译完成后把 audio_url/caption_url 写入对应的 gen.json。
+
+### Step B2-B5:逐语种等结果 → 出片(每个一条独立 bash)
+
+**重点:每个语种用单独的 bash 命令处理,不要再用 `&` 并发**。这样:
+- chat 看到每个语种独立完成、独立报告
+- 第 1 个 bash 等 HeyGen(~12 min),后续每个 bash 几乎瞬间完成(因为 4 个翻译是并行跑的,后续几个早已 done)
+- 失败隔离:1 个失败不影响其他
+
+通用 per-lang 模板(把 `$TAG` 换成 en / th / ms / vi 各跑一遍):
+
+```bash
+TAG=en                                   ## ← 换语种就改这个
+WORK="./videos/${NAME}_${TAG}.work"
+FINAL="./videos/${NAME}_${TAG}.mp4"
+
+## 等 gen.json 写完(或失败)
+## ⚠ gen-cli 用 outputSuccess 包装在 {success, data: {...}} 里,字段在 .data.* 下
+DEADLINE=$(( $(date +%s) + 1800 ))     ## 30min 上限,跟 HeyGen poll timeout 对齐
+while true; do
+  ## Case 1: 成功 → .data.audio_url 非 null
+  if jq -e '.data.audio_url' "$WORK/gen.json" >/dev/null 2>&1; then
+    break
+  fi
+  ## Case 2: 业务失败 → .data.error_message(outputSuccess with status=failed)
+  if jq -e '.data.error_message' "$WORK/gen.json" >/dev/null 2>&1; then
+    echo "[$TAG] FAIL: $(jq -r '.data.error_message' "$WORK/gen.json")"
+    exit 1
+  fi
+  ## Case 3: CLI 异常 → .error.code/.error.message(outputError 抛出)
+  if jq -e '.error' "$WORK/gen.json" >/dev/null 2>&1; then
+    echo "[$TAG] FAIL: $(jq -r '.error.code + \": \" + .error.message' "$WORK/gen.json")"
+    exit 1
+  fi
+  ## Case 4: 30min 超时(HeyGen 一般 5-15min,30min 还没就是真挂了)
+  if [ "$(date +%s)" -gt "$DEADLINE" ]; then
+    echo "[$TAG] TIMEOUT 30min,gen.json 内容:"; cat "$WORK/gen.json"; exit 1
+  fi
+  sleep 15
+done
+
+## 拿到 audio_url + caption_url(必须带 .data. 前缀)
+AUDIO_URL=$(jq -r '.data.audio_url' "$WORK/gen.json")
+CAP_URL=$(jq -r '.data.caption_url' "$WORK/gen.json")
+
+## 下载 + render-ass
+curl -sSL --retry 1 "$AUDIO_URL" -o "$WORK/translated_audio.wav"
+curl -sSL --retry 1 "$CAP_URL"   -o "$WORK/caption.srt"
+video-translate render-ass \
+  --srt "$WORK/caption.srt" --lang "$TAG" \
+  --translations "$WORK/translations.json" \
+  --out "$WORK/subs.ass"
+
+## mux 出片
+video-translate mux \
+  --raw "$WORK/translated_audio.wav" \
+  --orig-video "$ORIG_VIDEO" \
+  --ass "$WORK/subs.ass" \
+  ${BGM:+--bgm "$BGM"} ${NO_BGM:+--no-bgm} \
+  --work "$WORK" \
+  --out "$FINAL"
+
+echo "[$TAG] DONE -> $FINAL"
+```
+
+**Agent 执行节奏**:
+1. 跑 Step B1(1 条 bash,5 秒返回,**立刻告知用户"4 个翻译派出去了"**)
+2. 跑 per-lang 模板 `TAG=en`(1 条 bash,~12 min,出片后**立刻告知用户"English 出片 ✓"**)
+3. 跑 per-lang 模板 `TAG=th`(1 条 bash,~30 秒,出片后**立刻告知用户"Thai 出片 ✓"**)
+4. 跑 per-lang 模板 `TAG=ms`(~30 秒)
+5. 跑 per-lang 模板 `TAG=vi`(~30 秒)
+
+**总 wall time 不变(~13 min)**,但用户每 30 秒看到一个出片,不是 12 min 黑盒后突然 4 个一起出。
+
+输出:`./videos/${NAME}_en.mp4` / `_th.mp4` / `_ms.mp4` / `_vi.mp4`
+
+### 单语 vs 渐进批量对比
+
+| | 单语循环(❌ 不要) | 渐进批量(✓) |
+|---|---|---|
+| 源视频下载 | N 次重下 | 1 次共用 |
+| HeyGen 调用 | 串行 N × 12min | 并发 max(12min) |
+| chat 队列占 | N 条阻塞 bash | 1 条 submit + N 条快速 poll |
+| 失败隔离 | 一个挂全停 | per-lang subshell + bash 独立 |
+| 用户感知 | 黑盒 48 min | 第 1 个 ~12 min 出,后续每 ~30 秒 1 个 |
+| **wall time(N=4)** | **~48 min** | **~13 min(73%↓)** |
+
+### 失败处理
+
+- 单 lang 失败:per-lang bash `exit 1`,agent 报告该语种失败但**继续跑下一个语种的 bash**
+- 用户对失败的单 lang re-run → 删 `$WORK/gen.json` 重跑 Step B1 单语 + per-lang 模板即可
+- HeyGen credit 不足报错 → 当 lang 个失败处理,不阻塞其他 lang
+
 ## 错误处理
 
 | 失败 | 处理 |
@@ -148,15 +377,14 @@ rm -rf "$WORK"
 | HeyGen `status: failed` "No speaker is detected" | 同源视频音量过低处理 |
 | HeyGen 其他失败 | 透出 task_id,提示用 `gen task get <id>` 查最新;干净退出 |
 | HeyGen >30min 超时 | 同上,可能任务还在 running |
-| `gen.json` 缺 `.output` / `.caption_url` | gen 后端契约可能改字段名。打 `cat $WORK/gen.json` 看实际字段 |
+| `gen.json` 缺 `.audio_url` / `.caption_url` | gen 后端契约可能改字段名。打 `cat $WORK/gen.json` 看实际字段 |
 | `curl <caption_url>` 失败 | URL 7 天 expire。retry 1 次后仍失败 → 重跑 step 1 |
 | `video-translate render-ass` SRT 解析失败 | 显示 SRT 头 20 行,不重试 |
 | `video-translate mux` 字体 ☐ | 检查 `fc-match Bangers / Sarabun / "Noto Sans"` 是否精确返回 |
 
 ## 不做
 
-- ❌ 音色覆盖(voice override)— v1 默认 HeyGen 自动克隆;v2 再考虑"用户问起时 LLM 给候选 + preview URL"流程
-- ❌ 性别自动检测 — 同上 defer v2
+- ❌ 性别自动检测(让用户自己选,见 Step 0.5)
 - ❌ 硬字幕(burnt-in)抹除 — 源视频有的话出片会双语
 - ❌ 自动加粗关键词 — SRT 直入无粉色,用户手编 translations.json
 - ❌ 双说话人差异化音色 — HeyGen 自动 diarize 但用同一克隆音色
@@ -166,3 +394,18 @@ rm -rf "$WORK"
 
 - 设计 SPEC:https://github.com/Optima-Chat/video-translate/blob/main/SPEC.md (v3.1)
 - 实测踩坑(gotchas):同上 §Gotchas
+
+---
+
+## Voice Catalog
+
+下面 4 个 voice 全部是 HeyGen catalog 里走 **ElevenLabs `eleven_multilingual_v2`** 模型的多语 voice,**任选一个,所有支持语言(en/th/ms/vi)都能说**。实测 Connie 跨 4 语全部 Whisper 95%+ 语种识别置信度,音色保留 + 自动适配目标语言性别敬语(如泰语 ค่ะ/ครับ)。
+
+| # | voice_id | 名字 | 性别 | 风格定位 | preview(英文样本) |
+|---|---|---|---|---|---|
+| 1 | `d774d69075f24d1fb52a0dad145ba809` | Connie - Professional | F | 沉稳专业旁白 | https://resource.heygen.ai/text_to_speech/locale=en-USmodel=eleven_multilingual_v2id=9FnNGNtwCeU9fyf6mFfDp8.mp3 |
+| 2 | `vakjM0uzzAxU4UiT0433`             | Sophie                | F | 温柔友好     | https://resource.heygen.ai/text_to_speech/locale=model=eleven_multilingual_v2id=kte4EzDuRTnsnHkATe6tDK.mp3 |
+| 3 | `1LtsDD7yfTuX92TzjmJk`             | Bruce                 | M | 中年浑厚     | https://resource.heygen.ai/text_to_speech/locale=model=eleven_multilingual_v2id=2SdnapPUN7wvtCbkPSgdHV.mp3 |
+| 4 | `6HiVdeiuBdZbtcnukrQn`             | Luca                  | M | 年轻活力     | https://resource.heygen.ai/text_to_speech/locale=model=eleven_multilingual_v2id=FVKYscu8J8EVReBuZdPXnJ.mp3 |
+
+> 维护说明:换 voice 时,从 `GET /v2/voices` 里筛 `preview_audio` 含 `multilingual` 的 EL 系列。其它非 EL 系列的"English"标签 voice **大概率**不能跨语言,要实测验证。

package/dist/commands/asr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asr.d.ts","sourceRoot":"","sources":["../../src/commands/asr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,QAiIlD"}
+{"version":3,"file":"asr.d.ts","sourceRoot":"","sources":["../../src/commands/asr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,QAoIlD"}

package/dist/commands/asr.js

@@ -79,12 +79,15 @@ export function registerAsrCommand(program) {
                     });
                 }
                 else {
-                    outputSuccess({
+                    // task status != completed → 失败。outputError 让顶层 success:false 并 exit 1，
+                    // 否则 Agent 把 failure 当 success（参见 image.ts 同样修复）。
+                    const errCode = result.error_code ?? 'GENERATION_FAILED';
+                    const errMsg = result.error_message ?? `任务状态: ${result.status}`;
+                    outputError(errCode, errMsg, options, {
                         task_id: result.task_id,
                         status: result.status,
-                        error_code: result.error_code ?? null,
                         retryable: result.retryable ?? false,
-                        error_message: result.error_message,
+                        error_class: result.error_class ?? null,
                     });
                 }
             }

package/dist/commands/asr.js.map

@@ -1 +1 @@
-{"version":3,"file":"asr.js","sourceRoot":"","sources":["../../src/commands/asr.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"asr.js","sourceRoot":"","sources":["../../src/commands/asr.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAElB,iBAAiB,EACjB,YAAY,GACb,MAAM,+BAA+B,CAAC;AAEvC,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,MAAM,GAAG,GAAG,OAAO;SAChB,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,yCAAyC,CAAC;SACtD,QAAQ,CAAC,QAAQ,EAAE,sCAAsC,CAAC;SAC1D,MAAM,CAAC,mBAAmB,EAAE,2BAA2B,CAAC;SACxD,MAAM,CAAC,gBAAgB,EAAE,YAAY,EAAE,wBAAwB,CAAC;SAChE,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,OAAO,EAAE,EAAE;QACtC,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QAErC,IAAI,CAAC;YACH,WAAW;YACX,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7B,WAAW,CAAC,gBAAgB,EAAE,YAAY,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;gBAC/D,OAAO;YACT,CAAC;YAED,YAAY;YACZ,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACnC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAE3C,eAAe;YACf,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;YAEhD,MAAM,MAAM,GAAiB;gBAC3B,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBACjC,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;aACrB,CAAC;YAEF,MAAM,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAE7B,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,CAAC;gBAEzC,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE;wBACvD,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE;4BACrB,OAAO,CAAC,IAAI,GAAG,UAAU,MAAM,MAAM,CAAC;wBACxC,CAAC;qBACF,CAAC,CAAC;oBAEH,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;oBAE1C,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;wBAClC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;wBAC3B,IAAI,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;4BAC7B,OAAO,CAAC,SAAS,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;wBAC9C,CAAC;6BAAM,CAAC;4BACN,IAAI,CAAC,+BAA+B,MAAM,CAAC,OAAO,QAAQ,CAAC,CAAC;wBAC9D,CAAC;wBACD,IAAI,CAAC,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;oBACjD,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;wBACvC,IAAI,MAAM,CAAC,aAAa;4BAAE,IAAI,CAAC,OAAO,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;wBAC9D,IAAI,CAAC,oBAAoB,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;oBACrD,CAAC;gBACH,CAAC;gBAAC,OAAO,GAAQ,EAAE,CAAC;oBAClB,OAAO,CAAC,IAAI,CAAC,SAAS,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC;oBAC7C,MAAM,GAAG,CAAC;gBACZ,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBACzD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;gBAE1C,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;oBAClC,aAAa,CAAC;wBACZ,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,IAAI,EAAE,MAAM,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE;wBACpC,IAAI,EAAE,QAAQ;wBACd,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,MAAM;wBACpC,KAAK,EAAE,OAAO,CAAC,KAAK;wBACpB,UAAU;qBACX,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,wEAAwE;oBACxE,kDAAkD;oBAClD,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,IAAI,mBAAmB,CAAC;oBACzD,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC;oBAChE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;wBACpC,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,KAAK;wBACpC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,IAAI;qBACxC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,kBAAkB,EAAE,CAAC;gBACtC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACN,WAAW,CAAC,YAAY,EAAE,WAAW,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,eAAe,CAAC,GAAG,EAAE;QACnB,QAAQ,EAAE;YACR,iBAAiB;YACjB,yBAAyB;YACzB,EAAE;YACF,iBAAiB;YACjB,uCAAuC;YACvC,EAAE;YACF,UAAU;YACV,oCAAoC;SACrC;QACD,UAAU,EAAE;;;;;;;;;;EAUd;QACE,eAAe,EAAE;YACf,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE;YAC/C,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,QAAQ,EAAE;SACpD;QACD,KAAK,EAAE;YACL,yCAAyC;YACzC,mDAAmD;YACnD,qCAAqC;YACrC,aAAa;SACd;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/avatar.d.ts

@@ -1,7 +1,17 @@
 import { Command } from 'commander';
 /**
- * `gen avatar train <video-file> --external-id <id>` — train a HeyGen digital_twin avatar
- * from a local video file. CLI handles asset upload + submit + poll, then prints look_id.
+ * `gen avatar` — 数字人分身完整 namespace.
+ *
+ * 低层 (本文件):
+ *   gen avatar train <video-file> --external-id <id>   训练 avatar look
+ *
+ * 高层 (来自 doctor.ts,作为 alias 也注册在 gen doctor 下):
+ *   gen avatar onboard <audio> <video>                 一次性训 voice + avatar
+ *   gen avatar video --avatar <id> --voice <id>        用 trained avatar 合成视频
+ *   gen avatar profile <external-id>                   查 profile (voice_id / look_id / 状态)
+ *
+ * gen doctor * 是历史命名 (Phase 2 POC 起源于医生场景),保留作为兼容性别名,
+ * 行为完全一致。新用户 / 文档推荐用 gen avatar *。
  *
  * Phase 2 doctor-avatar feature. See spec §13 + §13.4 (clean-bg requirement).
  */

package/dist/commands/avatar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"avatar.d.ts","sourceRoot":"","sources":["../../src/commands/avatar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,QA6JrD"}
+{"version":3,"file":"avatar.d.ts","sourceRoot":"","sources":["../../src/commands/avatar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,QAqKrD"}

package/dist/commands/avatar.js

@@ -5,14 +5,28 @@ import { success, info, warning } from '../utils/logger.js';
 import { outputSuccess, outputError, isPrettyMode } from '../utils/output.js';
 import { addEnhancedHelp } from '../utils/helpText.js';
 import { GenerationApiClient, GenerationApiError } from '../services/generation-api.js';
+import { registerDoctorSubcommands } from './doctor.js';
 /**
- * `gen avatar train <video-file> --external-id <id>` — train a HeyGen digital_twin avatar
- * from a local video file. CLI handles asset upload + submit + poll, then prints look_id.
+ * `gen avatar` — 数字人分身完整 namespace.
+ *
+ * 低层 (本文件):
+ *   gen avatar train <video-file> --external-id <id>   训练 avatar look
+ *
+ * 高层 (来自 doctor.ts,作为 alias 也注册在 gen doctor 下):
+ *   gen avatar onboard <audio> <video>                 一次性训 voice + avatar
+ *   gen avatar video --avatar <id> --voice <id>        用 trained avatar 合成视频
+ *   gen avatar profile <external-id>                   查 profile (voice_id / look_id / 状态)
+ *
+ * gen doctor * 是历史命名 (Phase 2 POC 起源于医生场景),保留作为兼容性别名,
+ * 行为完全一致。新用户 / 文档推荐用 gen avatar *。
  *
  * Phase 2 doctor-avatar feature. See spec §13 + §13.4 (clean-bg requirement).
  */
 export function registerAvatarCommand(program) {
-    const avatar = program.command('avatar').description('医生 avatar(数字人)训练相关命令(Phase 2)');
+    const avatar = program.command('avatar').description('数字人分身相关命令 (train / onboard / video / profile)');
+    // 高层 facade (与 gen doctor * 等价)
+    registerDoctorSubcommands(avatar);
+    // 低层 train (仅在 gen avatar 下注册,不在 gen doctor 下出现)
     const trainCmd = avatar
         .command('train')
         .description('用本地视频训练 HeyGen digital_twin avatar,产出 avatar look_id')
@@ -93,19 +107,23 @@ export function registerAvatarCommand(program) {
                 }
             }
             else {
+                // task status != completed → 失败。让顶层 success:false 并 exit 1，否则
+                // Agent 会把 failure 当 success（参见 image.ts 同样修复）。
+                const errCode = result.error_code ?? 'GENERATION_FAILED';
+                const errMsg = result.error_message ?? `任务状态: ${result.status}`;
                 if (pretty) {
-                    trainSpinner.info(`任务状态: ${result.status}`);
-                    if (result.error_message)
-                        info(`错误: ${result.error_message}`);
+                    trainSpinner.fail(errMsg);
+                    if (result.error_code)
+                        info(`错误码: ${result.error_code}${result.retryable ? '（可重试）' : ''}`);
                     info(`使用 'gen task get ${result.task_id}' 查看最新状态`);
+                    process.exit(1);
                 }
                 else {
-                    outputSuccess({
+                    outputError(errCode, errMsg, options, {
                         task_id: result.task_id,
                         status: result.status,
-                        error_code: result.error_code ?? null,
                         retryable: result.retryable ?? false,
-                        error_message: result.error_message,
+                        error_class: result.error_class ?? null,
                     });
                 }
             }

package/dist/commands/avatar.js.map

@@ -1 +1 @@
-{"version":3,"file":"avatar.js","sourceRoot":"","sources":["../../src/commands/avatar.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"avatar.js","sourceRoot":"","sources":["../../src/commands/avatar.ts"],"names":[],"mappings":"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"}

package/dist/commands/doctor.d.ts

@@ -1,9 +1,19 @@
 import { Command } from 'commander';
 /**
- * `gen doctor` namespace — Phase 2 doctor-avatar high-level commands:
- *   gen doctor onboard <audio> <video> --external-id <id>
- *   gen doctor video --avatar <id> --voice <id> --text <...>
- *   gen doctor profile <external-id>
+ * `gen doctor` namespace — historical naming (Phase 2 POC originated for medical
+ * scenarios). Functionally identical to `gen avatar *` and kept as a
+ * backward-compatible alias.
+ *
+ * Subcommands (registered via registerDoctorSubcommands, also reused under
+ * `gen avatar` in avatar.ts):
+ *   onboard <audio> <video> --external-id <id>
+ *   video --avatar <id> --voice <id> --text <...>
+ *   profile <external-id>
+ *
+ * All user-facing help text refers to `gen avatar *` (recommended name),
+ * not `gen doctor *`. `--help` under either namespace guides users toward
+ * the unified command set.
  */
 export declare function registerDoctorCommand(program: Command): void;
+export declare function registerDoctorSubcommands(parent: Command): void;
 //# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,QAMrD"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,QAMrD;AAKD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,QAIxD"}