dsh-webui-installer
DSH 插件 dsh-webui-installer
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:FYHC1/dsh-webui-installer#9b111ed559afc6ac1b89af4aaec372c8a46232baDSH 插件 dsh-webui-installer
Webui Installer 以 dsh-webui-installer 发布，当前版本为 1.4.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
需要托盘后台管理？ 本插件只负责"双击快捷方式弹出独立窗口"（v1.x，已收尾不再大改）。 如果你还需要常驻托盘、服务守护/重启、多实例、WSL systemd 托管、状态显示与一键更新， 请使用新一代管理器 dsh-web-manager （dsh 插件 + Windows 托盘，独立 Edge 应用窗口、快捷方式快速打开，体验一致且功能更全）。
让 DeepSeek Harness 的 WebUI（dsh web）有桌面快捷方式，双击即可启动并打开无浏览器界面的 App 窗口。
关键设计：在 Windows 原生 的 DeepSeek Harness 上安装时，使用 Windows 平台命令（PowerShell / cmd） 创建快捷方式，快捷方式启动的是 Windows 侧 的 dsh web（如 nvm4w 安装的 dsh.cmd），不经过 WSL、不运行 bash 脚本。
按平台生成各自的快捷方式（v1.4.0）：快捷方式以 (win) / (wsl) / (linux) 后缀命名区分，各启动对应平台的 dsh web 并弹出 App 窗口，不生成 .bat：
DeepSeek Harness WebUI (win).lnk（Windows 桌面）DeepSeek Harness WebUI (wsl).lnk（Windows 桌面，未启动 WSL 会自动启动发行版）+ 注册 dsh-ui 命令DeepSeek Harness WebUI (linux).desktop（Linux 桌面）+ 注册 dsh-ui 命令图标：安装时自动采用桌面 DeepSeek Harness.lnk（Edge PWA 安装的官方图标）的图标，缺失时回退随包 dsh-webui.ico；并把图标物化一份到 %USERPROFILE%\.dsh-webui\dsh-webui.ico，供看护进程设置 App 窗口/任务栏图标（v1.4.2）。
任务栏图标与快捷方式同款（v1.4.2）：dsh web 页面只提供 SVG favicon，Chromium 的 --app 窗口拿不到位图图标，任务栏会显示 Edge 默认图标。看护进程（dsh-ui-winsize.ps1）会在 App 窗口出现后把官方图标（%USERPROFILE%\.dsh-webui\dsh-webui.ico）以 WM_SETICON 设置到窗口（32px 大图标 + 16px 小图标），并每 3 秒重新应用一次以覆盖 Edge 自身的图标切换，任务栏/窗口图标与桌面快捷方式保持一致。
无 cmd 窗口 + 窗口尺寸记忆（v1.4.0）：Windows 快捷方式双击后 dsh web 以隐藏方式启动（不再闪现 cmd 窗口，日志写入 %USERPROFILE%\.dsh-webui\dsh-web.log）；App 窗口默认横向 1280×800，关闭后自动记忆调整过的尺寸，下次启动恢复。
关闭窗口自动停止服务（v1.4.1）：WSL / Linux 脚本关闭浏览器窗口即停止 dsh web；Windows 启动器新增看护进程（dsh-ui-winsize.ps1），检测到 App 窗口关闭后停止由本启动器拉起的 dsh web（仅监听该端口的那个进程），不会误杀启动器外已运行的 dsh web（例如已手动启动/其它快捷方式启动的实例）。同时修正：启动失败（120 秒内未就绪）时清理本次拉起的 dsh web；DSH_WEBUI_DATA_DIR 可覆盖浏览器独立数据目录（默认 %LOCALAPPDATA%\dsh-webui-browser）。
安装器输出强制 UTF-8，在 PowerShell / dsh 控制台里中文不再乱码。
dsh plugin --profile web add "github:FYHC1/dsh-webui-installer#main"
# 查看已安装的插件
dsh plugin --profile web list
# 更新插件到最新版本
dsh plugin --profile web update dsh-webui-installer
安装后需要重启 DSH（重新运行
dsh web）才会加载插件并执行apply()。apply()会先检测桌面快捷方式是否已存在：已存在则跳过安装（不再每次启动都重跑安装器）；只有快捷方式缺失时才自动运行安装器。如需强制重装，用dsh-ui-install工具或直接运行安装器：
- Windows:
powershell -NoProfile -ExecutionPolicy Bypass -File <包目录>\install-dsh-webui.ps1- WSL/Linux:
bash <包目录>/install-dsh-webui.sh
| 平台 | 安装器 | 创建内容 | 快捷方式启动的目标 |
|---|---|---|---|
| Windows（win32） | install-dsh-webui.ps1（PowerShell 原生） | 桌面 DeepSeek Harness WebUI (win).lnk（无窗口，wscript+VBS）+ %USERPROFILE%\.dsh-webui\ 目录 | Windows 侧 dsh web（自动探测 nvm4w 的 dsh.cmd） |
| WSL | install-dsh-webui.sh（bash，自动进入 wsl 模式） | Windows 桌面 DeepSeek Harness WebUI (wsl).lnk + ~/.local/share/dsh-webui/ + dsh-ui 命令 | WSL 侧 dsh web（wsl.exe 未启动则自动启动发行版） |
| Linux（原生） | install-dsh-webui.sh（bash，自动进入 linux 模式） | Linux DeepSeek Harness WebUI (linux).desktop + ~/.local/share/dsh-webui/ + dsh-ui 命令 | Linux 侧 dsh web |
三端产物均只生成快捷方式，不生成任何 .bat；旧版遗留的无后缀快捷方式 / .bat / 旧 Linux 入口会在安装与卸载时自动清理，但不影响其它平台带后缀的快捷方式。
Windows 快捷方式启动流程（%USERPROFILE%\.dsh-webui\start-dsh-webui.cmd）：
3080 是否已在服务（已在运行则直接开浏览器，防重复启动；此时不会把已有服务当作本次启动的进程）dsh web（start /b，无 cmd 窗口，日志写 %USERPROFILE%\.dsh-webui\dsh-web.log；并标记 KILL_ON_CLOSE=1）--app=http://127.0.0.1:3080 App 窗口（独立浏览器数据目录，可用 DSH_WEBUI_DATA_DIR 覆盖；默认横向 1280×800，按 %USERPROFILE%\.dsh-webui-browser\window-size 记忆上次尺寸）dsh-ui-winsize.ps1）：窗口开着时持续保存窗口尺寸；检测到窗口关闭（约 12 秒）后，若 KILL_ON_CLOSE=1 则停止监听该端口的 dsh web 进程并退出，否则仅退出（不误伤已在运行的实例）快捷方式图标：优先采用桌面 DeepSeek Harness.lnk（Edge PWA）图标，缺失回退 dsh-webui.ico；无窗口运行（wscript+VBS）。
环境变量：DSH_WEB_PORT（默认 3080）可在 start-dsh-webui.cmd 外设置以改端口（启动时传给 dsh web --port，dsh web 自身不读该环境变量）。
dsh plugin --profile web remove dsh-webui-installer # 或手动运行安装器 --Uninstall / --uninstall
卸载时按平台删除对应快捷方式与启动文件：Windows 删除 (win).lnk 与 %USERPROFILE%\.dsh-webui；WSL 删除 (wsl).lnk 与 WSL 脚本 / dsh-ui；Linux 删除 (linux).desktop 与 dsh-ui；并顺带清理旧版遗留的无后缀快捷方式 / .bat / Linux 入口（幂等）。
dsh-webui-installer
├── package.json # name: dsh-webui-installer, dsh.bundle.patch
├── cordis.patch.yml # insert 一行 name: dsh-webui-installer
├── lib/index.js # apply() 自动安装（已存在则跳过）+ 注册工具
├── install-dsh-webui.ps1 # Windows 原生安装器（(win).lnk，PowerShell/cmd，启动 Windows 侧 dsh web）
├── install-dsh-webui.sh # WSL/Linux 安装器（bash，wsl 模式 → (wsl).lnk；linux 模式 → (linux).desktop）
├── start-dsh-webui.sh # WSL 主脚本（随 wsl 模式安装；也可独立运行）
├── start-dsh-webui.bat # 独立 Windows 一键启动（保留直接使用，桌面不再生成）
├── start-dsh-webui-linux.sh # 原生 Linux 脚本（随 linux 模式安装；也可独立运行）
├── dsh-webui.svg # Linux 应用图标源文件
└── dsh-webui.ico # Windows 快捷方式图标（由 SVG 生成；安装时物化到 %USERPROFILE%\.dsh-webui\ 供看护进程设置窗口/任务栏图标）
lib/index.js 的 apply() 在插件加载时按运行平台分支，并先检测本平台快捷方式是否已存在：Windows 检查桌面 (win).lnk、WSL 经 powershell.exe 探测桌面 (wsl).lnk、Linux 检查 .local/share/applications/dsh-webui-linux.desktop，已存在则跳过：
win32 → 运行 install-dsh-webui.ps1（纯 Windows 命令）install-dsh-webui.sh（自动进入 wsl 模式）install-dsh-webui.sh（自动进入 linux 模式；可用 DSH_WEBUI_MODE=linux 强制）同时注册 dsh-ui-install（强制重装）/ dsh-ui-uninstall 两个工具供 agent 手动调用。