队友上限调节器 Soulize/dsh-agent-teams-optimizer

dsh-agent-teams-optimizer

一个独立的 DeepSeek Harness 插件，用来配置真正生效的 Agent Teams 队友准入上限。它改的是 spawn_teammate 创建新的持久队友时检查的那个数字，而不只是让模型多用几个队友。

官方 Agent Teams 配置档里，agent-team 配的是 maxMembers: 8。没有配置档覆盖时，底层 TeamService 默认是 16。本插件默认 16，允许任意正的安全整数。

安装

先启用官方 Agent Teams 套件。然后在同一个配置档里安装优化器：

dsh plugin --profile web add "github:Soulize/dsh-agent-teams-optimizer#main"

添加插件后重启 DSH。在 Web/Desktop 里打开 Plugins -> dsh-agent-teams-optimizer -> agent-teams-optimizer -> Configure，填入想要的 maxMembers，保存。DSH 会把选项存进当前配置档；只要当前官方内部结构兼容，改动会直接作用到运行中的 Team 服务，不用重启。

直接改配置档的话，这样写：

- id: agent-teams-optimizer
config:
maxMembers: 32

插件自带的套件补丁只插入 agent-teams-optimizer。它不会覆盖官方 Agent Teams 的配置行，也不会动任何无关设置。

行为

- 上限只统计队友，Lead 不计入。
- 这是累计的、不可逆的名册上限，不是同时运行数上限。哪怕成员已不活跃或已失败，它的名额依然占着；调高上限可以容纳更多不同的名字。调低上限不会删除历史成员。
- 它改的是真实的 TeamRoster 准入字段，所以当前 Team 服务里已有的和将来的团队都会按新值执行。
- 普通 Subagent、工作流和嵌套委派的上限不受影响。
- Agent Teams 没启用时，优化器保持空闲。官方 agentTeams 服务可用后，它会自动绑定。
- 禁用或卸载本插件时，只有在没有其他组件改过同一字段的前提下，才会恢复原来的名册上限。

实现与兼容性

官方 TeamService 目前在 TeamRoster 构造函数里捕获 maxMembers，没有公开的运行时 setter。改 agent-team 的 Cordis 配置档行，是服务启动时设置上限的受支持做法。本插件换了个思路：有条件地更新现有名册的 maxMembers 属性，从而提供可编辑的实时 UI。这是未文档化的内部字段，不是稳定的 DSH API。

适配层在动手之前，会先检查官方服务和可写字段的形状是否符合预期。将来某个 DSH 版本改了这些内部结构，插件会记一条警告，不会假装设置已经生效。它不替换 spawnTeammate，不对工具处理函数做 monkey-patch，也不改动名册的历史记录。
如果只需要稳定的配置方案，可以用这个配置档覆盖（整个 config 对象会被补丁替换，所以要一并写上其余字段，保留官方显式值）：

- id: agent-team
config:
maxMembers: 32
maxTasks: 256
maxMessageBytes: 65536
disposalTimeoutMs: 5000

这两种做法不要在运行时争抢同一个上限。如果两者同时存在，优化器会把服务挂载时看到的值当作恢复基线。

验证

兼容的 Team 服务挂载后，在 DSH Host 日志里找类似这样的一行：

agent-teams-optimizer: maxMembers=32 (previous=8, official baseline=8, reason=service-mounted)

测试方法：在一个 Team 里创建超过八个不同的队友。第九个创建成功，就说明改的是运行时上限，而不只是提示词。模型实际怎么表现是另一回事：调高上限并不会逼 Lead 多生成智能体。

用 npm test 跑单元测试（用的是 Node 内置的测试运行器）。

环境要求

- 官方 DeepSeek Harness Agent Teams 服务（@deepseek-ai/dsh-experimental-agent-team），不是第三方 Teams 实现。
- DeepSeek Harness >=0.2.0-rc.1；不设 DSH 最高版本。每次挂载时由运行时适配器校验兼容性。
- DSH 需要 Node.js >=22.19.0。

License: MIT。