前言¶

DSH 的理念是「一切皆插件」，社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。如果经常在 dsh web 中使用 Harness，需要快速看到当前会话是等待、思考、运行工具还是出错，Harness Pet 提供了一个较轻量的页面内观察方式：在 Harness 页面中渲染一只像素鲸鱼，并响应 DSH 客户端运行时暴露的结构化会话信号。

下面介绍 cakeni/harness-pet 的定位、安装方式和已核实用法。

这是什么¶

Harness Pet 是一个原生 DSH web 插件，不是浏览器扩展。它在 Harness 页面中渲染像素鲸鱼，用九种视觉状态映射会话状态，并在鲸鱼上方显示最新本地用户 prompt、Harness 回复和进度。

仓库信息：

• 仓库：cakeni/harness-pet
• 许可证：MIT
• 定位：非官方社区项目，未与 DeepSeek 关联、背书或由其维护。

核心功能¶

• 支持九种视觉状态：idle、thinking、working、searching、bash、editing、waiting、error、success。
• 在鲸鱼上方显示最新本地用户 prompt、Harness 回复和进度。
• 点击鲸鱼可播放鳍部波浪；拖拽可移动位置，位置保存在 localStorage。
• 提供尺寸、透明度、启用/禁用、重置位置和减少动态控制。
• 支持 English、Simplified Chinese、Japanese、Korean 界面即时切换。
• 可选 Chromium 桌面窗口模式，将宠物保持在 always-on-top Document Picture-in-Picture 窗口中。
• 支持调试状态覆盖、自动状态循环和实时状态徽章。
• 无遥测，不向第三方发送对话数据。
• 插件不独立发起 fetch、分析、遥测、云同步或第三方请求。
• 仅在浏览器 localStorage 保存设置，不请求浏览器权限。
• 显示中的对话文本不会被持久化。

安装与启用¶

前置条件¶

要求 Harness 0.1.0-rc.6，并且 pnpm 在 PATH 中。

npm 包名保留给未来发布；未发布前使用 Git 或本地链接安装。浏览器扩展模式不支持。

Git 安装¶

先执行下面的命令，从 GitHub 安装插件：

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

安装或移除插件后，需要重启 dsh web 进程。经过上面的步骤，重启进程后即可在 Harness 页面中使用该插件。

pnpm prepare 构建被阻止¶

如果 pnpm 阻止 prepare 构建，在 profile 的 pnpm-workspace.yaml 中添加：

allowBuilds:
  harness-pet: true

然后重复上面的安装命令。

本地开发链接安装¶

从仓库父目录运行：

dsh plugin --profile web add link:../harness-pet

同一 profile 不要运行多个 link 安装。

开发构建¶

在仓库中执行：

pnpm install
pnpm run typecheck
pnpm test
pnpm bundle

如果只是重新构建当前目录，也可以进入插件目录后执行：

cd harness-pet
pnpm bundle

典型用法¶

1、点击鲸鱼播放鳍部波浪；拖拽移动鲸鱼，位置保存在 localStorage。

2、双击、长按或点击齿轮按钮打开设置。

3、在设置中选择 Language，即时切换界面语言；支持 English、Simplified Chinese、Japanese、Korean。

4、使用设置控制尺寸、透明度、启用/禁用、重置位置和减少动态。

5、启用 Open Floating Pet 后，主 Harness 窗口可最小化，宠物保留在独立 always-on-top 窗口中；桌面窗口模式需要 Chromium 116+ 的 Document Picture-in-Picture，不支持的浏览器会保持该控制禁用。

6、点击灰色 follow-up 图标打开输入框；Enter 提交到当前 Harness session。

适用场景与注意¶

适合使用 DSH web 插件，希望在 Harness 页面内观察会话状态、查看最新 prompt、Harness 回复和进度，并本地调整尺寸、透明度和动态效果的人。

注意事项：

• 插件以当前 dsh 进程权限运行；安装前应检查源码、依赖和许可证。
• 非官方社区项目，未与 DeepSeek 关联、背书或由其维护。
• 后续 0.1.x 预发布版本未验证；客户端 API 在 1.0 前可能变化。
• 插件不独立发起 fetch、分析、遥测、云同步或第三方请求。
• 显示中的对话文本不会被持久化。
• 仅设置保存在浏览器 localStorage，插件不请求浏览器权限。

结尾¶

Harness Pet 的价值比较集中：它是原生 DSH web 插件，用九种状态把 Harness 会话信号映射成像素鲸鱼，同时提供本地设置、悬浮窗口和调试控制。安装前仍应检查源码与许可证。

仓库链接：

• GitHub：https://github.com/cakeni/harness-pet