多智能体协作场 Tikzen/dsh-agent-arena

dsh-agent-arena

English version

把几位 AI 和人类用户放进同一个持续协作群：大家像在 QQ 群里一样连续发言、并行处理任务并使用工具完成工作。人类可以随时自由发言、@指定 AI、@管理员调整会议，并在右侧协作控制台管理任务、方案与成果。

直接选择已经配置好的 AI 用户，创建长期协作会议，而不是重复填写 provider 和 model。

v0.7.0 更新速览

本版本全面按 DeepSeek Harness Web 0.2.0-rc.2 的 Web、Agent、Session、LLM、Subagent、Workspace 和原生 UI 接口开发，并在独立隔离的 0.2.0-rc.2 Web profile 中完成插件加载、状态接口和构建回归验证。当前 release 只保证在 DSH Web 0.2.0-rc.2 上工作；其他 DSH 版本（包括 0.1.x 和未单独验证的版本）暂不保证兼容，后续会针对其他版本另行制作兼容版 release。

本版本大幅优化 UI 体验，并完成与 DSH 0.2.0 Agent 会话、工具、子 Agent、工作区和原生语言服务的对齐。

DSH 0.2.0-rc.2 对齐

- 角色会话使用 DSH 0.2.0-rc.2 的 Agent、Session 和 Subagent 能力；每个 AI 用户在每场对话中保持独立的顶层 Agent 会话。
- 角色继承当前 DSH Agent Preset 的工具、技能、子 Agent 和审批策略，不再由插件另起一套受限的“模拟 Agent”。
- 模型供应商、默认模型、工作区、会话持久化和原生语言切换均通过 DSH 0.2.0 的服务接入；插件不复制或保存 DSH 中的 API Key。
- 已在隔离的 DSH 0.2.0-rc.2 Web profile 中验证插件 bundle 可加载并返回 Agent Arena 状态；真实模型调用仍取决于本机是否配置可用供应商和权限策略。

每个角色独立的上下文查看与压缩

- 右侧“动态”面板新增上下文使用区，按角色分别显示估算 Token、模型上下文窗口、使用比例、未压缩消息数和组成明细。
- 每个 AI 角色拥有独立的压缩进度和摘要，不会把四个角色错误地共用一个压缩窗口；公开聊天记录仍然对所有角色可见。
- 创建 AI 用户时必须选择压缩方式：DSH 原生压缩或服务端压缩。
- DSH 原生压缩支持角色级“立即压缩”和会议级自动压缩；自动压缩阈值可以调整，聊天区原始记录不会被删除。
- 选择服务端压缩时，主动压缩按钮会禁用并提示当前方式不支持主动压缩；是否可压缩取决于供应商是否提供对应能力，例如 OpenAI Responses API。

角色能力、运行状态与动作审计

- 每个会议或群聊都能单独控制每个 AI 的文件、终端、网络、子 Agent、协作板和 Skill / MCP 能力。
- 能力默认保持开启，但它只是工具识别过滤，不是安全隔离；高风险操作仍应使用 DSH 原生权限模式和审批。
- 动态面板显示运行状态、当前阶段、请求数、Token、接话判断、错误、重试和最近耗时；Token 单独放在第二行，长数字不会挤压其他统计。
- 每个角色的动作记录会保留在历史窗口中，不再由新动作覆盖旧动作。
- 会议支持暂停、继续和重试当前运行；任务板的待开始任务提供明确的“开始任务”按钮。

协作面板与参会阵容整理

- 模式导航可以折叠；动态、任务、决策和成果区域都支持调节尺寸，长会议标题不会把右侧面板或人类输入区挤出屏幕。
- 决策板改为按方案展示意见摘要和详情，更适合比较理由、风险与信心，不再依赖人气投票。
- 选择参会角色后，阵容卡片只显示角色名、供应商/模型和已启用能力，不再展开很长的人格文本；人格仍会完整用于实际对话。
- 中英文界面继续跟随 DSH 原生语言设置，本版本新增的上下文、能力、运行统计和审批文案也已同时提供中英文。

v0.5.0 更新速览

这次更新让不同协作群可以在各自的项目目录工作，解决透明主题下的界面重叠，并让 Agent Arena 直接跟随 DSH 切换中英文。

每场对话独立的工作区

