npm - video-pipeline - Versions diffs - 1.2.6 → 1.2.8 - Mend

video-pipeline 1.2.6 → 1.2.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/.env.example CHANGED Viewed

@@ -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）可一起修改
@@ -77,10 +78,10 @@ COL_CONTENT=content              # 输出列：识别文本写入此列
 COL_KEYWORDS=keywords           # 输出列：AI 分析结果（关键词归纳）写入此列
 #
 # 【平台视频 ID 列】至少配置一个，列值会替换 URL 模板中的占位符
-COL_TENCENTVID=extra.tencentVid
-COL_BILIBILIBVID=extra.bilibiliBvid
-COL_YOUTUBEID=extra.youtubeId
-COL_YOUKUID=extra.youkuId
+COL_TENCENTVID=extra.tencent
+COL_BILIBILIBVID=extra.bilibili
+COL_YOUTUBEID=extra.youtube
+COL_YOUKUID=extra.youku
 # ── 处理的 Sheet ────────────────────────────────────────────────────────────
 # 【自由】逗号分隔的 sheet 名称列表，可增删、调序；不指定则处理所有 sheet
@@ -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）
@@ -127,7 +128,10 @@ YOUKU_URL_TPL=https://v.youku.com/v_show/id_{youkuId}.html
 # {前缀}_URL_TPL                【自由】URL 模板 (见"平台 URL 模板"段)
 # ── Bilibili 配置 ───────────────────────────────────────────────────────────
-BILIBILI_COOKIE_FILE=cookies/bilibili.txt     # 【自由】cookie 文件路径
+# 方案 A（推荐）: 直接从 Firefox 浏览器读 cookie，yt-dlp 能稳定解密
+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  # 【自由】
 BILIBILI_REFERER=https://www.bilibili.com/     # 【自由】
 BILIBILI_CONCURRENT_FRAGMENTS=4               # 【自由】并发分片数
@@ -164,8 +168,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 CHANGED Viewed

@@ -1,5 +1,40 @@
 # Changelog
+## [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
+- 补充所有模式 README 示例 + 修复下载和AI分析进度显示 (`9aa2160`)
+- --content / --content-column + B站 Firefox cookie (`e25a4a8`)
+### Bug Fixes
+- 修复JS报告时间戳小数点导致文件名出现两个点的问题 (`c0abe90`)
+### Documentation
+- update (`df4d7b6`)
 ## [1.2.6] - 2026-06-11
 ### Features

package/README.md CHANGED Viewed

@@ -2,10 +2,15 @@
 基于 `process_videos.js` (Node.js) 或 `process_videos.py` (Python)，一键完成：yt-dlp 下载 → ffmpeg 转码 → whisper 识别 → AI 关键词归纳 → 写回 Excel。
-**两种使用方式：**
-- **Excel 批量处理**：从 Excel 文件读取视频 ID，自动完成全流程
-- **直链下载**：通过 `--url` 直接指定视频链接，自动识别平台并下载
-- **本地文件**：通过 `--input` 指定本地视频文件，跳过下载直接转码分析
+**五种使用方式，覆盖不同场景：**
+| 模式 | 输入 | 跳过步骤 | 适用场景 |
+|------|------|---------|----------|
+| **Excel 批量** | Excel 行（多视频） | — | 批量处理全流程 |
+| **--url 直链** | 单个视频 URL | — | 临时下载单个视频 |
+| **--input 本地** | 本地视频/音频文件 | 下载 | 处理已有文件 |
+| **--content 纯文本** | 文件路径或内联文本 | 下载+转码+识别 | 已有文本直接分析 |
+| **--content-column** | Excel 列的已有文本 | 下载+转码+识别 | 批量分析 Excel 中的文本 |
 ---
@@ -39,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` | 音频转码 + 时长检测 |
@@ -51,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/) |
@@ -60,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` 中的值即可。
@@ -81,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） |
@@ -99,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 配置项变更权限
@@ -108,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 语音识别
@@ -137,9 +144,7 @@ WHISPER_LANGUAGE=zh          # 空=多语言自动检测（默认），需要指
 ```
 脚本会直接调用 `whisper` CLI，无需额外服务进程。
----
-## 目录结构
+### 目录结构
 ```
 ├── process_videos.js              # Node.js 主流程脚本（推荐）
