cakeni/harness-pet 预览 preview

cakeni/harness-pet

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

Harness Pet — DeepSeek Harness的非官方社区宠物。与DeepSeek无关联,未经其认可,亦不由其维护。

Project Overview项目介绍

Harness Pet is an open-source, native web plugin built exclusively for DeepSeek Harness. It renders an original pixel whale directly onto the DSH web interface, and updates the whale’s animation state based on structured session signals exposed by the official DSH client runtime. To install the plugin, you need DSH version 0.1.0-rc.6 or later and pnpm available on your system PATH. After running any install or remove command, you need to restart the dsh web process for changes to take effect, while code updates for existing local link installs only require a simple page refresh.

The whale has nine distinct animation states that correspond to common DSH session activities, including idle, thinking, working, searching, running bash commands, editing files, waiting, error, and success. State detection follows a clear priority order from highest to lowest: error, success, waiting, working, thinking, idle, and never relies on DOM scraping or matching translated UI text. A Codex Pet-style card above the whale displays the latest local user prompt and live Harness reply progress, and does not persist any text to local storage. You can drag the whale anywhere on the viewport, and your position preference is saved automatically to localStorage.

Harness Pet supports instant switching between four interface languages: English, Simplified Chinese, Japanese, and Korean. It also offers an optional Chromium desktop window mode that keeps the whale visible in an always-on-top picture-in-picture window even when the main DSH window is minimized. The project is released under the MIT license, does not request any additional browser permissions, and keeps all DSH coupling isolated in an adapter to simplify future updates for API changes. Original pixel sprites are embedded directly in the client bundle, so no additional asset requests are made at runtime, keeping load times fast and animation smooth.

Harness Pet 是一款专为 DeepSeek Harness 开发的原生开源趣味网页插件,它会在 DSH 的网页端界面渲染一只像素风格的小鲸鱼,根据 DSH 客户端运行时暴露的结构化会话状态信号切换不同的动画状态。它支持拖拽调整位置,位置信息会保存在浏览器 localStorage 中,还提供了大小、透明度、开关、重置位置等可配置选项。安装需要 DSH 0.1.0-rc.6 以上版本和 pnpm 环境,可通过 dsh 插件命令从 GitHub 或本地开发链接安装。

这只小鲸鱼共有九种不同的视觉状态,对应空闲、思考、工作、搜索、执行bash命令、编辑、等待、错误、成功九种会话状态,状态检测优先级遵循错误>成功>等待>工作>思考>空闲的规则,不会通过抓取DOM或匹配翻译文本判断状态。它还会在鲸鱼上方显示一张类似Codex Pet风格的卡片,展示最新的用户提示、实时的DSH回复进度,文本不会持久化存储,滚动长文本也流畅自然。

它支持英文、简体中文、日文、韩文四种语言的即时切换,支持可选的Chromium画中画模式,在主窗口最小化时也能保持宠物可见。项目基于MIT许可证开源,不请求任何浏览器权限,所有和DSH耦合的逻辑都集中在适配器中,便于后续API更新维护。首次安装后需要重启dsh web进程才能生效,本地开发更新只需要刷新页面即可。

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

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

READMEREADME

Harness Pet

A tiny whale that lives inside DeepSeek Harness.

This is an unofficial community project. Not affiliated with, endorsed by, or maintained by DeepSeek. DeepSeek and related marks belong to their respective owners.

Harness Pet animation states

dsh plugin --profile web add github:cakeni/harness-pet

中文说明

Harness Pet is an open-source, native DSH web plugin—not a browser extension. It renders an original pixel whale inside the Harness page and reacts to structured session signals exposed by the official client runtime.

Features

  • Nine visual states: idle, thinking, working, searching, bash, editing, waiting, error, and success.
  • A QA-validated 8×9 atlas with fixed 192×208 cells: calm idle, directional drag movement, wave/click, connected water-spout success, red-hot fault/error, waiting, active work, and magnifying-glass search animations.
  • A Codex Pet-style card above the whale showing the latest local user prompt, live/final Harness reply, and progress; long streams follow the newest text while remaining scrollable, and displayed text is never persisted.
  • Dragging uses dedicated left/right swimming rows; clicking plays a short flipper wave without sprite overflow.
  • Optional Chromium desktop-window mode keeps the pet visible in an always-on-top Document Picture-in-Picture window while the main Harness window is minimized.
  • Draggable, viewport-clamped position saved in localStorage.
  • Pet size, opacity, enable/disable, reset position, and reduced-motion controls.
  • Instant, persisted interface switching between English (default), Simplified Chinese, Japanese, and Korean.
  • Debug state override, automatic state cycling, and a live status badge.
  • Original pixel sprites embedded directly into the client bundle, with the procedural Canvas whale retained as a fallback.
  • Full cleanup for subscriptions, timers, animation frames, media listeners, and resize listeners.

Install

Harness 0.1.0-rc.6 and pnpm on PATH are required. Installing or removing a plugin changes the host roster, so restart the dsh web process after one of these commands. A code-only rebuild of an existing link installation needs only a page refresh.

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-session-nav 下一个 Next dsh-page-preview →