会议、群聊和私聊都可以在各自的设置中保存工作区目录，让角色和管理员在对应项目中执行文件与命令操作，无需为了两个项目启动两份 DSH。

- 输入已经存在的绝对目录；留空则跟随 DSH 启动目录。
- 每场对话分别保存，切换会话不会串用未保存的输入；无效目录会明确提示且不覆盖原设置。
- 正在执行的同一批任务保持原工作目录，下一批任务才使用新设置，避免运行中切换路径。
- 文件协作锁跟随任务所在的工作区解析，降低多角色编辑同一文件时的冲突风险。

工作区目录不等于安全沙箱。 Read Only、Workspace Write 和 Full access 权限仍需独立设置。

透明主题与窄屏布局修复

全屏打开 Arena 时，底层 DSH 侧栏、聊天和输入区不再透过透明主题叠到插件上；退出后恢复原界面，会话内嵌模式不受影响，也不会强制取消壁纸透明效果。另修复窄屏标题、长英文按钮以及聊天与协作面板重叠的问题，让底部操作能正常滚动到。

跟随 DSH 切换中英文

进入 DSH 设置 → 通用设置 → 语言（Settings → General → Language）选择中文或 English 即可。插件不增加独立语言开关，已打开的页面即时更新，未保存的输入也会保留。

- 会议、私聊、群聊、AI 用户管理、协作设置和历史管理统一切换。
- 任务板、决策板、成果库、角色动态、权限及审批操作同步切换。
- 插件生成的新系统提示与校验错误支持双语显示，日期格式跟随语言。
- 只切换界面，不翻译对话内容：角色名称与人格、预设对话、历史消息、任务内容及模型/供应商原始错误保持原文。无法可靠识别的旧版系统提示也保留原文。

翻译维护方式见 本地化开发说明。

感谢贡献者 / Thanks to our contributors

感谢 @linkhaha 在 PR #1 中深度使用并贡献每个聊天独立工作区的功能，也感谢 @ShakeCrane 在 PR #2 中提供透明主题下的界面隔离修复和回归测试。

也向两位说声抱歉：这段时间忙于课业，忘记及时处理消息和 PR，让你们久等了。谢谢你们的耐心、认真反馈与贡献！

特别感谢 @linkhaha 贡献每个聊天独立工作区，@ShakeCrane 贡献透明主题修复和回归测试。抱歉回复和 PR 审查都拖了这么久——我忙于课业，忘记跟进消息了。谢谢两位的耐心与贡献！

v0.4.0 权限与协作界面更新

- 每个对话独立设置 Agent 权限：会议和群聊中的每个 AI 角色（包括管理员）都可以分别选择 Read Only、Workspace Write 或 Full access，不会修改该角色在其他对话中的权限。
- 原生审批式交互：受限角色需要执行高风险动作时，审批请求直接显示在聊天记录中；人类可以允许一次、拒绝，或附加自己的执行要求。
- 完整动作记录：角色动态不再只保留最后几条状态，新增动作历史窗口，可按角色查看完整工作过程、工具、文件锁和错误记录。
- 可调节协作布局：右侧协作栏支持横向拉伸；会议标题区、任务板、决策板和成果库支持纵向调节。标题区向上压缩时文字同步缩小，向下扩展时文字同步放大。
- 更清晰的权限入口：权限模式直接位于“动态”板每个角色卡右侧，不再单独增加会议成员板；保存时显示状态，失败时提供明确提示。

这次更新的目的，是让多 AI 协作不必默认交出完整机器权限：同一场会议里可以让调研角色只读、实现角色写入工作区，并只在确有需要时开放完整权限。

v0.3.3 布局修复

- 超长会议标题现在会在可用宽度内显示省略号，不会再把右侧协作栏或底部人类操作区挤出屏幕。
- 桌面端右侧协作栏支持拖动调整宽度，窄屏自动采用上下布局。
- 人类提示、点名栏、输入框和会议操作按钮始终保持在可视区域，长文字可以正常换行。

v0.3.2 更新速览

- 可自定义队列速率：同渠道每分钟放行次数不再固定为 55，可在协作设置中填写 1–10000。
- 可自定义冷却错误码：默认使用 429、500，支持添加或删除；也能识别部分中转服务把真实 429 包装成 500/get_channel_failed 的情况。
- 更干净的错误展示：空响应自动重试一次，连续为空时静默；其他运行错误移到右侧角色动态栏标红，不再占用聊天区。

