在使用 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 秒未落盘的数据。
