前言¶

DeepSeek Harness (DSH) 的 Web UI 提供了 Agent 运行的上下文，但有时需要更直观的反馈。DSH Agent Pet 插件在 Web UI 角落放置了一个宠物，它的动作会跟随 Agent 的状态变化。这只宠物由 Noah-wang 维护，解决了在长时间运行或调试过程中，通过视觉反馈确认 Agent 当前行为的需求。

核心功能¶

插件的核心能力是生成和展示逐帧动画精灵表。它将 Agent 的生命周期状态映射为具体的动作：待命时的呼吸起伏、思考时的抬头、执行工具时的奔跑、等待确认时的歪头、完成时的跳跃、出错时的低头等。精灵表大小为 6x8 格，包含 8 种状态。内置的默认宠物 Momo 是一张手写的 SVG，不依赖网络。

安装¶

插件需要 Node.js >= 22.19.0。

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

安装后重启 DSH Web UI。

使用¶

插件提供三种拥有宠物的方式：

1. 使用默认形象：安装后即可使用内置的 SVG 宠物 Momo，无需任何配置。
2. 通过工作室生成：在设置页的「宠物」分区，填写名字、外观描述和画风（预设包括 auto, pixel, sticker 等），点击「开始绘制」。这会消耗 API Key 生成新的 6x8 精灵表。
3. 导入外部精灵表：从其他生图 AI（如 Midjourney）导出提示词，生成精灵表后上传。插件会自动识别图片中的透明间隔，无需手动指定行列。

本地调试时，可以通过接口切换状态：

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

配置¶

插件支持通过 profile 的 patch 层进行配置，全部可选：

• apiKeyEnv：图片服务的凭据引用名（默认 OPENAI_API_KEY）。
• model：图片生成模型（默认 gpt-image-2）。
• baseURL：图片服务地址（默认 https://api.openai.com/v1）。
• quality：生成质量（low/medium/high）。
• dataDir：生成结果存放目录。
• petFile：自定义宠物定义文件路径。
• idleAfterMs：完成或出错后回到待命的毫秒数。

隐私与依赖¶

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

依赖方面，插件仅有 React peer dependency，无其他运行时依赖。它只接受合法的 PNG 格式图片，拒绝执行脚本或 HTML。

结尾¶

当前版本为 0.5.0。这只宠物适合需要在 DSH Web UI 中获取 Agent 状态视觉反馈的开发者。源码与文档可在 GitHub 查看。