totoro-pet
龙猫桌宠插件：在 DSH 页面右下角常驻悬浮 Q 版龙猫，支持喂食、抚摸、玩耍、睡觉等互动养成系统。
AI 分析
核心用途是为 DSH 界面提供一个具有数值养成属性（饱食度、心情、等级）的龙猫桌宠。适合喜爱龙猫、追求趣味陪伴和轻度养成玩法的用户。
安装
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Lucasli2018/totoro-pet说明文档
阅读完整 README ↗totoro-pet · DSH Web GUI 桌宠插件
DSH Web GUI 桌宠插件（悬浮 Q 版龙猫 · 喂食/抚摸/玩耍/睡觉互动养成）。
一只栖居在回环端口里的 Q 版龙猫「绒绒」：白天帮你盯日志、踩构建，夜里蜷成毛球给 CPU 取暖。
totoro-pet 是一个 DeepSeek Harness Web GUI 悬浮桌宠插件：SVG 手绘 Q 版龙猫常驻页面右下角，支持喂食、抚摸、玩耍、睡觉四种互动养成（饱食/心情/精力三维状态 + 经验等级），拖拽换位、外观自定义、图鉴鉴赏一应俱全。零构建纯 JS 双半边架构（宿主 ESM + 浏览器 ModuleLoader factory），安装即用。
📖 完整教程：docs/使用手册.md ｜ API 契约：docs/API.md
✨ 特性亮点
- 四姿态 SVG 动画：待机呼吸眨眼、开心跳跃、睡觉 Zzz 上浮、进食咀嚼，切换不跳形
- 四种互动：🍎 喂食 / ✋ 抚摸 / 🎾 玩耍 / 💤 睡觉·唤醒，各有数值收益与小脾气（冷却、体力门槛）
- 养成系统：饱食/心情/精力随时间线性衰减（睡眠减半、精力回充），经验升级
level = floor(exp/50)+1 - 龙猫台词库：五类口吻台词各 9 条随机回复；断网时无缝降级为本地台词
- 个性化：拖拽换位记忆、大小 0.5×–2.0×、不透明度 30%–100%、闲置自动隐藏、一键停用（缩成小圆点）
- 图鉴弹卡：四姿态触发条件一览 + 龙猫小传
- 安全边界：HTTP API 仅回环 127.0.0.1 可达，请求体 64KB 上限，统一错误码
- 可靠持久化：状态落盘 tmp+rename 原子写，坏档自动降级默认值继续服务
- 零构建：浏览器半边单文件内嵌全部 SVG/CSS，无打包器、无第三方运行时依赖；宿主冒烟 18 项全绿
📦 安装（本地 tgz）
前置要求：Node.js ≥ 18，且能正常运行 dsh web（GUI 地址 http://127.0.0.1:3080）。
cd F:\dsh\totoro-pet
npm pack # 生成 totoro-pet-0.1.0.tgz（仓库已附带，可跳过）
dsh plugin --profile web add F:\dsh\totoro-pet\totoro-pet-0.1.0.tgz
然后重启 dsh web，刷新 http://127.0.0.1:3080 —— 页面右下角出现龙猫即安装成功。分步详解见《使用手册》第二章。
🚀 快速上手三步
- 装好插件并重启 dsh web，右下角找到龙猫「绒绒」；
- 鼠标悬停在它身上，浮现交互条（喂食/抚摸/玩耍/睡觉/图鉴/设置）；
- 点按钮互动：气泡冒出台词，顶部状态条实时反映三维数值与等级；按住本体可拖到屏幕任意角落。
🎮 玩法速览
| 动作 | 数值效果 | 经验 | 限制 |
|---|---|---|---|
| 🍎 喂食 feed | 饱食 +30 | +5 | 无 |
| ✋ 抚摸 pet | 心情 +10 | +2 | 冷却 10 秒 |
| 🎾 玩耍 play | 精力 −15、心情 +15 | +8 | 结算后精力 <15 拒绝 |
| 💤 睡觉 sleep | 入睡：精力 +12/时回充 | — | 幂等，重复无副作用 |
| ☀️ 唤醒 wake | 结束睡眠 | — | 幂等 |
| 👆 点击本体 | 扭一扭 + 闲聊一句 | — | — |
自然衰减（每小时）：清醒 饱食 −0.8 / 心情 −0.5 / 精力 −1.5；睡眠 减半 / 减半 / 精力 +12。关掉页面也在衰减哦。完整规则见《使用手册》第四章。
🔌 HTTP API 简表
Base URL：http://127.0.0.1:3080/api/totoro-pet（仅回环可达）。
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /state | 查询状态（先结算衰减） |
| POST | /interact | 交互 {"type":"feed|pet|play|sleep|wake"} |
| GET / POST | /config | 读取 / 部分更新配置 |
| POST | /reset | 状态归零（配置不动） |
统一包裹 {ok:true,...} / {ok:false,error:"..."}。权威契约与字段级细节见 docs/API.md，curl 示例见《使用手册》第七章。
📁 目录结构
totoro-pet/
├── package.json # 插件清单（双入口 exports + dsh 字段）
├── cordis.patch.yml # 宿主服务注册补丁
├── README.md # 英文占位指引（本文档的转发）
├── README.zh.md # 本文档
├── docs/
│ ├── 使用手册.md # ⭐ 面向终端用户的完整教程（九章 + FAQ）
│ ├── API.md # 宿主 ↔ 浏览器 API 权威契约
│ └── REVIEW.md # 集成验证审查报告（t5）
├── lib/
│ ├── index.js # 宿主半边：养成引擎 + 回环路由（仅 node: 内置模块）
│ └── client.js # 浏览器半边：悬浮桌宠 UI（单文件零构建，SVG/CSS 内嵌）
├── assets/
│ ├── svg/ # 四姿态 SVG 源稿 + pet.css + MANIFEST.md（内嵌前资产）
│ └── photos/ # 龙猫原型参考图
└── scripts/
└── smoke-host.mjs # 宿主半边冒烟测试（18 项断言）
npm 包内含 lib、docs、cordis.patch.yml 与 README（assets/scripts 仅存在于源仓库）。
📚 更多文档
- docs/使用手册.md —— 从安装到卸载的完整教程、数值详解、故障排查与 FAQ
- docs/API.md —— 接口字段级契约（改数值须三处同步的第一权威）
- docs/REVIEW.md —— 形态/契约/安全/功能四类核验记录
License
MIT © totoro-pet team