这是个什么东西？

deepseek-harness（简称 dsh）是deepseek 开源的 harness 框架，但它启动方式和更新主要靠命令行操作， deepseek-harness 还在开发前期没有稳定下来更新方式，更新特别麻烦； 装它要 npm 或 git 编译，启动要敲 dsh web --port 3080，管插件要 dsh plugin add ...， 日志还得去翻文件。

dsh-launcher 就是把这些事搬进一个启动器和提供桌面窗口：

• 🖱️ 点一下就能装 —— Node / Git / Python 运行环境缺什么补什么，dsh 本体支持 npm 与 GitHub 两条安装通道；
• 🔀 版本随意切、随意退 —— 版本管理面板把 npm 与 GitHub 两条通道的历史版本全列出来（最新置顶）， 想升就升、想退就退：点哪个版本就装哪个，比如从最新版一键退回到某个稳定版、或换一条通道再装。 不用记 npm i -g xxx@版本、不用自己 git clone --branch <tag> 再编译； 切版本/换通道也不会动 ~/.dsh 里的会话、技能与插件配置（详见下方「🔒」一节）。
• ▶️ 点一下就能跑 —— 启动 / 停止 / 重启 dsh web，状态实时显示，还能一键内嵌打开 Web GUI（自动带上免登录 token，不用手动复制那串地址）；
• 🧩 插件像 App 一样管 —— 装、卸、开着、关掉，改完 dsh 自己热重载，不用重启；
• ✨ 技能点点开关 —— 管理 ~/.agents/skills 下的技能，谁能被模型调用一目了然，还能从 GitHub 仓库批量导入；
• 🔌 MCP server 也能管 —— 加一个 MCP 工具服务器，实时看到它有没有生效；
• 📜 日志有个"直播"面板 —— dsh 和启动器自己的日志都在这儿滚动，出问题一眼能看见。

一句话：如果你在用 dsh，但不想天天记命令、敲路径、翻日志，就装它。

它不做什么（重要）：

• 不改 dsh 源码，只用官方开放的 CLI / 包 / GitHub tag —— dsh 升级了它照样能用；
• 不接管你的数据：DSH_HOME（默认 ~/.dsh）里的东西只读展示，卸载时默认保留；
• 不偷偷下东西：所有安装动作都是你点了才做，界面会实时显示进度与日志。

界面速览

1. 主界面：版本管理 + 工具链 + 实时日志

左边看运行状态、点启动；中间管 dsh 版本（npm / GitHub 双通道）和运行环境（Node / npm / pnpm / Git / Python）；右边是滚动的实时日志。

2. 插件管理：装、卸、开、关，热重载

填 npm 包名（如 dshmarket）或 GitHub 仓库 URL（如 https://github.com/owner/repo）即可安装。 upstream 来源的插件还能自动同步新版本 / 新 commit。

3. 技能管理：让模型用上你的技能

按官方扫描根管理技能（dsh 的 ~/.dsh/skills、共享的 ~/.agents/skills）， 可单个启停、可批量从 GitHub 仓库导入、可检查上游更新（纯手动，永不自动写盘）。

4. MCP server 管理

按 serverName 管理合成树里的 MCP 工具服务器；启停由 dsh 就地热重载，不需要重启。

5. 设置：镜像源、Token、窗口行为

npm registry / GitHub 加速 / Node 二进制三类镜像源，GitHub Token（用于防限流 + git 认证，落盘前用 Windows DPAPI 加密），以及托盘、自动启动等开关。

快速开始

装

1. 打开 Releases，下载最新的 dsh-launcher_<版本>_x64-setup.exe；
2. 双击安装（NSIS 简体中文安装器，免管理员，装到当前用户目录）；
3. 想要免安装版？下载 ..._x64_portable.zip 解压即用。

遇到「Windows 已保护你的电脑」/「未知发布者」？ 这是正常的 —— 本项目不做代码签名（刻意的产品决策，非构建疏忽），所以 Windows SmartScreen 会提示。 点「更多信息」→「仍要运行」即可。 想先核对文件有没有被篡改？下载页附带 SHA256SUMS.txt，用 sha256sum -c SHA256SUMS.txt 校验。

用（典型流程）

