dsh-dafeiyu 是什么？把 DeepSeek Harness 真实状态变成桌面宠物的 DSH 插件

dsh-dafeiyu（DSH 大肥鱼）是住在桌面上、由 DeepSeek Harness（DSH）真实工作状态驱动的 Agent 伴侣：它不是需要单独启动的桌宠应用，而是由 DSH 插件启用、跟随 DSH 一起启动和退出的始终置顶透明窗口，让你切到其他软件也能知道 DSH 当前在思考、修改、测试还是等待。 本文介绍 dsh-dafeiyu 是什么、核心功能、安装配置、更新卸载命令与典型用法。

dsh-dafeiyu 是什么？

dsh-dafeiyu 解决的是「离开 DSH 页面就看不到 Agent 进度」的问题：它把 DSH 的真实工作状态显示在桌面最上层，反馈来自真实 Agent 事件而非屏幕读取，不会把你在其他软件里的操作误判成 DSH 工作。 以下定位与事实来自官方 README（来源）：

dsh-dafeiyu（GitHub 仓库 QCYTSN/dsh-dafeiyu）由 qcytsn 维护，MIT 协议开源，是 DSH Plugin 生态里的 UI 类插件，当前支持 Windows、WSL2、Linux x64，macOS 为实验性支持。它的入口属于 DSH、生命周期属于 DSH、显示层属于桌面：普通用户不需要安装 Python、PySide6，也不需要单独运行 Helper 或配置额外端口，Windows、Linux x64 与 macOS 的 Helper 都已包含在发布包里。当 DSH 提供实际采用的 reasoning effort 时，状态详情会持续显示该值，不靠模型名称猜测；若 DSH 没有提供待办清单，它只显示「分析阶段」「实现阶段」这类可靠信息，不编造完成百分比。

dsh-dafeiyu 的核心功能有哪些？

核心能力围绕「真实状态反馈、推理强度显示、多会话优先级、克制不编造、原生桌面窗口」展开：用最可靠的信息、最小的打扰，让你随时掌握 DSH 在做什么。 以下能力来自官方 README（来源）：

• 真实状态反馈：基于 DSH 的 Agent 事件而非屏幕读取，不监听 VS Code、浏览器或其他应用，也不截图。
• 显示推理强度：当 DSH 提供实际采用的 reasoning effort 时持续显示该值，不根据模型名称自行猜测。
• 多会话优先级：多个 Session 同时运行时，默认优先展示最需要注意的顶层任务（等待确认 > 错误 > 工作 > 思考 > 空闲）。
• 信息克制不编造：没有真实待办数据时只显示可靠阶段，不虚构完成百分比。
• 原生桌面窗口：透明、无边框、始终置顶，带思考、查找、修改、执行、验证、等待、完成与错误的动作与文案。
• 隐私边界清晰：不读取或保存 API Key、不截图、不发送遥测、不监听键盘，也不新开网络端口。

怎么安装与启用 dsh-dafeiyu？

安装 dsh-dafeiyu 前先完全退出 DSH Host，再用 dsh plugin 命令装进 web profile；装完照常启动 DSH WebUI，大肥鱼会由 DSH 自动拉起，不需要手动打开 Helper。 命令与平台要求来自官方 README（来源）：

1. 完全退出 DSH：关闭 DSH Host 而不只是浏览器标签页，安装或更新时不要让旧版插件继续运行。

2. 安装插件（Windows / WSL2 / Linux / macOS 通用）：在 DSH 安装目录执行，从 npm 安装稳定版：

dsh plugin --profile web add dsh-dafeiyu

若 dsh 尚未注册为全局命令，可在 DSH 安装目录用 pnpm 前缀执行同一条命令：

pnpm dsh plugin --profile web add dsh-dafeiyu

等待安装完成，插件默认启用，无需额外手工步骤。

3. 启动 DSH 并确认启用：照常启动 DSH WebUI，插件会自动拉起桌面窗口；进入「设置 → 插件 → 插件配置 → 大肥鱼桌面伴侣」可确认或调整开关。

4. 开始使用：在 DSH 中开始一个项目任务，切换到其他窗口，大肥鱼仍保持在桌面最上层显示最新状态。

5. 更新插件：完全退出 DSH 后执行更新命令，或重跑安装命令让它解析 npm 上的新版本：

dsh plugin --profile web update dsh-dafeiyu

6. 卸载插件：完全退出 DSH 后运行移除命令，再重新启动 DSH：

dsh plugin remove dsh-dafeiyu

dsh-dafeiyu 典型用法

dsh-dafeiyu 安装后不需要额外操作：启动 DSH、开一个任务，宠物就会随真实事件切换动作和状态卡；拖动、右键菜单与设置项都能按习惯调整。 使用步骤来自官方 README（来源）：

