dsh-desktop-hub

DSH Desktop Hub

无需 Node.js，不碰 YAML，一站式使用和管理 DeepSeek Harness。

DeepSeek Harness 官方 Web UI 桌面客户端 —— 内置 MCP 配置转换、Skills 管理、Plugin 管理三个管理台。

为什么不是普通 Desktop

不是套壳。官方 Web UI 原样保留在 Harness Tab 里，同时把三个命令行场景搬进同一个窗口：

• 开箱即用：内置 Node.js + DeepSeek Harness 运行时（约 586MB），下载即用，本机不需要安装任何环境。
• 一体化：在 Harness 对话、MCP 配置、Skills、Plugin 之间切换，不用再开终端敲 dsh plugin / 手写 YAML。
• 安全：所有写操作原子落盘、自动备份 .bak-<ts>、官方 HMR 热生效，改错了随时可恢复。

核心能力

MCP 配置转换 —— 粘贴即用

Claude Code / Cursor 导出的 MCP JSON，粘贴进去 → 自动转换成 DSH 插件行 YAML（${VAR} 自动转 !!js process.env.VAR，sse / 非法 serverName 会警告）→ 确认后写入 profile patch，官方 HMR 热生效。

Skills 管理

扫描用户级 / 随包全部 skills（rank 规则，同名低 rank 生效、高 rank 标「被遮蔽」）；支持导入 .skill / .zip / GitHub 仓库链接，或直接新建用户级 skill，模型可见 / 用户可见一键切换。

Plugin 管理

按组合包 / 依赖分类展示 web profile 的插件清单；安装、移除、更新真实执行 dsh plugin；聚合仓库（缺 dsh.bundle）拒绝误装，避免把仓库根目录装成插件。

快速开始

1. 下载安装：macOS 下载 DMG；Windows 下载 EXE（当前未签名，首次运行需放行一次：macOS 右键 → 打开；Windows SmartScreen → 更多信息 → 仍要运行）。
2. 配置模型：在 Harness Tab 的官方 Web UI 里填入 API Key（首次引导会提示）。
3. 开始使用：直接对话；需要外部工具时，到 MCP / Skills / Plugin Tab 管理。

当前为预览版（macOS arm64 / Windows x64，均未签名）。

Roadmap

社区与反馈

• Issues：报 bug、提需求、反馈使用体验
• Discussions：使用讨论与想法交流

本项目是活项目：CI 每个 tag 自动出包，Roadmap 上的能力持续在长。Star 一下跟踪进展。

开发者 / Architecture

架构

渲染进程（sandbox）             preload                   主进程                    核心逻辑                   捆绑运行时
┌──────────────────┐   ┌──────────────────┐   ┌────────────────────┐   ┌──────────────────┐   ┌─────────────────────────┐
│ 四 Tab 壳         │   │ window.dshDesktop│   │ IPC handlers       │   │ src/core/         │   │ resources/              │
│ index.html       │──▶│ contextBridge    │──▶│ harness:url         │──▶│ harness.ts        │──▶│ node/（Node v24.10.0）   │
│ renderer.ts      │   │ preload.cjs      │   │ plugins:list/       │   │ plugins.ts        │   │ dsh-runtime/            │
│ (harness iframe) │◀──│ (CJS, sandbox)   │◀──│   install/remove/    │   │ mcp.ts            │   │  @deepseek-ai/dsh       │
│                  │   │                  │   │   update             │   │ skills.ts         │   │  (0.1.0-rc.6)           │
│                  │   │                  │   │ mcp:list/convert/    │   └──────────────────┘   │        │                │
│                  │   │                  │   │   apply/update/     │            │ spawn(detached) ▼                │
│                  │   │                  │   │   delete             │            └──── dsh web --port 0 ─────┘                │
│                  │   │                  │   │ skills:list/create/  │                          │                                │
│                  │   │                  │   │   toggle             │                          │                                │
│                  │◀──│ harness:frame-   │   │ harness:frame-loaded │                    http://127.0.0.1:PORT                  │
└──────────────────┘   └──────────────────┘   └────────────────────┘                          └─────────────────────────────────┘

