抠图桌宠 AlannerFranklin/dsh-cutout-pet

抠图桌宠 · Cutout Pet

把任意一张图片变成浮在 Harness Web UI 上的桌宠：在页面里直接抠掉背景，给人物加上贴纸描边和一点待机的小动作，头顶气泡实时显示当前 DeepSeek 账户余额。

功能

- 上传 → 抠图 → 变成桌宠。 在 Settings → Cutout Pet 里选一张 JPG/PNG。页面自带的 canvas 从边缘开始把背景泛洪抠掉，去掉零散的碎块（亮片、多余的水印笔画），羽化边缘，裁掉透明留白，再画一圈白色贴纸描边。
- 抠图可调。 背景容差滑块，外加一个开关：背景是照片或渐变时，保留整张图。
- 会动，但不是逐帧动画。 呼吸和摇摆以她的脚为支点，亮片在她周围飘，指针靠近时身体倾斜几个像素，拖动时也会倾斜。
- 跟随窗口。 位置按可用空间的比例存储，不按像素，所以窗口变大变小，桌宠都待在自己的角落。
- 余额气泡。 Host 端向已登录的 DeepSeek 账户查询钱包余额（CNY/USD，外加赠送钱包）。不需要 API key，页面里不放 token。
- 本地运行，安静。 图片不离开本机：在浏览器里解码、抠图，只有处理好的 PNG 写进 DSH 数据目录。

安装

从插件市场安装（上架后）：

dsh plugin --profile <profile> add dsh-cutout-pet

直接从本仓库安装：

dsh plugin --profile <profile> add github:AlannerFranklin/dsh-cutout-pet

或者在 Plugins 页面把文件夹作为 bundle 安装（Install from folder）。

安装完成后，打开 Settings → Cutout Pet，选一张图片，需要的话调整 Background tolerance，然后按 Use as pet。

工作原理

| 部分 | 职责 |
| client.js | 在 shell.overlay 里注册桌宠，在 settings.section 里注册设置页。在 canvas 里完成抠图：边缘颜色泛洪填充 → 主体轮廓过滤 → 3×3 alpha 羽化 → 裁剪 → 白色描边 → PNG data URL。 |
| index.js | 提供 /.dsh-pet/art.png（上传的图或内置默认图）、/.dsh-pet/state、/.dsh-pet/art（POST/DELETE）和 /.dsh-pet/balance。上传的图存到 <DSH_HOME>/plugin-data/dsh-cutout-pet/art.png。 |
| assets/default.png | 为本插件画的草莓占位图（MIT，与代码同协议）。 |

上传的图在写入前会校验是否为真正的 PNG 数据（签名、IHDR 尺寸、上限 3 MiB）。

限制

- 抠图用的是颜色键算法，不是分割模型。纯色或单色背景抠得干净；照片、渐变和杂乱场景需要关掉开关（整张图当桌宠），或者用外部编辑器处理。
- 余额来自 DeepSeek 账户钱包服务。如果配置档没有登录账户余额气泡会显示余额，而不是直接失败。
- 每个配置档一只桌宠：图片共享，位置按浏览器分别保存。

中文说明

功能

- 上传即抠图：在「设置 → 抠图桌宠」选一张 JPG/PNG。页面用画布从四边做背景泛洪，去掉背景与脱落的碎片（亮点、水印笔画），羽化边缘、裁掉透明边，再加一圈白描边。
- 可调：「去背强度」滑块控制背景容差；背景是照片/渐变时可以关掉去背，整张图当桌宠。
- 会动：以脚底为原点的呼吸与摇摆、身边漂浮的星光、朝鼠标轻轻倾斜、拖动时跟着倾斜。
- 跟着窗口走：位置按“可移动空间的比例”保存，窗口放大缩小时她会留在右下角，而不是停原地。
- 余额气泡：宿主半通过已登录的 DeepSeek 账户取钱包余额（含赠送），页面里没有任何密钥。
- 隐私：图片不会离开本机——抠图在浏览器里完成，只有处理好的 PNG 写到 DSH 数据目录。

安装：dsh plugin --profile <profile> add github:AlannerFranklin/dsh-cutout-pet，然后在「设置 → 抠图桌宠」上传图片、点「保存为桌宠」。

限制：抠图是颜色键算法而不是分割模型，纯色/简单背景效果最好；照片类背景建议关掉去背。

License

MIT © AlannerFranklin。默认的草莓吉祥物为本插件绘制，适用同一许可；上传的图片留在你的机器上，插件不会再次分发。