hongyue0721/dsh-kimicode-swarm ↗★ 5

dsh-kimicode-swarm

Batch-parallel subagents for DeepSeek Harness: Swarm mode, per-item models, rate-limit recovery and a live in-chat panel. DeepSeek Harness 批量并行子 Agent:Swarm 模式、单项指定模型、限流恢复与聊天内实时面板。

パッケージ
dsh-kimicode-swarm
互換性
未検証
Harness ピア範囲
*
バージョン
0.2.2
ライセンス
MIT
最終更新
2026/11/07

インストール

$npx -p @deepseek-ai/dsh dsh plugin --profile web add dsh-kimicode-swarm

ドキュメント

README 全文を読む ↗

使用指南

Swarm 模式

命令作用
/swarm切换当前会话的 Swarm 模式开关
/swarm on / /swarm off持续开启或关闭,状态随会话保存
/swarm 仅对当前回合开启,回合结束后自动退出

开启期间,聊天输入区会显示 Swarm 状态徽标,点击即可随时关闭。为避免无限递归,子 Agent 内部不会再次派发 Swarm 批次。

子 Agent 沿用当前会话已委派的权限运行,不会在执行中途弹窗等待交互式审批;超出委派权限的操作将交回主 Agent 统一处理,确保整批任务顺畅执行。

指定模型

模型选择优先级从高到低依次为:单项或整批显式传入的 model > 插件设置页的类型映射表 > 继承父 Agent 的模型。

{ "item": "src/core/scheduler.ts", "model": "deepseek-v4-pro" }

swarm_batch 参数

参数说明
description当前批次的简短任务描述
prompt_template包含 {{item}} 占位符的提示词模板(传入 items 时必填)
items2 到 128 个子任务项(配合 resume_agent_ids 使用时可少于 2 项),支持 string 或 { item, model?, type? }
model整批任务使用的模型,优先级高于配置映射表
subagent_type优先匹配宿主已注册的 Agent 预设,其次匹配模型映射表中的类型标签;省略时继承父 Agent 配置
fork继承截至上一回合的对话历史启动子 Agent(与 resume_agent_ids、model、type、subagent_type 互斥)
resume_agent_idsagent_id -> prompt 映射表,在已有子 Agent 会话上继续推进任务,优先于新任务启动

开启 fork 适合依赖前文背景的拆解任务;由于每个子 Agent 都会携带完整对话历史,建议结合上下文长度按需启用。

配置

模型映射、超时时间与单批并发上限均可在 Web 界面的「插件 → dsh-kimicode-swarm」设置页中调整,保存后对下一次派发立即生效。配置持久化在对应 profile 的配置文件中(~/.dsh/profiles/ /cordis.patch.yml):

- id: dsh-kimicode-swarm
  name: dsh-kimicode-swarm
  config:
    requireSwarmMode: true      # 设为 false 时主 Agent 可无需手动开启直接调用
    timeoutMs: 7200000          # 单个子 Agent 超时时间,默认 2 小时,0 表示不限
    maxConcurrency: 0           # 插件侧单批并发上限,0 表示不额外限制
    modelMappingEnabled: false
    modelMapping:
      - type: explore
        provider: deepseek-official
        model: deepseek-v3

enabled 与 announceToAgent(默认均为 true)在插件挂载时读取,修改这两项后插件会自动重新挂载。

提升并发上限:宿主默认最多同时激活 8 个子 Agent,超出部分由调度器自动排队。如需提高并发度,可在 DSH 的「子智能体」设置页修改,或在 profile 的 subagent 条目中配置:

- id: subagent
  name: '@deepseek-ai/dsh-subagent'
  config:
    maxActiveSubagents: 32

使用说明与注意事项

  • 运行环境:实时进度卡片与设置面板基于宿主的 webServer 服务构建,插件在 web profile 下加载启用。
  • 网络与访问控制:/swarm-events 进度流具备跨站请求校验(检查 Origin 与 Host),同源连接下由前端按会话过滤进度事件。DSH 默认仅监听本地回环地址;若使用 --host 将服务暴露至局域网或公网,建议配合反向代理或外层访问控制使用。
  • 进度展示粒度:运行卡片实时跟踪子 Agent 的生命周期状态、工具调用计数、当前活动工具名与运行耗时,子任务的完整回答在执行完成后渲染。
  • 页面刷新与状态恢复:运行中和已完成的批次在刷新页面后均可完整恢复卡片视图;中途手动取消的批次在刷新后会收起实时状态行,并在折叠面板中保留已收集的结果文本。
  • 工作区并发协作:子 Agent 共享当前工作区目录。执行涉及文件写入的任务时,建议按目录或模块边界划分任务项,避免多个子 Agent 同时修改同一文件。

更多平台细节与版本更新记录请参见 docs/KNOWN-ISSUES.md。