在使用 DeepSeek Harness 進行智能體開發時，開發者往往需要時刻關注會話的狀態流轉與耗時。本插件通過一個本地運行的“狀態寵物”提供可視化反饋，並附帶了番茄鍾功能，輔助管理開發節奏。
插件定位與核心價值¶
MoonPet 是一個運行在 DeepSeek Harness 環境中的本地插件，由用戶 Femad-6 維護。它不進行模型調用，不處理工具審批，僅通過觀察 Harness 的會話事件，通過立繪動畫和狀態標籤展示當前情況。
插件採用 MIT 許可證，支持本地運行，不上傳聊天記錄，所有數據處理均在本地完成。
核心功能¶
插件提供以下功能：
- 狀態寵物聯動：根據回合開始、思考、工具執行、等待審批等事件切換立繪與動作（如待機、思考、招手提醒）。
- 番茄鍾：默認工作 25 分鐘、休息 5 分鐘，支持計時、暫停、結束，到期彈出提醒並響鈴（Windows 下由隱藏的 PowerShell 播放）。
- 多語言字幕與語音：提供中英文勵志語音及字幕，支持獨立選擇發音語言。
- 資源監控：顯示餘額、Token 和估算花費，需在 Harness 中配置 DeepSeek 憑據。
- 自定義角色：支持用戶導入自定義角色包，覆蓋內置角色。
安裝與啓用¶
安裝前請確保已安裝 DeepSeek Harness Desktop 或 Web，且環境符合 Node.js 要求（^22.19.0 || >=24.0.0）。
方式一：通過命令行安裝¶
在 Harness 的 CLI 中執行以下命令：
dsh plugin --profile desktop add dsh-moonpet@0.1.2
Web 用戶請使用 --profile web。
方式二：通過插件市場¶
在支持 npm 插件發現的市場中搜索 dsh-moonpet，確認版本爲 0.1.2 或更新版本，安裝並啓用。安裝成功後需完全退出應用再重新打開，以便加載插件。
方式三：本地安裝包¶
下載 dsh-moonpet-0.1.2.tgz 或從 GitHub Releases 下載，在插件添加框中填寫絕對路徑。
配置與自定義¶
自定義角色包¶
用戶可以將自定義角色包放入以下目錄：
~/.dsh/dsh-moonpet/packs/my-character/
├── sprites/ # 立繪圖片
├── voices/ # 音頻文件
├── pack.json # 包名與默認立繪
└── pet.json # 狀態與文件名的映射
在設置中啓用該角色包後，同名包會覆蓋內置角色。
添加多語言語音¶
插件支持可選的中文/英文勵志語音。下載 moonpet-multilingual-voices.zip，解壓後將 english-boost 和 chinese-boost 兩個目錄複製到 ~/.dsh/dsh-moonpet/packs/，刷新頁面並在「字幕與資源 → 語音包」中選擇。
使用注意事項¶
- 兼容性：建議在啓用 MoonPet 時關閉舊版
dsh-gal插件，避免兩個掛件同時出現。 - 隱私與邊界：狀態寵物僅觀察 Harness 已加載的聊天事件，不上傳聊天內容，不新增模型調用，不修改審批結果。
- 餘額功能：餘額功能需使用 Harness 中的 DeepSeek 憑據，花費依據內置歷史費率估算，可自行覆蓋，不替代供應商賬單。
- 番茄鍾限制：番茄鍾提醒音在 Windows 下由隱藏窗口播放，正常退出應用會暫停計時；異常退出可能丟失最後 30 秒未落盤的數據。
