OpenLLM 路由桥openllmsh/dsh

@openllmsh/dsh — 通过 OpenLLM 路由 DeepSeek Harness。

一个 DeepSeek Harness（dsh）bundle，将 harness 指向 OpenLLM 网关，并把 OpenLLM 的 MCP 工具交给它。它是一个纯配置的 Cordis 补丁层——从 dsh 侧安装，无运行时代码——它做两件事：

- LLM 路由器——向 dsh 内置的 llm-pi-ai 适配器（openai-completions）添加一个 openllm provider，指向守护进程的本地优先网关（http://127.0.0.1:8787/v1），并将其设为默认模型。无需适配器代码，也无需 API key：该回环接口没有认证门禁；守护进程使用自己的 ~/.openllm/.env 凭据获取签名计划并转发到上游。
- MCP——注册 openllm mcp stdio 服务器（openllm、claude-context、supermemory 工具组）。openllm 二进制文件自行解析 ~/.openllm/.env，因此它也不需要从 dsh 获取任何东西。

dsh 不持有任何 key，也不持有任何 origin——它只与 127.0.0.1:8787 通信，因此它唯一需要的就是 openllmd 正在运行。安装 OpenLLM 是前置条件（见下文）——安装程序会为你启动守护进程；此 bundle 不会安装、提示或引导它。运行在宿主 DeepSeek Harness 上——它所补丁的服务（@deepseek-ai/dsh-llm-pi-ai、@deepseek-ai/dsh-mcp-client）随 @deepseek-ai/dsh-base 一同提供。

前置条件——安装 OpenLLM

只需执行一次——dsh 路由到本地 OpenLLM 守护进程，安装程序会为你设置并启动它（macOS / Linux）：

curl -fsSL https://www.openllm.sh/install | bash

这是 OpenLLM 自己的官方安装程序（规范来源：）；它会对下载的二进制文件进行摘要校验。如果你的策略要求，请在将脚本通过管道传给 shell 之前先获取并阅读它。此 bundle 仅记录该前置条件——它从不运行它。

无需再运行、粘贴或导出任何其他内容——安装程序会启动守护进程并将你的 key 持久化到 ~/.openllm/.env，守护进程从那里为 dsh 提供服务。

安装 bundle

安装到你实际运行的 profile 中。dsh profile 是相互独立的 bundle 栈，因此添加到某个 profile 的 bundle 对其他 profile 不可见——浏览器 UI 仅存在于 web profile 中（web 挂载 dsh-base + dsh-web-app；headless 挂载 dsh-base + dsh-headless）。
裸的 default 配置文件仅包含 dsh-base——没有 Web 界面——因此在那里添加该 bundle 永远不会到达 Web UI。

浏览器 UI（web 配置文件）：

dsh plugin --profile web add github:openllmsh/dsh

无头 / CLI（headless 配置文件）：

dsh plugin --profile headless add github:openllmsh/dsh

然后重启该配置文件。从 GitHub 分发——没有 npm 包。构建好的
lib/ 已提交，因此 git 安装无需构建步骤即可加载（也没有 pnpm
allowBuilds 提示）。使用 github:openllmsh/dsh# 固定某个发布版本。

自托管 / 自定义端口

路由器基础地址（http://127.0.0.1:8787/v1）在 cordis.patch.yml 中是固定的。若要
通过自托管的 OpenLLM 进行路由，请在安装守护进程时将其指向你的源——dsh 仍然只是与
127.0.0.1:8787 通信。自定义守护进程端口
（OPENLLM_DAEMON_PORT）意味着需要编辑 cordis.patch.yml 中的 baseURL 以匹配。

开发

pnpm install
pnpm build            # tsdown → lib/index.mjs (+ .d.mts) — 提交结果
pnpm typecheck        # tsc --noEmit

dsh plugin --profile demo add .          # 将此 bundle 链接到临时配置文件中
dsh --profile demo --dump-config         # 检查组合后的插件树

该 bundle 的实质内容是 cordis.patch.yml（通过 dsh.bundle.patch
清单字段解析）；src/index.ts 是一个 export {} 占位符，没有运行时 API，
与 @deepseek-ai/dsh-base 一致。

lib/ 已提交（GitHub 是唯一的分发渠道），因此每当 src/ 发生变化时都要重新构建并
提交它——git 安装加载的正是过时的 lib/。

开发者预览版——dsh 尚未发布 1.0；请固定版本并针对每次 dsh 升级重新测试。

许可证

MIT © OpenLLM, INC — 参见 LICENSE。