前言¶
在 DeepSeek Harness（DSH）中扩展能力时，常见问题不是“能不能加一个插件”，而是多个配置入口分散：MCP servers、用户 skills、API key 轮换、图像理解端点往往要分别改配置或写额外工具。XJungit/omdp 把这些能力整理成三个可独立安装的 DSH 插件，并放在同一个 monorepo 中。每个插件位于独立子目录，也可以作为独立 DSH bundle 安装。下面介绍它的功能、安装方式和使用边界。
这是什么¶
XJungit/omdp 是一个 DeepSeek Harness（DSH）插件 monorepo，维护者为 XJungit，许可证为 MIT。它将三个 @omdp/* 插件放在不同子目录中：
dsh-connector/：@omdp/dsh-connectordsh-key-fallback/：@omdp/dsh-key-fallbackdsh-vision-bridge/：@omdp/dsh-vision-bridge
仓库通过 GitHub Actions 在每个 v* tag 自动发布 npm 包。你可以按插件粒度安装，也可以只安装其中一个。
核心功能¶
@omdp/dsh-connector¶
在 DSH Web UI 的 Connector 设置页管理三件事：
- MCP servers；
- 用户 skills；
- 只读 market explorer。
该插件的 market data 只保存在进程内存中，TTL 为 30 分钟，不落盘。
@omdp/dsh-key-fallback¶
提供多 API key 池、自动轮换、显示实际使用的 key，并支持 key 冷却/删除等管理操作。失败请求的重发由 DSH 的 dsh-llm-retry 负责。
@omdp/dsh-vision-bridge¶
让 text-only 模型通过可配置的 OpenAI 兼容多模态端点处理粘贴或拖入的图像。默认使用 Agnes agnes-2.5-flash。
安装与启用¶
npm 安装¶
在 ~/.dsh/profiles/<name>/package.json 的 dependencies 中加入需要安装的包。本文不固定具体版本号；请在 npm 上选择当前可用版本后写入：
@omdp/dsh-connector
@omdp/dsh-vision-bridge
@omdp/dsh-key-fallback
然后执行：
cd ~/.dsh/profiles/<name>
pnpm install
如果只安装其中一个，只添加对应依赖即可。
更新¶
cd ~/.dsh/profiles/<name>
pnpm update @omdp/dsh-connector @omdp/dsh-vision-bridge @omdp/dsh-key-fallback
GitHub 安装¶
如果不想先本地 clone，也可以用 dsh plugin add 从 GitHub 子目录安装：
dsh plugin --profile web add github:XJungit/omdp#path:dsh-connector
dsh plugin --profile web add github:XJungit/omdp#path:dsh-vision-bridge
dsh plugin --profile web add github:XJungit/omdp#path:dsh-key-fallback
如果没有全局 dsh 命令，可以把 dsh 前缀替换为 npx @deepseek-ai/dsh：
npx @deepseek-ai/dsh plugin --profile web add github:XJungit/omdp#path:dsh-connector
npx @deepseek-ai/dsh plugin --profile web add github:XJungit/omdp#path:dsh-vision-bridge
npx @deepseek-ai/dsh plugin --profile web add github:XJungit/omdp#path:dsh-key-fallback
pnpm ≥10 的 git 安装¶
GitHub 安装会获取源码。pnpm 默认会拒绝运行 git 依赖的 prepare/build 脚本；如果第一次 add 失败，需要在 profile 的 pnpm-workspace.yaml 中显式允许对应包的构建脚本：
allowBuilds:
'@omdp/dsh-connector': true
'@omdp/dsh-vision-bridge': true
'@omdp/dsh-key-fallback': true
保存后重新执行对应的 add 命令。这个白名单相当于允许在 install 时运行包代码，因此应只对信任的来源开启。对不信任来源，可以 pin commit，例如使用类似下面的选择器：
github:XJungit/omdp#<sha>&path:<subdir>
典型用法¶
管理 MCP 与 skills¶
安装 @omdp/dsh-connector 后，从 DSH Web UI 的 Connector 设置页进入管理界面。可以在同一设置页维护 MCP servers、用户 skills，并浏览只读 market explorer。market explorer 的数据只保留在进程内存中，30 分钟 TTL 后过期，不会写入磁盘。
管理多个 API key¶
安装 @omdp/dsh-key-fallback 后，可以维护一个多 API key 池。它支持自动轮换、显示实际使用的 key，以及 key 冷却/删除等管理操作。失败请求的重发由 DSH 的 dsh-llm-retry 处理。
给 text-only 模型添加图像理解¶
安装 @omdp/dsh-vision-bridge 后，可以为 text-only 模型配置一个 OpenAI 兼容多模态端点。当你粘贴或拖入图像时，插件通过该端点处理图像。默认使用 Agnes agnes-2.5-flash。
适用场景与注意¶
这个仓库适合以下场景：
- 想把 MCP servers、skills 和 market 浏览放在 DSH Web UI 中统一管理；
- 需要多个 API key，并希望在请求间轮换、查看实际使用的 key；
- 使用 text-only 模型，但希望把图像交给外部多模态端点处理。
使用前需要注意：
- DSH 插件以当前
dsh进程权限运行。安装前应检查源码、依赖和许可证。该仓库声明 MIT 许可证，但仍建议对实际安装来源做确认。 - git 安装会拉取源码。
allowBuilds不是普通依赖项，它会允许安装时执行包内脚本或代码；不信任来源应 pin commit。 @omdp/dsh-connector的 market data 只在内存中保留 30 分钟，不适合当作持久化缓存。@omdp/dsh-key-fallback不负责重发；重发交给 DSH 的dsh-llm-retry。
