deepseek-harness-kit

一个基于 Tauri 2 的 Windows 桌面应用：一键部署并运行 DeepSeek Harness（GitCode 镜像仓库）， 免去手动装环境、克隆、安装依赖、构建的繁琐步骤。

界面效果图

启动与环境检测

一键部署 / 启动时自动检测 Node.js 与 dsh 运行时，版本不符或缺失时自动下载便携版 Node，日志实时滚动：

服务就绪后，主界面左侧为控制台，中间直接内嵌 DeepSeek Harness Web UI：

技能广场与技能调用

技能广场：浏览 / 搜索技能广场（skillhub.cn 数据源），一键安装技能与专家：

在 Harness 对话中输入 / 呼出技能候选菜单，选择已安装技能后技能指令自动注入对话：

插件市场与内置插件

插件市场：「本地插件 / 在线搜索 / 外部内置插件」三个 Tab，可启停内置插件、从 GitHub / npm 搜索安装新插件：

文件列表插件：侧边栏工作区改「会话 / 文件」双 Tab，文件 Tab 以文件树浏览当前会话工作区，点击文件后中间变为「对话 | 文件A | 文件B …」多 Tab 编辑（代码高亮、JSON / MD / HTML 预览、图片视频等）：

主题换肤

主题换肤：覆盖品牌色 / 底色 / 边框 / 文字等令牌色，并支持背景图（含 GIF / APNG / 动态 WebP）与背景视频（MP4 / WebM / OGG）：

背景图效果，以及动态背景图的实际演示：

功能

• 侧边栏单一入口：点击侧边栏菜单在「控制台」与「Harness 页面」之间切换。
• 一键部署：自动完成
  1. Node.js 检测（系统 Node 需 ^22.19 || >=24，不满足或缺失时自动下载便携版 Node）；
  2. 通过 npx --yes @deepseek-ai/dsh web --help 获取官方发布的 DeepSeek Harness 运行时（预编译 npm 包，无需克隆源码、无需 pnpm、无需构建）；
  3. （可选）自动启动服务。
• 一键启动 / 一键停止：后台运行 npx --yes @deepseek-ai/dsh web --port <设置端口>，等待端口就绪；停止时结束整棵进程树。
• 内嵌页面：服务运行中时，中间面板直接内嵌 DeepSeek Harness 的 Web UI；若系统已部署且正在运行，打开应用即直接进入页面。
• 运行日志实时滚动显示；设置可配置镜像源（默认 npmmirror）、端口（会传递给 dsh web --port）、退出是否停止服务等。

目录结构

├── index.html              # 前端入口
├── src/                    # 前端（原生 JS + Vite）
│   ├── main.js
│   └── styles.css
├── src-tauri/              # Tauri / Rust 后端
│   ├── src/
│   │   ├── main.rs         # 入口
│   │   ├── lib.rs          # 应用装配、退出清理
│   │   ├── commands.rs     # Tauri 命令（get_status / deploy / start / stop …）
│   │   ├── deploy.rs       # 一键部署编排（Node + npx 运行时）
│   │   ├── service.rs      # 服务启停、端口探测
│   │   ├── process.rs      # 进程执行、日志流
│   │   ├── download.rs     # 下载与解压
│   │   └── state.rs        # 设置、路径、运行时检测
│   ├── tauri.conf.json
│   └── icons/              # 应用图标（scripts/gen-icons.ps1 生成）
└── scripts/gen-icons.ps1

本地开发

前置：Node.js ≥ 18（构建打包需要 Rust MSVC 工具链）、Windows 10/11（自带 WebView2）。

项目已内置 .npmrc（registry 指向 npmmirror），并同时提供 package-lock.json 与 pnpm-lock.yaml， npm 或 pnpm 均可直接安装：

npm install        # 或 pnpm install
npm run tauri dev  # 开发模式
npm run tauri build  # 打包：Windows 输出 NSIS（bundle/nsis/）；Linux 输出 deb（bundle/deb/，麒麟/UOS/Ubuntu 可装）；macOS 输出 dmg（bundle/dmg/）

内置离线运行时（可选，推荐发布前执行）

正式安装包可把 Node 便携包 + @deepseek-ai/dsh 完整依赖树 打进应用资源（src-tauri/resources/runtime/）， 用户一键部署时本地解压、全程无需联网，彻底规避弱网/代理环境下载报错：

