DSH Harness 是一个插件驱动的开发工具。在日常使用中，频繁启动、重启和关闭服务器的操作需要多次切换终端和浏览器窗口。dsh-dock 插件通过在桌面生成原生程序图标、在系统托盘常驻状态以及提供侧栏快捷菜单，将上述操作收拢进“双击鲸鱼”的交互中。
是什么¶
双击桌面鲸鱼开窗、托盘常驻报状态、一键重启服务器的 DSH Harness 桌面启动器。
- 维护者：UnknowCao
- 类别：客户端
- 协议：MIT
安装与启用¶
该插件依赖 DSH 的 web profile 运行。安装后，桌面会自动出现 DSH Harness.exe 图标（黑鲸鱼图标）。
dsh plugin --profile web add github:UnknowCao/dsh-dock#v0.8.0
核心功能¶
- 一键启动：支持热路径（服务器在跑时静默全屏开窗）和冷路径（服务器未跑时显示启动卡片，就绪后自动开窗）。
- 系统托盘常驻：开窗后鲸鱼图标驻留系统托盘，悬停显示运行状态，左键秒开。
- 侧栏“鲸湾”菜单：提供“换气”（重载界面）、“洄游”（重启服务器）、“归湾”（完全退出）三个操作。
- 一键重启服务器：通过托盘右键或侧栏菜单完成，自动关闭旧窗口并重启服务。
- 开机自启：支持在插件设置页或托盘菜单中配置。
- 多环境支持：支持多份 DSH 环境同时运行，冷启动时可选择目标环境。
- 独立窗口：以独立 Edge 应用窗口运行，不混入主浏览器标签页。
- 插件设置页：集成在 DSH 系统设置中，可配置托盘常驻、开机自启及额外安装路径。
典型用法¶
- 安装：执行上述安装命令。
- 启动：双击桌面
DSH Harness.exe。 - 重启：在系统托盘右键，或点击侧栏“鲸湾”菜单的“洄游”。
- 退出：在侧栏点击“归湾”并确认，或在托盘单击“完全退出”。
注意事项¶
- 平台限制：仅限 Windows 平台。
- 运行依赖：运行时依赖 DSH Web Profile。
- 通信方式：只与本机回环通信，无安装钩子。
- 卸载行为：卸载不会自动清理安装目录。
- 冷启动依赖：冷启动需要 Node >= 22.19。
