dsh-save-button
直接从 Web GUI 交付卡下载由 `present` 提供的文件——无需 SFTP，无需额外工具。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-save-button@0.1.5Save Button 以 dsh-save-button 发布，当前版本为 0.1.5。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
正在加载相关插件…
English | 中文
Adds a Download button next to Open on DSH Web GUI delivery cards: files the model delivered with
present (a zipped build, a report, a dataset, images…) go straight to your machine through the browser —
no SFTP/SCP detour.
┌──────────────────────────────────────────────────────────────────┐
│ 📄 HexHowitzer-windows-x86_64.zip ┌────────┐ │
│ Preview in sidebar │ Open ▾ │ │ ← official card
│ └────────┘ │
└──────────────────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────┐
│ 📄 HexHowitzer-windows-x86_64.zip ┌────────┐ ┌──────┐ │
│ Preview in sidebar │ Open ▾ │ │ ⬇ Download │ ← with this plugin
│ └────────┘ └──────┘ │
└──────────────────────────────────────────────────────────────────┘
Most useful when DSH runs remotely or inside a container (cloud host, GPU box, WSL, intranet server): the file lives on the Host, the browser is in your hands, and the only thing missing is a button.
present gets a Download button.
It responds with Content-Disposition: attachment, so the browser's own download manager streams it to disk —
a 100 MB zip never has to fit in page memory.▾ menu still offers the official Open in default app and Open containing folder / Show in Finder /
Show in File Explorer, disabled with an explanation when the Host has no desktop.All N files / Collapse) keep working, and a Turn without a delivery is left entirely to the official
renderer.postinstall,
no compile step.0.1.5-rc.*, 0.1.7-rc.* and 0.2.0-rc.*: see Supported DSH versions.Install from npm into your web profile:
dsh plugin --profile web add dsh-save-button
A git checkout works too — the package has no build step, so lib/ ships as-is:
dsh plugin --profile web add github:hanbernate/dsh-save-button
For local development, link this checkout instead so edits take effect through Loader recomposition:
dsh plugin --profile web add /path/to/dsh-save-button
If dsh is not on your PATH, use the CLI you started the Web GUI with, for example:
node ~/.dsh/profiles/node_modules/@deepseek-ai/dsh/lib/bin.js \
plugin --profile web add dsh-save-button
This appends dsh-save-button to the profile's dsh.profile.bundles and lets the Loader insert the entry
declared in this package's cordis.patch.yml. A link: install keeps the Host half live through Loader
recomposition; an npm or git install serves the published code.
To take effect:
dsh web (or however you start it).To verify: have the agent present any file (for instance ls a zip you just built) and a Download button
shows up on the right of the card.
The button sits to the right of the official Open button, one per delivered file:
| Action | Behavior |
|---|---|
| Download | first sends HEAD /api/download.button?sessionId=…&seq=…&index=… to probe availability, then hands the file to the browser's download manager with <a download>; the file name comes from the Host's Content-Disposition |
| Open | same as official: previews the file in the sidebar |
| ▾ menu | official actions: open in default app / open containing folder (Finder / File Explorer); disabled when the Host has no desktop |
| On failure | the reason is shown in place (e.g. "file is no longer in this session") and the same button retries |
| More than 4 files | the official collapse is preserved: All N files / Collapse |
Downloads are addressed only by the (sessionId, seq, index) triple — there is no path parameter — so the
only files that can be downloaded are the ones this session declared with present. Resolution, containment and
type checks, and chunked reads all happen in the Host half. See
doc/architecture.md (Chinese).
| DSH RC | turnTail contract | Integration | Status |
|---|---|---|---|
| 0.1.0-rc.2 … 0.1.2-rc.1 | — (no present / workspaceFiles) | not applicable | not supported |
| 0.1.5-rc.1 / rc.2 / rc.3 | chain | claims the whole turn row with priority: -1 and draws the card itself | supported (rc.3 verified 11/11) |
| 0.1.7-rc.1 / rc.2 | list | official card untouched; injects a Download button into deliverables.file.actions | supported (rc.2 verified 12/12) |
| 0.2.0-rc.1 / rc.2 | list | same as 0.1.7: official card untouched; injects a Download button into deliverables.file.actions | supported (rc.2 verified 12/12) |
At init time the plugin picks its adapter from what the runtime actually declares — a client plugin cannot read the DSH version — so one installation works on every supported line. The contract list, test layers, itemized verification records and the tag-switching handbook are in doc/compatibility.md (Chinese).
dsh plugin --profile web remove dsh-save-button
Then reload the page. Once the plugin is gone the official delivery card is back exactly as before — this plugin never modifies any official file.
| Symptom | What to do |
|---|---|
| No Download button on the card | reload the page first; then check that dsh-save-button is listed in dsh.profile.bundles in ~/.dsh/profiles/web/package.json; if it still does not show up, restart dsh web |
| Button appears, click reports "Download failed. Click to retry." | open the browser devtools and look at the /api/download.button?... response: 401/403 = authentication, 404 = that declaration is not in the Session (different session, or the event was pruned), 422 = not a regular file / outside the workspace |
| Open reports "Open failed" | expected when the Host has no desktop (a headless server); use Download or the sidebar preview instead |
exports["./client"] must be a string | the exports field in package.json got broken; run npm test for the guard |
Edited lib/client.js but nothing changed | reload the page (the Host serves the bundle by revision, and it is not refetched until the page reloads) |
The detailed docs under doc/ are currently written in Chinese:
| Document | Contents |
|---|---|
| doc/architecture.md | how a download works end to end, the two halves, the adapter + capability-probe selector, the icon capability table, security boundary, design decision records |
| doc/compatibility.md | support matrix, official contract list (C1–C10), history of the two breaking points, test layers and cases, real-machine verification records (V1–V23), tag-switching handbook |
| doc/development.md | directory layout, running tests, how edits take effect, steps for adding an adapter, pre-release checklist, development pitfalls |
MIT, see LICENSE.