dsh-live2d-mao

Mao-pet · DSH 专用 Live2D 桌宠

把 DeepSeek Harness 的工作状态，变成一只住在你桌面上的 Live2D 看板娘。

她不是贴图，是会呼吸、会看你、会跟着 DSH 干活动起来的桌宠。

---

> 右下角就是她。你在 DSH 里敲需求，她在旁边 思考中 → 执行工具 → 完成，

> 头顶徽标实时告诉你「DSH 现在在干嘛」。

---

🎯 为什么选这只

市面上的桌宠大多停在「有个立绘在屏幕上飘」。这只的不同在于——它真的知道 DSH 在干什么。

| | 常见桌宠 | Mao-pet |

|---|---|---|

| 状态粒度 | 「思考 / 工作」两三态 | 12 态，细到「正在用哪个工具」 |

| 状态来源 | 定时器 / 假的循环 | DSH 真实事件（会话日志 + 插件事件），跟着轮次走 |

| 需要 API Key？ | 有的要填 key 才能用 | 完全不需要，只读本机日志，不碰云端 |

| 回复正文 | 塞进小气泡，几秒就被冲掉 | 独立流式横条：逐 token、可换行、可滚动看历史 |

| 拿到工具信息 | 一般不知道 | 气泡直接说「正在用 read 干活…」 |

| DSH 专属性 | 跨 Agent 通用，适配浅 | 只为 DSH 做，12 态、审批态、子会话都是 DSH 原生概念 |

装完不用配任何东西：DSH 跑起来 → 桌宠就开始跟着动。没有账号、没有 key、没有云端往返。

---

✨ 核心亮点

| | 能力 | 说明 |

|---|---|---|

| 🎭 | 真 · Live2D | PixiJS + Cubism 4 骨骼动画，不是 GIF/序列帧。待机呼吸、眨眼、视线跟随、动作表情全部实时驱动 |

| 🐳 | 8 款内置形象 | DSH 专用（大肥鱼、DeepSeek娘）+ Live2D 官方免费 6 款，开箱即用；也支持导入自己的模型 |

| 🎨 | 自定义动作与表情 | 每个模型可逐槽位绑定动作/表情（思考、观察、聆听、开心、害羞…），DSH 的工作状态会真实驱动它们 |

| 👀 | 视线跟随鼠标 | 她的眼睛一直跟着你的光标走，转头、侧目都是真的骨骼动画 |

| 📡 | DSH 工作状态实时显示 | 12 态语义总线：规划 / 思考中 / 执行工具 / 回复中 / 聆听中 / 说话中 / 待确认 / 完成 / 出错 / 暂停 / 待机 / 在线 |

| 💬 | 工具状态气泡 | 「正在用 read 干活…」——她亲口告诉你 DSH 正在调什么工具 |

| 📜 | 流式横条 | DSH 的回答逐字铺在一条可拖动、可拉伸、可换肤的横条上，单行滚动 / 多行可翻历史 |

| 🖱️ | 拖动交互反馈 | 拖拽带惯性滑行、按压有 Q 弹 + 音效，还能锁定位置、Shift 防误拖 |

| 🔊 | 7 类事件音效 | 按压 / 松开 / 切换 / 任务结束 / 提问 / 授权 / 异常，内置小黄鸭、Minecraft 经验球等原版音效，可逐事件换片段 |

| 🎚️ | 不透明度可调 | 10%~100% 任意调，摸鱼时让她淡一点 |

---

📸 功能展示

1️⃣ DSH 工作状态实时显示

她在 DSH 里干活时，桌宠头顶会实时显示当前阶段——这是同类桌宠里最细的粒度（多数只有「思考/工作」两态）。

执行工具中徽标「DSH · 思考中」+ 气泡「正在用 read 干活…」

完成徽标变绿「DSH · 完成」，一轮干完

完整 12 态（徽标颜色可在 DSH 面板逐项自定义）：

| 阶段 | 含义 | 桌宠表现 |

|---|---|---|

| planning | 规划 | 思考动画 + 徽标 |

| thinking | 思考中 | 思考动画 + 徽标 |

| executing_tool | 执行工具 | 观察动作 + 徽标 |

| streaming | 回复中 | 回应动画 + 横条逐字输出 |

| waiting_input | 聆听中 | 聆听动作 + 徽标 |

| voice | 说话中 | 说话口型（预留态） |

| awaiting_approval | 待确认 | 回应动作 + 徽标 |

| complete / error / paused / idle / heartbeat | 完成 / 出错 / 暂停 / 待机 / 在线 | 待机动画，无徽标 |

2️⃣ Live2D 形象与自定义

• DSH 专用模型（金色标识）：大肥鱼、DeepSeek娘 —— 为这个项目定制的形象
• Live2D 官方免费模型：Hiyori / Haru / Mao / Mark / Rice / Wanko
• 点卡片即切换形象，写穿服务端持久化（重启、轮询都不会弹回）
• 支持导入自己的 Live2D 模型目录

3️⃣ 自定义动作与表情

每个模型可独立配置 6 类情绪 × 动作/表情：

• 表情槽位：自然 / 开心 / 认真 / 温柔 / 担心 / 害羞 → 任选模型自带表情
• 动作槽位：思考 / 观察 / 聆听 / 说话 / 触碰 / 待机 → 任选模型自带动作
• 绑好后，DSH 的工作状态会真实驱动它们：executing_tool 播放你配的「观察动作」、waiting_input 播放「聆听动作」
• 每个槽位带试听按钮，点一下就知道效果

4️⃣ 拖动交互与反馈

| 交互 | 效果 |

|---|---|

| 拖动 | 跟手移动，松手后按速度惯性滑行、阻尼停稳 |

| 按压 | 角色 Q 弹一下 + 按压音效（小黄鸭） |

| 松开 | 回落音效，构成「咔哒」手感 |