---
type: design
node_id: design:batch-tree-build
title: "Spec-2 建树批量并行入口"
date: 2026-07-11
---

# Spec-2 建树批量并行入口

**完整设计**: [2026-07-11-batch-tree-build-design.md](2026-07-11-batch-tree-build-design.md)

- **选定方案**: tools/build_trees.py + scripts/build_trees.sh；两层并发参数（video_concurrency=16 视频级 + api_concurrency=16 全局共享 Semaphore 注入 builder）；repair_trees 惯例的 progress.json 断点续跑与熔断阈值缩放
- **被否方案**: 单一视频级信号量（API 并发不可控 16×16）；仅全局 API 信号量（磁盘 IO 无界）