AI 简明手册
DeepSeek Harness 源码解读 · 工具系统终端、代码查询与后台任务怎样分工

专题篇章 · 工具系统源码解读

终端、代码查询与后台任务怎样分工

先看全局

DSH 提供 terminal、lsp、jobs 三套工具：持久终端会话、四类语义查询、统一后台任务。均按所有者授权，闭合词汇，结构化降级。

沿地图找代码

terminal 用 id 管理持久 PTY 会话，热重载期间不丢

terminal 用 id 管理持久 PTY 会话，热重载期间不丢。每个会话归属一个 Agent，他人拿 id 也无法操作。同一会话仅一个活动 send，并发请求返回 SEND_ACTIVE 错误。

[repo]

lsp 仅开放跳定义、找引用、跳实现、hover 四类查询

lsp 仅开放跳定义、找引用、跳实现、hover 四类查询。无 provider 时返回 LSP_UNAVAILABLE，不开放通用 JSON-RPC。jobs 统一管理后台 bash、PTY 发送、subagent，按所有者授权，默认上限 10 并发。

[repo]

建议阅读顺序

  • 同一终端会话，后台 send 未结算时发前台 send 会怎样： 后台 send 占用活动发送位，前台 send 收到 SEND_ACTIVE 错误，需等后台结算。

  • 为什么 lsp 不开放通用 JSON-RPC： 通用协议会让 schema 随 provider 漂移。DSH 固定四操作联合，新增操作需三层同步修改。

这张地图没覆盖什么

  • 本页结论对应 revision 0a53fb55bea101816fa226bb964ae2bed71c343b。文件位置、命名和默认行为可能随版本变化，引用实现细节时应同时记录 commit。

来源与核验

  1. [repo] DeepSeek Harness 官方源码（固定 revision）
  2. [official] DeepSeek Harness 官方介绍

Revision：0a53fb55bea101816fa226bb964ae2bed71c343b · 核验日期：2026-08-31