@lingjingai/scriptctl 0.63.3 → 0.63.5

package/README.md

@@ -55,7 +55,9 @@ Gemini 接收左侧带时间戳、行锚点的亚洲格式剧本正文，以及
 - **漏台词**：记录 ASR 原话、时间范围、邻近位置和理由，不直接插入 ASR 文本。随后对应集 Agent 收到清单和切好的看片窗口，逐项 `watch` 核对原片后修复并记录 finding。每处线索按窗口数增加看片预算，长句拆成不超过 15 秒的窗口。
 - **无法可靠对应**：保留原样，把具体说明交给 Agent。服务请求失败、无效响应或非法修正目标记为本集失败，继续后续集；失败集不应用对比方案、不启动本集 Agent。已完成集的修改保留，失败清单在 `episode` 事件及最终统计中体现。
 
-剧本旁 `.review/asr/episode-N/` 保存按音频 SHA-256 复用的成功 ASR 响应，以及每次对比的 `script.txt`、`asr.txt`、`prompt.txt`、`gemini-response.json` 和 `report.json`（含前后时间、台词、缺漏线索）。当前剧本每次重新对比，不缓存对比结论。
+剧本旁 `.review/asr/episode-N/` 保存按音频 SHA-256 复用的成功 ASR 响应，以及每次对比的 `script.txt`、`asr.txt`、`prompt.txt`、逐模型逐次响应和 `report.json`（含前后时间、台词、缺漏线索）。当前剧本每次重新对比，不缓存对比结论。
+
+审核 Agent、ASR 文本比对和原片视频核对均使用所选 Gemini → 其余 3.8 / 3.7 / 3.6 Flash → 豆包的恢复顺序。Gemini 沿用 provider 的 `maxAttempts`，豆包最多尝试三次；明确内容过滤进入下一模型。Mastra 在当前模型调用内切换，已执行成功的工具不重放。豆包使用 `ARK_API_KEY`，端点可通过 `ARK_MODEL` 指定。
 
 `asr-started` / `asr-transcribed` / `asr-compared` NDJSON 按集报告进度与证据；`asr-compared` 不代表修改已落盘，带 `episode_number` 的 `asr-applied` 表示本集校时已经保存。之后的 `episode` 报告本集完成或失败，已有修改已保存；`done.statistics.fixed` 包含自动校时条数，`usage_total` 汇总对比与审核 Gemini 用量。
 
@@ -136,7 +138,7 @@ MIT
 
 ### 指定视频理解服务
 
