Manage your AI channel accounts inside DeepSeek Harness
Balances, check-in, tasks and account switching, without leaving DSH
简体中文 · English
Check balances, check in, run tasks and switch accounts — manage CLIProxyAPI (CPA) accounts
inside DSH, without opening its own web console.
Install the plugin and you are done: the CPA binary, the channel plugins, the config and the
admin key are all prepared by the plugin itself.
> [!NOTE]
> **The key never leaves the host**: every action in the panel is performed by the plugin on
> your behalf. The admin key only lives on the host side — the web page can never see it.
## What it does
Open **Plugins → CPA Switch** in DSH. Each of the four channels gets its own tab:
- **See account balances**: available / used / quota pool / package count; tokens and credits
are shown separately and never summed together.
- **Quota cycle reminders**: when the provider supplies a valid cycle end date, expand a notice in
the last seven days to see the account, package, remaining quota, and end time. A cycle ending
does not necessarily mean unused quota expires.
- **Check in all / run all tasks**: one click per channel; each account can also be operated
individually.
- **Enable / disable accounts**: every account has a toggle, and "Use only this one" disables
every other account in the same channel at once.
- **Add an account**: the "+ Add account" entry at the end of each channel's list opens the
OAuth page — finish the login in your browser and you are done.
- **Remembers your choice**: after a DSH restart, the account you picked is still the one in use.
- **Automatic check-in**: toggled per channel; check-ins missed while DSH was not running are
caught up when the plugin starts.
- **Process hosting**: CPA starts with DSH (an already-running instance is reused) and stops
with it.
- **Says why it will not start**: a port taken by another CPA, a config-generation mismatch,
and a bad config each get their own message; a port held by someone else's instance no longer
reports "Running".
- **Models registered automatically**: once the plugin is installed and an account is added,
the four channels' models appear in DSH's model picker on their own.
- **Keep only the models you use in the picker**: each channel's toolbar has a "Models" button —
uncheck a model and save, and it disappears from the chat model picker (the panel still
lists every model, so you can check it back at any time). Unchecked models remain callable;
they are only hidden from the dropdown.
### The four channels
| Channel | Accounts | Balance unit | Check-in | Tasks |
| --------- | -------- | ------------ | -------- | ----- |
| WorkBuddy | several | credits | ✅ | ✅ |
| Trae | several | credits | ✅ | — |
| Qoder | single | credits | ✅ | — |
| ZCode | single | **token** | — | — |
The four channels do not report the same balance fields: Trae has a single balance pool and no
total or used figure, so its "used" cell shows `—` and no bar is drawn — that means "upstream did
not say", not "used 0".
**Degrades by capability**: features a channel does not support are not rendered — no button
that "does nothing when clicked".
## Security
The admin key only lives on the host side and is never sent to the browser — details in
[Architecture](docs/ARCHITECTURE.md).
## Requirements
Only **DSH** (DeepSeek Harness). The CPA binary, the channel plugins and the admin key are not
yours to prepare — the plugin downloads and configures them on first start; an existing CPA on
the machine is reused, never overwritten.
Downloading needs access to GitHub Releases; configure a proxy where a direct connection does
not work.
**Channel plugins are never upgraded automatically** (upstream can change behaviour at any
release, so a silent swap is too risky). The panel shows "channel plugins a → b", and
"Update channel plugins" swaps them when you click it: CPA is stopped first, the previous
version is kept until the swap succeeds, and it is not started again for you.
## Install
From npm:
```
dsh plugin --profile 