智能体协作编排 secretxuan/oh-my-dsh

Oh My DSH

面向 DeepSeek Harness 的 Agent Teams 发行层。一个 Lead 在同一项目 checkout 中协调持久化 teammate、peer 消息和共享的 compare-and-set 任务图。Windows 用户还可以按需加入原生视觉桌面感知和经过审批的 computer-use 控制。

抢先体验：DeepSeek Harness 当前仍把 Agent Teams 放在私有 experimental workspace package 中。Oh My DSH 在这些 package 进入正式发行前，固定并启动 DSH 0.1.1-rc.2 对应的上游 commit b150a55。

快速开始

前置条件：Node.js 22.19 或更新版本、pnpm、curl、tar，以及 DEEPSEEK_API_KEY。

pnpm add -g github:secretxuan/oh-my-dsh
oh-my-dsh setup

setup 命令只需执行一次，它会把固定版本的 Harness runtime 安装到 ~/.oh-my-dsh。随后在任意项目目录运行：

cd my-project
oh-my-dsh "使用 Agent Teams。让 researcher 阅读代码，implementer 完成修改，reviewer 审查结果。"

当前目录会保持为团队的共享 workspace。只有当请求明确要求 Agent Teams 或 teammate 时，Lead 才会创建成员。

运行 oh-my-dsh doctor 可以检查本地依赖、API key 和托管 runtime。

加入 Windows computer-use

在 Windows 上，把可选的桌面工具安装进 Oh My DSH 的托管 profile：

oh-my-dsh setup --computer-use
oh-my-dsh doctor
oh-my-dsh "使用 Agent Teams 检查这个应用，通过 computer-use 完成操作，并验证结果。"

这个选项会安装 dsh-computer-use-win 0.7.0，提供截图、窗口与 UI Automation 发现、OCR、面向纯文本模型的界面观察和鼠标键盘输入等 18 个工具。选择 DeepSeek-V4-Flash-Vision-Exp 后，computer_screenshot 会通过 DSH 原生图片管线把真实截图交给模型；纯文本模型仍使用结构化 OCR 流程。输入类工具默认仍经过 DSH 审批。由于 Windows 输入会影响全局桌面，所以该能力必须显式启用。

你会得到什么

- 使用 fresh 或已完成轮次 fork 上下文的持久化命名 teammate。
- 带稳定投递 id 的安静 peer 消息与可唤醒 follow-up task。
- 带依赖、所有者、revision 和建议 write scope 的共享任务 DAG。
- 仅限 Lead 的中断，以及不制造轮询循环的状态感知等待。
- 在 Lead session log 中恢复 roster、mailbox 和 task 的崩溃感知机制。
- 不做改写的上游 Agent Team policy 和十个作用域协作工具。

推荐提示词

使用 Agent Teams。把这个功能拆成仓库研究、实现和回归审查。
保持 write scope 互不重叠，并让 Lead 在回答前运行最终测试。

使用三个 teammate 并行调查这些相互独立的失败。为每个失败创建一个共享任务，向 Lead 报告根因；在 Lead 分配互不重叠的 write scope 前不要修改文件。

工作原理

Oh My DSH 是发行层，不是第二套 Agent Team runtime。cordis.patch.yml 启用上游 experimental Team domain 和作用域工具，替换名称冲突的旧 continuation control，选择标准 spawn 与 fork provider，并停用 headless task 不会使用的 RPC type graph。launcher 在执行固定版本 Harness 源码 runtime 时保留你的项目目录作为 cwd。

上游实现始终是事实来源。DeepSeek Harness 正式发布 Agent Teams 后，本项目会移除托管源码 checkout，改为普通的 dsh plugin --profile add bundle。

安全与限制

- 所有 teammate 共享一个 checkout。write scope 用于协调而不是文件锁；Bash、formatter 和 generator 仍可能发生写入重叠。
- Lead 必须在回答前检查最终 diff 并运行测试。
- 首次 setup 会下载 DeepSeek Harness，并安装 headless runtime 的依赖闭包。如果网络要求对 GitHub archive 进行身份验证，请设置 GITHUB_TOKEN。
- Agent Teams 仍处于实验阶段，API 可能随固定的上游 commit 变化。
- 设置 OH_MY_DSH_RUNTIME 可以使用已有的兼容 Harness 源码目录。setup 会安装 headless production 依赖，并且只在其中写入一个托管的 .oh-my-dsh overlay。
- Oh My DSH 使用隔离的 profile 与 session 目录 ~/.oh-my-dsh/home；可以通过 OH_MY_DSH_HOME 改到其他位置，它不会修改已有的 ~/.dsh。
- --computer-use 仅支持 Windows。非管理员进程可能无法操作管理员窗口，UI Automation 的覆盖范围取决于目标应用提供的无障碍信息。

项目状态

首个版本跟随官方 experimental 实现，与 npm 上同名但目标不同的 oh-my-dsh package 无关。欢迎提交实际使用反馈，尤其是安装兼容性、teammate 协作和有价值的默认工作流。

许可证

MIT。DeepSeek Harness 及其 Agent Team 实现由上游作者维护，并使用相同许可证。