插件能力库 LaplaceYoung/oh-my-dsh

oh-my-dsh

同类 harness 有的能力，全都做成 DSH 插件。

DeepSeek Harness（DSH）的能力库——全程开放，绝不碰智能体循环。

这是 DSH 智能体的能力面，从那些做对了的 harness 移植而来。每个插件都通过有文档的扩展接缝注册——从不给骨架打补丁，从不给热路径加负担。

530 个插件 · 3731 个测试 · 2183/2183 项 e2e 注册检查 · 6/6 项针对真实 DeepSeek 模型的实时会话检查。

[!NOTE]
oh-my-dsh 是能力库，不是分支。每个插件把同类 harness（Claude Code、Oh-my-pi、kimi-code、opencode、Codex CLI……）的一处缺口适配成可直接替换的 DSH 插件。完整的缺口清单在 GAP-LEDGER.md。

这些能力，_都做了适配_。

01 · 深度研究，接上 ctx.web + ctx.llm

deep-research 把复合问题拆成子问题，通过 DSH 可移植的 web 接缝并行搜索并抓取来源，最后综合成一份带引用的报告。配置 provider + model，综合这一步就走 LLM；不配置，也照样产出一份确定性模板报告——每条路径都能优雅降级，测试时都不需要真实密钥。

02 · Tower——多智能体编排，带冲突协调

tower 把一串指令派发给一队 worker 子代理，让它们并发迭代同一个仓库。每个 worker 都读共享的团队简报（所以 M1 负责 README，M2 读它），然后由 reviewer——始终跑在主模型上——重读它们的产出并标出冲突。移植自 kimi-code 的 /tower（MoonshotAI/kimi-code#2633）。fleet-orchestrator、microagents 和 specialist-agents 覆盖了各种长尾的扇出形态。

03 · 写入前的密钥扫描，作为单调守卫

secret-scanner 注册一个 tools.guard，拒绝参数里带 API key、token 或私钥的 write/edit/apply_patch 调用——在任何文件系统改动之前，且不带任何允许覆盖路径。保守模式，低误报。repo-secret-audit 扫描磁盘上已有的内容；git-secret-gate 盯住即将提交的内容。

04 · 流式规则，在模型跑偏时当场拦截

模型一旦偏离脚本，stream-rules 立刻把正则匹配的提醒注入流中——oh-my-pi 的时光旅行流式规则，在 DSH 的事件瀑布上重建。semantic-compression 压缩上下文同时保留语义；cache-aware-compaction 和 compact-fidelity 保证压缩不失真。

05 · GitHub 工作流，架在 shell 接缝上

github-workflow 通过 ctx.shell（resolve → run）包装 gh 命令行（issue create/list、pr list），并带 child_process 兜底，供独立使用。返回途中解析结构化的 --json 输出。pr-description 和 pr-review-bot 接力，从分诊走到评审。

06 · 血缘与看板投影

branch-tree 渲染分叉血缘（父→子、祖先链、分叉点），task-board 投影并行任务看板（列、阻塞原因、依赖树）——两者都防环。数据留在会话内；持久化是消费方的一步。

07 · 会话，_完整生命周期_

二十四个 session- 插件覆盖了没有任何单一 harness 能端到端包揽的全过程：session-snapshot 和 session-rewind 负责检查点回滚，session-share 负责云端链接，session-search / session-retrieval / session-semantics 负责找回旧工作，session-rbac 负责谁能碰什么，session-replay 和 session-export 负责审计。opencode 的分享模型、Codex 的 rollout 词汇、Claude Code 的检查点——在同一个命名空间里调和。

08 · 审批，配一套词汇表

六个 approval- 插件把权限提示变成策略：approval-vocabulary 按工具记住 once/always/reject（Codex CLI 的 /approvals），approval-queue 和 approval-persist 让决策持久可审，approval-diff 和 approval-binding 把每个决策绑定到它批准的确切改动，approval-grace 加上会过期的信任。autonomy-tier 设定上限。

09 · 记忆，活过会话

memory-writeback 落地 Claude Code 的 CLAUDE.md 循环；episodic-memory、procedural-memory 和 graph-memory 分别存下发生过什么、什么管用、事物如何关联；memory-consolidation 和 memory-promotion 把反复出现的内容从原始回忆搬进持久知识。默认按项目隔离——智能体对这个仓库学到的东西，留在这个仓库。

