跳到正文

cakeni/harness-pet

51最近提交 2026年8月14日

harness-pet DSH 插件

Harness Pet 是一个开源的原生 DSH 网页插件,在 Harness 页面内渲染一只像素鲸鱼。它响应结构化会话信号,显示思考、工作、搜索等视觉状态。插件还包含一个对话卡片、拖拽定位以及可选的置顶桌面窗口。

如何安装 harness-pet DSH 插件

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

复制不会执行命令。安装 harness-pet DSH 插件前请核对仓库和版本。

harness-pet DSH 插件数据来源

harness-pet DSH 插件快照日期:2026年8月16日

discovered

harness-pet DSH 插件能做什么

  • 九种视觉状态:空闲、思考、工作、搜索、Bash、编辑、等待、错误、成功。
  • 对话卡片显示最新用户提示、实时/最终 Harness 回复及进度。
  • 可拖拽、视口内定位,位置保存在 localStorage,支持大小、透明度、减弱动画控制。
  • 可选的 Chromium 桌面窗口模式(使用 Document Picture-in-Picture)。
  • 即时语言切换:英语、简体中文、日语、韩语。
  • 调试状态覆盖和自动状态循环用于测试。

harness-pet DSH 插件适合哪些场景

  • 用伴生宠物增强 DeepSeek Harness 的视觉体验,宠物会随会话状态变化。
  • 快速获得助手当前活动的视觉反馈(思考、搜索、编辑等)。
  • 将宠物保持在独立的置顶窗口中,同时专注于其他任务。
  • 通过对话卡片的输入框轻松发送后续提示,无需切换标签页。
  • 从开源代码中学习 DSH 插件开发模式。

harness-pet DSH 插件适合谁

  • DeepSeek Harness 用户,希望有一个有趣、不打扰的视觉伴侣。
  • 对构建和结构 DSH 网页插件感兴趣的开发者。
  • 偏好通过视觉反馈而非纯文本日志了解会话状态的用户。

harness-pet DSH 插件的限制

  • 仅验证与 Harness 0.1.0-rc.6 兼容;后续 0.1.x 预发布版未验证,客户端 API 可能变化。
  • 不支持浏览器扩展模式;插件是原生 DSH 插件,需要 Harness 网页客户端。
  • 桌面窗口模式需要 Chromium 116+ 并支持 Document Picture-in-Picture;不支持的浏览器会禁用该控制。
  • 1.0 前的 Harness 版本可能重命名工具,导致未知工具名称退化为“工作”状态而非特定状态。
  • 该插件是社区非官方项目,与 DeepSeek 无关联、未经认可或维护。

harness-pet DSH 插件的仓库 README 摘录

以下文字摘自 harness-pet DSH 插件的上游仓库 cakeni/harness-pet 的 README,版权归原作者,仅作引用。

> 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](./assets/whale/whale-animation-v6-contact-sheet.png) ```sh dsh plugin --profile web add github:cakeni/harness-pet ``` [中文说明](./README.zh.md) 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

阅读完整 README仓库许可: MIT

harness-pet DSH 插件常见问题

如何安装 Harness Pet?

请确保已安装 Harness 0.1.0-rc.6 且 pnpm 在 PATH 中。然后运行 `dsh plugin --profile web add github:cakeni/harness-pet`。安装完成后,重启 `dsh web` 进程以使插件列表生效。如需本地开发,可在仓库父目录运行 `dsh plugin --profile web add link:../harness-pet`。

Harness Pet 会收集我的数据或发送遥测信息吗?

不会。Harness Pet 不发起任何独立的 fetch、分析、遥测、云同步或第三方请求。它仅读取显示最新用户提示和 Harness 回复所需的最少结构化字段。对话文本从不持久化。只有设置存储在浏览器 localStorage 中,不请求任何浏览器权限。

如何切换插件界面的语言?

打开设置面板(双击、长按或点击齿轮按钮)。在设置菜单中选择“Language”。插件支持英语(默认)、简体中文、日语和韩语。切换即时生效,并在会话间持续保留。

能否使用桌面窗口模式让宠物在最小化 Harness 时保持可见?

可以,但需要 Chromium 116+ 且浏览器支持 Document Picture-in-Picture。在设置中启用“Open Floating Pet”。宠物将出现在一个始终置顶的窗口中。主 Harness 窗口可以最小化,但 Harness 标签页和浏览器进程必须保持打开。在不支持的浏览器上,该控制会被禁用。

Harness Pet 如何检测当前会话状态?

插件订阅结构化的 `ctx.sessions` 列表和 `SessionFace` 快照。它还观察 `ctx.connection.hostDescription` 以检测重连。它从不匹配翻译后的 UI 文本或爬取 DOM。状态优先级为:错误 > 成功 > 等待 > 搜索/Bash/编辑 > 工作 > 思考 > 空闲。无法识别的工具名称会退化为“工作”状态。