v0.3.1 补丁

修复协作设置页面中勾选更新选项后，后台状态刷新会让勾选自动消失的问题。未保存的选择现在会稳定保留，直到用户保存或离开页面。

v0.3.0 更新速览

这次更新主要解决多个 AI 共享供应商渠道时容易触发限流，以及自动接话判断消耗较多 Token 的问题，新增以下三个可选配置：

- 渠道限流冷却选项：同一供应商配置命中用户设置的错误码后，相关角色会统一等待，并优先采用提供方返回的重试时间。默认错误码为 429、500，可以自行添加或删除。
- 同渠道请求队列选项：同一供应商下的正式发言、接话判断、工具续跑、子 Agent、重试和失败请求统一纳入队列。每分钟放行次数可在协作设置中自定义，默认 55；高并发时回复速度可能降低。
- 自动接话判断选项：管理员面板提供自动接话总开关；每个 AI 用户还可以单独关闭自己的判断请求，改由管理员直接判断是否适合接话。这样可以在保留连续讨论体验的同时，由用户自行控制额外 Token 消耗；关闭总开关不会影响人类发言和明确 @AI。

Arena 不读取或保存 DSH 中的 API Key，因此共享渠道按“供应商配置”识别：同一供应商配置下的不同模型会共用队列和冷却，分别配置的供应商则互不影响。

完整版本记录请查看 CHANGELOG.md。

它是什么

dsh-agent-arena 是 DeepSeek Harness 的多人 AI 协作插件。它把人类用户、多个 AI 用户和一个可配置管理员放进同一个长期会话，让讨论、任务执行、方案选择与成果验收发生在统一界面中。

它并不是把同一条 Prompt 并排发送给几个模型。每位 AI 用户都有自己的身份、人格、模型配置和独立 Agent 会话，可以读取完整聊天记录、使用当前 DSH Agent Preset 提供的工具与技能、创建子 Agent，并根据上下文判断是否继续接话。

核心亮点

0. 渠道保护与自动接话策略

- 用户设置可选开启渠道限流冷却：同一供应商配置命中自定义错误码后，所有共享角色一起冷却；默认识别 429、500，并可自由增删。
- 用户设置可选开启同渠道请求队列：共享渠道的角色排队请求，每分钟放行次数可以自定义，降低触发 RPM 限制的概率。
- 自动接话由管理员总开关控制；关闭后不影响人类发言和 @AI。每个 AI 用户还可以单独关闭自动接话。
- 自动接话沿用角色判断后由管理员过滤跑题、重复和刷屏的分配逻辑；用户可以关闭总开关，也可以为某个 AI 单独关闭判断请求以节省 Token。

0.5. 每场对话独立的 Agent 权限

- 每个会议或群聊分别保存角色权限，不会影响同一 AI 在其他会话中的设置。
- 支持 Read Only、Workspace Write 和 Full access 三种模式，管理员也可以单独配置。
- 权限选择位于角色动态卡右侧；正在保存、保存失败都会有清晰反馈。
- 受限模式遇到需要批准的动作时，会在聊天记录中显示审批卡片，由人类做最终决定。

1. AI 用户：先创建角色，再邀请进会话

AI 用户是一等成员，而不是会议表单里的临时模型槽位。

- 从 DSH 系统设置中选择已经配置好的供应商与模型，不在插件里重复保存 API Key。
- 自定义显示名称、头像和人格；人格可以留空，不强迫套用预设。
- 支持预设快捷对话，方便保存角色常用的开场方式或指令。
- 内置常见 AI 品牌头像库，也支持上传图片后拖动、滚轮缩放和正方形裁剪。
- 同一个 AI 用户可以加入私聊、群聊和多个会议；已建立的群聊或会议也能继续邀请新成员。
- 人类用户同样可以自定义昵称和头像，所有消息都以社交软件式头像气泡展示。

2. 像群聊一样持续讨论，而不是固定轮次

被点名的 AI 会并发开始工作，谁先产出就先发送；一次智能体工作也可以按真实进度自然发送多条消息。首次回复之后，每当有人发言，其他角色都会结合完整记录、自己的历史发言和人格，重新判断是否有必要接话。

