DSH｜dsh-desktop｜Tauri 2 桌面壳：托管 dsh web，让 DeepSeek Harness 以原生应用形态运行
非官方项目，由社区成员独立开发和维护，与 DeepSeek 官方无关联。
Unofficial project, independently developed and maintained by a community
member. Not affiliated with or endorsed by DeepSeek.
Project URL / 项目地址: https://github.com/baikangwang/dsh-desktop
简介 / Introduction
中文：dsh-desktop 是 DeepSeek Harness
Web 界面的桌面壳（Tauri 2 + Rust + WebView2）。它是极薄的宿主包装器，不是 fork：
不打包 DSH，启动时通过 npx 解析并安装最新 dsh web，以受管子进程运行它，再把
WebView 导航到其服务的 URL。补上了浏览器给不了的体验：独立应用图标、单实例、
系统托盘、关窗驻留、崩溃自愈、优雅关停、本地插件安装。
English: dsh-desktop is a thin desktop shell for the
DeepSeek Harness Web GUI,
built with Tauri 2 (Rust + WebView2). It never bundles DSH: on startup it
resolves the latest dsh web via npx, manages it as a child process, and loads
its URL in a WebView2 window — adding what a browser cannot: an app icon,
single instance, system tray, close-to-tray, crash auto-restart, graceful
shutdown, and local plugin installation.
Screenshots / 截图
（占位：启动进度窗、主界面、托盘菜单 —— 后续补充）
(Placeholder: splash/progress window, main UI, tray menu — to be added.)
与 DSH 的集成方式 / How it integrates with DSH
| 集成点 | 机制 |
|---|---|
| 运行 DSH | 启动时经 npx @deepseek-ai/dsh@<latest>（专属缓存）运行 dsh web --port 0，解析 stdout 端口 |
| WebView 加载 | 导航到 dsh web 服务的 URL（window.__DSH_BOOT__ 由 dsh web 注入——本壳不注入、不打包任何前端） |
| 会话 / 工作区 / 插件 | 与浏览器版共享 DSH_HOME（~/.dsh）：零迁移，web 与桌面双端一致 |
| 健康 / 优雅关停 | DSH 侧 ops overlay（dsd-side/）挂载 /api/health + /api/admin/shutdown（Bearer 每进程密钥） |
| 插件 | 托盘「安装插件…」：选择本地 .tgz → dsh plugin --profile web add → 重启 dsh 生效（与 web 版同 profile） |
Requirements / 环境要求
- Windows 10 1809+ / Windows 11（WebView2 Evergreen）
- Rust stable (MSVC) + VS 2022 Build Tools（含 Windows SDK）+ Node.js ≥ 20（构建期）
Build & Run / 构建与运行
npm install
npm run tauri -- dev # 开发运行
npm run tauri -- build # 构建 NSIS 安装包（per-user）Release / 发布
见 docs/cicd.md：node scripts/dsh-release.mjs --dry-run 预览，
确认后执行（自动打 v* tag → GitHub Actions 构建 → NSIS 产物挂到 GitHub Release）。
仓库结构 / Repo layout
ui/ splash / 安装进度 / 离线页
scripts/
dsh-release.mjs 发布执行层（幂等：读版本 → tag → 生成 release workflow）
local-setup.ps1 一次性构建环境准备（Rust + MSVC + npm install）
src-tauri/ Tauri 2 Rust 后端
src/
app.rs setup 装配（插件、托盘、单实例、生命周期）
process_supervisor.rs spawn dsh web、解析端口、监视退出
dsh_manager.rs npx 执行、版本决策/缓存、插件兼容门、插件安装
health.rs 就绪/存活探针
lifecycle.rs 状态机 + 重启/退避 + 优雅关停
tray.rs 托盘图标/菜单/状态色
plugins.rs 本地插件安装流程（选包 → dsh plugin → loader entry → 重启）
commands.rs WebView<->Rust IPC
config.rs config.json 与日志滚动
docs/
ARCHITECTURE.md 架构设计
DEPLOYMENT.md 安装/升级/目录布局
INTERFACE_CONTRACT.md DSH 侧 /api/health + /api/admin/shutdown 契约
cicd.md 打包/发布流程（对齐 DSH 插件生态多项目方案）
dsd-side/ DSH 侧 ops overlay 插件（挂载两个路由）
skills/release/ DSH release skill（agent 发布操作层）文档 / Docs
- ARCHITECTURE.md — 架构设计（进程模型、关键机制、性能/安全边界）
- DEPLOYMENT.md — 安装 / 升级 / 目录布局
- INTERFACE_CONTRACT.md — DSH 侧契约
- cicd.md — 打包 / 发布流程
License
Apache-2.0（与 DSH 生态一致；dsh-desktop 本身非官方、与官方无关联）。