桌面端伴侣 LvsH13/dsh-desktop

中文 · English

🐋 Dsh-Desktop

DeepSeek Harness 桌面端伴侣插件 —— 托盘鲸鱼图标 · 桌面快捷方式 · 开机自启（按设置打开桌面端或网页端） · 一键切换桌面/Web 模式

cover

dsh-plugin
type
version
license
platform
node

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，自动抑制 Google 翻译弹窗，扩展/通知/登录提示绝不泄漏进窗口，无启动闪烁 |
| 🔄 一键切换桌面/Web | 设置页按钮随当前状态显示 切换桌面端 / 切换网页端，状态自动检测（无需 WMI），标签始终真实可靠 |
| ⚡ 秒级启动 · 快捷方式先起服务 | 快捷方式与登录任务由专用极速启动器（dsh-open.vbs / dsh-autostart.vbs）直启服务，窗口并行准备；冷启动提前显示内置启动页（3–5s 可见），服务就绪后通过 DevTools 协议原地导航到认证地址，单窗口无缝切换、无 401 卡死、无端口冲突 |
| 🔁 开机自启（方式二选一） | 注册任务计划程序登录触发器（DSHDesktop 任务，无需管理员权限；HKCU\...\Run 仅作注册失败时的兜底）；启动器内嵌 --no-open，并支持 autoStartMode 设置（桌面端独立窗口 / 网页端默认浏览器），只开所选一端，绝不重复弹出两个窗口 |
| 🚀 全程无终端闪现 | 所有外部 PowerShell 启动（快捷方式 / 托盘 / 登录任务）都经 wscript.exe 隐藏运行器（Win32 SW_HIDE），开机、打开、切换全程无控制台窗口闪现 |
| 🛡️ 端口安全 · 熔断保护 · 托盘自愈 | 退出后立刻重开；精确启动标记 + 端口闸门杜绝并发拉起 Node 抢端口；连续 3 次失败自动熔断写入 launch-failures.json；启动标记全生命周期清理 |
| 🪟 终端显隐 | 设置页一键显示/隐藏 Harness 终端窗口，控制台随心切换 |
| ⚙️ 原生设置面板 | DSH Web UI 内新增 桌面端 设置区：首屏骨架屏秒开、去除冗余探测、支持开机打开方式选择、状态卡片与上次打开诊断 |

0.8.1 / 0.8.0 本次迭代

- 快捷方式提速：dsh-open.vbs 升级为快速启动器，探测服务并直启 Node，Node 冷启动不再串行排在 PowerShell 冷启动与窗口准备之后。
- 修复开机同时弹两个窗口：登录启动器补上 --no-open，彻底解决 DSH 自行弹默认浏览器与插件桌面窗口并存的必现问题。
- 新增开机打开方式设置 (autoStartMode)：设置页新增开机打开方式选项（桌面端独立窗口 / 网页端默认浏览器，二选一），严格只开一端。
- 端口闸门与防无限重启：重写 Start-Harness 端口等待逻辑，检测到冷启动中的 Node 进程时绝不并发拉起第二个实例；Ensure-Harness 增加 3 次失败自动熔断保护（写入 launch-failures.json）。
- 抑制 Chromium 翻译弹窗：独立 profile 自动写入 translate.enabled: false，彻底消除 Chrome 138+ 弹出的 Google 翻译气泡。
- 就绪判定与端口纠错：Test-HarnessHttp 拒绝启动期 404，Wait-HarnessToken 等待插件树完整加载后才开启窗口（解决左侧会话加载延迟）；harness.json 自动以 webServer.port 真实端口纠错。
- 性能与开销优化：同内容跳过文件重复写入；稳态启动通过文件时间戳直接判定，不再为快捷方式/自启确认而额外启动 PowerShell；设置面板加入骨架屏并去除冗余探测。

0.7.8 / 0.7.7 历史迭代

📦 安装方法

环境要求

| 项目 | 要求 |
| 系统 | 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；插件管理器会处理依赖安装）：

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 "克隆后的 dsh-desktop 目录绝对路径"

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

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

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

3. 在 profile 的 cordis.patch.yml 的 insert 列表中加入：
- insert:
- id: dsh-desktop
name: '@dsh-external/dsh-desktop'

4. 重启 Web profile，插件生效。

卸载

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

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

🚀 使用方法

打开 设置 → 桌面端：

| 面板 | 功能 |
| 状态 | Harness 服务、托盘、桌面窗口、桌面快捷方式、自启、终端的实时状态 |
| 开机自启动 | 开关登录自启（任务计划程序登录触发器，Run 键兜底）；可选择 开机打开方式（桌面端独立应用窗口 / 网页端默认浏览器，二选一，只开一端） |
| 操作 | 切换桌面端 / 切换网页端（按当前模式显示标签）、启动/退出托盘、创建桌面快捷方式、显示/隐藏终端 |

托盘右键菜单中的 重新启动 会按顺序停止并重新启动 Harness，保留托盘图标和开机自启动设置；重启期间重复点击快捷方式或“重新启动”不会创建额外的 Node 实例。

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

⚙️ 配置说明

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

⚠️ 保持 dsh-tray.ps1 为 UTF-8 with BOM 编码——Windows PowerShell 5.1 会乱码读取无 BOM 的 UTF-8 文件。

📸 成果展示

| 🖥️ 桌面端 DeepSeek Harness | 🐋 托盘图标 |
| 桌面端 DeepSeek Harness | 托盘鲸鱼图标 |
| 📌 桌面快捷方式 | 🗔 任务栏显示 |
| 桌面快捷方式 | 任务栏中的 DeepSeek Harness |
| ⚙️ 设置面板 · dsh-desktop | |
| 设置面板中的 dsh-desktop | |

📄 许可证

MIT · Copyright © 2026 LvsH13

🔖 本仓库属于 dsh-plugin 生态：dsh-plugin 话题 · GitHub 仓库