Nanki-nn/dsh-answer-pet 预览 preview

Nanki-nn/dsh-answer-pet

Desktop桌面端 Native原生 ⭐ 10 MIT Pets & Fun桌宠与娱乐

Project Overview项目介绍

dsh-answer-pet is a native DeepSeek Harness (DSH) web bundle plugin and an extensible desktop pet framework built specifically for DSH. It adds an interactive pet overlay to the DSH web interface that tracks conversation progress and displays model execution trajectories in real time. The plugin follows the PetTheme v1 specification that fully decouples pet appearance from core logic, and it ships with three built-in themes by default: blue whale, orange cat, and silver shaded cat. To install the plugin, users run the DSH CLI command dsh plugin --profile web add github:Nanki-nn/dsh-answer-pet and then restart dsh web and refresh the browser page.

For each running DSH conversation session, the plugin creates a separate status card that displays stage information, token metrics, progress percentage, and a timeline of recent model actions and tool calls. Failed tool calls are highlighted in red for visibility, and the pet animates differently based on the current conversation stage. Users can drag the pet anywhere on the screen, and the position is saved to browser local storage for future sessions. Clicking the pet only triggers a predefined animation like a blink, so users do not accidentally move it when they just want to interact.

After installation, users can adjust plugin settings directly in DSH’s settings.yaml file, including theme selection, pet size, docked corner, opacity, polling interval, and whether to show status cards and bubbles. The plugin only loads pre-built, validated themes distributed with it, and it never executes arbitrary third-party JavaScript or loads untrusted external resources. This intentional design choice keeps user interactions safe and protects user privacy. Third-party developers can create custom themes following the official PetTheme v1 guide. dsh-answer-pet is distributed as free open-source software under the MIT license, and all users can modify or redistribute it per the license terms.

dsh-answer-pet 是专为 DeepSeek Harness(DSH)开发的原生 Web 插件,也是一个可扩展的回答状态桌面宠物框架。核心功能是在 DSH Web 界面中显示会话进度、模型执行轨迹和状态卡片,采用声明式 PetTheme v1 规范将宠物外观与核心逻辑解耦,内置蓝鲸、橘猫、银渐层猫三个宠物主题,支持用户自定义开发新主题。

插件可以实时显示请求开始处理、思考、输出、工具调用和完成各个阶段的状态,工具调用失败会在轨迹中标记为红色。它同时展示输出 token 数量、生成速率、耗时和进度百分比,多会话并发时每个会话都有独立可折叠的状态卡片,卡片展示最近的模型轨迹、工具名称和运行状态,支持拖拽调整宠物位置,位置会被持久化保存。

用户可通过 DSH CLI 命令 dsh plugin --profile web add github:Nanki-nn/dsh-answer-pet 安装,安装后需要重启 dsh web 并刷新页面才能生效。可以在 DSH 的 settings.yaml 配置文件中修改主题、尺寸、停靠位置、透明度、轮询间隔等参数。项目以 MIT 许可证开源,仅加载经过校验的内置主题,不执行第三方任意 JavaScript,保护用户隐私。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • 10 stars - an early-stage project星标 10,属于早期项目
  • Desktop client: installation downloads an executable - verify the publisher and checksums桌面客户端:安装会下载可执行文件,请核对发布者与校验和
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

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

把 Nanki-nn/dsh-answer-pet 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-answer-pet

DSH Web 可扩展回答状态宠物框架:宠物主题、多会话进度与模型执行轨迹。

dsh-answer-pet 是一个 DeepSeek Harness Web bundle 插件和可扩展回答状态宠物框架。核心负责会话进度、模型轨迹和状态卡;声明式 PetTheme v1 负责宠物 SVG、动画、宽高比和阶段文案。默认使用蓝鲸,也内置橘猫示例主题和高相似度银渐层猫主题。

dsh-answer-pet 蓝鲸宠物、多会话进度卡和模型工具调用轨迹演示

功能

  • 可扩展 PetTheme v1:宠物外观与回答进度核心解耦。
  • 内置蓝鲸、橘猫和银渐层猫三个主题;银渐层猫使用构建时注入的可信内嵌 PNG,不加载外部图片资源。
  • 实时显示开始处理、思考、输出、工具调用和完成状态;工具失败会在轨迹中标红。
  • 显示输出 token、token/s、耗时、进度百分比和文本片段。
  • 多会话并发时,每个运行中的会话显示一张独立进度卡。
  • 卡片内展示最近模型轨迹:分析任务、推理与规划、组织回答、调用工具及运行结果。
  • 工具轨迹显示工具名、安全短描述、运行/完成/失败状态和耗时,不展示完整命令或原始参数。
  • 状态卡可折叠;折叠后仅在有运行会话时显示会话数量。
  • 拖拽位置持久化;单击宠物只触发主题定义的眨眼表现。
  • 轮询与 SSE 结合:流式数据平滑更新,阶段切换即时刷新。
  • 支持主题、尺寸、停靠角、透明度、轮询间隔、进度卡和气泡配置。

宠物主题

主题 id 名称 定位
blue-whale 蓝鲸 默认主题,保持原有喷水、摆尾、眨眼和完成表情
orange-cat 橘猫 PetTheme v1 示例,包含摆尾、抬爪、说话和完成表情
silver-shaded-cat 银渐层猫 去背景紧裁切原画 + 明显阶段动画:呼吸、眨眼、摇摆、说话、抬爪和完成跳跃

蓝鲸主题与回答状态卡 橘猫主题与回答状态卡 银渐层猫主题与回答状态卡

在配置中切换:

answer-pet:
  theme: silver-shaded-cat # blue-whale / orange-cat / silver-shaded-cat

主题更新会在下一次配置刷新时挂载。未知主题会安全回退到 blue-whale。

希望开发自己的宠物,请查看 PetTheme v1 开发指南。当前版本只加载随插件构建、通过契约校验的可信内置主题,不执行第三方任意 JavaScript,也不注入未经清理的外部 SVG。

安装

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

安装后重启 dsh web,再刷新页面。升级插件时重复执行同一条安装命令即可。

模型轨迹和主题配置都由插件的 Node half 提供;从旧版本升级到 0.6.0 后必须重启 dsh web,仅刷新浏览器不会加载新的配置 schema。

回答进度

阶段 主题接口 状态卡
空闲 idle 动画与文案 不显示运行会话卡与数量
turn/start turn 2%
思考(step/start) think 5% → 10%
输出(assistant/chunk) stream 10% → 90%,按 token 填充
工具(tool/call) tool 冻结当前进度并显示工具名
完成(turn/end) done 100%

进度计算规则:

  • 优先使用 assistant/chunk 的 usage 数据;流式期间按文本长度估算。
  • 有 maxTokens 时按 outputTokens / maxTokens 填充。
  • 没有 maxTokens 时使用饱和曲线估算,避免进度长期停滞。
  • 同一回合内进度单调不减。
  • 输出速率使用 EMA 平滑估算。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-opencode-go-usage 下一个 Next deepseek-harness-phone-remote →