dsh-desktop-plugin

dsh-desktop-plugin

版本规则(2026-08-16 起):本插件与桌面应用版本线解耦——应用经 GitHub Release 自由前进(现 v1.6.50,已适配 dsh web 0.1.2+ 新鉴权体系),npm 包随插件内容变更发布(现 1.5.12,本版为 README/清单同步)。两线版本号不一致是有意设计:纯版本号空包只会触发所有用户的插件市场更新提示与重复下载。桌面应用启动时自动把已装插件对齐 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-windowos when 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" .url desktop shortcut that opens the DSH web UI in the default browser (default http://127.0.0.1:3080), reusing the desktop exe's whale icon when installed
• Registers the desktop_launch tool — 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.