前言¶
DeepSeek Harness (DSH) 的插件生态强调「一切皆插件」。除了功能性工具外，开发者在长时间编码时往往需要一些视觉陪伴或反馈。mypet 插件为 DSH 桌面端提供了一个 Tamagotchi 风格的电子宠物。它不仅是屏幕上的一个图标，更具备呼吸浮动、自动眨眼、尾巴摇摆等活体动画，并能根据时段、天气和宠物状态改变环境氛围。
插件信息¶
- 名称：mypet
- 作者：qiqikuaidianpao
- 分类：趣味换装
- 许可证：MIT
核心功能¶
活体动画¶
宠物具备呼吸浮动、自动眨眼、尾巴摇摆等动画。点击宠物会有回弹效果，悬停时会做出笑脸。闲时宠物会闲逛踱步，睡着时会做梦。时段氛围光和天气粒子会随时间变化，例如清晨橙、白天蓝、夜晚蓝以及雨滴或雪花效果。
面板系统¶
插件提供四标签页面板：
- 状态：显示心情、体力、饱腹、牵绊四维进度条，包含趋势走势线、抚摸/喂食/小憩/玩耍按钮及每日任务。
- 衣橱：提供皮肤更换，包含 24 种皮肤（6 普通 / 9 稀有 / 9 传说）及稀有度筛选。
- 成就：展示 26 个里程碑、进度条、事件日志及近 7 天周报。
- 更多：包含接球小游戏、单抽/十连抽、改名、分享、换性格、转生及存档导入导出。
经济与牵绊¶
- 经济系统：通过工作发薪、连击递增奖金（5~25/轮）、每日签到、每周津贴、随机宝箱、每日任务和转生永久加成积累金币。
- 牵绊系统：互动累积好感度。好感度达到阈值可解锁暴击效果和主动冒险带回金币的能力。
音效与庆祝¶
内置 12 种 Web Audio 合成音效。在升级、稀有掉落或完成里程碑时，会触发 Canvas 粒子彩带雨、环形冲击波、emoji 粒子或金色仪式横幅。
其他特性¶
- 离线归来结算：断开连接后返回时会结算离线进度和报告。
- 快捷键：支持 1-4 / P / F / N / L / D / Esc 等快捷键操作。
- 持久化：面板位置可持久化保存，支持分享状态卡片。
- 性格与节律：包含 6 种性格和昼夜节律。
安装与启用¶
使用官方插件管理命令进行安装。
dsh plugin --profile web add mypet
安装后重启 DSH Web，屏幕上会出现悬浮宠物，可拖拽。
更新与卸载¶
dsh plugin --profile web update mypet
dsh plugin --profile web remove mypet
自定义与开发¶
插件采用模块化开发。修改源码前需注意：
npm run build
修改 src/client.js 后运行上述命令进行打包。lib/client.js 是构建产物，不可手动修改。
自定义配置项¶
在源码中可调整：
- SKINS：皮肤目录（名称 + emoji + 稀有度）
- TRAITS：性格（6 种）
- DRAW_COST / SALARY_PER_TICK / PITY_CAP：经济参数
- ACH：成就定义
- QUESTS：每日任务
- tick()：衰减速度
- MOUNT：面板挂载方式（"overlay" 悬浮 或 "sidebar" 侧边栏）
数据与注意事项¶
- 存档位置：宠物状态存储在浏览器的
localStorage中，key 为mypet，旧版兼容 key 为dsh-pet:v1。 - 导出码：面板内的「更多」标签支持导出/导入存档码，导出码仅包含游戏数据（金币/皮肤/成就/性格等），不含历史走势和事件日志。
- 依赖项：项目依赖
react和@deepseek-ai/dsh-client-runtime。
适用场景¶
适合希望在编码过程中获得视觉陪伴、喜欢电子宠物养成或希望为 DSH 体验增加趣味性的开发者。
