DSH小助手 🐋
住在桌面上、由 DeepSeek Harness 真实工作状态驱动的 Agent 伴侣。
入口属于 DSH，生命周期属于 DSH，显示层属于桌面。
使用 · 外观与互动 · 今天干了什么 · 参考与致谢 · 已知边界
· · ·
DSH小助手不是需要单独启动的桌宠应用：它由 DSH 插件拉起，跟着 DSH 一起启动和退出，
以透明、无边框、始终置顶的原生窗口待在桌面上。切到 VS Code、浏览器或全屏应用之后，
照样能看到 DSH 当前在思考、在执行、在等你确认，还是已经完成。
它只显示真实发生的事：状态来自 DSH 的会话事件 —— 不读屏幕、不根据模型名猜推理强度、
也不编造完成度。几个项目一起跑时，气泡只给两行关键信息：谁在跑、谁在等你。
macOS（Apple Silicon / Intel 通用二进制）· 包里自带编译好的 helper 与素材包，
装完就能跑，不需要 Xcode
状态展示
七个耐久状态各自有动作与文案，同一状态还会随机换姿势，不会一直重复同一张图。
多项目并行：
多项目并行
子任务也算在进行中：会话派出子 Agent（或后台跑着别的活）时，就算它自己的回合已经
结束，桌面上那个项目仍然是 ● —— 气泡说「子任务在跑，我盯着」，直到最后一个子任务收工。
设置里的「含子 Agent」打开后，子会话会自己占一格，父项目就不再重复显示这份工作。
完成、出错、等你确认各会另起一条通知，独立于状态气泡钉在宠物上方，
点一下就把 DSH 窗口带到最前、并切到那个会话（macOS 上靠激活 DeepSeek Harness 本体）——
状态气泡可能正被别的项目占着，通知不会。
使用
装到 DSH 里
dsh plugin --profile desktop add dsh-assistant
--profile 填你实际在用的那个（桌面端是 desktop，Web 端是 web）。
这条命令背后是 pnpm：装完包之后，它会自动把声明了 dsh.bundle 的依赖加进
profile 的 dsh.profile.bundles —— 不用手改 package.json。
包里带着编译好的 macOS helper 与素材包（44MB），装完就能跑，不需要 Xcode。
重启 DSH 后，桌面右下角会出现宠物，设置里多出一页「DSH小助手」（左侧导航里）。
以后升级：
dsh plugin --profile desktop update dsh-assistant
想跟着最新提交跑
npm 上是发版快照；想用 GitHub 上最新的 main：
dsh plugin --profile desktop add github:vianvio/dsh-assistant
改这个插件本身
改用 link，改完不用重装：
git clone https://github.com/vianvio/dsh-assistant.git ~/dsh-assistant
dsh plugin --profile desktop add link:$HOME/dsh-assistant
自己构建（可选）
包里带了编译好的 macOS helper 与素材包，上面三种装法都用不到这些命令；
只有改了原生端或想换素材时才需要：
npm run build:helper # 编译原生 helper（需要 Xcode 命令行工具）
npm run build:pack # 重新生成素材包
npm run verify # 自检：素材 / helper / 模块 / 握手 / 状态归约
npm test # Node 单测（含真实 DSH 设置服务的集成用例）
npm run probe # 不经 DSH，直接驱动宠物跑一遍状态与动作（肉眼验收）
npm test 里那几条集成用例要拿真的 schemastery / dsh-settings 跑（假实现测不出设置页
认不认我们的 schema）。桌面端把 DSH 装在 app.asar 里、$DSH_HOME 下没有这些包，所以先解一份：
DSH_ASSISTANT_DSH_PACKAGES=$(npm run -s dsh:packages) npm test
解出来的那份放在 $DSH_HOME/cache/dsh-packages/<DSH 版本>/，同一个版本只会解一次。
外观与互动
设置里的「DSH小助手」一页就是全部开关：
| 设置 | 默认 | 说明 |
|---|
enabled | 开 | 关闭后立即收起桌面窗口 |
scale | 0.4 | 0.15 – 2.0，1 = 原始尺寸；右键菜单有 40% / 55% / 70% / 100% 四挡 |
bubbleEnabled | 开 | 是否显示气泡 |
bubbleTheme | light | 浅色气泡配黑字，深色配白字 |
reducedMotion | 关 | 减少动效 |
soundEnabled | 关 | 完成 / 出错时响一声 |
includeSubagents | 关 | 允许子 Agent 抢占宠物状态 |
backgroundSummary | 关 | 任务后台总结（见下） |
autoInteract | 开 | 自己找点事做：状态停留够久就随机来一次互动 |
autoInteractSeconds | 10 | 上面那件事的判定间隔（5 – 300 秒），每隔这么久掷一次 30% 的骰子 |
宠物可以直接拖着走：位置记在本机（$DSH_HOME/dsh-assistant/layout.json），上面这些偏好
交给 DSH 存 —— 0.2 起写在 profile 补丁里（$DSH_HOME/profiles/<profile>/cordis.patch.yml
的 dsh-assistant 段），重启也在；0.1 那代写 settings.yaml。
自己找点事做：任意状态连续维持一个间隔（默认 10 秒），就有 30% 概率随机来一次
投喂点心 / 夸夸它 / 摸摸头；浮层还在播的时候不打扰你。嫌闹就把间隔调大，或者直接关掉。
右键菜单：投喂点心 / 戳一下 / 夸夸它 / 摸摸头 / 回到原位 / 今天干了什么。
左键点身体也会摸头，四个互动动作在菜单、点击、设置面板三处是同一套。
今天干了什么
右键宠物 →「今天干了什么」（或设置面板里的「生成日报」）：回顾当天的会话，产出一份
「今天做了什么 + 待办」的 markdown —— 按项目聚合，长度有硬性上限，写不下就自动重写一轮。
生成完在宠物上方弹一条通知，点一下打开弹窗；弹窗里有「复制 Markdown」按钮，
复制的是原文，不是渲染结果。
生成日报用的会话是隐藏会话：不会出现在左侧列表里，也不会弹系统通知。
打开设置里的「任务后台总结」后，它改成边干活边攒：会话每次压缩时先在后台提炼一段
已完成的内容存着，点日报时只补增量、再汇总 —— 不用等到晚上才有一份完整回顾。
这个开关默认关（关着 = 每次把今天所有会话重新读一遍）。所以关着的时候，弹窗底部
会多一行提示，告诉你在哪儿打开它；打开后这行就不出现了。提示只在窗口里，不进正文 ——
「复制 Markdown」拿到的始终是干净的日报。
今日总结弹窗
参考与致谢
这个项目的两半（画面与状态）都站在别人的成果上。没有下面这两个仓库，
就不会有现在的 dsh-assistant —— 特此致谢。
MIT License · Copyright © 2026 Sutera-Diffusus
DeepSeek Harness 桌宠插件：元气鲸鱼娘陪你写代码
本项目默认的 88 段角色素材全部来自这个仓库。上游是静态姿态图，我们做了三件加工：
统一高度（切状态时角色大小不跳）、按显示尺寸烘焙成 WebP、其中一部分用百炼图生视频
生成微动作再抠像对齐成序列帧。
加工不改变上游的许可与署名要求：角色形象版权仍归原作者，本项目只以 MIT 分发代码与
加工后的素材。想换成自己的角色：把图丢进一个目录，改 scripts/build_pack.py 顶部的
STATE_ASSETS / ACTION_ASSETS，重跑 npm run build:pack —— 宿主与原生端都不用改。
MIT License · Copyright © 2026 QCYTSN
「原生透明面板 + stdio JSON 协议 + 会话事件归约」这条路线，是这个仓库用生产代码先跑通的。
我们照着它做，省掉了"原生方案在 DSH 里到底行不行"那一段最贵的试错；之后在帧内存、
VoiceOver 可访问性、僵尸进程与布局持久化上各自做了加固。
其它
- 素材生成依赖 阿里云百炼（图生视频模型），管线脚本在
scripts/；
- 配色与排版参考了 DSH 自身的界面规范（深/浅两套气泡配色）。
完整署名与许可见 THIRD_PARTY_NOTICES.md。
已知边界
- 平台：原生 helper 目前只有 macOS（AppKit）。Windows/Linux 要么重写面板层，
要么退回 Electron 子窗口方案（会失去「全屏应用之上」这一条）。
- 分发：.app 是 ad-hoc 签名。别人从浏览器下载会被 Gatekeeper 拦，正式分发需要
Developer ID + 公证。
- 素材体积：
assets/pack 约 46MB（88 段 × 30 帧）；assets/motion 另有几百 MB
的源 MP4，已加进 .gitignore。
- 素材来源：默认取自 dsh-whale-musume
（MIT, © 2026 Sutera-Diffusus，见参考与致谢）。想换角色：
把图丢进一个目录、改
scripts/build_pack.py 顶部的 STATE_ASSETS / ACTION_ASSETS，
重跑 npm run build:pack 即可，宿主与原生端都不用改。
