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 实现由上游作者维护，并使用相同许可证。