- 不 @ 任何人时，所有未静默成员都可以参与；@角色名 可以强制指定 AI 回答。
- 支持“某某先别说话”“可以继续回复了”等自然语言静默与恢复。
- 人类可以随时插话，也可以点击“立即停止”终止当前工作。
- 管理员只负责过滤跑题、重复和刷屏，不替角色强行决定立场或发言次数。
- 话题自然收束后会议进入等待状态，不会被删除；人类再次发言即可继续。

3. 任务板：把聊天中的工作真正拆出来

任务板用于记录可执行工作，而不是只在聊天气泡里说“我来做”。

- 创建任务时可填写标题、说明和负责人。
- 状态覆盖：待开始、进行中、待评审、已完成、受阻和已暂停。
- 待开始任务提供明确的“开始任务”按钮；受阻任务可以重新处理或发起复核。
- AI 可以通过共享协作工具主动创建、认领和更新任务，人类也可以直接管理状态。
- 任务信息会进入所有成员的协作上下文，让角色知道谁在做什么，减少重复劳动。

4. 决策板：比较方案，不做人气投票

当讨论中出现多个可行方案时，可以把它们放进决策板进行结构化比较。每位 AI 可以对具体方案留下支持、反对或中立意见，并附上理由、风险与信心；最终选择权始终属于人类。

- 一个决策可以包含多个候选方案。
- 每位角色的理由、风险和信心分别展示，不用票数掩盖分歧。
- 人类可以选择方案、重新选择，或要求全员补充证据。
- 决策记录长期保留，方便回看当时的依据与取舍。

5. 成果库：让产出可以验收

AI 完成文件、链接、结论或阶段总结后，可以登记到成果库。人类能够验收、驳回或要求补充证据；被驳回的结果会重新进入协作流程，而不是在聊天记录里悄悄沉底。

6. 实时角色监控与编辑冲突保护

右侧协作控制台可以逐个展开角色动态，查看当前阶段、正在调用的工具、子代理、最近动作和文件锁。所有成员共享 arena_coordination 协作板；编辑文件前需要原子锁定目标，检测到冲突时会阻止覆盖，角色也可以据此等待、协调或切换任务。

典型使用流程

1. 先在 DSH 设置中配置模型服务商。
2. 在 AI 用户中心创建成员，设置名称、头像、模型与可选人格。
3. 创建私聊、群聊，或选择圆桌会议、AI 法庭、代码评审会、吐槽大会等会议形式。
4. 在群聊中自由发言或 @AI 分配工作；复杂工作拆入任务板。
5. 出现多个方案时放进决策板，让角色分别给出依据、风险和信心。
6. 将文件、链接或结论登记到成果库，由人类完成最终验收。

完整功能清单

