前言¶
在 DeepSeek Harness（DSH）Web UI 中，智能体通常以文本形式与用户交互，缺乏视觉反馈。Petween 作为一个中间件插件，旨在解决这一问题。它允许开发者使用少量的静态图片资源，通过程序化算法生成丰富的动画效果，将静态的智能体形象转化为具有动态表现力和交互性的“宠物”。
它是什么¶
Petween 是一个由 Traveritas 维护的 DSH Web UI 宠物插件，定位为纸片动画风格的智能体宠物动画中间件。它不依赖庞大的预设动画库，而是通过 Motion Engine 处理输入的图片，自动生成漫画式过渡与循环动画，并跟随 Agent 的真实运行状态进行切换。
核心功能¶
该插件主要包含以下能力：
- 资源要求低：支持少量图片即可工作。包含待机、思考、工作、等待、成功、错误六个状态槽位，缺失状态可自动 fallback。
- 动画生成：支持漫画式过渡动画（如 Comic Pop、Soft、Jelly、Celebrate）与状态循环动画（如 Bounce、Sway、Breathing）。
- 真实对齐：提供 Anchor 真实对齐功能，确保角色换图时脚底不瞬移，Squash & Stretch 围绕地面锚点进行。
- 状态跟随：根据 Agent 状态（空闲、活跃、等待、成功、错误）自动切换姿势与动画表现。
- 交互与持久化：支持拖动、缩放、位置持久化，并支持点击互动与粒子特效。
- 可视化编辑：提供 Timeline Engine 与可视化时间轴编辑器，支持管理自定义动画轨道、关键帧与事件。
- 生态扩展：提供动画包（Motion Pack）和宠物包（Pet Package）功能，支持自定义动画的导出与分享。同时提供附属插件扩展服务，支持动画库注册、舞台快照订阅等。
安装与启用¶
由于插件尚未发布到 npm，需通过源码安装：
# 1. 克隆仓库
git clone https://github.com/Traveritas/petween.git
cd petween
# 2. 安装依赖并构建（必须在安装前构建）
pnpm install
pnpm run build
# 3. 安装插件
dsh plugin --profile web add link:/path/to/petween
# 4. 重启 dsh web 生效
典型用法¶
在 DSH Web UI 中，进入设置页面的 Petween 卡片，可以快速启用或停用宠物，并调整整体缩放。点击卡片上的“打开完整编辑器”会在新标签页打开独立编辑器页面。
也可以直接访问 http://127.0.0.1:3080/petween-editor/（端口以 DSH web 配置为准）。
若想在不触碰真实配置的情况下测试，构建后直接双击 preview/index.html 即可打开独立预览页。
注意事项¶
- 插件 README 目前需要更新。
- 尚未发布到 npm，不能直接使用
dsh plugin add petween，必须从 GitHub 克隆安装。 - 不支持 SVG，仅解码展示图片。
- 多浏览器标签同时编辑同一配置时，默认采用 Last-Write-Wins 机制。
- 版本过期时，写入请求会返回 409 错误。
总结¶
Petween 通过程序化动画技术，降低了为 DSH 智能体添加视觉反馈的门槛。它提供了完整的动画编辑与分享工具链，适合希望增强智能体交互体验的开发者使用。更多详情请参考 GitHub 仓库。
