前言¶
用 DSH 做多智能体开发，常见的做法是同时开几个会话，各自派活，最后靠人工翻日志对齐谁写了什么、谁验证了什么。能协作，但交付证据散在各处：验收命令没人复跑、实现者自己说完成即完成、任务之间的依赖关系只存在于提示词里。
agent-bot（npm 包名 @eternalnight/agent-bot，维护者 EternalNight996）就是针对这个缺口做的插件。它把一次 DSH 会话变成一支结构化交付团队：掌教带队的任务 DAG、独立审查、交付时就地运行产物并汇总证据。项目是 AgentTeams 的衍生，MIT 许可。下面按功能、安装、用法、门禁几个部分介绍。
这是什么¶
一句话定位：DSH 的多智能体团队协作与交付流水线插件，附带一个桌面宠物组件。
项目信息（来源 GitHub README 与 package.json）：
- 维护者：EternalNight996
- 当前版本：v0.1.6（npm
latest标签） - 许可：MIT
- 运行要求：Node.js
^22.19.0 || >=24 - 社区目录里的分类是「工作流」
- 插件本体不含云依赖，团队状态写在本地
.agent-teams目录
它解决的具体问题是「交付证据」。常见智能体 UI 给人一墙日志；agent-bot 把谁在干活、什么被卡住、交付了什么，连同冒烟结果、独立验收、真实渲染证据放在同一处界面里。
核心功能¶
团队运行时¶
底层不是状态机假动作，是一套可持久化的运行时：
- 掌教（captain）带队的任务 DAG，依赖满足才派发
- 持久成员会话、邮箱、attempt 所有权，支持修复轮次与冷恢复
- 每个角色有独立写域，前端 / 后端 / 合契（集成）互不重叠
- 任务带质量契约：目标 / 范围 / 验收 / 验证命令 / 审查结论
- 实现者不能批准自己的实现；宿主会复跑声明的验证命令
团队状态目录结构：
.agent-teams/<teamId>/
team.json
inbox/
delivery-report.md
# 本地优先；不接云账号
界面与开宗向导¶
插件提供一座「洞府」式界面，内含六件可点设施：山门、道统、功德碑、封神榜、天机阁、宗门志。组建团队的流程是固定的几步：填目标与阵容、AI 按目标拟需求访谈（运行环境、视觉主题、动效强度等）勾选后拍板、计划摊开审核、批准后才创建任何东西、交付时在驱动网关里直接跑起产物。README 中给出的真机采集记录显示，一次「做个贪吃蛇」的交付最后汇总为 2/2 通过、0 阻断、13m33s、165.2K token、¥1.66；这是单次运行记录，不是对任何任务的保证。
角色阵容¶
阵容按「接下来要干什么」组队，席位上限 5，空闲角色不消耗 token。内置 6 套任务阵容，例如功能直交（产品经理、高级开发者、证据收集者、代码审查员）和缺陷修复（代码库入职引导工程师、高级开发者、证据收集者）。定义位置在 src/client/lineup-store.ts，角色显示名取自 src/agency-role-seeds.ts。
桌面宠物¶
插件附带一套独立安装的桌面宠物（形象「小肥鱼」），Windows 端与 DSH 端共用同一套角色资源：
- 25 组逐帧动作：点击回应、睡觉链路、6 种工作状态、拖拽反馈、随机待机
- 空闲时每 18–28 秒漫游一段，停下随机换动作
- 睡觉持续 10 分钟；点一下才醒，不点就继续睡
- 双击唤出 DSH 并展开侧栏；DSH 未运行时会自动启动
- 单击只触发抚摸，不唤起或改动 DSH 窗口；悬停显示状态卡（等级、成长、饱食、心情、精力）
宠物为独立安装包，不依赖 Python 环境，按用户安装到 %LOCALAPPDATA%\Programs\DSH Pet 并创建桌面快捷方式。
安装与启用¶
在 DSH 里安装插件本体，官方命令：
dsh plugin --profile desktop add @eternalnight/agent-bot
# 重开 DSH → 组建团队
桌面宠物单独安装，最近发布的宠物包见 GitHub Releases：
DSH-Pet-Setup-<version>.exe
# 安装到 %LOCALAPPDATA%\Programs\DSH Pet，创建桌面快捷方式
想从源码装，README 给的是从 GitHub 克隆后再添加本目录。注意插件以当前 dsh 进程权限运行，安装前应先检查源码与许可证（项目为 MIT，来自第三方维护者，不是 DeepSeek / 幻方官方出品）。
安装后最小闭环：点「组建团队」→ 填目标与阵容 → 访谈勾选并拍板 → 先审计划再批准 → 看成员跑、交付时在驱动网关里直接看产物。
交付门禁配置¶
quality 字段控制门禁如何审计。下面这些字段和默认值都来自 README 原文：
| 选项 | 默认 | 作用 |
|---|---|---|
autoVerify |
true |
宿主在接收完成的质检任务前，复跑每条声明的 verify 命令 |
autoReview |
false |
所有门禁、目标验收与宿主命令通过后，自动完成就绪的审查任务 |
requireAcceptance |
true |
自动审查要求被审任务的每条验收都通过 |
autoDetect |
true |
检测生成项目自带的 package.json 测试 / 类型检查脚本并一起跑 |
reviewMode |
"auto" |
auto：宿主收口；human：宿主审完停在「待人工复核」 |
commands |
["git diff --check"] |
生成项目的兜底验证命令，不继承插件脚本 |
commandsByProject |
{} |
按项目根目录配置验证命令 |
verifyTimeoutMs |
120000 |
每条验证命令的宿主超时 |
一个例子，宿主审完后停在待人工复核，并为某个项目指定冒烟脚本：
quality:
autoReview: true
reviewMode: "human" # 宿主审核通过后停在「待人工复核」
commandsByProject:
"projects/贪吃蛇": ["node projects/贪吃蛇/smoke.mjs"]
插件自身的发布门禁用 pnpm verify（全量套件）和 pnpm verify:web-routes（浏览器侧契约）做校验。README 也提醒，这套工具的适用面是并行墙钟与独立验证，不是「每个任务都更便宜」：小任务通常一个智能体更划算。
适用场景与注意¶
适合的场景：
- 任务可拆成有依赖的并行工作，交付物能被独立命令验证
- 希望「实现者不自批、宿主复跑验收命令」的团队化流程
- 需要在交付现场直接看到产物运行证据（冒烟、渲染、审查结论）
需要注意：
- 插件以当前 dsh 进程权限运行。安装前应通读源码，确认没有越权的文件系统或网络行为；许可证是 MIT，作者信息见 package.json（署名「梦游」，公司「梦游科技有限公司」）。
- 日常开发应直接运行其开发版验证工具
python desktop-pet/pet.py --check --workspace .检查宠物主流程。这个检查来自 README 的实跑说明（退出码 0 才算通过），算是一个安装后的快速自检手段。 quality默认autoReview: false，即审查任务默认人工确认，适合先跑通再逐步放开。- 星标、版本以 GitHub/npm 实时数据为准，README 里的截图数值是单次运行记录。
结尾¶
agent-bot 的价值在于把「多智能体协作」落到可审计的交付门禁和可点视的界面上，而不是停留在角色卡片和日志墙上。桌面宠物是附加项。项目地址见 SkillHub 目录页与 GitHub 仓库：SkillHub 目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
- 目录页：https://www.skillhub.cn/plugins/EternalNight996/agent-bot
- GitHub：https://github.com/EternalNight996/agent-bot
- npm：https://www.npmjs.com/package/@eternalnight/agent-bot
