dsh-desktop-plugin
已验证dsh-desktop-plugin · v1.5.10 · MIT
Install and launch the dsh-desktop-windowos desktop shell: auto-downloads and auto-updates the exe from GitHub Releases, creates desktop shortcuts (app + web UI), and exposes a desktop_launch tool. First run of the unsigned exe shows Windows SmartScreen -
安装
dsh plugin add dsh-desktop-plugin 用 dsh --profile default --dump-config 确认 layer 已生效 —— 参见安装指南。
源码
作者
说明文档
dsh-desktop-plugin
版本规则:本插件与桌面应用共用同一条版本线(如插件 1.4.2 = 应用 v1.4.2);插件单独改进时版本号继续前进,始终 ≥ 应用版本。
DSH 插件:安装并启动 dsh-desktop-windowos 桌面壳(DeepSeek Harness 的 Windows 托盘应用)。
- 插件激活时自动确保桌面应用就绪:缺失则从 GitHub Releases 下载 exe 到
%LOCALAPPDATA%\Programs\dsh-desktop-windowos\,并在桌面创建/刷新不带版本号的快捷方式「DeepSeek Harness」;已存在则跳过下载 - 自动升级:每次激活时比对已装版本与最新 Release,有新版自动下载替换(运行中也能安全替换,旧文件保留为
.old) - 同时在桌面创建/刷新
.url快捷方式「DeepSeek Harness Web」,用默认浏览器打开 DSH 前端(默认http://127.0.0.1:3080);exe 已安装时复用其鲸鱼图标 - 注册
desktop_launch工具:对话里说"打开桌面应用"即可安装并拉起, agent 可直接调用;exe 缺失时走后台任务安装(标准 job_output/job_list 可轮询,完成后自动启动),exe 已存在则前台秒开 - 安装/下载失败不影响 DSH 启动,错误只记录日志,下次激活或调用工具时重试
首次双击 exe 会弹 Windows SmartScreen 蓝色警告("Windows 已保护你的电脑")——exe 未签名所致,点「更多信息 → 仍要运行"即可,以后不再弹。
安装
dsh plugin --profile web add dsh-desktop-plugin
重启 DSH(dsh web)后生效。要求 Windows + Node ^22.19 或 ≥ 24。
配置(cordis.patch.yml)
| 字段 | 默认 | 说明 |
|---|---|---|
| autoInstall | true | 激活时自动安装/刷新 |
| autoUpdate | true | 激活时检查并升级新 Release |
| assetProxy | (空) | Release 资产下载镜像前缀,如 https://ghproxy.com/(GitHub 直连不畅时用) |
| createShortcut | true | 创建桌面应用快捷方式 |
| createWebShortcut | true | 创建前端 Web 快捷方式(.url) |
| installDir | %LOCALAPPDATA%\Programs\dsh-desktop-windowos | exe 安装目录 |
| shortcutName | DeepSeek Harness | 快捷方式名称(无版本号) |
| webShortcutName | DeepSeek Harness Web | Web 快捷方式名称(无扩展名) |
| webUrl | http://127.0.0.1:3080 | Web 快捷方式打开的地址 |
| repoSlug | RAFOLIE/dsh-desktop-windowos | exe 的 GitHub Release 来源 |
| backgroundInstall | true | 工具装 exe 走后台任务;关闭则永远前台安装 |
English
Versioning rule: npm publishes are on-demand: this package ships only when the plugin itself changes (currently 1.5.9); the app version advances independently and aligns installed plugins to npm latest.
DSH plugin that installs and launches dsh-desktop-windowos — the Windows tray shell for DeepSeek Harness.
- On activation it ensures the desktop app is ready: downloads the exe from GitHub Releases into
%LOCALAPPDATA%\Programs\dsh-desktop-windowoswhen missing and creates/refreshes a version-less desktop shortcut "DeepSeek Harness"; existing installs are left alone - Auto-update: each activation compares the installed version with the latest Release and swaps in the new exe when one exists (safe even while the app is running; the old file is kept as
.old) - It also creates/refreshes a "DeepSeek Harness Web"
.urldesktop shortcut that opens the DSH web UI in the default browser (defaulthttp://127.0.0.1:3080), reusing the desktop exe's whale icon when installed - Registers the
desktop_launchtool — say "open the desktop app" in chat and the agent installs/launches it; a missing exe installs as a background job (pollable via the standard job_output/job_list tools, auto-launches when done) while an existing exe launches instantly in the foreground - A failed install never blocks DSH startup; errors are logged and retried on next activation or tool call
First launch of the exe shows the Windows SmartScreen warning ("Windows protected your PC") because the exe is unsigned — click More info → Run anyway; it will not appear again.
Install
dsh plugin --profile web add dsh-desktop-plugin
Restart DSH (dsh web) to activate. Requires Windows + Node ^22.19 or ≥ 24.
Configuration
See the table above; all keys are optional with those defaults.