本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

harness-pet

— 源: plugin_wiki.wiki_content

安装与验证

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

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 九种状态：idle、thinking、working、searching、bash、editing、waiting、error、success。
• 使用经过 QA 的 8×9 图集和固定 192×208 单元格：待机、左右拖动游动、点击挥鳍、成功喷水、红温故障、等待、工作和拿放大镜搜索动画。
• 鲸鱼上方显示 Codex Pet 风格卡片，展示最新一条本地用户问题、Harness 实时/最终回复和进度；长回复会跟随最新流式文字且可手动回看，显示内容不会被持久化。
• 左右拖动分别使用独立游动动画行；单击播放短暂挥鳍动画，不会串帧溢出。
• 可选 Chromium 桌面小窗模式：Harness 主窗口最小化后，鲸鱼仍显示在 Document Picture-in-Picture 系统置顶窗口中。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后页面右下角没有鲸鱼怎么办？

首先确认 window.__DSH_BOOT__.entries 包含 harness-pet，再确认 /plugins/harness-pet/client.js 返回 HTTP 200；插件通过 dsh.bundle.patch 注册到 web profile，首次安装或移除后必须重启 dsh web 进程让宿主重新扫描插件清单。

这是官方 DeepSeek 项目吗？

不是。这是一个非官方社区项目，与 DeepSeek 无隶属、认可或维护关系，README、UI 底部与页面文案均显著声明该免责声明。

插件会上传我的对话内容吗？

不会。插件不发起任何独立网络请求（不 fetch、不分析、不遥测），对话文字仅在本地渲染显示且不会被持久化；只有当你主动在鲸鱼上的跟进输入框里点发送时，文字才会经官方 SessionFace 提交给 Harness 自身通道。

找不到符合当前工具的状态怎么办？

适配器工具名表只识别官方命名（web_search / bash / str-replace-editor 等），未识别的运行工具一律降级为 working 而不是伪造为 searching / bash / editing，因此 1.0 前 API 变化时不会误报。

"Open Floating Pet" 按钮点了没反应？

该功能依赖 Chromium 116+ 的 Document Picture-in-Picture API；非 Chromium 浏览器（如 Firefox / Safari）会直接禁用按钮且不可用，且必须保持浏览器进程和对应标签页打开，鲸鱼才能留在独立小窗中。

设置保存在哪里？删除账号登录后会丢失吗？

仅保存在浏览器 localStorage（harness-pet:settings），包含语言、启用、大小、透明度、位置、Reduce Motion、Debug State、自动轮播。清除浏览器数据或换浏览器登录都会丢失，需要重新设置。

怎么卸载？

执行 dsh plugin --profile web remove harness-pet 然后重启 dsh web；如果是本地 link 安装，从 link:../harness-pet 目录中删除对应行并重启宿主即可。

reduced motion 开关会完全停止动画吗？

不会。系统 prefers-reduced-motion: reduce 与设置面板的 Reduced Motion 都只停止持续漂浮和帧动画，但仍会显示正确的当前状态静态帧，因此宠物依然能反馈 Harness 在做什么。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.6
• Node: >=22

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则