1. 启动 DSH 并开始任务：安装后启动 DSH WebUI，在 DSH 中开始一个项目任务，大肥鱼根据 DSH 的真实事件切换动作和状态卡。

2. 切换窗口继续工作：切到 VS Code、浏览器或文件管理器，大肥鱼保持在桌面最上层；状态卡会显示项目目录名、当前阶段（如「实现阶段」）、当前待办与真实进度（如「已完成 3/5 步」）：

项目目录名：dsh-dafeiyu
当前阶段：实现阶段
当前待办：完善项目文档
真实进度：已完成 3/5 步

3. 与宠物互动：按住大肥鱼可拖动并自动保存位置；点击或双击触发摸头、戳一下等短互动；右键菜单可调整角色大小、气泡大小、减少动态、打开 WebUI、本次隐藏或本次关闭。

4. 调整显示设置：在 DSH WebUI 进入下列设置项，可调整角色大小（55%～140%）、气泡大小（80%～120%）、气泡显示、活跃程度、提示音与是否响应子 Agent：

设置 → 插件 → 插件配置 → 大肥鱼桌面伴侣

5. 收尾退出：DSH Host 真正退出后大肥鱼自动退出；关闭了 DSH 网页但后台仍在运行时，它也会继续显示。

dsh-dafeiyu 常见问题与排错

常见问题集中在「装了看不到鱼」「关了网页鱼还在」「没有数字进度」「本次关闭后不回来」四类，分别核对启用开关、Host 生命周期、真实待办数据与抑制规则即可。 依据来自官方 README（来源）：

1. 安装后没有看到大肥鱼：症状是装了插件但桌面没有任何显示。原因：可能没装进 web profile、DSH Host 未完全重启、或设置里没勾选启用。解决：确认安装用的 profile 是 web，完全退出并重启 DSH Host，再进「设置 → 插件 → 插件配置」勾选「启用大肥鱼」：

dsh plugin --profile web add dsh-dafeiyu

2. 关闭了 DSH 网页，为什么大肥鱼还在：症状是关掉浏览器标签页后宠物不消失。原因：它绑定的是 DSH Host 生命周期而不是浏览器标签页。解决：只要 DSH 后台仍在运行宠物就继续显示，真正退出 DSH Host 后它会自动关闭。

3. 为什么没有显示数字进度：症状是状态卡不显示「已完成 3/5 步」之类的进度。原因：只有 DSH 写入了结构化待办时插件才能可靠计算。解决：没有真实待办数据时它只显示当前工作阶段，不制造虚假的百分比，属正常行为。

4. 右键选择「本次关闭」后没有自动回来：症状是选本次关闭后宠物一直不出现。原因：这是预期行为——「本次关闭」会抑制当前 DSH 运行期间的自动重启。解决：完全退出并重新启动 DSH 即恢复；想永久关闭请在设置中取消「启用大肥鱼」。

适用场景与注意

dsh-dafeiyu 适合在 DSH 长任务期间需要切到别的窗口工作的人：写代码、查资料时随时瞄一眼就知道 Agent 在思考、等待还是出错，多任务时还能按优先级关注最要紧的会话。 适用性与限制来自官方 README（来源）：

典型场景包括：多窗口并行开发——让 DSH 跑任务的同时用编辑器或浏览器做别的事；长任务监工——构建、测试或批量任务时不用一直盯着 DSH 页面；多会话管理——同时跑多个 Session 时优先关注等待确认或出错的那一个；WSL2 开发——在 WSL 终端安装，可视模式自动通过 Windows Helper 显示。需要注意的限制有：Windows 10/11 x64、WSL2 或 Linux x64 桌面（glibc 不低于 2.35，Debian/Ubuntu 常需 libxcb-cursor0），macOS 12.0+ 为实验性支持且当前只有 ad-hoc 签名；ARM、无显示器的远程 SSH、容器和纯服务器环境不是桌面显示目标；默认只跟随最近活跃的顶层 DSH Session，是否让子 Agent 参与优先级需在设置中开启；角色视觉资产不适用 MIT 代码许可证，使用边界见仓库的 ASSET_LICENSE。

项目链接

dsh-dafeiyu 是 qcytsn（QCYTSN）维护的 MIT 开源项目，作为只服务 DSH 状态的桌面伴侣插件持续迭代。 想查看完整功能、截图与插件信息，欢迎访问本站的 dsh-dafeiyu 插件详情页：dsh-dafeiyu。

本页是基于该插件官方 README 独立重写的导读——权威文档和最新变更请以源头为准：QCYTSN/dsh-dafeiyu。插件是安装时就在你机器上运行的第三方代码；收录不代表背书——安装前请自行审阅源码。