Releases: xiangshangya/deepseek-harness-desktop
Releases · xiangshangya/deepseek-harness-desktop
Release list
V0.1.0
DeepSeek Harness Desktop v0.1.0 发行说明
发布日期:2026-08-14 | 安装包:DeepSeek Harness Desktop-0.1.0-setup.exe(约 118 MB) | Windows x64
简介
DeepSeek Harness Desktop 是把 DeepSeek Harness(dsh web 服务器 + 网页前端) 打包成桌面应用的一键式方案:
- 打开应用 = 自动启动服务器 + 打开前端窗口;
- 关闭应用 = 自动停止服务器、清理进程;
- 服务器、前端、运行时全部随安装包分发,目标机器无需安装 Node.js、无需任何配置。
功能特性
| 特性 | 说明 |
|---|---|
| 一键启动 | 启动即拉起 dsh web 服务器并打开界面,退出即清理 |
| 自带运行时 | 无系统 Node 时自动使用 Electron 内置 Node(v24)运行服务器,系统 Node 存在时优先使用 |
| 自动端口 | 默认自动分配空闲端口,避免冲突;可用环境变量 DSH_DESKTOP_PORT 固定端口 |
| 数据与 CLI 共用 | 会话、配置存放于 ~/.dsh,与命令行版完全一致,可无缝切换 |
| 快速启动 | 首次启动约 10–20 秒(解压服务器组件,界面实时显示进度),之后约 6 秒打开 |
| 官方图标 | 使用 DSH 官方鲸鱼标志 |
| 调试友好 | 支持 DSH_ROOT 指向源码目录运行改造后的代码;--smoke 冒烟测试 |
| 安全设计 | 渲染层 sandbox + contextIsolation,服务器仅监听 127.0.0.1 |
运行环境
- 系统:Windows 10 / 11,x64
- 无需预装 Node.js(可选:系统 Node ≥ 22.19 或 ≥ 24 会被优先使用)
- 磁盘空间:安装后约 500 MB
安装步骤
- 运行
DeepSeek Harness Desktop-0.1.0-setup.exe,按向导完成安装(可自选安装目录); - 从桌面快捷方式或开始菜单启动 DeepSeek Harness Desktop;
- 首次启动会显示"正在准备服务器组件(约 10–20 秒)…",完成后自动进入主界面。
如已安装旧版本,请先卸载再安装本版。
使用说明
- 主界面即 DeepSeek Harness 官方 Web UI:新建会话、选择工作区、模型设置、插件管理等;
- 服务器运行在本地随机端口(仅本机可访问),关闭应用即停止;
- 日志位置:
%APPDATA%\DeepSeek Harness Desktop\logs\dsh-server.log(含启动就绪行dsh web: http://127.0.0.1:<端口>)。
常见问题
1. 安装/首次运行出现 SmartScreen 提示?
安装包尚未进行代码签名,Windows 会提示"未知发布者"。点击"更多信息 → 仍要运行"即可;源码见下方仓库,可自行审计。
2. 杀毒软件误报?
Electron 打包应用偶有误报(尤其未签名版本)。如遇拦截,请选择"允许"并将问题反馈给我们。
3. 首次启动为什么比之后慢?
首次启动需将随包分发的服务器组件解压到用户目录(真实文件,保证 DSH 插件系统正常工作),约 10–20 秒;之后启动直接复用,约 6 秒。
4. 能自定义端口吗?
设置环境变量 DSH_DESKTOP_PORT=3080 等固定端口;不设置则自动分配。
5. 用命令行版还是桌面版?
数据完全互通(~/.dsh),可随时切换,互不影响。
已知限制
- 应用尚未代码签名(SmartScreen 提示属正常现象,计划后续接入);
- 仅提供 Windows x64 安装包,macOS / Linux 构建在规划中;
- 会话导出等下载类操作遵循系统默认下载设置。
相关链接
- 源码仓库:https://github.com/xiangshangya/deepseek-harness-desktop
- 上游项目:https://github.com/deepseek-ai/deepseek-harness (MIT License)
本应用为 DeepSeek Harness 的桌面封装,所有版权归各自所有者。
两点建议:① 如果对方是普通使用者,可以把"功能特性/常见问题"部分保留、"调试友好/DSH_ROOT"这类开发者内容精简掉;② 如果你希望把它做成正式的 GitHub Release(带下载链接和这个说明),我可以直接用你已有的令牌发布 v0.1.0 并把安装包传上去——需要的话说一声。