@terricsh/dsh-desktop
Desktop shell for the DeepSeek Harness Web GUI: own window + tray, manages the local dsh web server (attach or spawn).
AI Analysis
核心用途是将 DSH Web 界面打包为自包含的桌面客户端。适合不想在机器上配置 Node 环境、追求双击即用和独立窗口体验的普通用户。
Install
This plugin has no verified bundle, or compatibility checks failed. Read the repository notes first. Read the full README ↗
README
Read the full README ↗@terricsh/dsh-desktop
DeepSeek Harness Web GUI 的桌面壳（Electron）：把 dsh web 装进独立窗口 +
系统托盘。打包后完全自包含——harness 代码（含 dsh CLI 与 Web 前端）内置
在应用里，机器上不需要任何 dsh / node 安装，双击即用。
上游项目
本应用内置的 harness 来自
DeepSeek Harness——
DeepSeek 官方的插件式 Agent 执行环境（Cordis 组合，dsh web 即其 Web GUI）。
dsh-desktop 是它的桌面壳：不改动 harness 任何代码，只负责窗口、托盘、
服务生命周期与打包分发。harness 升级后执行 npm run package -- -RefreshBundle
即可把新版本重新打进应用。
┌──────────────────────────┐
│ Electron 窗口（独立应用） │
│ ← 加载 http://127.0.0.1:
│
└──────────────────────────┘
│ spawn（默认，自己起内置 harness）；attach 仅在 --attach 时
▼
┌──────────────────────────┐
│ dsh web（Node 宿主进程） │ ← 关闭窗口=最小化到托盘，退出=杀进程
└──────────────────────────┘
运行方式：应用是独立的一套体系
| 场景 | 行为 |
|---|---|
| 默认 | spawn：从内置 harness 起自己的服务（--expose-internals 走 Electron 自带 Node 运行时），端口被占用时自动顺延到下一个空闲端口；退出时杀掉整个进程树，服务随之停止 |
--attach | 显式挂接端口上已有的 DSH 服务（测试/临时复用用），退出不影响它 |
内置服务使用应用自己的 DSH home（默认 /dsh-home），与浏览器 GUI
的 $DSH_HOME 相互独立——应用不共用、不依赖任何外部 dsh web（“网页的
node”）进程。首次运行会自动播种：profile 配置拷入 home，内置插件
（@terricsh/dsh-notify、@terricsh/dsh-app-launcher）从 bundled 安装树链
进 profile 的 node_modules。
应用注册 dsh:// URL scheme：通知点击等深链
（dsh://open-session?session=）会聚焦应用窗口并跳转到对应会话，
而不会在浏览器里打开网页。
开发态运行
cd E:\dsh\dsh-desktop
npm install
npm run bundle # 把当前部署的 harness 复制进 resources/harness（255MB，一次性）
npm start # 启动桌面应用
打包成独立 exe
一键打包（推荐）：
npm run package # 复用现有 resources/harness，产出安装包 + 便携版
npm run package -- -RefreshBundle # 先从当前部署重新同步 harness 再打包
产物（dist/）：
| 文件 | 说明 |
|---|---|
DSH Desktop Setup 0.1.0.exe | NSIS 安装版（推荐）：安装有进度条，装完后启动无解压、秒开 |
DSH Desktop 0.1.0.exe | 便携版：单文件拷走即用；首次双击会静默解压数分钟（33000 个文件，期间无任何窗口），之后启动复用缓存 |
手动分步：
npm run bundle # 把当前部署的 harness 复制进 resources/harness（255MB，一次性）
npm run dist # electron-builder --win → 两个安装产物
产物是单个便携 exe（~200MB）：拷贝到任何 Windows 机器双击即用，自带 Node 运行时与整个 harness，不依赖外部安装。
可选参数
npm start -- --port 3199 # 首选端口（被占用时自动顺延）
npm start -- --dsh-command "C:\path\to\dsh.cmd" # 强制用外部 dsh（跳过内置）
npm start -- --no-tray # 关窗口直接退出（不驻留托盘）
npm start -- --attach # 挂接已有服务（默认是自己起独立服务）
npm start -- --smoke # 无头自检：截图 smoke.png 后退出
环境变量：
| 变量 | 作用 |
|---|---|
DSH_DESKTOP_COMMAND | 与 --dsh-command 等效 |
DSH_DESKTOP_PORT | 与 --port 等效 |
DSH_DESKTOP_HOME | 应用 DSH home 路径（默认 /dsh-home） |
DSH_DESKTOP_USERDATA | Chromium 配置目录（便携/测试模式） |
自检
npm run smoke # 起独立服务（端口被占用则顺延），加载 GUI，截图到 data/smoke.png 后退出
全链路 bundled 自检（无需任何外部 dsh）：
$env:DSH_DESKTOP_HOME = "E:\dsh\dsh-desktop\data\test-home"
$env:DSH_DESKTOP_USERDATA = "E:\dsh\dsh-desktop\data\userdata-smoke"
electron.exe . --smoke --port 3199
在应用自己的 home 里加插件
应用的 home（默认 /dsh-home）profile patch 由 bundled 配置播种，
开箱即带 @terricsh/dsh-notify（桌面通知）和 @terricsh/dsh-app-launcher
（工作区启动器）两个内置插件（npm run bundle 时连同代码一起打进
resources/harness，首次运行由 home.js 链进 profile 的 node_modules）。
要加自己的插件：
- 把插件包放进
dsh-home\profiles\web\node_modules\（或dsh-home\profiles\node_modules\）； - 编辑
dsh-home\profiles\web\cordis.patch.yml加 insert 行（见各插件 README）； - 重启应用。
不需要通知/启动器时，把 cordis.patch.yml 里对应的 insert 行删掉即可。
生成图标
npm run make-icon # favicon.svg → icon.png / icon-256/64/32/16.png
powershell -File scripts\make-icon.ps1 # 再生成 icon.ico（Windows 任务栏）
工作原理与安全
- 壳内 BrowserWindow 就是普通浏览器上下文（
sandbox: true、无 nodeIntegration、contextIsolation: true），与浏览器打开127.0.0.1:3080完全同权，不新增 任何权限面；DSH 的 loopback 信任围栏、审批、沙箱全部照旧。 - spawn 的服务日志写在
data/server.log（本目录，已 gitignore）。 - 单实例锁：重复启动只会聚焦已有窗口，不会拉起第二个服务；
dsh://深链 （通知点击等）通过second-instanceargv 转发给已运行实例，冷启动时则 从进程 argv 读取，无论哪种情况都聚焦窗口并跳转到对应会话，不打开浏览器。 - 打包时 harness 通过
extraResources以真实文件落盘（junction/链接需要真实 路径，不能进 asar）；应用代码本体（src/assets）在 asar 内。
配合周边项目
@terricsh/dsh-notify：桌面通知 + 点击激活应用窗口直达对应会话；@terricsh/dsh-app-launcher：从会话头部一键打开 工作区文件夹 / VS Code。