DeepSeek Harness 启动器

一个基于 Fluent-Install 架构（Python + PyQt6 + PyQt6-Fluent-Widgets）制作的 DeepSeek Harness（dsh）本地启动器。软件本身只作为控制台，提供 安装 dsh、 启动 dsh、关闭 dsh、在浏览器打开 和 检查版本 等功能；dsh 的界面 在浏览器中打开，不会重复显示在启动器窗口里。

⚠️ 本项目完全由 AI 根据本人需求生成，后续维护全看心情，不保证及时更新或修复。

截图

功能

• 一键启动本地 dsh web，并等待 Web UI 就绪
• 一键关闭 dsh，并清理整个进程树（避免残留 node 进程）
• 一键通过 npm install -g @deepseek-ai/dsh 全局安装 dsh，并实时显示日志
• 自动检测本地 dsh 版本与 npm 最新版本，旧版本时显示「更新」按钮
• 显示运行状态（未运行 / 启动中 / 运行中 / 关闭中）
• 日志框常驻主界面，实时显示安装 / 更新 / 版本检查日志
• 深色 / 浅色主题跟随系统，支持自定义主题色
• 可在浏览器中打开 dsh Web UI（只打开一个页面）
• 关闭窗口时自动停止 dsh

环境要求

• Windows 10/11
• Python 3.10+（推荐 3.12）
• 已安装并可用 dsh 命令（npx @deepseek-ai/dsh web 已配置好）
• 已安装 Node.js

快速开始

方式一：使用脚本

1. 双击 install.bat 安装依赖（或手动执行 pip install -r requirements.txt）
2. 双击 run.bat 启动

方式二：手动运行

pip install -r requirements.txt
python main.py

使用中国镜像安装依赖：

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt

项目结构

dsh UI/
├── main.py                  # 程序入口
├── requirements.txt         # Python 依赖
├── config/
│   └── config.json          # 主题与 dsh 地址/端口配置
├── app/
│   ├── __init__.py
│   └── fluent_app.py        # Fluent Design 控制台界面
├── backend/
│   ├── __init__.py
│   ├── dsh_manager.py       # dsh 进程启动/停止管理
│   ├── dsh_installer.py     # 通过 npm 全局安装 dsh
│   └── dsh_version.py       # 本地/最新版本检测与比较
├── assets/
│   └── icon.ico             # 应用图标
├── run.bat                  # 快速启动脚本
├── install.bat              # 依赖安装脚本
├── build_exe.py             # PyInstaller 打包脚本（可选）
└── README.md

配置

编辑 config/config.json：

{
  "theme_mode": "auto",
  "theme_color": "#0078d4",
  "dsh_host": "127.0.0.1",
  "dsh_port": 3080
}

theme_mode 可选 auto / light / dark。dsh_port 默认与 dsh web 的默认端口一致（3080）。

打包为 exe（可选）

pip install pyinstaller
python build_exe.py

生成文件位于 dist/DSHLauncher.exe。运行环境仍需已安装并可用的 dsh 与 npm 命令。

说明

• “启动 dsh”会调用系统中的 dsh web，默认监听 http://127.0.0.1:3080，但 不会在启动器窗口内嵌入该页面。
• “安装 dsh”会在后台执行 npm install -g @deepseek-ai/dsh，并在主界面显示 进度条和实时日志。
• “检查版本”会读取本地 dsh --version 和 npm 上的最新版本；如有新版本会显示 「更新」按钮，点击后复用 npm 全局安装流程完成更新。
• 程序启动时不会自动拉起 dsh，点击“启动 dsh”后才启动。
• 关闭窗口时会自动关闭由本启动器启动的 dsh 进程。