* feat(release): publish package source, declaration maps, and documentation Every release member publishes its TypeScript source and the declaration maps that resolve into it, and @deepseek-ai/dsh publishes the repository Markdown documentation staged from docs/ at prepack time. The ./src/* export most members already declared now resolves for an installed consumer, and a consumer editor follows a declaration to the implementation. Bundled JavaScript maps stay unpublished; the vendored family and the Desktop runtime file policy are unchanged. Rationale: .agents/notes/implemented/process/2026-10-08-published-source-and-docs.md * feat(release): publish JavaScript maps and compress bundles Every emitted JavaScript map ships beside the bundle it describes, and the workspace build and the client preset compress bundles without mangling identifiers. The documentation payload now mirrors the website publication manifest and is removed again by `postpack`; Desktop and the Python executable exclude the published source, documentation, and maps; `clean` removes a staged copy. Typert's publication contract gains the Remote declaration map. * fix(release): keep node bundles readable for the worker image The browser worker image lowers `yield*` only as a whole statement and rewrites `for await` loops by their source layout, so compressed node-side entries either fail that lowering or lower to unparseable code. Only the browser bundles keep compression, which removes about a third of their text. The bundle-purity assertion now matches the module-loader call regardless of the quote style compression picks, and the release-pack fixture exercises the installed package's new documentation requirement. * feat(release): publish the whole documentation tree `@deepseek-ai/dsh` copies `docs/` in full instead of the website's page set: the maintainer documents, the generated migration records, the translation guidelines, and the `*.i18n.yaml` consistency records ship with the installed package, so the documentation's own links resolve without a checkout. * feat(release): publish the upgrade guides with the documentation The staged documentation keeps the website's page set and adds every `docs/upgrade-guide/` document, which is what an installed reader consults when a released change breaks something. The rest of the maintainer tree stays out. * test(release): expect source and maps in master's new payload cases * feat(release): keep installed docs and source readable in Desktop Desktop keeps the published src/ and docs/ trees inside app.asar, and every model shell call receives DSH_INSTALL_DIR and DSH_NODE_EXECUTABLE so an agent can read them through Electron's Node mode. Staging also generates docs/upgrade-guide/README.md, an index of the upgrade guides grouped by the release they upgrade from. Minified client bundles print string literals with backticks: the worker image packer now recognizes those chunk requests, client license banners are prepended after minification so their text survives, and the affected artifact tests accept either quote. * test(desktop): read archived docs through the Windows PowerShell form Regenerate the config catalog for the shifted shell-env source line. * test(desktop): wait for the GUI-subsystem Electron process from PowerShell * build(release): publish source and maps from the message-quotes package * build(release): publish source and maps from packages new on master * build(release): publish source and maps from the tool-office package
description, kind
| description | kind |
|---|---|
| The bundled 'powered by dsh' badge skill for users and maintainers enabling, using, or debugging the optional badge provider. | package-reference |
@deepseek-ai/dsh-skill-badge
English | 中文
Summary
Agents can load the official "powered by dsh" badge skill from this bundled provider and follow its instructions for adding attribution badges to documents, PRs, and other content produced with DeepSeek Harness. The provider has no configuration; deployments install it and insert its plugin row explicitly. The skill ships both Markdown snippets and a packaged PNG for systems that cannot reliably import remote images.
Table of Contents
- Use this package
- Understand the implementation
- Further Exploration
- Model Experience
- Known Limitations and Deferred Work
- Dev Note
Use this package
Enable the plugin to make the dsh-badge skill available in the session skill catalog; the model can then load it like any other skill and follow its instructions for adding a "powered by dsh" badge.
In Plugins, this component is named DSH and uses the DSH tag icon. Its skill is named dsh-badge.
When to choose it
Choose this provider when content produced with DeepSeek Harness should carry official attribution badges, and the deployment wants the badge skill available to agents without storing it in a local skill directory. Skip it when the badge is irrelevant to the deployment. The default composition omits the plugin; installation and an explicit active row are required.
Enable the plugin
Install @deepseek-ai/dsh-skill-badge into the profile and insert its plugin row. The default composition does not declare it.
- insert:
- id: skill-badge
name: '@deepseek-ai/dsh-skill-badge'
After enabling, dsh-badge appears in the available skills of the session catalog. The skill covers remote Markdown badges (Shields.io-based) and a packaged PNG badge asset for targets that cannot fetch remote images reliably.
What the badge skill provides
- Markdown snippets. Instructions for embedding the official badge markup in documents, PRs, and merge requests.
- Packaged PNG asset. A
dsh-badge.pngresource (726×120 source, rendered at 121×20) that works where remote images cannot be imported.
Observable success and failures
An explicitly inserted active row makes dsh-badge appear in the catalog and loadable by name. Without an active row, this provider contributes no catalog entry. Because the provider is immutable, discovery always succeeds with exactly one skill and never reports partial results.
Understand the implementation
Implementation internals — click to expand
This section explains how the bundled provider is wired; the observable behavior is fully covered in Use this package.
Design concept
The provider is an immutable, synchronously registered skill source: it registers one fixed candidate at the bundled skill rank (600) under the provider name dsh-badge, exposes its packaged assets/ directory as the skill's directory resource base, and reads the skill body from the packaged assets/dsh-badge.md file on every load.
Source map
| File | Role |
|---|---|
src/index.ts |
Plugin entry and the immutable provider: one candidate, resource base, body load |
assets/ |
Packaged skill body (dsh-badge.md) and PNG asset (dsh-badge.png) |
Further Exploration
Read these pages when the package-level contract is not enough. They move from the registry this provider registers on to how the skill reaches the model.
- Skill subsystem reference — the registry and provider contract this provider implements.
- skill package — the registry the provider registers on, and the shared rendering of loaded skills.
- tool-skill package — how the badge skill reaches the session catalog and the model.
Model Experience
Indirectly, through dsh-tool-skill, which renders the provider's catalog entry and the selected skill body to the model.
KV Cache effect
An omitted plugin adds no request content. When its inserted row is active, its catalog entry and any loaded body change the provider KV prefix at their insertion points.
Known Limitations and Deferred Work
These limits define what the bundled provider does not do. They are current package constraints, not a task backlog.
- One fixed skill, no runtime customization — the provider contributes exactly the
dsh-badgeskill; deployments that need another badge variant author their own skill instead. - Remote Markdown relies on Shields.io — the remote badge markup embeds a Shields.io image; use the packaged PNG when the target cannot fetch remote images reliably.
Dev Note
Working context for maintainers — click to expand
None.