以 DeepSeek Harness（dsh）为内核的 Windows 桌面版 AI 编程助手。
- 双击即用，不需要装 Node.js、不需要懂命令行；
- 自带完整内核（
node+dsh），拷到别的电脑也能跑。
- 打开下载页面：
https://github.com/EasyTZ/Deepseek-Harness-Desktop/releases - 找到最新版本（数字最大的那个），下载下面两个文件里任意一个：
| 文件 | 选它的理由 |
|---|---|
DeepSeek-Harness-Desktop-Setup-x.x.x.exe |
安装包：装完有桌面图标，新手选这个 |
DeepSeek-Harness-Desktop-Portable-x.x.x.zip |
绿色版：不用安装，解压即用，适合放 U 盘 |
- 如果你下的是安装包：双击那个
.exe，一路点「下一步」→「完成」。桌面会出现图标。 - 如果你下的是绿色版：右键那个
.zip→「全部解压」，打开解压出来的文件夹。
- 双击「DeepSeek Harness Desktop」图标（桌面的，或绿色版文件夹里的
DeepSeek Harness Desktop.exe）。 - 会先弹出一个启动加载窗口（DeepSeek logo + 加载动画），几秒后自动进入主界面；这是正常的，说明程序正在后台启动本地服务。
- 点窗口左下角的「设置」按钮（齿轮图标）；
- 找到「模型」（或 Models）那一页；
- 填入你的 DeepSeek API Key（形如
sk-xxxx，去platform.deepseek.com申请）； - 保存。
没配 Key 也能打开窗口看界面，但发消息会失败，因为调用模型需要这个 Key。
- 关闭窗口 ≠ 退出：点右上角 ✕ 只是缩到右下角托盘，程序还在后台；右键托盘图标可「退出」。
- 快捷键：按
Ctrl + Alt + Space随时唤出 / 隐藏窗口。 - 看余额：每次对话结束后，AI 回复正下方会显示你 DeepSeek 账户的余额。
- 系统通知：窗口在后台时，任务跑完 / 需要你确认会弹通知，点通知回到窗口。
- 窗口关了找不到了？ → 看屏幕右下角托盘图标，点它。
- 余额显示「查询失败」？ → 没配 API Key，回「设置 → 模型」填。
- 双击没反应 / 报毒？ → 本程序没做代码签名，Windows 可能弹「未知发布者」，点「仍要运行」即可。
- 无边框窗口 + 自定义标题栏（DeepSeek 鲸鱼 logo）
- 系统托盘、单实例、全局快捷键
- 会话、文件、终端、搜索、子代理等完整 dsh 能力
- 余额查询（每次对话后显示账户余额）
- 系统通知（任务完成 / 待确认）
- 浅色 / 深色 / 跟随系统主题
启动体验与打包优化：
- 启动闪屏（加载动画）：双击图标后立即弹出带 DeepSeek logo 与加载动画的窗口，避免「点了没反应」的误解，主界面就绪后自动进入。
- 启动加速：闪屏先行、内核并行启动，并跳过每次启动对开始菜单快捷方式的冗余重写。
- 打包复用本地 Electron：electron-builder 直接使用本机已安装的 Electron，打包不再联网下载。
修复系统通知完全失效的问题：
- 事件流改用 WebSocket：内核的
/api/events.mux只提供 WebSocket 下行通道（普通 HTTP GET 返回 426，无 SSE 回退），原先用 HTTP 拉取导致永远收不到事件，「任务完成 / 待确认」通知从未真正触发。 - 新增任务栏闪烁：任务完成且窗口失焦时，除系统通知外还会闪烁任务栏图标；窗口重新获得焦点后自动熄灭。
- 绿色版通知补丁：首次启动自动补建开始菜单快捷方式（Windows 显示 toast 通知的前置条件），修复绿色版 / win-unpacked 下通知被系统静默丢弃的问题。
- 无边框窗口 + 自定义标题栏（DeepSeek 鲸鱼 logo，圆角可爱化样式）
- 窗口控制按钮：最小化 / 最大化（含还原状态图标切换）/ 关闭，柔和配色
- DeepSeek 官方鲸鱼图标（应用图标 + 系统托盘图标）
- 放大开始菜单 / 任务栏 / 托盘图标：裁掉 logo 透明留白，鲸鱼填满图标画布
- 应用更名：DeepSeek Harness Desktop
- 系统托盘、单实例、全局快捷键（
Ctrl + Alt + Space） - 自包含内核：内置 node + 完整 dsh 依赖树，无需预装 Node/dsh
- 余额查询插件：每次对话后在回复下方显示 DeepSeek 账户余额
- 系统通知：任务完成 / 待确认时后台弹系统通知（窗口失焦时）
- 打包：NSIS 安装包 + zip 绿色版
仅开发者需要，普通用户跳过。
- 安装 Node.js ≥ 22（自带 npm）；
- 全局安装 DeepSeek Harness（开发态要用到本机 dsh）：
npm install -g @deepseek-ai/dsh国内网络下载慢，可先设镜像再装依赖：
$env:ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/" $env:ELECTRON_BUILDER_BINARIES_MIRROR="https://npmmirror.com/mirrors/electron-builder-binaries/"
npm install # 装依赖（首次会下 Electron）
npm start # 开发态运行（用本机 dsh）应用图标（
build/icon.png、build/icon.ico）已随仓库提交，无需每次生成；只有改了build/logo.svg才需要运行npm run icon重新生成。
npm run install-plugin # 先把余额插件装进开发态 dsh（一次性）
npm run dist # 产出安装包 + 绿色版到 release/产物：
release/DeepSeek-Harness-Desktop-Setup-x.x.x.exe（安装包）和DeepSeek-Harness-Desktop-Portable-x.x.x.zip（绿色版）。
Electron 外壳 + 自包含 dsh 内核：外壳 spawn 内置的 node.exe .../dsh/lib/bin.js web，就绪后加载本地回环地址。自定义插件放在 plugins/，通过 install-plugin 装进 dsh。