@zerorigin-studio/dsh-desktop-shell

Readme

# @zerorigin-studio/dsh-desktop-shell

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 注册表项

## 安装

```bash
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 插件需要开原生独立窗口时，直接调用统一入口即可：

```js
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）通过该标准入口打开「网页对话」独立窗口。