ChatGPTClaudeGrok / X / CursorGemini

DeepSeek Harness 终端、Bash 与后台任务怎么选:PTY、一次性命令与长任务边界

配置与使用发布于 2026-11-18作者: DeepSeek Plugin 插件市场
DeepSeek HarnessDSH plugin终端PTY后台任务
终端、Bash 与后台任务在 DeepSeek Harness 里是三种执行模型:持久 PTY、一次性进程、可回收任务。本文用一张选择表和四个场景例讲清什么时候用哪个,以及迁移后哪些行为会变。

终端、Bash 与后台任务不是三个同类工具,而是三种执行模型:持久 PTY、一次性进程、可回收任务。 选错模型,表现通常不是报错,而是「命令能跑,但状态丢了」「任务在跑,但拿不到输出」或「用户点了取消,进程还在」。先把模型分清,再谈命令怎么写。

DeepSeek Harness 三种执行模型

三种模型的差别在「状态活多久」和「谁持有生命周期」。 对照如下(来源):

模型状态生命周期典型入口
终端持久 shell,保留环境与目录由终端会话持有terminal_open/send/read
Bash每次新进程,无跨命令状态由单次调用持有bash
后台任务进程或任务在后台跑由 ctx.jobs 持有run_in_background + job_*

终端的核心是「连续性」:上一条命令的 cd、环境变量、shell 函数,下一条还能用。Bash 的核心是「隔离」:每次都是干净进程,不残留状态。后台任务的核心是「可回收」:任务启动后,调用可以返回,之后用 job 工具读取或停止。

三者可以组合:在终端里启动一个后台任务,或在 bash 里用 run_in_background。组合时要想清楚「状态归谁」,否则会出现两套生命周期互相打架。

DeepSeek Harness 按需求选模型

按需求选模型,不要按习惯选。 下面这张表可以直接对照(来源):

需求推荐原因
连续多条命令、需要保留 cd/环境终端持久 PTY 保留状态
一条命令、跑完即走Bash隔离干净,开销小
命令超过当前调用时长后台任务可返回句柄、稍后读取
需要交互式输入或 TUI终端PTY 支持交互
需要用户看到进度后台任务可查询输出与状态
需要严格隔离、避免污染Bash每次新进程

第一行和第四行最容易混。终端适合交互,但不适合「一次性、要求绝对干净」的命令;Bash 适合一次性,但保留不了状态。

第三行与第五行也容易混。后台任务不是「更快的 bash」,而是「生命周期更长的任务」;如果命令几秒就结束,后台化只会增加读取与回收的复杂度。

DeepSeek Harness 四个场景例

四个例子覆盖大多数选择,照最接近的用。 每个例子都给出「为什么不用另一个」(来源):

  1. 安装依赖并跑测试 — 用 Bash。一条命令链,跑完即走;不需要保留 shell 状态。
  2. 连续调试同一个 REPL — 用终端。需要保留变量、导入与当前目录;Bash 每次都重置。
  3. 启动开发服务器 — 用后台任务。服务器长期运行,调用要返回,之后读取日志或停止。
  4. 在远程机器上保持一个 shell — 用终端。需要持久会话与交互;一次性命令无法保持连接状态。

四个例子的共同点是「先看生命周期,再看命令内容」。同样是 npm test,跑一次用 Bash,持续监听用后台任务,反复交互用终端。

如果一个任务同时需要「持久状态」和「后台运行」,优先用终端启动后台进程,再用终端的输出游标读取;不要同时开两套后台管理。

DeepSeek Harness 状态与持久性差异

状态归谁,决定了切换、取消与重连后的行为。 三种模型的差异(来源):

  • 终端 — 状态在 PTY 会话里,会话关闭即丢失;重连不一定恢复原 shell。
  • Bash — 状态只在单次进程内,进程结束即丢失;不存在「上一次的目录」。
  • 后台任务 — 状态在任务运行时里,任务结束或回收后只保留输出;取消要走任务自己的信号。

这三条解释了很多「看起来像 bug」的现象:在 Bash 里 cd 后下一条命令又回到原目录,是正常;在终端里关闭面板后环境变量没了,是正常;后台任务取消后输出还在,是正常。

