企业官网建设流程全解析

dsh-agent-teams的/agent-teams命令全攻略：确定性激活与自然语言触发双入口

【免费下载链接】dsh-agent-teamsAgentTeams plugin for DeepSeek Harness项目地址: https://gitcode.com/gh_mirrors/ds/dsh-agent-teams

dsh-agent-teams 是一款为 DeepSeek Harness 打造的多智能体团队插件：安装后，当前会话会变成"队长"，能把一个目标拆成带依赖的任务，拉一群可续聊的子 Agent 并行干活，并提供实时 Web 面板。启动这支团队有两条入口——确定性的/agent-teams斜杠命令，和更省心的自然语言触发。本攻略带你一次搞懂这两种入口的用法、背后的确定性机制，以及激活后的完整流程。

🧭 双入口一览：怎么选

两个入口最终走的是同一套队长协议，区别只在于激活路径。核心实现见 src/command.ts 与 src/capabilities.ts。

🚀 安装准备：三步就能用

推荐组合：DeepSeek Harness0.1.7-rc.2+ 插件0.1.22-rc.1（完整对照见 compatibility.json）。

# 1. 全局安装 Harness（已有可跳过） npm install --global @deepseek-ai/dsh@0.1.7-rc.2 # 2. 安装插件（--profile 换成你实际使用的 profile） dsh plugin --profile web add --save-exact @nanmicoder/dsh-agent-teams@0.1.22-rc.1

装完后重启对应 profile 的 Harness 进程并刷新浏览器即可。桌面端则在 插件 → 添加插件 中填入上面第 2 行的 npm 包规格。安装细节参考 README_ZH.md。

⚡ 入口一：/agent-teams 命令的确定性激活

基本用法

在 Web 或桌面端的输入框输入/，slash 菜单会出现agent-teams占位项（带输入提示）。选中它或直接键入命令，描述目标，回车：

/agent-teams 调研三家竞品的定价页

支持 profile 参数的完整形式是/agent-teams [--profile <name>] <goal>。命令执行后会提示"AgentTeams activated — the captain will assemble the team."，队长随即开始组队。

为什么说它是"确定性"的

这条命令不是把文字丢给模型"猜一下"，而是一条有明确管线的激活链路，源码在 src/command.ts：

1. 命令管线认领这一行：插件以封闭命名空间注册了agent-teams宿主命令，输入行被精确匹配，不存在歧义。
2. 原文保留在聊天记录里：管线把你提交的原文作为普通用户消息回填到主会话，所以聊天记录中仍能看到完整的/agent-teams ……，方便追溯。
3. pre-step 注入激活指令：gesture 边界（src/command.ts 的installAgentTeamsGestureBoundary）在模型第一步之前注入一段确定性的激活指令，第一次模型请求就直接进入"先计划后执行"的队长协议，不需要任何辅助调用。
4. 全程留痕：每次调用都会持久化记录command/run/command/done事件，可供审计与复盘。

输入框之外同样生效

没有命令裁决机制的界面（例如 headless CLI）也走 gesture 边界：任何以/agent-teams开头的真实用户消息，都会为其余文本激活协议；而句子中间出现的字样仍是普通文本，不会误触发。这个正则边界定义在 src/command.ts 的GESTURE常量中。

💬 入口二：自然语言触发

不想记命令？直接在对话里表达意图即可：

使用 AgentTeams 审查 v0.5.3 之后的提交，分别从性能、安全和产品角度分工，最后输出一份汇总报告。

插件通过固定的系统提示段（TEAM_ACTIVATION_PROMPT，见 src/capabilities.ts）让模型识别"用户请求"：当用户请求使用AgentTeams（含/agent-teams）或继续已有团队时才激活。边界很清晰——单纯提及、引用、讨论或拒绝 AgentTeams 都不算启动请求。

两种入口可以混用：先用命令创建团队，后续轮次用自然语言追加指令（如"把验证环节交给另一人"），队长会继续当前团队，而不是重建。

🧭 激活之后：先出"分阶段计划"，确认后才跑

无论哪个入口，正常的/agent-teams流程都遵循计划先行（Plan before execution）：

1. 队长调用agent_teams_create，把成员名单和任务 DAG 以staged（分阶段）草案形式提交——此时不创建任何子会话、不领取任何任务；
2. Web 计划审查面板出现，你可以直接调整成员、模型路由、任务负责人和依赖；
3. 三个按钮决定走向：确认并启动团队（Approve & Run）、返回对话修改（队长追问一次修改方向后原子更新同一份草案）、放弃本次计划（归档草案，并明确禁止自动重建）。

批准后，成员会话才在"第一个任务就绪"时按需创建，共享调度器依据真实的running / idle / ready状态为空闲成员原子领取就绪任务。

👀 执行过程：团队卡片、协作页与活动面板

团队创建后，对话流下方会出现团队卡片（成员一览 + 查看团队入口），点"查看团队"打开原生"团队协作"标签页；右侧活动面板则实时展示分段进度、可折叠成员树和任务 DAG。

团队结束后，"团队协作"页保留完整归档：左侧是队长与成员列表（含各自模型路由与交付进度），右侧是带真实连线的任务依赖 DAG——依赖关系一目了然。

如果你更习惯悬浮窗，活动面板可切换为浮动窗口随意拖拽，运行中的任务节点会直接标出所用模型。

🎛 进阶：用 Profile 模板一键启动

在 profile 的cordis.patch.yml里预定义好成员阵容和任务模板后，命令还能"点菜式"启动：

/agent-teams --profile demo-delivery 实现这个功能

更妙的是，每个合法 profile 名会自动注册一个别名命令（如 profiledemo-delivery对应/agent-teams-demo-delivery <goal>），命名规则与解析逻辑见 src/command.ts 的profileCommandName/profileForCommand。两个注意点：

• 第一个普通 token 永远不会被当作隐式 profile——想指定模板必须显式写--profile，避免foo_bar、非 ASCII 等歧义命名；
• taskPlanning: captain时模板只提供阵容与门禁，由队长根据目标动态设计 DAG；seed则展开固定任务模板。

❓ 常见问题速查

• 只想保留自然语言入口？在配置里加slashCommand: false，即可关闭 slash 命令与 gesture 边界两个确定性激活面。
• 一个会话能带几支队伍？一个队长同时只能带一个活动团队；已有团队时，新的激活指令会继续现有团队而不是重建。
• 团队数据存在哪？<workspace>/.agent-teams/<teamId>/（team.json+ 每成员一个 JSONL 邮箱），Web 面板读的就是这份"磁盘真相"。
• 模型偶尔没更新任务状态怎么办？面板如实反映持久化状态，队长以agent_teams_status与文件为准汇总，不会凭空显示进度。

📚 延伸阅读

• 完整工具参考、状态机与已知限制：docs/usage.md
• 固定协议与渐进加载设计：docs/progressive-loading.md
• 中英文 README：README.md · README_ZH.md
• 源码入口：命令注册与 gesture 边界 src/command.ts、协议提示段 src/capabilities.ts

【免费下载链接】dsh-agent-teamsAgentTeams plugin for DeepSeek Harness项目地址: https://gitcode.com/gh_mirrors/ds/dsh-agent-teams