HTUP1 / dsh-desktop-launcher

dsh-desktop-launcher

DeepSeek Harness 桌面启动器（Windows）—— 双击图标即可一键启动 / 停止 DeepSeek Harness Web 控制台。

特性

• 双击即用：自动终止 3080 端口上的残留实例，保证只有一个服务在运行
• 终端窗口前台运行：dsh web 的日志实时显示在终端里，方便排查
• 关窗即停：关闭终端窗口（或按 Ctrl+C）即真正终止 dsh web 进程，无需任务管理器
• 自动打开浏览器：服务就绪后用 Microsoft Edge 打开控制台（可配置为默认浏览器）
• 单实例保护：控制终端已存在时重复双击不会产生第二个实例
• 完全可配置：通过 config.ps1 覆盖所有路径（node / dsh CLI / 工作目录 / Edge / URL）

要求

• Windows 10 / 11（自带 Windows PowerShell 5.1，无需额外安装）
• Node.js
• DeepSeek Harness CLI（dsh）

安装

1. 下载本仓库到本地任意目录（例如 D:\dsh-desktop-launcher）
2. 复制 config.example.ps1 为 config.ps1，按注释修改其中的路径（node.exe、dsh 的 bin.js、工作目录等）
3. 右键 open-dsh.ps1 → 「发送到」→「桌面快捷方式」，再把快捷方式的图标设置为 deepseek-harness.ico 即可

使用

• 双击快捷方式 → 弹出终端窗口，dsh web 在其中前台运行，Edge 自动打开控制台
• 使用完毕后，直接关闭终端窗口（或按 Ctrl+C），服务即被真正终止
• 日志：工作目录下的 open-dsh.log（启动 / 停止 / 杀进程记录）；服务自身日志直接在终端显示

常见问题

• 启动失败？ 终端会显示错误提示；确认 config.ps1 中的 $NodePath 和 $DshCli 路径正确
• 端口被占用？ 脚本会自动终止 3080 端口上的旧监听进程后重新启动
• 想用默认浏览器打开？ 把 config.ps1 中的 $EdgePath 留空即可
• dsh 是通过 npx 安装的？ $DshCli 直接填 %LOCALAPPDATA%\npm-cache\_npx\<hash>\node_modules\@deepseek-ai\dsh\lib\bin.js

许可证

MIT