前言¶
在 DSH 里做办公类智能体，常见做法是只在对话框里发指令，真正的工作却落在桌面应用里：WorkBuddy 里的报告、千问办公里的排版、磁盘上的 PDF、群聊里的审批。任务状态和产出往往要来回复制，多个 Bot 也缺少统一的线程和权限边界。
BotCrew（hankniu77/dsh-botcrew）把 WorkBuddy 与千问办公（QwenWork）收进同一个 DSH 群聊：成员、@ 提及、附件、审批卡片和实时工位面板在同一界面完成。维护者为 GitHub 用户 hankniu77，分类为客户端插件，采用 local-first 设计——不依赖云端沙箱，不为办公应用单独配置 API Key，也不做屏幕推流；通过 Chromium DevTools Protocol 驱动本机已登录的 Mac 或 PC 上的应用，并暴露与 mcp__office__* 工具一致的操作。
这是什么¶
BotCrew 的定位是：一个群聊，指挥整组桌面 Bot。它在 DSH Desktop 中提供群聊 UI、本地工位面板服务，以及 MCP 服务端，使 UI 与外部 Agent 都能以同一套接口操作 WorkBuddy 与千问办公。
插件当前版本为 0.1.3（见仓库 package.json），许可证 MIT，要求 DSH Desktop 0.2.1+、Node.js 22+（DSH 自带运行时即可）。
核心功能¶
多成员群聊与真实桌面执行¶
群聊内可包含 Chief、WorkBuddy、千问办公及自定义成员（最多 10 人，至少保留 1 人）。通过 @ 指定执行者，任务说明、文件与回复留在同一线程，减少跨窗口搬运。
WorkBuddy 经 CDP 端口 9331 控制，千问办公经 9444；自定义成员由 qoderclicn（千问 CLI）按名称与角色真实执行。
文件、产物与审批¶
支持粘贴本地路径、拖拽或 ＋ 附件 上传；任务产出以卡片形式回到线程。敏感操作可通过 office_request_approval / office_resolve_approval 挂审批，待办在工位面板中可见。
实时工位面板¶
本地面板服务绑定 127.0.0.1:8765，只读为主：并排展示 WorkBuddy 与千问桌面截图、当前任务、队列、调试端口及待审批项。聊天区可打开 工位面板 对照进度。
MCP 与架构¶
每条聊天能力也对应 MCP 工具（如 office_send、office_wait、office_artifacts 等），Agent 可不经过 UI 驱动办公应用。插件由三部分组成：Host 插件（启动本地 panel 服务）、Client 插件（群聊、成员面板、@ 芯片、右侧工位面板）、MCP server。
成员权限¶
可为成员配置 读 / 写 / 命令 / 外发 开关。移除正在跑任务的成员时会询问 停止并移除 / 仅移除 / 取消。头部 环境 按钮可随时重新运行环境检测。
环境与依赖¶
| 项目 | 要求 |
|---|---|
| 系统 | Windows 10/11 或 macOS 13+ |
| DSH | Desktop 0.2.1+ |
| WorkBuddy | 5.x，已安装并登录 |
| QwenWork | 1.4+，已安装并登录；CLI 工具 qoderclicn 可用 |
| Node.js | 22+ |
首次打开群聊时会自动检测本机应用。典型路径示例（README 原文）：
Windows: C:/Users/<you>/AppData/Local/Programs/WorkBuddy/WorkBuddy.exe
macOS: /Applications/WorkBuddy.app/Contents/MacOS/WorkBuddy
Windows: .../QwenWorkCN/<version>/resources/bin/qoderclicn.exe
macOS: /Applications/QwenWorkCN.app/Contents/Resources/bin/qoderclicn
已安装未运行时插件会尝试带调试端口自动启动；已在运行但未开调试端口时，会提示 Restart WorkBuddy / Restart 千问，避免静默结束未保存的工作。千问 CLI 未登录时会启动 qoderclicn login 并轮询授权状态。
安装与启用¶
推荐从 DSH 插件市场安装：打开 DSH Desktop → Plugins → Discover，搜索 BotCrew 安装，再在 Workspace → 对话群聊 中打开。若列表尚未上架，可使用本地目录或 Release 包配合 plugin_manager。
本地目录或解压 Release 后的安装方式（README 原文）：
plugin_manager install_bundle { "target": "C:/path/to/dsh-botcrew" }
预构建包可从 GitHub Releases 下载 tarball，解压后对上述 target 指向解压目录执行同一命令。包无 npm 依赖，无需额外 build 步骤。
社区目录页：https://www.skillhub.cn/plugins/hankniu77/dsh-botcrew（独立站点，与 DeepSeek / 幻方无官方从属关系）。
典型用法¶
- 进入 Workspace → 对话群聊 → ＋ 新建群聊。
- 输入指令，按需
@成员，例如：
@WorkBuddy 把这份 PDF 提炼成 8 页汇报，先出大纲，数字要能追溯。
@千问办公 按公司模板 v3 重排，不要改数字。
@Reviewer 检查第 4 页的口径，只回复问题清单。
- 用 ＋ 附件 或拖拽添加文件。
- 在聊天中看进度，需要时打开 工位面板 对照两侧桌面。
- 用 标准 ▾ 切换输出模式，用 会话 N ▾ 切换线程。
成员管理：若群聊中尚未包含 WorkBuddy / 千问，可手动添加；自定义成员填写名称与角色，由 qwen CLI 执行。
适用场景与注意¶
适合：已在 Windows 或 macOS 上使用 WorkBuddy 5.x 与 QwenWork 1.4+，希望在 DSH 里用一条线程协调提取、排版、复核，并需要本地工位可视化与审批门禁的团队或个人开发者。
注意：
- 插件以当前 DSH 进程权限运行，安装前请阅读仓库源码与 MIT 许可证，确认路径与自动化行为可接受。
- 面板与 CDP 均在本机 127.0.0.1 侧完成，README 说明不存储办公账号密码；仍应对本机已登录的办公应用与会话安全自行负责。
- WorkBuddy / 千问版本与调试端口要求需满足 README 中的 Requirements，否则首次运行设置卡片会持续提示修复。
结尾¶
BotCrew 把「一个群聊 + 真实桌面 Bot + 产物与审批留在线程里」落到 DSH 客户端插件与 MCP 双通道上，适合 local-first 的办公自动化编排。进一步了解可查看目录页 skillhub.cn/plugins/hankniu77/dsh-botcrew 与源码仓库 github.com/hankniu77/dsh-botcrew。
