From 8c9adfd3fa0935bfa5e7db50ba82c0a5d441fb50 Mon Sep 17 00:00:00 2001
From: iomgaa <iomgaaycz@gmail.com>
Date: Sat, 11 Jul 2026 12:13:22 -0400
Subject: [PATCH] =?UTF-8?q?docs(wiki):=20record=20Spec-2=20harness-eval=20?=
 =?UTF-8?q?finding=20(N/A=20=E2=80=94=20pure=20tooling=20addition)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../findings/eval-spec2-batch-tree-build.md   | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 research-wiki/findings/eval-spec2-batch-tree-build.md

diff --git a/research-wiki/findings/eval-spec2-batch-tree-build.md b/research-wiki/findings/eval-spec2-batch-tree-build.md
new file mode 100644
index 0000000..e392ab9
--- /dev/null
+++ b/research-wiki/findings/eval-spec2-batch-tree-build.md
@@ -0,0 +1,30 @@
+---
+id: eval-spec2-batch-tree-build
+title: "Harness 评估: Spec-2 批量并行建树"
+type: finding
+created: 2026-07-11
+tags: [harness-eval, spec-2, batch-tree-build]
+---
+
+## 评估结论：不适用（N/A）
+
+| 字段 | 内容 |
+|------|------|
+| 分支 | `feat/batch-tree-build` |
+| 提交范围 | e9073bf..0290005（7 commits） |
+| 判定 | **N/A — 无可评估指标** |
+
+## 理由
+
+Spec-2 为纯工具层新增，不修改任何推理/搜索/训练路径代码：
+
+- `tools/build_trees.py`（新增）：批量建树编排脚本
+- `scripts/build_trees.sh`（新增）：shell 入口
+- `.env.example`（追加一行）：`TREE_BUILD_API_CONCURRENCY=16`
+- `app/tree/video_builder.py`（最小改动）：`_build_async` 重命名为 `build_async` + 信号量注入，方法体零改动
+
+harness-eval 前置条件（schemas/metrics/harness.db）均不存在，且本 Spec 不影响推理性能指标。
+
+## 算法保真确认
+
+Codex 最终整体审查确认：`build_async` 方法体与原 `_build_async` 完全一致，信号量默认路径保持 `asyncio.Semaphore(self._config.concurrency)`，单视频行为零变化。