DSH Session ConductorAI 编程插件开发

给 AI 分派任务之后,如何把结果带回原会话

DSH Session Conductor 的开发与用法:在原生聊天中创建子任务、保留来源、读取进展,并将首轮结果回填到创建卡片。

作者 Dingxin Tao发布于 阅读约 11 分钟
本页目录
深蓝色立体会话窗口向两个子会话分派任务,一条青绿色路径将结果接回原窗口

用 AI 做项目时,一次讨论经常会带出另一件工作:修改界面之前要检查接口,修复问题之后要审查改动,研究一个方案时又想保留另一条思路。把这些内容都放进同一段聊天,后面再找某个决定或结果就会费力。

我做的 DSH Session Conductor 是 DeepSeek Harness Desktop 的多会话协调插件。它把任务分派留在普通聊天里:从当前会话创建子会话,指定标题与第一条指令,通过创建卡片进入子会话,再从子会话标题栏返回。

插件处理的是这些会话之间的关系和操作。子会话继续使用宿主的聊天界面与模型,用户也可以直接进去继续讨论。

它具体帮用户做了什么

以“检查一组接口改动”为例,通常需要手动开一段聊天、写好背景、记住它对应哪项工作,结束后再把结果带回原来的讨论。插件把其中几项操作接在了一起。

需要处理的事插件怎样帮助
把一项工作单独拿出来在当前聊天提出要求,创建带标题和首条指令的普通子会话
交代相关背景创建时可带入已确认目标、约束和参考资料的摘要,也可明确从空上下文开始
记住任务来自哪里原聊天保留创建卡片,子会话标题栏保留返回来源会话的入口
查看它做到了哪一步明确要求查看进度后,读取有权限访问的公开历史,包含可见消息与工具记录
接回这一轮的结果0.1.6 候选将准确首轮的终态与有限公开预览回填到原创建卡片

这样安排的帮助是减少手动整理会话、复制背景和寻找结果的操作。比如,让一个子会话负责审查接口,原会话保留需求讨论。需要看审查细节时打开子会话,需要在原会话分析这些意见时再明确提出要求。

这里还要分清两种隔离:子会话有自己的聊天历史,但默认继承发起会话的目录与工作区。多个会话要同时修改代码时,需要明确选择独立 Git worktree,分别使用自己的工作目录。单独开聊天并不会自动隔离文件改动。

先准备好运行环境

插件运行在 DeepSeek Harness Desktop 中。源码仓库公开,当前尚未发布到 npm;在另一台机器上使用时,需要按安装与运行说明准备兼容环境并加载本地插件包。

开发环境要求 Node.js 满足 ^22.19.0 || >=24.0.0。克隆仓库、进入项目目录后,可以执行源码检查:

npm install
npm run check
npm run lint
npm run smoke

这些命令用于安装依赖、检查源码和构建产物。Desktop Profile 的插件加载是后续步骤,具体配置以仓库文档为准。部分模型设置和分叉能力需要独立的 Host 兼容配套包;宿主缺少对应接口时,插件会说明操作无法执行的原因。

在已加载插件的会话中,先要求检查 conductor_capabilities,确认当前 Host 支持哪些操作。下面的示例说明用法,不是在本文中实际执行的模型任务。

用一次接口审查走完整个流程

1. 在原会话里提出一个明确的子任务

可以这样写:

创建一个子会话,标题为“接口改动审查”。
使用当前工作区,从空上下文开始。
首条指令:阅读当前仓库的接口实现和相关测试,
检查参数校验、权限检查与错误处理是否有确定的问题。
只做审查,不修改文件;每条发现写明文件位置、触发条件和依据。
主会话展示创建结果后结束本次响应。

如果任务依赖刚才讨论过的决策,可以改为要求带入背景摘要。摘要用于交接目标、约束和参考信息;子会话收到的任务仍应写清范围与检查标准。如何写这样的任务说明,可参照结构化与流程化:把任务说清楚

模型会通过 conductor_create 创建任务。供开发者核对的参数示例如下:

{
  "title": "接口改动审查",
  "instruction": "阅读当前仓库的接口实现和相关测试,检查参数校验、权限检查与错误处理。只做审查,不修改文件;每条发现写明文件位置、触发条件和依据。",
  "contextMode": "empty",
  "operationId": "api-review-example-001"
}

这里省略工作区参数,沿用发起会话的目录与工作区。operationId 标识这一次创建请求;重试同一次请求时保留原 ID 和参数,新建另一项任务时使用新的 ID。只创建空会话时可以省略 instruction,它准备好后保持空闲,也没有首条委派可供回传。

2. 从创建卡片打开子会话

准备就绪后,原聊天里会出现带标题的创建卡片,点击“打开会话”即可进入宿主原生聊天。子会话标题栏提供“返回发起会话”。

这两处入口只是导航。打开或返回会话不会发送新的指令,也不会启动或停止模型任务。

真实测试界面中的 DSH 创建卡片,以及明确请求后读取的公开历史
图 1:v0.1.5 的本地验证界面。原聊天保留创建卡片;截图也展示了按明确请求读取公开历史的结果。

3. 需要进度时,再明确要求查看

默认创建成功后,原会话只呈现创建结果。子会话独立执行首条指令,原会话不会同时重做一遍审查,也不会自动等待、汇总或验证它。

要了解进度,可以在原聊天继续说:

