前言¶
在 DeepSeek Harness（DSH）里长时间开着 Web UI 做对话或调试时，界面往往只有功能面板，缺少一点「常驻在场」的视觉锚点。自己叠一层 HTML 浮窗可以，但要处理抠图、描边、跟随窗口缩放和账户信息展示，又要保证图片不出本机，工作量不小。
下面介绍社区插件 dsh-cutout-pet（维护者 AlannerFranklin，分类：趣味换装）：把任意 JPG/PNG 变成浮在 Harness 界面上的桌宠，在浏览器里本地抠背、白描边、待机动画，头顶气泡实时显示当前 DeepSeek 账户余额。插件以 MIT 许可发布，当前 GitHub 星标为 0。
这是什么¶
dsh-cutout-pet 是面向 DSH Web 前端的趣味换装类插件：上传图片后在页面内完成背景去除与描边，注册到 shell.overlay，并在设置页提供可调抠图参数。余额由宿主半通过已登录的 DeepSeek 账户钱包接口获取，页面内不放置 API Key 或 Token。
图片解码与抠图均在浏览器完成；仅处理后的 PNG 写入 DSH 数据目录，原图不上传远端。
核心功能¶
上传 → 抠图 → 桌宠¶
在 Settings → Cutout Pet（中文界面为「设置 → 抠图桌宠」）选择 JPG/PNG 后，客户端在 canvas 上执行：从四边按边框颜色泛洪去背、过滤主轮廓、去掉脱落碎片（亮点、水印笔画等）、3×3 alpha 羽化、裁透明边，再绘制白色贴纸描边，最后生成 PNG。
上传在写入前会校验真实 PNG（签名、IHDR 尺寸），单文件上限 3 MiB。
可调抠图¶
「Background tolerance」（去背强度）滑块控制背景容差。背景是照片或渐变时，可关闭去背开关，整张图作为桌宠使用。
待机动画（非精灵图）¶
以脚底为锚点的呼吸与摇摆、身边漂浮星光、朝指针轻微倾斜、拖动时倾斜，均为程序化动画，不依赖预烘焙精灵序列。
跟随窗口¶
位置按「可移动区域」的比例保存，而非固定像素；窗口放大缩小时，桌宠仍留在相对角落。
余额气泡¶
宿主半（index.js）向已登录 DeepSeek 账户请求钱包余额（CNY/USD 及赠送钱包）。未登录的 profile 下，气泡会说明状态而非报错。
本地与安静¶
抠图在浏览器内完成；成品 PNG 存于 <DSH_HOME>/plugin-data/dsh-cutout-pet/art.png。默认占位图为插件自带的草莓形象（MIT，与代码同许可）。
安装与启用¶
插件在 DSH 生态中通过 profile 安装；安装命令须与仓库 README 一致。package.json 要求 Node >=20。
从插件市场安装（上架后）：
dsh plugin --profile <profile> add dsh-cutout-pet
直接从 GitHub 仓库安装：
dsh plugin --profile <profile> add github:AlannerFranklin/dsh-cutout-pet
也可在 Plugins 页面使用 Install from folder 从本地文件夹安装 bundle。
安装后打开 Settings → Cutout Pet，选图、按需调整去背强度，点击 Use as pet（中文为「保存为桌宠」）。
典型用法¶
- 为当前 DSH profile 执行上述
dsh plugin ... add命令之一。 - 在 Harness Web UI 进入 Settings → Cutout Pet。
- 上传一张主体清晰、背景尽量纯色或简单的 PNG/JPG；若背景复杂，先关掉去背或在外部编辑器处理好再上传。
- 点击 Use as pet，在界面上拖动桌宠到合适位置；缩放浏览器窗口可确认比例定位是否符合预期。
- 已登录 DeepSeek 账户时，查看头顶气泡中的余额展示是否正常。
每个 profile 仅一只桌宠（美术资源共享）；位置按浏览器分别保存。
架构与数据流（简述）¶
| 半 | 职责 |
|---|---|
client.js |
在 shell.overlay 注册桌宠，在 settings.section 注册设置页；浏览器内完成抠图管线并提交 PNG。 |
index.js |
提供 /.dsh-pet/art.png、/.dsh-pet/state、/.dsh-pet/art（POST/DELETE）、/.dsh-pet/balance；持久化上传图。 |
适用场景与注意¶
适合：希望在 DSH Web UI 里有一个轻量、本地抠图的桌面宠物，并顺带看到账户余额的开发者或日常用户；纯色或简单背景的素材抠图效果最好。
限制（来自 README）：
- 抠图为颜色键算法，不是分割模型；照片、渐变、杂乱场景需关闭去背或使用外部编辑器。
- 余额依赖 DeepSeek 账户钱包服务；无登录账户时仅显示说明文字。
- 每个 profile 一只桌宠；位置 per browser。
安全与权限：DSH 插件以当前 dsh 进程权限运行。安装前请阅读 GitHub 仓库 源码与 MIT 许可证，确认符合你的环境策略。社区目录 SkillHub 插件页 与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。
结尾¶
dsh-cutout-pet 把「本地抠图 + 描边桌宠 + 账户余额气泡」收进一个 DSH 插件：上传在设置页完成，动画与窗口跟随由前端承担，敏感图片不离开本机。若你已在用 Harness Web UI，可按 README 安装到指定 profile，从一张图开始试。
