dsh-webui-launcher — DeepSeek Harness 跨平台 Web UI 启动器插件
English | 中文
从 harness 内部启动、停止、检查并打开 DeepSeek Harness Web UI——跨平台（Windows / macOS / Linux），无需任何桌面脚本。
安装
dsh plugin --profile web add github:YV3507/dsh-webui-launcher
或从本地检出安装：
cd dsh-webui-launcher
npm install && npm run build
dsh plugin --profile web add .
提供的能力
- 模型工具 —
webui_start/webui_stop/webui_status/webui_open：后台启动 Web UI（spawndsh --profile web）、等待 HTTP 200、查询或停止、打开默认浏览器。 - 斜杠命令 —
/webui start|stop|status|open。 - 设置页卡片 — Web UI 设置页上的「Web UI 启动器」卡片（浏览器半，
exports["./client"]），驱动同一组/webui/*JSON 端点。 - 桌面快捷方式 — 首次启动插件时在桌面自动创建启动器快捷方式（Windows
.lnk/ Linux.desktop/ macOS.command），双击后启动 Web UI 并在就绪时打开浏览器。无头主机（无桌面、无 DISPLAY）会静默跳过；可用desktopShortcut: false关闭。 - 默认图标为 dsh 图标 — 快捷方式默认使用 dsh 官方图标（Web 应用 favicon 光栅化并内置在
assets/；Windows 用.ico、Linux 用.png），图标复制到持久化状态目录，重装插件不会丢失。 - 自定义快捷方式图标 — 在设置卡片上传任意图片（PNG/JPEG/BMP/GIF/TIFF），自动转换（Windows 生成多尺寸
.ico，Linux 生成.png）并立即更新已有快捷方式的图标。显式配置shortcutIconPath可覆盖默认图标。
插件配置
| 选项 | 默认值 | 含义 |
|---|---|---|
port |
3080 |
Web UI 端口。 |
host |
127.0.0.1 |
dsh web 绑定的回环地址。 |
cliBin |
"" |
显式 dsh CLI 脚本；为空则复用当前运行的 CLI。 |
startupTimeoutMs |
120000 |
start 等待表面应答 HTTP 200 的时间。 |
openBrowserOnStart |
true |
Web UI 就绪后自动打开默认浏览器。 |
desktopShortcut |
true |
首次启动时创建桌面启动器快捷方式。 |
shortcutName |
"DeepSeek Harness Web UI" |
快捷方式显示名称。 |
shortcutIconPath |
"" |
显式图标图片；为空则使用内置的 dsh 图标。 |
行为与健壮性
- 接管或启动 — 端口上已有服务器时只接管：不重启、绝不停止。
webui_stop终止本插件 spawn 的进程树，也会终止启动器（或上一实例）记录过 PID 的接管服务器——仅当该 PID 是当前监听进程、且就是承载本插件的进程本身，杀前仍做node.exe身份核验。未记录 PID 的外部服务器绝不动。 - 显式状态机 —
idle → starting → running → stopping，单飞串行化：并发start/stop永不交错。 - 孤儿清理 — 插件卸载或热重载时，停止其 spawn 的服务器（
ctx.effectdispose）。 - PID 身份防护 — 杀进程前重新核验（存活、仍是本插件子进程、Windows 下经 tasklist 确认仍是 node.exe），绝不动被复用的 PID。
- 中止/超时卫生 — 被中止或超时的 start 会杀掉自己 spawn 的子进程，并在错误信息中带上输出尾部。
- CLI 定位兜底链 — 当前运行中的 CLI（
process.argv[1]）→@deepseek-ai/dsh包 → 显式cliBin配置；找不到时报可操作错误。
开发
npm run build # esbuild → lib/index.js（宿主）+ lib/client.js（浏览器）
npm test # node --test，零依赖（mock 两个外部包）
状态机的失败路径（子进程死亡、超时、中止、兄弟接管、并发、卸载清理）通过脚本化假依赖对构建产物做单元测试——不涉及真实进程与计时器。
安全性
默认仅回环地址，不提权、不连外网。插件只终止自己 spawn 的进程树——或所承载的、记录过 PID 的启动器服务器——且杀前核验 PID 仍属于该进程。
License
MIT