1. 打开 「工具链」 → 缺什么点「一键安装缺失」（Node 免 UAC；Git / Python 会弹 UAC 确认）；
2. 打开 「版本管理」 → 选 npm 或 GitHub 通道装一个 dsh；
3. 点左侧 「启动」 → 状态变「运行中」；
4. 点 「内嵌打开」 → 直接在窗口里用 dsh 的 Web GUI（token 自动带上，不用管）；
5. 想扩展能力 → 进 「插件」/「技能」/「MCP」 面板按需装。

功能一览

# 插件
dsh-launcher plugin list [--json]
dsh-launcher plugin install <spec> [--origin upstream|in-house|unknown]
dsh-launcher plugin enable|disable|uninstall <package>
dsh-launcher plugin sync [--check]        # 同步 upstream 插件（--check 只检查不落盘）
dsh-launcher plugin repair [--package <pkg>]

# 技能（注意：技能列表请用 status，没有 skill list）
dsh-launcher skill status [--json]
dsh-launcher skill apply [--mode auto|link|config] [--resource skills|agents-md|context-md]
dsh-launcher skill migrate [--dry-run]    # 迁移冲突资源（原文件改名保留，绝不删除）
dsh-launcher skill repair-links [--json]

# MCP
dsh-launcher mcp list [--json]
dsh-launcher mcp add --server-name <n> --transport <stdio|streamable-http> [选项]
dsh-launcher mcp remove <serverName>
dsh-launcher mcp enable|disable <serverName>

安装方式细节

两种 dsh 安装通道

全局同时只有一个 dsh 生效 —— 切换通道时启动器会先清理对侧（ADR-0003）。

🔒 换版本 / 换通道 / 卸载，都不会碰你的数据

你可以随便切版本、切通道 —— 会话记录、技能、插件、配置全都在。

原因是 dsh 把用户数据集中放在 DSH_HOME（默认 ~/.dsh），而版本切换只动「程序本体」：

启动器实际做了什么（可对照源码）：

要点：切版本不会清技能、不会丢会话、也不会重置插件配置。装上不同版本后，它们读的是同一个 DSH_HOME。

例外（需你知情）：插件本身是装在 ~/.dsh/profiles/<name>/ 里的，跟 dsh 版本无关； 但如果某个插件与新版 dsh 不兼容，新版启动时可能报错 —— 此时启动器会自动把冒头的那一行禁用（可逆）并提示你，不会去卸载它。

插件安装：三种来源形态

在「插件」面板的输入框里可以填：

1. npm 包名 —— 写 registry 上的真实包名，例如 dshmarket（⚠️ 不是它在配置里的行 id dsh-market）；
2. GitHub / Git 仓库 URL —— 例如 https://github.com/owner/repo，建议钉 commit：https://github.com/owner/repo#<sha>； 也支持 github:owner/repo、git+https://...git#main 等 pnpm 原生写法；
3. 本地路径 —— 例如 link:../my-plugin（这类「自研」插件不会被自动同步改动）。

pnpm 拦住构建脚本？ 部分插件安装时要跑 build/prepare 脚本，pnpm ≥10 默认会拦下并打印确切的键名。 按提示把那一行加到 profile 目录的 pnpm-workspace.yaml 的 allowBuilds 下即可 —— 启动器会把这个路径和键名一并显示在错误信息里。 （启动器不代劳这一步：不写 profile 配置文件，与官方 dsh 行为保持一致。）

它是怎么做的（技术）

┌─────────────────────────────────────────────────┐
│  React 19 + TypeScript + shadcn/ui（深色主题）    │  ← 前端：UI 渲染
├─────────────────────────────────────────────────┤
│  Tauri 2 IPC（48 个类型化命令 + 事件推送）         │  ← 桥接层
├─────────────────────────────────────────────────┤
│  Rust：core/（进程·端口·配置·日志·工具链·         │  ← 后端：真正干活
│  GitHub·插件·技能·MCP）+ commands/（IPC 薄壳）    │
└─────────────────────────────────────────────────┘

