dsh-cloud-download
从 DSH Web GUI 下载已交付、已更改和已预览的文件，并隐藏在无头或远程部署中无法使用的原生打开控件。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:SOVLOOKUP/dsh-cloud-download#39d41de135798e8e55ab4eb16c20d8a8deb71b2cCloud Download 以 dsh-cloud-download 发布，当前版本为 1.2.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Download files that DeepSeek Harness delivers or previews straight from the conversation — no SFTP, no backend file manager, no detour to the NAS.
Built for DSH running on a remote host, in a container, on a NAS, or behind a reverse proxy, where the browser is on your machine but the files are on the Host.
| Where | What it adds |
|---|---|
Delivery card (present) | A download icon next to the native open control |
| Changed-files review (right sidebar) | A download icon in the review header |
| Document preview header | A download icon for the file being previewed |
| Unsupported-preview empty state | A labeled “Download file” button |
Download action on a delivery card
The download icons show their own state: Preparing download…, Download started, or Download failed. Click to retry. A failed request also shows the server's HTTP status and reason in a short toast, instead of the browser's generic “download failed” message.
A remote DSH Host often exposes the native “show file location” / “open in file manager” actions. They report success, but the file manager opens on the Host's desktop — which the remote browser cannot see. On a NAS or cloud container that desktop may be Xvfb, a display with no viewer at all.
This plugin:
HEAD request to the plugin's authenticated route. A successful probe means the file is readable and the Host can stream it.GET so the Host's error text can be shown in the toast.Delivery and review downloads carry only the coordinates the official card already has — Session, durable event sequence, and file index. No path or extra capability crosses the wire; the Host resolves the path from the Session log and confines it to the configured workspace root. A path outside that root returns 403 instead of being read.
The preview header reuses DSH's built-in /api/file route, which needs an absolute Host path and caps a single file at roughly 20 MiB. For larger files, download from the delivery card or the review page.
The plugin hides file- and directory-level native open controls ([data-open-target]). On a real desktop where those controls do work, restore them once:
localStorage.setItem('dsh-cloud-download:native-open', 'show')
location.reload()
To hide them again:
localStorage.removeItem('dsh-cloud-download:native-open')
location.reload()
From this repository:
dsh plugin --profile web add github:SOVLOOKUP/dsh-cloud-download
An npm release is planned under the same name; GitHub install works today.
Then reload the browser page. The package ships built index.js and client.js; the TypeScript sources live in src/ and are compiled at build/release time.
Requires a DSH Web build that exposes the four per-file slots listed above (developed against DSH 0.2.x). On a Host without those slots the plugin stays inert rather than replacing the official card.
/api/file (~20 MiB).403.dsh-save-button — download from delivery cards, with a compatibility layer for older DSH lines.dsh-file-transfer — confirmed download/upload in the preview toolbar and Files tree, including folder ZIP.This plugin is intentionally narrower: one download action across the card, the changed-files review, and the preview, plus the headless native-control cleanup.
npm install
npm run typecheck # strict TypeScript, including tests
npm test # path-escape and cross-Session security tests
npm run build # emit index.js and client.js from src/
npm pack --dry-run
The Host half registers one authenticated route at /api/cloud.download; the browser half registers four additive slots. No DSH core package is patched. The TypeScript build emits the runtime JS at the package root so existing installs keep working unchanged.
MIT. See LICENSE.