工具系统与编排对比分析

1. Claude Code (claude-code-rev)

工具定义位于 src/tools/，执行逻辑核心在 src/services/tools/StreamingToolExecutor.ts。

核心特性：

• 并发安全分组：通过 isConcurrencySafe 属性区分可以并行的工具（如文件读取）和必须排他的工具（如 Shell 命令或文件写入）。
• 级联终止（Cascading Abort）：如果一个 Bash 工具由于依赖关系失败，它会通过 siblingAbortController 触发同组内其他并行任务的终止，防止无效计算。
• 读写锁机制：在 toolOrchestration.ts 中实现了精细的读写分离锁，确保在并行执行期间文件系统状态的一致性。

2. Opencode (opencode)

工具系统位于 packages/opencode/src/tool/，核心管理逻辑在 registry.ts。

核心特性：

• ToolRegistry：基于 Effect 的注册表，工具被视为具备特定权限要求的 Effect。
• 自动截断（Auto-Truncation）：在 truncate.ts 中实现，自动对工具输出进行预算管理。如果输出过大，会生成一个临时文件路径供模型后续查阅。
• Permission-First：工具执行上下文中强制集成了权限检查（ask 方法），在执行原子操作前进行校验。

3. 对比总结

维度	Claude Code	Opencode
并行模式	显式并发标记 + 读写锁	基于 Effect 的并发编排
错误处理	级联终止 (AbortController)	Effect 错误通道 (Error Channel)
输出治理	实时流式回填 + 5层压缩	自动预算截断 + 临时文件持久化
工具定义	强类型 Zod Schema + 类定义	Effect 风格的函数式定义

Claude Code 的工具编排更具“防御性”，特别是在处理不稳定的 Shell 环境时；Opencode 则利用函数式编程优势，使工具的副作用管理更加可预测。