• 后端（Rust / Tauri 2）：进程生命周期、端口探测、工具链检测与安装、日志落盘、配置持久化、版本与通道管理、事件推送、插件 / 技能 / MCP 管理。
• 前端（React 19 + TS + shadcn/ui + Tailwind CSS 4）：所有界面与交互。
• 进程模型：子进程一律无窗口启动（CREATE_NO_WINDOW）；dsh 的 stdout/stderr 重定向到文件后 tail 读取（解决 Windows 下管道缓冲导致 token 迟迟不出现的问题）；停止时先发 taskkill /PID /T（即 SIGTERM 语义，等待约 1 秒），未退再 /F 强杀，最后按端口兜底清剿残留（清剿前校验监听进程确为 dsh，防误杀）。
• 前后端类型契约：有一条 CI 测试逐字段对账 Rust DTO ↔ TS interface，改名漏改一侧会直接构建失败。

项目结构

dsh-launcher/
├── src/                     # 前端（React + TS + shadcn/ui）
│   ├── components/          #   面板：StatusCard / VersionPanel / ToolchainPanel
│   │                        #         PluginsPanel / SkillsPanel / McpPanel / ...
│   ├── components/ui/       #   shadcn/ui 组件
│   ├── hooks/               #   useTauriEvent / useResizablePanel / useIsMobile
│   └── lib/tauri.ts         #   IPC 的类型化封装（与 Rust 命令一一对应）
├── src-tauri/               # 后端（Rust）
│   ├── src/core/            #   核心逻辑（process / port / config / logging /
│   │                        #   toolchain / github / plugin / skill / mcp / tray …）
│   ├── src/commands/        #   Tauri IPC 命令（薄壳：spawn_blocking + 事件广播）
│   ├── src/cli.rs           #   无 GUI 命令行（与 GUI 共用同一套 core）
│   └── capabilities/        #   Tauri 2 权限声明（最小化授权）
├── docs/
│   ├── DESIGN.md            #   设计总览
│   └── adr/                 #   架构决策记录 ADR-0001 ~ 0009
├── png/                     #   本 README 的界面配图
└── .github/workflows/       #   CI / Release / Nightly 三条流水线

开发

npm install          # 安装依赖（若本机 .npmrc 含 omit=dev，需加 --include=dev）
npm run tauri dev    # 开发模式（前端热更新 + Rust 热重载）
npm run build        # 只构建前端（tsc 类型检查 + vite build）
npm run tauri build  # ★ 打包：产出可运行的 exe + NSIS 安装包

⚠️ 发布构建必须启用 custom-protocol（踩过的坑）

不要用裸 cargo build --release 产出发布件。

tauri::is_dev() 的实现是 !cfg!(feature = "custom-protocol")（见 tauri-2.11.5/src/lib.rs:308）。 缺少该 feature 时，即使加了 --release，二进制仍处于开发模式：它不去加载内嵌的前端资源， 而是去连 build.devUrl（http://localhost:1420）—— 于是窗口报 ERR_CONNECTION_REFUSED（"localhost 拒绝连接"），且构建输出目录不会生成 tauri-codegen-assets。

自检：看构建输出目录有没有 target/release/build/dsh-launcher-*/out/tauri-codegen-assets/ —— 有 = 前端已内嵌（正常）；没有 = dev 模式（启动会连不上）。

测试

cargo test --manifest-path src-tauri/Cargo.toml --lib          # Rust 单元测试
cargo test --manifest-path src-tauri/Cargo.toml --test <name>  # 集成测试
npx tsc --noEmit                                               # 前端类型检查

持续集成与发布

三条 GitHub Actions 流水线（.github/workflows/）：

• CI —— 每次 push / PR：版本一致性门禁 → tsc 类型检查 → 前端构建 → cargo check（零警告）→ 单元 + 离线集成测试；
• Release —— push 到 master：自动递增 PATCH 版本、写 CHANGELOG、构建 NSIS 安装包 + 便携 zip + SHA256SUMS.txt，发布 GitHub Release；
• Nightly —— 每晚跑依赖真实网络 / 真实 dsh 环境的 #[ignore] 集成测试（失败不阻断 master）。

版本号由 scripts/bump-version.mjs 同步「五文件六落点」并带一致性校验（ADR-0004 / ADR-0009），防止手工改一处导致漂移。

常见问题（FAQ）

文档

技术栈

Tauri 2 · Rust · React 19 · TypeScript · Vite · Tailwind CSS 4 · shadcn/ui（base-nova）

许可

MIT © 2026 dsh-launcher contributors