chenxinj08-lgtm/deepseek-harness-desktop ↗★ 2

deepseek-harness-desktop

DeepSeek Harness 桌面版 —— 内置官方 dsh 运行时与本地文件/视觉插件的自包含 Electron 桌面壳(macOS / Windows) 核心用途是将 DeepSeek Harness 转化为开箱即用的本地桌面应用。适合不希望依赖系统 Node 环境、注重数据本地化隐私,且需要拖拽上传文件和图片视觉检查功能的用户。

Package
deepseek-harness-desktop
Compatibility
Unverified
Version
0.2.5
License
MIT
Last updated
Aug 15, 2026

Other repositories with this package name

Install

This plugin has no verified bundle, or compatibility checks failed. Read the repository notes first. Read the full README ↗

DeepSeek Harness 桌面版(deepseek-harness-desktop)

自包含的 Electron 桌面壳:内置官方 dsh 运行时(@deepseek-ai/dsh)与本地文件 / 视觉插件, 把 DeepSeek Harness 变成一键启动的桌面应用。数据全部保存在本地,无遥测、无上传。

✨ 功能特性

  • 一键启动:内置 Node 运行时(Electron 二进制),不依赖系统 Node / npm
  • 本地文件附件:拖拽 / 粘贴上传本地文件与图片,图片主流大图预览(官方 local-files 插件)
  • 视觉检查:图片 eyes-only 视觉观察(官方 host-vision 插件)
  • 无缝启动过渡:品牌加载页渐隐 → 官方界面接管,无闪烁、无空档
  • 窗口状态记忆:窗口位置与大小自动恢复
  • 自更新(零上传):以官方 npm registry 为信号源,检测到新 dsh 版本后在应用内提示 → 下载 → 替换内置运行时 → 重启生效
  • 原生体验:右键菜单(撤销 / 剪切 / 复制 / 粘贴)、下载静默落盘、外链交给系统浏览器
  • 跨平台:macOS(Apple Silicon / Intel)与 Windows x64

📦 下载安装

在 GitHub Releases 下载:

平台文件
macOS(Apple Silicon)DeepSeek-Harness-arm64.dmg
macOS(Intel)DeepSeek-Harness-x64.dmg
Windows x64DeepSeek-Harness-win32-x64.zip

目前为未签名构建:

  • macOS:首次打开请在 Finder 中右键应用 → 「打开」
  • Windows:SmartScreen 提示时点击「更多信息 → 仍要运行」

🔧 从源码构建

前置:Node.js ≥ 18、npm;macOS 打包 dmg 需系统自带的 hdiutil。

npm install        # 安装 electron 与打包工具
npm run setup      # 安装官方 dsh 运行时到 vendor/,并装入内置插件包
npm start          # 开发启动

npm run pack:mac   # 打包 macOS arm64(Apple Silicon)
npm run pack:mac:x64
npm run pack:win   # 打包 Windows x64(建议在 Windows 或 CI 上执行)
npm run dmg:mac    # 生成 .dmg
npm run zip:win    # 生成 Windows .zip

Windows 交叉构建提示:Windows 原生依赖(sharp 等)需要在 Windows 环境重新执行 npm run setup 后打包;也可以直接用仓库自带的 GitHub Actions 工作流 双平台构建。

🔒 隐私与安全

  • 不收集任何统计,不发送遥测
  • API Key 只保存在本机用户目录(macOS:~/.dsh/settings.yaml、~/.dsh/.credentials.yaml;Windows:%USERPROFILE%\.dsh\...),权限 600
  • 会话、附件、本地文件全部保存在本机
  • 唯一的网络访问:启动后查询官方 npm registry 的 @deepseek-ai/dsh 最新版本(只取版本号,不上传任何数据)

🔄 更新机制

应用内置自更新器:静默查询 npm registry 官方 dsh 版本 → 与内置版本不同时右下角出现角标提示 → 点击「重启安装」下载并替换内置 vendor → 重启生效。更新只动官方 dsh 包,不碰用户数据与插件注册。

🗂 目录结构

main.js        Electron 主进程:服务生命周期 / 自更新 / 窗口管理 / 菜单
preload.js     预加载脚本(更新角标的下载安装 / 重启桥接)
vendor/        运行时目录(npm run setup 生成;extra/ 内置官方插件包)
scripts/       构建脚本(setup-vendor / make-dmg / zip-win / make-ico)
docs/          用户层插件注册模板(cordis.patch.yml.example)

⚖️ 免责声明

本项目是社区桌面壳,非 DeepSeek 官方产品。「DeepSeek Harness」为官方项目名称 (deepseek-ai/deepseek-harness,MIT 开源), 本壳仅对其做桌面化封装。内置运行时与插件版权归 DeepSeek 所有(MIT)。

📄 License

  • 壳代码(main.js / preload.js / scripts / docs):MIT,见 LICENSE
  • 内置运行时与插件(vendor/extra/*.tgz):DeepSeek 官方 deepseek-ai/deepseek-harness,MIT