video-pipeline 1.2.7 → 1.2.9

package/.env.example

@@ -54,12 +54,13 @@ WHISPER_SERVICE=http://localhost:9588   # 【自由】服务地址
 WHISPER_TEMPERATURE=0.0           # 【自由】whisper 推理温度 (0.0~1.0, 越低越确定)
 WHISPER_TEMPERATURE_INC=0.2       # 【自由】whisper 温度增量 (fallback 时升温步长)
 WHISPER_RESPONSE_FORMAT=json      # 【自由】whisper 返回格式 (json/text/srt/vtt)
+WHISPER_SERVICE_MODEL=models/ggml-base.bin   # 【自由】服务端模型文件路径（留空则使用服务器当前模型）
 
 # 本地模式 - openai-whisper CLI (取消下方注释并注释上方即可切换)
 # WHISPER_BACKEND=local
 # WHISPER_MODEL=base
 # WHISPER_DEVICE=cpu
-# WHISPER_LANGUAGE=zh
+# WHISPER_LANGUAGE=
 
 # ── 转码参数 ────────────────────────────────────────────────────────────────
 # 【自由】wav 格式参数通常不变；如需其他格式（mp3/flac）可一起修改
@@ -88,27 +89,27 @@ VIDEO_SHEETS=YouTube视频,普诺赛中文站
 
 # ── 平台优先级 ──────────────────────────────────────────────────────────────
 # 【调序】可选值来自以下固定集合（与上方平台列名后缀对应）:
-#   bilibiliBvid  = B 站 BV 号
-#   youtubeId     = YouTube 视频 ID
-#   tencentVid    = 腾讯视频 VID
-#   youkuId       = 优酷视频 ID
+#   bilibili  = B 站 BV 号
+#   youtube     = YouTube 视频 ID
+#   tencent    = 腾讯视频 VID
+#   youku       = 优酷视频 ID
 #
 # 你可以：
 #   1. 调整顺序 → 排前面的平台优先下载
 #   2. 增减条目 → 只保留你需要的平台
 #   ✗ 不能使用集合之外的值（如 "tiktokId"、"douyinId" 等未定义的 key）
-PLATFORM_PRIORITY=bilibiliBvid,youtubeId,tencentVid,youkuId
+PLATFORM_PRIORITY=bilibili,youtube,tencent,youku
 
 # ── 平台 URL 模板 ───────────────────────────────────────────────────────────
 # 【关联】模板中的 {占位符} 必须与 PLATFORM_PRIORITY 中的 key 名一致
-#         如 {youtubeId} 会被 COL_YOUTUBEID 列的值替换
+#         如 {youtube} 会被 COL_YOUTUBEID 列的值替换
 # 【自由】URL 本身可随意修改（例如从 youtu.be 改为 www.youtube.com/watch?v=）
 #
 # 前缀规则: TENCENT=腾讯视频 BILIBILI=B站 YOUTUBE=YouTube YOUKU=优酷
-TENCENT_URL_TPL=https://v.qq.com/x/page/{tencentVid}.html
-BILIBILI_URL_TPL=https://www.bilibili.com/video/{bilibiliBvid}/
-YOUTUBE_URL_TPL=https://youtu.be/{youtubeId}
-YOUKU_URL_TPL=https://v.youku.com/v_show/id_{youkuId}.html
+TENCENT_URL_TPL=https://v.qq.com/x/page/{tencent}.html
+BILIBILI_URL_TPL=https://www.bilibili.com/video/{bilibili}/
+YOUTUBE_URL_TPL=https://youtu.be/{youtube}
+YOUKU_URL_TPL=https://v.youku.com/v_show/id_{youku}.html
 
 # ── 平台通用配置 ────────────────────────────────────────────────────────────
 # 以下变量对每个平台分别配置，前缀 = 平台前缀（BILIBILI / YOUTUBE / TENCENT / YOUKU）
@@ -131,7 +132,8 @@ YOUKU_URL_TPL=https://v.youku.com/v_show/id_{youkuId}.html
 BILIBILI_COOKIES_FROM_BROWSER=firefox    # 【自由】firefox / chrome / edge
 # 方案 B（备用）: 从文件读取 cookie
 # BILIBILI_COOKIE_FILE=cookies/bilibili.txt   # 【自由】cookie 文件路径（方案 A 启用时此行无效）
-BILIBILI_USER_AGENT=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/149.0.0.0 Safari/537.36  # 【自由】
+# 【自由】自定义 User-Agent (含特殊字符需用双引号包裹)
+BILIBILI_USER_AGENT="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/149.0.0.0 Safari/537.36"
 BILIBILI_REFERER=https://www.bilibili.com/     # 【自由】
 BILIBILI_CONCURRENT_FRAGMENTS=4               # 【自由】并发分片数
 BILIBILI_FORMAT=bestvideo[height<=720]+bestaudio/bestvideo+bestaudio/best  # 【自由】
@@ -145,7 +147,8 @@ YOUTUBE_COOKIES_FROM_BROWSER=firefox           # 【自由】firefox / chrome /
 #   ⚠️ Windows Chromium 系浏览器 DPAPI 解密已知失败，不建议用 --cookies-from-browser chrome
 YOUTUBE_PROXY=http://127.0.0.1:7897           # 【自由】代理地址 (Clash Verge 默认 7897, v2rayN 默认 10809)
 #   ⚠️ 脚本会自动给 yt-dlp 及其 node/ejs 子进程注入 HTTPS_PROXY 环境变量
-YOUTUBE_USER_AGENT=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/149.0.0.0 Safari/537.36  # 【自由】
+# 【自由】自定义 User-Agent (含特殊字符需用双引号包裹)
+YOUTUBE_USER_AGENT="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/149.0.0.0 Safari/537.36"
 YOUTUBE_JS_RUNTIMES=node                      # 【自由】解 n-sig 的 JS 运行时
 YOUTUBE_REMOTE_COMPONENTS=ejs:github          # 【自由】YouTube n-sig 需要的远程组件
 YOUTUBE_FORMAT=bestvideo[height<=720]+bestaudio/bestvideo+bestaudio/best  # 【自由】
@@ -159,7 +162,6 @@ TENCENT_USER_AGENT=                            # 【自由】
 YOUKU_COOKIE_FILE=                             # 【自由】
 YOUKU_USER_AGENT=                              # 【自由】
 
-
 # ── AI 分析/关键词归纳 ─────────────────────────────────────────────────────
 # 【自由】是否启用 AI 分析环节（true/false），在 transcribe 之后执行
 AI_ENABLED=true
@@ -167,8 +169,6 @@ AI_ENABLED=true
 AI_API_KEY=your-api-key-here
 AI_BASE_URL=https://your-api-host/v1
 AI_MODEL=your-model-name
