anyuinlara-bit/dsh-BFF-pet

README 摘要

dsh-BFF-pet 🐾 一只住在 Windows 桌面上的 DeepSeek Harness（DSH）桌宠插件 A desktop pet plugin for the DeepSeek Harness running on Windows, driven by real agent state. 透明悬浮窗 + WebM 动画，通过 DSH 的 webServer 状态端点实时反映 Agent 的工作状态。整个插件与 DSH 共生： 由 DSH 自动拉起，无独立应用入口、无需额外端口 （仅复用 DSH 自身的 127.0.0.1:3080 ）。 ✨ 功能特性 - 透明悬浮桌宠 ：只在桌面显示宠物本身，无背景块；置顶显示，可任意拖拽 - Agent 状态驱动 ：空闲 / 思考中 / 工作中（区分搜索/编辑/测试/命令）/ 等待确认 / 完成 / 错误 实时切换动画与气泡 - 状态气泡 ：在宠物上方显示当前状态文字（如「工作中 · 搜索」） - 彩蛋调度 ：空闲随机彩蛋、早/中/晚餐时间彩蛋、长时间工作吃 Token - 互动 ：点击触发互动动画，拖拽反馈悬空动画 - 系统托盘 + 右键菜单 ：触发彩蛋 / 显示隐藏 / 气泡开关 / 透明度 / 大小缩放 / 复位位置 / 退出 - 健壮性 ：断连检测（DSH 失联自动显示「未连接」并在恢复后回到真实状态）、错误可视化、状态回落（任务完成无活动自动回空闲） 🎬 效果演示 动画由 Agent 实时状态驱动 ——当 DSH 的 agent 接触信息、执行任务时，桌宠会播放对应的动画。以下是几个代表性场景： 工作中 · 搜索 完成任务 吃 Token 动画素材来自 dsh-pet（见下方致谢），完整 50+ 个动画随桌宠运行自动触发。 🔄 数据流（逻辑结构） 桌宠的核心是 一条从 DSH 到桌宠的单向状态流 + 一条反向的控制流 ，全部通过 DSH 自身的 webServer 完成，不引入额外通道。 1. 状态流（正向） ：DSH 的 Agent 产生 session/event → 插件内状态机（ reducer ）把事件推导成宠物状态（空闲/思考/工作/等待/完成/错误）→ 通过状态端点 GET /state 暴露。Windows Electron 每秒轮询该端点，去重后转发给渲染层，驱动动画与气泡切换。 2. 控制流（反向） ：托盘/右键菜单的用户动作（触发彩蛋、气泡开关、退出等）→ 渲染层处理，或通过控制端点 POST /quit 通知 DSH 彻底停止。 两条流都只复用 DSH 自身的 127.0.0.1:3080 ，插件与 DSH 共生，无独立入口、无额外端口。 🖥️ 环境与 Electron 运行时 桌宠是 Windows 原生 应用（透明置顶窗口 + 系统托盘）。运行需要 Electro…

分类