治控手册：让持续演化的智能体治控可读、可导航、可编辑

现代AI智能体的能力不仅取决于基础模型，还取决于其治控（harness）——构建提示、管理状态、调用工具并协调执行的部分。随着模型、API、环境与需求演化，治控必须持续修改。在做这种修改之前，开发者或编码智能体必须识别实现目标行为的全部代码位置。这很困难：生产治控庞大、紧耦合且行为分布化，而修改请求描述的是系统应做什么、仓库却按文件与模块组织。代码搜索、仓库索引与长上下文处理减轻检查负担，但仍把行为到代码的映射留给手工恢复。行为定位因此是治控演化的中心瓶颈。我们提出治控手册（Harness Handbook）：一个经静态分析与LLM辅助结构化从治控代码库自动合成的、以行为为中心的表示——把每个行为链接到对应源码。我们还提出行为引导的渐进披露（BGPD）：引导智能体从高层行为走向相关实现细节，并对照当前源码验证候选位置。在来自两个开源治控的多样修改请求上：手册辅助的规划改善行为定位与编辑计划质量，同时使用更少的规划器token——增益在分散位点、罕执行路径与跨模块交互上最大。演化复杂智能体系统因此不仅取决于生成编辑，也取决于确定编辑应落在何处。