BlackBearCC/dsh-pet-sprite

Plugin插件 Native原生 ⭐ 2 MIT Pets & Fun桌宠与娱乐

A playable pixel companion plugin for DeepSeek Harness (DSH): platform-jumps over chat messages, WASD controllable, with a full nurture system fed by your agent's real token usage.

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH) that adds an interactive pixel pet companion to the DSH web UI. To install the plugin, run the command dsh plugin --profile web add github:BlackBearCC/dsh-pet-sprite in your CLI, then restart DSH with dsh web and open any conversation to see your pet spawn at the bottom of the chat flow. The pre-built output is already committed to the repository, so no extra build steps are required for a standard install, though you can rebuild from source with pnpm install && pnpm build if you want to modify the code.

When you first launch the plugin, a speckled egg will appear quietly in the corner of your chat without any intrusive forced popups. You can click the egg to hatch it and choose one of three default companions, or generate a fully custom companion by describing it in one sentence, which costs 100 in-game star coins. You can left-click the pet to open a small chat box, and the pet will reply in-character using your existing configured DSH LLM provider, so no extra API keys or new credentials are required. Right-click the pet to open the care panel to check status, manage inventory, adjust settings, and switch companions anytime.

All game state, including pet attributes, level, coins, inventory, chat history, and model choice, is stored locally in your browser's localStorage. There is no external telemetry or outbound network calls beyond what DSH itself already makes. The plugin is tested against DSH developer preview 0.1.0-rc.7, but since DSH is evolving quickly with breaking changes, you can pin a specific commit hash for greater stability if you need a reliable experience. It is released under the open source MIT license, with a full nurturing system and token-based in-game economy tied to your actual DSH token usage.

这是一个专为DeepSeek Harness(DSH)打造的原生网页端插件,可为DSH的网页界面添加一只可互动的像素电子宠物。它不是静态壁纸吉祥物,宠物会在聊天气泡上跳跃移动,支持用户手动控制,还拥有一套和代理实际token使用挂钩的完整养育系统。你可以通过DSH CLI命令dsh plugin --profile web add github:BlackBearCC/dsh-pet-sprite安装,安装后重启DSH即可启用。

首次启动时,角落会出现一枚安静的斑点蛋,点击孵化后你可以从三个预设初始宠物中选择一个,也可以用一句话描述想要的宠物,让模型生成全新的自定义像素精灵。右键点击宠物可打开护理面板,查看状态、管理物品、调整设置,左键点击可调用当前DSH配置的模型和宠物聊天。宠物会自动在消息气泡间漫游,你也可以通过键盘按键手动控制它移动跳跃。

该插件使用MIT许可,所有游戏状态和聊天记录都保存在浏览器本地存储中,不会上传任何数据到外部服务器,也不需要额外的API密钥,会复用你现有DSH的配置和凭据。它目前适配DSH开发者预览版0.1.0-rc.7,由于DSH更新较快存在 breaking 变更,如果你需要稳定使用,可以锁定特定commit版本。

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

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

READMEREADME

dsh-pet-sprite

A playable pixel companion plugin for DeepSeek Harness (DSH) Web UI.

Not a wallpaper mascot — the pet lives in your chat area, platform-jumps over your message bubbles, and you can grab the controls yourself. It also carries a full nurture system fed by your agent's real token usage.

Features

  • Three companions, one egg — on first launch a speckled egg wobbles quietly in the corner (never a forced popup). Click it to hatch and pick your companion: Poka the white-haired girl, Mikan the tabby cat, or Puff the DeepSeek-blue baby whale. Switch anytime from the care panel.
  • Generate & share your own companion — describe it in one sentence ("a green dino with round glasses") and the model draws a new pixel sprite for 100 star coins, animated automatically. Every generated pet exports as a .dsh-pet.json file friends can import for free.
  • Left-click to chat — clicking the pet opens a small chat box beside it. Replies come from the model you already configured in DSH (provider + model pickable in the care panel's settings tab), so it reuses your existing credentials — no extra API key. The pet answers in-character as a speech bubble; the last 30 turns persist locally.
  • Platform jumping playground — the pet treats chat message bubbles as platforms: it wanders, climbs bubble edges, hops between messages on its own.
  • Player control — click empty space in the chat area to take over: A/D move, Space jump (double-tap mid-air for a skill jump), W climb, S drop through platforms. Idle 10s and it goes back to autonomous mode.
  • Agent-state reactions — while the model streams, the pet sits down and types on its own tiny laptop; idle, it blinks, strolls, and naps. Each companion has its own ambient chatter.
  • Nurture system (ported from the PetClaw engine): mood / power / health attributes with decay and linkage, Lv.1–100 with titles, coins, inventory, and a shop with level-gated + daily-limited items.
  • Token-bound economy — your input tokens drain the pet's power, each completed reply converts output tokens into XP, daily-first-open grants login coins, leveling slows attribute decay.

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-vision 下一个 Next dsh-overdrive →