chyra-moon/deepseek-harness-desktop

DeepSeek Harness desktop shell: 1:1 replica of the official web UI as a Windows desktop app (community project)

项目介绍Project Overview

DeepSeek Harness 桌面版是 Windows 客户端,把官方网页前端打包成双击即用的桌面应用。它内置官方 dsh 服务器,断线 5 秒内自愈,外部已开服务会自动复用并共享会话;提供托盘驻留、窗口记忆、单实例、崩溃自启和原版鲸鱼动画。适用场景:想在 Windows 本地以桌面应用方式运行 DeepSeek Harness,又不想装 Node.js 或敲命令的用户。注意事项:仅 Windows x64,且为社区未签名应用,杀毒软件可能误报。

DeepSeek Harness Desktop is a Windows client that packages the official web frontend into a double-click desktop app. It bundles the official dsh server, auto-recovers within 5 seconds if the server dies, and reuses any running web or CLI instance to share session data. Features include a system tray, window memory, single-instance lock, crash auto-restart, and the original whale loading animation. Use it when you want to run DeepSeek Harness as a native Windows app without installing Node.js or typing commands. Note: Windows x64 only, and as an unsigned community build, antivirus software may flag it.

或使用命令行安装(适合开发者)Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add github:chyra-moon/deepseek-harness-desktop

chyra-moon/deepseek-harness-desktop 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

简体中文 | English

DeepSeek Harness 桌面版

GitHub Release License Platform

⚠️ 社区项目,非官方出品。DeepSeek Harness 本体、@deepseek-ai/* 软件包与官方前端版权归 deepseek-ai 及其贡献者所有。

DeepSeek Harness 官方网页版装进 Windows 桌面应用 —— 同一个界面、同一个服务器,双击即用

为什么选它

  • 🎯 零配置:不用装 Node.js、不用敲命令,装完双击就是官方界面(一比一加载官方前端,不是仿制皮肤)
  • 🐳 服务器内置:应用自己托管官方 dsh 服务器;你已开着网页版/CLI 时自动复用,会话数据互通
  • 🔄 断线自愈:外部服务器被关掉?应用 5 秒内自动接管重启,页面自动恢复,不会"界面还在但发不了消息"
  • 🖥 正经桌面体验:托盘驻留、窗口记忆、单实例、崩溃自动重启、无菜单栏纯净窗口
  • 🐋 鲸鱼加载动画:官方鲸鱼由蓝/白光点构成(肚皮、眼睛、水花三处细节一比一),呼吸式起伏

下载

版本 链接 说明
安装版(推荐) DeepSeek Harness-0.1.1-rc.2-x64.exe 桌面/开始菜单自动建快捷方式
解压版 DeepSeek Harness-0.1.1-rc.2-win32-x64.zip 解压即用,解压过程自带进度,最透明
免安装便携版 DeepSeek Harness-0.1.1-rc.2-portable-x64.exe 单文件,首次启动需后台解压数分钟(无进度提示)

桌面版版本号与官方 dsh 保持一致(当前内置官方 @deepseek-ai/dsh@0.1.1-rc.2)。链接使用精确版本路径;如需最新版,可在 Releases 页面 查看。

快捷键:Ctrl+Shift+I 开发者工具 · Ctrl+R 重载 · Ctrl+Shift+O 在浏览器打开。 关闭窗口会驻留托盘,托盘右键可退出或查看关于信息。

从源码运行

npm install && npm start      # 图标缺失时会自动生成,也可手动 npm run icon

其他常用命令:

npm run dist                      # 打包(安装版 + 解压版 + 便携版,并自动完整性校验)
npm run verify                    # 单独跑打包完整性校验
npm run update:dsh                # 一键升级官方 dsh 并重新出包
npm run preview -- --open         # 浏览器实时预览加载动画

官方 dsh 发新版后,Dependabot 会自动开升级 PR(CI 自动跑 Windows 冒烟),合并后跑一条 npm run update:dsh 即可出新安装包。

常见问题

  • 杀毒软件报毒:社区未签名应用的常见误报;源码全部公开,可自行审计或从源码构建
  • 不想关窗口驻留托盘:在应用数据目录的 settings.json 里设置 "closeToTray": false
  • 工作区选择器打不开(远程桌面环境):settings.json 里设置 "directoryPicker": "browse" 改用应用内浏览选择器("native" 为 Windows 原生对话框,默认值)
  • 中文路径添加工作区失败:官方 0.1.1 系列原生目录选择器存在 UTF-16 截断 bug(已在上游讨论区报告),桌面版已在打包时自动修复(无需用户操作);若仍失败请反馈具体报错
  • 想用最新官方版:跑官方最新的 npx @deepseek-ai/dsh web,桌面版会自动复用

许可

本项目以 MIT 协议开源。

上一个 Prev dsh-deepseek-usage 下一个 Next dsh-chat-imagine