wanghj040530 / dsh-swarm

dsh-swarm

自主团队协作插件：领队（DSH）自主拆分任务 → 特化队员带独立 API/插件执行 → 结果汇总

核心能力

• 自主拆分：领队（DSH 主会话）分析任务类型，自动拆分子任务
• 特化队员：每个队员独立 API、独立模型、独立插件（如搜索专家用本地 qwen3.5，工程师用 GPT-4o）
• 进程隔离：每个队员运行在独立 DSH subprocess 中
• 进程通信：基于 JSONL Mailbox 的跨进程消息协议
• 动态注册：运行时可添加新队员（指定模型+API+插件）

与 agent-teams 的区别

维度	agent-teams	dsh-swarm
拆分方式	人工描述如何拆分	领队自主分析并拆分
队员隔离	同一进程 subagent	独立 DSH subprocess + profile
队员 API	全队统一模型	每个队员独立 API/模型
队员插件	继承 profile 工具	队员可装专属插件
适用场景	简单委派	复杂多角色协作

安装

# 复制到本地插件目录
cp -r dsh-swarm ~/.dsh/local-plugins/dsh-swarm

# 安装到 desktop profile
dsh plugin --profile desktop add "link:~/.dsh/local-plugins/dsh-swarm"

# 验证
dsh --profile desktop --dump-config | Select-String dsh-swarm

# 重启 DSH

配置队员 API Key

编辑环境变量或队员 credentials.yaml：

# OpenAI
setx OPENAI_API_KEY "sk-..."

# Google Gemini
setx GEMINI_API_KEY "..."

# DeepSeek (可选，备用)
setx DEEPSEEK_API_KEY "sk-..."

使用方式

在 DSH 会话中直接用自然语言：

> 帮我查一下特斯拉最新财报，同时写一个 Python 爬虫爬取它的股票数据

→ 领队自动拆分：
  - @researcher: 搜索特斯拉最新财报
  - @coder: 编写 Python 爬虫
→ 两个任务并行执行
→ 领队汇总结果 → 输出最终答案

工具列表

工具	说明
swarm_create_team	创建团队，领队自动分析任务并拆分
swarm_send_task	将子任务下发给指定队员
swarm_add_member	运行时添加新队员（指定 API/模型/插件）
swarm_status	查看团队状态
swarm_disband	解散团队，停止所有队员进程

架构图

用户输入
    ↓
领队（DSH，deepseek-v4-flash）
    ├→ 分析任务类型
    ├→ 自主拆分 → [子任务A, 子任务B]
    └→ 并行下发
           ↓
    ┌──────────────┬──────────────┐
    ↓              ↓
  @researcher    @coder
  (Ollama本地)   (GPT-4o)
  dsh-local-web  代码插件
    ↓              ↓
    └──────────────┴──────────────┘
           ↓
      领队汇总 → 最终答案

队员配置

编辑 members.yaml 自定义队员：

members:
  - id: researcher
    provider: llm-pi-ai
    providerKey: ollama
    model: qwen3.5:9b
    plugins:
      - dsh-local-web
    tools:
      - web_search
      - web_fetch

  - id: coder
    provider: llm-pi-ai
    providerKey: openai
    model: gpt-4o
    apiKeyEnv: OPENAI_API_KEY
    baseURL: https://api.openai.com/v1

运行时添加自定义队员

> 用 Claude 作为代码审查员帮我审查刚才写的代码

→ swarm_add_member 添加 @reviewer（Claude API，code_analysis 角色）
→ swarm_send_task 发送代码审查任务
→ 接收结果
→ swarm_disband 解散临时队员

致谢

本插件参考了以下 MIT 开源项目的架构与接口模式：

• @nanmicoder/dsh-agent-teams — 客户端 UI 面板、webServer 路由模式
• DSH-better-sidebar — 侧边栏/悬浮面板 UI 模式
• @deepseek-ai/dsh-bridge-browser — 工具注册与 TEXT_OUTPUT 模式
• @liustack/modlens — 识图插件集成参考

License

MIT