🐋 Dsh-Desktop

DeepSeek Harness 桌面端伴侣插件 —— 托盘鲸鱼图标 · 桌面快捷方式 · 开机自启直达桌面窗口 · 一键切换桌面/Web 模式

cover

DeepSeek Harness 桌面端伴侣插件：托盘鲸鱼图标、桌面快捷方式、开机自启直达桌面窗口，一键切换桌面/Web 模式。

⚠️ 仅支持 Windows：本插件是 Windows 10 / 11 专用。在 macOS / Linux 上它虽然能被加载、不会崩溃，但托盘、桌面快捷方式、开机自启等桌面功能无法工作（这些依赖 Windows PowerShell 与任务计划程序），请在 Windows 环境使用。

📌 使用前请注意：需要 Node.js ≥ 20（与 DeepSeek Harness 相同）；建议安装 Microsoft Edge 或 Google Chrome（应用模式桌面窗口需要 Chromium 内核，两者都无时回退为默认浏览器普通窗口）；全程无需管理员权限；卸载时需手动清理（托盘、自启、快捷方式、%LOCALAPPDATA%\dsh-desktop）。

🚀 重点：桌面端 = DeepSeek Harness + 一个插件，无需任何额外安装。 DeepSeek Harness 的桌面体验完全以 Web 插件 的形式提供——不需要下载独立的桌面客户端、不需要重装、不需要管理员权限。只要你的电脑上已有 DeepSeek Harness Web 环境，安装本插件后重启，即可获得完整的桌面端体验。

✨ 功能特性

特性	说明
🐋 系统托盘伴侣	通知区域鲸鱼图标，右键菜单一键打开 / 退出，随时掌控 Harness
🖥️ 原生桌面窗口	本地 Chromium 应用模式（`--app`）渲染：1352:972 自适应比例、屏幕居中、可自由缩放；独立浏览器 profile，扩展/通知/登录提示绝不泄漏进窗口，无启动闪烁
🔄 一键切换桌面/Web	设置页按钮随当前状态显示切换桌面端 / 切换网页端，状态自动检测（无需 WMI），标签始终真实可靠
⚡ 秒级启动	登录任务以 `wscript.exe` 隐藏启动器（冷启动 <1s）直接拉起 `node <entry> web`（精确入口记录于 `harness.json`）；服务就绪前桌面窗口显示内置启动页，就绪后自动跳转；无 npx 网络往返、无端口冲突
🔁 开机自启	注册任务计划程序登录触发器（`DSHDesktop` 任务，无需管理员权限；`HKCU\...\Run` 仅作注册失败时的兜底），登录瞬间即触发，不排队等待启动队列
🚀 全程无终端闪现	所有外部 PowerShell 启动（快捷方式 / 托盘 / 登录任务）都经 `wscript.exe` 隐藏运行器（Win32 `SW_HIDE`），开机、打开、切换全程无控制台窗口闪现
🛡️ 退出即重开 · 托盘自愈 · 竞态防护	退出后立刻重开；`tray.pid` 单一所有权 + 互斥锁 abandoned 处理保证永远只有一个托盘；quit 标记等待、自愈就绪等待、打开互斥锁全面防竞态
🪟 终端显隐	设置页一键显示/隐藏 Harness 终端窗口，控制台随心切换
⚙️ 原生设置面板	DSH Web UI 内新增桌面端设置区：状态卡片、一键操作、上次打开诊断

📦 安装方法

环境要求

项目	要求
系统	Windows 10 / 11（自带 Windows PowerShell 5.1）
运行时	Node.js ≥ 20（与 DeepSeek Harness 相同）
Harness	DeepSeek Harness Web profile（`dsh web`）
浏览器	推荐 Chromium 系浏览器（Edge 随 Windows 自带）；桌面窗口优先使用默认浏览器（若为 Chromium 系），否则依次回退 Edge → Chrome

⚡ 方式一：一条命令安装（推荐）

在任意终端执行（需要 dsh CLI 与 pnpm，DSH 插件管理依赖 pnpm）：

dsh plugin --profile web add github:LvsH13/dsh-desktop

然后重启正在运行的 Web profile：

通知区域出现 🐋 鲸鱼托盘图标；
设置页出现新的 桌面端 区块；
开启自启后，登录即触发任务计划程序，秒级打开带启动页的桌面窗口（全程无终端闪现）。

方式二：从源码目录安装

git clone https://github.com/LvsH13/dsh-desktop.git
dsh plugin --profile web add "FULL/PATH/TO/dsh-desktop"

同样需要重启 Web profile 后生效。

方式三：手动添加（Web 插件标准流程）

进入 web profile 目录（默认 %USERPROFILE%\.dsh\profiles\web）；
在 package.json 的 dependencies 中添加本包——一条命令即可完成：
```
npm install github:LvsH13/dsh-desktop
```

在 profile 的 cordis.patch.yml 的 insert 列表中加入：

- insert:
    - id: dsh-desktop
      name: '@dsh-external/dsh-desktop'

重启 Web profile，插件生效。

卸载

dsh plugin --profile web remove "@dsh-external/dsh-desktop"

然后（可选）：退出托盘、关闭自启（删除 DSHDesktop 任务计划程序任务；若曾走 Run 键兜底，再删除 HKCU\...\Run 中的 DSHDesktop 键值）、删除桌面快捷方式与 %LOCALAPPDATA%\dsh-desktop 目录。

🚀 使用方法

打开 设置 → 桌面端：

面板	功能
状态	Harness 服务、托盘、桌面窗口、桌面快捷方式、自启、终端的实时状态
开机自启动	开关登录自启（任务计划程序登录触发器，Run 键兜底）；开启后登录即秒级拉起服务，直接打开带启动页的桌面窗口
操作	切换桌面端 / 切换网页端（按当前模式显示标签）、启动/退出托盘、创建桌面快捷方式、显示/隐藏终端

上次打开 一行会报告上次启动的就绪耗时（如 就绪耗时 1.2s）与窗口模式（独立窗口 / 默认浏览器），或失败原因——遇到卡顿时先看这里。

⚙️ 配置说明

项目	位置 / 说明
伴生文件目录	`%LOCALAPPDATA%\dsh-desktop\`（自动从 v0.1 的 `$DSH_HOME\desktop` 迁移）
`dsh-tray.ps1`	托盘/启动器核心脚本（窗口布局、单实例、就绪轮询、退出信号）
`harness.json`	记录当前安装的精确 CLI 入口、node、DSH_HOME、origin、端口
`state.json`	`showTerminal` / `autoStart` 状态
`open-state.json`	上次打开诊断（就绪耗时、窗口模式）
启动页	`boot.html`——服务就绪前桌面窗口显示的黑色鲸鱼白底启动页，就绪后自动跳转 UI
自启方式	任务计划程序登录触发器（`DSHDesktop` 任务，无需管理员权限）；`HKCU\...\Run` 仅注册失败时兜底；当前生效方式见 `%LOCALAPPDATA%\dsh-desktop\autostart-method.json`（`task` / `runkey`）
桌面/Web 状态检测	双通道：记录窗口 PID（主）+ WMI 命令行匹配（兜底），无 WMI 环境同样可靠
运行时依赖	`schemastery`（唯一运行时依赖）