Usage & Billing

dsh-kimi-subscription

BaronCyrus/dsh-kimi-subscription · ★ 10

BaronCyrus

Use a Kimi Code subscription in DeepSeek Harness with OAuth, quota display, and composer usage

License
MIT
Added
2026-10-28
Maintenance
active
Install kind
npm
npm
dsh-kimi-subscription
Manifest details
Manifest status
Declared
Manifest path
package.json#dsh
Manifest checked
2026-10-30T09:38:55.890Z
Lifecycle scripts
None found

Static manifest checks report declarations only; they are not compatibility or security review.

安装

dsh plugin --profile web add 'dsh-kimi-subscription@1.4.2'

从 npm 安装预构建包

For install and environment setup, plus plugin development tutorials, see DSH community docs ↗

README

Source README · body: en · Read Chinese README

Table of contents
  1. DSH Kimi Subscription
  2. Features
  3. Install
  4. 1. Install the plugin
  5. 2. Connect your subscription
  6. 3. Select a model
  7. Daily use
  8. Screenshots
  9. User guide
  10. Update and uninstall
  11. FAQ
  12. Security and scope
  13. Local development
  14. References and acknowledgements
  15. License
  16. Support the author

DSH Kimi Subscription

简体中文 · English

Code, search, and check your quota in DSH with a Kimi Code subscription.

Connect with a subscription API key or device sign-in. Use Kimi models, web search, and usage information inside DeepSeek Harness without a separate pay-as-you-go Open Platform key.

CI npm Total npm downloads MIT Star

Features · Install · Daily use · Screenshots · User guide · Update and uninstall

Features

Capability What it does
Dedicated subscription models Adds a Kimi subscription group without replacing your existing kimi-coding or Open Platform configuration
Two connection methods Accepts a Kimi Code subscription API key or device sign-in; OAuth supports automatic refresh
Subscription web search Leaves existing search routing alone by default; optionally routes by model or uses Kimi search
Visible quota Shows usage, reset times, and reported booster balances in Settings, with a compact remaining-quota display beside the composer
Update checks in Settings Shows current and latest versions; supported npm installs can update directly, while local development installs receive separate guidance
Clear credential boundaries DSH Host manages credentials without returning them through browser RPC; subscription failures do not silently switch to another paid model route

Install

You need DeepSeek Harness and an active Kimi Code subscription. For DSH setup, see the official instructions. See the guide for compatibility declarations and validation records.

1. Install the plugin

Open the desktop application's Plugins page, click Add plugin, and enter this as the package name or address:

dsh-kimi-subscription

Choose the official install source, then click Install. The same field also accepts a GitHub repository address or an absolute path to a local plugin directory; to pin a version, enter dsh-kimi-subscription@1.4.2.

Then manually restart the desktop application — it reports that changes take effect on the next launch, and refreshing the page alone does not reload the plugin inside the Host process.

2. Connect your subscription

Open Settings → Kimi subscription. Enter a subscription API key created in the Kimi Code console, or follow the device sign-in flow.

A subscription API key is not a pay-as-you-go Kimi Open Platform key. Do not mix them, or post keys, device codes, or login callbacks in public issues.

3. Select a model

Choose a model your subscription can use from the Kimi subscription group, then start a conversation or coding task. A model appearing in the list does not guarantee that your account has access to it.

The Plugins page shows the installed state and version, and is also where you enable, disable, or uninstall.

The install source can be switched next to it; to pin a version, put dsh-kimi-subscription@<version> straight into package name or address. For offline or audited setups, download dsh-kimi-subscription-1.4.2.tgz from GitHub Releases and install from that file's absolute path instead.

For non-desktop profiles only: dsh plugin --profile <name> add dsh-kimi-subscription@latest works for a scratch profile. Do not use it for desktop — the CLI refuses it outright (profile "desktop" is managed exclusively by the Electron application). Use the Plugins page for the desktop app.

Details are in Installation and compatibility.

