oh-my-dsh

Topics: deepseek-harness · dsh-plugin · dsh-ecosystem · oh-my-dsh

从其他开源 harness 中选取有用的能力，重写为适配 DSH（DeepSeek Harness SDK）的插件。 所有插件遵循 DSH 的插件规范：只通过扩展接缝（ctx.effect() / ctx.on() / ctx.tools 等）注册， 不修改 agent-loop 骨架、不引入热路径开销。

目标

DSH 是一个插件化的 agent harness。opencode、oh-my-pi、Codex CLI、Claude Code、pi、Goose、Aider、 LangGraph、PyRIT 等工具各有成熟能力（编排、记忆、审批、评估、安全护栏、自动化、开发者体验……）。 本项目逐项对照这些工具，把其中对 DSH 用户有用的能力以插件形态重写并适配 DSH 的接缝与约定， 形成可直接安装的能力库。

工作流：

调研（对照开源 harness，找出可借鉴的能力）
  → 登记差距（GAP-LEDGER.md）
    → 设计插件（遵循 DSH 能力接缝三件套：interface / implementation / consumer）
      → 实现 + vitest 测试
        → e2e 验证（挂载进真实 DSH 环境 + 真实 LLM 冒烟）

• 差距登记：GAP-LEDGER.md + swarm/ledger/ 下的条目，状态机：open → designing → implementing → verifying → closed
• 插件纪律：注册是副作用（ctx.effect() / ctx.on() 返回 disposer）；能力接缝三件套；显式 > 隐式；配置可调、无硬编码；禁改 agent-loop
• 验证：每个插件 vitest 单测全绿 + typecheck 0 错误；e2e 环境挂载全部插件做注册校验与真实 LLM 冒烟

目录结构

oh-my-dsh/
├── README.md              ← 本文件
├── AGENTS.md              ← 仓库操作手册
├── GAP-LEDGER.md          ← 差距总账（状态机）
├── swarm/
│   └── ledger/            ← 差距条目 GAP-xxxx.md（含对照项目证据）
├── plugins/               ← DSH 插件实现（按包组织，每个差距一个包）
├── e2e/                   ← 端到端验证（挂载插件 + 注册校验 + LLM 冒烟）
└── docs/
    ├── architecture.md    ← 插件设计规范（接缝三件套）
    └── performance.md     ← 性能基线

快速开始

# 1. 安装并运行全部测试
pnpm install
pnpm test

# 2. 单个插件
cd plugins// && pnpm install && pnpm test

# 3. e2e 验证（需 DSH_HOME/.env 中的 DEEPSEEK_API_KEY）
bash e2e/run-e2e.sh

对照项目

项目	定位	借鉴的能力面