brittanistrehlowll-oss/dsh-pet-shura

An animated desktop pet for the DeepSeek Harness (DSH) web surface. A white winged-armor guardian tiger with gold light armor, red wing armor, a green spirit core and tiny fangs — hatching code-guarding, error-warning, evidence-review and safety-gate instincts.

catalog descriptioncatalog 简介 / catalog description:修罗小脑斧 — animated desktop pet for the DeepSeek Harness (DSH) web surface: v2 spritesheet animation, drag & drop, look-at-mouse, settings panel

Project Overview项目介绍

This is a native DSH plugin that adds an animated desktop pet to the DSH web interface. The pet is a white guardian tiger called Shura, designed with gold light armor, red wing armor, a green spirit core and tiny fangs. The plugin works with zero dependencies on the host side, does not interfere with your model traffic at all, and only injects a self-contained page script after tapping the served index.html, serving the spritesheet over a dedicated route. To install it, you just run one command via the DSH CLI, then restart DSH web and refresh the page, and the pet will appear at the bottom right of your screen.

After the pet loads, you can drag it to any position on the screen, and its position is automatically saved to your browser's localStorage. It tracks your cursor within a 240px radius and looks at it with 16 direction frames. It also performs random actions like waving, jumping, tumbling and pacing every 7 to 16 seconds, and goes into a waiting pose after 22 seconds of inactivity. It shows different status symbols for different task states, such as a floating question mark while thinking, a red exclamation mark on error, and a check mark flash when a task completes.

The plugin is released under the open source MIT license, and requires no build step to modify. If you want to adjust the pet's behavior, you only need to edit the lib/pet-client.js file, and any change takes effect immediately after you commit it, no extra compilation is needed. All settings of the pet, including size, whether to enable random actions and look-at-mouse, are saved to localStorage and persist between page refreshes. To uninstall, you just run a single DSH CLI command and restart DSH web, and if the spritesheet becomes unavailable, the script automatically removes itself without disrupting your host page.

这是一款专为DeepSeek Harness(DSH)网页端打造的原生桌面宠物插件,提供名为「修罗小脑斧」的动画守护白虎,设计带有白翼金纹光甲、绿色灵核等特色。它运行在DSH网页端,不会干扰任何模型流量,宿主侧零依赖,只需通过dsh插件命令行工具即可完成安装,重启DSH网页端并刷新页面后,就能在右下角看到萌宠。

这款宠物插件支持拖动调整位置,位置信息会保存在浏览器localStorage中,支持右键菜单唤起设置面板、查看线程状态等操作。它会实时追踪当前DSH会话中所有忙碌线程的状态,还会在任务成功、出错、思考时显示对应的状态符号,给枯燥的编码界面增加趣味互动,适合喜欢个性化界面的DSH用户使用。

插件整体遵循MIT许可开源,无需额外构建步骤,修改客户端代码后直接提交即可生效。它自带完整的1536×2288分辨率精灵图资源,只有当精灵图资源不可用时才会自动移除脚本,不会对宿主页面造成任何干扰。用户可以随时通过dsh命令行工具完成卸载,操作简单无负担。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
  • 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:brittanistrehlowll-oss/dsh-pet-shura"

把 brittanistrehlowll-oss/dsh-pet-shura 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

🐯 dsh-pet-shura — 修罗小脑斧

An animated desktop pet for the DeepSeek Harness (DSH) web surface. A white winged-armor guardian tiger with gold light armor, red wing armor, a green spirit core and tiny fangs — hatching code-guarding, error-warning, evidence-review and safety-gate instincts.

Built from a hatch-pet v2 spritesheet (1536×2288, 8 cols × 11 rows, 192×208 cells) with a zero-dependency host plugin: it taps the served index.html and injects one self-contained page script, plus serves the spritesheet over a dedicated route. Nothing touches your model traffic.

Install

dsh plugin --profile web add "github:brittanistrehlowll-oss/dsh-pet-shura"
# restart dsh web, then refresh the page — the pet appears bottom-right

Uninstall

dsh plugin --profile web remove dsh-pet-shura
# restart dsh web

Features

Feature Detail
Speech bubble Codex-style bubble above the pet, fed over SSE (/pet/events)
Thread overview Tracks every busy thread (session): "🔧 3 个线程在忙:主线程在跑终端命令,子线程 #1 在写文件" — refreshed every 15 s, only when the picture changes
Line bank Varied Chinese lines per event kind (user/work/done/error/ask/reply/turn-end/workflow/goal) plus idle self-talk every 45–90 s — the pet rarely repeats itself
Full animation All 11 v2 rows: idle breathing, running left/right, waving, jumping, failed, waiting, task-running, review, plus 16-direction look loop
Look-at-mouse Tracks your cursor with 16 direction frames (240px radius)
Drag & drop Position remembered in localStorage['dsh.pet.pos']
Thread status card Double-click the pet (or right-click → 线程状态) shows a token-styled card listing every busy thread (session) and what tool it is running, fed by GET /pet/status
Status symbols Design-review extras: floating ? while thinking, red shaking ! on error, ✓ flash on success, Zzz rising while idle-waiting
Plugin ring A semi-circular tool ring around the pet (up to 6 nodes, one per busy thread) fed by GET /pet/status: each node shows a tool-type icon, lights up with stagger while threads are busy, and the ring fades out when idle — the design review's plugin-ring concept
Core glow An emerald radial glow behind the pet brightens while working — the "energy core, state visible" idea from the design review
Random actions Waves / jumps / tumbles / paces every 7–16 s; waiting pose after 22 s idle
Settings panel Right-click the pet → ⚙️ 设置: size (60/75/100%), random actions, look-at-mouse, reset position — persisted in localStorage['dsh.pet.settings']
Right-click menu Pet info · rest (hide, recall via 🐯 button) · thread status · settings
Safe failure Script removes itself when the spritesheet is unavailable; never disturbs the host page

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-cordis-plugin-kit 下一个 Next dsh-workspace-env →