svharness 0.15.10 → 0.15.13

package/README.md

@@ -38,6 +38,10 @@ svharness build --config svharness.config.yaml --yes
 # 全自动模式 —— 资料整理 → 构建 → 审查 → 优化，支持断点续跑
 svharness auto --work-dir . --auto-approve -y
 
+# 需求包专项 —— 在 requirements 资料目录直接运行（推荐）
+cd ./requirements && svharness auto_pack_req --yes
+# 或指定资料包根：svharness auto_pack_req ./req-pack --yes
+
 # 一行式 —— 跳过交互，直接生成
 svharness build --harness-name my-app --arch android-compose --agent qoder --yes
 
@@ -65,6 +69,8 @@ svharness start-agent --work-dir .
 
 **`svharness auto`**：无人值守构建入口。工作目录可以是已有 `<name>-harness/`（从 `.harness-build-state.yaml` 断点续跑），也可以是资料包根（自动检测 `baseline/`、`requirements/`、`references/`、`extra-skills/` 后先执行 build）。配置示例见 `auto/templates/auto.config.example.yaml`。
 
+**`svharness auto_pack_req`**：需求包专项入口（独立于 `auto`）。**无参数时默认把当前目录当作工作目录**；若当前目录本身是 requirements 资料夹（含 doc/md/pdf 等，目录名任意），则自动视为输入并在**上级目录**创建 harness。也支持传入资料包根（含 `requirements/` 子目录）或已有 harness 根。仅执行 S30 + S40，三维度质量闭环直到综合分 **严格大于** 9.5。配置示例见 `auto/templates/auto-pack-req.config.example.yaml`（`auto_pack_req:` 节）。详细设计见 [`auto/auto-harness-detail-design.md` §2.2.1](./auto/auto-harness-detail-design.md#221-svharness-auto_pack_req-需求包专项)。
+
 生成完成后，在你的 Agent IDE 中说：
 - "运行 harness-build-skills-main"或"harness-build-skill-orchestrator"即可开始逐步填充内容；
 - 构建完成后在目标项目中说"应用 harness-apply-skills-main 完成 xxx 功能开发"即可调用 harness。
@@ -234,6 +240,8 @@ svharness wizard
 | `convert` | 对应 `svharness convert` |
 | `doctor` | 对应 `svharness doctor` |
 | `wiki` | 对应 `svharness wiki` |
+| `auto` | 对应 `svharness auto` |
+| `auto_pack_req` | 对应 `svharness auto_pack_req`（需求包 S40 专项） |
 
 `build` 节除路径外，可写人类可读说明（仅写入配置文件，供团队阅读）：
 
@@ -289,7 +297,7 @@ svharness build \
 | `--convert-endpoint <url>` | 可选 | build 自动 convert 使用的 markitdown 服务基址（支持逗号分隔 failover）；省略时读 `SVHARNESS_MARKITDOWN_ENDPOINT` | `http://markitdown.desaysz.site` |
 | `--convert-concurrency <n>` | 可选 | build 自动 convert 并发上传数 | `3` |
 | `--convert-max-file-mb <n>` | 可选 | build 自动 convert 单文件大小上限（MB） | `50` |
-| `--convert-timeout-sec <n>` | 可选 | build 自动 convert 请求超时秒数 | `120` |
+| `--convert-timeout-sec <n>` | 可选 | build 自动 convert 请求超时秒数 | `900`（15 分钟） |
 | `--convert-force` | 可选 flag | build 自动 convert 覆盖同名 `.md`（否则按 `-1/-2` 追加） | `false` |
 | `--force` | 可选 flag | 覆写已存在的 harness 目录；同时允许覆盖已注入的 build skills/rules 与项目根 `AGENTS.md` / `CLAUDE.md`（默认遇到已存在文件会跳过） | `false` |
 | `-y, --yes` | 可选 flag | 跳过所有提示，采用默认值 | `false` |
@@ -540,7 +548,7 @@ svharness convert --verbose --yes
 | `--endpoint <url>` | 云端 `markitdown_serve` 基址；**逗号分隔**可配置 failover；省略时读 `SVHARNESS_MARKITDOWN_ENDPOINT` | `http://markitdown.desaysz.site` |
 | `--concurrency <n>` | 并发上传数 | `3` |
 | `--max-file-mb <n>` | 单文件大小上限（MB），本地 + 服务端双重限流 | `50` |
-| `--timeout-sec <n>` | 单请求超时秒数 | `120`（2 分钟） |
+| `--timeout-sec <n>` | 单请求超时秒数 | `900`（15 分钟） |
 | `--type <type>` | 目标子目录：`requirements`（正式需求）\| `references`（参考资料） | `requirements` |
 | `--force` | flag，覆盖已存在同名 `.md`（默认自动追加 `-1`、`-2` 后缀） | `false` |
 | `--split-sheets-suffix <suffix>` | xlsx/xls 按 sheet 拆分的子目录后缀 | `_split` |
@@ -586,6 +594,102 @@ convert-failures.json
 
 完整契约、fallback chain、Docker 部署见 [markitdown_serve/README.md](./markitdown_serve/README.md)；模块设计见 [tmp/svharnessbuild-detail-design.md §4.10](../tmp/svharnessbuild-detail-design.md#410-文档转换convert-命令--markitdown_serve-远端服务)。
 
+### `auto` —— 全自动构建 harness（无人值守）
+
+一条命令完成资料整理 → S10~S80 构建 → S85 七维评审 → 优化循环，直到综合分 ≥ 目标分后 S90 封存。
+
+```bash
+svharness auto [workdir] [options]
+```
+
+工作目录可以是已有 `<name>-harness/`（断点续跑），也可以是资料包根（自动检测后先 build）。
+
+| 参数 | 说明 | 默认值 |
+|------|------|--------|
+| `--work-dir <path>` | 工作目录 | 当前目录 |
+| `--config <path>` | 配置文件（`auto:` 节） | `svharness.config.yaml` |
+| `--target-score <score>` | 目标综合评分 | `9.5` |
+| `--max-optimize-rounds <n>` | 最大优化轮数 | `10` |
+| `--max-phase <phase>` | 只运行到此阶段即停止（如 `S40` 会跳过评审） | — |
+| `--auto-approve` / `-y, --yes` | 无人值守 | `autoApprove` 默认 `true` |
+| `--dry-run` | 打印 prompt，不调用 Agent | `false` |
+
+配置示例：`auto/templates/auto.config.example.yaml`
+
+### `auto_pack_req` —— 需求包全自动条目化（S40 专项）
+
+独立于 `auto`，专门用于需求文档条目化 + 质量闭环，**不污染**完整 harness 构建流程。
+
+```bash
+# 推荐：在 requirements 资料目录直接运行（目录名任意）
+cd ./requirements
+svharness auto_pack_req --yes
+
+# 或指定资料包根 / harness 根
+svharness auto_pack_req [workdir] [options]
+```
+
+**工作目录解析**（`[workdir]` 可省略，默认当前目录）：
+
+| 当前/指定目录 | 行为 |
+|---------------|------|
+| 本身是 requirements 资料夹（含文档文件，目录名任意） | 视为 `--requirements` 输入，在**上级目录**创建 `<name>-harness/` |
+| 资料包根（含 `requirements/` 等子目录） | 在目录内自动检测并创建 harness |
+| 已有 harness 根（或恰好一个 `*-harness/`） | 重置 S40，重做条目化 |
+| 多个 `*-harness/` | 报错，须显式指定路径 |
+
+**内置默认**：`targetScore=9.5`（须**严格大于**）、`maxOptimizeRounds=10`、`sampleCount=7`、`autoApprove=true`、`yes=true`
+
+**评分模型**：
+
+```
+综合分 = 机械门禁 × 0.40 + 对抗验证 × 0.30 + 抽样验证 × 0.30
+```
+
+| 维度 | 权重 | 说明 |
+|------|------|------|
+| 机械门禁 | 40% | `verify --strict` + `doctor --mode requirements --strict` 全通过；任一失败机械分=0 |
+| 对抗验证 | 30% | 独立 Reviewer Agent 逐 block 挑刺（禁止读 Builder 自评） |
+| 抽样验证 | 30% | 从 `requirements/md` 随机抽 N 片段，反向追溯 yaml 产物是否可支撑开发 |
+
+**通过条件**（AND）：`综合分 > targetScore` + 硬门禁全通过 + `critical_count=0`
+
+**两种入口**：
+
+| 模式 | 检测条件 | 行为 |
+|------|----------|------|
+| 资料包新建 | 无 `harness.yaml` | `runMaterialsPrepAndBuild` → S30+S40 |
+| 已有 harness 重做 | 存在 `harness.yaml` | 重置 `S40=PENDING` → 只跑 S40 |
+
+**主要参数**：
+
+| 参数 | 说明 | 默认值 |
+|------|------|--------|
+| `--requirements <path>` | 需求文档路径 | 自动检测 |
+| `--target-score <score>` | 目标综合评分（须严格大于） | `9.5` |
+| `--max-optimize-rounds <n>` | 最大优化轮数 | `10` |
+| `--sample-count <n>` | 抽样验证片段数 | `7` |
+| `--config <path>` | 配置文件（`auto_pack_req:` 节） | — |
+| `--dry-run` | 打印 S40 + 三维度评审 prompt | `false` |
+
+**典型用法**：
+
+```bash
+cd ./requirements && svharness auto_pack_req --yes
+svharness auto_pack_req ./req-pack --yes
+svharness auto_pack_req ./my-app-harness --requirements ./docs --yes
+svharness auto_pack_req --config auto-pack-req.config.yaml --dry-run
+```
+
+**产物**（不执行 S90）：
+
+- `requirements/yaml/*.yaml`、`requirements/coverage-report.yaml`
+- `auto-review/第N轮需求自评报告.md`、`第N轮对抗评审.md`、`第N轮抽样验证报告.md`
+- `auto-review/auto-score.json`、`auto-review/pack-req-complete.json`
+
+配置示例：`auto/templates/auto-pack-req.config.example.yaml`  
+详细设计：[`auto/auto-harness-detail-design.md` §2.2.1](./auto/auto-harness-detail-design.md#221-svharness-auto_pack_req-需求包专项)
+
 ### `wiki` —— 对任意代码工程生成 baseline wiki（v0.15+）
 
 独立子命令，**不依赖 harness 生命周期**，直接对任意代码工程目录就地扫描生成 wiki。与 `build` 内置 wiki 共用同一 repowiki 核心，但不拷贝 code、不创建 harness 骨架。

package/auto/auto-harness-detail-design.md

@@ -1,10 +1,10 @@
 # auto-harness 详细设计方案
 
-> **文档定位**：`svharness auto` 模式的完整设计书，面向本系统的开发者与维护者。  
+> **文档定位**：`svharness auto` 与 `svharness auto_pack_req` 模式的完整设计书，面向本系统的开发者与维护者。  
 > **上级文档**：`svharnessbuild/README.md`（CLI 总体规范）、`svharnessbuild/tmp/svharnessbuild-detail-design.md`（SDD）。  
 > **参照工程**：[snarktank/ralph](https://github.com/snarktank/ralph)（外循环思路）。  
-> **版本**：v2.5（2026-06-16，新增 Web 仪表盘、默认标志优化、优化容错）  
-> **最后更新**：2026-06-16
+> **版本**：v2.6（2026-06-26，任意错误不中断 + CostTracker 超限兜底优化）  
+> **最后更新**：2026-06-26
 
 ---
 
@@ -309,6 +309,105 @@ async function resolveHarnessRoot(workDir: string): Promise<string | null> {
 
 > `harness.yaml` 通常位于 `<work-dir>/<name>-harness/harness.yaml`，而非项目根直接子级。`--work-dir` 可指向资料包根或 harness 根；Orchestrator 先执行上述解析再进入主循环。
 
+### 2.2.1 `svharness auto_pack_req` — 需求包专项
+
+> **定位**：独立于 `svharness auto` 的 preset 命令，内部固定 `scope=requirements`，不暴露 `--scope` CLI 参数。复用 `AutoOrchestrator` + `PhaseRunner`，不新建 orchestrator 类。
+
+#### 命令形态
+
+```bash
+# 推荐：在 requirements 资料目录直接运行（目录名任意）
+cd ./requirements && svharness auto_pack_req --yes
+
+# 或指定资料包根 / harness 根
+svharness auto_pack_req [workdir] [options]
+```
+
+实现入口：`src/commands/auto-pack-req.ts` → `resolveAutoPackReqWorkContext()` → 注入 preset opts → 调用 `runAuto()`。
+
+#### 工作目录解析（`[workdir]` 可省略）
+
+无参数时默认 `process.cwd()`，按以下优先级识别：
+
+| 当前目录 | 行为 |
+|----------|------|
+| harness 根（或恰好一个 `*-harness/`） | 重置 S40，重做条目化 |
+| 资料包根（含 `requirements/`、`baseline/` 等子目录） | 在目录内自动检测并 `build` |
+| **requirements 资料夹**（含 doc/md/pdf 等，**目录名任意**） | 将当前目录固定为 `--requirements` 输入，在**上级目录**创建 `<name>-harness/` |
+| 其它 | 按资料包根处理（与 `auto` 一致） |
+
+示例：在 `req-pack/requirements/` 内执行 `svharness auto_pack_req --yes`，等价于在 `req-pack/` 执行并指定 `--requirements ./requirements`。
+
+#### 内置默认（可被 CLI / 配置覆盖）
+
+| 参数 | 默认值 |
+|------|--------|
+| `scope` | `requirements`（内部固定） |
+| `targetScore` | `9.5`（通过条件为**严格大于**） |
+| `maxOptimizeRounds` | `10` |
+| `sampleCount` | `7` |
+| `autoApprove` / `yes` | `true` |
+
+配置文件节：`auto_pack_req:`（示例见 `auto/templates/auto-pack-req.config.example.yaml`）。
+
+#### 两种入口
+
+| 模式 | 检测 | 行为 |
+|------|------|------|
+| 资料包新建 | `resolveHarnessRoot(workDir)` 为 null | `runMaterialsPrepAndBuild` → 仅跑 `S30_convert_docs` + `S40_extract_requirements` |
+| 已有 harness 重做 | 存在 `harness.yaml` | `resetS40ForRerun()` 将 `S40_extract_requirements.status=PENDING`，不动 S50~S90 |
+
+阶段白名单（`SCOPE_PHASES.requirements`）：
+
+```typescript
+['S30_convert_docs', 'S40_extract_requirements']
+```
+
+#### 三维度质量闭环
+
+```
+综合分 = 机械门禁分 × 0.40 + 对抗验证分 × 0.30 + 抽样验证分 × 0.30
+```
+
+| 维度 | 权重 | 实现 |
+|------|------|------|
+| 机械门禁 | 40% | `runMechanicalGates({ scope: 'requirements' })`：`verify --strict` + `doctor --mode requirements --strict`；任一失败机械分=0 |
+| 对抗验证 | 30% | ACP + `S40-adversarial-review.md`；禁止读 Builder 自评报告 |
+| 抽样验证 | 30% | `auto-sample-trace.ts` 生成 `sample-fragments.json` + ACP + `S40-sample-trace.md` 反向追溯 |
+
+每轮评审流程（`runReqPackReview`）：
+
+1. 机械门禁
+2. `writeSampleFragmentsFile()` — 从 `requirements/md` 随机抽 N 片段
+3. Builder 自评 — `S40-review.md`（产出 gap 表供优化，**不计入**综合分权重）
+4. 对抗验证 — `S40-adversarial-review.md`
+5. 抽样验证 — `S40-sample-trace.md`
+6. `computeReqPackScore()` 加权 → 写 `auto-review/auto-score.json`
+
+**通过条件**（AND）：
+
+- `composite_score > targetScore`
+- `gate_pass === true`（verify=0、doctor=0、critical=0）
+- 不执行 `finalizeAutoHarness`（S90）；改为写 `auto-review/pack-req-complete.json`
+
+#### 优化循环 scope 隔离
+
+- `SCOPE_ALLOWED_PHASES.requirements` 仅含 `S40_extract_requirements`
+- `invalidateDownstream` 在 requirements scope 下**不调用**（避免 S50+ 标 OUTDATED）
+- 优化 prompt 仍复用 `optimize-plan.md` / `optimize-implement.md`
+
+#### 关键文件
+
+| 类型 | 路径 |
+|------|------|
+| CLI 入口 | `src/commands/auto-pack-req.ts` |
+| 三维度评审 | `src/lib/auto-req-pack-review.ts` |
+| 抽样生成 | `src/lib/auto-sample-trace.ts` |
+| 评分公式 | `src/lib/score-aggregator.ts` → `computeReqPackScore` |
+| 完成标记 | `src/lib/auto-pack-req-finalize.ts` |
+| Prompt | `auto/templates/phase-prompts/S40-review.md` 等 |
+| Rubric | `auto/templates/requirements-review-rubric.yaml` |
+
 ### 2.3 典型运行输出
 
 ```
@@ -391,7 +490,7 @@ program
   .option('--no-force',              '禁用自动 force（目标目录存在时不覆盖）')
   // === 质量与流程控制 ===
   .option('--target-score <score>',  '目标综合评分（默认 9.5）', '9.5')
-  .option('--max-optimize-rounds <n>','最大优化轮数（默认 5）', '5')
+  .option('--max-optimize-rounds <n>','最大优化轮数（默认 10）', '10')
   .option('--checkpoint <phase>',    '到达此阶段前暂停等待人工确认（如 S85）')
   .option('--max-phase <phase>',     '只运行到此阶段即停止（调试用）')
   .option('--dry-run',               '打印各阶段 prompt 和命令，不实际执行')
@@ -399,9 +498,10 @@ program
   .option('-y, --yes',               '跳过所有交互确认（推荐无人值守）')
   .option('--verbose',               '详细日志')
   // === 成本控制 ===
-  .option('--max-total-calls <n>',   '总 ACP 调用次数上限（含重试和优化），超出即冻结', '30')
+  .option('--max-total-calls <n>',   '总 ACP 调用次数上限（含重试和优化），超出即冻结', '100')
   .option('--budget-usd <amount>',   '费用预算上限（USD），超出暂停等待确认')
   .option('--cost-alert <amount>',   '单次调用费用告警阈值（USD）', '5')
+  .option('--no-auto-repair',        '禁用阶段失败自动修复（默认启用）')
   .action(runAuto);
 ```
 
@@ -440,20 +540,46 @@ class AutoOrchestrator {
     this.ensurePhaseRunnerReady();
 
     // === AGENT-2: 构建 ===
-    await this.runHarnessBuild();              // 驱动 S10→S80 全流程
+    try {
+      await this.runHarnessBuild();              // 驱动 S10→S80 全流程
+    } catch (err) {
+      // v2.6: 构建阶段失败不裸崩溃，先 emit build_failed 事件再终止
+      dashboardEventBus.emitBuildFailed(undefined);
+      throw new Error(`构建阶段失败：${err.message}；auto 构建终止，请在修复后重新执行`);
+    }
 
     // === AGENT-3 + AGENT-4: 审查 + 优化循环 ===
     let round = 0;
     while (round < this.ctx.maxOptimizeRounds) {
       round++;
-      const score = await this.runHarnessReview(round);   // 产出 第<n>评审报告.md
-      if (score.composite_score >= this.ctx.targetScore && score.gate_pass) {
+      let review;
+      try {
+        review = await this.runHarnessReview(round);   // 产出 第<n>评审报告.md
+      } catch (err) {
+        // v2.6: 资源限制（预算/调用次数超限）优雅终止，其他异常继续下一轮
+        if (err.message.includes('预算') || err.message.includes('调用次数') || err.message.includes('ACP 调用')) {
+          logger.error(`评审因资源限制终止：${err.message}`);
+          dashboardEventBus.emitBuildFailed(undefined);
+          throw err;
+        }
+        logger.warn(`评审异常：${err.message}，继续下一轮`);
+        continue;
+      }
+      if (review.composite_score >= this.ctx.targetScore && review.gate_pass) {
         await this.runFinalize();
         break;
       }
       // AGENT-4 两步：先写 第<n>轮修改-plan.md，再实施
-      await this.runOptimizePlan(round, score);
-      await this.runOptimizeImplement(round, score);
+      try {
+        await this.runOptimizePlan(round, score);
+        await this.runOptimizeImplement(round, score);
+      } catch (err) {
+        // v2.6: 资源限制 break，其他异常继续
+        if (err.message.includes('预算') || err.message.includes('次数')) {
+          break;
+        }
+        logger.warn(`第 ${round} 轮优化失败：${err.message}，继续下一轮`);
+      }
     }
   }
 }
@@ -620,13 +746,19 @@ class CostTracker {
   estimatedCostUsd: number;
   phaseCosts: Map<string, number>;
 
+  // v2.6: 80%/95% 预警告警标志（单次触发，不重复）
+  private budget80Warned = false;
+  private budget95Warned = false;
+  private calls80Warned = false;
+  private calls95Warned = false;
+
   constructor(
-    private maxTotalCalls: number,      // 默认 30
+    private maxTotalCalls: number,      // 默认 100（v2.6 从 30 提升）
     private budgetUsd: number | null,   // null = 不限制
     private alertThreshold: number,     // 默认 5 USD
   ) {}
 
-  async recordCall(phase: string, promptTokens: number, outputTokens: number): Promise<void> {
+  recordCall(phase: string, promptTokens = 0, outputTokens = 0): void {
     this.totalCalls++;
     const cost = estimateCost(promptTokens, outputTokens);
     this.estimatedCostUsd += cost;
@@ -635,14 +767,40 @@ class CostTracker {
     if (cost > this.alertThreshold) {
       logger.warn(`[成本] ${phase} 本次约 $${cost.toFixed(2)}，累计 $${this.estimatedCostUsd.toFixed(2)}`);
     }
+
+    // v2.6: 预算 80%/95% 预警告警
+    if (this.budgetUsd !== null) {
+      const usagePct = (this.estimatedCostUsd / this.budgetUsd) * 100;
+      if (usagePct >= 80 && usagePct < 95 && !this.budget80Warned) {
+        this.budget80Warned = true;
+        logger.warn(`[成本] 预算已使用 ${usagePct.toFixed(0)}%（$${this.estimatedCostUsd.toFixed(2)} / $${this.budgetUsd.toFixed(2)}），接近上限`);
+      }
+      if (usagePct >= 95 && !this.budget95Warned) {
+        this.budget95Warned = true;
+        logger.warn(`[成本] 预算已使用 ${usagePct.toFixed(0)}%（$${this.estimatedCostUsd.toFixed(2)} / $${this.budgetUsd.toFixed(2)}），即将达到上限`);
+      }
+    }
+
+    // v2.6: 调用次数 80%/95% 预警告警
+    if (this.maxTotalCalls > 0) {
+      const callsPct = (this.totalCalls / this.maxTotalCalls) * 100;
+      if (callsPct >= 80 && callsPct < 95 && !this.calls80Warned) {
+        this.calls80Warned = true;
+        logger.warn(`[成本] ACP 调用次数 ${this.totalCalls}/${this.maxTotalCalls}（${callsPct.toFixed(0)}%），接近上限`);
+      }
+      if (callsPct >= 95 && !this.calls95Warned) {
+        this.calls95Warned = true;
+        logger.warn(`[成本] ACP 调用次数 ${this.totalCalls}/${this.maxTotalCalls}（${callsPct.toFixed(0)}%），即将达到上限`);
+      }
+    }
+
     if (this.totalCalls >= this.maxTotalCalls) {
-      logger.warn(`[成本] 总调用次数 ${this.totalCalls} 已达上限 ${this.maxTotalCalls}，暂停等待确认`);
-      await enterCheckpoint('max-calls-exceeded');
+      throw new Error(`ACP 调用次数 ${this.totalCalls} 已超过上限 ${this.maxTotalCalls}，累计费用 $${this.estimatedCostUsd.toFixed(2)}`);
     }
     if (this.budgetUsd !== null && this.estimatedCostUsd >= this.budgetUsd) {
-      logger.warn(`[成本] 费用 $${this.estimatedCostUsd.toFixed(2)} 已达预算上限，暂停等待确认`);
-      await enterCheckpoint('budget-exceeded');
+      throw new Error(`ACP 估算费用 $${this.estimatedCostUsd.toFixed(2)} 已超过预算 $${this.budgetUsd.toFixed(2)}（${this.totalCalls} 次调用）`);
     }
+    dashboardEventBus.emitCostUpdated(this.estimatedCostUsd, this.totalCalls);
   }
 
   checkBudget(): 'ok' | 'alert' | 'exceeded';
@@ -650,10 +808,10 @@ class CostTracker {
 }
 ```
 
-**默认建议**（首次运行保守）：
+**默认建议**（v2.6 提升）：
 
-- `--max-total-calls 30`（约 $10–$30 API 成本）
-- `--max-optimize-rounds 2`（大多数场景 2 轮内要么通过要么卡住）
+- `--max-total-calls 100`（约 $30–$100 API 成本，覆盖完整构建+多轮优化）
+- `--max-optimize-rounds 10`（默认值）
 
 ### 4.5 完成标记协议
 
@@ -1265,25 +1423,68 @@ async function rerunOutdatedPhases(
 }
 ```
 
-### 6.4 失败重试策略
+### 6.4 失败重试策略（v2.6 重写）
+
+整个重试循环 + auto-repair + SKIPPED 跳过链，全部在 `PhaseRunner.runPhase()` 内实现。
+
+**流程图**：
+
+```
+for attempt = 0..maxRetriesPerPhase:
+  cost.recordCall()
+  ┌─ try-catch 捕获 CostTracker 异常 ──────────────┐
+  │  acpOk=false → tryResolveFromArtifacts(免费)     │
+  │    ├─ 命中 → DONE (「资源受限产物兜底」) ✅        │
+  │    └─ 未命中 → break 退出循环                    │
+  └─────────────────────────────────────────────────┘
+  ┌─ acpOk=true → ACP 调用 → 状态检查 ─────────────┐
+  │    ├─ 状态 DONE/SKIPPED → return ✅              │
+  │    ├─ 信号兜底 <PHASE_DONE/SKIP> → return ✅      │
+  │    └─ 产物兜底（检查磁盘产物）→ return ✅          │
+  └─────────────────────────────────────────────────┘
+
+重试循环结束后（尝试全部耗尽）：
+  1. emitPhaseFailed
+  2. if (autoRepair !== false):
+       tryAutoRepair() — 再次调 ACP 修复数据
+       ├─ ACP 修复成功 → DONE ✅
+       └─ 修复失败 → 日志警告
+  3. 标记 SKIPPED + writeBuildState → 继续下一阶段 ▶️
+     （不再 throw Error，构建不会中断）
+```
+
+**关键差异**（对比 v2.5）：
+
+| 方面 | v2.5 | v2.6 |
+|------|------|------|
+| retry 耗尽后 | `throw new Error()` | `tryAutoRepair()` + 标记 `SKIPPED` |
+| CostTracker 超限 | 异常穿透 → 进程终止 | try-catch 捕获 → 免费产物兜底 + `break` |
+| 仪表盘事件 | 无 `build_failed` | 新增全链路 `build_failed` 事件 |
+| YAML 写入 | 直接 `writeFile` | `.tmp` + `rename` 原子写入 |
+| 默认调用次数 | 30 | 100 |
+
+**`tryAutoRepair()` 实现**：
 
 ```typescript
-async retryPhase(phase: string, lastResult: AcpResult) {
-  // 分析失败原因
-  const doctorOutput = await runDoctor(this.harnessRoot, phase);
-  const fixPrompt = buildFixPrompt(phase, lastResult.output, doctorOutput);
-  
-  for (let attempt = 1; attempt <= MAX_RETRIES_PER_PHASE; attempt++) {
-    logger.warn(`${phase} 门禁未通过，第 ${attempt} 次修复尝试...`);
-    const retryResult = await this.acp.call({
-      workDir: this.harnessRoot,
-      prompt: fixPrompt
+private async tryAutoRepair(def, harnessRoot, phaseStartTime): Promise<boolean> {
+  try {
+    this.cost.recordCall(def.key + '_repair');
+    const result = await this.acp.call({
+      workDir: harnessRoot,
+      phase: def.key + '_repair',
+      prompt: wrapAcpPrompt(repairPrompt, `<PHASE_DONE>${def.short}</PHASE_DONE>`),
     });
-    const state = await readBuildState(this.harnessRoot);
-    if (state.phases[phase]?.status === 'DONE') return;
+    // 三级兜底：状态检查 → 信号兜底 → 产物兜底
+    const state = await readBuildState(harnessRoot);
+    if (phaseStatus(state, def.key) === 'DONE') return true;
+    const resolved = await this.tryResolveFromSignal(def, harnessRoot, result);
+    if (resolved) return true;
+    const artifactResolved = await this.tryResolveFromArtifacts(def, harnessRoot, result, phaseStartTime);
+    if (artifactResolved) return true;
+    return false;
+  } catch (err) {
+    return false;  // 任何异常不穿透，调用方标记 SKIPPED
   }
-  
-  throw new PhaseFailedError(phase, `超过最大重试次数 ${MAX_RETRIES_PER_PHASE}`);
 }
 ```
 
@@ -2157,7 +2358,7 @@ auto:
   
   # 质量目标
   targetScore: 9.5
-  maxOptimizeRounds: 5
+  maxOptimizeRounds: 10
   mechanicalWeight: 0.30       # 机械指标占综合分比例（默认 30%）
   reviewWeight: 0.70           # 评审 Agent 占综合分比例（默认 70%）
   
@@ -2171,8 +2372,11 @@ auto:
   dashboard: true            # v2.5 新增：启动本地 Web 仪表盘（端口 7879）
   dashboardPort: 7879        # 仪表盘 HTTP 端口
 
+  # v2.6 新增：阶段失败自动修复（默认启用）
+  autoRepair: true           # false 则禁用 ACP 自动修复，阶段失败后直接 SKIPPED
+
   # 成本控制
-  maxTotalCalls: 30
+  maxTotalCalls: 100         # v2.6 从 30 提升（对应约 $30-$100 API 成本）
   budgetUsd: null            # null = 不限制
   costAlertThreshold: 5      # USD，单次调用告警阈值
 
@@ -2180,6 +2384,7 @@ auto:
   acpMode: auto              # auto | sdk | cli-print
   acpTimeoutMs: 1800000      # 30 分钟（v2.4 从 10 分钟提升）
   maxRetriesPerPhase: 2      # 每阶段最大重试次数
+  autoRepair: true           # v2.6
   
   # 构建参数（同 svharness.config.yaml build 节）
   generateWiki: false        # build 时是否直接生成完整 wiki（false = 由 auto 驱动 ACP 生成）
@@ -2627,3 +2832,104 @@ PhaseRunner/AutoOrchestrator/CostTracker
       → broadcast SSE event → 浏览器三面板自动更新
 ```
 
+---
+
+## 附录：v2.6 实现修订记录（2026-06-26）
+
+根据审查与验证反馈，新增任意错误不中断机制与 CostTracker 超限兜底优化：
+
+| # | 文件 | 修订内容 | 类型 | 对应 § |
+|---|------|---------|------|--------|
+| 1 | `src/lib/auto-orchestrator.ts` | **runBuildPhases() try-catch**：初始构建失败时 `logger.error` + `emitBuildFailed` + 带上下文重新抛出 | Bug 修复 | §3.3 |
+| 2 | `src/lib/auto-orchestrator.ts` | **评审阶段 try-catch**：`runHarnessReview()` 单独 try-catch，资源限制优雅终止，其他异常继续下一轮 | 增强 | §3.3 |
+| 3 | `src/lib/auto-orchestrator.ts` | **优化循环 catch break**：CostTracker 超限时 `break` 而非 `continue`，避免下一轮再次触发崩溃 | Bug 修复 | §3.3 |
+| 4 | `src/lib/phase-runner.ts` | **重试耗尽 + auto-repair + SKIPPED**：ACP 重试（默认 3 次）全部耗尽后，先调 `tryAutoRepair()` 尝试 ACP 自动修复数据，修复失败则标记 SKIPPED 并继续下一阶段（不再 `throw Error`） | 新增 | §6.4 |
+| 5 | `src/lib/phase-runner.ts` | **CostTracker 超限兜底**：`cost.recordCall()` 包 try-catch，捕获后走 `else` 分支免费产物兜底 + `break` 退出重试循环；同时修复了 `if(acpOk)` 缺少闭合 brace 导致的代码结构 Bug | Bug 修复 | §6.4 |
+| 6 | `src/lib/phase-runner.ts` | **tryAutoRepair() 方法**：新增 `tryAutoRepair()` 私有方法，调用 ACP agent 诊断修复数据问题，叠加三级 fallback（状态/信号/产物） | 新增 | §6.4 |
+| 7 | `src/lib/auto-state.ts` | **YAML 原子写入**：`writeBuildState()` 改为先写 `.tmp` 再 `fs.rename` 原子替换；`readBuildState()` dedupe 修复路径也统一使用 `.tmp` + `rename` | 增强 | §6.5 |
+| 8 | `src/lib/cost-tracker.ts` | **80%/95% 预警告警**：新增 4 个一次性预警标志，预算/调用次数达到 80% 和 95% 时各触发一次 `logger.warn`；超限 `throw` 附带完整累计费用和调用次数信息 | 增强 | §4.4 |
+| 9 | `src/commands/auto.ts` | **默认值提升**：`maxTotalCalls` 默认 30→100；`autoRepair` 默认 `true` 传入 `AutoContext` | 配置 | §12.1 |
+| 10 | `src/index.ts` | **CLI 选项更新**：`--max-total-calls` 帮助文本更新为默认 100；新增 `--no-auto-repair` 选项 | 配置 | §3.1 |
+| 11 | `src/dashboard/event-bus.ts` | **build_failed 事件**：新增 `'build_failed'` 事件类型和 `emitBuildFailed()` 方法 | 新增 | §15.1 |
+| 12 | `src/dashboard/sse-handler.ts` | **build_failed 状态**：`build_failed` 事件将 `BuildSnapshot.status` 置为 `'failed'` | 增强 | §15.2 |
+| 13 | `src/dashboard/index.ts` | **事件路由**：`build_failed` 注册到事件订阅数组 | 增强 | §15.3 |
+| 14 | `src/dashboard/static/js/app.js` | **前端失败提示**：`build_failed` 处理器在日志面板显示 `❌ 构建失败` | 增强 | §15.5 |
+| 15 | `auto/templates/auto.config.example.yaml` | **示例值更新**：`maxTotalCalls: 100` | 配置 | §12.1 |
+
+### 架构变更
+
+```
+v2.5 → v2.6 关键变更：
+
+PhaseRunner.runPhase() 重试循环
+  ├── 原：cost.recordCall() 裸调用 → 异常穿透 → 进程终止
+  ├── 新：try-catch 捕获 → acpOk=false → else 分支免费产物兜底 → break
+
+  ├── 原：重试耗尽 → throw Error → 构建崩溃
+  └── 新：重试耗尽 → tryAutoRepair() → 修复成功 DONE / 修复失败 SKIPPED ▶️
+
+CostTracker.recordCall()
+  ├── 原：超限直接 throw
+  └── 新：80% → warn | 95% → warn | 100% → throw(含完整累计信息)
+
+auto-state.ts writeBuildState()
+  ├── 原：直接 writeFile
+  └── 新：writeFile(.tmp) → rename(.yaml) 原子写入
+
+仪表盘事件
+  └── 新增 build_failed（event-bus → sse-handler → app.js 全链路）
+```
+
+### 容器对比示意
+
+```
+v2.6 PhaseRunner 重试循环容器边界：
+
+for (attempt = 0; attempt <= maxRetries; attempt++) {   ← 容器：重试循环
+    try { cost.recordCall(); } catch { acpOk=false; }
+    if (acpOk) {
+        // ACP 调用 + 状态检查 + 信号兜底 + 产物兜底
+    } else {
+        // 资源耗尽：免费产物兜底 + break
+    }
+    if (attempt < maxRetries) { ... retry warning ... }
+}                                                         ← 容器闭合
+
+emitPhaseFailed                                           ← 在循环外
+if (autoRepair) { tryAutoRepair(); }                      ← 在循环外
+mark SKIPPED + writeBuildState + continue                 ← 在循环外
+```
+
+---
+
+## 附录：v2.7 实现修订记录（auto_pack_req）
+
+新增 `svharness auto_pack_req` 命令，作为 `auto` 的 preset 包装，专门服务 S40 需求条目化三维度质量闭环。
+
+| # | 文件 | 修订内容 | 类型 |
+|---|------|---------|------|
+| 1 | `src/commands/auto-pack-req.ts` | 新增 preset 入口；已有 harness 时 `resetS40ForRerun` | 新增 |
+| 2 | `src/index.ts` | 注册 `auto_pack_req [workdir]` 子命令 | 新增 |
+| 3 | `src/types/auto-types.ts` | `AutoScope`、`SampleFragment`、`ReqPackScoreSnapshot` 等 | 新增 |
+| 4 | `src/lib/auto-orchestrator.ts` | `scope=requirements` 走 `runReqPackReview` + `finalizeReqPack` | 增强 |
+| 5 | `src/lib/phase-runner.ts` | `SCOPE_PHASES` 白名单 | 增强 |
+| 6 | `src/lib/gate-checker.ts` | requirements scope 使用 `doctor --mode requirements` | 增强 |
+| 7 | `src/lib/score-aggregator.ts` | `computeReqPackScore` 三维度公式 | 新增 |
+| 8 | `src/lib/auto-req-pack-review.ts` | 机械 + 自评 + 对抗 + 抽样评审编排 | 新增 |
+| 9 | `src/lib/auto-sample-trace.ts` | 从 md 随机抽片段写 `sample-fragments.json` | 新增 |
+| 10 | `src/lib/auto-optimize.ts` | requirements scope 仅允许重跑 S40 | 增强 |
+| 11 | `auto/templates/phase-prompts/S40-*.md` | 三维度评审 prompt | 新增 |
+| 12 | `auto/templates/requirements-review-rubric.yaml` | 评审契约 SSOT | 新增 |
+| 13 | `auto/templates/auto-pack-req.config.example.yaml` | 配置示例 | 新增 |
+
+```
+auto_pack_req 与 auto 关系：
+
+svharness auto_pack_req
+  └── runAutoPackReq() 注入 scope=requirements preset
+        └── runAuto() → AutoOrchestrator
+              ├── PhaseRunner（S30+S40 only）
+              ├── runReqPackReview()（三维度）
+              └── finalizeReqPack()（非 S90）
+```
+