cvc-catalog-sync-plugin
Maintenance: Activemikel38487/cvc-catalog-sync-plugin
DSH plugin: keeps the CheapVibeCode model catalog in the profile patch in sync with /v1/models and the official installer's reasoning levels, with a settings page
$ dsh plugin add cvc-catalog-sync-pluginInstall
dsh has no central install command — add this plugin’s entry (documented in its README) to your profile or patch config, then restart.
How installs work0
stars
0
forks
JavaScript
Language
MIT
License
2026-11-20
Created
2026-11-20
Last push
README
CVC catalog, coefficients and balance
One plugin for three things a CheapVibeCode route needs in a DSH profile:
- Catalog sync keeps
llm-pi-ai.providers.<provider>.modelsand the subagent model allowlist in step withGET /v1/modelsand with the reasoning levels published by the official CheapVibeCode installer. - Coefficients put the price multiplier (
×0.1…×10) beside every model of that provider in the model picker. - Balance adds a sidebar button and a panel with the remaining balance and the spend since the previous reading.
Each of the three has its own switch in the settings page. A switched-off
function leaves nothing behind: no route, no timer, no tool, no UI element.
Version 2.0.0 replaces two earlier plugins (cvc-model-coeff-plugin and
cvc-balance-plugin) and absorbs their features into this package, so one
plugin row in the profile patch is enough.
Requirements
- DeepSeek Harness
>=0.2.2-rc.3 <0.4.0; - Node.js 20 or newer;
- a provider route in
llm-pi-aiwhosebaseURLpoints at acheapvibecode.ruhost (defaulthttps://ru.cheapvibecode.ru/v1), with its credential named byapiKeyEnv(defaultCVC_DEEPSEEK_API_KEY).
If there is no such route, the catalog and the balance have nobody to read: plan and apply report that no route was found, and the balance panel says so. The settings page itself still works, because it is also the switchboard.
Install
Ask the DSH agent to install the bundle from npm:
install the npm bundle cvc-catalog-sync-plugin
By hand: add "cvc-catalog-sync-plugin": "^2.0.0" to the dependencies of
~/.dsh/profiles/<profile>/package.json, add the package name to
dsh.profile.bundles, and let the profile install it. The bundle ships a
compiled client.js, so nothing is built during installation and no
allowBuilds permission is needed. For a local checkout use
"cvc-catalog-sync-plugin": "link:<absolute path>" instead.
The package keeps the name cvc-catalog-sync-plugin and the composition row id
cvc-catalog-sync, so the profile does not need to be rewritten for the
upgrade. See docs/UPGRADING.md for the steps that do
change.
Where the settings are
The same form appears in two places:
- Settings → CVC — a section of the settings navigation with its own icon
(
settings.section+settings.section.icon, idcvc, order 25); - Plugins → CVC catalog sync → bundle page — a configuration block between
the bundle description and its component rows (
plugins.bundle.config, keyed by the package name). In the collapsed list the block renders as a one-line summary.
One group of switches at the top (Features) and then the parameter groups:
Catalog, Coefficients, Balance and Advanced. The switches decide
which of the first three groups has any effect; the Advanced group holds the
provider lookup (providers.*) and the level cache, and stays visible with every
function off, because it configures the lookup all three share.
| Switch | What it controls |
|---|---|
| Catalog sync | startup and timer runs, the cvc_catalog tool, POST /cvc/run and what the check and apply buttons can do |
| Coefficients | GET /cvc/coefficients and the badges in the model picker |
| Balance | GET /cvc/balance, the cvc_balance tool, the sidebar button and the panel |
The settings page and GET /cvc/state are not gated: they exist with all three
functions off, because the page is the switch. The check and apply buttons stay on
the page when catalog sync is off, but the run route behind them answers 404 and
the page reports the failed run.
A change is applied through PUT /cvc/config and takes effect immediately:
the plugin declares every configuration field as volatile, so DSH reloads the
row without a restart. Turning a function off unmounts it, turning it on
mounts it again, in the same page session.
The three switches are named Catalog sync, Model coefficients and
Balance, and the settings page spells out what a switched-off feature
leaves behind: its route answers 404, its timer is not created, its interface
element disappears. The page itself always stays, because it is the switch.
Buttons:
| Button | Effect |
|---|---|
| Save | Validates the form and writes the row config into the profile patch through configEditor.edit(). A value equal to the schema defaults removes the override, so the patch keeps only real changes. |
| Check catalog | Fetches the catalog and the level map, shows the diff, writes nothing. |
| Apply catalog | Same fetch, then writes the models and the subagent allowlist. Asks for confirmation first. |
| Reset | Puts the defaults into the form; press Save to remove the override. |
Check and apply use the saved settings, so press Save first; the page marks unsaved changes. Below the buttons the page shows the last run: catalog, current and next model counts, the level source, added, removed and changed models, allowlist changes, warnings and the patch path.
Configuration
More in Other
dsh-oil-creator
by oil-oil
AI-assisted local creator workbench for DeepSeek Harness
dsh-novel-writer
by akira399
网络小说创作插件:九阶段门禁式创作流程 + 世界书设定注入 + 本地书籍导入 + AI 一键润色 + 去 AI 味。
dsh-multica-runtime
by multica-ai
Support dsh runtime on Multica.
dsh-plugin-radar
by adamplatin123
An ecosystem radar for the DeepSeek Harness (dsh) plugin community that auto-discovers thousands of candidate plugins and runs continuous k8s-level validation, publishing the results as a browsable plugin catalog.
