@zerorigin-studio/dsh-desktop-shell

September 3, 2026 · View on GitHub

dsh 桌面壳插件：把 DeepSeek Harness 封装成原生 Windows 桌面客户端。

功能

内置桌面客户端：dsh-desktop-shell-client.exe（Wails v3 + WebView2，~13MB）打包在 npm 包 bin/ 内——装插件即得桌面窗口，无需单独安装客户端
自动拉起桌面客户端：dsh 启动后，插件探测 web 端口、写协议文件、启动包内 exe——独立桌面窗口包裹 Harness UI（无浏览器痕迹）
协议文件：~/.dsh/dsh-web-port.json 写入 {port, url, pid, harnessVersion, pluginVersion, runtimeDir}——客户端据此连接，设置页展示版本信息
快捷方式：桌面 + 开始菜单注册；卸载插件时自动删除
客户端自动拉起 dsh：若 harness 未运行，客户端自身会隐形启动（无控制台窗口）
开机自启开关：设置页「桌面壳」开关，写入 HKCU Run 注册表项

安装

dsh plugin --profile web add @zerorigin-studio/dsh-desktop-shell
# 然后手动把 "@zerorigin-studio/dsh-desktop-shell" 追加到
# ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 数组
# 重启 harness

🪟 多窗口接入标准（插件开发者）

客户端向每个托管页面注入标准桌面 SDK window.dsh.desktop（version 1）。任何 dsh 插件需要开原生独立窗口时，直接调用统一入口即可：

await window.dsh.desktop.openWindow({
  url: "https://chat.deepseek.com/",
  title: "DeepSeek 网页对话",
  width: 1024,
  height: 768,
});

协议说明：

底层走 WebView2 宿主消息（window.chrome.webview.postMessage → { type: "dsh.desktop.openWindow", url, title, width, height }），由客户端 RawMessageHandler 接收并打开原生窗口——无跨端口 fetch / CORS，任何页面（含外部 harness）都成立；
SDK 方法：openWindow({url,title,width,height})（返回 Promise）、closeWindow(id)、getInfo()；
检测宿主：有 window.chrome.webview.postMessage 即视为桌面宿主存在；没有时插件应自行降级（如当前 webview 内导航）——插件在纯浏览器/第三方壳中不应失效；
兼容旧协议：宿主仍注入 window.__DSH_DESKTOP_API__（http://127.0.0.1:<port>/<token>，HTTP 桥接），老插件 fetch(api + "/window/chat") 路径继续可用；
参照实现：dsh-deepseek-chat（@zerorigin-studio/dsh-deepseek-chat）通过该标准入口打开「网页对话」独立窗口。