前言¶
在 DeepSeek Harness(DSH)里做复杂任务时,工具调用往返多、中间结果堆进对话,Lead 往往又要自己拆活又要自己收束验收。官方已提供 PTC 模式:模型只直接调用 run_code,其余工具在一段程序里通过生成 SDK 调用,能减少轮次、压低对话噪音。若你还希望会话默认按「先拆工作流、建共享任务、派有界队友、Lead 做集成与验证」来执行,单靠内置 PTC 预设通常不够——需要在同一套 PTC 组合上叠加一套固定的委派准则。
下面介绍社区维护的配置包 zouyuanqing/dsh-super-ptc-mode(npm 包名 @local/dsh-super-ptc-mode):纯配置 DSH Profile Bundle,安装后新增 Agent 预设「超级 PTC 模式」(id super-ptc),在保留 PTC 工具呈现的同时,在预设作用域内追加 SUPER PTC 的 Agent Teams 委派教义。
这是什么¶
@local/dsh-super-ptc-mode 由 zouyuanqing 维护,版本 1.0.0,许可证 MIT。包内没有 index.js、没有构建步骤、没有运行时依赖;唯一行为是通过 cordis.patch.yml(在 package.json 中声明为 dsh.bundle.patch)向 Profile 插入一行 @deepseek-ai/dsh-agent-preset,对应 row id preset-super-ptc。
与官方随附的「PTC 模式」相比,差异主要在 persona 后缀:教义写在预设组合内,只对选用 super-ptc 的新会话生效,并在 PTC SDK 说明之后渲染,从而约束执行策略。Agent Teams 相关工具不由本包声明,而是依赖宿主 Profile 已启用的实验包 @deepseek-ai/dsh-experimental-agent-team-profile。
生态上,插件目录站点 SkillHub 是社区索引,与 DeepSeek / 幻方无官方从属关系;安装与行为以 GitHub 仓库 文档为准。
核心功能¶
PTC 工具呈现¶
预设挂载 @deepseek-ai/dsh-agent-tool-presentation,mode: ptc。加入该预设的 Agent 在请求头里只直接暴露 run_code 传输;其它工具须在 run_code 程序内通过 await tools.<name>(args) 访问。独立调用可合并进同一段程序,减少往返,并把中间输出留在程序侧而非对话里。
与官方 ptc 组合对齐的能力面¶
预设复述随附 ptc 的组合行,使 PTC、委派与教义在同一预设内一致,主要包括:
- 身份与上下文:
persona(前缀 + 教义后缀)、agent-instructions、time-context - Shell:Windows 用
pwsh,其它平台用bash - 文件系统:读写编辑、路径与内容搜索
- 运行时:后台任务与定时提醒
- 知识与控制:skills、goals、plan mode、compaction(
/compact与工具结果裁剪) - 委派:仍挂载旧版
subagent/subagent_fork/list_agents;教义要求默认采用 Agent Teams 策略 - 交互:
ask_user_question、todo_write、联网搜索/抓取、present
在本预设的会话内,plugin_manager 与 plugin-market 相关工具被禁用,避免委派子会话擅自改 Profile。
委派教义(persona 后缀)¶
相对随附 ptc 预设,增量即 persona 后缀,且不得包含 {{…}} 类 prompt 变量语法。教义要求 Lead 在非琐碎任务上先分解再动手;在生成队友前建立带验收标准、写域互不重叠的共享任务;队友数量有界(文档写明通常 1–4),任务简报自洽;Lead 保留集成与最终验证;不得把「完成消息」等同于已验证成功。
依赖宿主提供的 Agent Teams 工具¶
本 Bundle 不声明团队工具。启用 @deepseek-ai/dsh-experimental-agent-team-profile 后,宿主提供例如 spawn_teammate、send_message、list_agents、wait_agent、interrupt_agent,以及共享任务板 team_task_create / list / get / update。未启用实验包时预设仍可挂载,但团队工具缺失,教义无法落地。
环境与依赖¶
| 要求 | 说明 |
|---|---|
| DSH 桌面或 Web 0.2.1-rc.5 或更新 | README 写明在 0.2.1-rc.5 上验证;组合面与随附 ptc 预设相同 |
@deepseek-ai/dsh-experimental-agent-team-profile 已启用 |
提供 Agent Teams 与任务板工具 |
@deepseek-ai/dsh-ptc-runtime-node(桌面应用内已包含) |
无 PTC 运行时则挂载拒绝,并指出失败行 |
兼容性:README 记载在 Windows 上于 DSH 桌面 0.2.1-rc.5 端到端测试;组合在平台维度与随附 ptc 一致。
安装与启用¶
安装方式为本地目录链式安装,不要手改 Profile 依赖列表或 patch。官方步骤如下。
1、克隆仓库并保持检出目录常驻(本地目录安装会链接整个目录,files 不会过滤已链接目录):
git clone https://github.com/zouyuanqing/dsh-super-ptc-mode.git
2、在 DSH 内用 plugin_manager 从克隆目录安装 Bundle(target 填仓库的绝对路径):
plugin_manager action: install_bundle target: <absolute path to the cloned dsh-super-ptc-mode directory>
3、若安装结果提示 restart-required,先重启 DSH 再使用预设。
4、新建会话时选择 Super PTC Mode(显示名:超级 PTC 模式,id super-ptc)。已有会话仍使用各自原有预设。
5、在新会话中核对:名册与 Bundle 详情出现标题与图标;持久化系统提示含教义原文;请求头仅 run_code 可直接调用;生成 SDK 暴露团队工具绑定。仓库内 docs/VERIFICATION.md 列出验收项与复现提纲。
Bundle patch 在 Profile 自有 cordis.patch.yml 之前应用;若操作员编辑 Profile 覆盖了 row id preset-super-ptc,以 Profile 级覆盖为准。
卸载:在 DSH 插件管理中对本 Bundle 执行 plugin_manager 的 set_bundle / remove_bundle;预设行随 Bundle 移除,不影响 Agent Teams 实验包。
典型用法¶
本包不附带独立业务场景脚本;用法即「选用预设 + 按教义组织多 Agent 工作流」。
1、确认实验 Agent Teams Profile 与 PTC 运行时已满足上节要求。
2、新建会话,预设选 super-ptc。
3、由 Lead 将任务拆成互不依赖的工作流;用 team_task_create 等建立共享任务与验收条件;再通过 spawn_teammate 派发有界队友,写域分离。
4、复杂工具操作放在单次或少量 run_code 中,通过 SDK 批量调用 tools.*(含团队工具),减少对话轮次。
5、Lead 使用 wait_agent、检查任务板与产物,完成集成验证后再对用户收尾;避免仅依赖队友的完成宣告。
仓库 README 记载在 0.2.1-rc.5 上完成真实队友与共享任务流验证;细节见 VERIFICATION 文档。
适用场景与注意¶
适合:已在 DSH 上使用 PTC、并愿意启用 Agent Teams 实验能力的开发者;需要默认「Lead 编排 + PTC 批处理 + 共享任务验收」的长链路工作流。
不适合或未就绪:未启用 @deepseek-ai/dsh-experimental-agent-team-profile 的环境(教义无工具支撑);DSH 版本低于 0.2.1-rc.5 且组合面不兼容的情况需自行验证。
安全与信任:插件以当前 DSH 进程权限运行;安装前请阅读仓库源码、cordis.patch.yml 与 MIT 许可证,确认 patch 仅插入预期预设行。@local/ 作用域与 private: true 表示设计为从检出目录本地安装,而非 npm 公开发布包。
结尾¶
dsh-super-ptc-mode 把官方 PTC 组合与一套固定的 Agent Teams 委派教义收成单一预设 super-ptc,适合在 DSH 里用 run_code 压低工具往返、又用共享任务与有界队友分担复杂工作的场景。