前言¶
用 DeepSeek Harness（DSH）跑长任务时，一个常见场景是：Agent 在后台改代码、跑测试，你 meanwhile 切到 VS Code、浏览器或终端继续别的事。WebUI 标签页一关或一挡，就很难一眼判断 DSH 是在思考、执行、等你确认，还是已经报错结束。
社区插件 dsh-dafeiyu（DSH 大肥鱼）针对的正是这个痛点。它由维护者 QCYTSN 开发，在 SkillHub 插件库 归类为「客户端」，GitHub 仓库约 252 星、27 个 fork。插件以 npm 包 dsh-dafeiyu 发布，代码采用 MIT 许可证。
需要先说清生态背景：DSH 的核心理念是「一切皆插件」，SkillHub 等社区目录是第三方整理的发现入口，与 DeepSeek / 幻方并无官方从属关系。安装任何社区插件前，都建议自行查看源码与许可证——插件以当前 dsh 进程权限运行。
这是什么¶
DSH 大肥鱼 是一个桌面原生的 BigFish 伴侣：由 DSH 插件机制启用，生命周期跟随 DSH Host，在桌面上以透明、无边框、始终置顶的原生窗口展示 Agent 状态。
它不是需要单独启动的桌宠程序，也不会读取屏幕或监听 VS Code、浏览器里的操作。状态变化全部来自 DSH 的真实 Agent 事件；没有待办数据时，只显示「分析阶段」「实现阶段」等可靠信息，不会编造完成百分比。
当前 README 标注版本为 0.1.5，支持 Windows 10/11 x64、WSL2（经 Windows interop 拉起桌面 Helper）、Linux x64 桌面（X11 或 XWayland），macOS 12.0+ 为实验性支持。
核心功能与亮点¶
- 离开 WebUI 也能看状态：大肥鱼常驻桌面最上层，切到别的软件仍能看到 DSH 在做什么。
- 事件驱动，非屏幕抓取：思考、查找、修改、执行、验证、等待、完成、错误等状态，对应不同动画与文案。
- 信息适量：状态卡可展示项目目录名、当前阶段、进行中的步骤，以及 DSH 提供的结构化待办进度（如「已完成 3/5 步」）。
- 多 Session 优先级：多个 DSH Session 同时运行时，按「等待确认 > 错误 > 工作 > 思考 > 空闲」排序，气泡可同时列出多个活动任务。
- 零额外入口：随 DSH 启停，无需单独装 Python、配端口或手动开 Helper；Windows / Linux / macOS 的 Helper 已打包在发布物中。
- 可配置交互：角色与气泡大小、气泡显示策略、空闲微动作、减少动态、提示音、是否响应子 Agent 等，均在 WebUI 设置中调整。
安装与启用¶
安装前请完全退出 DSH Host（不只是关浏览器标签），避免旧版插件进程残留。
在 DSH 安装目录下执行（PowerShell 或终端均可）：
dsh plugin --profile web add dsh-dafeiyu
若系统未全局暴露 dsh，可用项目内的 pnpm 调用：
pnpm exec dsh plugin --profile web add dsh-dafeiyu
想试用 @alpha 测试版，将包名改为 dsh-dafeiyu@alpha 即可。也可从 GitHub Releases 下载 dsh-dafeiyu-<version>.tgz（勿解压），本地安装：
dsh plugin --profile web add "C:\Users\you\Downloads\dsh-dafeiyu-<version>.tgz"
WSL2 用户在 WSL 终端执行同一条命令，插件会通过 cmd.exe 启动包内 Windows Helper。Linux x64 用户同样一条命令；远程无桌面 Linux 与容器不在显示目标范围内。macOS 安装命令相同，但当前为实验性支持，下载包可能遇 Gatekeeper 拦截（ad-hoc 签名，尚未公证）。
安装完成后照常启动 DSH WebUI。设置入口：
设置 → 插件 → 插件配置 → 大肥鱼桌面伴侣
确认「启用大肥鱼」已勾选。更新插件时，先完全退出 DSH，再执行：
dsh plugin --profile web update dsh-dafeiyu
卸载：
dsh plugin --profile web remove dsh-dafeiyu
典型用法¶
安装后无需额外操作，按日常流程使用 DSH 即可：
- 启动 DSH，在 WebUI 中开始一个项目任务。
- 大肥鱼根据 DSH 事件切换动作与状态卡（思考、工作、等待确认、完成、错误等）。
- 切换到其他窗口继续工作；伴侣窗口保持置顶。
- DSH Host 真正退出后，大肥鱼自动关闭。
桌面交互方面：可拖动调整位置（自动保存）；单击或双击触发短互动；右键菜单可改大小、隐藏气泡、打开 WebUI、「本次隐藏」或「本次关闭」。「本次关闭」会抑制当前 DSH 运行期间的自动重启，下次启动 DSH 才会再出现。
若安装后看不到大肥鱼，依次检查：是否使用 --profile web、是否重启了 DSH Host、设置里是否启用、是否使用了含预构建 Helper 的发布包（仅克隆源码通常不够）。
适用场景与注意事项¶
适合谁：
- 长时间让 DSH Agent 跑任务，又需要在 IDE / 浏览器里并行工作的开发者；
- 希望桌面一眼看到「是否在等我确认」「是否已报错」的用户；
- Windows / WSL2 桌面环境为主，或 Linux x64 本地图形会话的用户。
需要注意：
- 插件绑定 DSH Host 生命周期，不是浏览器标签页；关网页但 Host 仍在跑时，大肥鱼会继续显示。
- 数字进度仅在 DSH 写入结构化待办时展示；无待办时只显示阶段信息，这是刻意设计，避免虚假百分比。
- 隐私边界（据官方 README）：不读取 API Key、不截图、不遥测、不监听键盘或其他应用、不新开网络端口。
- 社区插件需自行审计代码；角色视觉资产另有 ASSET_LICENSE.md 约束，与 MIT 代码许可分开。
- 同作者的独立桌宠项目 ds-local-pet 与本文插件不同：本仓库只服务 DSH 状态展示。
小结¶
如果你希望 DSH 的 Agent 状态「离开 WebUI 也看得见」，dsh-dafeiyu 把真实事件映射到桌面置顶伴侣，安装成本低、信息来源可靠，是客户端类插件里较受欢迎的选择之一。