-# 【自由】请求超时（秒），默认 300
-AI_TIMEOUT=300
 # 【自由】AI 推理温度 (0.0~2.0, 越低越确定/保守, 越高越随机/创意)
 AI_TEMPERATURE=0.3
 # 【关联】提示词模板，{content} 占位符会被识别文本替换

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## [1.2.9] - 2026-06-11
+
+### Bug Fixes
+
+- yt-dlp download progress parsing and encoding (`e32acc9`)
+- yt-dlp download progress not showing — listen stdout not stderr (`8cb99b0`)
+- quote USER_AGENT values with double quotes to prevent semicolon parsing issues (`419dff2`)
+
+### Documentation
+
+- update (`f761ad4`)
+
+
+## [1.2.8] - 2026-06-11
+
+### Features
+
+- add colored console output and task separators (PY) (`d983920`)
+- add colored console output and task separators (JS) (`3119a74`)
+
+### Bug Fixes
+
+- add long-form platform key mappings + upgrade to bright ANSI colors (`f56cb1f`)
+- remove AI_TIMEOUT env, unify platform keys (`142bc37`)
+
+### Documentation
+
+- update (`82637ea`)
+- add missing WHISPER_SERVICE_MODEL to .env.example (`de1d4d8`)
+- restructure README with progressive layout and updated platform keys (`298f049`)
+
+
 ## [1.2.7] - 2026-06-11
 
 ### Features

package/README.md

@@ -3,11 +3,14 @@
 基于 `process_videos.js` (Node.js) 或 `process_videos.py` (Python)，一键完成：yt-dlp 下载 → ffmpeg 转码 → whisper 识别 → AI 关键词归纳 → 写回 Excel。
 
 **五种使用方式，覆盖不同场景：**
-- **Excel 批量处理**：从 Excel 文件读取视频 ID，自动完成全流程（最常用）
-- **直链下载**：通过 `--url` 直接指定视频链接，自动识别平台并下载
-- **本地文件**：通过 `--input` 指定本地视频文件，跳过下载直接转码分析
-- **纯文本分析**：通过 `--content` 直接提供文本内容，跳过所有视频步骤，直接做 AI 关键词分析
-- **Excel列文本批量分析**：通过 `--content-column` 读取 Excel 某列的已有文本，批量做 AI 分析
+
+| 模式 | 输入 | 跳过步骤 | 适用场景 |
+|------|------|---------|----------|
+| **Excel 批量** | Excel 行（多视频） | — | 批量处理全流程 |
+| **--url 直链** | 单个视频 URL | — | 临时下载单个视频 |
+| **--input 本地** | 本地视频/音频文件 | 下载 | 处理已有文件 |
+| **--content 纯文本** | 文件路径或内联文本 | 下载+转码+识别 | 已有文本直接分析 |
+| **--content-column** | Excel 列的已有文本 | 下载+转码+识别 | 批量分析 Excel 中的文本 |
 
 ---
 
@@ -41,7 +44,7 @@ pip install pandas openpyxl requests python-dotenv questionary
 ### 必装工具
 
 | 工具 | 版本要求 | 安装方式 | 用途 |