持久性还影响安全边界。终端的 PTY 字节不出进程,后台任务的输出可能进入日志或 spill;需要保密的交互,优先终端,不要把敏感输出后台化。

DeepSeek Harness 迁移注意

从 Bash 迁到终端或后台任务,要逐项确认四件事。 不要只改工具名(来源):

  1. 状态 — 终端保留状态,Bash 不保留;迁移后命令可能依赖了上一次的目录或变量。
  2. 取消 — 终端的取消是关闭或中断会话;后台任务的取消是任务信号;Bash 的取消是进程信号。三者的清理路径不同。
  3. 输出 — 终端用输出游标读取新增;后台任务用 job_output;Bash 直接返回。迁移后不要把「读取新增」写成「读取全部」。
  4. 权限 — 三种模型都受沙箱与审批约束,但触发点可能不同;迁移后要重新验证越界写入的行为。

迁移后最常见的 bug 是「命令在终端里能跑,在 Bash 里失败」,原因通常是环境变量或当前目录没有带过去。反过来,「Bash 能跑,终端里卡住」通常是交互式命令在等输入。

迁移不要一次改完。先改一条命令,验证状态、取消、输出、权限四项,再扩大范围。

DeepSeek Harness 四项验证:状态、取消、输出与权限

验证选型,按四步走,不要只看命令成功。 四步(来源):

  1. 状态 — 连续两条命令,确认第二条能看到第一条留下的目录或变量(终端),或看不到(Bash)。
  2. 取消 — 启动一个长命令,取消后确认进程或会话真的停止,没有残留。
  3. 输出 — 读取输出,确认游标或 job_output 只返回新增部分,不重复。
  4. 权限 — 在工作区外写入,确认审批或拒绝行为符合当前预设。

四步都过,模型选型与实现基本一致。只过第一步,常见问题是取消不彻底;只过前两步,常见问题是输出重复或丢失。

旧文 develop-terminal-subsystem 讲终端服务 API,configure-background-jobs 讲后台任务配置,develop-jobs-output-ring 讲输出环;本篇补的是三者选型。先定状态归谁,再定用哪个工具。

ChatGPTClaudeGrok / X / CursorGemini

常见问题

DeepSeek Harness 的终端和 Bash 工具最核心的区别是什么?

DeepSeek Harness 的 terminal 是持久 PTY,会话状态跨命令保留;bash 是每次调用起一个一次性进程,不保留 shell 状态。需要连续交互用终端,一次性命令用 bash。

DeepSeek Harness 什么时候该用后台任务,而不是继续前台跑?

当命令需要跨过当前调用返回、需要用户随时查看进度,或需要稍后回收结果时,用 DeepSeek Harness 的后台任务。几秒内完成的命令留在前台更简单。

DeepSeek Harness 的 terminal 工具默认启用吗?

DeepSeek Harness 里不默认启用。DeepSeek Harness 的 terminal 六个工具需要选择启用,用于补充一次性 bash 与文件系统工具;没有启用时,模型看不到这些工具。

DeepSeek Harness 从 bash 换到 terminal 后,哪些行为会变?

最明显的是状态:DeepSeek Harness 的 terminal 保留 shell 状态、环境与当前目录,bash 每次都是新进程。取消、输出读取与后台化方式也不同,迁移时要逐项确认。

相关术语

PTY
PTY 是伪终端,DeepSeek Harness 的 terminal 用它提供持久 shell 会话,保留状态、环境与交互输出。— DeepSeek Harness 官方文档 - PTY 会话
一次性命令
一次性命令是每次调用启动新进程执行的命令,不保留上一次的 shell 状态,DeepSeek Harness 的 bash 工具属于这一类。— DeepSeek Harness 官方文档 - Bash 执行
后台任务
后台任务是 DeepSeek Harness 中通过 ctx.jobs 管理、可跨调用返回并稍后读取输出的执行单元。— DeepSeek Harness 官方文档 - 后台任务
输出游标
输出游标是读取持久终端或后台任务输出时的位置标记,用于只取新增部分,避免重复读取。— DeepSeek Harness 官方文档 - PTY 会话

来源