video-pipeline 1.2.3 → 1.2.5

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## [1.2.5] - 2026-06-11
+
+### Features
+
+- 新增 --offset / --limit 参数，支持跳过和限量处理 Excel 数据 (`d691822`)
+
+### Bug Fixes
+
+- base_dir 改用 cwd 而非脚本安装目录，修复全局安装后路径解析错误 (`0fe5b1e`)
+
+### Documentation
+
+- update (`45a8d45`)
+
+
+## [1.2.4] - 2026-06-11
+
+### Features
+
+- release body 自动提取当前版本 CHANGELOG 段 (`4f03302`)
+
+### Bug Fixes
+
+- sed 模式改用 #+ 匹配任意层级标题，兼容 major/minor/patch 不同 # 数量 (`86f2e5b`)
+
+### Documentation
+
+- update (`9e4fd55`)
+
+
 ## [1.2.3] - 2026-06-11
 
 ### Bug Fixes

package/README.md

@@ -244,6 +244,10 @@ node process_videos.js --sheet "YouTube视频" --concurrency 2 --retry 3
 
 # 先干跑预览
 node process_videos.js --dry-run
+
+# Excel 数据量大时，偏移+限量调试
+node process_videos.js --offset 10 --limit 5 --dry-run  # 跳过前10条，预览5条
+node process_videos.js --limit 3 --concurrency 1        # 只处理前3条
 ```
 
 ### 重跑失败
@@ -344,6 +348,8 @@ 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 开始），适合调试大量数据 |
+| `--limit <n>` | int | 0 | 最多处理 N 条任务，0 表示无限制 |
 | `--step <step>` | str | 全跑 | 只执行某步：`download` / `transcode` / `transcribe` / `analyze` |
 | `--force` | flag | off | 强制重做下载+转码，忽略已有文件 |
 | `--concurrency <n>` | int | 1 | 并发数，建议 2~3 |

package/package.json

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

package/process_videos.js

@@ -8,6 +8,7 @@
  *   node process_videos.js --sheet "普诺赛中文站" --id 427
  *   node process_videos.js --step download
  *   node process_videos.js --dry-run
+ *   node process_videos.js --offset 10 --limit 5   # 跳过前10条，只处理5条
  */
 
 // ============================== 依赖 ==============================
@@ -34,7 +35,7 @@ dotenv.config({ path: _dotenvPath });
 // ============================== 路径配置 ==============================
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
-const BASE_DIR = path.resolve(__dirname);
+const BASE_DIR = process.cwd();
 
 function envPath(key, defaultValue) {
   const val = process.env[key] || defaultValue;
@@ -1763,6 +1764,7 @@ async function run({
   targetSheet, targetId, steps, maxRetries, retryDelay,
   concurrency, force, dryRun, retryFailed,
   downloadTimeout, transcodeTimeout, transcribeTimeout, analyzeTimeout,
+  offset = 0, rowLimit = 0,
 }) {
   // ── 重跑失败模式 ──
   if (retryFailed) {
@@ -1772,7 +1774,7 @@ async function run({
 
   // ── 构建任务列表 ──
   const sheets = targetSheet ? [targetSheet] : VIDEO_SHEETS;
-  const tasks = [];
+  let tasks = [];
   for (const sheetName of sheets) {
     let rows = readExcelSheet(sheetName);
     if (targetId) {
@@ -1796,6 +1798,15 @@ async function run({
     }
   }
 
+  // ── 偏移/限量（全局，跨 sheet） ──
+  if (offset > 0 || rowLimit > 0) {
+    const start = offset;
+    const end = rowLimit > 0 ? start + rowLimit : undefined;
+    const originalLen = tasks.length;
+    tasks = tasks.slice(start, end);
+    logInfo(`applied offset=${start}, limit=${rowLimit || 'all'} → tasks: ${originalLen} → ${tasks.length}`);
+  }
+
   logInfo(`tasks: ${tasks.length}, concurrency: ${concurrency}, max retries: ${maxRetries}`);
 
   const envCheck = await checkEnvironmentAsync(steps);
@@ -2069,6 +2080,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('--step <step>', '指定执行步骤（可多次指定），如 --step transcode --step transcribe', (val, prev) => {
       const allowed = ['download', 'transcode', 'transcribe', 'analyze'];
       if (!allowed.includes(val)) {
@@ -2359,6 +2372,8 @@ if (process.argv[1] === __filename || process.argv[1]?.endsWith('process_videos.
     targetSheet: opts.sheet || null,
     targetId: opts.id || null,
     steps,
+    offset: opts.offset || 0,
+    rowLimit: opts.limit || 0,
     maxRetries: opts.retry,
     retryDelay: opts.retryDelay,
     concurrency: opts.concurrency,