@@ -152,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 重建脚本
@@ -213,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`
 ---
@@ -339,6 +359,64 @@ node process_videos.js --input "downloads/产品介绍.mp4" --step analyze
 - 检查是否可以正常读取
 - 校验失败会提示错误并退出
+### 处理纯文本内容（跳过视频步骤）
+如果你已经有了一段文本内容（比如爬虫爬取的、之前识别好的、或者从其他途径获取的），可以直接做 AI 分析，跳过下载、转码、识别三个步骤：
+```bash
+# ═══════════ --content 模式：纯文本 AI 分析 ═══════════
+# 从文件读取内容，自动用文件名作为输出名
+node process_videos.js --content "data/article.txt"
+python process_videos.py --content "data/article.txt"
+# 直接提供内联文本，自动取前 32 字符作为输出名
+node process_videos.js --content "这是一段需要分析的内容..."
+python process_videos.py --content "这是一段需要分析的内容..."
+# 指定输出文件名（--name）
+node process_videos.js --content "data/article.txt" --name "文章分析"
+python process_videos.py --content "data/article.txt" --name "文章分析"
+# 配合 --dry-run 预览
+node process_videos.js --content "data/article.txt" --dry-run
+```
+**输出文件命名规则：**
+- 指定了 `--name` → 使用 `--name` 的值
+- 内容是文件路径 → 使用文件名（不含扩展名）
+- 内容是内联文本 → 使用前 32 个字符
+**输出位置：** `output/reports/content/tasks/{name}.txt` + `output/reports/content/report_xxx.json`
+### Excel 列文本批量 AI 分析
+当 Excel 某列已经存好了文本内容（比如之前爬虫爬取的），可以批量对这些文本做 AI 关键词分析：
+```bash
+# ═══════════ --content-column 模式：批量 AI 分析 ═══════════
+# 对 Excel 中 "content" 列的文本逐行做 AI 关键词分析，结果写回 "keywords" 列
+node process_videos.js --content-column "content"
+# 指定其他列名
+node process_videos.js --content-column "爬取文本"
+# 指定特定 sheet
+node process_videos.js --sheet "普诺赛中文站" --content-column "content"
+# 配合 --dry-run 预览
+node process_videos.js --content-column "content" --dry-run
+# 配合 --offset / --limit 调试
+node process_videos.js --content-column "content" --offset 0 --limit 3
+node process_videos.js --content-column "content" --concurrency 2 --retry 2
+```
+> **注意**：`--content-column` 模式自动设置 `--step analyze`（仅 AI 分析），不会触发下载/转码/识别。
+> 文本为空的行会自动跳过。
+> 分析结果写入 Excel 的 `keywords` 列（由 `COL_KEYWORDS` 环境变量指定）。
 ### 工具预检（执行前自动检测）
 每次执行任务前，脚本会自动检测本次涉及步骤所需的工具/服务是否可用：
@@ -359,7 +437,7 @@ node process_videos.js --input "downloads/产品介绍.mp4" --step analyze
 ## 参数说明
 | 参数 | 类型 | 默认值 | 说明 |
-|---|---|---|---|
+|------|------|---------|------|
 | `--sheet <name>` | str | 全部 | 指定 sheet 名称 |
 | `--id <id>` | str | — | 指定 extra.id 或 title（单条测试） |
 | `--offset <n>` | int | 0 | 跳过前 N 条任务（从 0 开始），适合调试大量数据 |
@@ -379,7 +457,9 @@ node process_videos.js --input "downloads/产品介绍.mp4" --step analyze
 | `--file <path>` | path | — | 指定 Excel 文件路径（优先级高于 EXCEL_FILE 环境变量） |
 | `--input <path>` | path | — | 指定本地视频文件路径（跳过下载，直接转码→识别→分析） |
 | `--url <url>` | str | — | 直接指定视频下载链接（跳过 Excel），支持标准链接和内嵌链接 |
-| `--name <name>` | str | — | 指定输出文件名，不含扩展名（与 --url / --input 配合使用） |
+| `--content <text 或 path>` | str | — | 直接提供文本内容（文件路径或内联文本），跳过下载/转码/识别，仅做 AI 分析 |
+| `--content-column <col>` | str | — | Excel 模式：指定包含已有文本的列名，批量做 AI 分析（自动设 --step analyze） |
+| `--name <name>` | str | — | 指定输出文件名，不含扩展名（与 --url / --input / --content 配合使用） |
 | `--env-file <path>` | path | .env | 指定要加载的 .env 文件路径 |
 ---
@@ -387,7 +467,7 @@ node process_videos.js --input "downloads/产品介绍.mp4" --step analyze
 ## 重试规则
 | 可重试 | 不重试 |
-|---|---|
+|----------|----------|
 | 网络超时、连接拒绝 | HTTP 404 / 403 / 401 |
 | yt-dlp 下载中断 | 视频已删除 / 私有 |
 | whisper 服务超时 | 无效 URL、文件不存在 |
@@ -400,7 +480,7 @@ node process_videos.js --input "downloads/产品介绍.mp4" --step analyze
 脚本默认不会重复处理已有文件，但会在以下情况自动触发重做：
 | 步骤 | 跳过条件 | 自动重做条件 |
-|---|---|---|
+|------|-----------|----------------|
 | 下载 | 同名文件已存在（非 `--force`） | `--force` 或文件不存在 |
 | 转码 | WAV 已存在 **且** MP4 时间戳 ≤ WAV 时间戳 | `--force` 或 **MP4 比 WAV 新**（重新下载过） |
 | 识别 | —（每次必跑，覆盖写入 Excel） | — |
@@ -443,8 +523,8 @@ AI_MODEL=agnes-2.0-flash
 # 提示词模板（{content} 会被识别文本替换）
 AI_PROMPT_TPL=帮我归纳总结一下Keywords，尽可能全一点，这是内容：{content}
-# 请求超时（秒）
-AI_TIMEOUT=300
+# 请求超时（秒，通过 --analyze-timeout 参数设置）
+# 不再使用 AI_TIMEOUT 环境变量（已统一为 --analyze-timeout 参数）
 ```
 ### 工作原理