Daily use

Pick a model. Switch models within Kimi subscription. When a plan-access message appears, choose a model your account can use. See Models and subscription access.

Check quota. The composer can show a compact readout such as 5h 82% 7d 64%; those numbers are examples, not an allowance promise. Open Settings for detailed usage, remaining percentages, resets, and booster information returned for your account.

Enable search deliberately. Open Settings → Kimi subscription → Web search. The default is Do not take over; optionally select Auto (route by model) or Always use Kimi search. With the Codex subscription plugin installed, read Search coexistence first.

Screenshots

Screenshots illustrate where features appear. Models, quota, and controls depend on your installed version and account.

User guide

The full user guide covers installation, compatibility, model access, quota, search routing, troubleshooting, and removal.

Quick links: Sign-in and credentials · Search and Codex coexistence · Troubleshooting · Changelog.

Update and uninstall

Upgrading from 1.3.9 or earlier: install dsh-kimi-subscription@1.4.2 on the Plugins page instead of clicking Update plugin in the old settings card. The old button bypasses pnpm's release-age policy: if the version it installs is less than 24 hours old, the profile refuses every other plugin install until that version is 24 hours old. After the install and a restart, the button is the fixed one, and later updates can use it.

Update: open Settings → Kimi subscription → Update plugin. It installs the exact version into the desktop profile with DSH's bundled pnpm and reads the version back from package.json, so a command that installed nothing never reads as success. The install keeps pnpm's release-age policy instead of overriding it: by default pnpm installs the version at once and records it in the profile's minimumReleaseAgeExclude; under a stricter pnpm policy the button says when the update can run. Manual recovery steps are in Updates and cleanup.

A local link: development install cannot use that button; pull, test, and rebuild its checkout instead of replacing the development link with an install command. The desktop app owns its desktop profile exclusively and the CLI refuses dsh plugin --profile desktop … (profile "desktop" is managed exclusively by the Electron application); dsh plugin --profile <name> … applies to non-desktop profiles only.

Uninstall: if Kimi search was enabled, first switch it to Do not take over, then use Uninstall for this plugin on the app's Plugins page.

Manually restart the desktop application after installation, updates, or removal. If the plugin is already removed but its search patch remains, remove only its marked block as described in Updates and cleanup; do not delete the entire profile.

FAQ

Signed in, but one model does not work? The catalog is not filtered by your subscription tier. Model-access rejections and invalid credentials need different checks; see Troubleshooting.

No quota readout? Check that a Kimi subscription model is selected, then refresh usage in Settings. Missing usage data should not be interpreted as a zero balance.

Still seeing the old UI? Quit the desktop application completely and open it again. A page refresh alone does not reload the Host adapter.

Security and scope

This is a community plugin, not affiliated with or endorsed by DeepSeek or Moonshot AI. The project is intended for personal interactive use; consult the Kimi Code Community Guidelines for subscription usage rules.

Credentials stay Host-side; the browser receives only necessary status and usage information. Model requests still go to the relevant Kimi service: keeping credentials out of browser responses does not mean inference is offline. See SECURITY.md.

Use Issues for ordinary bugs and private vulnerability reporting for security issues. Never publish credentials or raw account responses.

Local development

git clone https://github.com/BaronCyrus/dsh-kimi-subscription.git
cd dsh-kimi-subscription
pnpm install --frozen-lockfile
pnpm run check

See Local development for linking and rebuild steps. Read AGENTS.md before agent-assisted changes or releases; do not hand-edit generated lib/ files.

References and acknowledgements

DeepSeek Harness · Kimi Code · Model documentation · Membership · Third-party tools · DSH Codex Subscription

See THIRD_PARTY_NOTICES.md for implementation references and third-party licenses.

License

MIT

Support the author

This plugin is free and open source, and tips are entirely optional. If it saved you some hassle using your Kimi Code subscription in DSH, a tip helps keep it current with new models and new DSH releases.