DeepSeek Harness Desktop（dsh-desktop-tauriapp）

主人好呀～ 这是 DeepSeek Harness Desktop 桌面客户端仓库，把 DeepSeek Harness Web GUI 封装成 macOS/Windows 桌面应用。一键启动、托盘常驻、退出自动回收子进程。 一键安装：dsh plugin add dsh-desktop-tauriapp（npm）或 dsh plugin add github:hyperion2144/dsh-desktop-tauriapp（GitHub），主人家的 agent 就学会「把 DSH 封装成桌面应用」的手艺了呢～

来源与致谢：本仓库 fork 自 happpsee/dsh-desktop-app，现由 hyperion2144/dsh-desktop-tauriapp 独立演进维护；感谢原作者的开创性工作。

这个仓库把 DeepSeek Harness 做成桌面端（macOS + Windows 双平台），主要看点：

1. Windows 无管理员工具链方案：无 VS Build Tools 也能构建 Tauri 2（xwin + rust-lld + clang-cl + 真 rc.exe），全部用户级安装，附配置模板与脚本
2. 国内镜像哨兵机制：rustup/cargo/npm/GitHub/NSIS 全套镜像 + subagent 超时判定，Windows 新环境不再卡外网
3. 真机实测审计报告：Win11 无管理员逐条实测 + 20 条修订清单（docs/）

桌面壳本身（desktop/，macOS + Windows 双平台，托盘常驻 / 单实例 / 子进程回收 / 任务完成通知 / macOS Overlay 标题栏）作为可运行参考实现。

命名

• 应用展示名：DeepSeek Harness Desktop（与已安装的 DeepSeek Harness.app 保持一致）
• 技术标识：ASCII 的 dsh-desktop-tauriapp / dsh-desktop-tauriapp / com.arcreel.dsh-desktop-tauriapp
• 应用图标：复用已安装的 DeepSeek Harness.app 的 icon.icns（保真度最高的 macOS icns）
• 应用内左上角图标：保留 DSH Web GUI 原始样式；桌面 chrome（拖拽区/状态条/窗口按钮）由内置 dsh-desktop-tauriapp 插件的 client 提供——应用启动时把插件经 --patch 注入 dsh web profile（实体挂共享模块池，不写 profile bundles），窗口加载 URL 带 dsh-desktop-tauriapp-mode=advanced&dsh-desktop-tauriapp-platform=<平台> 标记，插件 client 在标准布局内注入局部拖拽区/状态条（不禁用 stock ui-layout）；普通浏览器访问不激活、不受影响

特性

• 一键启动：双击 app → 探测本地 dsh web（默认 127.0.0.1:3080，端口可在托盘「本地端口…」 修改，DSH_DESKTOP_PORT 环境变量优先；dsh 升级后默认会打开系统浏览器，桌面壳 spawn 时带 --no-open 关闭）。空闲则由本应用按配置的 profile/端口拉起实例并直接启用桌面 chrome； 已有实例时，启动页弹「兼容/高级」模式选择：
  • 兼容模式：复用外部实例、标准布局、系统原生标题栏（不启用桌面 chrome，浏览器不影响）
  • 高级模式：先停用占用端口的现有 dsh（含外部/终端进程），再按配置拉起桌面壳实例、 启用完整桌面 chrome 退出只回收自己拉起的实例
