大肥鱼 · ds 鲸鲸娘
若叶睦形态大肥鱼，陪你工作，也陪你摸鱼。同一只蓝发小伙伴，可以用在 Codex、DeepSeek Harness 和 Web。
选择版本 · 素材下载 · Web 预览 · 开发 · 参与改进
选择你的版本
| 版本 | 适合什么场景 | 功能与入口 |
|---|---|---|
| Codex | Codex / ChatGPT Work Pets | 导入 Work Pets v2 精灵图；动画由客户端驱动 |
| DSH | DeepSeek Harness 窗口内陪伴 | 拖动、视线跟随、投喂、休息、会话状态动画，以及用量 / 余额气泡 |
| Web | 普通 HTML、Vue、React 等网站 | 独立 Web Component；人物出窝、回窝，控件留在原位 |
三端使用同一张透明精灵图。Web 与 DSH 共用动作时长和方向定义；Codex 的交互方式取决于客户端。 它们不会因为使用同一套素材而自动共享账户、会话或偏好设置。
互动方式
Web 与 DSH 都支持点击挥手、悬停跳跃、拖动奔跑、闲暇时看向鼠标，以及投喂和休息 / 唤醒。气泡位于人物左上方，随人物移动。
- Web：点击「放出来」，只有人物和气泡进入透明浮层。原位保留召回入口；双击、右键人物或聚焦后按 Escape 可以回窝。出窝轻跳，回窝奔跑并招手，拖动可打断过渡。
- DSH：跟随真实会话显示工作、等待、完成和失败状态。可定时播报 Token、估算花费、账户余额或自设预算剩余；点击人物立即播报，右键进入设置。
- 减少动态效果：Web / DSH 尊重系统设置；DSH 另有手动开关。页面隐藏时暂停动画，恢复后不补发积压提醒。
桌宠互动不调用模型。DSH 通过 Harness 的服务读取本机用量与账户余额；Web 不读取账户、不上传对话，也没有聊天输入框。
素材下载
| 文件 | 用途 |
|---|---|
| 完整精灵图 PNG | 导入 Codex，或供其他适配器使用 |
| 动作预览 GIF / MP4 | 查看动作效果 |
| 静态动作总览 | 检查各状态 |
| 16 方向总览 | 查看视线方向 |
| 素材信息与 SHA-256 | 核对尺寸、版本和文件一致性 |
在 GitHub 打开 PNG 后选择 Download raw file，保留原尺寸与透明通道。素材为 1536 × 2288 px，8 列 × 11 行，每格 192 × 208 px，共 57 张动作帧和 16 张方向帧。73 是有效帧数量，不是帧率。
Web 本地预览
使用 Node.js 22 或更高版本：
git clone https://github.com/zhouwu97/ds-pet.git
cd ds-pet
npm run preview
打开 http://127.0.0.1:4175。预览服务无需安装依赖；模块需要 HTTP 服务，不能直接双击演示 HTML。
嵌入自己的网站时，保留 web/、shared/ 和 codex/ 的相对目录：
<jingjing-pet
src="/pets/codex/jingjing-spritesheet.png"
storage-key="my-site-jingjing"
>
import { registerJingjingPet } from '/pets/web/jingjing-pet.js';
registerJingjingPet();
组件使用 Shadow DOM，无框架运行依赖。样式变量、宿主状态 API 和生命周期说明见 Web 文档。个人主页接入示例见 claawqianduan。
DSH 安装
仓库附带已构建客户端，无需自行打包。克隆后，用 Harness 桌面端内置 CLI 安装本地链接：
$petDirectory = (Resolve-Path .\ds-pet\dsh).Path.Replace('\', '/')
& '/resources/runtime/cli/bin/dsh.cmd' plugin --profile desktop add "link:$petDirectory"
以上命令在 ds-pet 的父目录执行；将占位路径换成自己的 Harness 安装目录。安装后启用 ds-jingjing-pet，正常重开 Harness 加载插件。本地链接依赖仓库目录，请保留它。
DSH 需要 connection、sessionQuery、deepseekAccount 服务。安装、设置、兼容性与统计口径详见 DSH 文档。估算花费依赖用户填写的单价，自设预算不代表官方套餐额度。
开发与验证
npm ci
npm run build
npm test
npx playwright install chromium
npm run test:browser
npm run build 将共享动作定义同步到 DSH 包内并生成 dsh/lib/client.js。修改共享动作、DSH 客户端或样式后，请重新构建并提交生成文件。
| 路径 | 内容 |
|---|---|
codex/ |
原始精灵图、校验信息与动作预览 |
shared/motion.js |
Web / DSH 共用的动作、方向和边界计算 |
web/ |
原生 Web Component 与演示页 |
dsh/src/ |
Harness 客户端、Host 与统计逻辑 |
dsh/lib/client.js |
可直接加载的 DSH 客户端产物 |
tests/、dsh/tests/ |
动作、统计、接口与浏览器测试 |
浏览器回归覆盖跟随气泡、拖动边界、出窝 / 回窝、动画打断、设置恢复与卸载清理。DSH 测试使用模拟 Connection RPC，不连接真实账户；客户端兼容性说明见对应版本文档。
想要大肥鱼更完善，来提交吧
欢迎 提 Issue 或 提交 Pull Request。
反馈问题时请说明使用哪一端、客户端版本、复现步骤，以及是否开启减少动态效果；如果是显示问题，附一张截图会更容易定位。修改素材时请保留 v2 网格与透明通道，并更新校验信息和预览。
许可
素材与代码采用 MIT License，可使用、修改和分发；请保留许可声明。
