Usage & Billing
dsh-kimi-subscription
BaronCyrus/dsh-kimi-subscription · ★ 10
Use a Kimi Code subscription in DeepSeek Harness with OAuth, quota display, and composer usage
Manifest details
安装
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
Table of contents
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.
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.2on 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
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.