耄耋（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 的来源。
方式二：手动拷贝
- 装 DeepSeek Harness 桌面端，并在插件市场里装
dsh-pet。 - 把
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 许可发布；如果要用在自己的项目里，保留出处即可