查看“接口改动审查”的公开历史,告诉我已经检查了哪些文件,
还有哪些问题没有确认。不要修改文件。

此时模型可以通过 conductor_readhistory 视图读取已授权的公开消息、工具调用和工具结果。它可以直接依据这些记录说明进展,无须让子会话额外生成一份报告文件。

如果只想补充范围,可以写:“给这个子会话补充要求:也检查未登录请求的处理。”需要单独的后续轮次时,明确要求将指令排队。持续监控同样需要明确提出,插件才使用 conductor_watch 等对应工具。

这些是不同操作:查看已有记录、补充指令、排队等待下一轮、持续跟进。创建一个子会话本身只包含创建时的要求。

真实测试界面中的子会话,标题栏带有返回发起会话的入口
图 2:子会话继续使用原生输入框,标题栏保留任务来源。此图来自 v0.1.5 的本地验证。

4. 首轮结束后,把结果留在原卡片

0.1.6 候选实现了一次首轮回传:创建时给出非空首条指令后,插件追踪这条指令实际对应的执行轮次。该轮进入终态,原创建卡片可以显示状态、原因与有限的公开回答预览。

回传更新的是原卡片,不会为原会话新增一轮模型调用。完整内容仍在子会话里,点击打开即可阅读。

卡片也会区分执行失败、中断、需要处理和明确的初始投递失败。一次正常结束的执行,仍然需要按原始要求检查成果。后续在子会话继续讨论,不会覆盖这次首轮回传。

如果你希望原会话结合审查意见给出判断,可以再提出:

读取“接口改动审查”的结果,对照原需求,
分析哪些问题应在合并前修复,哪些发现还缺依据。
先说明判断,不修改代码。

这时原会话才参与分析。关于实现、独立审查与人工决策的分工,可继续阅读AI 编程工作流:实现、审查与决策

为什么要保存任务身份,而不是只保存标题

在界面里,用户认的是“接口改动审查”这个标题。服务端还要知道:它是哪项逻辑任务、在哪个宿主会话执行,以及这一次创建请求对应哪条初始指令。

DSH 架构示意:主会话经过协调服务向子会话委派任务,公开终态经准确轮次匹配和读取权限检查,回到原创建卡片
图 3:依据源码关系生成的概念架构图。蓝色路径表示创建与委派,青绿色路径表示首轮终态回传;协调服务保存任务和操作记录。

图中的 Task 是逻辑任务,Binding 记录任务所在的 Host 与 Session 及其版本,Operation 记录一次创建或修改请求。插件在独立存储域中保存这些关系,不靠标题或回答文本猜测任务来源。

首轮回传还保存准确的初始消息 ID。观察到这条消息对应的轮次结束后,才形成回传。这样可以排除一个容易出错的情况:子会话后来又运行了一轮,插件却把后来的回答当成创建时那项委派的结果。

显示前,服务端重新检查原会话是否仍有读取权限,以及当前卡片是否对应原创建操作。预览只取允许公开的内容,不包含推理草稿、原始 token 流或私有 Session 日志。授权被撤销后,导航关系仍可保留,回传细节会隐藏。

“创建了”“做完了”和“通过了”分别记录

开发这类插件时,一条“成功”提示很容易承载太多意思。我在实现中把不同事实分开记录。

状态事实能说明什么
会话准备就绪子会话和环境已准备好,尚不能证明指令已执行
指令已受理Host 已接收输入,尚不能证明目标已完成
首轮进入终态本次委派以完成、失败、中断或阻塞等状态结束
成果通过验收按明确的检查规则确认输出满足要求

例如,接口审查回答了“检查完成”,可以作为阅读结果的入口。是否覆盖了要求的接口、发现是否有代码依据、测试能否复现,都属于后续验收。一次性卡片回传负责呈现执行事实,工作流的验收则有自己的规则和记录。

这种区分也影响重试。请求结果不确定时,插件保留原操作身份并对账;换一个新 ID 重发,可能会创建第二个任务。准确记录当前阶段,比把未知结果写成成功或失败更有用。

当前适用范围与验证状态

本文依据 2026 年 9 月 15 日的 0.1.6 源码候选及仓库验证记录。创建卡片、双向原生跳转和明确要求后的公开历史读取已有 v0.1.5 的真实本地 Host/Edge 验证,正文两张截图来自该环境。

0.1.6 的首轮回传实现已通过本地源码检查、测试与构建检查,候选包已链接到本机 Desktop Profile。完整桌面加载、Host/Edge 流程与恢复场景的最终验证仍待完成。架构图用于解释实现关系,两张界面截图不作为新版回传已经通过桌面验证的证据。

插件适合需要把研究、审查或另一条方案单独交给子会话的使用者。任务很短、只需一次回答时,留在原会话通常更直接。远程连接与在线分享默认关闭;当前源码公开,但尚未发布 npm 包,也尚未声明许可证。

继续阅读与源码

本网站的项目详情页整理了界面截图、技术栈与实现重点。结构化任务说明可用于准备首条指令,AI 编程工作流讨论结果审查与决策,上下文与验证实践说明交接时应该提供什么材料。

源码与工具用法见 GitHub 仓库。本篇的实现依据包括原生会话链接说明工具参数示例验收记录。适配与安装时,以仓库当前的文档和实际能力检查为准。

继续阅读