10 · MCP，桥接 _且受治理_

七个 mcp-* 插件：mcp-bridge 说协议，mcp-registry 编目服务器，mcp-trust 和 mcp-poison 决定谁可以应答，mcp-capabilities 协商能力面，mcp-browser 驱动浏览器服务器，mcp-extension-ecosystem 让整套东西可被发现。生态齐全，不留供应链盲区。

11 · 浏览器舰队，七个插件之深

browser-driver 负责驾驶，然后每个关注点一个插件：browser-session、browser-a11y、 browser-form-fill、browser-network、browser-scraper、browser-visual-assert。不是一个全能工具——而是把同一份浏览器能力拆成接缝，你可以按需独立挂载。

12 · 红队，内置

jailbreak-detector 和 injection-guard 盯着提示词流，sandbox-escape 和 sandbox-intent 盯着工具面，adversarial-eval 和 redteam-orchestrator 按计划发起攻击，malicious-package-guard 和 supply-chain 盯着装进来的东西。
安全是插件，不是一个阶段。

13 · 可观测性：追踪、指标、成本

otel-genai-traces 和 otel-genai-metrics 输出 OpenTelemetry GenAI 语义约定； trace-waterfall-webui 和 trace-viewer 负责渲染；token-stats、cost-command 和 cache-hit-meter 回答「这个会话烧了什么，烧在哪」。perf-baseline 和 perf-regression-detector 守护 harness 自身。

14 · 纪律本身：接缝，不是手术

每个插件都作为副作用注册（ctx.effect() / ctx.on()），用 inject 声明自己的服务，
并把能力拆成三段式接缝：interface（类型化契约）、 implementation（后端）、consumer（面向模型的工具）。不改智能体循环，不在热路径上分配，不写死旋钮。

安装

git clone https://github.com/LaplaceYoung/oh-my-dsh.git
cd oh-my-dsh
pnpm install

插件是 plugins/<name> 下的 ESM 包（@oh-my-dsh/<name>）。在 DSH 的 cordis.yml 组合里挂载：

- id: omd-deep-research
name: '@oh-my-dsh/deep-research'
config:
provider: deepseek-official
model: deepseek-v4-flash

快速开始

1. All tests + typecheck
pnpm test
pnpm typecheck

2. Registration verification — boots DSH, mounts 530 plugins, asserts 2183 checks bash e2e/run-e2e.sh

3. Real session — full agent stack + all plugins + one real DeepSeek turn
DEEPSEEK_API_KEY=… node --import tsx e2e/run-real-session.mjs e2e/dsh-src

架构

DSH 是全插件 harness：智能体循环本身就是插件，新行为通过有文档的接缝落地——绝不改骨架。

| 接缝 | 用途 |
| ctx.tools | 面向模型的工具（register / guard / restrict） |
| ctx.shell · ctx.fs | shell + 文件系统服务商 |
| ctx.subagents | 子代理（spawn / fork / acp / codex / claude-code） |
| ctx.workflows | 脚本化的多智能体编排 |
| ctx.llm · ctx.web | 模型路由 + 搜索/抓取 |
| ctx.sessionPersistence · ctx.sessionQuery | 持久化会话 + 查询 |
| 事件瀑布 | agent/pre-step、tools/pre-execute、session/event、… |

纪律

- 注册即副作用 —— ctx.effect() / ctx.on()；register() 返回一个清理函数。
- 三段式接缝 —— interface / implementation / consumer。
- 显式优于隐式 —— 默认值写在 resolve(request): Spec 里，而不是 ?? default。
- 性能 —— 注册很轻，热路径不分配内存，监听器 next()。

按领域划分的目录

524 个插件，共用一个命名空间。下面是几个有代表性的切片：