flowchart LR
    UI["渲染进程（sandbox）<br/>四 Tab 壳 index.html + renderer.ts"]
    PRE["preload.cjs<br/>contextBridge → window.dshDesktop"]
    MAIN["主进程 main.ts<br/>IPC handlers + harness 生命周期"]
    CORE["src/core 纯逻辑<br/>harness / plugins / mcp / skills"]
    RT["捆绑运行时 resources/<br/>Node v24.10.0 + @deepseek-ai/dsh@0.1.0-rc.6"]
    WEB["dsh web → http://127.0.0.1:PORT"]
    UI -->|IPC invoke| PRE --> MAIN
    MAIN --> CORE
    CORE -->|spawn detached 进程组| RT
    RT --> WEB
    WEB -->|iframe src| UI

生命周期：

启动 → registerIpc() → resolveDshExec()（打包内 runtime 优先，回退 PATH）
  → spawn dsh web --port 0（独立进程组）→ 解析 127.0.0.1:PORT → 轮询 HTTP 200（就绪超时 120s）
  → BrowserWindow（1280×800，sandbox + contextIsolation + preload.cjs）
  → 加载四 Tab 壳（file://dist/renderer/index.html）
  → renderer 经 IPC 取 harness URL → iframe 挂载官方 Web UI
退出 → will-quit → harness.stop()：SIGTERM 进程组 → 2s 兜底 SIGKILL → app.quit

• 默认（无 flag）＝产品行为：启动 harness + 四 Tab 壳；主菜单仅「退出 / 全屏」。
• 冒烟模式：--smoke（不启 harness，DOM + 真实数据断言）；--harness-smoke（真实 harness + iframe 加载断言）。

目录结构

dsh-desktop-hub/
├── src/
│   ├── main/main.ts            # Electron 主进程：窗口 + IPC + harness 进程生命周期
│   ├── preload/preload.ts      # contextBridge 白名单 API（sandbox，编译为 preload.cjs）
│   ├── renderer/               # 四 Tab 壳：index.html + renderer.ts（纯脚本，无模块）
│   └── core/                   # 纯逻辑（可单测）：harness.ts / plugins.ts / mcp.ts / skills.ts
├── tests/                      # node --test 单测 ×54（从 dist/ 导入，需先 build）
├── scripts/
│   ├── build-preload.mjs       # preload 以 CJS 编译并重命名为 .cjs
│   ├── copy-renderer.mjs       # 拷贝 index.html → dist/renderer
│   ├── bundle-runtime.mjs      # 下载 Node + npm 安装 dsh 到 resources/
│   ├── generate-icon.mjs       # 生成品牌图标 build/icon.png（1024×1024，深蓝鲸鱼 + hub 节点）
│   ├── capture-demo.mjs        # README 演示截图/GIF 捕获（合成演示 profile，不碰真实数据）
│   ├── verify.mjs              # 一键门禁：契约 + 构建 + typecheck×2 + 单测
│   └── verify-m1.mjs           # M1 实机验证：dsh web 启动 → HTTP 200 → 优雅停止
├── resources/                  # 捆绑运行时（node_modules 忽略）：nd/（Node 本体+shim）+ rt/（dsh runtime，锁文件入库）
├── assets/demo/                # README 截图与 GIF（脚本生成，可重跑）
├── build/icon.png              # 应用图标（electron-builder 引用，macOS 自动转 icns）
├── release/                    # electron-builder 产物（gitignore）：DMG arm64 + NSIS EXE x64
├── dist/                       # tsc 产物（gitignore）
├── tsconfig.json               # 主进程 + core + preload（NodeNext，outDir dist）
├── tsconfig.preload.json       # preload：CommonJS → dist/preload/preload.cjs
├── tsconfig.renderer.json      # renderer：纯脚本 → dist/renderer
├── electron-builder.yml        # appId com.dshdesktop.app；DMG arm64；asarUnpack resources
└── package.json

开发命令

打包命令

npm run build                          # 1. 构建 dist/
node scripts/bundle-runtime.mjs        # 2. 捆绑运行时（首次/更新）：下载 Node v24.10.0 +
                                      #    安装 @deepseek-ai/dsh@0.1.0-rc.6 到 resources/