• 进程守护（0.6.0）：连接级健康探测（TCP 连不上才判异常），异常自动回启动页并重建；自愈 3 次 封顶、自动重启冷却 60s；复用外部实例/远程只提示不代拉。侧边栏底部整行状态条实时显示运行状态 （重启走托盘，状态条不承担点击）
• 托盘三件套（0.6.0）：Profile ▸ 二级菜单（扫描/切换/新建）、dsh 服务地址 ▸（本地/ 远程列表/新增/删除）、「本地端口…」；配置持久化于 $DSH_HOME/settings.yaml 的 dsh-desktop-tauriapp: 键（只读写该键，其余内容不动）
• 远程 dsh（0.6.0）：可切换到任意远程 dsh 地址；高级模式需要远程已安装本插件，缺则提示建议 切兼容模式；远程只做可达性检测、不代拉不重启
• 托盘常驻：关闭窗口仅隐藏（首次有通知提示），托盘左键唤起、菜单退出； 拦截 Cmd+Q 防误退
• 托盘「重启 dsh 服务」：会停掉当前占用端口的实例（含复用的外部实例，例如终端/浏览器 起的 dsh web），再按当前配置（profile/端口/本地或远程）重建服务；远程模式下则重新导航远程页面
• 进程回收：只回收本次启动 spawn 的 dsh 子进程，stdout/stderr 落盘日志
• 单实例：重复双击聚焦已有窗口，不会拉起第二个服务
• 窗口状态记忆：位置与大小自动恢复
• 桌面 chrome（插件式，参考 dsh-plugin-desktop 实现）：由内置 dsh-desktop-tauriapp 插件 client（src/client/，构建产物 lib/client.js）在标准布局内局部注入（不禁用 stock ui-layout）——macOS titleBarStyle: Overlay 保留原生红绿灯 + 侧栏区域拖拽；Windows/Linux 用 decorations:false 隐藏系统标题栏，中间 header 区域自绘 caption 行 + 最小化/最大化/关闭按钮；布局/配色全部跟随主题 token，无硬编码；另注入设置弹窗 tab 列滚动等样式修复（稳定标记定位，不依赖 hash 类名）
• 插件注入（--patch 方式）：应用启动（需拉起 dsh 时）把内置插件实体的符号链接挂入共享模块池 $DSH_HOME/profiles/node_modules（Windows 退化为实体复制），并迁移历史 plugin add 写入的 profile bundle 注册；spawn 时传 --patch 注入清单（包名行）——不写 profile bundles、不禁用 stock ui-layout，浏览器 GUI 不受影响
• 内嵌插件跨平台路径：dsh-desktop-tauriapp 打包时经 bundle.resources 内嵌进安装包—— macOS 落在 Contents/Resources/dsh-desktop-tauriapp、Windows 落在可执行文件所在安装目录、 Linux 落在 /usr/lib/<应用>（deb）或 AppImage 挂载点；运行时统一用 app.path().resource_dir() 解析真实位置，安装目录不在 /Applications 也不受影响。
• 鲸鱼娘桌宠：透明置顶无边框小窗，纯 CSS 呼吸/漂浮动画 + 椭圆阴影；拖拽移动 （4px 阈值区分点击）、左键唤起主窗、右键菜单（穿透开关/隐藏/退出）、任务完成 弹气泡；位置记忆（多屏钳位 + 拖拽防抖）；托盘「显示/隐藏桌宠」开关
• 任务完成通知：注入 JS 监听运行中标记（data-state="ongoing"）的"忙碌→空闲" 翻转，任务结束时 Dock 角标 +1；窗口失焦/隐藏时弹系统通知并跳 Dock（前台不打扰）， 回到窗口自动清零；通知桥内置 CORS 预检应答（跨源 fetch 不再被浏览器拦截）
• 三平台通知权限：启动时 best-effort 申请/确认系统通知权限（macOS UNUserNotificationCenter / Windows Toast / Linux dbus），所有系统通知的发送结果统一落日志，便于排查"通知不生效"
• 外链默认浏览器打开：webview 里任意位置的 http(s)/mailto/tel 链接（对话内、设置页等）， 由插件 client 拦截并转交系统默认浏览器（Tauri 命令 open_external），同时覆盖 window.open （"在新窗口打开链接"等）；纯浏览器页面不做任何拦截
• 启动控制台：加载页实时显示 dsh web 子进程的 stdout/stderr（原生侧 emit dsh-console 事件到页面），控制台样式输出框支持展开/收起/清空，启动失败时可直接看到原因
• 健壮定位：Finder/资源管理器启动的 GUI 应用没有终端 PATH，内置 nvm/npm-global/npx/Homebrew/非标准盘符等多级兜底探测（Windows 分支用 node + bin.js 直跑，规避 dsh.cmd shim 与黑窗闪现）
• 国内镜像优先：skill 内置 rustup/cargo/npm/GitHub/NSIS 全套国内源配置， 以及"subagent 哨兵"下载时长判定机制（Windows 无管理员环境的完整替代工具链 方案见 docs/windows-build-notes.md）

仓库结构

skill/     Claude/DSH 兼容技能包（SKILL.md + resources/ 参考实现 + Windows 实战笔记）
desktop/   Tauri 2 项目源码（macOS + Windows，cfg 双平台分支）
docs/      Windows 实测审计报告与构建笔记

快速开始

直接安装（macOS）

1. 确保已装 dsh：npm i -g @deepseek-ai/dsh
2. 从 Releases 下载 Deepseek-Harness_*.dmg，拖入应用程序
3. 双击「DeepSeek Harness Desktop」；托盘菜单可退出

从源码构建

cd desktop
pnpm install
pnpm tauri build   # macOS 出 .app/.dmg；Windows 出 .msi/.exe

构建细节、平台差异与验收清单见 skill/SKILL.md。

作为技能使用

cp -r skill ~/.claude/skills/dsh-desktop-tauriapp   # Claude Code / Claude Agent
# DSH：复制到所运行 profile 的 skills 目录后加载 dsh-desktop-tauriapp 技能

平台实测状态

平台	状态
macOS	✅ 实测（三条验收路径全绿）
Windows	✅ 实测（Win11 无管理员环境完整构建+打包+验收，见 docs/windows-audit-report.md）

许可

• 代码与文档：MIT（见 LICENSE）
• 应用图标来源：/Applications/DeepSeek Harness.app/Contents/Resources/icon.icns（已安装的桌面客户端原图，复用以保证图标一致）
• 鲸鱼娘素材：CC BY-NC-SA 4.0 非商用素材仍随仓库保留（skill/resources/whale-girl-LICENSE.txt），如有启用可作为品牌辅助素材
• 另请注意：DeepSeek 鲸鱼为官方商标，本应用是非官方客户端

已知限制

• 任务完成通知仍为 DOM 启发式（data-state 运行中标记），分不清成功/失败/被停、 拿不到标题/token；权威信号 turn/end 的语义化升级方案见 docs/next-tasks.md
• 桌宠：macOS 打包（DMG）后透明可能丢失（tauri issue #13415，dev 正常，需真机双验）； macOS 置顶仅 Floating 级、盖不过全屏应用；macOS Cmd+Tab 会出现桌宠条目 （skipTaskbar 仅 Windows 生效）；任务通知首次弹出需在系统设置授予通知权限
• 未签名分发：Windows 网络下载的 exe 会触发 SmartScreen 提示（本地构建不触发）； macOS 非公证 app 需右键打开