subprocess/：子进程能力家族

English | 中文

这里集中提供一个执行世界的共享进程基底：可执行文件查找、具有原始或收集式 stdio 的完整指定受管子进程树，以及一项深层终端进程原语，负责 PTY 分配、前台进程组和提供方仍可观察到的会话成员清理。命令默认值补全、shell 语义、时限、协议分帧、就绪状态与呈现留在消费方：bash 执行器、LSP 主机、PTY shell 后端与 ACP（Agent Client Protocol）subagent 后端。参见subprocess seam Agent Note（agent 决策记录）。

包（package）	ctx 键	角色
`subprocess`（`@deepseek-ai/dsh-subprocess`）	`ctx.subprocess`	seam 本体：可执行文件查找、普通受管 spawn、终端进程原语、句柄生命周期，以及共享的环境／输出词汇
`subprocess-local`（`@deepseek-ai/dsh-subprocess-local`）	无	本地实现：detached 进程树、有界收集／spill、`node-pty`、前台／会话检查、进程树信号发送，以及先终止再等待退出的资源释放

即使消费方重载，进程生命周期仍由服务负责管理；消费方负责定义进程的含义（一条 bash 命令、未来的非 shell 运行器），以及决定塑造该进程的每一项默认值。