前言¶
在 DeepSeek Harness（DSH）里跑桌面宠物，通常要先装 dsh-pet 宿主，再自己找透明通道动画、写 maodie-config.json，路径还得符合宿主只扫描 pet/ 下一层的规则。素材一多，升级时又怕覆盖本地改过的配置。下面介绍维护者 Edwardpch 的 maodie-pet：一套基于 AI 视频生成的橘猫「耄耋」桌宠素材，以及带 hash 校验的安装与抠像导入工具链，分类上属于社区目录里的「趣味换装」。
这是什么¶
maodie-pet 是 DSH 插件（package.json 中声明 dsh.bundle，宿主侧逻辑在 lib/index.js）。它把 pets/maodie/ 下的配置与 VP9-alpha、512×512、12fps 的 webm 动作，安装到 ~/.dsh/dsh-pet/pet/ 的扁平位置（maodie-config.json 与 maodie-animation/*.webm），供已安装的 dsh-pet 加载。仓库当前版本 0.3.10，代码与素材为 MIT 许可；GitHub 仓库：Edwardpch/maodie-pet，社区目录页：skillhub 插件页。
README 写明素材包含 32 个动作（待机体系含长循环与 22 条小动作轮播、走路、点击回应、生气类等），并附带作者自用的 DSH 插件清单（dsh-plugins-share.md / .json）以及「绿幕视频 → 透明桌宠动画」的脚本与文档。
核心功能¶
桌宠素材与配置¶
- 动作文件为带透明通道的 webm，统一 512×512、12fps。
maodie-config.json中动作挂在animations.categories（不是animations顶层键）；clicks、events.whisper、events.workStatus等字段控制点击与事件触发。- 插件加载时仅负责把包内素材按规则复制到 dsh-pet 的
pet/目录；必须先安装 dsh-pet 本体（插件市场搜dsh-pet）。
安装器与升级策略¶
安装器通过 .maodie-manifest.json 记录各文件 sha256，每次做磁盘现状 / 包内新版 / 上次安装基线的三方比较：未改动的文件随包更新并备份旧文件；你改过的配置与素材默认保留；你删掉的文件不会自动复活（可用 --restore）。maodie-config.json 会保留你的顺序与自定义字段，仅追加包内新增动作。
命令行入口为 tools/cli.mjs，支持 --dry-run、--restore、--force、--prune、--rollback 等（装成插件后也可通过 node node_modules/maodie-pet/tools/cli.mjs 调用）。
右键菜单：固定 / 恢复走动¶
安装后，桌宠右键「更多 → maodie-pet」可切换 fixedEnabled：固定后只做待机与分类动作，不再走动；改的是生效路径 ~/.dsh/dsh-pet/pet/maodie-config.json，也可手动编辑后「重载配置」。
自制动作工具链¶
文档与脚本覆盖：提示词 → 绿幕图生视频 → 色相抠图 → 体检 → 登记。
tools/maodie-matte.py：灰绿/绿幕抠成 VP9-alpha webm。tools/maodie-check.py：检查尺寸、fps、alpha、绿边、循环接缝。tools/maodie-import.mjs：批量转码并--register写入 config。docs/maodie-prompts-cat.md等提供生成用提示词与参考拆解。
依赖：ffmpeg（含 libvpx-vp9）、Python 3 + numpy + Pillow、Node.js 18+（导入脚本需要）。
dsh-pet 切换闪烁¶
README 说明 dsh-pet 双 <video> 切换可能导致透明窗口下发白或空白帧；插件加载时会幂等应用 tools/patch-dsh-pet-fade.mjs 对前端 bundle 的「硬切 + 旧帧垫底」补丁，一般无需手跑。
安装与启用¶
- 安装 DSH 桌面端，并在插件市场安装 dsh-pet。
- 添加本插件（推荐）：
dsh plugin add https://github.com/Edwardpch/maodie-pet
也可在插件市场「发现」页搜索 maodie。插件安装时会自动运行与 node tools/cli.mjs 等价的安装逻辑。
- 刷新 DSH 页面。默认
display: desktop；若要在网页内显示，将pet/maodie-config.json的display改为web或both后重载配置。
安全说明：插件以当前 DSH 进程权限运行，安装前请自行查阅仓库源码与 MIT 许可证，确认可接受后再装。
典型用法¶
查看升级将发生什么（不写盘）¶
在仓库或已安装插件目录下：
node tools/cli.mjs --dry-run
从绿幕视频做一条动作并登记¶
python tools/maodie-matte.py 输入.mp4 输出.webm
python tools/maodie-check.py pets/maodie/maodie-animation
node tools/maodie-import.mjs ./我的视频 --register --category 小动作
登记时注意 categories 结构示例：
"categories": [
{ "id": "小动作", "weight": 20, "actions": ["睡觉", "舔毛"] },
{ "id": "生气", "weight": 10, "actions": ["哈气"] }
]
改完后在桌面端对宠物右键「重载配置」或刷新页面。
手动拷贝（不用插件安装器时）¶
将 pets/maodie 内容复制到 %USERPROFILE%/.dsh/dsh-pet/pet/，得到扁平路径 pet/maodie-config.json 与 pet/maodie-animation/*.webm，不要放进 pet/maodie/ 子目录（dsh-pet 不递归扫描）。
适用场景与注意¶
- 适合：已在 DSH 使用 dsh-pet、想要现成橘猫透明动画，或打算按仓库工具链扩展自家动作的开发者。
- 不适合：未装 dsh-pet 的环境；期望官方 DeepSeek / 幻方内置桌宠（本插件属社区生态，目录站 skillhub 与官方无从属关系）。
- 已知限制（README）：部分动作里 AI 生成的道具本身半透明；个别动作循环接缝略明显；各片段猫占比可能不一致。Windows 下含中文文件名的删除/递归复制有 Node 已知问题，安装器因此采用逐文件复制与 rename 备份策略。
自定义 DSH_HOME 时，CLI 需加 --home 指向对应 .dsh 目录。
结尾¶
maodie-pet 把 32 个 VP9-alpha 橘猫动作、可保留本地改动的增量安装，以及 抠像与导入工具链 收在一个 DSH 插件里，降低在 dsh-pet 上落地桌宠的门槛。进一步了解可打开 社区目录页 与 GitHub 仓库 阅读完整 README 与 docs/ 下的提示词文档。