| 领域 | 数量 | 插件 |
| 会话 | 24 | session-snapshot、session-rewind、session-share、session-rbac、session-replay、… |
| Web UI | 19 | webui-plugin-manager、webui-smart-diff、webui-usage-cost-dashboard、webui-virtualized-session、… |
| 智能体与编排 | 12 | tower、agent-hub、agent-teams、fleet-orchestrator、microagents、plan-mode、… |
| 任务管理 | 10 | task-board、task-dependency-dag、task-queue、task-predict、task-results-inbox、… |
| 提示词与模型路由 | 9 | prompt-rewriter、prompt-optimizer、provider-router、provider-fallback、model-routing-policy、… |
| 上下文控制 | 9 | context-usage、context-inject、context-add-dir、context-pin、context-pruner、… |
| 知识 | 9 | knowledge-spaces、knowledge-graph-curator、knowledge-recommender、knowledge-versioning、… |
| 浏览器 | 8 | browser-driver、browser-a11y、browser-form-fill、browser-network、browser-visual-assert、url-summarize、… |
| MCP | 7 | mcp-bridge、mcp-registry、mcp-trust、mcp-poison、mcp-capabilities、… |
| 评审 | 12 | review-checklist、review-feedback、review-thread、pr-review-bot、diff-review、code-metrics、import-graph、dead-code、symbol-index、code-format、… |
| 审批与策略 | 6 | approval-vocabulary、approval-queue、approval-diff、approval-grace、autonomy-tier、… |
| 记忆 | 12 | memory-writeback、episodic-memory、procedural-memory、graph-memory、project-memory、… |
| 可观测性 | 11 | otel-genai-traces、otel-genai-metrics、trace-waterfall-webui、token-stats、cost-command、doctor、… |
| Git 与 GitHub | 24 | github-workflow、git-auto-commit、git-hooks、git-hygiene、git-secret-gate、git-surgery、git-blame、git-churn、git-submodule、git-remote、git-log、git-diff、git-config、git-status、git-branch、git-tag、git-switch、git-pull、git-push、git-merge、git-fetch、git-rebase、git-restore、git-revert |
| 安全与红队 | 13 | secret-scanner、jailbreak-detector、injection-guard、sandbox-escape、adversarial-eval、output-guard、license-checker、dependency-audit、… |
| DevOps 与基础设施 | 22 | docker、k8s、terraform、sqlite、redis、helm、psql、aws、npm-scripts、mysql、gcp、checksum、systemctl、azure、brew、journalctl、openssl、make、apt、ssh-keygen、df-du、gpg |
| 音频与语音 | 6 | audio-transcribe、audio-tts-exec、voice-input、voice-session-ui、… |
| 评估 | 6 | evals、eval-suite-registry、eval-case-mining、eval-dataset-manager、eval-report-clustering、… |
| 文档与数据 | 15 | pdf-parser、epub-reader、sheet-reader、csv-kit、ocr-extractor、word-reader、diagram、json-query、regex-tester、semver-compare、base64、uuid、file-diff、… |

全部内容都在 plugins/ 下 —— 每一处缺口都记录在 GAP-LEDGER.md。

同类 harness

| 项目 | 移植的能力面 |
| Oh-my-pi | 深度研究、编排器提示词、专家子代理、技能注入、流规则、语义压缩、Agent Hub（/agent） |
| Claude Code | 记忆回写、钩子、CLAUDE.md、检查点、回退（/rewind）、计划模式（/plan）、computer use（/computer）、子代理委派（/subagent）、代码审查（/review）、MCP 列表（/mcp）、发布说明（/release-notes）、/init、/memory、/add-dir |
| kimi-code | /tower 多智能体编排、次级模型路由、重访 + 清理 |
| opencode | 会话模型、MCP 生态、编辑器集成 |
| Codex CLI | 审批词汇、会话快照、灰度发布、apply_patch |

完整映射见 GAP-LEDGER.md —— 25 轮，每一处缺口都追溯到来源和状态。

状态

- [x] 530 个插件 —— typecheck 0 错误，3731 个测试全绿
- [x] e2e 注册 —— 2183/2183 项检查（530 个插件挂载进实时 DSH 组合）
- [x] 真实会话 —— 完整智能体栈 + 真实 DeepSeek 回合通过 6/6

开发

pnpm install # workspace deps
pnpm test # vitest across all plugins
pnpm typecheck # tsc -b across all plugins
bash e2e/run-e2e.sh # live DSH boot + registration surface + LLM smoke

插件约定见 AGENTS.md；接缝契约见 docs/seams-reference.md；性能预算见 docs/performance.md。

_made for harnesses that stay open_

- GitHub
- Gap ledger
- DeepSeek Harness