Releases: EasyTZ/Deepseek-Harness-Desktop
Release list
v1.3.3
以 DeepSeek Harness（dsh）为内核的 Windows 桌面版 AI 编程助手。双击即用，不需要装 Node.js。
下载哪个
| 文件 | 选它的理由 |
|---|---|
DeepSeek-Harness-Desktop-Setup-1.3.3.exe |
安装包：装完有桌面图标，新手选这个 |
DeepSeek-Harness-Desktop-Portable-1.3.3.zip |
绿色版：解压即用，适合放 U 盘 |
本程序没有做代码签名，Windows 可能提示「未知发布者」，选择「仍要运行」即可。
首次使用需要在「设置 → 模型」里填 DeepSeek API Key，否则无法对话。
本次更新
上个版本改完 Git 面板后收到了一轮实际使用中的反馈，这版全是打磨。
🎨 深浅主题下的对比度
好几处控件在某个主题下会「和背景糊在一起」：推送按钮（深色下底色与面板同色、浅色下同样分不清）、终端的标签页（未选中时完全没有边界，选中态和悬浮态还共用同一个样式）、终端的停止按钮。
根子是同一个：这些控件原来用 dsh 的背景色 token 去跟面板底色做对比，而这些 token 的明暗关系在两个主题里是反的 —— 深色下能拉开的，浅色下就是同一个白。现在统一改成中性灰描边配色，对纯白和近黑都有对比，一个值在两个主题下都成立。
顺带修了推送按钮禁用时「看不出轮廓」的问题：描边按钮不能靠整体透明度表达禁用，那会把边框一起冲淡。
🌿 Git 面板
- 提交历史用颜色区分推送状态：已推送是绿色实心圆，未推送是黄色空心圆。虚实与颜色两条线索表达同一件事，不依赖辨色能力。
- 已推送的提交默认只显示 5 条，更早的收进「展开更早的 N 条」，展开有平滑动画。
- 变更文件列表默认展开（上版默认收起，实际用下来还是想先扫一眼改了什么），折叠能力保留并记住选择。
- 面板底部留出固定留白，展开长列表时内容不再顶到面板下沿；滚动时底部有渐隐，文字不会被齐刷刷切断。
🖥️ 终端
- 打开工作区时自动开一个对应的终端标签，不用再点 +。切换到别的工作区也会为它单独开一个 —— 判断依据是「当前工作区有没有对应标签」，而不是「有没有任何标签」，否则手上那个标签的路径还指着上一个项目。只有在还没打开任何工作区时，才会提示你先打开一个。
- 当前路径高亮显示，字号也调大了一点，深浅主题各用一个蓝色。
从 v1.3.x 升级
直接安装即可，会自动沿用原有会话与配置。
完整说明见 README
v1.3.2
以 DeepSeek Harness（dsh）为内核的 Windows 桌面版 AI 编程助手。双击即用，不需要装 Node.js。
下载哪个
| 文件 | 选它的理由 |
|---|---|
DeepSeek-Harness-Desktop-Setup-1.3.2.exe |
安装包：装完有桌面图标，新手选这个 |
DeepSeek-Harness-Desktop-Portable-1.3.2.zip |
绿色版：解压即用，适合放 U 盘 |
本程序没有做代码签名，Windows 可能提示「未知发布者」，选择「仍要运行」即可。
首次使用需要在「设置 → 模型」里填 DeepSeek API Key，否则无法对话。
本次更新
📦 绿色版解压从 3 分钟降到 5 秒
有用户反馈绿色版解压特别慢。查下来原因不是包大，而是文件太多：内核依赖树有一万五千多个小文件，而 Windows 资源管理器解压 zip 的耗时基本由文件个数决定（实测每个文件约 11.7ms 的固定开销）——同一份内容，资源管理器要 181 秒，换成别的解压方式只要十几秒。
现在内核在安装包里是一个文件，首次启动时由程序自己展开：
| v1.3.1 | v1.3.2 | |
|---|---|---|
| 绿色版解压（资源管理器） | 3 分钟以上 | 约 5 秒 |
| 包内文件数 | 16374 | 41 |
| 绿色版 | 209 MB | 207 MB |
| 安装包 | 153 MB | 150 MB |
代价是首次启动多等约 8 秒（展开内核，只发生一次，启动画面上有提示）。后续启动不受影响。
🌿 Git 面板按反馈改版
感谢 @kksucoder 在 #1 提的建议：
- 提交与推送拆成两个独立按钮。旧版是同一个按钮在两种动作之间自动切换——有未推送的提交时它会变成「推送」，想再提交还得先在输入框里打字把按钮换回来。现在两个按钮各就各位，想干哪件点哪件；推送按钮上直接显示待推送条数（
推送 ↑2）。 - 提交框移到分支选择下方，打开面板就能直接写信息提交，不用先滚过一长串变更文件。
- 每条提交标出推送状态：未推送的用橙色实心点标注，已推送的是灰色空心点，一眼分得清哪些还在本地。
- 分支下拉框放大，不再是那个几乎看不出可点的小控件。
- 变更文件列表可折叠，默认收起，点一下展开，并记住你的选择。
从 v1.3.x 升级
直接安装即可，会自动沿用原有会话与配置。
完整说明见 README
v1.3.1
以 DeepSeek Harness（dsh）为内核的 Windows 桌面版 AI 编程助手。双击即用，不需要装 Node.js。
v1.3.0 已下架：它有一个会导致部分机器无法启动的问题，请直接用本版本。已经装了 1.3.0 的直接覆盖安装即可，会话与配置不受影响。
下载哪个
| 文件 | 选它的理由 |
|---|---|
DeepSeek-Harness-Desktop-Setup-1.3.1.exe |
安装包：装完有桌面图标，新手选这个 |
DeepSeek-Harness-Desktop-Portable-1.3.1.zip |
绿色版：解压即用，适合放 U 盘 |
本程序没有做代码签名，Windows 可能提示「未知发布者」，选择「仍要运行」即可。
首次使用需要在「设置 → 模型」里填 DeepSeek API Key，否则无法对话。
本次修复
🔌 修复部分机器上「dsh 内核启动失败，无法进入主界面」
报错形如 listen EACCES: permission denied 127.0.0.1:53389。
原因是内核要用的本地端口落进了 Windows 的系统保留端口区间 —— Hyper-V / WSL2 / Docker 会动态预留大段端口（在一台反馈机器上实测有约 60 段、占动态端口范围的 37%，而且是按需分配、随时新增的）。旧版本由桌面端先探一个空闲端口、再把号码交给内核去绑定，这中间隔着几秒，端口可能正好在这段时间被系统划走。
现在改成由内核自己向系统申请端口，绑定发生在申请的同一刻，系统天然跳过保留区间，这个时间差不复存在。另外还加了两道兜底：绑定失败会自动换端口重试；端口问题不再被误判成「内核损坏」（旧版本会因此把热更新下载的内核当成坏件弃用，等于让你白白重下一次）。
如果仍然遇到启动失败，弹窗现在会直接说明原因与排查命令，而不是抛一串内部术语。
📦 安装包与绿色版都瘦了一圈
出厂内核里那些运行时用不到的文件（源码映射、类型声明、TypeScript 源码、调试符号、非本平台的原生预编译）以及用不到的 Electron 语言包都不再打包：
| v1.3.0 | v1.3.1 | |
|---|---|---|
| 安装包 | 185 MB | 约 157 MB |
| 绿色版 | 255 MB | 约 215 MB |
绿色版少了约 1.4 万个文件——zip 解压耗时主要由文件个数决定，所以解压会明显更快。
打包流程里新增了一道自检：出厂内核会被真实启动一次，并逐包核对入口文件是否齐全，不通过就不出包。
v1.3.0 带来的功能（本版同样包含）
- Git 面板：改动文件、暂存、提交、推送、切换分支、撤销最新提交
- 终端面板：当前工作区执行命令、实时输出、多标签、Tab 补全、Ctrl+C 终止
- 在资源管理器中打开：会话标题栏一键打开工作区目录
终端是命令控制台，不是完整的终端仿真器：需要交互输入的程序（
vim、sudo密码、npm init的问答）跑不了，面板里提供了「在系统终端中打开」作为出口。
完整说明见 README
v1.2.1
以 DeepSeek Harness（dsh）为内核的 Windows 桌面版 AI 编程助手。双击即用，不需要装 Node.js。
下载哪个
| 文件 | 选它的理由 |
|---|---|
DeepSeek-Harness-Desktop-Setup-1.2.1.exe |
安装包：装完有桌面图标，新手选这个 |
DeepSeek-Harness-Desktop-Portable-1.2.1.zip |
绿色版：解压即用，适合放 U 盘 |
本程序没有做代码签名，Windows 可能提示「未知发布者」，选择「仍要运行」即可。
首次使用需要在「设置 → 模型」里填 DeepSeek API Key，否则无法对话。
本次更新
- 标题栏改为透明悬浮层：不再用 padding 把整个页面往下推，而是叠在 dsh 页面自己的顶部留白上，界面顶部不再有一大块空白。
- 内核更新弹窗视觉优化：只有一个按钮时不再撑满整行；主按钮改为柔和的强调色调，浅色/深色主题分别取值，不再是焊死的一个蓝；副标题「dsh」改写成完整的 「DeepSeek Harness」。
- 新增 GitHub Issue 模板：报 bug / 提功能建议都有结构化表单，托盘菜单「反馈问题」直接跳转到模板选择页。
- 新增 QQ 交流群：群号
263261649，入口见 README。 npm run dist自动串联install-plugin：打包流程内部调整，不影响使用体验。
从 v1.2.0 升级
直接安装即可，会自动沿用原有会话与配置。
完整说明见 README
v1.2.0
以 DeepSeek Harness（dsh）为内核的 Windows 桌面版 AI 编程助手。双击即用，不需要装 Node.js。
下载哪个
| 文件 | 选它的理由 |
|---|---|
DeepSeek-Harness-Desktop-Setup-1.2.0.exe |
安装包：装完有桌面图标，新手选这个 |
DeepSeek-Harness-Desktop-Portable-1.2.0.zip |
绿色版：解压即用，适合放 U 盘 |
本程序没有做代码签名，Windows 可能提示「未知发布者」，选择「仍要运行」即可。
首次使用需要在「设置 → 模型」里填 DeepSeek API Key，否则无法对话。
本次更新
- 修复「装了新版客户端，内核还是旧的」：安装包不会动用户目录，此前本地热更新过的内核会一直优先于新版自带的内核，导致新版外壳跑在旧内核上。现在会比较两者版本，谁新用谁。
- 出厂内核升级到 dsh
0.1.1-rc.2（上一版为0.1.0-rc.7）。 - 插件改用 dsh 官方机制接入：不再改写内核自带的配置文件，改为启动时通过官方的
--patch参数传入。好处是内核升级后插件不会失效，也不会因内核目录结构变化而出问题。 - 内核更新自检更严格：升级后的可启动性校验现在连插件一起验，避免「验的时候没插件、真跑起来插件崩」。
- 修复内核异常回退时的长时间卡顿：内核启动失败需要回退时，旧做法是同步删掉整个内核目录（3 万多个文件），实测会让程序假死十几秒、期间加载窗口还会提前消失、屏幕空白数秒。现在改为瞬时弃用 + 后台清理，加载动画全程保留，整个回退过程约 4 秒，基本无感。
- 修复标题栏的一处性能问题：定位不到侧边栏时会一直监听页面变动、持续消耗性能，现已加超时保护。
从 v1.1.x 升级
直接安装即可，会自动沿用原有会话与配置。若此前用过内核热更新，首次启动可能会多花几秒自动切换内核，只发生一次。
完整说明见 README
v1.1.1
🐛 修复
- 启动黑屏卡死：余额插件
@deepseek-ai/dsh-ui-balance只被拷进 dsh 依赖树、未登记进package.json依赖清单，导致内核启动时模块解析失败（ERR_MODULE_NOT_FOUND）、进程秒退，外壳又未把崩溃反馈出来，闪屏永久挂起。修复：安装插件时同步写入依赖清单，并在内核就绪前退出时弹出「启动失败」错误框。
下载
| 文件 | 说明 |
|---|---|
DeepSeek-Harness-Desktop-Setup-1.1.1.exe |
安装包（新手推荐） |
DeepSeek-Harness-Desktop-Portable-1.1.1.zip |
绿色版（免安装，解压即用） |
v1.1.0
✨ 新增
- 启动闪屏：双击图标后立即弹出带 DeepSeek logo 与加载动画的窗口，内核后台并行启动、主界面就绪后自动进入，不再「点击后长时间无响应」。
⚡ 优化
- 打包复用本地 Electron：electron-builder 直接使用本机已安装的 Electron，打包不再联网下载。
下载
| 文件 | 说明 |
|---|---|
| DeepSeek-Harness-Desktop-Setup-1.1.0.exe | 安装包（新手推荐） |
| DeepSeek-Harness-Desktop-Portable-1.1.0.zip | 绿色版（免安装，解压即用） |
v1.0.1
🐛 修复：系统通知完全失效
此前任务在后台跑完后不会弹出任何提醒，根因是事件流通道用错了：内核的
/api/events.mux 只提供 WebSocket 下行通道（普通 HTTP 请求返回 426，无 SSE
回退），原先用 HTTP 拉取导致永远收不到事件，「任务完成 / 待确认」通知从未真正触发。
本次已改为 WebSocket 连接，通知恢复正常。
✨ 新增
- 任务栏闪烁提醒：任务完成且窗口失焦时，除系统通知外还会闪烁任务栏图标；窗口重新获得焦点后自动熄灭。
🔧 修复
- 绿色版通知补丁：首次启动自动补建开始菜单快捷方式（Windows 显示 toast 通知的前置条件），修复绿色版 / win-unpacked 下通知被系统静默丢弃的问题。
下载
| 文件 | 说明 |
|---|---|
DeepSeek-Harness-Desktop-Setup-1.0.1.exe |
安装包（新手推荐） |
DeepSeek-Harness-Desktop-Portable-1.0.1.zip |
绿色版（免安装，解压即用） |
v1.0.0
- 无边框窗口 + 自定义标题栏（DeepSeek 鲸鱼 logo，圆角可爱化样式）
- 窗口控制按钮：最小化 / 最大化（含还原状态图标切换）/ 关闭，柔和配色
- DeepSeek 官方鲸鱼图标（应用图标 + 系统托盘图标）
- 应用更名：DeepSeek Harness Desktop
- 系统托盘、单实例、全局快捷键（Ctrl + Alt + Space）
- 自包含内核：内置 node + 完整 dsh 依赖树，无需预装 Node/dsh
- 余额查询插件：每次对话后在回复下方显示 DeepSeek 账户余额
- 系统通知：任务完成 / 待确认时后台弹系统通知（窗口失焦时）
- 打包：NSIS 安装包 + zip 绿色版
v0.1.0
首个 Windows 桌面版，以 DeepSeek Harness（dsh）为内核。
下载
DeepSeek-Setup-0.1.0.exe—— 安装包（推荐）DeepSeek-Portable-0.1.0.zip—— 绿色版（解压即用）
特性
- Electron 外壳托管 dsh web，自包含 node + dsh 依赖树，目标机器无需预装 Node/dsh
- 单实例、系统托盘、全局快捷键（Ctrl+Alt+Space）、优雅退出
- 会话与 CLI/Web 版共享（~/.dsh）
Full Changelog: https://github.com/EasyTZ/Deepseek-Harness-Desktop/commits/v0.1.0