-Gemini 文本、结构化工具和视频请求在当前路由重试耗尽或被审核拦截后，由已配置的豆包兜底。视频的默认路由与显式指定的 Gemini 均保留所选主模型；视频上传失败时豆包读取同一份本地文件。用户取消不触发兜底。豆包使用 `ARK_API_KEY`，`ARK_MODEL` 可指定已开通的视频理解端点，默认 `ep-20260721150136-98dj9`。直接选择豆包时只调用豆包：
+Gemini 文本、结构化工具和视频请求先使用配置的主模型，再按 `gemini-3.8-flash → gemini-3.7-flash → gemini-3.6-flash` 尝试尚未调用的模型，全部失败后使用豆包。每个 Gemini 模型按 provider 的 `maxAttempts` 重试暂时性错误，豆包最多尝试 3 次；审核拒绝等不可重试错误直接进入下一模型，用户取消立即停止。切换 Gemini 模型保留服务地址、凭据和同一份视频；公共 Files API 上传重试耗尽时，由豆包读取本地视频。豆包使用 `ARK_API_KEY`，`ARK_MODEL` 可指定已开通的视频理解端点，默认 `ep-20260721150136-98dj9`。完整模型链耗尽后才汇总报错，调用和用量逐模型记录。直接选择豆包时只调用豆包：
 
 ```bash
 # 豆包：默认读取 ARK_API_KEY；模型也可通过 ARK_MODEL 设置

package/changes/0.63.4.md

@@ -0,0 +1,5 @@
+# 0.63.4
+
+- Gemini 文本、结构化工具和视频请求先使用所选模型，再按 3.8 Flash → 3.7 Flash → 3.6 Flash 补齐尚未尝试的模型，最后由豆包兜底。
+- 每个 Gemini 模型独立执行配置的暂时性错误重试，豆包保留最多 3 次尝试；完整模型链耗尽后汇总报错，取消立即停止。
+- 复用 Gemini 视频媒体与已有分集检查点，保留各模型的实际用量、重试次数和失败原因。

package/changes/0.63.5.md

@@ -0,0 +1,6 @@
+# 0.63.5
+
+- `review` 的逐集与全局 Agent、ASR 文本比对、原视频核对统一执行所选 Gemini → 其余 3.8 / 3.7 / 3.6 Flash → 豆包模型链，各模型使用有限重试。
+- Gemini 以 HTTP 200 返回内容过滤时也进入下一模型，避免将空响应当作审核完成。
+- Agent 在当前模型调用内切换，保留已成功的工具执行；视频核对复用同一段原片，ASR 比对保存逐模型响应及用量。
+- 审核沿用所选 provider 的地址、凭据与重试预算；豆包使用 `ARK_API_KEY` 和 `ARK_MODEL`，最多尝试三次。

package/dist/bin.js

@@ -7802,6 +7802,7 @@ var DOUBAO_FALLBACK = {
   timeoutMs: 6e5,
   maxAttempts: 3
 };
+var GEMINI_FLASH_MODELS = ["gemini-3.8-flash", "gemini-3.7-flash", "gemini-3.6-flash"];
 function normalizeBaseUrl(value) {
   return value?.trim().replace(/\/+$/, "") ?? "anthropic-sdk-default";
 }
@@ -7842,9 +7843,9 @@ function routedFailure(error, route) {
     message: error.message
   });
 }
-function fallbackFailure(primary, error, route) {
-  const failures = [primary, routedFailure(error, route)];
-  const aggregate = aggregateFailures(failures, "Primary model and Doubao fallback both failed.");
+function exhaustedFailure(error, failures) {
+  if (failures.length === 1) return error;
+  const aggregate = aggregateFailures(failures, "All configured model routes failed.");
   return new LlmTransportError(error.code, aggregate.message, {
     retryable: aggregate.retryable,
     classification: classificationOf(aggregate),
@@ -7856,6 +7857,19 @@ function fallbackFailure(primary, error, route) {
 function isGeminiRoute(route) {
   return route.protocol === "google-gemini" || /(^|\/)gemini-/i.test(route.model);
 }
+function geminiRoutes(primary) {
+  const prefix = primary.info.model.slice(0, primary.info.model.lastIndexOf("/") + 1);
+  const models = /* @__PURE__ */ new Set([primary.info.model, ...GEMINI_FLASH_MODELS.map((model) => prefix + model)]);
+  return [...models].map((model) => {
+    if (model === primary.info.model) return primary;
+    const modelConfig = { ...primary.modelConfig, model };
+    return {
+      ...primary,
+      modelConfig,
+      info: { ...primary.info, model, fingerprint: routeFingerprint(primary.info.task, primary.providerConfig, modelConfig) }
+    };
+  });
+}
 function canFallback(error, signal) {
   return !signal?.aborted && error instanceof LlmTransportError && error.code !== "cancelled";
 }
@@ -8162,25 +8176,43 @@ var ModelRouter = class {
       generate: async (request2) => {
         request2.signal?.throwIfAborted();
         if (request2.media.kind === "local-fallback") {
-          return this.generateDoubaoVideo(task, request2, request2.media.primaryFailure);
+          return this.generateDoubaoVideo(task, request2, [request2.media.primaryFailure]);
         }
-        try {
-          return await this.tracked(route.info, () => adapter.generate({ ...request2, maxOutputTokens: spec2.maxOutputTokens }));
-        } catch (error) {
-          if (!canFallback(error, request2.signal) || !this.doubaoAdapter() || !request2.localPath) throw error;
-          return this.generateDoubaoVideo(task, request2, routedFailure(error, route.info));
+        const routes = geminiRoutes(route);
+        const failures = [];
+        for (const [index, candidate] of routes.entries()) {
+          request2.signal?.throwIfAborted();
+          try {
+            return await this.tracked(candidate.info, () => this.videoAdapter(candidate).generate({
+              ...request2,
+              maxOutputTokens: spec2.maxOutputTokens
+            }));
+          } catch (error) {
+            if (!canFallback(error, request2.signal)) throw error;
+            const failure = routedFailure(error, candidate.info);
+            failures.push(failure);
+            const next = routes[index + 1];
+            if (next) {
+              process.stderr.write(`\u21AA\uFE0F  ${candidate.info.model} \u8BF7\u6C42\u5931\u8D25\uFF0C\u5207\u6362\u5230 ${next.info.model} (${formatFailure(failure)})
+`);
+              continue;
+            }
+            if (!this.doubaoAdapter() || !request2.localPath) throw exhaustedFailure(error, failures);
+            return this.generateDoubaoVideo(task, request2, failures);
+          }
         }
+        throw new Error("Gemini model routes cannot be empty.");
       }
     };
   }
-  async generateDoubaoVideo(task, request2, primary) {
+  async generateDoubaoVideo(task, request2, failures) {
     const adapter = this.doubaoAdapter();
     if (!adapter) throw credentialError("doubao");
     const localPath = request2.media.kind === "local-fallback" ? request2.media.path : request2.localPath;
     if (!localPath) throw configRuntimeError("Doubao video fallback requires the local video.", ["localPath"], ["localPath: missing"]);
     const localMime = request2.localMime ?? (request2.media.kind === "file-api" ? request2.media.file.mimeType : request2.media.mimeType);
     const route = this.doubaoRoute(task);
-    process.stderr.write(`\u21AA\uFE0F  ${primary.model} \u8BF7\u6C42\u5931\u8D25\uFF0C\u56DE\u9000\u5230\u8C46\u5305 ${route.model} (${formatFailure(primary)})
+    process.stderr.write(`\u21AA\uFE0F  Gemini \u8DEF\u7531\u5DF2\u8017\u5C3D\uFF0C\u56DE\u9000\u5230\u8C46\u5305 ${route.model}
 `);
     try {
       return await this.tracked(route, () => adapter.run({
@@ -8195,7 +8227,7 @@ var ModelRouter = class {
       }));
     } catch (error) {
       if (!canFallback(error, request2.signal)) throw error;
-      throw fallbackFailure(primary, error, route);
+      throw exhaustedFailure(error, [...failures, routedFailure(error, route)]);
     }
   }
   // Resolve the default fallback or explicitly selected Doubao video.
