前言¶
DeepSeek Harness (DSH) 采用「一切皆插件」的架构理念。对于需要在浏览器端和桌面端之间切换的开发者,管理独立的 Tauri 应用实例、快捷方式以及退出流程通常需要手动操作。DSH Tauri Launcher 插件将桌面端的启停、退出确认及快捷方式管理抽象为标准的 Web 插件,用户可直接在 DSH 的设置面板中完成这些操作,无需脱离 Web 界面。
这是什么¶
DSH Tauri Launcher 是一个 DSH 插件,由 cilis 维护。它解决了在 Web 环境下管理 Tauri 桌面应用实例的问题,通过插件化的方式实现桌面启动开关、快捷方式联动和状态可视。
核心功能¶
该插件提供以下能力:
- 桌面端启动开关:在 Web 设置面板中一键启动或退出桌面应用,点击后立即反馈,秒级同步状态。
- 快捷方式联动:开启时自动创建桌面快捷方式,关闭时自动删除;运行中支持手动补建。
- 关闭确认弹窗:关闭前弹出确认框,并提示快捷方式将被删除。
- 状态可视:显示运行中(绿色)、已停止(灰色)、状态未知(黄色)或错误状态,并附带诊断信息。
- 深色模式适配:界面颜色适配 DSH 主题令牌,支持深浅色自动切换。
- 设置导航显示器图标:替换默认齿轮图标,使用矢量绘制,任意缩放保持锐利。
安装与启用¶
安装命令如下。请将命令中的 <profile> 替换为你实际使用的配置档名称(例如 web):
dsh plugin --profile web add github:cilis/dsh-tauri-launcher
安装完成后,重启 DSH Web 进程,在设置面板中即可看到「桌面启动」分区。通过 dsh --profile web --dump-config 命令可以验证插件是否已生效。
典型用法¶
- 进入 DSH 设置 → 桌面启动。
- 配置参数:
launcherExe:桌面应用 exe 绝对路径,留空则自动探测。launcherDirs:候选 exe 目录列表,留空则使用内置默认候选。freshSecs:心跳“新鲜窗口”的秒数,须大于心跳写入周期。
- 点击开关即可唤起或关闭 Tauri 桌面应用。
适用场景与注意¶
- 平台限制:目前仅支持 Windows。Linux 和 macOS 尚在规划中。
- 快捷方式命名:快捷方式文件名由插件与桌面应用共用(
DeepSeek Harness.lnk),不存在自定义名称配置。 - 开发维护:修改
launcher/src-tauri下的 Rust 源码后,必须重新构建dsh-launcher.exe,否则 npm 包内 exe 与源码会不一致。 - 依赖机制:插件依赖标记文件协议控制桌面应用(
.dsh-heartbeat用于探测运行状态,.dsh-quit用于优雅退出)。
结语¶
DSH Tauri Launcher 将桌面应用的管理流程标准化、插件化,降低了 Web 与桌面端集成的门槛。该插件通过共享心跳文件和快捷方式,确保了状态同步的准确性。更多技术细节及源码,请参考插件目录或 GitHub 仓库。