happpsee/dsh-desktop-app

主人好呀～ 小南梁是 DeepSeek Harness 的鲸鱼娘代码娘，这里是小南梁的「国内落地 know-how + 技能包」，附带一个可用的 Tauri 桌面壳参考实现。 一键安装：dsh plugin add dsh-desktop-app（npm）或 dsh plugin add github:happpsee/dsh-desktop-app（GitHub），主人家的 agent 就学会「把 DSH 封装成桌面应用」的手艺了呢～

小南梁才不是又一个桌面壳（GitHub 上同类已经多到打群架啦）。这个仓库真正值钱的是三点别处没有的看家本领：

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 双平台，托盘常驻 / 单实例 / 子进程回收 / 品牌注入 / 任务完成通知）作为这套 know-how 的可运行参考实现。

名字的来由

• 「南」：梁总（DeepSeek 创始人梁文锋，广东湛江人，南方人）的南方之义
• 「梁」：取其姓氏
• 封面：鲸鱼娘（DeepSeek 官方鲸鱼的娘化 OC「溟月」，深海女仆工坊 maid-atelier）， 与「小南梁」之名相配
• 技术标识仍用 ASCII 的 dsh-desktop-app / dsh-desktop，中文只出现在展示层

特性

• 一键启动：双击 app → 自动探测/拉起 dsh web（127.0.0.1:3080）→ 就绪后 自动导航；已有服务则直接复用，退出时绝不误杀
• 托盘常驻：关闭窗口仅隐藏（首次有通知提示），托盘左键唤起、菜单退出； 拦截 Cmd+Q 防误退
• 进程回收：只回收本次启动 spawn 的 dsh 子进程，stdout/stderr 落盘日志
• 单实例：重复双击聚焦已有窗口，不会拉起第二个服务
• 窗口状态记忆：位置与大小自动恢复
• 品牌注入：窗口内左上角官方 logo/字标替换为鲸鱼娘 +「小南梁」
• 任务完成通知：注入 JS 监听"忙碌→空闲"翻转，任务结束时 Dock 角标 +1； 窗口失焦/隐藏时弹系统通知并跳 Dock（前台不打扰），回到窗口自动清零
• 健壮定位：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 下载 小南梁_*.dmg，拖入应用程序
3. 双击「小南梁」；托盘菜单可退出

从源码构建

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

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

作为技能使用

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

平台实测状态

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

许可

• 代码与文档：MIT（见 LICENSE）
• 鲸鱼娘图标（desktop/src-tauri/icons/ 及加载页素材）：CC BY-NC-SA 4.0 非商用
  • 角色 OC「溟月」by 上善无形；DeepSeek 二创 ZipZipPipe；修复 QYQCAMIAO
  • 素材来源：fornarwhal/deepseek-whale-girl-icon
  • 许可证全文：skill/resources/ 无此文件时见素材仓库；署名请勿移除
• 另请注意：DeepSeek 鲸鱼为官方商标，本应用是非官方客户端

已知限制

• Web GUI 内的系统通知（如任务完成）尚未接入桌面通知通道
• 品牌注入在窗口内手动刷新（Cmd+R）后会丢失，重开窗口恢复
• 未签名分发：Windows 网络下载的 exe 会触发 SmartScreen 提示（本地构建不触发）； macOS 非公证 app 需右键打开