启停面板 Charlottepyc23/dsh-control-tool

DSH Control Tool

一个小型原生控制工具，用来在 Windows 上启动、打开和关闭 DeepSeek Harness（DSH）Web 服务。

本项目为非官方工具，与 DeepSeek 官方无隶属或授权关系。

功能

- 双击 EXE 后选择启动或关闭 DSH
- 检测 http://127.0.0.1:3080/ 是否可访问
- DSH 已运行时直接打开浏览器
- 在后台启动 DSH，不显示命令行窗口
- 等待 Web 服务就绪后自动打开页面
- 仅关闭命令行可确认为 DSH Web 的进程，降低误关其他程序的风险
- 支持 start、stop、status 和 probe 命令行参数
- 图标和 Windows application manifest 均嵌入 EXE

环境要求

- Windows 10 或 Windows 11 x64
- Node.js
- 已全局安装 @deepseek-ai/dsh
- %APPDATA%\npm\dsh.cmd 存在

安装 DSH：

npm install --global @deepseek-ai/dsh

使用方法

从项目的 Releases 页面下载 DSHControlTool.exe，然后双击运行。

也可以在 PowerShell 中使用命令行参数：

.\DSHControlTool.exe start
.\DSHControlTool.exe stop
.\DSHControlTool.exe status
.\DSHControlTool.exe probe

参数说明：

| 参数 | 行为 |
| start | 启动 DSH，服务就绪后打开浏览器；已经运行时直接打开页面 |
| stop | 关闭检测到的 DSH Web 进程 |
| status | 显示服务是否可访问 |
| probe | 仅通过退出码报告状态，运行时返回 0，不可访问时返回 1 |

从源码构建

需要安装：

- Visual Studio 2022 Build Tools 或更新版本
- Desktop development with C++ 工作负载
- Windows 10/11 SDK

在仓库根目录运行：

build.bat

构建结果：

dist\DSHControlTool.exe

build.bat 使用 Visual Studio Installer 提供的 vswhere.exe 自动寻找最新的 C++ Build Tools。

项目结构

.
├── src/
│ └── DSHControlTool.cpp
├── resources/
│ ├── app.ico
│ ├── app.manifest
│ ├── app.rc
│ ├── resource.h
│ └── source-icon.png
├── dist/
│ └── .gitkeep
├── .gitignore
├── build.bat
├── LICENSE
└── README.md

source-icon.png 是图标原图，app.ico 是供 Windows 资源编译器使用的多尺寸图标。app.manifest 和 app.ico 会通过 app.rc 编译进最终 EXE，无需随 EXE 一同分发。

发布建议

源码文件提交到 GitHub 仓库。dist/DSHControlTool.exe 不提交到 Git，而是作为 GitHub Release 附件发布。

发布前可以计算 SHA-256：

Get-FileHash -Algorithm SHA256 ".\dist\DSHControlTool.exe"

许可证

本项目代码使用 MIT License。项目名称、DeepSeek、DSH 以及其他第三方名称和商标归各自权利人所有。