{"_id":"@aaroncarry/dsh-plugin-swarm","_rev":"2-ac2ed45ec96b9a15c80dfba8c7b35415","name":"@aaroncarry/dsh-plugin-swarm","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@aaroncarry/dsh-plugin-swarm","version":"1.0.0","keywords":["deepseek-harness","dsh","cordis","plugin","multi-agent","swarm","orchestration","subagents","master-worker"],"license":"MIT","_id":"@aaroncarry/dsh-plugin-swarm@1.0.0","maintainers":[{"name":"aaroncarry","email":"aaron.linzx@gmail.com"}],"dist":{"shasum":"9165586b5c32c04af1a3040995872b915c16d3ed","tarball":"https://registry.npmjs.org/@aaroncarry/dsh-plugin-swarm/-/dsh-plugin-swarm-1.0.0.tgz","fileCount":6,"integrity":"sha512-fn/d+GS4+Ibuev9WKdLofwhYo93Jyg7iPxNH+gfSt05aKjdY5ayl7GTd3mWIjdPoHznqfdXbf5tWwXaMG0QUkQ==","signatures":[{"sig":"MEQCICcZjf4e0XO+yPmhqvNlmkoIu9S5VHo0a3PBQpQ+GJhtAiALf/cxI9fvpQA7qf53Y8149NKH4Z4btBbTBbF0S4046A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":41748},"main":"src/index.js","type":"module","types":"index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./index.d.ts","default":"./src/index.js"},"./package.json":"./package.json"},"gitHead":"cc33601de5b20af7b6776f479ed8fc21f3c3255d","scripts":{"check":"node --check src/index.js"},"_npmUser":{"name":"aaroncarry","email":"aaron.linzx@gmail.com"},"_npmVersion":"11.12.1","description":"Master/worker multi-agent orchestration plugin for DeepSeek Harness: one master agent fans a goal out to parallel worker subagents with per-tier budgets, optional review-with-redo, and a final synthesis step.","directories":{},"_nodeVersion":"24.15.0","_hasShrinkwrap":false,"peerDependencies":{"@deepseek-ai/cordis":">=4.0.0","@deepseek-ai/dsh-llm":">=0.1.0-rc.0 <0.2.0","@deepseek-ai/dsh-agent":">=0.1.0-rc.0 <0.2.0","@deepseek-ai/dsh-tools":">=0.1.0-rc.0 <0.2.0","@deepseek-ai/dsh-subagent":">=0.1.0-rc.0 <0.2.0"},"peerDependenciesMeta":{"@deepseek-ai/dsh-llm":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/dsh-plugin-swarm_1.0.0_1786701101779_0.06640569726188428","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@aaroncarry/dsh-plugin-swarm","version":"1.0.1","description":"Master/worker multi-agent orchestration plugin for DeepSeek Harness: one master agent fans a goal out to parallel worker subagents with per-tier budgets, optional review-with-redo, and a final synthesis step.","homepage":"https://github.com/aaroncarry/dsh-swarm#readme","repository":{"type":"git","url":"git+https://github.com/aaroncarry/dsh-swarm.git"},"bugs":{"url":"https://github.com/aaroncarry/dsh-swarm/issues"},"type":"module","main":"src/index.js","types":"index.d.ts","exports":{".":{"types":"./index.d.ts","default":"./src/index.js"},"./package.json":"./package.json"},"scripts":{"check":"node --check src/index.js"},"keywords":["deepseek-harness","dsh","cordis","plugin","multi-agent","swarm","orchestration","subagents","master-worker"],"license":"MIT","engines":{"node":">=20"},"peerDependencies":{"@deepseek-ai/cordis":">=4.0.0","@deepseek-ai/dsh-agent":">=0.1.0-rc.0 <0.2.0","@deepseek-ai/dsh-llm":">=0.1.0-rc.0 <0.2.0","@deepseek-ai/dsh-subagent":">=0.1.0-rc.0 <0.2.0","@deepseek-ai/dsh-tools":">=0.1.0-rc.0 <0.2.0"},"peerDependenciesMeta":{"@deepseek-ai/dsh-llm":{"optional":true}},"gitHead":"ef79d5104bf2c9d15260b5a6c3786880b06b25ab","_id":"@aaroncarry/dsh-plugin-swarm@1.0.1","_nodeVersion":"24.15.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-DSFVEcbJOi3kvbNTp04kK8sfx+0qZsBO9KvwbbQsMvZA6hnc2/obz52aWgltYqQV2fYunNPCwq6Y4hN0L9C/7Q==","shasum":"5dbc70412aefb32f7f15ca3ec4fd991de958068a","tarball":"https://registry.npmjs.org/@aaroncarry/dsh-plugin-swarm/-/dsh-plugin-swarm-1.0.1.tgz","fileCount":7,"unpackedSize":49570,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICa02owv0EFcfdh+mF6o3sqQ0fBOMS48zs29Lzq1YrWNAiAQ+02ySNQMbY/DX8op0KRgZzjvNenhda4b7fvTDu4lJw=="}]},"_npmUser":{"name":"aaroncarry","email":"aaron.linzx@gmail.com"},"directories":{},"maintainers":[{"name":"aaroncarry","email":"aaron.linzx@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/dsh-plugin-swarm_1.0.1_1786701948902_0.3992823820600069"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-14T09:51:41.562Z","modified":"2026-08-14T10:05:49.236Z","1.0.0":"2026-08-14T09:51:41.974Z","1.0.1":"2026-08-14T10:05:49.062Z"},"license":"MIT","keywords":["deepseek-harness","dsh","cordis","plugin","multi-agent","swarm","orchestration","subagents","master-worker"],"description":"Master/worker multi-agent orchestration plugin for DeepSeek Harness: one master agent fans a goal out to parallel worker subagents with per-tier budgets, optional review-with-redo, and a final synthesis step.","maintainers":[{"name":"aaroncarry","email":"aaron.linzx@gmail.com"}],"readme":"# dsh-plugin-swarm\n\n[![npm version](https://img.shields.io/npm/v/@aaroncarry/dsh-plugin-swarm)](https://www.npmjs.com/package/@aaroncarry/dsh-plugin-swarm)\n[![license](https://img.shields.io/github/license/aaroncarry/dsh-swarm)](./LICENSE)\n\n[English](./README.md) | **简体中文**\n\n面向 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的主从式（master/worker）多智能体协同编排插件。\n\n高智力**主 agent**（会话中的 agent）将一个目标分解为并行子任务，分发给拥有不同智力预算的 **worker 子智能体**。Worker 通过 `subagents` 服务在其独立的全新上下文中运行；可选的智能**评审者**对每个结果评分并对不合格任务带反馈重做一次；可选的智能**综合者**将所有结果合并为一份交付物。\n\n```\n                        ┌─────────────────────────────┐\n                        │  主 agent（当前会话）        │\n                        │  swarm_run(goal, tasks…)     │\n                        └──────────────┬──────────────┘\n              ┌────────────────────────┼────────────────────────┐\n              ▼                        ▼                        ▼\n      ┌──────────────┐         ┌──────────────┐         ┌──────────────┐\n      │ worker (fast)│  ...    │worker (std)  │  ...    │worker (smart)│   ≤16 个任务\n      └──────┬───────┘         └──────┬───────┘         └──────┬───────┘\n             └───────────┬────────────┴───────────┬────────────┘\n                         ▼                        ▼\n              ┌──────────────────┐      ┌──────────────────────┐\n              │ reviewer (smart) │ ───► │ 对标记任务重做         │ （可选）\n              └────────┬─────────┘      └──────────┬───────────┘\n                       └───────────────┬───────────┘\n                                       ▼\n                         ┌──────────────────────────┐\n                         │ synthesizer (smart)      │ （可选，默认开启）\n                         │ → 一份最终交付物          │\n                         └──────────────────────────┘\n```\n\n## 特性\n\n- **按智力分级**：`fast`（小输出预算）、`standard`（继承主 agent 的模型）、`smart`（最大预算，用于最难的步骤、评审者与综合者）。\n- **按层级或按任务的模型覆盖**：把廉价层指向廉价模型，把 `smart` 留给你最强的模型。\n- **评审 + 重做**：评审者返回结构化结论和逐任务反馈；被标记 `redo` 的任务带着评审意见再执行一次。\n- **综合合成**：产出一份连贯的最终交付物，并注明每个 worker 的贡献。\n- **叶子安全**：worker 通过 `toolFilter`（若 provider 支持）被禁用 swarm 工具，并在提示中明确不得自行启动 swarm。\n- **可观测**：`swarm_status` 查看活跃/历史运行；`swarm_providers` 列出可用传输与 LLM 路由。\n\n## 安装\n\n插件是一个普通的 cordis 组合行，通过 dsh profile 补丁层挂载。按需选择包来源：\n\n```sh\n# A. 从 npm 安装（推荐；已发布为 @aaroncarry/dsh-plugin-swarm）\ndsh plugin --profile web add @aaroncarry/dsh-plugin-swarm\n\n# B. 直接从 GitHub 安装\ndsh plugin --profile web add github:aaroncarry/dsh-swarm\n\n# C. 本地目录安装（拷贝模式；改代码后需重新 update）\ndsh plugin --profile web add file:../dsh-swarm\n\n# 2. 将下面这行加入 profile 补丁层\n#    $DSH_HOME/profiles/web/cordis.patch.yml  （参见 cordis.patch.example.yml）\n```\n\n组合行（所有配置项均可选）：\n\n```yaml\n- insert:\n    - id: swarm\n      name: '@aaroncarry/dsh-plugin-swarm'\n      config:\n        providerName: spawn\n```\n\n| 配置项 | 默认值 | 说明 |\n| --- | --- | --- |\n| `providerName` | 自动（`spawn` > `fork` > 第一个） | 所有 swarm 子智能体的传输 provider |\n| `maxTasks` | `16` | 单次 `swarm_run` 的任务数上限（1–32） |\n| `historyLimit` | `20` | `swarm_status` 记住的已完成运行数（0–100） |\n| `defaultMaxConcurrency` | `4` | 调用未指定 `maxConcurrency` 时的并行 worker 数 |\n| `tierBudgets.fast` | `4096` | fast 层每次模型请求的最大输出 token |\n| `tierBudgets.standard` | `0` | `0` = 继承主 agent 的预算 |\n| `tierBudgets.smart` | `16384` | smart 层 / 评审者 / 综合者的最大输出 token |\n\nprofile 补丁层会被 dsh 启动监视器热应用；否则重启 dsh。\n\n## 工具\n\n### `swarm_run`\n\n把一个目标分解为最多 16 个独立子任务，以受控并发运行，然后可选评审与综合。阻塞直到整个 swarm 结束。\n\n| 参数 | 类型 | 说明 |\n| --- | --- | --- |\n| `goal` | string（必填） | 总体目标 |\n| `tasks` | array（必填） | `{ label, prompt, tier?, model?, provider? }` —— prompt 必须自包含（worker 看不到会话上下文） |\n| `maxConcurrency` | integer（默认 4） | 并行 worker 数，1–16 |\n| `modelOverrides` | object | `{ fast?, standard?, smart? }` 模型 id；`smart` 同时覆盖评审者与综合者 |\n| `review` | boolean（默认 false） | 智能评审者评分每个结果；被标记的任务带反馈重做一次 |\n| `synthesize` | boolean（默认 true） | 智能综合者把结果合并为一份最终交付物 |\n| `providerName` | string | 覆盖行配置的传输 provider |\n\n返回 `{ runId, goal, provider, tasks: [{ label, tier, status, output, error, redone }], review, finalAnswer }`。\n\n### `swarm_providers`\n\n列出已注册的 subagent provider（含能力）与 LLM 路由——用于挑选合法的 `model` / `provider` 覆盖值。\n\n### `swarm_status`\n\n列出当前活跃与最近完成的 swarm 运行（`limit`，默认 5，最大 20）。\n\n## 环境要求\n\n- dsh 部署的主机组合提供 `subagents`（至少一个 provider，如 `spawn`）与 `tools`。\n- `llm` 服务为可选，仅用于丰富 `swarm_providers` 的返回。\n\n## 开发\n\n无构建步骤——包直接发布源码。本地迭代：\n\n```sh\nnode --check src/index.js        # 语法检查\ndsh plugin --profile web add link:../dsh-plugin-swarm   # 软链安装（需依赖可解析）\n```\n\n运行时零依赖：一切通过 cordis 服务注入。`peerDependencies` 中的 `@deepseek-ai/dsh-*` 是对部署契约的说明；任何真实部署都已自带这些包。\n\n## 许可证\n\nMIT —— 参见 [LICENSE](./LICENSE)。\n","readmeFilename":"README.zh-CN.md","homepage":"https://github.com/aaroncarry/dsh-swarm#readme","repository":{"type":"git","url":"git+https://github.com/aaroncarry/dsh-swarm.git"},"bugs":{"url":"https://github.com/aaroncarry/dsh-swarm/issues"}}