dsh-desktop
DiscoveredDeepSeek Harness 桌面版 (DSH Desktop)
一个基于 Electron 的 Windows 桌面应用，用于启动并承载 DeepSeek Harness 的完整 Web 界面（对话、插件、技能、工作流、子代理、设置等全部功能），并在窗口右下角实时显示 DeepSeek 账户余额。
💡 通用版：不含任何个人 API Key，开箱即用，配置你自己的 Key 即可。 💡 无需 Visual Studio / 任何 IDE：Node.js + Electron，命令行即可运行、测试、打包。 🧩 DeepSeek Harness 社区项目：本应用是 DeepSeek Harness（DSH）生态的桌面客户端，通过
dsh-plugin主题与官方社区关联。
✨ 功能特性
🖥️ 桌面集成
- 标准菜单栏：文件 / 编辑 / 视图 / 工具 / 帮助 五段式菜单，符合 Windows 桌面软件习惯
- 文件：新建会话（Ctrl+N）、刷新界面（Ctrl+R）、在浏览器打开、打开配置目录、退出
- 编辑：撤销 / 重做 / 剪切 / 复制 / 粘贴 / 全选
- 视图：重新加载（F5）、强制重载、缩放、全屏（F11）、开发者工具（F12）
- 工具：检查 dsh 更新、重启 dsh 服务、查看服务状态
- 帮助：官方文档、项目主页、反馈问题、关于
- 快捷键：Ctrl+N 新建会话、F5 刷新、F11 全屏、F12 开发者工具
🚀 自动启动前提
启动时自动完成，无需手动执行任何命令：
- 定位 dsh 命令（全局 npm / npx 缓存 / PATH）
- 未安装时自动
npm install -g @deepseek-ai/dsh - 自动启动
dsh web（带--no-open，界面由窗口承载而非跳浏览器） - 服务就绪后自动加载界面（含渲染检查与失败重试）
🔄 版本管理
- 菜单「工具 → 检查 dsh 更新」：对比本地与 npm 最新版本，一键升级 dsh
- 升级后提示重启服务以生效
💰 余额显示
- 右下角实时显示账户余额（30 秒刷新，点击手动刷新，悬停看明细）
🔌 DeepSeek Harness 0.1.5+ 适配
- 认证机制适配（关键）：0.1.5 起
dsh web需要认证，裸访问返回 401。本应用会捕获启动输出中的带 token URL 并用它加载界面（303 → cookie → 200），彻底解决黑屏 - 端口冲突自愈：若 3080 被无法认证的遗留服务占用，自动清理该 dsh web 进程并重启自己的服务
- 代理支持：传递
HTTP_PROXY/HTTPS_PROXY/ALL_PROXY/NO_PROXY环境变量（0.1.5 新增） - 兼容
--no-open官方参数（0.1.5 官方推荐用法） - 支持 0.1.5 新特性：DeepSeek-V41-Flash 模型、任意文件上传、右侧 Sidebar 预览
🩺 诊断工具
遇到启动问题时运行（输出环境、服务、认证、余额、代理状态）：
node scripts\doctor.js
📸 运行截图
⬇️ 下载安装
前往 Releases 页面 下载 DSH Desktop Setup 1.2.1.exe 安装程序（Windows 10/11，约 95 MB）。
或克隆源码自行构建：
git clone https://github.com/xuanyuying/dsh-desktop.git
cd dsh-desktop
npm install
npm start
功能特性
- 🚀 一键启动：自动检测
dsh web服务；未运行时自动拉起，已运行时直接复用（端口3080） - 🖥️ 完整 Harness 内容：窗口内嵌全部 Web UI，无任何功能裁剪
- 💰 右下角余额实时显示：每 30 秒自动刷新 DeepSeek 账户余额；点击手动刷新；悬停查看赠金/充值明细（与左下角"设置"按钮错开，互不遮挡）
- 🪟 桌面窗口体验：独立窗口、无地址栏、外链用系统浏览器打开
- 🧹 干净退出：由本应用启动的服务在退出时自动关闭，不影响外部已运行的服务
环境要求
| 依赖 | 版本 | 说明 |
|---|---|---|
| Node.js | ≥ 20 | 必装（含 npm） |
| DeepSeek Harness | ≥ 0.1.0-rc | 通过 npm install -g @deepseek-ai/dsh 安装；或由本应用自动发现 npx 缓存 |
| DeepSeek API Key | - | 见下方"API Key 配置" |
API Key 配置（通用版）
按优先级自动读取，任选其一：
-
环境变量
setx DEEPSEEK_API_KEY "sk-你的key" -
应用配置文件（推荐）
# 复制模板到用户目录并填入你的 Key copy config.example.json %USERPROFILE%\.dsh-desktop\config.json # 编辑 config.json，把 apiKey 改为 sk-你的key配置文件格式：
{ "apiKey": "sk-你的DeepSeek-API-Key" } -
兼容读取 Harness 凭据：若你已用
dsh且~/.dsh/.credentials.yaml中存在DEEPSEEK_API_KEY，自动复用。
API Key 获取：https://platform.deepseek.com → API Keys。
快速开始
方式一：直接启动（推荐）
双击项目目录下的 启动桌面端.bat。
首次运行自动安装 Electron 依赖并下载运行时（需联网，约 2~5 分钟），之后秒开。
方式二：命令行启动
cd dsh-desktop-desk
npm install # 首次
npm start
运行测试（无需 IDE）
node scripts\smoke-test.js # 冒烟测试：服务检测 + 余额 API
node scripts\test-lib.js # lib 模块：12 项断言
node scripts\test-preload.js # 浮层 UI：11 项断言
打包为安装程序
通用方式（默认走 GitHub，需要能访问 GitHub）
npm run dist
国内网络 / 无 GitHub 访问（推荐）
node scripts\build-dist.js
一键脚本自动完成（全程走 npmmirror 国内镜像、不访问 GitHub）：
- 从国内镜像下载 NSIS / winCodeSign / nsis-resources 构建工具
- 解压工具到本地缓存（幂等，二次打包秒过）
- 自动 patch electron-builder 适配受限环境
- 使用本地已解压的 Electron（
electronDist），全程离线 - 产出
dist\DSH Desktop Setup 1.2.1.exe
项目结构
dsh-desktop-desk/
├── src/
│ ├── main.js # 主进程：Electron 集成（窗口、IPC、菜单、生命周期）
│ ├── menu.js # 应用菜单栏（文件/编辑/视图/工具/帮助）
│ ├── preload.js # 预加载：右下角余额浮层 UI + IPC 桥
│ └── lib/
│ ├── harness.js # Harness 服务检测/启动/停止 + 版本检测升级（纯 Node）
│ └── balance.js # DeepSeek 余额 API 查询（纯 Node 模块，通用 Key 解析）
├── scripts/
│ ├── build-dist.js # 一键打包（国内镜像 / 离线）
│ ├── prepare-builder-cache.js # 构建工具缓存准备
│ ├── download-builder-tools.js # 构建工具下载（npmmirror）
│ ├── smoke-test.js / test-lib.js / test-preload.js / test-menu.js # 测试
│ └── gen-ico.js / download-electron.js / extract-electron.js / patch-builder.js
├── build/ # 应用图标
├── config.example.json # API Key 配置模板（通用）
├── package.json
├── 启动桌面端.bat # 一键启动脚本
└── README.md
常见问题
Q: 启动时报"未找到 dsh 命令"？
A: 执行 npm install -g @deepseek-ai/dsh，或确认 dsh 在 PATH / npx 缓存中。
Q: 余额显示"不可用"？
A: 检查 API Key 配置（环境变量或 ~/.dsh-desktop/config.json），以及网络能否访问 api.deepseek.com。
Q: 关闭窗口后 dsh 服务还在运行？
A: 若服务由本应用启动，退出时自动关闭；若外部启动（如命令行 dsh web），本应用不接管其生命周期。
Q: 如何修改端口？
A: 编辑 src/lib/harness.js 的 HARNESS_PORT（默认 3080），或设置环境变量 DSH_DESKTOP_PORT。
Comments
Loading…