dsh-assistant
DSH小助手：原生 Swift 悬浮窗负责展示与交互，宿主插件负责把它接到 DSH 会话状态（含今日工作总结）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-assistant@0.2.2Assistant 以 dsh-assistant 发布，当前版本为 0.2.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
住在桌面上、由 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 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/；完整署名与许可见 THIRD_PARTY_NOTICES.md。
assets/pack 约 46MB（88 段 × 30 帧）；assets/motion 另有几百 MB
的源 MP4，已加进 .gitignore。scripts/build_pack.py 顶部的 STATE_ASSETS / ACTION_ASSETS，
重跑 npm run build:pack 即可，宿主与原生端都不用改。