dsh-plugins
Independently installable DeepSeek Harness plugins, published from one pnpm
monorepo.
Plugins
| Package | What it does | Install |
|---|
@icedrop-ai/dsh-cost-meter | Session-header balance/token widget and sidebar fallback with a DeepSeek top-up link | dsh plugin --profile web add @icedrop-ai/dsh-cost-meter |
@icedrop-ai/dsh-browser-use | One model-facing browser_use tool backed by the browser-use CLI | dsh plugin --profile web add @icedrop-ai/dsh-browser-use |
@icedrop-ai/dsh-all | Aggregate bundle that installs both plugins | dsh plugin --profile web add @icedrop-ai/dsh-all |
@icedrop-ai/dsh-plugins | Repository-root bundle; equivalent to dsh-all for link: installs | dsh plugin --profile web add link:$(pwd) |
Install modes
npm (recommended)
dsh plugin --profile web add @icedrop-ai/dsh-cost-meter
dsh plugin --profile web add @icedrop-ai/dsh-browser-use
# or both:
dsh plugin --profile web add @icedrop-ai/dsh-all
Restart dsh web after a bundle install. Use
dsh --profile web --dump-config to confirm the bundle's # == ... layer is
present.
GitHub subpath (no npm)
Install one package directly from a pinned tag or commit:
dsh plugin --profile web add \
"git+https://github.com/icedrop-lab/dsh-plugins.git#v0.1.0&path:packages/cost-meter"
Subpath installs fetch the built lib/ that is committed in this repository,
so they need no build approval. Pin a tag or commit SHA; do not point at
main.
GitHub Release tarballs
Every release attaches vendor/*.tgz and vendor/plugins.lock.json:
gh release download v0.2.0 -R icedrop-lab/dsh-plugins -p '*.tgz' -D vendor/
dsh plugin --profile web add --save-exact ./vendor/icedrop-lab-dsh-cost-meter-0.2.0.tgz
dsh plugin --profile web add --save-exact ./vendor/icedrop-lab-dsh-browser-use-0.1.0.tgz
Install the individual plugin tarballs when you are not using npm: each bundle
adds its own profile layer. The aggregate dsh-all-*.tgz is npm-backed — its
package.json depends on the individual packages by published version, so it
works after those packages are on npm. Before then, use the individual tarballs
or the Git subpath installs.
Local development
pnpm install
pnpm aggregate
pnpm link-runtime # link this machine's installed @deepseek-ai runtime
dsh plugin --profile web add link:$(pwd)/packages/cost-meter
Layout
packages/<name>/ independently published plugin packages
packages/all/ aggregate bundle (generated patch + exact deps)
scripts/aggregate.mjs regenerates root + packages/all bundles
scripts/vendor.mjs packs vendor tarballs + SHA-256 lock
scripts/publish-targets.mjs
scripts/check-publishable.mjs
vendor/ generated tarballs and plugins.lock.json
Each plugin package declares dsh.bundle.patch (installability) and
optionally dsh.client (Web browser half). No published dependency uses the
workspace: protocol: Git-subpath installs preserve that protocol and fail.
Releasing
See RELEASING.md.
License
MIT