- DSH 首页快捷卡片 + 会话顶部“AI 协作”整页模式
- 持久化 AI 用户库：昵称、头像、自定义人格、服务商、模型和预设快捷对话
- 人类用户也可自定义昵称与头像；全部消息使用社交软件式头像气泡
- 一对一 AI 私聊，以及由 2–12 个 AI 组成的多模型群聊；群聊自动加入管理员
- 已创建群聊可随时修改群名；群聊和会议都能从 AI 用户库继续邀请新成员
- DeepSeek、OpenAI、Claude、Gemini、通义千问、Kimi、Grok、豆包、Llama、Mistral 预设头像库
- 支持上传图片、emoji 和本机生成的品牌预设头像，不依赖外部图片链接
- 圆桌会议、AI 法庭、代码评审会、吐槽大会四种预设
- 每场会议选择 2–4 位已创建的 AI 用户，各自沿用用户库中的服务商、模型、名称、头像与人格配置
- 无固定轮数的长期会议；自然收束后进入等待状态并释放智能体资源，人类随时发言即可继续
- 每位 AI 都可在工作过程中自主发送公开消息：发一条还是多条、每条长短由角色结合人格、语义和真实进度决定，不按字数、句号或固定节奏机械切分
- 普通聊天可以直接一次说完；耗时任务可以自然地先说明正在处理，完成后再发送结果，但不会被系统强制要求每轮确认
- 同一批被点名的 AI 会并发工作，谁先完成谁先在群里发送结果；随后每个角色结合完整记录、自己的历史发言和人格，独立判断是否继续接话
- 管理员不替角色决定是否发言，只过滤跑题、重复和刷屏；有实质推进时持续接话，话题偏离或自然收束时安静等待人类
- 支持自由发言、@指定 AI 强制回应、@管理员更换话题/切换协作阶段、暂停、继续、停止当前工作和生成阶段总结
- 支持自然语言静默与恢复，例如“丛雨先别说话”“@丛雨 可以继续回复了”；静默状态会持久化并显示在成员列表
- 管理员的名称、头像、人格、服务商和模型可在用户中心配置
- 右侧协作控制台包含角色动态、任务板、决策板与成果库
- 决策卡展示各 AI 的理由、风险与信心，由人类选择最终方案
- 成果支持验收、驳回和要求补充证据
- 会议和聊天右侧提供可逐角色展开的实时动态：当前阶段、工具、子代理、文件锁与最近动作
- AI 角色共享 arena_coordination 协作板；编辑前原子锁定文件，常用 DSH 文件写入工具会阻止未锁定或冲突修改
- 独立历史管理页：会议、私聊、群聊可分类查看、重命名和手动删除
- 会议不会进入需要“重开”的终态；自然收束、停止当前工作或 DSH 重启后都会回到等待新消息
- 所有记录永久保留，不按数量或时间自动清理
- 用户资料、私聊、群聊和会议记录保存在 DSH_HOME/agent-arena/meetings.json
- 每位 AI 成员都是独立的顶层 DSH 智能体，挂载当前系统默认 Agent Preset，继承其中的工具、技能与子代理能力不 @ 任何成员时，所有未静默的 AI 会同时开始；@某个 AI 时只会请求被点名者。角色可通过 arena_send_message 在一次 Agent 工作中自主发送一条或多条公开消息；同一角色完成本次工作后，系统才会触发其他 AI 的接话判断，避免一句话没说完就被抢话。插件不设置 maxTokens 或子 Agent 深度上限，实际能力仍由所选模型、当前 DSH Agent Preset、权限策略和提供方决定。协作板会保护 DSH 的标准文件编辑工具；角色仍被明确禁止用任意 Shell 写入命令绕过文件锁。

环境要求

- Node.js 22 或更高版本
- DeepSeek Harness Web profile
- 本 release 按 DSH Web 0.2.0-rc.2 开发和验证；其他版本（包括 0.1.x）暂不保证可用，后续会提供兼容版
- 中英文切换依赖 DSH 原生 locale 服务
- 至少一个已经在 DSH 设置中配置好的模型供应商

安装

从本地目录安装

先构建：

cd <插件源码目录>
npm install
npm run build

再挂载到 DSH Web profile：

<DSH 安装目录>\manage-dsh.bat plugin --profile web add <插件源码目录>

重启 DSH 后，首页会出现“进入 AI 协作群”，已有会话顶部会出现“AI 协作”标签。

从 GitHub 安装

本仓库提交了预构建的 lib/，安装时不需要本机 TypeScript 工具链。推荐固定到正式版本：

<DSH 安装目录>\manage-dsh.bat plugin --profile web add "github:Tikzen/dsh-agent-arena#v0.7.0"

如果希望直接跟随 main 分支的最新开发版本：

<DSH 安装目录>\manage-dsh.bat plugin --profile web add github:Tikzen/dsh-agent-arena

随后重启 DSH。

开发

npm install
npm run check
npm run build

本地修改后重新执行 npm run build 并重启 DSH。插件由两部分组成：

- src/index.mjs：HTTP API、用户/聊天持久化、持续协作队列、@路由、管理员动作及子代理编排
- src/client/index.tsx：首页入口、用户库、私聊/群聊和交互式会议面板

默认同时只运行一场会议，可在 cordis.patch.yml 中调整 maxConcurrentMeetings。会议、私聊和群聊记录不会自动清理，只能由人类用户在历史管理中手动删除。

隐私与安全边界

- 会议主题、公开发言和插话会发送给所选模型提供方。
- 会议数据默认仅写入本机 DSH Home。
- AI 成员可以使用 DSH 提供的工具；权限仍受 DSH 当前工作区访问模式与工具审批规则约束。
- 管理员只允许执行服务器白名单中的会议动作，不能通过聊天指令修改密钥、模型权限或任意文件。
- UI 只展示模型的公开回答，不展示或索取隐藏思维过程。

License

MIT

AI 品牌预设头像来自 Lobe Icons，按其 MIT License 使用。各品牌标志及商标归各自权利人所有。