dsh-cliproxyapi-provider
适用于 DeepSeek Harness 的 CLIProxyAPI 提供程序，支持本地自动发现、动态模型同步和原生模型切换。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:ChadCSong/dsh-cliproxyapi-provider#6f1039feeb184cd2a7b4e92a2a8ca879ff3d00d6Cliproxyapi Provider 以 dsh-cliproxyapi-provider 发布，当前版本为 0.1.9。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
An auto-discovery CLIProxyAPI provider for DeepSeek Harness (DSH).
It discovers a local CPA service and synchronizes the live model catalog into DSH's native model picker.
Generic OpenAI-compatible routes usually require a manually maintained base URL and model list. This plugin treats CLIProxyAPI as a first-class, dynamic DSH provider:
127.0.0.1:8317, localhost:8317, and [::1]:8317./v1/models?client_version=pi, with standard data[].id fallback.CLIProxyAPI (auto) in DSH's model picker.settings.yaml.0.1.5-rc.1 (public contracts 0.1.5-rc.2)22.19+ or 24+The plugin is built and tested against the public DSH 0.1.5-rc.2 contracts used by the
0.1.5-rc.1 CLI release. Version 0.1.8 and later use the current settings and browser module APIs.
Install directly from GitHub into the profile you use:
dsh plugin --profile web add github:ChadCSong/dsh-cliproxyapi-provider
For DSH Desktop, use its active profile (normally desktop):
dsh plugin --profile desktop add github:ChadCSong/dsh-cliproxyapi-provider
Restart the corresponding DSH process once after installation. No manual profile patching is needed;
the standard DSH bundle declaration lives in package.json and cordis.patch.yml.
git clone https://github.com/ChadCSong/dsh-cliproxyapi-provider.git
cd dsh-cliproxyapi-provider
pnpm install
pnpm build
dsh plugin --profile web add "$PWD"
Replace web with the profile you actually use.
8317.Useful commands:
/cpa-status
/cpa-refresh
/cpa-status reports the current endpoint and synchronized model count. /cpa-refresh immediately
probes CPA and refreshes the DSH model catalog.
The settings namespace intentionally remains dsh-cliproxyapi for upgrade compatibility:
dsh-cliproxyapi:
enabled: true
# Empty means local auto-discovery. Remote CPA is also supported.
baseURL: ''
apiKeyEnv: CLIPROXYAPI_API_KEY
protocol: openai-completions
refreshIntervalSeconds: 300
probeTimeoutMs: 2000
Candidates are deduplicated and tried in this order:
baseURL settingCLIPROXYAPI_BASE_URL from the DSH launch environment8317A non-loopback service is contacted only when you explicitly configure it.
apiKeyEnv is a credential reference, not the secret itself. The settings UI writes the key through
DSH's credential service. The default reference is CLIPROXYAPI_API_KEY.
The default, openai-completions, uses CPA's /v1/chat/completions route. Select
openai-responses only when your CPA deployment exposes the target models through the Responses API.
The plugin forwards the input capabilities reported by CPA. Models that declare image input receive images through DSH's official adapter; text-only models remain text-only. There is no separate vision model, image-to-text preprocessing, or capability override. DSH applies its native compatibility rules when a session contains images.
The plugin manages one route in DSH's official @deepseek-ai/dsh-llm-pi-ai adapter through the public
settings contract. It does not patch Harness or reimplement model transport. Streaming, tool calls,
attachments, reasoning, image handling, and errors continue through the official adapter.
The host bundle imports no Electron or dsh-plugin-desktop APIs. Its settings card uses public DSH
client services and slots, allowing the same package to run in CLI/Web and Desktop profiles.
pnpm install
pnpm test
pnpm typecheck
pnpm build
When developing against a local Harness checkout:
DSH_CHECKOUT=/absolute/path/to/deepseek-harness pnpm test
DSH_CHECKOUT=/absolute/path/to/deepseek-harness pnpm build
Alternatively, point DSH_PACKAGES_ROOT at a DSH node_modules directory. Generated local path files
are ignored by Git and never included in published packages.
Automatic discovery only contacts loopback addresses. The plugin never writes a literal API key to its settings, model cache, or logs. See SECURITY.md to report a vulnerability privately.
Issues and pull requests are welcome. For behavior changes, please include or update Vitest coverage and
verify pnpm test, pnpm typecheck, and pnpm build before submitting.