前言¶
在 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/ 下的提示詞文檔。
