验证与扩展：用测试约束架构假设

先复现，再扩展

把问题缩小为一个可观察行为，例如“名称不同的两个工具是否被正确分派”。寻找对应单元测试〔小范围行为检查〕，阅读固定输入、执行动作与断言，再向外追踪集成测试〔跨组件行为检查〕。测试通过证明受检查条件下的行为，不能证明所有环境都相同。

router_tests.rs 包含扩展工具规格与执行器示例。它比凭空添加一个 handler〔具体处理实现〕 更好的起点：先理解工具身份、规格、执行契约与注册，再看它如何进入工具计划。新的工具需要明确输入、输出、取消和权限边界。

无账号的阅读实践

git clone https://github.com/openai/codex.git
cd codex
git checkout f82e36592278a0a782fb0d0fc97e5fa10e832ac2
rg -n "tool_supports_parallel|supports_parallel_tool_calls" codex-rs/core/src/tools
rg -n "ExtensionEcho" codex-rs/core/src/tools/router_tests.rs

这组命令只获取和搜索公开代码，不连接模型〔内容生成系统〕账户。首次克隆需要网络。固定版本后，再核对文件路径与本课程是否一致。不要把最新安装的二进制当成这一源码提交的构建产物。

需要编译时，选择最小范围

Cargo〔Rust 构建工具〕、Rust〔实现语言〕 工具链及依赖准备好后，可以按 docs/install.md 构建。根目录 justfile〔任务配方文件〕 提供格式化、静态检查和测试入口；just 是读取任务配方的命令工具，nextest〔Rust 测试运行器〕 是测试运行器。以下命令是读完规范后可选择执行的练习，不是本网站运行所需。

cd codex-rs
cargo test -p codex-core --lib tool_log_payload_redacts_plaintext_multi_agent_messages
# 或在仓库根目录使用已安装的任务工具
just test -p codex-core

第一条定位现有日志脱敏测试，第二条范围更大。编译可能下载依赖并占用磁盘；不同平台与工具链会影响可运行的测试。本课程制作过程中核验了文件和测试名称，但没有编译或运行 Codex 的 Rust〔实现语言〕 测试套件。网站自身的检查记录在交付包中。

结业任务：写出你自己的执行链

• 选“读取一个测试配置”作为任务，标出用户输入、回合〔一次输入的处理过程〕循环、工具分派和结果返回。
• 给每个箭头附一个源码路径和固定版本链接；对未读到的部分标“尚未确认”。
• 列出四个用例：正常返回、未知工具、执行取消、权限拒绝。明确你要观察的结果。
• 写一页复现记录：版本、平台、前置条件、操作、预期与实际结果。

若准备向上游反馈，本版本 contributing.md 明确欢迎问题、分析和功能请求，但不接受外部代码贡献或 PR。先查现有问题，提供脱敏复现材料；本地练习不意味着上游会接收补丁。

自测与边界检查