桌面控制台 ScottLiu2512/dsh-desktop

DSH Desktop

DeepSeek Harness（DSH）桌面客户端（Windows）。把 DSH 的 Web 界面包装成原生桌面应用：一键启动/停止 dsh web，内嵌浏览器加载其完整界面，并提供图形化的模型/API 配置与日志查看，让你像用普通软件一样使用 DeepSeek Harness。

说明：本应用是 DeepSeek Harness 的客户端外壳，不包含 Harness 本体，运行前需要先安装 Node.js 和 dsh。

当前版本：v1.1.1 ｜ Releases

功能特性

- 一键启动/停止 dsh：后台拉起 dsh web，自动解析访问地址并加载
- 内嵌浏览器：直接使用 DSH 自带的完整 Web UI（多会话、历史记录、流式输出、工具调用与审批等）
- 图形化配置：API Key、模型、推理强度、工作区目录、端口，无需手改配置文件
- 日志面板 + 状态栏：实时查看 dsh 进程输出，便于排查问题
- 会话清理：按当前工作区列出 dsh 的历史会话（大小、创建时间、是否有真实对话内容），可一键选中所有空会话并删除
- 环境管家：维护面板把 dsh 的日常运维收进界面——环境概览（可一键复制用于反馈问题）、命令描述汉化一键打/还原、插件状态诊断与修复、dsh 本体升级、升级残留清理
- 升级 dsh 时自动绕开 npm 的 latest 降级陷阱：latest 标签有时比已装版本还旧（例如 latest 指向 0.1.5-rc.2，实际最新是 0.1.6-alpha.2），直接 npm install 会降级。这里按语义化版本号取真正最新的那个，并显式带上版本号安装
- 升级前自动停止 dsh，避免旧版原生模块被占用而产生清理不掉的残留目录

界面预览

DSH Desktop 运行截图

环境要求

- Windows 10 及以上
- Node.js 22 或更高版本
- DeepSeek Harness（dsh）

安装

方式一：安装包（推荐）

1. 前往 Releases 页面 下载 DSH-Desktop-Setup.exe
2. 双击安装（需要管理员权限，会弹出 UAC 确认），默认安装到 Program Files\DSH-Desktop，自动创建开始菜单快捷方式，安装向导中可选创建桌面快捷方式
3. 安装完成后会检测 Node.js 和 dsh，缺失会弹出提示

方式二：免安装版

在 Releases 页面 下载 DSH-Desktop.exe，双击即可运行，无需安装。

单文件版每次启动都要把全部依赖解压到临时目录，启动明显更慢（实测约 8 秒 vs 安装版约 2 秒），装了安全软件的机器还可能因此反复触发扫描。长期使用建议用安装包。

方式三：从源码运行

git clone https://github.com/ScottLiu2512/dsh-desktop.git
cd dsh-desktop
pip install -r requirements.txt
python main.py

依赖：Python 3.10+、PySide6、PyYAML、zstandard（见 requirements.txt）。

若启动时报 No module named 'PySide6.QtWebEngineWidgets'，说明 PySide6 只装到了基础部分——6.x 起 QtWebEngine 被拆到了单独的 Addons 包，补一句 pip install PySide6-Addons 即可。

使用

1. 打开后点左上角「设置」，填入 DeepSeek API Key（也可配置模型、推理强度、工作区目录和端口）
2. 点「启动 dsh」，等待状态栏显示运行地址，内嵌浏览器会加载出 DeepSeek Harness 界面
3. 后续操作（选择工作区、发送任务、审批工具调用等）都在界面内完成

打包（可选）

两种产物共用同一份源码，取舍见 build_common.py 里的说明。

安装打包依赖（PyInstaller）
pip install pyinstaller

目录版 → dist\DSH-Desktop\（安装包用，启动快、不占临时目录）
python -m PyInstaller dsh_gui_onedir.spec --noconfirm --clean

单文件版 → dist\DSH-Desktop.exe（免安装绿色版）
python -m PyInstaller dsh_gui.spec --noconfirm

生成安装包（需先安装 Inno Setup 6；依赖上面的目录版产物） ISCC.exe dsh_client_setup.iss

联系方式

- 作者：梧井流曦
- 邮箱：744508955@qq.com

欢迎交流，共同研究。使用中遇到问题请在 GitHub Issues 反馈。