@@ -8224,24 +8256,38 @@ var ModelRouter = class {
   }
   async withTextFallback(task, signal, generate) {
     const route = this.resolve(task);
-    const adapter = this.adapter(route);
-    try {
-      return await this.tracked(route.info, () => generate(adapter));
-    } catch (error) {
-      if (!canFallback(error, signal) || !isGeminiRoute(route.info) && error.code !== "content_filtered") throw error;
-      const doubao = this.doubaoTextAdapter();
-      if (!doubao) throw error;
-      const primary = routedFailure(error, route.info);
-      const fallback = this.doubaoRoute(task);
-      process.stderr.write(`\u21AA\uFE0F  ${route.info.model} \u8BF7\u6C42\u5931\u8D25\uFF0C\u56DE\u9000\u5230\u8C46\u5305 ${fallback.model} (${formatFailure(primary)})
-`);
+    const gemini = isGeminiRoute(route.info);
+    const routes = gemini ? geminiRoutes(route) : [route];
+    const failures = [];
+    for (const [index, candidate] of routes.entries()) {
+      signal?.throwIfAborted();
+      const adapter = this.adapter(candidate);
       try {
-        return await this.tracked(fallback, () => generate(doubao));
-      } catch (fallbackError) {
-        if (!canFallback(fallbackError, signal)) throw fallbackError;
-        throw fallbackFailure(primary, fallbackError, fallback);
+        return await this.tracked(candidate.info, () => generate(adapter));
+      } catch (error) {
+        if (!canFallback(error, signal) || !gemini && error.code !== "content_filtered") throw error;
+        const failure = routedFailure(error, candidate.info);
+        failures.push(failure);
+        const next = routes[index + 1];
+        if (next) {
+          process.stderr.write(`\u21AA\uFE0F  ${candidate.info.model} \u8BF7\u6C42\u5931\u8D25\uFF0C\u5207\u6362\u5230 ${next.info.model} (${formatFailure(failure)})
+`);
+          continue;
+        }
+        const doubao = this.doubaoTextAdapter();
+        if (!doubao) throw exhaustedFailure(error, failures);
+        const fallback = this.doubaoRoute(task);
+        process.stderr.write(`\u21AA\uFE0F  \u4E3B\u6A21\u578B\u8DEF\u7531\u5DF2\u8017\u5C3D\uFF0C\u56DE\u9000\u5230\u8C46\u5305 ${fallback.model}
+`);
+        try {
+          return await this.tracked(fallback, () => generate(doubao));
+        } catch (fallbackError) {
+          if (!canFallback(fallbackError, signal)) throw fallbackError;
+          throw exhaustedFailure(fallbackError, [...failures, routedFailure(fallbackError, fallback)]);
+        }
       }
     }
+    throw new Error("Text model routes cannot be empty.");
   }
   async generateText(task, request2) {
     const spec2 = LLM_TASK_REGISTRY[task];
@@ -8594,7 +8640,7 @@ function resolveProfile(llm2, override) {
       data: { expected: [provider.apiKeyEnv], actual: ["<empty>"] }
     });
   }
-  return { provider: model.provider, model: model.model, baseUrl: provider.baseUrl, apiKey };
+  return { provider: model.provider, model: model.model, baseUrl: provider.baseUrl, apiKey, maxAttempts: provider.maxAttempts };
 }
 async function loadAgent() {
   const here = path13.dirname(fileURLToPath3(import.meta.url));
@@ -8696,6 +8742,7 @@ async function commandReview(opts) {
       converge: opts["converge"] !== false,
       convergeOnly: opts["converge_only"] === true,
       apiKey: profile.apiKey,
+      maxAttempts: profile.maxAttempts,
       model: profile.model,
       mediaModel: profile.model,
       ...profile.baseUrl ? { baseUrl: profile.baseUrl } : {},