文档
Shell
Workspace Shell 如何执行 Sandbox 与宿主命令
Shell 是 Workspace 能力,不是 Power。它持有 Sandbox Provider、当前 Workspace 的隔离 Sandbox 与可复用的 Shell Session。
功能
- 默认在 Workspace Sandbox 中执行命令
- 在不同 Chat Session 之间保留已安装工具和 HOME 状态
- 捕获 stdout、stderr 和退出码
- 支持超时和取消
长任务与完成通知
短命令使用 shell 的 exec 动作;长任务和交互进程使用 session_start。设置 auto_notify_on_exit: true 后,命令结束会把成功、失败或主动停止的完成信息自动送回原 Session,无需轮询,同一完成信息只处理一次。
通知在执行检查点处理,不保证立即打断模型请求或同步工具。原执行已停止、关闭或被替代时,结果保留,迟到通知不会重新唤醒它。常驻服务可设为 auto_notify_on_exit: false。重启只恢复已保存完成结果的投递;无法接管的原进程报告中断或状态未知,不自动重跑命令。
具体调用见 Shell 与 Sandbox。
安全
Shell 只有 sandbox 和 host 两个执行目标。默认使用 Sandbox,且不能看到任意宿主路径;host 执行必须提供明确原因并经过宿主审批。Sandbox 失败时不会回退到宿主执行。
使用场景
- 运行构建脚本
- 文件系统操作
- 查询系统状态
- 执行项目特定工具
继续阅读: