s17179XTY/dsh-BigfishPet

README 摘要

dsh-BigfishPet — DeepSeek Harness 桌宠插件（鲸鱼娘 🐳） 这是针对 DeepSeek Harness 的通用桌宠插件 ，不是 Bigfish 应用或 DSH Desktop 的专属功能——Bigfish、DSH Desktop 都只是它运行于其中的壳。任何 DeepSeek Harness 环境只要运行 dsh plugin 命令即可安装：插件管理桌宠状态与任务完成信号，宠物窗口由「壳侧整合」提供（完整安装流程见下文，两步都要做）。 桌宠原型来自 Bigfish（DeepSeek Harness 的第三方桌面壳），本插件把它插件化，成为 DSH 的一等公民：在 DSH 设置里直接调整，状态持久化、任务完成走真实信号。 能力边界一句话 ：插件（任何 DSH 环境都能装）提供设置页、 pet.json 状态与完成信号；宠物窗口需要 Electron 壳创建——本仓库提供 Bigfish 壳的现成整合，其他 Electron 壳（如 DSH Desktop）可做等价整合（见「安装到 DeepSeek Harness（完整流程）」）。 这是什么 DeepSeek Harness 本身是 Web 后端 + 浏览器界面， 没有创建桌面窗口的能力 ——这是所有 DSH 壳（Bigfish、DSH Desktop 等 Electron 应用）存在的意义。因此桌宠被拆成两部分，插件管数据、壳管窗口： 部分 位置 职责 DSH 插件 （通用，必装） 仓库根目录（ lib/ 、 package.json ） DSH 设置里的「桌宠」页：显示开关、大小（带默认刻度尺）、位置、改名、摸头/喂食、任务完成提醒；状态存 /.dsh/pet.json ；监听真实 agent/status 事件写完成标记。任何 Harness 环境都能装，只依赖 DSH 标准接口，不依赖任何特定壳 壳侧整合 （按壳装） bigfish/ 目录（Bigfish 壳的参考实现） 置顶的 剪影宠物窗口 （ win.setShape() 按角色轮廓裁剪，无背景矩形），由插件通过 pet.json 驱动；任务完成时气泡「任务完成啦！🎉」。宠物窗口代码只依赖标准 Electron API + pet.json ， 不绑定 Bigfish ——任何 Electron 壳都能做等价整合 为什么这么拆：宠物窗口本质是 Electron 窗口，DSH 插件跑在 Web 后端里建不了窗口，所以窗口由壳提供、配置与信号由插件管——两边通过 /.dsh/pet.json 和 /.dsh/bigfish-completions.jsonl 协作。 功能 - 置顶悬浮 ，Bigfish 隐藏/最小化也不消失； - 剪影显示 ：部分系统不合成透明窗口（本项目目标机器即是），宠物用不透明窗口 + 角色轮…

分类