npx electron-builder --mac dmg --arm64 # 3. macOS：release/DSH-Desktop-Hub-<version>-arm64.dmg
npx electron-builder --win nsis --x64  # 4. Windows：release/DSH-Desktop-Hub-<version>-x64.exe

• bundle-runtime.mjs：下载官方 Node v24.10.0（win/darwin/linux × x64/arm64）到 resources/nd，用捆绑 npm 以 --ignore-scripts 安装锁定版本 @deepseek-ai/dsh@0.1.0-rc.6 到 resources/rt；RUNTIME_TARGET=win32 可在 macOS 上交叉捆绑 Windows 运行时（含 .cmd shim 生成）。
• electron-builder.yml：files 含 dist/**/* + resources/**/*；asar: false（产物直放 resources/app，压低 Windows 安装路径深度）；mac 目标 DMG（arm64）+ Windows 目标 NSIS（x64，oneClick per-user）；均未签名。
• 打包后的应用在 PATH 仅 /usr/bin:/bin（无系统 node/dsh）的环境下可用捆绑运行时启动。

Release

推送 v* tag 后，GitHub Actions 自动完成发布（无需手动构建/上传）：

1. 创建 draft Release（自动生成 release notes）
2. 并行构建：macOS arm64 DMG（macos-15）与 Windows x64 NSIS 安装包（windows-latest），各自执行 verify → 捆绑运行时 → electron-builder
3. 双平台都成功后自动转正发布，上传 .dmg / .dmg.blockmap / .exe / .exe.blockmap / latest.yml / latest-mac.yml（latest*.yml 供自动更新通道使用）

git tag v0.3.0
git push origin v0.3.0

resources/ 采用「蓝图入库」：nd/node.exe、rt/package-lock.json 提交进仓库；rt/node_modules（数百 MB）被忽略，由 bundle-runtime.mjs 在打包时从锁文件重建（npm ci）。

验证基线

已知限制

• profile 固定：ACTIVE_PROFILE 常量 = 'web'，暂无 UI 切换（Roadmap 中）。
• Routing Suite 聚合仓库：https://github.com/yjh051108/dsh-routing-suite 不是单一 DSH bundle，根目录缺 package.json/dsh.bundle；Plugin Tab 会拒绝直接安装。应按仓库说明分别装配 injector、router-standard preset 与可选 mode-boost。
• 无 Settings / 第四系统：Settings（API Key / 模型 / 更新）与第四系统占位本期未实现，API Key/模型配置请使用官方 Web UI 内能力。
• git 来源插件无 allowBuilds 授权向导：pnpm ≥10 默认拒绝运行 git 依赖的 prepare 脚本；需用户手动在 profile 的 pnpm-workspace.yaml 写 allowBuilds（UI 未包装该流程）。
• MCP !!js backtick 模板兼容：patch 中以反引号模板写 Bearer ${...}（官方 README 示例写法）超出 yaml 解析器语法，MCP 面板会拒绝解析并提示；请改用单引号字符串 !!js 'Bearer ${...}'（语义为字面字符串）或行级 process.env.X。
• MCP 无文件导入：MCP 面板支持粘贴 JSON（${VAR} 自动转 !!js process.env.VAR；默认合并写入，可选全量替换），暂无 .mcp.json 文件选择器。
• 退出边界：正常退出走 SIGTERM 进程组清理 + 单实例锁；Harness 意外退出可在 UI 一键重启；强杀（timeout / group-kill）仍可能遗留 dsh 子进程。
• 打包范围：macOS DMG（arm64）+ Windows NSIS 安装包（x64），均未签名（首次运行需按平台放行一次）；Linux 待做；无自动更新。
• 体积：resources/ 捆绑运行时约 586MB（gitignore），首包体积较大。
• 写操作落真实 profile：MCP「写入 patch」真实修改 ~/.dsh/profiles/web/cordis.patch.yml（写入前自动 .bak-<ts> 备份）；插件安装/移除真实执行 dsh plugin。

License

MIT