npm run prepare-runtime       # 产物已存在会跳过；加 --force 强制重新生成

• 发布前由 publish-release.ps1 -Build 与 CI（release.yml）自动执行；跳过该步骤也能打包， 只是安装包退回「部署时在线下载」模式。
• 产物不入库（.gitignore），安装包体积约增加 100MB（Node ~34MB + 依赖树压缩包）。
• 「重新部署」按钮仍为在线强制 @latest，用于把运行时升级到比内置更新的版本。

部署流程说明

• 数据目录：%LOCALAPPDATA%\DSHDesktop\
  • node/ — 便携版 Node.js
  • runtime/ — dsh 运行时（内置资源解压 / npm 安装落点，优先于 npx 缓存）
  • downloads/ — 下载缓存
  • settings.json — 应用设置
  • dsh.installed / dsh.version — 部署标记
• 运行时来源（按优先级）：
  1. 已就绪的本地运行时（runtime/node_modules/@deepseek-ai/dsh，部署幂等离线）；
  2. 随包内置资源 dsh-runtime.zip 离线解压（推荐，免联网）；
  3. npm 在线安装兜底（npm install --prefix，弱网自动重试；旧版本的 npx 缓存仍可直接启动）。
• 服务地址：http://127.0.0.1:<设置端口>（默认 3080，可在设置中修改并传递给 --port）
• 二进制下载源：npmmirror（registry.npmmirror.com/-/binary），Node 失败时回退 nodejs.org， 下载带 3 次重试与完整性校验。

注意事项

• 未内置运行时的安装包，部署首次耗时较长（下载 ~75MB 工具 + 安装数百个 npm 包），请耐心等待日志完成。
• 首次进入 Harness 页面后，需在页面内完成模型 API Key 等配置（与直接使用 DeepSeek Harness 相同）。
• 应用退出时默认自动停止服务（可在设置中关闭，以便服务保持后台运行）。

更新与发布

• 侧边栏底部「检查更新」按钮：通过 GitHub Releases（AlwaysSum/deepseek-harness-kit）检测新版本， 发现新版本后可直接下载安装包并运行安装程序；自动使用系统代理（FlClash 等）与国内加速镜像。
• 发布新版本（两种方式任选）：
  • 本地脚本（推荐）：scripts/publish-release.ps1，token 放环境变量，一键打 tag + 发布到 GitHub 与 GitCode：

    $env:GITHUB_TOKEN = "github_pat_xxx"     # 可选，缺省则跳过 GitHub
    $env:GITCODE_TOKEN = "xxx"               # 可选，缺省则跳过 GitCode
    .\scripts\publish-release.ps1 -Build -TagAndPush
    # 常用参数：-Version 0.2.0（默认读 tauri.conf.json）/-SkipGitHub /-SkipGitCode /-Proxy http://127.0.0.1:7890
    

  • GitHub Actions 自动发布：打 tag v0.1.0 后自动构建 Windows（NSIS）、Linux（deb，麒麟 / UOS / Ubuntu 可装）与 macOS（dmg，Apple Silicon，未签名）安装包并发布到 GitHub；若在仓库 Settings -> Secrets 配置了 GITCODE_TOKEN，则同步发布到 GitCode。
• 版本号三处保持一致：package.json、src-tauri/Cargo.toml、src-tauri/tauri.conf.json。

国内网络构建提示（仅对源码构建者）

• crates.io 直连较慢：建议在 %USERPROFILE%\.cargo\config.toml 配置 rsproxy 稀疏镜像 （sparse+https://rsproxy.cn/index/）。
• Tauri 打包 NSIS 时会从 GitHub 下载 NSIS 工具链，国内会超时；可提前将 nsis-3.11.zip 与 nsis_tauri_utils.dll 放入 %LOCALAPPDATA%\tauri\NSIS\（SHA1 校验， 需保持官方文件一致），打包器检测到文件齐全后会自动跳过下载。
• 仓库依赖全部来自 npm registry（无 GitHub 依赖），部署时使用 npmmirror 镜像即可。

技术栈

相关链接

• 上游项目：DeepSeek Harness — GitHub / GitCode 镜像
• 本仓库发布页：GitHub Releases / GitCode Releases
• Star 趋势图：star-history.com

Star History