前言¶

用 DSH 写代码或跑任务时，Agent 的思考、查找、修改、执行这些阶段大多只显示在会话窗口里。窗口一最小化或切到别的应用，就看不到当前进度；想知道 DeepSeek 余额还要另开一个页面。下面介绍 dsh-dafeiyu，它把状态拉到桌面上：一个透明、无边框、始终置顶的原生窗口，随 DSH 一起启动和退出，让你在编辑器或浏览器旁边也能看到 Agent 在做什么。

dsh-dafeiyu 是一个 DSH 插件（客户端类），由 skyzou071026-collab 维护镜像，上游仓库是 QCYTSN/dsh-dafeiyu，代码按 MIT 许可发布。当前稳定版 0.1.23。它不读取屏幕，状态全部来自 DSH 会话事件；推理强度与进度只显示上游实际提供的信息，拿不到真实进度时显示阶段。

能做什么¶

1. 显示真实任务状态：思考、查找、修改、执行、验证、等待确认、完成和错误。
2. 展示项目、步骤、多任务和 DSH 提供的待办进度；没有真实进度时显示阶段。
3. 显示 DeepSeek 余额：状态气泡底部和设置页都会显示，区分 API Key 与已登录账户两种来源。
4. 兼容 WebUI 与官方桌面端，两个客户端使用各自的插件配置，各自启动一个原生角色。
5. 支持拖动、摸头、戳身体、碰尾巴，以及角色大小、气泡大小、声音和减少动态设置。
6. 可选在 DSH 页面右下角显示轻量角色，默认关闭。

先选你的 DSH 客户端¶

WebUI 用户的插件装在 web profile；官方桌面端装在 desktop profile。两者的设置入口在 DSH 0.2 都是左侧「插件 → dsh-dafeiyu」，但角色右键菜单的打开目标不同：WebUI 默认打开 http://127.0.0.1:3080/，桌面端通过 dsh://open 唤起桌面应用。

需要注意：WebUI 中安装的插件不会自动出现在桌面端。 两边都启用会各自启动一个原生角色，可以在其中一个 profile 关闭「大肥鱼」。第三方桌面包装器可能仍使用 web profile，以它的实际启动方式为准。

安装与启用¶

使用命令行安装、升级或移除前，先完全退出对应的 DSH Host，操作完再重新启动。下面按客户端分别给出命令。

浏览器 WebUI¶

已全局安装 DSH 时：

dsh plugin --profile web add dsh-dafeiyu@0.1.23
dsh web

没有全局安装 DSH，用 npx：

npx -y @deepseek-ai/dsh plugin --profile web add dsh-dafeiyu@0.1.23
npx -y @deepseek-ai/dsh web

从 DeepSeek Harness 源码运行的用户，在 Harness 仓库中执行：

pnpm dsh plugin --profile web add dsh-dafeiyu@0.1.23
pnpm dsh web

官方桌面端¶

推荐直接在应用内安装：打开官方桌面应用，点击左侧「插件」→「添加插件」，输入 dsh-dafeiyu@0.1.23，安装后点「立即启用」。这套流程使用应用自带的安装环境，不需要自己装 Node.js 或执行 npm 命令。

如果走命令行：

1. 先启动一次官方桌面应用，让它初始化 desktop profile，然后完全退出。
2. 使用桌面应用自带的 dsh 命令（也可直接调用安装目录的 resources/runtime/cli/bin/dsh，Windows 是 dsh.cmd）。
3. 执行：

dsh plugin --profile desktop add dsh-dafeiyu@0.1.23

4. 重新打开桌面应用，在左侧插件 → dsh-dafeiyu 调整角色。

这里的 dsh 必须来自桌面应用。 独立安装的 npm 或 npx @deepseek-ai/dsh CLI 不能修改官方桌面端的 profile。

只填 dsh-dafeiyu 会取默认安装源中的最新版，新发布时可能仍是旧版；指定 @0.1.23 可以避免装错，装完核对详情页版本号。

使用 Release 安装包¶

在 Release 页 的 Assets 中下载 dsh-dafeiyu-0.1.23.tgz，用对应客户端的命令安装，无需解压：

# WebUI；路径替换为实际下载路径
npx -y @deepseek-ai/dsh plugin --profile web add "C:\Downloads\dsh-dafeiyu-0.1.23.tgz"

