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

subprocess/：进程管理能力家族

English | 中文

spawn 受管子进程树的共用归属位置：完全显式的 spawn spec，其 stdio 处置方式（disposition）为 Node 形状、按流划分（原始管道、inherit、附带 spill 文件的有界尾部保留收集）；harness 中所有 spawn 调用方共用的那一份凭据清除；基于偏移量的增量读取；以进程树为范围、带 SIGTERM→宽限期→SIGKILL 升级的信号发送；以及协作式 dispose（资源释放）阶梯。命令默认值补全、shell 语义、deadline、协议分帧与呈现留在消费方：bash 执行器、LSP 主机与 ACP（Agent Client Protocol）subagent 后端。参见进程管理器 seam Agent Note（agent 决策记录）。

包（package）	ctx 键	角色
subprocess（@deepseek-ai/dsh-subprocess）	ctx.subprocess	seam 本体：抽象的 SubprocessService.spawn(spec)、完全显式且带按流划分 stdio 处置方式的 SubprocessSpawnSpec、SubprocessHandle（流、基于偏移量的读取器、terminate/waitForExit/dispose），以及共享的凭据清除 + DSH_*/CollectedOutput 词汇
subprocess-local（@deepseek-ai/dsh-subprocess-local）	无	本地实现：detached 进程树、按处置方式接线的流、附带有界私有 spill 文件的尾部保留截断、DSH_* 合并次序、带升级的进程树信号发送、dispose 阶梯，以及先终止再等待退出的 dispose
e2b/subprocess-e2b（@deepseek-ai/dsh-subprocess-e2b）	无	实验性 E2B 实现：远程 Linux 进程组和共享 ctx.e2b 沙箱中的 spill 状态，但 PID 异步获取，且受 SDK 缓冲限制

服务拥有跨消费方重载的进程存续期；消费方拥有一个进程的含义（一条 bash 命令、未来的非 shell 运行器）以及塑造它的每一项默认值。