
Nanki-nn/dsh-answer-pet
70Last commit Aug 14, 2026
dsh-answer-pet DSH plugin
dsh-answer-pet is a plugin for DeepSeek Harness Web that displays a cute pet (blue whale or orange cat) on your chat interface. It shows real-time progress of each session, including thinking, streaming, tool calls, and completion. The pet is draggable, and status cards can be collapsed to show only a session count badge.
How to install the dsh-answer-pet DSH plugin
dsh plugin --profile web add github:Nanki-nn/dsh-answer-petCopying does not run this command. Review the repository and version before installing the dsh-answer-pet DSH plugin.
dsh-answer-pet DSH plugin data source
dsh-answer-pet DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-answer-pet DSH plugin can do
- Real-time answer progress display with stages (idle, turn, think, stream, tool, done) and percentage estimation.
- Multi-session support: each running session gets its own independent progress card.
- Model execution trace timeline showing recent actions (analysis, reasoning, tool calls, etc.) with status indicators.
- Draggable pet position saved to localStorage; click triggers blink animation.
- Configurable theme (blue-whale, orange-cat), size, corner, opacity, polling interval, and visibility of progress bar and bubble.
- Tool call traces show tool name, safe short description, and status (running/success/fail) without exposing full commands or raw parameters.
Where the dsh-answer-pet DSH plugin fits
- Monitor the progress of multiple concurrent sessions without switching tabs.
- Quickly see when a model starts thinking, streaming output, or calling tools.
- Identify failed tool calls in the trace timeline with red indicators.
- Customize the appearance of the progress indicator with different pet themes.
- Develop new pet themes using the PetTheme v1 contract and built-in validation.
Who the dsh-answer-pet DSH plugin is for
- DSH Web users who want a visual indicator of answer progress and model activity.
- Developers who want to create custom pet themes for DSH Web.
dsh-answer-pet DSH plugin limitations
- Works only in DSH Web profile; not available in terminal or other contexts.
- Progress is estimated based on stage, tokens, and a saturation curve, not an exact percentage from the model.
- Trace timeline is limited to the last 6 entries (host) and displays only the last 4 (client).
- Tool trace parameters are restricted to a whitelist of fields (e.g., description, query, pattern) and do not show full commands or raw JSON.
- Theme updates require a configuration refresh; unknown themes fall back to blue-whale.
- Upgrading the plugin requires restarting `dsh web` to load new configuration schema and Node half changes.
dsh-answer-pet DSH plugin: from the repository README
Quoted from the Nanki-nn/dsh-answer-pet README, the upstream source of the dsh-answer-pet DSH plugin. Copyright remains with the original authors.
`dsh-answer-pet` 是一个 DeepSeek Harness Web bundle 插件和可扩展回答状态宠物框架。核心负责会话进度、模型轨迹和状态卡;声明式 `PetTheme v1` 负责宠物 SVG、动画、宽高比和阶段文案。默认使用蓝鲸,也内置橘猫示例主题。 <p align="center"> <img src="./assets/dsh-answer-pet-demo.gif" width="560" alt="dsh-answer-pet 蓝鲸宠物、多会话进度卡和模型工具调用轨迹演示"> </p> ## 功能 - 可扩展 `PetTheme v1`:宠物外观与回答进度核心解耦。 - 内置蓝鲸和橘猫两个纯 SVG 主题,无外部图片资源。 - 实时显示开始处理、思考、输出、工具调用和完成状态;工具失败会在轨迹中标红。 - 显示输出 token、token/s、耗时、进度百分比和文本片段。 - 多会话并发时,每个运行中的会话显示一张独立进度卡。 - 卡片内展示最近模型轨迹:分析任务、推理与规划、组织回答、调用工具及运行结果。 - 工具轨迹显示工具名、安全短描述、运行/完成/失败状态和耗时,不展示完整命令或原始参数。 - 状态卡可折叠;折叠后仅在有运行会话时显示会话数量。 - 拖拽位置持久化;单击宠物只触发主题定义的眨眼表现。 - 轮询与 SSE 结合:流式数据平滑更新,阶段切换即时刷新。 - 支持主题、尺寸、停靠角、透明度、轮询间隔、进度卡和气泡配置。 ## 宠物主题 | 主题 id | 名称 | 定位 | |---|---|---| | `blue-whale` | 蓝鲸 | 默认主题,保持原有喷水、摆尾、眨眼和完成表情 | | `orange-cat` | 橘猫 | PetTheme v1 示例,包含摆尾、抬爪、说话和完成表情 | 在配置中切换: ```yaml answer-pet: theme: orange-cat ``` 主题更新会在下一次配置刷新时挂载。未知主题会安全回退到 `blue-whale`。 希望开发自己的宠物,请查看 [PetTheme v1 开发指南](./docs/PET_THEME.md)。当前版本只加载随插件构建、通过契约校验的可信内置主题,不执行第三方任意 JavaScript,也不注入未经清理的外部 SVG。 ## 安装 ```sh dsh plugin --profile web add github:Nanki-nn/dsh-answer-pet ``` 安装后重启 `dsh web`,再刷新页面。升级插件时重复执行同一条安装命令即可。 > 模型轨迹和主题配置都由插件的 Node half 提供;从旧版本升级到 `0.6.0` 后必须重启 `dsh web`,仅刷新
Read the full READMERepository license: MIT
dsh-answer-pet DSH plugin questions
How do I install dsh-answer-pet?
Run the command `dsh plugin --profile web add github:Nanki-nn/dsh-answer-pet` in your terminal. After installation, restart the `dsh web` process, then refresh your browser page. The plugin should appear with a blue whale pet on the chat interface.
I installed the plugin but I don't see the pet.
Make sure you added the plugin to the Web profile with `--profile web`. Also, you must stop and restart the current `dsh web` process, not just start a new one. After restarting, refresh the Web GUI page. If the pet still doesn't appear, check your browser console for errors.
Can I create my own pet theme?
Yes, the plugin supports PetTheme v1. You can develop a new theme by following the [PetTheme v1 development guide](./docs/PET_THEME.md). The theme must be built into the plugin bundle and pass contract validation. Third-party JavaScript is not executed, and external SVG files are not injected for security reasons.
Why is the progress percentage not accurate?
Most model APIs do not report an exact 'answer completion percentage'. The plugin estimates progress based on stages, token count, and a saturation curve. When the actual token usage is received (via `assistant/chunk`), it overrides the streaming estimate. The progress is monotonic and never decreases within a single turn.
How do I reset the pet's position to default?
Open your browser's developer tools on the DSH Web page and run `localStorage.removeItem('answer-pet:pos')` then `location.reload()`. This will remove the saved position and reload the page. If you also want to reset the status card visibility, run `localStorage.removeItem('answer-pet:bar')` before reloading.