maodie-pet

耄耋（maodie）· 橘猫桌宠 + DSH 插件清单

一只用 AI 视频生成的橘猫桌宠，跑在 DeepSeek Harness 的 dsh-pet 插件上：32 个动作、带透明通道的 VP9-alpha webm、512×512 / 12fps。

顺带附上一份我在用的 DSH 插件清单，以及把「绿幕视频 → 透明桌宠动画」的整条工具链。

里面有什么

路径	内容
pets/maodie/	桌宠素材包：maodie-config.json + 32 个动作 webm
lib/index.js	插件宿主半侧：安装器本体（三方合并 + hash 校验 + 备份/回滚）
lib/merge.mjs / lib/manifest.mjs / lib/pet-schema.mjs	配置三方合并、安装清单与文件判定、路径与动作名约定
tools/cli.mjs	安装器命令行：--dry-run / --restore / --force / --prune / --rollback
tools/make-manifest.mjs	生成并校验 .maodie-manifest.json
test/run.mjs	升级策略的回归测试（12 项）；node tools/_runner.mjs test/run.mjs 跑
package.json / cordis.patch.yml	插件清单：dsh.bundle.patch 指向挂载行
docs/preview.png	32 个动作的总览图（每格取该动作的第 0.6 秒）
docs/maodie-prompts-cat.md	20 条猫动作的视频生成提示词（绿幕、10 秒、首尾同姿态）
docs/橘猫后续动作提示词.docx	其中 08–20 共 13 条的 Word 版，方便直接发给生成工具
docs/竖中指参考视频拆解.md	「竖中指」梗图参考视频的逐秒拆解 + 绿幕改写版提示词
tools/maodie-matte.py	按色相抠图：把豆包/即梦的灰绿影棚背景抠成 alpha
tools/maodie-check.py	体检：尺寸、fps、alpha 通道、绿边残留、循环接缝
tools/maodie-import.mjs / .cmd	批量转码 + 自动登记到 config
tools/maodie-ref.png	白底参考图，用图生视频时当首帧参考
dsh-plugins-share.md / .json	我在用的 12 个 DSH 插件、装法、避坑

32 个动作

• 待机 / 移动：待机（10 秒长循环；animations.idle 里实际挂了 23 条——基础待机 + 22 条小动作，空闲时轮播）、走路
• 点击回应：开心、被摸、我真的特别爱你、笑
• 小动作（22）：睡觉、开心、被摸、舔毛、踩奶、追尾巴、揣手手、打哈欠伸懒腰、东张西望、扒拉杯子、钻进纸箱、打滚晒太阳、抓激光笔、偷吃被抓住、蹭头撒娇、洗脸、扑蝴蝶、看鸟、踩键盘、伸爪拍屏幕、翻肚皮、小猫抖毛
• 生气（6）：哈气、炸毛、飞机耳、耄耋哆嗦毛、竖中指、喷火

安装

方式一：当插件装（推荐）

本仓库同时是一个 DSH 插件（package.json 里声明了 dsh.bundle，lib/index.js 是宿主半侧）。装上它，素材会自动就位：

dsh plugin add https://github.com/Edwardpch/maodie-pet

或者在插件市场的「发现」页搜 maodie。插件加载时做且只做一件事：把 pets/maodie 复制到 %USERPROFILE%/.dsh/dsh-pet/pet/maodie/。

前提仍然是先装 dsh-pet 本体（市场里搜 dsh-pet）。

升级：拉新动作不用手动拷文件

pets/maodie/.maodie-manifest.json 里记着每个素材的 sha256，安装器每次运行都做三方比较（磁盘现状 / 包内新版本 / 上次安装时的基线），再决定每个文件怎么办：

你的文件状态	新版包	结果
和上次装的一样（没动过）	变了	用新版覆盖，旧文件进备份目录
你改过 / 替换过	变了	保留你的，不覆盖
你删掉了	包里还有	不复活（想要就 --restore）
你改过	新版删掉了	保留，不删
你没动过	新版删掉了	挪进备份目录（--prune 时才生效）

maodie-config.json 同理：你加的动作、你的顺序、你改过的非动画字段（size、display、触发事件……）都保留，只把新版包里新增的动作追加进去；新分类按你的顺序插在后面。

# 查看这次会发生什么（不写盘）
node tools/cli.mjs --dry-run

