dsh-agent-pet

Name: dsh-agent-pet
Availability: InStock
Author: Noah-wang

A pet in the DeepSeek Harness Web UI that changes pose with your agent, with an eight-pose sprite sheet you can generate from one sentence.

Stars: 0
Language: JavaScript
Created: Sep 8, 2026
Updated: Sep 9, 2026

Fun

GitHub repo

Introduction

Momo 的八个循环动画：待命、思考、执行工具、等待确认、完成、出错、休息、打招呼

DSH Agent Pet

一只住在 DeepSeek Harness Web UI 角落的宠物，跟着 Agent 换动作。

它思考的时候宠物抬爪，跑工具的时候宠物在跑，等你确认的时候宠物坐直了看着你。
形象可以用一句话描述生成——用你自己的 API Key，或者拿提示词去任何生图 AI。

中文 · English

Momo 在真实 DSH Web UI 右下角，执行工具时是奔跑姿势

每个状态一个循环动画

大多数桌宠只有一张图，靠位移和缩放假装在动。这个插件不是——一次生成会画出一张 6×8 的逐帧动画精灵表：八个状态，每个状态六帧。界面按 Agent 当前状态切到对应那一行，再用 CSS steps(6) 逐帧播放。

状态	循环动画	触发时机
`idle`	呼吸起伏，耳朵尾巴轻摆	没事做
`thinking`	爪子点下巴，头往上仰	Agent 在思考
`running_tool`	侧面跑步循环	正在执行工具
`waiting_approval`	正面歪头看你，眨一次眼	等你确认
`done`	下蹲、腾空举爪、落地	完成
`error`	垂肩低头再抬起一点	出错
`resting`	蜷着睡，呼吸起伏	预留
`greeting`	举爪左右摆动	预留

四十八格来自同一次生成，所以是同一只宠物。分开生成只会得到一堆长得像但不一样的动物——文生图没有记忆，角色一致性是这件事唯一的难点。

后两行暂时没有触发来源，先占好位置，以后加状态不用重新生成形象。

三种拥有一只宠物的方式

1. 什么都不做

装完就有一只内置的云朵猫 Momo，六个状态都能动。它是一张手写的 SVG，不需要任何 API Key、不联网。

2. 用自己的 API Key 画一只

在设置 → 宠物里，或者把鼠标移到宠物上点左上角的 🎨。填名字、外观描述（8–800 字符）、选画风，点「开始绘制」。

插件会生成一张 6×8 的透明逐帧动画表并立刻替换当前形象。点「恢复默认」随时回到 Momo。

画风预设：auto、pixel、sticker、plush、flat-vector、3d-toy。

绘制需要图片服务的 Key，默认从 DSH 凭据服务读 OPENAI_API_KEY。没配置时工作室会直接告诉你，不会发请求。

3. 用别的 AI 画，再导进来（不需要 API Key）

展开「用别的 AI 生成」，点「生成提示词」，会给你一段自包含的提示词。

复制到任何生图 AI——即梦、Midjourney、Nano Banana 都行——让它输出一张透明背景的 6×8 精灵表（八行状态，每行六帧），再点「⬆ 上传精灵表 PNG」选中那张图。

你不需要告诉插件这张图是几行几列——导入时它会从图里的透明间隔自己数出来，单张图也认得。只有在那张图没有透明背景、或者格子挨得太紧认错了的时候，才需要展开「识别错了？手动指定」。

这条路不需要任何 Key，也不产生费用。

设置页

设置页里的宠物分区：形象工作室与外观开关

装好后设置页会多出一个**「宠物」**分区：上半部分是完整的形象工作室，下半部分是外观开关——显示气泡、播放动画、隐藏宠物、恢复默认位置。

位置、隐藏状态和这些开关都存在 Host 侧，刷新页面和重启都不会丢。

安装

需要 DSH 的 web profile。

dsh plugin --profile web add dsh-agent-pet

从 Git 安装：

dsh plugin --profile web add github:Noah-wang/dsh-agent-pet

本地开发：

dsh plugin --profile web add /absolute/path/to/dsh-agent-pet

装好后重启 DSH Web UI。卸载：

dsh plugin --profile web remove dsh-agent-pet

配置

在 profile 的 patch 层覆盖，全部可选：

配置项	默认值	说明
`apiKeyEnv`	`OPENAI_API_KEY`	凭据引用名
`model`	`gpt-image-2`	图片模型
`baseURL`	`https://api.openai.com/v1`	图片服务地址，兼容 OpenAI 协议的端点都行
`quality`	`medium`	`low` / `medium` / `high`
`dataDir`	`<DSH_HOME>/agent-pet`	生成结果存放目录
`petFile`	内置 `pets/default/pet.md`	自定义宠物定义
`idleAfterMs`	`2400`	完成/出错后回到待命的毫秒数

隐私

插件不读取对话正文、工具参数、工具结果、API Key 或任何凭据。 它只观察 Agent 生命周期事件和工具名称。

浏览器端只请求 DSH 本机同源接口，不访问第三方。绘制时 Key 由 DSH 凭据服务在 Host 进程内解析，不会进入浏览器状态、API 响应、日志或导出的宠物元数据。

只接受签名合法的 PNG，生成的 SVG/HTML 会被拒绝而不是执行。完整边界见 SECURITY.md。

自定义与交互

拖拽移动，右上角 × 隐藏，变成 🐾 圆钮点回来。位置和隐藏状态都会记住
尊重 prefers-reduced-motion，开了就全部静止
编辑 pets/default/pet.md 可以改名字、形象和每个状态的短文案。avatar 只接受 pet.md 同目录下的相对路径；Markdown 不会执行脚本、命令或 HTML

本地切状态调试：

curl -X POST http://127.0.0.1:3080/api/agent-pet \
  -H 'content-type: application/json' \
  -d '{"state":"running_tool"}'

实现说明

零运行时依赖，只有 React 的 peer dependency
精灵表用 CSS background-position 按像素取格，动画用 steps() 推进，两端都不解码图片
单帧形象（内置 Momo、旧数据、用户上传的单图）走 background-size: contain，不变形
生成结果原子落盘，重启后保留

当前范围

0.5.0。已支持逐帧动画精灵表生成、提示词导出、外部精灵表导入、设置页与持久化偏好，以及 npm、Git 或本地安装。

暂不包含社区账号提交、云同步、ESP32 通信或可执行的第三方宠物插件。

许可证

MIT