执行摘要

• 一句话：将 coding_agent_rl 辅助函数从 generate.py 移至 sandbox.py
• 推荐动作：该 PR 是常规精简重构，值得学习其模块拆分思路。如果正在使用 coding_agent_rl 示例，建议同步更新代码以避免引用过时的私有函数。

功能与动机

PR 标题和提交信息明确说明目标是“将 coding_agent_rl 的辅助函数移到 sandbox.py”，原始实现将所有逻辑堆在 generate.py 中，导致模块职责不清，不利于复用和测试。通过移动函数，让 sandbox 操作集中在 sandbox.py，提高代码可维护性。

实现拆解

1. 迁移环境常量：将 SWE_HOST_NODE_TARBALL、SWE_HOST_CC_TARBALL、SWE_BOOT_CONCURRENCY、SWE_BOOT_RETRIES 和 CC_PROMPT 等配置变量从 generate.py 移至 sandbox.py。
2. 迁移核心函数：将 _boot_agent_sandbox（重命名为公共函数 boot_agent_sandbox）和 _run_claude_code（改为内部函数 _spawn_claude_code）从 generate.py 移至 sandbox.py，并调整接口以支持模块内的直接调用。
3. 精简 generate.py：删除 generate.py 中不再需要的导入（如 AsyncIterator、asynccontextmanager、E2BSandbox）和上述常量/函数，保留 _State 单例和 generate 编排函数。
4. 更新调用关系：在 generate.py 中通过 sandbox.run_claude_code 和 sandbox.git_diff 调用新位置的方法，并在文档字符串中同步更新描述。
5. 后续清理：第二个提交删除了 generate.py 中不再使用的 _get_diff 私有函数。

关键文件：

• examples/coding_agent_rl/generate.py（模块 生成编排；类别 source；类型 refactoring；符号 _boot_agent_sandbox, _run_claude_code, _get_diff）: 核心编排文件，移除了 sandbox 相关辅助函数和常量，大幅精简，职责更加单一。
• examples/coding_agent_rl/sandbox.py（模块 沙箱工具；类别 source；类型 refactoring；符号 boot_agent_sandbox, _spawn_claude_code）: 接收了来自 generate.py 的 sandbox 相关函数和常量，成为 sandbox 操作的中心模块。

关键符号：boot_agent_sandbox, _spawn_claude_code, generate

评论区精华

该 PR 没有 review 评论，表明变更简单直接，无争议。

• 暂无高价值评论线程

风险与影响

• 风险：这是一次纯重构，功能行为不变。主要风险是引用路径错误（如函数名称或参数不匹配）以及新的 sandbox.py 中缺少必要的导入。由于 PR 已合并且无测试失败，风险较低。但无测试覆盖新增函数，未来修改 sandbox.py 时可能引入回归。
• 影响：对直接使用 coding_agent_rl 示例的用户无功能影响，但若用户直接调用了 generate.py 中的私有函数（不推荐），则需要调整为 sandbox.py 的公共函数。对开发团队， sandbox 相关逻辑集中，便于后续维护和扩展（例如支持更多 sandbox 后端）。
• 风险标记：无直接测试配套

关联脉络

• PR #1923 [examples] add coding_agent_rl: agent-in-sandbox RL minimal demo: 本 PR 是对 PR#1923 新增的 coding agent RL 示例的内部模块拆分，将辅助函数从 generate.py 迁移至 sandbox.py。