DeepSeek Harness Desktop

以 DeepSeek Harness（下称 dsh）为内核的 Windows 桌面版 AI 编程助手。双击即用，不需要装 Node.js、不需要懂命令行。

_{浅色主题：}

⬇️ 下载最新版

✨ 亮点

• 零配置，开箱即用 —— 自带完整运行环境（node + dsh），装好就能聊，拷到别的电脑也照样跑。
• 内核独立热更新 —— dsh 上游发了新版，在客户端里一键升级即可，不用等桌面版发版。更新前会真实启动自检，失败自动回滚，不会把能用的装成不能用的。
• 常驻后台，随叫随到 —— 关窗口自动缩进托盘，Ctrl + Alt + Space 全局唤出。
• 跑完主动提醒 —— 窗口在后台时，任务完成或需要你确认会弹系统通知并闪烁任务栏，不用守着屏幕。
• 随手看余额 —— 每次 AI 回复下方直接显示 DeepSeek 账户余额，不用切到网页查。
• Git 面板 + 终端，都在侧边栏 —— 改了哪些文件、暂存、提交、推送、切分支，点几下就完事；终端能在当前工作区敲命令、看实时输出、Tab 补全路径与命令名。
• 完整 dsh 能力 —— 会话、文件、终端、搜索、子代理，一个不少。
• 原生桌面观感 —— 无边框窗口 + 自定义标题栏，浅色 / 深色 / 跟随系统主题。

📥 下载与安装

到 Releases 页面下载任选一个：

本程序没有做代码签名，Windows 可能提示「未知发布者」或被杀软拦一下，选择「仍要运行 / 允许」即可。

🚀 开始使用

第一次启动：双击图标后会先出现启动窗口（logo + 加载动画），几秒后自动进入主界面 —— 这是程序在后台拉起本地服务，属正常现象。

填 API Key（必做）：点左下角齿轮 → 打开「模型」→ 填入 DeepSeek API Key（形如 sk-xxxx，在 platform.deepseek.com 申请）→ 保存。不填也能打开界面，但一发消息就会失败。

日常使用：

🔄 内核更新

「内核」就是真正干活的 dsh 本体，它和桌面版分开升级 —— 桌面版没发新版，内核也能保持最新。

• 自动检查：每天后台检查一次，有新版会弹出更新窗口；也可右键托盘 →「检查内核更新」手动查。
• 更新流程：点「立即更新」→ 等进度走完 → 点「立即重启」生效（选「稍后」也行，下次启动自动用新版）。
• 下载源：默认国内镜像 registry.npmmirror.com，更新窗口底部可切换到官方源。
• 不会更新坏：新内核先通过真实启动自检才会启用，异常时自动回退到自带内核，不影响使用。

❓ 常见问题

💬 反馈与交流

用着有问题、有想要的功能，欢迎随时提 —— 这个项目就是靠反馈改进的。

• 报 bug / 提需求：提交 Issue，客户端托盘菜单里的「反馈问题」可直接跳转。

• QQ 群：群号 263261649

  

📝 更新日志

最新版 v1.3.2 —— 绿色版解压从三分多钟降到 5 秒（内核在包里改成单个文件，首次启动时自动展开，约 8 秒）；Git 面板按反馈改版：提交与推送拆成两个独立按钮、提交框移到分支下方、每条提交标出已推送 / 未推送、分支下拉放大、变更列表可折叠。

v1.3.1 —— 修复部分机器上「dsh 内核启动失败」（端口被系统保留区间占用，Hyper-V / WSL2 / Docker 会动态预留大段端口）；安装包与绿色版体积各减约 30 MB，绿色版少了 1.4 万个文件，解压明显更快。

v1.3.0 —— 侧边栏新增 Git 面板（改动文件、暂存、提交、推送、切分支、撤销最新提交）与 终端面板（当前工作区执行命令、实时输出、多标签、Tab 补全、Ctrl+C 终止）；会话标题栏新增「在资源管理器中打开」；标题栏收窄并修掉与侧边栏交界处的色差。

完整历史见 Releases。

🧑‍💻 开发

仅开发者需要，普通用户跳过。架构设计、插件契约与踩坑记录详见 CLAUDE.md。

前置条件：Node.js ≥ 22，并全局安装 dsh 与 pnpm：

npm install -g @deepseek-ai/dsh
npm install -g pnpm

国内网络下载 Electron 慢，可先设镜像：

$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                # 开发态运行（外壳 spawn 本机全局 dsh）
npm test                 # 单元测试（node:test，零第三方依赖）
npm run typecheck        # tsc --checkJs 静态检查（无编译产物）
npm run dist             # 打包 → 产物收进 release/
npm run dist:dir         # 只出 win-unpacked，快速验证打包态

npm run dist 会自动依次执行 install-plugin → prepare-kernel → 打包，产物落在 release/。

架构：Electron 外壳 + 自包含 dsh 内核。外壳不渲染任何业务 UI —— spawn 内核后轮询 HTTP 就绪，再让 BrowserWindow 加载本地回环地址；所有会话 / 文件 / 终端能力都来自 dsh 自身的 web 应用，外壳只负责窗口、标题栏、托盘、快捷键、通知与内核更新。

src/main/     Electron 主进程
src/preload/  预加载脚本（注入标题栏 / 暴露 updater 接口）
src/shared/   纯 Node 模块，主进程与构建脚本共用，也是单测落点
scripts/      构建期 CLI（ESM）
plugins/      自定义 dsh 插件源码 + 清单

本项目没有编译步骤，src/ 直接打进 asar —— 这是打包设计的承重墙。

License

MIT