一键部署面板 NafixWang/DSH_launcher

DSH Launcher — DeepSeek Harness 一键部署与控制面板

开发者：NafixWang ｜ 联系邮箱：NafixWang@QQ.com 开源协议：CC BY-NC 4.0（署名-非商业性使用）——禁止倒卖，倒卖必究。

面向国内 Windows 10 / 11（64 位）用户的 DeepSeek Harness（dsh）开箱即用工具：双击安装包 → 点「开始部署」→ 点「启动 DSH」→ 浏览器里开用。
全程免管理员权限，下载全部走国内镜像（npmmirror）。

DeepSeek Harness 是 DeepSeek AI 的开源 Agent 工程框架（MIT 协议）。
本仓库是它的 Windows 桌面部署与管理工具，与其官方无隶属关系。

目录结构

DSHLauncher/
├── main.py # 启动器入口 ├── app/ # 程序源码 │ ├── main.py # 参数解析 / 自检 / 端到端测试 / GUI 入口 │ ├── gui.py # Tkinter 图形界面（控制面板/部署/日志/设置） │ ├── deployer.py # 一键部署引擎（Node 检测下载、dsh 安装校验） │ ├── service.py # dsh 服务启停、健康探测、日志收集 │ ├── config.py # 路径与配置管理 │ └── netutil.py # 镜像下载、版本解析、端口探测 ├── assets/ # 图标资源（鲸鱼娘，多尺寸） ├── build/ │ ├── installer.iss # Inno Setup 6 安装包脚本 │ └── version.txt # exe 版本信息资源 └── tools/ # 构建与图标处理脚本 ├── build_all.bat # 一键重构建（PyInstaller + Inno Setup） ├── make_icon_from_photo.py # 图标白底转透明 + 多尺寸生成 └── ...

功能

- 一键部署：自动检测系统 Node.js（需 ≥ 22.19），不满足则从 npmmirror 下载便携版 Node.js 22 LTS 并解压；随后用 npmmirror 镜像源全局安装 @deepseek-ai/dsh 并校验版本。
- 控制面板：启动 / 停止 DSH 服务、运行状态指示灯、一键打开 Web 控制台（默认 http://127.0.0.1:3080）、复制访问地址。
- 运行日志：实时查看 dsh 进程输出，日志落盘到 logs/。
- 设置：端口、npm 镜像源（npmmirror / 官方源）、Node 来源（自动 / 便携 / 系统）、自动打开浏览器、开机自启（含自动启动服务）。
- 维护：删除便携 Node、卸载 dsh（保留数据）、清除全部数据；「重新部署（修复）」可无损重装运行环境。

目录约定（目标机器）

| 内容 | 位置 |
| 程序本体 | %LOCALAPPDATA%\Programs\DSHLauncher\DSHLauncher.exe |
| 数据根目录 | %LOCALAPPDATA%\DSHLauncher\ |
| 便携 Node.js | 数据根目录\runtime\node\ |
| dsh 安装前缀 | 数据根目录\dsh-global\ |
| DSH_HOME | 数据根目录\dsh-home\ |
| 默认工作区 | 数据根目录\workspace\ |
| 日志 | 数据根目录\logs\ |

卸载程序只删除程序本体；运行环境与个人数据默认保留，可在「设置 → 维护」中清除。

兼容性说明

- 仅依赖 Windows 自带组件（程序为 PyInstaller 单文件 exe，零运行时依赖，不需要 .NET / WebView2 / 预装 Node.js）。
- 首次部署需要联网（Node 便携版约 34 MB + dsh 依赖约 450 个包）。
- 部署全程不需要管理员权限；服务只监听 127.0.0.1，不对外暴露。

从源码构建

tools\build_all.bat

产物：

- dist\DSHLauncher.exe —— 绿色单文件版
- installer\DSHLauncher-Setup-1.0.5.exe —— 一键安装包（Inno Setup 6）

调试命令

DSHLauncher.exe --selftest 引擎自检（平台/配置/Node/镜像解析/端口） DSHLauncher.exe --deploy-test 端到端测试（真实下载便携 Node、装 dsh、起停服务） DSHLauncher.exe --smoke-gui GUI 冒烟测试（1.5 秒后自动关闭） DSHLauncher.exe --with-service 启动面板并自动启动 DSH 服务（开机自启用）

图标

鲸鱼娘图标为本项目 AI 生成的原创图标（assets/icon_src.png），经 tools\make_icon.py 处理为多尺寸 app.ico。

开源协议与贡献

- 本项目采用 CC BY-NC 4.0（知识共享 署名-非商业性使用 4.0 国际许可协议）开源，详见 LICENSE。你可以自由复制、分发、修改，但必须署名（开发者：NafixWang）且不得用于售卖等商业目的，倒卖必究。
- 欢迎通过 Issue / Pull Request 反馈问题与改进；二次开发请在显著位置保留原作者署名。
- DeepSeek Harness 本体为 DeepSeek AI 的开源项目，遵循 MIT 协议。

参考

- 官网：https://www.deepseek.com/harness/
- 文档：https://deepseek-harness.github.io/deepseek-harness/guide/quickstart
- 仓库：https://github.com/deepseek-ai/deepseek-harness （MIT）