@libre-webui/dsh-native-provider
通过私有本地连接在 Libre WebUI 中使用 DeepSeek Harness 提供商。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:libre-webui/dsh-native-provider#d71df9bc2b51ccf59588faadc5196bee4899d98dNative Provider 以 @libre-webui/dsh-native-provider 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Use the models already configured in DeepSeek Harness (DSH) from Libre WebUI. Choose each native provider and model independently, including Flash and Pro. Provider credentials stay in DSH.
This is the @libre-webui/dsh-native-provider plugin shown in DSH's Plugins
page. It connects the two applications through a private Unix socket. It adds
no web server, telemetry, agent sessions, or host tools.
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 manages conversations, usage, and Work's sandbox. DSH supplies the selected model connection. A Work task never gains access to DSH's native agents, sessions, files, or tool execution through this plugin.
feat/cordis-bridge-lwui branch.The Unix connection does not support Windows, remote DSH hosts, or a stock Libre WebUI container connecting directly to a host socket. See configuration and deployment.
In DSH → Plugins → Add plugin, paste this into Package name or address:
https://github.com/libre-webui/dsh-native-provider
Click Install. The repository includes the built plugin and its DSH bundle patch. Installation requires no build commands or install-script approval.
Verify native-provider 0.1.1 has a running component. DSH applies a fresh
installation to a live profile; follow a restart notice if DSH displays one.
DSH derives the short title from the package name; the full package identity
is @libre-webui/dsh-native-provider. Use the GitHub URL, because the bare
package name is not published on npm.
The default socket is <DSH home>/lwui-provider/llm.sock. Normally this means
$HOME/.dsh/lwui-provider/llm.sock; a configured DSH_HOME takes precedence.
DSH creates the private socket directory. See configuration
if you need a different path or have multiple DSH profiles.
The optional CLI equivalent is:
dsh plugin --profile web add https://github.com/libre-webui/dsh-native-provider
Use your actual profile name. Restart that profile after CLI installation.
Then configure Libre WebUI's cordis.config.yml with the same absolute path:
nativeProvider:
socketPath: /absolute/home/.dsh/lwui-provider/llm.sock
Replace /absolute/home with your home directory. YAML does not expand $HOME
or ~. Alternatively, set LIBRE_DSH_PROVIDER_SOCKET when launching Libre
WebUI. Restart Libre WebUI after changing its startup configuration.
In Libre WebUI, enable Cordis Engine as an administrator:
There is no default-model substitution: unavailable selections fail with an error instead of silently switching provider.
For the old locally prepared 0.0.0/0.1.0 bundle, let active requests finish, then use Uninstall on that plugin's page. Return to Add plugin, paste the GitHub URL above, and click Install. This replaces the local-only source with the public repository. Native DSH sessions and provider credentials are not deleted. With the usual DSH home, the default socket matches the old guide; retain a custom socket using the override in configuration.
For subsequent CLI updates of the GitHub-installed plugin:
dsh plugin --profile web update @libre-webui/dsh-native-provider
Restart the profile and verify its version. To pin or roll back to a reviewed
revision, install github:libre-webui/dsh-native-provider#<commit> instead of
the moving default branch. A disabled installation remains disabled until enabled.
dsh plugin --profile web remove @libre-webui/dsh-native-provider
Restart DSH and remove nativeProvider.socketPath or the corresponding
environment variable from Libre WebUI's configuration. An explicitly empty
LIBRE_DSH_PROVIDER_SOCKET disables the connection even when YAML defines it.
Saved Libre WebUI tasks remain; they require an available provider before
continuing. Removing this plugin does not delete native DSH sessions or keys.
npm ci
npm run check
npm audit --audit-level=moderate
Tests run against local fixtures and temporary Unix sockets. They do not need provider credentials or make real model calls. The generated bundle contains only the compiled plugin, protocol, package metadata, patch, README, and license; no npm runtime dependencies are installed into DSH.
The implementation is maintained with Libre WebUI's matching client and mirrored
here. upstream.json records the source revision and file hashes. The committed
runtime/ files make public Git installation work without a compiler; CI checks
that they exactly match a fresh TypeScript build. See
contributing before changing the wire protocol.
Apache-2.0. Maintained by Libre WebUI.