DSH 一键启动（dsh-desktop-launcher）

DeepSeek Harness 的 Windows 一键启动桌面图标：双击图标 = 确保后端服务运行（未运行则自动拉起），再在你现有的浏览器里打开前端标签页。附控制面板插件（Run 卡片上的 安装/打开/卸载 按钮 + dsh_desktop 模型工具）。

GitHub topic: dsh-plugin（DeepSeek Harness 社区插件市场按此 topic 同步收录）。

功能

• 后端：双击时检测 http://127.0.0.1:3080，没在跑就以低优先级静默拉起 dsh web（node ...\lib\bin.js web），等待就绪（最多 240 秒，进程崩溃会提前退出），并预热页面。
• 前端：就绪后在你现有的浏览器里打开普通标签页 —— 共享浏览器进程，不额外开浏览器实例、不建独立 profile，内存代价与手动开标签页完全一致。
• 隐藏执行：图标 → wscript.exe → VBS → 隐藏 PowerShell，绝不弹控制台窗口。
• 可诊断：启动器每步写日志 %USERPROFILE%\.dsh\dsh-launcher.log；后端启动失败会弹 MessageBox 提示日志位置。
• 管理：动态 Cordis 插件提供 dsh_desktop 工具（install / status / launch / uninstall）与 Run 卡片控制面板。

安装（动态插件）

本插件以 dynamic Cordis plugin 形式加载（会话级、进程内）。在 Harness 会话中（cordis_define）把 plugin/host.js 作为 code.host、plugin/client.js 作为 code.client 填入，然后 cordis_run 激活（Client 半部分需要一次授权）。激活后：

1. 对模型说「安装桌面图标」或调用 dsh_desktop 工具 action=install；
2. 桌面出现「DSH 一键启动」图标；
3. 之后随时双击图标即可。

说明：桌面图标和启动器是独立文件（%USERPROFILE%\.dsh\dsh-desktop-launcher.ps1 / .vbs），插件进程消失（Harness 重启）后它们照常可用；插件只是生成/管理它们的工具。

文件结构

plugin/host.js      Host 半部分（模型工具 + RPC + 启动器/安装脚本生成）
plugin/client.js    Client 半部分（Run 卡片控制面板）
launcher/           生成的启动器样例（真实路径已烘焙，仅作参考；install 会重新生成）

常见问题

问题	原因 / 处理
后端没起来，弹了「DSH 后端未能启动」	看 %USERPROFILE%\.dsh\dsh-launcher.log 最后几行；常见于 Start-Process 参数错误（见下）
-PriorityClass 报参数错误	PowerShell 7 专属参数，Windows PowerShell 5.1 不识别。v3 已改为进程启动后通过 .NET $boot.PriorityClass = BelowNormal 设置
弹控制台窗口	早期版本用 .lnk → powershell -WindowStyle Hidden，双击场景不可靠；v3 用 VBS 包裹（wscript.exe），保证无窗口
全系统卡顿 ~3 分钟	后端首次 boot 的重活（加载整个 profile、会话索引重建）在端口就绪后继续跑；低优先级启动后不会再抢瘫系统，最坏只是 DSH 窗口晚点出现
插件随 Harness 重启丢失	动态插件是进程级的，正常现象；图标与启动器是独立文件不受影响

卸载

调用 dsh_desktop 工具 action=uninstall（或面板「卸载」按钮）：删除桌面图标、启动器、VBS 包裹。

License

MIT