# 升级 / 补齐（插件安装时自动跑的就是这个）
node tools/cli.mjs

# 补回你手动删掉的动作
node tools/cli.mjs --restore

# 连你改过的文件也强制按包覆盖
node tools/cli.mjs --force

# 清掉新版已移除的素材（挪进备份，不真删）
node tools/cli.mjs --prune

# 后悔了，还原上一次升级前的文件
node tools/cli.mjs --rollback

装成插件后也可以用 node node_modules/maodie-pet/tools/cli.mjs ...；自定义了 DSH_HOME 就加 --home D:\somewhere\.dsh。

每次真正写盘前，被覆盖/移除的文件都会先复制到 $DSH_HOME/dsh-pet/pet/.maodie-pet-backup/<时间戳>/，这就是 --rollback 的来源。

方式二：手动拷贝

1. 装 DeepSeek Harness 桌面端，并在插件市场里装 dsh-pet。

2. 把 pets/maodie 整个复制到：

   %USERPROFILE%/.dsh/dsh-pet/pet/
   

   也就是最终得到 ~/.dsh/dsh-pet/pet/maodie/maodie-config.json 和 maodie-animation/*.webm。

3. 刷新页面。默认是桌面宠物（display: desktop）；想在网页里显示，把 maodie-config.json 里的 display 改成 web 或 both。

只想换掉某几个动作？直接往 maodie-animation/ 里加同名 webm，再在 animations 里登记即可——规则见下。

自己做动作

整条链路是：提示词 → 图生视频（绿幕）→ 按色相抠图 → 体检 → 登记。

# 1. 抠图：绿幕/灰绿影棚视频 → 512×512、12fps、VP9-alpha
python tools/maodie-matte.py 输入.mp4 输出.webm

# 可选参数
#   --ss 1.0 --to 6.0        截取片段
#   --fit                    保持整只猫入画，两侧用透明补齐
#   --erase 0,0,512,26       把某个矩形区域的 alpha 清零（去水印）
#   --hi 205 --ramp 8        背景色相带上界/过渡宽度（青绿背景会用到）

# 2. 体检
python tools/maodie-check.py pets/maodie/maodie-animation

# 3. 批量导入 + 自动登记（需要 ffmpeg、python、node）
node tools/maodie-import.mjs ./我的视频 --register --category 小动作

写 config 的坑

动作挂在 animations.categories 里，不是 animations 的顶层键：

"categories": [
  { "id": "小动作", "weight": 20, "actions": ["睡觉", "舔毛"] },
  { "id": "生气",   "weight": 10, "actions": ["哈气"] }
]

另外 clicks 是点击宠物时播的，events.whisper / events.workStatus 分别对应「悄悄话」和「工作状态」触发。改完刷新页面（桌面端右键宠物 →「重载配置」）。

已知问题

• 道具会半透明：踩键盘、扒拉杯子、钻进纸箱 里的键盘/杯子/纸箱在源视频里本身就是半透明生成的，抠图只是如实保留，不是抠像失败。
• 首尾接缝：打哈欠伸懒腰 的首尾帧差 12.9（其余多在 4–7），循环播放时可能有轻微跳变。
• 猫的大小不统一：各片段是独立生成的，猫在画面里的占比略有差别；介意的话可以按不透明像素包围盒统一缩放后再贴底。
• Windows + 中文文件名：本机实测，用 Node 的 fs.rm / fs.rmSync 删除含中文（非 ASCII）文件名的文件会让进程直接退出（退出码 3221226505 / 0xC0000409，没有异常可捕获），fs.cpSync 递归复制同类文件也一样。所以安装器从不用 rm/cp 递归：复制走 copyFileSync 逐文件，--prune 走 renameSync 挪进备份目录。测试脚本里"模拟用户删文件"也用 renameSync 而不是删。

工具链依赖

• ffmpeg（需要 libvpx-vp9；读 alpha 时把 -c:v libvpx-vp9 放在 -i 之前）
• Python 3 + numpy + Pillow
• Node.js 18+（只有 maodie-import.mjs 用到）

致谢与许可

• 桌宠运行时：dsh-pet（动作提示词库也来自这个仓库的 prompts/）
• 素材由 AI 视频模型生成，再经本项目脚本抠像、裁切、转码
• 代码与素材以 MIT 许可发布；如果要用在自己的项目里，保留出处即可