@@ -482,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          ← 下载实时进度
@@ -509,16 +587,20 @@ node process_videos.js --sheet "YouTube视频" --step analyze --concurrency 2
   [2143] 开始识别 (文件 45.2MB)...
   [2143] 识别中... 5s                        ← 识别每 5s 报时
   [2143] 识别完成 (22s, 1234 字符)
+  [2143] AI 分析中... 5s                     ← AI 每 5s 报时
+  [2143] AI 分析中... 10s
+  [2143] AI 分析完成 (567 字符)
 [总进度 1/91 (1.1%)] ✅1 ❌0 ⚠️0 ⏭️0         ← 每完成一个刷新
 ```
 | 层级 | 显示内容 |
-|---|---|
+|------|----------|
 | 总体进度 | 完成/总任务数、百分比、✅成功 ❌失败 ⚠️部分 ⏭️无视频 四维计数 |
 | 下载 | yt-dlp 实时百分比 + 速度 + ETA |
 | 转码 | 先 ffprobe 取时长，再实时解析 `time=` 算百分比（如 `25.3% (38s/150s)`） |
 | 识别 | 每 5s 打印已用时间，完成时显示总耗时和文本长度 |
+| AI 分析 | 每 5s 打印已用时间，完成时显示结果长度或失败原因 |
 多线程并发时使用打印锁保证输出不交错。
@@ -526,10 +608,10 @@ node process_videos.js --sheet "YouTube视频" --step analyze --concurrency 2
 ## 输出结构速查表
-三种输入来源在不同处理环节的输出路径汇总如下。所有路径均以 `output/` 为根（可通过 `DOWNLOADS_DIR` / `TRANSCODED_DIR` / `REPORTS_DIR` 环境变量覆盖）。
+五种输入来源在不同处理环节的输出路径汇总如下。所有路径均以 `output/` 为根（可通过 `DOWNLOADS_DIR` / `TRANSCODED_DIR` / `REPORTS_DIR` 环境变量覆盖）。
 > `{sheet}` = Excel 工作表名（如 `YouTube视频`、`普诺赛中文站`）
-> `{platform}` = 视频平台标识（如 `youtube`、`bilibili`、`tencentVid`、`youku`）
+> `{platform}` = 视频平台标识（如 `youtube`、`bilibili`、`tencent`、`youku`）
 > `{stem}` = 去重后的安全文件名（不含扩展名）
 ### ① Excel 批量模式（默认）
@@ -565,19 +647,50 @@ node process_videos.js --sheet "YouTube视频" --step analyze --concurrency 2
 > `local` 是 `--input` 模式的固定目录名（与 Excel 模式的 sheet 名无关），所有本地文件处理结果统一归入此目录。
----
+### ④ --content 纯文本模式
+| 环节 | 输出路径 | 产物格式 | 说明 |
+|------|---------|---------|------|
+| 下载 | —（跳过） | — | 无需下载 |
+| 转码 | —（跳过） | — | 无需转码 |
+| 识别 | —（跳过） | — | 无需语音识别 |
+| JSON 报告 | `output/reports/content/report_YYYYMMDD_HHMMSS.json` | JSON | 格式与 Excel 模式一致 |
+| 文本报告 | `output/reports/content/tasks/{stem}.txt` | 文本 | 含源内容 + AI 关键词分析 |
+> `content` 是固定目录名。{stem} = `--name` 值 > 文件名 stem > 内联文本前 32 字符。
+### ⑤ --content-column Excel列文本批量模式
+| 环节 | 输出路径 | 产物格式 | 说明 |
+|------|---------|---------|------|
+| 下载 | —（跳过） | — | 无需下载 |
+| 转码 | —（跳过） | — | 无需转码 |
+| 识别 | —（跳过） | — | 无需语音识别 |
+| JSON 报告 | `output/reports/{sheet}/report_YYYYMMDD_HHMMSS.json` | JSON | 按 Excel sheet 分目录，格式与 Excel 模式一致 |
+| 文本报告 | `output/reports/{sheet}/tasks/{stem}.txt` | 文本 | 含列文本 + AI 关键词分析 |
+| Excel 写回 | `{EXCEL_FILE}` 的 `keywords` 列 | Excel | AI 关键词写入 Excel |
-### 三种来源对比一览
+> 此模式自动设置 `--step analyze`，下载/转码/识别全跳过。AI 结果同时写入 Excel 和报告文件。
-| 维度 | Excel 批量 | --url 直链 | --input 本地文件 |
-|------|-----------|-----------|-----------------|
-| 输入 | Excel 行（多视频批量） | 单个视频 URL | 本地视频/音频文件 |
-| 下载目录 | `downloads/{sheet}/` | `downloads/{platform}/` | 无 |
-| 转码目录 | `transcoded/{sheet}/` | `transcoded/{platform}/` | `transcoded/local/` |
-| 报告目录 | `reports/{sheet}/` | `reports/{platform}/` | `reports/local/` |
-| 分组依据 | Excel sheet 名 | URL 解析的平台名 | 固定 `local` |
-| 并发支持 | ✅ 多线程 | ❌ 单任务 | ❌ 单任务 |
-| 支持 --retry-failed | ✅ | ❌ | ❌ |
+---
+### 五种来源对比一览
+| 维度 | Excel 批量 | --url 直链 | --input 本地文件 | --content 纯文本 | --content-column 列文本 |
+|------|-----------|-----------|-----------------|-----------------|------------------------|
+| 输入 | Excel 行（多视频批量） | 单个视频 URL | 本地视频/音频文件 | 文件路径或内联文本 | Excel 列的已有文本 |
+| 下载 | ✅ yt-dlp | ✅ yt-dlp | ❌ 跳过 | ❌ 跳过 | ❌ 跳过 |
+| 转码 | ✅ ffmpeg | ✅ ffmpeg | ✅ ffmpeg | ❌ 跳过 | ❌ 跳过 |
+| 识别 | ✅ whisper | ✅ whisper | ✅ whisper | ❌ 跳过 | ❌ 跳过 |
+| AI 分析 | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 下载目录 | `downloads/{sheet}/` | `downloads/{platform}/` | 无 | 无 | 无 |
+| 转码目录 | `transcoded/{sheet}/` | `transcoded/{platform}/` | `transcoded/local/` | 无 | 无 |
+| 报告目录 | `reports/{sheet}/` | `reports/{platform}/` | `reports/local/` | `reports/content/` | `reports/{sheet}/` |
+| 分组依据 | Excel sheet 名 | URL 解析的平台名 | 固定 `local` | 固定 `content` | Excel sheet 名 |
+| 并发支持 | ✅ 多线程 | ❌ 单任务 | ❌ 单任务 | ❌ 单任务 | ✅ 多线程 |
+| 写入 Excel | ✅ | ❌ | ❌ | ❌ | ✅ |
+| 支持 --retry-failed | ✅ | ❌ | ❌ | ❌ | ❌ |
+| 适用场景 | 批量处理全流程 | 临时下载单个视频 | 处理已有视频文件 | 已有文本直接分析 | 批量分析Excel中的文本 |
 ---
@@ -618,6 +731,8 @@ node process_videos.js --sheet "YouTube视频" --step analyze --concurrency 2
 ## 典型工作流
+### 场景一：Excel 批量处理视频
 ```bash
 # 1. 干跑预览
 node process_videos.js --dry-run