-|---|---|---|---|
+|------|-----------|----------|------|
 | Python | 3.9+ | [python.org](https://www.python.org/) | 脚本运行 |
 | yt-dlp | 最新 | `pip install yt-dlp` 或 [GitHub Release](https://github.com/yt-dlp/yt-dlp/releases) | 视频下载 |
 | ffmpeg + ffprobe | 4.0+ | [ffmpeg.org](https://ffmpeg.org/download.html) 或 `winget install ffmpeg` | 音频转码 + 时长检测 |
@@ -53,7 +56,7 @@ pip install pandas openpyxl requests python-dotenv questionary
 YouTube 要求 JS 运行时解开 n-sig 挑战，否则无法提取视频格式。
 
 | 方式 | 安装命令 |
-|---|---|
+|------|----------|
 | Node.js（推荐） | [nodejs.org](https://nodejs.org/) 下载 LTS 版，安装后 `node --version` 验证 |
 | Deno | `winget install DenoLand.Deno` 或 [deno.com](https://deno.com/) |
 
@@ -62,9 +65,11 @@ YouTube 要求 JS 运行时解开 n-sig 挑战，否则无法提取视频格式
 ### Python 依赖
 
 ```bash
-pip install pandas openpyxl requests python-dotenv
+pip install pandas openpyxl requests python-dotenv questionary
 ```
 
+> `questionary` 为可选依赖（交互式确认时使用），建议一并安装。
+
 ### 环境变量配置（.env）
 
 **从 v2 开始，所有路径、字段映射、平台参数均通过 `.env` 文件配置。** 这意味着同一套脚本可以直接用于其他 Excel 文件，只需修改 `.env` 中的值即可。
@@ -83,10 +88,10 @@ cp .env.example .env
 |------|------|------|
 | 输入 | `EXCEL_FILE` | Excel 文件路径 |
 | 列映射 | `COL_ID` / `COL_TITLE` / `COL_CONTENT` / `COL_KEYWORDS` | 唯一标识列 / 标题列 / 识别文本输出列 / AI 关键词输出列 |
-| 列映射 | `COL_TENCENTVID` / `COL_BILIBILIBVID` / `COL_YOUTUBEID` / `COL_YOUKUID` | 各平台视频 ID 所在列 |
+| 列映射 | `COL_TENCENT` / `COL_BILIBILI` / `COL_YOUTUBE` / `COL_YOUKU` | 各平台视频 ID 所在列 |
 | Sheet | `VIDEO_SHEETS` | 逗号分隔需要处理的 sheet（留空则全部） |
 | 平台 | `PLATFORM_PRIORITY` | 平台重试优先级 |
-| 平台 | `{平台}_URL_TPL` | URL 模板（如 `YOUTUBE_URL_TPL=https://youtu.be/{youtubeId}`） |
+| 平台 | `{平台}_URL_TPL` | URL 模板（如 `YOUTUBE_URL_TPL=https://youtu.be/{youtube}`） |
 | 平台 | `{平台}_COOKIES_FROM_BROWSER` | 从浏览器直读 cookie（推荐 Firefox，替代手动导出文件） |
 | 平台 | `{平台}_COOKIE_FILE` | cookie 文件路径（备用方案，需定期更新） |
 | 平台 | `{平台}_PROXY` | 代理地址（如 `http://127.0.0.1:7897`，Clash Verge） |
@@ -101,7 +106,7 @@ cp .env.example .env
 | AI 分析 | `AI_ENABLED` | `true` 启用 / `false` 跳过（默认 true） |
 | AI 分析 | `AI_API_KEY` / `AI_BASE_URL` / `AI_MODEL` | OpenAI 兼容 API 配置 |
 | AI 分析 | `AI_PROMPT_TPL` | 提示词模板，必须包含 `{content}` 占位符 |
-| AI 分析 | `AI_TIMEOUT` | 单次分析请求超时（秒，默认 300） |
+| AI 分析 | `AI_TEMPERATURE` | AI 推理温度 (0.0~2.0) |
 
 ### .env 配置项变更权限
 
@@ -110,11 +115,11 @@ cp .env.example .env
 | 标记 | 含义 | 涵盖的配置项 | 示例 |
 |------|------|-------------|------|
 | **【自由】** | 值可随意改为任意合法内容 | 路径、开关、数字、字符串、URL、UA、格式参数等 | `EXCEL_FILE`, `YOUTUBE_PROXY`, `WHISPER_MODEL` |
-| **【调序】** | 只能从固定集合中增减/排序，不能用集合外的值 | `PLATFORM_PRIORITY` | 只能包含 `bilibiliBvid` / `youtubeId` / `tencentVid` / `youkuId` |
-| **【关联】** | 值需与脚本内约定的 Key 名一致 | URL 模板中的 `{占位符}` | `{youtubeId}` 必须跟 `COL_YOUTUBEID` 的后缀一致 |
+| **【调序】** | 只能从固定集合中增减/排序，不能用集合外的值 | `PLATFORM_PRIORITY` | 只能包含 `bilibili` / `youtube` / `tencent` / `youku` |
+| **【关联】** | 值需与脚本内约定的 Key 名一致 | URL 模板中的 `{占位符}` | `{youtube}` 必须跟 `COL_YOUTUBE` 的后缀一致 |
 | **【固定】** | 除非 Excel 列名或脚本内部逻辑改变，否则不应修改 | 列名映射 | `COL_ID=extra.id`、`COL_TITLE=title` 等 |
 
-> **最容易混淆的是【调序】**：`PLATFORM_PRIORITY` 可以调整顺序、增减条目，但只能用脚本已定义的 4 个 key，新增 `tiktokId`、`douyinId` 等无效 key 会导致脚本无法识别。
+> **最容易混淆的是【调序】**：`PLATFORM_PRIORITY` 可以调整顺序、增减条目，但只能用脚本已定义的 4 个 key，新增 `tiktok`、`douyin` 等无效 key 会导致脚本无法识别。
 
 ### Whisper 语音识别
 
@@ -139,9 +144,7 @@ WHISPER_LANGUAGE=zh          # 空=多语言自动检测（默认），需要指
 ```
 脚本会直接调用 `whisper` CLI，无需额外服务进程。
 
----
-
-## 目录结构
+### 目录结构
 
 ```
 ├── process_videos.js              # Node.js 主流程脚本（推荐）
@@ -154,28 +157,32 @@ WHISPER_LANGUAGE=zh          # 空=多语言自动检测（默认），需要指
 ├── cookies/                     # 站点 cookie 文件
 │   ├── bilibili.txt            # B站 cookie（Netscape 格式）
 │   └── youtube.txt             # YouTube cookie 备用（Firefox 直读方案不需要）
-├── downloads/                    # yt-dlp 下载输出（mp4）
-│   ├── YouTube视频/
-│   └── 普诺赛中文站/
-├── transcoded/                   # ffmpeg 转码输出（wav 16kHz mono）
-│   ├── YouTube视频/
-│   └── 普诺赛中文站/
-├── reports/                      # 执行报告（按 sheet/站点分目录）
-│   ├── YouTube视频/
-│   │   ├── report_YYYYMMDD_HHMMSS.json   # JSON 报告（机器可读，用于重跑）
-│   │   └── tasks/                        # 人类可读文本摘要
-│   │       ├── 2143.txt
-│   │       └── ...
-│   ├── 普诺赛中文站/
-│   │   ├── report_YYYYMMDD_HHMMSS.json
-│   │   └── tasks/
-│   │       └── ...
-│   ├── youtube/                  # --url 模式按平台名分目录
-│   │   ├── report_YYYYMMDD_HHMMSS.json
-│   │   └── tasks/
-│   └── local/                    # --input 模式默认目录
-│       ├── report_YYYYMMDD_HHMMSS.json
-│       └── tasks/
+├── output/                       # 输出根目录（可通过环境变量覆盖）
+│   ├── downloads/                # yt-dlp 下载输出（mp4）
+│   │   ├── youtube/              # 按平台分目录
+│   │   └── bilibili/
+│   ├── transcoded/               # ffmpeg 转码输出（wav 16kHz mono）
+│   │   ├── youtube/
+│   │   └── bilibili/
+│   └── reports/                 # 执行报告（按 sheet/平台分目录）
+│       ├── YouTube视频/
+│       │   ├── report_YYYYMMDD_HHMMSS.json   # JSON 报告（机器可读，用于重跑）
+│       │   └── tasks/                        # 人类可读文本摘要
+│       │       ├── 2143.txt
+│       │       └── ...
+│       ├── 普诺赛中文站/
+│       │   ├── report_YYYYMMDD_HHMMSS.json
+│       │   └── tasks/
+│       │       └── ...
+│       ├── youtube/                  # --url 模式按平台名分目录
+│       │   ├── report_YYYYMMDD_HHMMSS.json
+│       │   └── tasks/
+│       ├── local/                    # --input 模式默认目录
+│       │   ├── report_YYYYMMDD_HHMMSS.json
+│       │   └── tasks/
+│       └── content/                  # --content 模式固定目录
+│           ├── report_YYYYMMDD_HHMMSS.json
+│           └── tasks/
 ├── scripts/                      # 辅助脚本
 │   ├── release.js                 # 版本发布脚本
 │   └── regenerate-changelog.js  # CHANGELOG 重建脚本
@@ -215,9 +222,20 @@ yt-dlp 可直接从 Firefox 浏览器读取 cookie，无需手动导出：
 
 ### B站（bilibili）
 
-1. 同样使用上述 Chrome 扩展
+**方案 A（推荐）：直接从 Firefox 浏览器读 cookie**
+
+1. 用 Firefox 浏览器登录 [bilibili.com](https://www.bilibili.com)
+2. 在 `.env` 中设置 `BILIBILI_COOKIES_FROM_BROWSER=firefox`
+3. 脚本自动通过 `--cookies-from-browser firefox` 读取
+
+> Firefox cookie 直读方案同样适用于 B站，无需手动导出。
+
+**方案 B（备用）：从文件读取 cookie**
+
+1. Chrome 安装扩展 [Get cookies.txt LOCALLY](https://chromewebstore.google.com/detail/get-cookiestxt-locally/cclelndahbckbenkjhflpdbgdldlbecc)
 2. 访问 [bilibili.com](https://www.bilibili.com) 并登录
 3. 点击扩展图标 → Export → 保存为 `cookies/bilibili.txt`
+4. 在 `.env` 中注释掉 `BILIBILI_COOKIES_FROM_BROWSER`，启用 `BILIBILI_COOKIE_FILE=cookies/bilibili.txt`
 
 ---
 
@@ -419,7 +437,7 @@ node process_videos.js --content-column "content" --concurrency 2 --retry 2
 ## 参数说明
 
 | 参数 | 类型 | 默认值 | 说明 |
-|---|---|---|---|
+|------|------|---------|------|
 | `--sheet <name>` | str | 全部 | 指定 sheet 名称 |
 | `--id <id>` | str | — | 指定 extra.id 或 title（单条测试） |
 | `--offset <n>` | int | 0 | 跳过前 N 条任务（从 0 开始），适合调试大量数据 |
@@ -449,7 +467,7 @@ node process_videos.js --content-column "content" --concurrency 2 --retry 2
 ## 重试规则
 
 | 可重试 | 不重试 |
-|---|---|
+|----------|----------|
 | 网络超时、连接拒绝 | HTTP 404 / 403 / 401 |
 | yt-dlp 下载中断 | 视频已删除 / 私有 |
 | whisper 服务超时 | 无效 URL、文件不存在 |
@@ -462,7 +480,7 @@ node process_videos.js --content-column "content" --concurrency 2 --retry 2
 脚本默认不会重复处理已有文件，但会在以下情况自动触发重做：
 
 | 步骤 | 跳过条件 | 自动重做条件 |
-|---|---|---|
+|------|-----------|----------------|
 | 下载 | 同名文件已存在（非 `--force`） | `--force` 或文件不存在 |
 | 转码 | WAV 已存在 **且** MP4 时间戳 ≤ WAV 时间戳 | `--force` 或 **MP4 比 WAV 新**（重新下载过） |
 | 识别 | —（每次必跑，覆盖写入 Excel） | — |
@@ -505,8 +523,8 @@ AI_MODEL=agnes-2.0-flash
 # 提示词模板（{content} 会被识别文本替换）
 AI_PROMPT_TPL=帮我归纳总结一下Keywords，尽可能全一点，这是内容：{content}
 
-# 请求超时（秒）
-AI_TIMEOUT=300
+# 请求超时（秒，通过 --analyze-timeout 参数设置）
+# 不再使用 AI_TIMEOUT 环境变量（已统一为 --analyze-timeout 参数）
 ```
 
 ### 工作原理
@@ -544,21 +562,19 @@ node process_videos.js --sheet "YouTube视频" --step analyze --concurrency 2
 |--------|------|------|
 | 1 | `{id}` | `2143` |
 | 2 | `{id}_{title}` | `2143_产品介绍` |
-| 3 | `{id}_{title}_{platformVid}` | `2143_产品介绍_BV1xx4y1z7Ab` |
+| 3 | `{id}_{title}_{platform}` | `2143_产品介绍_bilibili` |
 
 > 去重仅在同 sheet 内生效，不同 sheet 之间允许同名文件（存放在不同子目录）。
 
 ---
 
----
-
 ## 进度显示
 
 执行时会同时展示**总体进度**和**单视频进度**：
 
 ```text
-[1/91] [2143] 开始处理 (sheet=YouTube视频, platform=youtubeId, title=xxx)
-  [2143] 开始下载 (平台=youtubeId)
+[1/91] [2143] 开始处理 (sheet=YouTube视频, platform=youtube, title=xxx)
+  [2143] 开始下载 (平台=youtube)
   [2143] https://youtu.be/zzJmKPX8a3c
   [2143] 解析页面...
   [2143] 15.2% 2.50MiB/s ETA 00:17          ← 下载实时进度
@@ -579,7 +595,7 @@ node process_videos.js --sheet "YouTube视频" --step analyze --concurrency 2
 ```
 
 | 层级 | 显示内容 |
-|---|---|
+|------|----------|
 | 总体进度 | 完成/总任务数、百分比、✅成功 ❌失败 ⚠️部分 ⏭️无视频 四维计数 |
 | 下载 | yt-dlp 实时百分比 + 速度 + ETA |
 | 转码 | 先 ffprobe 取时长，再实时解析 `time=` 算百分比（如 `25.3% (38s/150s)`） |
@@ -595,7 +611,7 @@ node process_videos.js --sheet "YouTube视频" --step analyze --concurrency 2
 五种输入来源在不同处理环节的输出路径汇总如下。所有路径均以 `output/` 为根（可通过 `DOWNLOADS_DIR` / `TRANSCODED_DIR` / `REPORTS_DIR` 环境变量覆盖）。
 
 > `{sheet}` = Excel 工作表名（如 `YouTube视频`、`普诺赛中文站`）  
-> `{platform}` = 视频平台标识（如 `youtube`、`bilibili`、`tencentVid`、`youku`）  
+> `{platform}` = 视频平台标识（如 `youtube`、`bilibili`、`tencent`、`youku`）  
 > `{stem}` = 去重后的安全文件名（不含扩展名）  
 
 ### ① Excel 批量模式（默认）
@@ -778,11 +794,11 @@ node process_videos.js --content-column "content" --concurrency 2  # 执行
 脚本支持四个视频平台的下载，各有不同的反爬配置：
 
 | 平台 | 字段 | 反爬措施 |
-|---|---|---|
-| B站 (bilibili) | `extra.bilibiliBvid` | Chrome UA + Referer 头 + 有效 cookie + 并发分片 |
-| YouTube | `extra.youtubeId` | Chrome UA + Firefox cookie 直读 + 代理 + Node.js 解 n-sig |
-| 腾讯视频 | `extra.tencentVid` | 无需特殊配置 |
-| 优酷 | `extra.youkuId` | 无需特殊配置（部分视频需会员） |
+|------|-------|----------|
+| B站 (bilibili) | `extra.bilibili` | Chrome UA + Referer 头 + 有效 cookie + 并发分片 |
+| YouTube | `extra.youtube` | Chrome UA + Firefox cookie 直读 + 代理 + Node.js 解 n-sig |
+| 腾讯视频 | `extra.tencent` | 无需特殊配置 |
+| 优酷 | `extra.youku` | 无需特殊配置（部分视频需会员） |
 
 > YouTube 反爬最强：需要 **代理** + **登录态 cookie** + **JS runtime 解 n-sig** 三者配合。
 > 脚本会自动给 yt-dlp 及其 node/ejs 子进程注入 `HTTPS_PROXY` 环境变量，确保所有流量走代理。
@@ -795,7 +811,7 @@ node process_videos.js --content-column "content" --concurrency 2  # 执行
 #### YouTube
 
 | 格式类型 | URL 示例 | 视频 ID 提取正则 |
-|---|---|---|
+|----------|-----------|-------------------|
 | 标准观看页 | `https://www.youtube.com/watch?v=VIDEO_ID` | `youtube\.com/watch\?v=([a-zA-Z0-9_-]{11})` |
 | 短链接 | `https://youtu.be/VIDEO_ID` | `youtu\.be/([a-zA-Z0-9_-]{11})` |
 | Shorts | `https://www.youtube.com/shorts/VIDEO_ID` | `youtube\.com/shorts/([a-zA-Z0-9_-]{11})` |
@@ -815,7 +831,7 @@ node process_videos.js --content-column "content" --concurrency 2  # 执行
 #### B站（bilibili）
 
 | 格式类型 | URL 示例 | 视频 ID 提取正则 |
-|---|---|---|
+|----------|-----------|-------------------|
 | 标准页（BV 号） | `https://www.bilibili.com/video/BV1xx411c7mD` | `bilibili\.com\/video\/(BV[a-zA-Z0-9]{10})` |
 | 标准页（av 号） | `https://www.bilibili.com/video/av170001` | `bilibili\.com\/video\/av(\d+)` |
 | 短链接 | `https://b23.tv/BV1xx411c7mD` | `b23\.tv\/(BV[a-zA-Z0-9]{10})` |
@@ -836,7 +852,7 @@ node process_videos.js --content-column "content" --concurrency 2  # 执行
 #### 腾讯视频
 
 | 格式类型 | URL 示例 | 视频 ID 提取正则 |
-|---|---|---|
+|----------|-----------|-------------------|
 | 标准页（x/page） | `https://v.qq.com/x/page/VIDEO_ID.html` | `v\.qq\.com\/x\/page\/([a-zA-Z0-9]+)\.html` |
 | 标准页（x/cover） | `https://v.qq.com/x/cover/COVER/VIDEO_ID.html` | `v\.qq\.com\/x\/cover\/[^\/]+\/([a-zA-Z0-9]+)\.html` |
 | 内嵌页 | `https://v.qq.com/txp/iframe/player.html?vid=VIDEO_ID` | `[?&]vid=([a-zA-Z0-9]+)` |
@@ -853,7 +869,7 @@ node process_videos.js --content-column "content" --concurrency 2  # 执行
 #### 优酷（Youku）
 
 | 格式类型 | URL 示例 | 视频 ID 提取正则 |
-|---|---|---|
+|----------|-----------|-------------------|
 | 标准页（v_show） | `https://v.youku.com/v_show/id_VIDEO_ID.html` | `v\.youku\.com\/v_show\/id_([a-zA-Z0-9=]+)\.html` |
 | 标准页（video） | `https://v.youku.com/video/VIDEO_ID` | `v\.youku\.com\/video\/([a-zA-Z0-9=]+)` |
 | 标准页（www） | `https://www.youku.com/v_show/id_VIDEO_ID.html` | `www\.youku\.com\/v_show\/id_([a-zA-Z0-9=]+)\.html` |
@@ -866,18 +882,18 @@ node process_videos.js --content-column "content" --concurrency 2  # 执行
 - **格式互转**：
   - 优酷内嵌格式较复杂，建议直接使用标准页链接（`{YOUKU_URL_TPL}`）
 
-> **脚本使用提示**：Excel 中只需填入视频 ID（如 `zzJmKPX8a3c`、`BV1pg411b7Ug`、`o0325y3hqh`、`XMzgxNzExNTY4MA==`），脚本自动替换 URL 模板中的 `{youtubeId}`、`{bilibiliBvid}` 等占位符生成下载链接。
+> **脚本使用提示**：Excel 中只需填入视频 ID（如 `zzJmKPX8a3c`、`BV1pg411b7Ug`、`o0325y3hqh`、`XMzgxNzExNTY4MA==`），脚本自动替换 URL 模板中的 `{youtube}`、`{bilibili}` 等占位符生成下载链接。
 
 ### 常见下载错误
 
 | 错误 | 平台 | 原因 | 解决方案 |
-|---|---|---|---|
+|------|------|------|----------|
 | `Sign in to confirm you're not a bot` | YouTube | cookie 过期或无效 | 检查 Firefox 登录态，或重新导出 cookie 文件 |
 | `cookies does no longer seem to be valid` | YouTube | cookie 文件超过 48h | 用 Firefox cookies-from-browser 方案（免维护） |
 | `Unable to download webpage: HTTP Error 403` | YouTube | IP 被识别为非 YouTube 地区 | 确保代理运行（端口 7897），检查 `YOUTUBE_PROXY` |
 | `n challenge solving failed` | YouTube | 无 JS 运行时 | 安装 Node.js，确保 `YOUTUBE_JS_RUNTIMES=node` |
 | `Requested format is not available` | YouTube | n-sig 未解开，格式不可用 | 同上，安装 JS 运行时 |
-| `HTTP Error 412` | B站 | 缺少 Chrome UA 或 cookie 过期 | 重新导出 `cookies/bilibili.txt` |
+| `HTTP Error 412` | B站 | 缺少 Chrome UA 或 cookie 过期 | 重新导出 `cookies/bilibili.txt` 或使用 Firefox 直读 |
 | `HTTP Error 403` | B站 | 地区限制或视频已删除 | 检查视频是否可访问 |
 | `dpapi decryption failed` | YouTube | Windows Chrome cookie 加密 | **改用 Firefox**（`.env` 中设 `YOUTUBE_COOKIES_FROM_BROWSER=firefox`） |
 
@@ -895,7 +911,7 @@ node process_videos.js --content-column "content" --concurrency 2  # 执行
 3. 克隆或下载项目文件（`.env.example`、`.env`、`cookies/` 等）
 4. 安装必装工具：`yt-dlp`、`ffmpeg`、`ffprobe`，确保均在 PATH
 5. 用 Firefox 登录 YouTube，设置 `YOUTUBE_COOKIES_FROM_BROWSER=firefox`
-6. B站 cookie 仍需手动导出 `cookies/bilibili.txt`
+6. B站 cookie 仍需手动导出 `cookies/bilibili.txt`（或设置 `BILIBILI_COOKIES_FROM_BROWSER=firefox`）
 7. 启动代理（Clash Verge 等），确认端口匹配 `YOUTUBE_PROXY`
 8. `video-pipeline --dry-run` 验证
 
@@ -906,7 +922,7 @@ node process_videos.js --content-column "content" --concurrency 2  # 执行
 3. 安装 Python 依赖：`pip install pandas openpyxl requests python-dotenv questionary`
 4. `cp .env.example .env`，根据实际情况修改 `.env` 中的路径、代理端口和字段映射
 5. 用 Firefox 登录 YouTube，设置 `YOUTUBE_COOKIES_FROM_BROWSER=firefox`
-6. B站 cookie 仍需手动导出 `cookies/bilibili.txt`
+6. B站 cookie 仍需手动导出 `cookies/bilibili.txt`（或设置 `BILIBILI_COOKIES_FROM_BROWSER=firefox`）
 7. 启动代理（Clash Verge 等），确认端口匹配 `YOUTUBE_PROXY`
 8. `python process_videos.py --dry-run` 验证
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "video-pipeline",
-  "version": "1.2.7",
+  "version": "1.2.9",
   "description": "视频下载、转码、文本识别、AI 关键词分析一体化流程 CLI 工具",
   "keywords": [
     "video",

package/process_videos.js

@@ -71,35 +71,40 @@ const COL_ID = process.env.COL_ID || 'extra.id';
 const COL_TITLE = process.env.COL_TITLE || 'title';
 const COL_CONTENT = process.env.COL_CONTENT || 'content';
 const COL_KEYWORDS = process.env.COL_KEYWORDS || 'keywords';
-const COL_TENCENTVID = process.env.COL_TENCENTVID || 'extra.tencentVid';
-const COL_BILIBILIBVID = process.env.COL_BILIBILIBVID || 'extra.bilibiliBvid';
-const COL_YOUTUBEID = process.env.COL_YOUTUBEID || 'extra.youtubeId';
-const COL_YOUKUID = process.env.COL_YOUKUID || 'extra.youkuId';
+const COL_TENCENTVID = process.env.COL_TENCENTVID || 'extra.tencent';
+const COL_BILIBILIBVID = process.env.COL_BILIBILIBVID || 'extra.bilibili';
+const COL_YOUTUBEID = process.env.COL_YOUTUBEID || 'extra.youtube';
+const COL_YOUKUID = process.env.COL_YOUKUID || 'extra.youku';
 
 // ============================== 平台配置 ==============================
 const PLATFORM_COL_MAP = {
+  tencent: COL_TENCENTVID,
   tencentVid: COL_TENCENTVID,
+  bilibili: COL_BILIBILIBVID,
   bilibiliBvid: COL_BILIBILIBVID,
+  youtube: COL_YOUTUBEID,
   youtubeId: COL_YOUTUBEID,
+  youku: COL_YOUKUID,
   youkuId: COL_YOUKUID,
 };
 
 // ============================== 工具函数 ==============================
 function c(color, text) {
   const colors = {
-    dim: '\x1b[2m',
-    yellow: '\x1b[33m',
-    cyan: '\x1b[36m',
-    green: '\x1b[32m',
-    red: '\x1b[31m',
-    blue: '\x1b[34m',
-    magenta: '\x1b[35m',
-    reset: '\x1b[0m',
+    bold:    '\x1b[1m',
+    dim:     '\x1b[2m',
+    yellow:  '\x1b[93m',
+    cyan:    '\x1b[96m',
+    green:   '\x1b[92m',
+    red:     '\x1b[91m',
+    blue:    '\x1b[94m',
+    magenta: '\x1b[95m',
+    reset:   '\x1b[0m',
   };
   return (colors[color] || '') + text + colors.reset;
 }
 
-const PLATFORM_PRIORITY = (process.env.PLATFORM_PRIORITY || 'bilibiliBvid,youtubeId,tencentVid,youkuId')
+const PLATFORM_PRIORITY = (process.env.PLATFORM_PRIORITY || 'bilibili,youtube,tencent,youku')
   .split(',').map(s => s.trim()).filter(Boolean);
 
 const _VIDEO_SHEETS_RAW = process.env.VIDEO_SHEETS || '';
@@ -108,9 +113,13 @@ const VIDEO_SHEETS = _VIDEO_SHEETS_RAW
   : [];
 
 const _PKEY_ENV_PREFIX = {
+  tencent: 'TENCENT',
   tencentVid: 'TENCENT',
+  bilibili: 'BILIBILI',
   bilibiliBvid: 'BILIBILI',
+  youtube: 'YOUTUBE',
   youtubeId: 'YOUTUBE',
+  youku: 'YOUKU',
   youkuId: 'YOUKU',
 };
 
@@ -137,11 +146,11 @@ function buildPlatformConfig() {
     const ua = process.env[`${prefix}_USER_AGENT`] || '';
     const extraHeaders = [];
     if (ua) extraHeaders.push('--user-agent', ua);
-    if (pkey === 'bilibiliBvid') {
+    if (pkey === 'bilibili') {
       const referer = process.env[`${prefix}_REFERER`] || '';
       if (referer) extraHeaders.push('--add-header', `Referer:${referer}`);
     }
-    if (ua || (pkey === 'bilibiliBvid' && process.env[`${prefix}_REFERER`])) {
+    if (ua || (pkey === 'bilibili' && process.env[`${prefix}_REFERER`])) {
       extraHeaders.push('--add-header', 'Accept-Language:zh,en;q=0.9');
     }
     if (extraHeaders.length) cfg.extra_headers = extraHeaders;
@@ -151,7 +160,7 @@ function buildPlatformConfig() {
     if (cf) cfg.concurrent_fragments = parseInt(cf, 10);
 
     // Extra args (YouTube)
-    if (pkey === 'youtubeId') {
+    if (pkey === 'youtube') {
       const jsRt = process.env[`${prefix}_JS_RUNTIMES`] || '';
       const rc = process.env[`${prefix}_REMOTE_COMPONENTS`] || '';
       const extraArgs = [];
@@ -173,13 +182,13 @@ const PLATFORM_CONFIG = buildPlatformConfig();
 
 // ============================== 日志 ==============================
 function logInfo(msg) {
-  console.log(`${timestamp()} [INFO] ${msg}`);
+  console.log(`${timestamp()} ${c('cyan', '[INFO]')} ${msg}`);
 }
 function logWarn(msg) {
-  console.log(`${timestamp()} [WARN] ${msg}`);
+  console.log(`${timestamp()} ${c('yellow', '[WARN]')} ${msg}`);
 }
 function logError(msg) {
-  console.log(`${timestamp()} [ERROR] ${msg}`);
+  console.log(`${timestamp()} ${c('red', '[ERROR]')} ${msg}`);
 }
 function timestamp() {
   return new Date().toTimeString().slice(0, 8);
@@ -209,7 +218,13 @@ class OverallProgress {
   }
   summaryLine() {
     const pct = this.total ? (this.completed / this.total * 100).toFixed(1) : '0.0';
-    return `[总进度 ${this.completed}/${this.total} (${pct}%)] 成功:${this.success} 失败:${this.failed} 部分:${this.partial} 无视频:${this.noVideo}`;
+    const parts = [];
+    parts.push(c('dim', `[总进度 ${this.completed}/${this.total} (${pct}%)]`));
+    parts.push(this.success > 0 ? c('green', `✅${this.success}`) : c('dim', '✅0'));
+    parts.push(this.failed > 0 ? c('red', `❌${this.failed}`) : c('dim', '❌0'));
+    parts.push(this.partial > 0 ? c('yellow', `⚠️${this.partial}`) : c('dim', '⚠️0'));
+    parts.push(this.noVideo > 0 ? c('cyan', `⏹️${this.noVideo}`) : c('dim', '⏹️0'));
+    return parts.join('  ');
   }
 }
 
@@ -328,7 +343,7 @@ function buildUrl(pkey, vid) {
 const URL_PLATFORM_MAP = [
   {
     platform: 'bilibili',
-    pkey: 'bilibiliBvid',
+    pkey: 'bilibili',
     patterns: [
       /bilibili\.com\/video\/(BV[a-zA-Z0-9]{10})/,
       /b23\.tv\/([a-zA-Z0-9]+)/,
@@ -337,14 +352,14 @@ const URL_PLATFORM_MAP = [
   },
   {
     platform: 'youtube',
-    pkey: 'youtubeId',
+    pkey: 'youtube',
     patterns: [
       /(?:youtube\.com\/(?:watch\?v=|embed\/|shorts\/|live\/)|youtu\.be\/)([a-zA-Z0-9_-]{11})/,
     ],
   },
   {
     platform: 'tencent',
-    pkey: 'tencentVid',
+    pkey: 'tencent',
     patterns: [
       /v\.qq\.com\/x\/page\/([a-zA-Z0-9]+)\.html/,
       /v\.qq\.com\/x\/cover\/[^/]+\/([a-zA-Z0-9]+)\.html/,
@@ -353,7 +368,7 @@ const URL_PLATFORM_MAP = [
   },
   {
     platform: 'youku',
-    pkey: 'youkuId',
+    pkey: 'youku',
     patterns: [
       /v\.youku\.com\/v_show\/id_([a-zA-Z0-9=]+)\.html/,
     ],
@@ -649,15 +664,13 @@ function spawnWithTimeout(cmd, args, timeout, options = {}) {
       reject(Object.assign(new Error(`Timeout after ${timeout}s`), { name: 'TimeoutError', code: 'ETIMEDOUT' }));
     }, timeout * 1000);
 
-    if (onProgress && child.stderr) {
-      const rl = readline.createInterface({ input: child.stderr, crlfDelay: Infinity });
-      rl.on('line', line => {
-        stderr += line + '\n';
-        try { onProgress(line); } catch {}
-      });
-      child.stderr.on('end', () => rl.close());
-      // 同时消费 stdout，防止缓冲区填满阻塞子进程
-      child.stdout.on('data', d => { stdout += d.toString(); });
+    if (onProgress) {
+      // 同时监听 stdout 和 stderr — yt-dlp --newline 的 [download] 进度输出在 stdout
+      const onLine = (buf, line) => { try { onProgress(line); } catch {} };
+      const rlOut = readline.createInterface({ input: child.stdout, crlfDelay: Infinity });
+      rlOut.on('line', line => { stdout += line + '\n'; onLine('stdout', line); });
+      const rlErr = readline.createInterface({ input: child.stderr, crlfDelay: Infinity });
+      rlErr.on('line', line => { stderr += line + '\n'; onLine('stderr', line); });
     } else {
       child.stdout.on('data', d => { stdout += d.toString(); });
       child.stderr.on('data', d => { stderr += d.toString(); });
@@ -665,9 +678,6 @@ function spawnWithTimeout(cmd, args, timeout, options = {}) {
 
     child.on('close', code => {
       clearTimeout(timer);
-      if (!onProgress) {
-        // Without onProgress, stderr was captured by the 'data' handler
-      }
       if (code === 0) resolve({ stdout, stderr });
       else reject(Object.assign(new Error(`Exit code ${code}`), { code, stderr }));
     });
@@ -689,7 +699,7 @@ async function stepAnalyze(text, maxRetries, retryDelay, timeout = 300, label =
   const model = process.env.AI_MODEL || '';
   const promptTpl = process.env.AI_PROMPT_TPL || '帮我归纳总结一下Keywords，尽可能全一点，这是内容：{content}';
   const aiTemperature = parseFloat(process.env.AI_TEMPERATURE || '0.3');
-  const aiTimeout = parseInt(process.env.AI_TIMEOUT || String(timeout), 10);
+  const aiTimeout = timeout;
 
   if (!apiKey || !baseUrl || !model) {
     return { text: null, retries: 0, error: 'AI config incomplete' };
@@ -711,7 +721,7 @@ async function stepAnalyze(text, maxRetries, retryDelay, timeout = 300, label =
     const progressInterval = setInterval(() => {
       if (!done) {
         const elapsed = ((Date.now() - analyzeStart) / 1000).toFixed(0);
-        lockedPrint(`  [${label}] AI analyzing... ${elapsed}s`);
+        lockedPrint(`  [${label}] ${c('green', 'AI analyzing...')} ${elapsed}s`);
       }
     }, 5000);
 
@@ -742,7 +752,7 @@ async function stepAnalyze(text, maxRetries, retryDelay, timeout = 300, label =
       lastErr = String(e.message).slice(0, 500);
       if (attempt < maxAttempts - 1) {
         const delay = Math.min(retryDelay * Math.pow(2, attempt), 30);
-        lockedPrint(`  [${label}] AI attempt ${attempt + 1} failed: ${lastErr.slice(0, 100)}, retrying in ${delay}s...`);
+        lockedPrint(`  [${label}] AI attempt ${attempt + 1} ${c('red', 'failed')}: ${lastErr.slice(0, 100)}, retrying in ${delay}s...`);
         await sleep(delay * 1000);
       }
     }
@@ -773,13 +783,16 @@ function cleanupPartials(dlDir, stem) {
 
 // ============================== 下载 ==============================
 function parseYtdlpProgress(line) {
-  // Parse yt-dlp progress line like "[download]  12.3% of ~50.00MiB at  2.5MiB/s ETA 00:15"
-  const m = line.match(/\[download\]\s+([\d.]+%)\s+of\s+~?([\d.]+[KMG]iB)\s+at\s+([\d.]+[KMG]iB\/s)\s+ETA\s+([\d:]+)/);
-  if (m) return `DL ${m[1]} of ${m[2]} @ ${m[3]} ETA ${m[4]}`;
-  // Also try: "[download] 100% of 50.00MiB"
-  const m2 = line.match(/\[download\]\s+([\d.]+%)\s+of\s+([\d.]+[KMG]iB)/);
-  if (m2) return `DL ${m2[1]} of ${m2[2]}`;
-  return null;
+  // Parse yt-dlp progress lines like:
+  //   "[download]  12.3% of ~50.00MiB at  2.5MiB/s ETA 00:15"
+  //   "[download]   0.0% of   61.66MiB at  Unknown B/s ETA Unknown"
+  const m = line.match(/\[download\]\s+([\d.]+%)\s+of\s+~?\s*([\d.]+[KMG]iB)/);
+  if (!m) return null;
+  const pct  = m[1];                // e.g. "12.3%"
+  const size = m[2];                // e.g. "50.00MiB"
+  const spd  = (line.match(/at\s+([\d.]+ ?[KMG]?i?B\/s)/) || [])[1] || '?';
+  const eta  = (line.match(/ETA\s+([\d:]+)/) || [])[1] || '?';
+  return `DL ${pct} of ${size} @ ${spd} ETA ${eta}`;
 }
 
 async function stepDownload(row, sheetName, maxRetries, retryDelay, force, timeout = 600) {
@@ -796,13 +809,13 @@ async function stepDownload(row, sheetName, maxRetries, retryDelay, force, timeo
   if (!force) {
     const existing = findDownloadedFile(dlDir, stem);
     if (existing) {
-      lockedPrint(`  [${stem}] exists ${path.basename(existing)}, skip download`);
+      lockedPrint(c('dim', `  [${stem}] exists ${path.basename(existing)}, skip download`));
       return { file: existing, retries: 0, error: null };
     }
   }
 
   const videoUrl = buildUrl(pkey, vid);
-  lockedPrint(`  [${stem}] start download (platform=${pkey})`);
+  lockedPrint(`  [${stem}] ${c('cyan', 'start download')} (platform=${pkey})`);
   lockedPrint(`  [${stem}] ${videoUrl}`);
 
   const cfg = PLATFORM_CONFIG[pkey];
@@ -815,6 +828,10 @@ async function stepDownload(row, sheetName, maxRetries, retryDelay, force, timeo
     '-f', cfg.format || 'bestvideo+bestaudio/best',
   ];
 
+  if (force) {
+    args.push('--force-overwrites');
+  }
+
   if (cfg.concurrent_fragments) {
     args.push('--concurrent-fragments', String(cfg.concurrent_fragments));
   }
@@ -863,7 +880,7 @@ async function stepDownload(row, sheetName, maxRetries, retryDelay, force, timeo
 
   const downloaded = findDownloadedFile(dlDir, stem);
   if (downloaded) {
-    lockedPrint(`  [${stem}] download done -> ${path.basename(downloaded)}`);
+    lockedPrint(`  [${stem}] ${c('green', 'download done')} -> ${path.basename(downloaded)}`);
     return { file: downloaded, retries: 0, error: null };
   }
   logError(`[${stem}] file not found after download`);
@@ -957,7 +974,7 @@ async function stepTranscode(srcFile, sheetName, maxRetries, retryDelay, force,
 
   try {
     await retryCall(doTranscode, maxRetries, retryDelay, stem);
-    lockedPrint(`  [${stem}] transcode done`);
+    lockedPrint(`  [${stem}] ${c('green', 'transcode done')}`);
     return { file: outFile, retries: 0, error: null };
   } catch (e) {
     logError(`[${stem}] ffmpeg transcode failed: ${(e.stderr || e.message).slice(-2000)}`);
@@ -979,10 +996,10 @@ async function stepTranscribe(audioFile, maxRetries, retryDelay, timeout = 600)
   const fileSizeMB = (fs.statSync(audioFile).size / (1024 * 1024)).toFixed(1);
   if (WHISPER_BACKEND === 'local') {
     const langLabel = WHISPER_LANGUAGE || 'auto';
-    lockedPrint(`  [${stem}] start transcribe [local(${WHISPER_MODEL}/${langLabel})] (${fileSizeMB}MB)...`);
+    lockedPrint(`  [${stem}] ${c('magenta', 'start transcribe')} [local(${WHISPER_MODEL}/${langLabel})] (${fileSizeMB}MB)...`);
   } else {
     const modelLabel = WHISPER_SERVICE_MODEL || WHISPER_MODEL || '(server default)';
-    lockedPrint(`  [${stem}] start transcribe [service(${modelLabel})] (${fileSizeMB}MB)...`);
+    lockedPrint(`  [${stem}] ${c('magenta', 'start transcribe')} [service(${modelLabel})] (${fileSizeMB}MB)...`);
   }
 
   if (WHISPER_BACKEND === 'local') {
@@ -1018,7 +1035,7 @@ async function transcribeLocal(audioFile, stem, maxRetries, retryDelay, timeout
     const { result: text, retriesUsed, error } = await retryCall(doTranscribe, maxRetries, retryDelay, stem);
     const elapsed = ((Date.now() - startTime) / 1000).toFixed(0);
     if (error) return { text: null, retries: retriesUsed, error };
-    lockedPrint(`  [${stem}] transcribe done (${elapsed}s, ${text.length} chars)`);
+    lockedPrint(`  [${stem}] ${c('green', 'transcribe done')} (${elapsed}s, ${text.length} chars)`);
     return { text, retries: 0, error: null };
   } catch (e) {
     logError(`[${stem}] local whisper transcribe failed: ${e.message}`);
@@ -1082,7 +1099,7 @@ async function transcribeService(audioFile, stem, maxRetries, retryDelay, timeou
     const { result: text, retriesUsed, error } = await retryCall(doTranscribe, maxRetries, retryDelay, stem);
     const elapsed = ((Date.now() - startTime) / 1000).toFixed(0);
     if (error) return { text: null, retries: retriesUsed, error };
-    lockedPrint(`  [${stem}] transcribe done (${elapsed}s, ${text.length} chars)`);
+    lockedPrint(`  [${stem}] ${c('green', 'transcribe done')} (${elapsed}s, ${text.length} chars)`);
     return { text, retries: 0, error: null };
   } catch (e) {
     logError(`[${stem}] whisper transcribe failed: ${e.message}`);
@@ -1314,8 +1331,13 @@ async function processOneTask(row, sheetName, steps, maxRetries, retryDelay, for
   const result = new TaskResult(sheetName, key, title, pkey, videoUrl, stem);
 
   const tag = positionLabel ? `${positionLabel} ` : '';
-  lockedPrint(`${tag}[${stem}] start (sheet=${sheetName}, platform=${pkey || 'N/A'}, title=${title.slice(0, 40)})`);
-  logInfo(`[${stem}] start (sheet=${sheetName}, platform=${pkey || 'N/A'})`);
+  lockedPrint('');
+  lockedPrint(c('dim', '─'.repeat(62)));
+  lockedPrint(c('bold', `  ▶ Task ${positionLabel || '?'}`)
+ + c('dim', `  [${stem}]  sheet=${sheetName}  platform=${pkey || 'N/A'}`));
+  if (title) lockedPrint(c('dim', `  title: ${title.slice(0, 50)}`));
+  lockedPrint(c('dim', '─'.repeat(62)));
+  logInfo(`[${stem}] start (sheet=${sheetName}, platform=${pkey || 'N/A'}, title=${title.slice(0, 40)})`);
 
   // ── download ──
   let dlFile = null;
@@ -1414,9 +1436,9 @@ async function processOneTask(row, sheetName, steps, maxRetries, retryDelay, for
           const { text: kw, retries, error } = await stepAnalyze(txt, maxRetries, retryDelay, analyzeTimeout, result.stem);
           result.analyze = new StepResult(kw ? 'success' : 'failed', kw, error, retries);
           if (kw) {
-            lockedPrint(`  [${result.stem}] AI analysis done (${kw.length} chars)`);
+            lockedPrint(`  [${result.stem}] ${c('green', 'AI analysis done')} (${kw.length} chars)`);
           } else {
-            lockedPrint(`  [${result.stem}] AI analysis failed: ${error}`);
+            lockedPrint(`  [${result.stem}] ${c('red', 'AI analysis failed')}: ${error}`);
           }
         } catch (e) {
           result.analyze = new StepResult('failed', null, String(e.message).slice(0, 500), maxRetries);
@@ -2084,6 +2106,8 @@ async function run({
       }
       results.push(result);
       overall.addResult(result.overall_status);
+      lockedPrint('');
+      lockedPrint(c('dim', '─'.repeat(62)));
       console.log(`\n${overall.summaryLine()}\n`);
       return result;
     })
@@ -2284,6 +2308,8 @@ async function runFromReport(reportPath, steps, maxRetries, retryDelay, concurre
       }
       results.push(result);
       overall.addResult(result.overall_status);
+      lockedPrint('');
+      lockedPrint(c('dim', '─'.repeat(62)));
       console.log(`\n${overall.summaryLine()}\n`);
       return result;
     })
@@ -2315,8 +2341,8 @@ if (process.argv[1] === __filename || process.argv[1]?.endsWith('process_videos.
     .description('视频下载、转码、文本识别、AI分析一体化流程')
     .option('--sheet <name>', '指定 sheet 名称')
     .option('--id <id>', '指定 extra.id 或 title（单条测试）')
-    .option('--offset <n>', '跳过前 N 条任务（从 0 开始），默认 0', parseInt, 0)
-    .option('--limit <n>', '最多处理 N 条任务，默认无限制', parseInt, 0)
+    .option('--offset <n>', '跳过前 N 条任务（从 0 开始），默认 0', v => parseInt(v, 10), 0)
+    .option('--limit <n>', '最多处理 N 条任务，默认无限制', v => parseInt(v, 10), 0)
     .option('--step <step>', '指定执行步骤（可多次指定），如 --step transcode --step transcribe', (val, prev) => {
       const allowed = ['download', 'transcode', 'transcribe', 'analyze'];
       if (!allowed.includes(val)) {
@@ -2326,13 +2352,13 @@ if (process.argv[1] === __filename || process.argv[1]?.endsWith('process_videos.
       return [...(prev || []), val];
     })
     .option('--force', '强制重做下载+转码（忽略已有文件）')
-    .option('--concurrency <n>', '并发数，默认 1', parseInt, 1)
-    .option('--retry <n>', '每步失败最大重试次数，默认 0', parseInt, 0)
-    .option('--retry-delay <n>', '重试间隔基数（秒），默认 5', parseFloat, 5.0)
-    .option('--download-timeout <n>', '下载超时（秒），默认 600', parseInt, 600)
-    .option('--transcode-timeout <n>', '转码超时（秒），默认 600', parseInt, 600)
-    .option('--transcribe-timeout <n>', '识别超时（秒），默认 600', parseInt, 600)
-    .option('--analyze-timeout <n>', 'AI 分析超时（秒），默认 300', parseInt, 300)
+    .option('--concurrency <n>', '并发数，默认 1', v => parseInt(v, 10), 1)
+    .option('--retry <n>', '每步失败最大重试次数，默认 0', v => parseInt(v, 10), 0)
+    .option('--retry-delay <n>', '重试间隔基数（秒），默认 5', v => parseFloat(v), 5.0)
+    .option('--download-timeout <n>', '下载超时（秒），默认 600', v => parseInt(v, 10), 600)
+    .option('--transcode-timeout <n>', '转码超时（秒），默认 600', v => parseInt(v, 10), 600)
+    .option('--transcribe-timeout <n>', '识别超时（秒），默认 600', v => parseInt(v, 10), 600)
+    .option('--analyze-timeout <n>', 'AI 分析超时（秒），默认 300', v => parseInt(v, 10), 300)
     .option('--dry-run', '干跑模式，只列任务不执行')
     .option('--retry-failed <path>', '从报告 JSON 重跑失败项（output/reports/{sheet}/report_xxx.json）')
     .option('--init', '复制 .env.example 到当前目录并重命名为 .env')