dsh-super-ptc-mode:PTC 呈现与 Agent Teams 委派预设

前言

在 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 压低工具往返、又用共享任务与有界队友分担复杂工作的场景。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