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

oh-my-dsh

对等 harness 所具备的每一项能力，都以 DSH 插件的形式提供。

一个面向 DeepSeek Harness（DSH）的能力库——
自始至终开放，绝不触碰 agent 循环。

面向 DSH agent 的能力面，移植自那些做对了的 harness。每个插件都通过有文档记录的扩展接缝注册——绝不修补骨架，绝不增加热路径开销。

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

[!NOTE]
oh-my-dsh 是一个能力库，而非 fork。每个插件都将来自某个对等 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——带冲突协调的多 agent 编排

tower 将一组指令分派给一个 worker 子 agent 团队，它们并发地对同一个仓库进行迭代。每个 worker 都会读取共享的团队简报（因此 M1 负责 README，而 M2 读取它），随后一名 reviewer——始终使用主模型——重新审阅它们的输出并标记冲突。移植自 kimi-code 的 /tower（MoonshotAI/kimi-code#2633）。fleet-orchestrator、microagents 和 specialist-agents 覆盖了各种扇出形态的长尾场景。

03 · 写入前密钥扫描，作为单调防护

secret-scanner 注册一个 tools.guard，拒绝那些参数中携带 API 密钥、令牌或私钥的 write/edit/apply_patch 调用——在任何文件系统变更之前，且不
allow-override 路径。保守模式，低误报。repo-secret-audit 扫描磁盘上已有的内容；git-secret-gate 监视即将被提交的内容。

04 · 在模型漂移中途捕获它的流规则

stream-rules 在模型偏离脚本的那一刻，将正则匹配的提醒注入流中——oh-my-pi 的时间旅行流规则，在 DSH 的事件瀑布上重建。semantic-compression 在保留含义的同时压缩上下文；cache-aware-compaction 和 compact-fidelity 让压缩保持诚实。

05 · 跨越 shell 接缝的 GitHub 工作流

github-workflow 通过 ctx.shell（resolve → run）封装 gh CLI（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 守护测试框架本身。

14 · 纪律本身：接缝，而非手术

每个插件都作为副作用注册（ctx.effect() / ctx.on()），通过
inject 声明其服务，并将能力拆分为三部分接缝：interface（类型化契约）、
implementation（后端）、consumer（面向模型的工具）。没有 agent-loop 编辑，没有热路径
分配，没有硬编码旋钮。

安装

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

插件是 plugins/ 下的 ESM 包（@oh-my-dsh/）。在 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 是一个全插件测试框架：agent loop 本身就是一个插件，新行为通过
文档化的接缝落地——绝不通过编辑骨架。

| 接缝 | 用途 |
| --- | --- |
| 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）、子代理委派（/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 个插件——类型检查 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。

_为保持开放的 harness 而做_

- GitHub
- 缺口账本
- DeepSeek Harness