@@ -634,6 +749,44 @@ node process_videos.js --concurrency 3 --retry 3
 node process_videos.js --retry-failed reports/YouTube视频/report_xxx.json --concurrency 2 --retry 3
 ```
+### 场景二：临时下载单个视频
+```bash
+# 从 URL 下载 → 转码 → 识别 → AI 分析，一条龙
+node process_videos.js --url "https://www.youtube.com/watch?v=zzJmKPX8a3c"
+# 指定输出文件名
+node process_videos.js --url "https://www.bilibili.com/video/BV1xx411c7mD" --name "产品介绍视频"
+```
+### 场景三：处理本地视频文件
+```bash
+# 已有视频文件，直接转码分析
+node process_videos.js --input "downloads/产品介绍.mp4"
+# 只做 AI 分析（已有转码+识别结果）
+node process_videos.js --input "downloads/产品介绍.mp4" --step analyze
+```
+### 场景四：纯文本 AI 分析
+```bash
+# 已有文本内容，跳过所有视频步骤，直接做关键词提取
+node process_videos.js --content "data/article.txt"
+# 内联文本直接分析
+node process_videos.js --content "今天我们要讨论的是普诺赛产品..." --name "产品讨论"
+```
+### 场景五：批量分析 Excel 中的已有文本
+```bash
+# Excel 某列已有文本（如爬虫爬取的），批量做 AI 关键词分析
+node process_videos.js --content-column "content" --dry-run      # 先预览
+node process_videos.js --content-column "content" --concurrency 2  # 执行
+```
 ---
 ## 平台适配说明
@@ -641,11 +794,11 @@ node process_videos.js --retry-failed reports/YouTube视频/report_xxx.json --co
 脚本支持四个视频平台的下载，各有不同的反爬配置：
 | 平台 | 字段 | 反爬措施 |
-|---|---|---|
-| 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` 环境变量，确保所有流量走代理。
@@ -658,7 +811,7 @@ node process_videos.js --retry-failed reports/YouTube视频/report_xxx.json --co
 #### 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})` |
