v0.3.0 — 把你的皮肤变成能给人看的东西

一套从照片生成的皮肤，此前只存在于生成它的那台机器上——除了录屏，没有办法给别人看。这一版把它变成一张图。

新增

--skin-sheet <id> — 把一套皮肤的六个状态拼成一张图，写到 skin-<id>.png。

~/.dsh/profiles/web/node_modules/deepseek-desk-pet/bin/dsh-desk-pet --skin-sheet mycat

内置皮肤和你自己装的皮肤一样画得出来。它在实例守卫之前处理——想要这张图的时刻，通常宠物还开着。纯标准库，和帧管线其余部分一致：零依赖的意义就是它能在生成皮肤的那台机器上直接跑。

皮肤画廊 — 投稿只交那一张预览图，你的十八张帧素材留在自己机器上。

右键菜单多了「Project on GitHub」 — 挨着检查更新。装插件的人是敲 dsh plugin add 装的，整个过程不经过仓库页面，宠物在桌面上跑着却没有任何一处指回它从哪来。这一项就是那条路。

文档

• README 改成中文为默认，英文移到 README_EN.md
• 每套皮肤都有了预览条与动图。动图按 manifest.json 的真实时间轴播放：空闲是 2.4 秒静止 + 一次几十毫秒的眨眼，三帧均分看起来是抽搐不是呼吸
• 状态机图，数字取自代码常量（HAPPY_MS=3200、SLEEP_AFTER_MS=90s）

修复

测试套件此前会读开发者真实 home 里的 ~/.dsh-desk-pet/skins/——任何人一用自定义皮肤功能，自己跑测试就会变红。已隔离。

---

升级要带 @latest（caret 作用在 0.x 上会锁住次版本号）：

dsh plugin --profile web add deepseek-desk-pet@latest

v0.2.0 — 原生菜单与自定义皮肤

右键不再是循环换皮肤，而是一个原生菜单；以及，你可以用一张图做自己的皮肤。

原生右键菜单

免打扰、会话清单、皮肤子菜单、菜单栏与 Dock 显隐、检查更新、退出。用 NSMenu + popUpContextMenu: 实现——全指针参数，绕开了 arm64 上结构体按值传递的编码坑（那个坑此前弄死过 hitTest:）。

一张图做一套皮肤

插件自带 dsh-pet-skin skill，把一张图扩写成一套皮肤需要的十八个姿势（六个状态 × 三帧），用你自己的画图工具、你自己的额度生成，我们不往任何地方发送东西。皮肤装在 ~/.dsh-desk-pet/skins/，在安装包之外，升级插件不会删掉它们。

skill 中途会停两次：第一次在基准姿势之后，让你在多花十七张之前先决定；第二次在第二帧之后，确认角色重画之后还是同一个。

帧管线改成纯标准库

PNG 解码、抠图、缩放全部标准库实现，不再需要 ffmpeg——这才让「在用户自己机器上装皮肤」这条路存在。

261 个测试 + 一个逐像素素材闸。

升级要带 @latest：caret 作用在 0.x 上会锁住次版本号，^0.1.0 永远不接受 0.2.0。

这个 tag 是事后补的，锚点按 npm 上 0.2.0 的发布时间（2026-08-18T05:54Z）回推到当时的 HEAD。

v0.1.0 — 第一版

第一版。一只浮在所有窗口之上（包括全屏 Space）的 macOS 桌宠，跟着本地 DSH 在干活、等你确认、跑完、报错之间换表情。

• 六个状态自动跟随本地 DSH：空闲、干活、等你确认、报错、刚跑完、打盹
• 打盹要两个时钟同时安静：agent 没事干，并且你的鼠标也不动了
• 点一下展开会话清单；拖到哪停在哪，重启还在原地
• 五套皮肤，每套六个状态各三帧
• 零依赖：跑系统自带的 /usr/bin/python3，靠标准库 ctypes 直接调 AppKit
• 跟着 dsh web 自动起停

145 个测试。

dsh plugin --profile web add deepseek-desk-pet

这个 tag 是事后补的：当时发 npm 没有打 tag，锚点按 npm 上 0.1.0 的发布时间（2026-08-17T14:40Z）回推到当时的 HEAD。