# 桌面端；必须使用应用自带的 dsh
dsh plugin --profile desktop add "C:\Downloads\dsh-dafeiyu-0.1.23.tgz"

Windows、Linux 与 macOS 共用这一个包。GitHub 自动生成的 Source code (zip / tar.gz) 是源码，不是安装包，不要拿来安装。

典型用法¶

装好后无需额外配置即可看到状态。

1. 默认透明窗口悬浮在桌面上，随会话阶段变化。不同的表情和动作对应状态，具体触发与衔接规则见仓库内的 docs/animation-behavior.md。
2. 在设置页开启余额显示，凭据在 DSH 的模型／账户设置中配置，大肥鱼设置页不需要填写 API Key。余额每分钟自动刷新，同一 Host 内共享缓存，手动刷新最快每 5 秒一次。服务失败时保留上次成功结果并标明「上次查询」。不配置凭据也能正常显示任务状态。
3. 在设置页调整角色大小与气泡大小、切换安静／标准／活泼（待机休息时长 45～90 / 25～45 / 12～22 秒）、开启减少动态、设置提示音与通知场景、选择气泡常驻／隐藏／仅在指定状态显示。
4. 右键角色可调整大小、切换减少动态、打开对应 DSH 客户端，或仅在本次运行隐藏／关闭角色。
5. 若 WebUI 使用自定义地址，在启动 Host 时设置 DSH_DAFEIYU_WEBUI_URL，它优先于自动推断的默认地址。

平台与运行环境¶

标准安装包已包含 Helper，不需要自己安装 Python 或运行 Helper。原生角色显示在 Host 所在的桌面：如果 Host 跑在远程服务器或无图形环境，而你在本地浏览器使用客户端，角色不会出现在你本机，页面内角色除外。

更新与排错¶

WebUI 用户退出 DSH 后执行：

npx -y @deepseek-ai/dsh plugin --profile web update dsh-dafeiyu

官方桌面端 0.2.0-rc.2 暂不支持应用内自动更新：在插件页面卸载后重新添加 dsh-dafeiyu@0.1.23，或退出应用后执行：

dsh plugin --profile desktop update dsh-dafeiyu

几个常见问题的方向：角色不出现时先检查 profile、插件是否启用、Host 是否有可用图形桌面，Helper 启动原因会写入日志（Windows %LOCALAPPDATA%\dsh-dafeiyu\logs\helper.log，macOS ~/Library/Logs/dsh-dafeiyu/helper.log，Linux ${XDG_STATE_HOME:-~/.local/state}/dsh-dafeiyu/helper.log）。首次启动要解压约 100 MB 的 Qt 运行库，杀毒软件实时扫描可能让冷启动明显变慢，首次就绪等待上限已放宽到 180 秒。余额查询失败时检查 DSH 中的凭据及所用网关是否支持余额接口。需要更详细输出可用 DSH_DAFEIYU_LOG_FILE=<路径> 改日志位置，或设为 off 关闭；日志只含本地路径与启动错误，不含凭据。

适用场景与注意¶

适合想长期挂着 DSH、希望编排过程中不断确认 Agent 状态的用户，尤其是需要盯住等待确认和工具出错场景的人。它是一个社区维护的镜像插件（上游 QCYTSN/dsh-dafeiyu），目录页显示星标为 0。

使用前有几件事要知道：插件以当前 DSH 进程的权限运行，安装前应检查源码与许可证，本篇只转述上游 README 的能力说明。代码适用 MIT，但角色素材来自 PC2005-cloud/dsh-pet，软件代码与素材授权不同，发布包内附 ASSET_LICENSE.md 与素材许可证。当前动态素材以 24 fps 转成透明 WebP，含 16 组动作、3,444 帧，帧画布 412 × 344。插件不发起模型调用，也不会把 API Key、登录凭据和上游原始错误写入余额页、角色消息或事件流。

目录页与源码¶

• 目录页：https://www.skillhub.cn/plugins/skyzou071026-collab/dsh-dafeiyu
• 镜像仓库：https://github.com/skyzou071026-collab/dsh-dafeiyu
• 上游仓库：https://github.com/QCYTSN/dsh-dafeiyu