@@ -678,7 +831,7 @@ node process_videos.js --retry-failed reports/YouTube视频/report_xxx.json --co
 #### 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})` |
@@ -699,7 +852,7 @@ node process_videos.js --retry-failed reports/YouTube视频/report_xxx.json --co
 #### 腾讯视频
 | 格式类型 | 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]+)` |
@@ -716,7 +869,7 @@ node process_videos.js --retry-failed reports/YouTube视频/report_xxx.json --co
 #### 优酷（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` |
@@ -729,18 +882,18 @@ node process_videos.js --retry-failed reports/YouTube视频/report_xxx.json --co
 - **格式互转**：
   - 优酷内嵌格式较复杂，建议直接使用标准页链接（`{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`） |
@@ -758,7 +911,7 @@ node process_videos.js --retry-failed reports/YouTube视频/report_xxx.json --co
 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` 验证
@@ -769,7 +922,7 @@ node process_videos.js --retry-failed reports/YouTube视频/report_xxx.json --co
 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 CHANGED Viewed

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

package/process_videos.js CHANGED Viewed

@@ -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,18 +182,19 @@ 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);
 }
+// Node.js 单线程模型下 console.log 是原子的，不会出现行内交错
 function lockedPrint(s) {
   console.log(s);
 }
@@ -208,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('  ');
   }
 }
@@ -327,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]+)/,
@@ -336,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/,
@@ -352,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/,
     ],
@@ -655,6 +671,8 @@ function spawnWithTimeout(cmd, args, timeout, options = {}) {
         try { onProgress(line); } catch {}
       });
       child.stderr.on('end', () => rl.close());
+      // 同时消费 stdout，防止缓冲区填满阻塞子进程
+      child.stdout.on('data', d => { stdout += d.toString(); });
     } else {
       child.stdout.on('data', d => { stdout += d.toString(); });
       child.stderr.on('data', d => { stderr += d.toString(); });
@@ -676,7 +694,7 @@ function spawnWithTimeout(cmd, args, timeout, options = {}) {
 }
 // ============================== AI 分析 ==============================
-async function stepAnalyze(text, maxRetries, retryDelay, timeout = 300) {
+async function stepAnalyze(text, maxRetries, retryDelay, timeout = 300, label = 'analyze') {
   if (!text || !text.trim()) {
     return { text: null, retries: 0, error: 'content empty, skip AI analysis' };
   }
@@ -686,7 +704,7 @@ async function stepAnalyze(text, maxRetries, retryDelay, timeout = 300) {
   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' };
@@ -703,6 +721,15 @@ async function stepAnalyze(text, maxRetries, retryDelay, timeout = 300) {
   let lastErr = null;
   const maxAttempts = maxRetries + 1;
   for (let attempt = 0; attempt < maxAttempts; attempt++) {
+    let done = false;
+    const analyzeStart = Date.now();
+    const progressInterval = setInterval(() => {
+      if (!done) {
+        const elapsed = ((Date.now() - analyzeStart) / 1000).toFixed(0);
+        lockedPrint(`  [${label}] ${c('green', 'AI analyzing...')} ${elapsed}s`);
+      }
+    }, 5000);
     try {
       const controller = new AbortController();
       const timer = setTimeout(() => controller.abort(), aiTimeout * 1000);
@@ -716,6 +743,8 @@ async function stepAnalyze(text, maxRetries, retryDelay, timeout = 300) {
         signal: controller.signal,
       });
       clearTimeout(timer);
+      done = true;
+      clearInterval(progressInterval);
       if (!resp.ok) {
         throw new Error(`HTTP ${resp.status}: ${await resp.text().catch(() => '')}`);
       }
@@ -723,10 +752,12 @@ async function stepAnalyze(text, maxRetries, retryDelay, timeout = 300) {
       const content = body.choices?.[0]?.message?.content || '';
       return { text: content.trim(), retries: attempt, error: null };
     } catch (e) {
+      done = true;
+      clearInterval(progressInterval);
       lastErr = String(e.message).slice(0, 500);
       if (attempt < maxAttempts - 1) {
         const delay = Math.min(retryDelay * Math.pow(2, attempt), 30);
-        lockedPrint(`  [analyze] 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);
       }
     }
