Preface

DeepSeek Harness (DSH) connects to various model services through Provider plugins. If your environment only provides WorkBuddy credits and lacks a universal API Key, or if you prefer logging in with a CodeBuddy China site account, the native DSH does not cover such credentials and model catalogs by default.

Below is the community plugin dsh-llm-codebuddy: it adds a Provider named CodeBuddy 中国区 (CodeBuddy China Region) to DSH, supporting both WorkBuddy API Key and CodeBuddy China site token authentication, and enables model retrieval and configuration within the WebUI. The plugin is installed independently without modifying DSH’s global directory; it is maintained by Axiaohungry, current version 1.3.5, MIT license, with approximately 20 stars on GitHub.

What This Is

dsh-llm-codebuddy is a third-party adapter, not an official plugin from WorkBuddy, CodeBuddy, or DSH. The API Key is provided by WorkBuddy, and the plugin uses this Key to call model services intended for CodeBuddy; it can also obtain a token through logging into the CodeBuddy China site webpage, without requiring the CodeBuddy CLI to be installed locally.

The request path is approximately: DSH Agent → this plugin → CodeBuddy /v2/chat/completions (inference) and /v3/config (model catalog). DSH handles the agent loop and tool calls, while CodeBuddy handles model inference.

Core Features

According to the repository README, the plugin’s current capabilities include:

  • Directly adding the CodeBuddy 中国区 Provider in the WebUI;
  • Supporting WorkBuddy API Key, with a switchable API Key / Token Login option next to the input field;
  • Supporting launching a browser from the WebUI or command line to complete CodeBuddy China site login, and automatically reusing and refreshing the token;
  • Automatically fetching currently available models from CodeBuddy, supporting editing of model ID, name, context window, and maximum output tokens;
  • Supporting adding, deleting models and resyncing the model catalog;
  • Declaring each model’s thinking capabilities and optional levels (off / minimal / low / medium / high / xhigh / max) in the model catalog, and converting them to reasoning_effort for transmission;
  • Using a built-in catalog as a fallback when the model API is unavailable;
  • Allowing replacement of the old API Key value by entering a new one; leaving it blank when saving preserves the original value; credentials are saved by DSH’s credential service and not written to settings.yaml.

System requirements: Windows, Linux, or macOS; Node.js >= 22.19.0; DSH installed. The repository notes indicate it has been verified on DSH 0.1.0-rc.6. The installer includes the pnpm required by DSH.

Installation and Enabling

It is recommended to use the one-click installation command, which will install the plugin for DSH’s web and headless profiles:

npx --yes dsh-llm-codebuddy@latest install

Restart DSH after completion. If you only use the WebUI, you can install only the web profile:

dsh plugin --profile web add dsh-llm-codebuddy@latest

When headless is needed, run:

dsh plugin --profile headless add dsh-llm-codebuddy@latest

If CodeBuddy is not visible in the WebUI after installation, confirm that DSH has been restarted and check the web profile plugin list:

dsh plugin --profile web list --depth 0

Typical Usage

  1. Open “Settings → Models”.
  2. Add or edit CodeBuddy 中国区.
  3. Click “Token Login” to the right of the API Key input field.
  4. Complete the CodeBuddy China site login in the automatically opened browser.
  5. After the WebUI displays “Token Logged In”, fetch models and save the custom catalog.

If the WebUI cannot open the browser, use the command line entry:

npx --yes dsh-llm-codebuddy@latest login

After successful login, the Provider switches to token mode, and no API Key is required. The two types of credentials are retained independently, and you can switch back to API Key mode at any time.

WorkBuddy API Key

  1. Open “Settings → Models”, click “Add Provider”, and select CodeBuddy 中国区.
  2. Enter the API Key obtained from WorkBuddy and save.
  3. Edit the Provider, expand “Custom Settings”, click “Fetch Available Models”, select the desired models, and import them.
  4. Modify model parameters as needed and save.

After changing the API Key, it is recommended to click “Fetch Available Models” again to sync the model permissions of the new account. Model permissions are bound to the Key, and the plugin only imports models authorized by the current Key.

Updating and Uninstalling

Update to the latest version:

npx --yes dsh-llm-codebuddy@latest install

Restart DSH after updating; model configurations and API Keys will not be overwritten.

Uninstall:

npx --yes dsh-llm-codebuddy@latest uninstall

The uninstallation will back up ~/.dsh/settings.yaml, only delete the llm-pi-ai.providers.codebuddy-cn configuration, remove the plugin from the web and headless profiles, and preserve credentials for potential reinstallation later.

Applicable Scenarios and Notes

Who It’s For: Users who are developing agents in DSH and whose company or team only provides WorkBuddy credits or CodeBuddy China site accounts; it can also be used when you need to uniformly manage the CodeBuddy model catalog and thinking levels in the DSH WebUI.

Runtime Permissions: The plugin runs with the current DSH process and has access to the files, network, and credentials that the process can access. Before installation, you should review the source code and MIT license to ensure it complies with your local security policies.

Version and Compatibility: DSH is still in a pre-release stage; if DSH adjusts its plugin interface in the future, this plugin may need a corresponding upgrade. If a 500 status code (no body) error occurs during a call, the README suggests updating to the latest version and restarting, as older versions might have the CodeBuddy request identifier overwritten by DSH.

Third-Party Disclaimer: This project is a community adapter; the SkillHub directory page and GitHub repository are published independently by the maintainer and have no official affiliation with DeepSeek / High-Flyer.

Links

  • SkillHub Directory Page: https://www.skillhub.cn/plugins/Axiaohungry/dsh-llm-codebuddy
  • GitHub Repository: https://github.com/Axiaohungry/dsh-llm-codebuddy