dsh-desktop-plugin
August 18, 2026 · View on GitHub
版本规则(2026-08-16 起):本插件与桌面应用版本线解耦——应用经 GitHub Release 自由前进(现 v1.6.2),npm 包仅在插件代码变更时发布(现 1.5.10)。两线版本号不一致是有意设计:内容相同的空包只会触发所有用户的插件市场更新提示与重复下载。桌面应用启动时自动把已装插件对齐 npm 最新版(只升不降)。
DSH 插件:安装并启动 dsh-desktop-windowos 桌面壳(DeepSeek Harness 的 Windows 托盘应用)。
- 插件激活时自动确保桌面应用就绪:缺失则从 GitHub Releases 下载 exe 到
%LOCALAPPDATA%\Programs\dsh-desktop-windowos\,并在桌面创建/刷新不带版本号的快捷方式「DeepSeek Harness」;已存在则跳过下载 - 自动升级:每次激活时比对已装版本与最新 Release,有新版自动下载替换(运行中也能安全替换,旧文件保留为
.old);下载走多路由链(assetProxy → 直连 → 环境代理 → 本机常见代理端口探活 → 公共镜像)并经 sha256+大小完整性校验,镜像被投毒/截断自动换路 - 同时在桌面创建/刷新
.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 资产下载镜像前缀(路由链第一跳)。通常无需配置:下载会自动尝试 直连→环境代理→本机常见代理端口→公共镜像;仅在需要强制指定镜像时填写 |
| 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 (since 2026-08-16): npm and the app version lines are decoupled — the app advances freely via GitHub Releases (currently v1.6.2) while this package ships only when the plugin code changes (currently 1.5.10). The mismatch is deliberate: identical empty packages would just trigger update prompts for every plugin user. The desktop app aligns installed plugins to npm latest (upgrade only).
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); downloads run a multi-route chain (assetProxy → direct → env proxies → local proxy-port probe → public mirrors) with sha256 + size integrity checks, discarding any tampered or truncated mirror automatically - 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.