@@ -780,13 +811,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];
@@ -847,7 +878,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`);
@@ -941,7 +972,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)}`);
@@ -963,10 +994,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') {
@@ -1002,7 +1033,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}`);
@@ -1066,7 +1097,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}`);
@@ -1201,7 +1232,7 @@ function generateReport(results, config, sheetName) {
   // ── 单 sheet 报告 ──
   const dir = path.join(REPORTS_DIR, sheetName);
   fs.mkdirSync(dir, { recursive: true });
-  const ts = new Date().toISOString().replace(/[-:T]/g, '').slice(0, 15).replace(/(\d{8})(\d{6})/, '$1_$2');
+  const ts = new Date().toISOString().split('.')[0].replace(/[-:T]/g, '').replace(/(\d{8})(\d{6})/, '$1_$2');
   const reportFile = path.join(dir, `report_${ts}.json`);
   const summary = computeSummary(results);
@@ -1287,6 +1318,8 @@ async function processOneTask(row, sheetName, steps, maxRetries, retryDelay, for
   whisperAvailable, positionLabel = '', downloadTimeout = 600, transcodeTimeout = 600,
   transcribeTimeout = 600, analyzeTimeout = 300) {
+  const preContent = row.preContent || null;
   const { pkey, vid } = getVideoId(row);
   const stem = stemName(row, sheetName);
   const key = rowKey(row);
@@ -1296,12 +1329,19 @@ 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;
-  if (steps.includes('download')) {
+  if (preContent) {
+    result.download = new StepResult('skipped', null, 'pre-content mode');
+  } else if (steps.includes('download')) {
     if (!pkey) {
       result.download = new StepResult('skipped');
       result.overall_status = 'no_video';
@@ -1332,7 +1372,9 @@ async function processOneTask(row, sheetName, steps, maxRetries, retryDelay, for
   // ── transcode ──
   let tcFile = null;
-  if (steps.includes('transcode') && dlFile) {
+  if (preContent) {
+    result.transcode = new StepResult('skipped', null, 'pre-content mode');
+  } else if (steps.includes('transcode') && dlFile) {
     try {
       const { file, retries, error } = await stepTranscode(dlFile, sheetName, maxRetries, retryDelay, force, transcodeTimeout);
       tcFile = file;
@@ -1357,7 +1399,9 @@ async function processOneTask(row, sheetName, steps, maxRetries, retryDelay, for
   }
   // ── transcribe ──
-  if (steps.includes('transcribe') && tcFile) {
+  if (preContent) {
+    result.transcribe = new StepResult('success', preContent);
+  } else if (steps.includes('transcribe') && tcFile) {
     if (!whisperAvailable) {
       result.transcribe = new StepResult('failed', null, `whisper unreachable (${WHISPER_SERVICE})`);
       result.overall_status = 'partial';
@@ -1387,12 +1431,12 @@ async function processOneTask(row, sheetName, steps, maxRetries, retryDelay, for
       const txt = result.transcribe.file;
       if (txt) {
         try {
-          const { text: kw, retries, error } = await stepAnalyze(txt, maxRetries, retryDelay, analyzeTimeout);
+          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);
@@ -1658,7 +1702,7 @@ async function runInputTask(opts) {
     if (aiEnabled) {
       console.log(`  [${usedStem}] 🤖 开始 AI 分析...`);
       try {
-        const { text: kw, error } = await stepAnalyze(transcribeText, maxRetries, retryDelay, analyzeTimeout);
+        const { text: kw, error } = await stepAnalyze(transcribeText, maxRetries, retryDelay, analyzeTimeout, usedStem);
         if (kw && typeof kw === 'string') {
           analyzeText = kw;
           console.log(`  [${usedStem}] 🤖 AI分析完成: ${kw.length} 字符`);
@@ -1730,6 +1774,123 @@ async function runInputTask(opts) {
 }
+// ═══════════════════════════════════════════════════════════════════
+// 文本内容流水线（--content 模式）
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * --content 模式：纯文本 → AI 关键词提取
+ * 文本来源可以是文件路径或内联文本，
+ * --name 可指定输出文件名（不含扩展名）。
+ * 不指定时：文件路径取 stem，内联文本取前 32 字符。
+ */
+async function runContentTask(opts) {
+  const { content, name, steps, force,
+    retry: maxRetries, retryDelay, analyzeTimeout } = opts;
+  // ── 1. 读取/确定文本 ──
+  const contentPath = path.resolve(content);
+  let contentText = '';
+  let fromFile = false;
+  if (fs.existsSync(contentPath) && fs.statSync(contentPath).isFile()) {
+    contentText = fs.readFileSync(contentPath, 'utf-8').trim();
+    fromFile = true;
+    console.log(`  📖 从文件读取: ${contentPath} (${contentText.length} 字符)`);
+  } else {
+    contentText = content;
+  }
+  if (!contentText || !contentText.trim()) {
+    console.error(c('red', '错误: --content 文本内容为空'));
+    process.exit(1);
+  }
+  // ── 2. 确定输出文件名 ──
+  let stem = '';
+  if (name) {
+    stem = safeFilename(name);
+  } else if (fromFile) {
+    stem = safeFilename(path.parse(contentPath).name);
+  } else {
+    stem = safeFilename(contentText.replace(/\s+/g, ' ').slice(0, 32).trim());
+  }
+  if (steps.length === 0) steps = ['analyze'];
+  console.log(c('dim', '\n── 开始执行 (内容分析) ──\n'));
+  console.log(`  输出名称:  ${c('cyan', stem)}`);
+  console.log(`  内容长度:  ${c('cyan', contentText.length + ' 字符')}`);
+  console.log(`  执行步骤:  ${c('cyan', steps.join(' → '))}`);
+  if (opts.dryRun) {
+    console.log('');
+    process.exit(0);
+  }
+  const sheetName = 'content';
+  // ── 3. 构建 TaskResult ──
+  const result = new TaskResult(sheetName, stem, stem.slice(0, 50), 'local', null, stem);
+  result.download = new StepResult('skipped');
+  result.transcode = new StepResult('skipped');
+  result.transcribe = new StepResult('success', contentText);
+  // ── 4. AI 分析 ──
+  if (steps.includes('analyze')) {
+    const aiEnabled = (process.env.AI_ENABLED || 'true').toLowerCase() === 'true';
+    if (!aiEnabled) {
+      result.analyze = new StepResult('skipped');
+      console.log(`  [${stem}] AI 分析: ${c('yellow', '已禁用 (AI_ENABLED=false)')}`);
+    } else {
+      console.log(`  [${stem}] 开始 AI 分析...`);
+      try {
+        const { text: kw, retries, error } = await stepAnalyze(
+          contentText, maxRetries, retryDelay, analyzeTimeout, stem
+        );
+        result.analyze = new StepResult(kw ? 'success' : 'failed', kw, error, retries);
+        if (kw) {
+          console.log(`  [${stem}] AI 分析完成 (${kw.length} 字符)`);
+        } else {
+          console.log(`  [${stem}] AI 分析失败: ${error}`);
+        }
+      } catch (e) {
+        result.analyze = new StepResult('failed', null, String(e.message).slice(0, 500), maxRetries);
+      }
+    }
+  }
+  result.overall_status = (result.analyze && result.analyze.status === 'success') ? 'success' : 'partial';
+  // ── 5. 保存文本结果 ──
+  const an = result.analyze;
+  const analyzeText = an && an.file && an.status === 'success' ? an.file : '';
+  if (contentText || analyzeText) {
+    const outDir = path.join(REPORTS_DIR, sheetName, 'tasks');
+    fs.mkdirSync(outDir, { recursive: true });
+    const outFile = path.join(outDir, `${stem}.txt`);
+    const lines = [
+      `来源: --content`,
+      `文件名: ${stem}`,
+      '', '='.repeat(60), '',
+      '【源内容】', '', contentText, '',
+    ];
+    if (analyzeText) {
+      lines.push('【AI 分析关键词】', '', analyzeText);
+    }
+    fs.writeFileSync(outFile, lines.join('\n'), 'utf-8');
+    console.log(`\n  报告已保存: ${outFile}`);
+  }
+  // ── 6. 生成标准报告 JSON ──
+  const config = { steps, max_retries: maxRetries, retry_delay: retryDelay, concurrency: 1, force: force || false };
+  generateReport([result], config, sheetName);
+  printReportSummary([result]);
+  console.log('');
+  return result;
+}
 // ═══════════════════════════════════════════════════════════════════
 // URL 直链流水线（--url 模式）
 // ═══════════════════════════════════════════════════════════════════
@@ -1846,7 +2007,7 @@ async function runUrlTask(opts) {
 }
 async function run({
-  targetSheet, targetId, steps, maxRetries, retryDelay,
+  targetSheet, targetId, contentColumn, steps, maxRetries, retryDelay,
   concurrency, force, dryRun, retryFailed,
   downloadTimeout, transcodeTimeout, transcribeTimeout, analyzeTimeout,
   offset = 0, rowLimit = 0,
@@ -1879,6 +2040,15 @@ async function run({
     }
     precomputeStems(rows, sheetName);
     for (const row of rows) {
+      // ── content-column 模式：从指定列读取预置文本 ──
+      if (contentColumn) {
+        const text = String(row[contentColumn] || '').trim();
+        if (!text) {
+          logWarn(`[${sheetName}] row ${row[COL_ID] || '?'}: contentColumn "${contentColumn}" 为空，跳过`);
+          continue;
+        }
+        row.preContent = text;
+      }
       tasks.push({ row, sheetName });
     }
   }
@@ -1934,6 +2104,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;
     })
@@ -1942,7 +2114,7 @@ async function run({
   await Promise.all(taskFns);
   // ── 批量写回 Excel ──
-  if (steps.includes('transcribe')) {
+  if (steps.includes('transcribe') || contentColumn) {
     const kwMap = new Map();
     for (const r of results) {
       if (r.analyze.status === 'success' && r.analyze.file) {
@@ -2134,6 +2306,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;
     })
@@ -2188,8 +2362,10 @@ if (process.argv[1] === __filename || process.argv[1]?.endsWith('process_videos.
     .option('--init', '复制 .env.example 到当前目录并重命名为 .env')
     .option('--file <path>', '指定 Excel 文件路径（优先级高于 EXCEL_FILE 环境变量）')
     .option('--input <path>', '指定本地视频文件路径（跳过下载，直接转码→识别→分析）')
+    .option('--content <text|path>', '直接提供文本内容（文件路径或内联文本），跳过下载/转码/识别，直接做 AI 分析')
+    .option('--content-column <col>', 'Excel 模式：指定包含已爬取文本的列名，批量做 AI 分析')
     .option('--url <url>', '直接指定视频下载链接（跳过 Excel），支持标准链接和内嵌链接')
-    .option('--name <name>', '指定输出文件名，不含扩展名（与 --url / --input 配合使用）')
+    .option('--name <name>', '指定输出文件名，不含扩展名（与 --url / --input / --content 配合使用）')
     .option('--env-file <path>', '指定要加载的 .env 文件路径（默认: 当前目录 .env）');
   program.parse();
@@ -2252,6 +2428,12 @@ if (process.argv[1] === __filename || process.argv[1]?.endsWith('process_videos.
     logInfo(`Excel 文件覆盖为: ${EXCEL_FILE}`);
   }
   const steps = opts.step?.length ? opts.step : ['download', 'transcode', 'transcribe', 'analyze'];
+  // --content-column 模式：默认只跑 AI 分析
+  if (opts.contentColumn && !opts.step?.length) {
+    steps.length = 0;
+    steps.push('analyze');
+    logInfo('--content-column 模式：默认 --step analyze');
+  }
   // ── --url 模式：直接处理单个视频链接 ──
   if (opts.url) {
     const parsed = parseUrl(opts.url);
@@ -2466,10 +2648,25 @@ if (process.argv[1] === __filename || process.argv[1]?.endsWith('process_videos.
     process.exit(0);
   }
+  // ── --content 模式：纯文本 AI 分析 ──
+  if (opts.content) {
+    await runContentTask({
+      content: opts.content,
+      name: opts.name || null,
+      steps,
+      retry: opts.retry,
+      retryDelay: opts.retryDelay,
+      analyzeTimeout: opts.analyzeTimeout,
+      force: opts.force || false,
+      dryRun: opts.dryRun || false,
+    });
+    process.exit(0);
+  }
   run({
     targetSheet: opts.sheet || null,
     targetId: opts.id || null,
+    contentColumn: opts.contentColumn || null,
     steps,
     offset: opts.offset || 0,
     rowLimit: opts.limit || 0,