跳到主内容

dsh-dafeiyu 使用指南

为 DeepSeek Harness 提供 Windows 桌面浮窗伴侣,根据 Agent 真实事件切换状态动作并显示项目阶段与待办进度。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

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

快速上手

dsh-dafeiyu

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-dafeiyu

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

— 源: plugins.install

关键要点

  • 最新版本永远以 npm latest 和 GitHub Releases 为准(Releases 里同时提供 .tgz 安装包);顶部的版本徽章会自动更新。
  • 给仓库 Star 只是收藏,不会收到更新通知。想第一时间知道「更新了什么」:
  • 已安装用户升级:完全退出 DSH 后执行
  • 离开 DSH 页面也能看到状态:大肥鱼始终显示在 Windows 桌面最上层。
  • 反馈来自真实 Agent 事件:不会读取屏幕,也不会把你在其他软件里的操作误判为 DSH 工作。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后桌面上没看到大肥鱼怎么办?

首先确认安装命令带了 --profile web;然后必须完全退出 DSH Host(不是关浏览器标签页)再重新启动;进入 DSH 的“设置 → 插件 → 插件配置 → 大肥鱼桌面伴侣”,确认“启用大肥鱼”已勾选;最后确认你用的是 Windows x64 的预构建包,而不是只有源码的克隆(runtime/bin/win32-x64/ 下必须有 dsh-dafeiyu-helper.exe)。

关掉 DSH 网页大肥鱼为什么还在?

大肥鱼绑定的是 DSH Host 的进程生命周期,而不是浏览器标签页。只要 DSH 后台还在跑,大肥鱼就会继续显示;只有真正退出 DSH Host 之后它才会一起关闭。

状态卡上为什么没有“已完成 N/M 步”的数字?

数字进度只有在 DSH Agent 写入了结构化的待办清单(todo/write 事件)时才会可靠计算。DSH 没提供真实待办时,状态卡只显示“分析阶段”“实现阶段”等当前工作阶段,避免编造百分比。

右键选“本次关闭”后为什么没有自动回来?

这是预期行为。“本次关闭”会抑制当前 DSH 运行期间的自动重启;完全退出 DSH 并重新启动后会重新出现。如果想永久关闭,去 DSH 设置里取消“启用大肥鱼”即可。

需要自己装 Python 或 PySide6 吗?

不需要。正常用户从 npm alpha 包或 GitHub Release 的 .tgz 安装时,包内已经带了 Windows x64 的 dsh-dafeiyu-helper.exe(用 PyInstaller 把 Python+PySide6 一起打包),DSH 会自动拉起它。只有从源码开发或重新构建 Helper 时才需要本地装 PySide6>=6.7,<7。

支持 macOS 或纯 Linux 吗?

当前 Alpha 不支持。Helper 只能运行在 Windows x64;WSL2 可以通过 cmd.exe 调用 Windows 的 .exe 来显示桌面浮窗(helper-process.js:isWsl 路径),但普通 Linux、远程 Linux、容器都不是本版本的桌面显示目标。

这个插件会监听其他应用、读取屏幕或发送遥测吗?

不会。插件只订阅 DSH 的 session/event 与 session/disposed 事件,不读取或保存模型 API Key,不截图,不监听键盘或其他应用,也不发送遥测;设置卡复用 DSH 自己的本地 Web 服务,不新开端口。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 未声明(package.json#dsh.client.platform 为 web,并通过 dsh.bundle.patch 注入宿主;未在源码或 README 中给出 DSH 最低版本号)
  • Node: >=22.19(package.json#engines.node)

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源:通用规则