deepseekplugins

DeepSeek Harness plugin

dsh-cpa

DSH CPA provider and runtime plugin

Models & Providers
Jump to install

Source facts

Repository
Moraxyc/dsh-cpa
Latest update
Aug 20, 2026
Category
Models & Providers
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/Moraxyc/dsh-cpa
Plugin: dsh-cpa
Author: Moraxyc

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.en.mdSource · read only
README language

dsh-cpa

> English | 简体中文

A dsh bundle plugin for CLI Proxy API (CPA). It registers the cpa provider, sends requests to /v1/chat/completions, and syncs models from /v1/models.

Quickstart

npx @deepseek-ai/dsh plugin --profile web add dsh-cpa

Headless profile:

npx @deepseek-ai/dsh plugin --profile headless add dsh-cpa

Install From Source

For development or local builds:

npx @deepseek-ai/dsh plugin --profile web add .

Headless profile:

npx @deepseek-ai/dsh plugin --profile headless add .

Use An Existing CPA

Switch to "External CPA" in the settings panel, enter the URL, API key, and management key, then apply.

Auto-Start CPA

By default the plugin writes $DSH_HOME/cpa/config.yaml, starts cli-proxy-api, and injects the generated key into the provider adapter. Before starting, the plugin resolves the executable from PATH; if it is missing, enter an absolute path in the internal CPA setting.

Models sync from /v1/models every 5 minutes.

Settings Panel

The CPA page uses dsh web-app components and supports internal and external startup modes, saved to $DSH_HOME/cpa/settings.json. Stop is only shown while the internal CPA is running. The management panel opens in a modal. External mode configures URL, API key, and management key; internal mode configures the CPA executable path. Advanced settings cover the port, model refresh interval, quota cache/concurrency, and config, settings, and execution record paths. The port, config path, and usage statistics only apply to internal CPA; model refresh, quota cache/concurrency, settings path, and execution record path apply to both modes.

Usage Status

The plugin parses x-cpa-trace-id from successful and failed responses, writes sanitized execution records to $DSH_HOME/cpa/executions.json, and exposes a cpaUsage projection for the current session. /dsh-cpa/execution-status?sessionId=... returns sanitized accounts, a quota snapshot, and the latest execution record for the compact composer readout. The browser cannot call CPA's /v0/management/api-call; it is only used by the server-side quota query. The readout shows only CPA-specific state: the currently used provider/plan, failure or unavailable status, and one primary quota window, without repeating the token, latency, or performance stats already shown by dsh. Providers are read from both auth files and API key configuration. Execution records locate the current provider by CPA trace account; when the trace has no account or the account is not present in the loaded config, the readout infers the provider from the model. Clicking it expands account, source, Base URL/prefix, quota, model/purpose, and CPA trace/request details. The same session still keeps per-account request, failure, and token totals for the cpaUsage projection, and the readout hides when no management API is available.

The internal CPA usage-statistics-enabled setting is on by default and can be disabled in the CPA settings panel.

CPA Summary

A read-only /dsh-cpa/summary endpoint is served by the plugin. The server uses the management key to call CPA's management API, and the browser only receives sanitized summary data, never the management key or credential fields. It includes version/update state, a whitelisted runtime config snapshot, usage request totals aggregated from /v0/management/api-key-usage and auth-file counters, sanitized accounts, and model-to-account availability from auth files. The CPA management API does not expose aggregate token totals, so those values stay at zero. Data is cached briefly; a failed source is recorded as an error without hiding other data.

The settings page includes a compact "CPA Summary" section for version/update state, runtime config, usage totals, usage details, and accounts. Composer status details include a "日志" deep link when a recorded requestId exists, opening CPA's original management log surface. The management panel remains the complete management entry point.

Back to searchOpen GitHub repository

More related plugins

View category