用途:tao-context-mode 面向需要代码库感知但又要控制上下文窗口占用的场景。它采用“构建/展开”模式:调用方先消费紧凑的 CodebaseIndex(路径 + 摘要 + 符号)作为工作上下文,只对当前任务真正需要的文件调用 expand() 展开完整内容。
主要能力:build_index 遍历仓库生成索引;expand 按路径展开完整文件;stats 返回 files_indexed、bytes_indexed、expansions、hit_rate 等统计。摘要为算法生成,每个源文件约 200B,而原始文件为 5-50KB。
使用方式:从 app.server.tao_context_mode 导入 build_index、expand、stats;调用 build_index(Path("/repo")) 建立索引,再用 expand(index, "app/server/main.py") 展开文件,stats(index) 查看统计。验证脚本为 python scripts/validate_tao_context_mode.py --repo-root .,与 vcc 基线(RA-1967 确定性压缩器)对比,而非原始 harness;董事会备忘阈值为相对 vcc 中位数额外减少 ≥40%,2026-05-05 裁决未达标为 WATCH 而非 REJECT。
适用场景:TAO 会话启动时规划器需要代码库感知;新一轮 tao-loop 迭代开始且 autoresearch 视角提示 tokens/turn 上升;代理被问“X 在哪里”时先做低成本查找。
限制:不做语义摘要或基于 LLM 的文件概要(刻意保持算法化);不支持跨仓库或跨会话索引(每个仓库一个 CodebaseIndex,内存中);无运行时失效机制,sha256 漂移仅记录警告,需重新运行 build_index 刷新。