dsh-pet-studio
Manifest validTurn a photo into a Q-style DSH pet: local cutout, a dsh-pet pack, and a seven-clip animation set, with built-in pets untouched. Its HTTP routes have no DSH access check, so a web page open in your br
dsh-pet-studio
把一张照片或 Q 版立绘变成 dsh-pet 能直接用的宠物包:本地抠图 → 512 头像 → 人设 → 自动登记实例。内置宠物照常可用——本插件不接管 dsh-pet 的渲染,只是往它的用户目录写宠物包。
能力
| 能力 | 说明 |
|---|---|
| 本地抠图 | 浏览器 canvas 四边泛洪填充去背景,图片不上传任何第三方 |
| 头像 | 自动裁到主体外接框、居中缩成 512×512 PNG |
| 人设 | 可自定义;留空用默认「说人话、短句、不说自己是 AI」 |
| 实例登记 | 写进 ~/.dsh/dsh-pet/main-config.jsonc 的 pets[](幂等,写前 .bak) |
| 整套动作 | 用 sharp 逐帧变换 + ffmpeg 编码 VP9(alpha),生成 7 段动作并写入宠物包 |
| 内置宠物 | 完全不受影响,继续用它自己的动画与配置 |
生成的 7 段动作
| 文件 | 用在 |
|---|---|
idle.webm | 待机呼吸、余额事件、随机小动作 |
walk.webm | 移动、工作状态(忙碌) |
turn.webm | 转向 |
drag.webm | 被拖拽 |
click.webm | 点击回应、完成庆祝 |
sleep.webm | 睡觉(开始/循环/醒来) |
whisper.webm | 碎碎念、思考/等待气泡 |
宠物包的 animations 会被整体重写为这七段(idle / turn / drag / clicks / moves / categories / events / sleep),
所以 dsh-pet 的睡觉、碎碎念、工作状态、余额事件都会落到你自己的角色上。
耗时:本机(Intel Mac,i5 级)七段全量生成约 2.5 分钟;CPU 越好越快。生成期间设置页会停在「处理中」,完成后刷新页面即可看到新动作。
依赖:sharp(必需,npm 直接装)+ ffmpeg(任选其一:@ffmpeg-installer/ffmpeg 可选依赖、系统 ffmpeg、
或环境变量 FFMPEG_PATH / DSH_PET_STUDIO_FFMPEG)。两者缺一时宠物包仍会写入,只是不生成动作。
安装
dsh plugin --profile web add dsh-pet-studio
装完打开 设置 → 插件 → 宠物工坊(或插件页里的同名标签),选图 → 生成宠物包 → 刷新页面,在 设置 → 桌宠配置 → 种类 里选新宠物。
AI 生成 Q 版(可选)
插件不绑定任何图像厂商:任何 OpenAI 兼容 的 POST {baseUrl}/images/edits 都能用。
# cordis.patch.yml 里给本插件行的 config
- insert:
- id: pet-studio
name: dsh-pet-studio
config:
imageBaseUrl: 'https://api.openai.com/v1'
imageModel: 'gpt-image-1'
# imageApiKey: 'sk-...' # 也可以用环境变量
或用环境变量(推荐,避免明文写配置):PET_STUDIO_IMAGE_BASE_URL / PET_STUDIO_IMAGE_MODEL / PET_STUDIO_IMAGE_KEY。
没配置时「AI 生成 Q 版」按钮不会出现,只保留「导入现成图」这条路径——不会假装能用。
边界(v0.2)
- 动作是程序化生成的:七段循环由一张静态图变换而来(呼吸、摇摆、回弹、倾倒),不是 AI 逐动作生成的视频;胜在零额外成本、离线可用。
- 表情包目录(
pet/<id>-memes/)与memes映射宿主已支持写入,但本版 UI 还没做上传(下一步)。 - 抠图对「背景干净、主体完整」的图效果最好;复杂背景建议先自己抠好再用。
自测
宿主在跑、插件已装的情况下:
node test/smoke.mjs # 状态 + 建包 + 清理(约 1 秒)
node test/smoke.mjs --animate # 再跑一次完整七段动作生成(约 2–4 分钟)
发布
npm publish # 需要 npm 账号与 token
包名 dsh-pet-studio 若已被占用,改成自己的 scope,例如 @yourname/dsh-pet-studio,同时改 package.json 的 name 与 cordis.patch.yml 里的 name。
License
MIT
Comments
Loading…
Similar plugins
by AlannerFranklin
Turns an uploaded picture into a floating desk pet by cutting out its background in the page, with idle animation and a live account-balance bubble.
★ 3
MIT
JavaScript
Oct 20, 2026
dsh plugin --profile web add dsh-cutout-petby afeiaswell
A draggable Doubao or SD-chan mascot in the corner of the web shell, with a hover card showing today's image spend and the quota usage of both the Doubao desktop client and the Volcengine Ark plan; it
★ 0
MIT
JavaScript
Nov 18, 2026
dsh plugin --profile web add dsh-doubao-petA desktop pet in the DSH web GUI: floating, draggable sprite pet that animates with agent activity (thinking, idle, error, done, awaiting approval), with a settings page for size, switching, gallery s
★ 0
dsh plugin --profile web add @dsh-external/dsh-petdex-petmacOS desk pet forked from anneheartrecord/dsh-desk-pet, in a real always-on-top window that covers fullscreen Spaces: the pose follows whatever the local DSH is doing across six states, the right-cli
★ 0
dsh plugin --profile web add dsh-macos-petby MichengAI
An in-page pet for DSH Web with multi-session task notifications and controls to open tasks, stop turns, and respond to supported approval and question requests.
★ 9
↓ 3.5k/wk
Apache-2.0
TypeScript
Nov 19, 2026
dsh plugin --profile web add @michengai/dsh-codex-petA photo-real desk pet for the DSH window: four personas with five expression sprites each, whose dance, hair-flip and walk actions play as 24 fps VP9 alpha video clips; proactive lines with an optiona
★ 2
MIT
JavaScript
dsh plugin --profile web add dsh-pet-plugin