小南梁（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 上同类已经多到打群架啦）。这个仓库真正值钱的是三点别处没有的看家本领：
- Windows 无管理员工具链方案：无 VS Build Tools 也能构建 Tauri 2（xwin + rust-lld + clang-cl + 真 rc.exe），全部用户级安装，附配置模板与脚本
- 国内镜像哨兵机制：rustup/cargo/npm/GitHub/NSIS 全套镜像 + subagent 超时判定，Windows 新环境不再卡外网
- 真机实测审计报告：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/字标替换为鲸鱼娘 +「小南梁」
- 鲸鱼娘桌宠：透明置顶无边框小窗，CSS 呼吸/漂浮动画 + 椭圆阴影 + 眨眼帧动画
（睁眼→半闭→闭眼，约 5s 一次）与任务完成开心表情（gpt-image 锚定原形象生成）；
拖拽移动（4px 阈值区分点击）、左键唤起主窗、右键菜单（穿透开关/隐藏/退出）、
任务完成弹气泡；位置记忆（多屏钳位 + 拖拽防抖）；托盘「显示/隐藏桌宠」开关
- 任务完成通知：注入 JS 监听运行中标记（
data-state="ongoing"）的"忙碌→空闲"
翻转，任务结束时 Dock 角标 +1；窗口失焦/隐藏时弹系统通知并跳 Dock（前台不打扰），
回到窗口自动清零；通知桥内置 CORS 预检应答（跨源 fetch 不再被浏览器拦截）
- 健壮定位：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）
- 确保已装 dsh：
npm i -g @deepseek-ai/dsh
- 从 Releases 下载
小南梁_*.dmg，拖入应用程序
- 双击「小南梁」；托盘菜单可退出
从源码构建
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 技能
平台实测状态
许可
- 代码与文档：MIT（见 LICENSE）
- 鲸鱼娘图标（
desktop/src-tauri/icons/ 及加载页素材）：CC BY-NC-SA 4.0 非商用
- 另请注意：DeepSeek 鲸鱼为官方商标，本应用是非官方客户端
已知限制
- 品牌注入在窗口内手动刷新（Cmd+R）后会丢失，重开窗口恢复
- 任务完成通知仍为 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 需右键打开
