[Plugin] dsh-answer-pet — DSH Web 可扩展回答状态宠物框架

[Nanki-nn]

1. 插件名称与仓库地址

• 名称：dsh-answer-pet
• 仓库：https://github.com/Nanki-nn/dsh-answer-pet

2. 功能简介

DeepSeek Harness Web 的 bundle 插件：在 DSH Web 页面显示一只回答状态宠物，实时展示会话进度、多会话状态卡与模型执行轨迹（思考 / 输出 / 工具调用 / 完成）。核心与宠物外观解耦——声明式 PetTheme v1 契约负责 SVG、动画与阶段文案，内置蓝鲸（默认）和橘猫两个纯 SVG 主题，支持主题扩展。

主要特性：

• 实时阶段展示：开始处理、思考、输出、工具调用、完成；工具失败在轨迹中标红
• 输出 token、token/s、耗时、进度百分比与文本片段
• 多会话并发时每个运行会话一张独立状态卡
• 卡片内展示最近模型轨迹（分析任务、推理与规划、组织回答、调用工具及结果）
• 状态卡可折叠、宠物可拖拽（位置持久化）、位置/透明度/停靠角可配置
• 轮询 + SSE 结合：流式数据平滑更新，阶段切换即时刷新

3. 安装与使用

dsh plugin --profile web add github:Nanki-nn/dsh-answer-pet

安装后重启 dsh web 并刷新页面。配置位于 <dshHome>/settings.yaml 的 answer-pet section：

answer-pet:
  theme: blue-whale # blue-whale / orange-cat
  size: 96          # 宠物高度 px（48–200）
  corner: br        # 停靠角：br / bl / tr / tl
  opacity: 1        # 透明度（0.2–1）
  pollMs: 800       # /state 轮询间隔
  showBar: true     # 显示会话进度卡
  showBubble: true  # 显示状态气泡

4. 开源许可证与版权归属

MIT License，版权归作者 Nanki-nn 所有。代码与文档的著作权归作者，插件被收录不转移任何权利。

5. 当前维护状态及主要维护者

• 状态：活跃维护
• 测试：30 项单元测试通过（node --test），客户端 bundle 有构建校验（npm run check:client）
• 文档：已提供贡献指南（CONTRIBUTING.md）与主题开发指南（docs/PET_THEME.md）
• 主要维护者：Nanki-nn

6. 已知风险、限制或兼容性说明

• 主题扩展当前仅支持随插件构建的内置主题（安全边界：不执行第三方 JS、不注入外部 SVG）
• Node half 或配置 schema 更新后需重启 dsh web，仅刷新浏览器不生效
• 进度百分比为估算值（多数模型接口不报告精确完成度），真实 token usage 到达后覆盖估算
• 工具轨迹只展示白名单字段的短摘要（description / query / pattern / file_path / path / url），不展示完整命令与参数