deepseek-harness/packages/shell/README.zh.md

description, kind

description	kind
面向部署方与维护者的 bash 能力家族说明，用于选择并组合 shell 执行器、沙箱化与面向模型的 bash 与 pwsh 工具。	package-group

shell/ — bash 能力家族

English | 中文

概述

shell 组为 agent 提供命令执行能力：运行前台命令并读取其有界输出，或启动后台进程并轮询它——在 POSIX 上用 Bash，在 Windows 上用 PowerShell。每个组合恰好挂载一个执行器实现；沙箱执行器会通过沙箱能力限制每条命令，面向模型的 bash 与 pwsh 工具则位于所挂载执行器之上。POSIX 选择 Bash 执行器，Windows 选择 PowerShell 执行器；命令需要文件级隔离时选择沙箱变体。

目录

• 包
• 相关文档
• 开发备注

---

包

包	职责	ctx key
shell	定义执行器约定：前台运行、后台句柄与请求解析	ctx.shell
bash-local	在 POSIX 上以全新 bash -c 进程运行 Bash 命令	注册 ctx.shell
bash-sandbox	通过沙箱能力限制 Bash 命令运行，并把拒绝报告为事实	注册 ctx.shell
pwsh-local	在 Windows 上以全新 pwsh -Command 进程运行 PowerShell 命令	注册 ctx.shell
pwsh-sandbox	通过沙箱能力限制 PowerShell 命令运行	注册 ctx.shell
shell-env	提供每条 shell 命令都会收到的受管 DSH_* 环境	ctx.shellEnv
tool-bash	以 bash 工具向模型公开 Bash 执行与后台任务	注册到 ctx.tools
tool-bash-persistent	在单个限定所有者范围的持久 Bash 会话中运行模型的 shell 调用	注册到 ctx.tools
tool-pwsh	以 pwsh 工具向模型公开 PowerShell 执行	注册到 ctx.tools
tool-pwsh-persistent	在单个限定所有者范围的持久 PowerShell 会话中运行模型的 shell 调用	注册到 ctx.tools

profile 层恰好选择一个执行器实现（win32 层会把 POSIX 行换成 pwsh 行；同时挂载两个会因服务重复注册而在加载期失败）以及所需的面向模型工具。沙箱化组合还会选择一个 ctx.sandbox 提供方与 ctx.sandboxPolicy；base bundle拥有随附接线。

---

相关文档

• Bash 执行器子系统 —— 共享的请求/spec 词汇、结果、后台进程与完整的服务约定。
• 沙箱子系统 —— 沙箱执行器所消费的隔离能力。

开发备注

None.