原生模型桥接 libre-webui/dsh-native-provider

用于 Libre WebUI 的 DeepSeek Harness 提供程序桥接

从 Libre WebUI 使用已在 DeepSeek Harness (DSH) 中配置好的模型。可独立选择每个原生提供程序和模型，包括 Flash 和 Pro。提供程序凭据保留在 DSH 中。

这是 DSH 的 Plugins 页面中显示的 @libre-webui/dsh-native-provider 插件。它通过一个私有 Unix 套接字连接这两个应用程序。它不添加任何 Web 服务器、遥测、代理会话或宿主工具。

[!WARNING]
在连接之前，请查看外部 DSH 配置文件的隐私设置。
上游基础配置文件默认启用 DeepSeek 会话日志和插件包贡献，以及由反馈触发的 OTel 导出。OTel 导出可能包含对话上下文和工具数据。
本插件的私有套接字不会禁用这些功能。使用前请遵循三项独立的退出设置；
DSH_TELEMETRY_DISABLED=1 仅禁用 OTel。请参阅
固定的上游默认值以及原生桥接请求与 DSH 会话之间的区别。

flowchart LR
LWUI[Libre WebUI: Chat, Work, titles] -->|Private Unix socket| Bridge[This plugin inside DSH]
Bridge --> LLM[DSH LLM service]
LLM --> Providers[Your configured providers and models]

Libre WebUI 管理对话、用量以及 Work 的沙箱。DSH 提供所选模型的连接。通过本插件，Work 任务永远不会获得对 DSH 原生代理、会话、文件或工具执行的访问权限。

Libre WebUI Work 中选择了 DeepSeek Harness 和一个原生模型。

Work 界面以演示数据展示。

要求

- macOS 或 Linux，且两个应用程序以同一操作系统用户运行。
- Node.js 22.22 或更高版本，这是受支持的 DSH 安装所要求的。
- DSH 的插件管理器可使用 pnpm。通过 DSH 安装本插件不需要 npm、源代码检出或编译器。
- 一个正在运行的 DSH 配置文件，且至少有一个可用的提供程序。本包针对 DSH 0.1.6-alpha.2 和 Cordis 4.0.2 进行了测试；DSH API 尚处于预稳定阶段，因此其他版本需要进行兼容性测试。
- Libre WebUI 0.37.0 或更高版本，其中包含原生提供程序集成。

Unix 连接不支持 Windows、远程 DSH 主机，也不支持原版 Libre WebUI 容器直接连接到宿主套接字。请参阅配置与部署。

安装

在 DSH → Plugins → Add plugin 中，将以下内容粘贴到 Package name or address：

https://github.com/libre-webui/dsh-native-provider

点击 Install。该仓库包含已构建的插件及其 DSH 捆绑补丁。安装不需要构建命令或安装脚本批准。

验证 native-provider 0.1.1 具有正在运行的组件。DSH 会应用一个新的安装到活动配置文件；如果 DSH 显示重启通知，请遵循该通知。
DSH 从包名派生短标题；完整的包标识是 @libre-webui/dsh-native-provider。请使用 GitHub URL，因为裸包名未发布在 npm 上。

默认套接字是 /lwui-provider/llm.sock。通常这意味着 $HOME/.dsh/lwui-provider/llm.sock；已配置的 DSH_HOME 优先。
DSH 会创建私有套接字目录。如果你需要不同的路径或有多个 DSH 配置文件，请参阅配置。

可选的 CLI 等效命令是：

dsh plugin --profile web add https://github.com/libre-webui/dsh-native-provider

请使用你实际的配置文件名称。CLI 安装后重启该配置文件。

连接 Libre WebUI

然后使用相同的绝对路径配置 Libre WebUI 的 cordis.config.yml：

nativeProvider:
socketPath: /absolute/home/.dsh/lwui-provider/llm.sock

将 /absolute/home 替换为你的主目录。YAML 不会展开 $HOME 或 ~。或者，在启动 Libre WebUI 时设置 LIBRE_DSH_PROVIDER_SOCKET。更改其启动配置后重启 Libre WebUI。

在 Libre WebUI 中，以管理员身份启用 Cordis Engine：

1. Work： 选择 DeepSeek Harness，然后从 Native DSH models 中选择一个模型。改为选择 Libre WebUI 模型则会使用其现有的 LWUI provider 连接。
2. Chat： 同时启用 Agent CLI models，然后在 Agents 下使用原生 DSH 模型。
3. Provider Usage： 在 DeepSeek Harness · provider 下检查原生请求。仅显示 provider 报告的用量；缺失的 token 计数不会被估算。

没有默认模型替换：不可用的选择会以错误失败，而不是静默切换 provider。

升级现有安装

对于旧的本地准备的 0.0.0/0.1.0 包，让活动请求完成，然后在该插件页面上使用 Uninstall。返回 Add plugin，粘贴上面的 GitHub URL，然后点击 Install。这会将仅本地源替换为公共仓库。原生 DSH 会话和 provider 凭据不会被删除。使用通常的 DSH home 时，默认套接字与旧指南一致；使用配置中的覆盖项保留自定义套接字。

对于 GitHub 安装插件的后续 CLI 更新：

dsh plugin --profile web update @libre-webui/dsh-native-provider

重启配置文件并验证其版本。要固定或回滚到已审查的修订版本，请安装 github:libre-webui/dsh-native-provider#，而不是移动的默认分支。已禁用的安装会保持禁用，直到启用。

移除

dsh plugin --profile web remove @libre-webui/dsh-native-provider

重启 DSH，并从 Libre WebUI 的配置中移除 nativeProvider.socketPath 或相应的环境变量。显式空 LIBRE_DSH_PROVIDER_SOCKET 会禁用连接，即使 YAML 中已定义它。
已保存的 Libre WebUI 任务会保留；它们需要可用的 provider 才能继续。移除此插件不会删除原生 DSH 会话或密钥。

文档

- 配置、验证与故障排查
- 安全与隐私
- 开发与上游同步
- Libre WebUI 集成指南

开发

npm ci
npm run check
npm audit --audit-level=moderate

测试针对本地 fixtures 和临时 Unix 套接字运行。它们不需要 provider 凭据，也不会发起真实的模型调用。生成的 bundle 仅包含编译后的插件、协议、包元数据、补丁、README 和许可证；不会向 DSH 安装任何 npm 运行时依赖。

该实现与 Libre WebUI 的匹配客户端一同维护，并在此处镜像。
upstream.json 记录了源修订版本和文件哈希。已提交的 runtime/ 文件使公开 Git 安装无需编译器即可工作；CI 会检查它们与全新 TypeScript 构建完全一致。在更改 wire protocol 之前，请参阅贡献指南。

Apache-2.0。由 Libre WebUI 维护。