前言¶
用 DeepSeek Harness（DSH）做智能体开发或日常对话时，主窗口往往被 IDE、浏览器或终端占满。需要追问、切换会话、选模型或处理工具审批时，只能反复 Alt-Tab 切回 Harness，打断当前工作流。社区插件 dsh-quorfloat（维护者 Azetus）提供系统级悬浮窗：全局快捷键呼出面板，在使用其他应用时也能向 Harness 提问、继续会话并处理审批。面板复用 Harness 的工作区、会话、模型与权限；对话执行与历史仍由 Harness 管理。支持 macOS 与 Windows，npm 主包名为 dsh-quorfloat，安装时会自动拉取当前平台的面板程序，无需自行编译。
这是什么¶
dsh-quorfloat 是 DSH 的客户端类插件：宿主侧注册插件，侧车进程提供带 WebView 的悬浮窗 UI。分类上属于「客户端」——运行在本机 DSH 主机上，而不是浏览器里。远程只开 WebUI 时，可以在 WebUI 里安装并查看插件状态，但悬浮窗只会出现在运行 dsh web 的那台机器上。
核心功能¶
以下能力均来自项目 README，安装后需完全重启 Harness 本体（仅关悬浮窗或刷新 WebUI 不足以重载宿主插件）。
- 随时呼出：全局快捷键显示或收起悬浮窗；可拖动并记住位置，可设置失焦后仍保持展开。默认快捷键为 Alt + Space（macOS 为 Option + Space），可在设置中更换。
- 工作区与会话：浏览当前工作区已有会话，切换其他工作区开新对话，或浏览「未分组」会话；可固定会话或固定默认工作区。
- 对话阅读与控制：Markdown、代码块、表格；工作过程可展开/折叠；长会话可加载更早内容并保持阅读位置。支持发送、停止生成，选择 Harness 提供的模型、推理档位与权限预设。
- 审批与追问：在面板内处理当前会话的工具审批和问题，无需切回 Harness 主窗口。
- 外观与诊断：浅色/深色/跟随系统，中英文界面；设置自动保存。设置页或 Harness「设置 → 内置插件 → dsh-quorfloat」可导出诊断日志到
~/.dsh-quorfloat/logs/。
安装与启用¶
准备：已安装 DeepSeek Harness。使用浏览器 WebUI 时，终端需能执行 dsh。插件在 package.json 中声明需要 dsh >= 0.2.0-rc.2。当前资料中的 npm 主包版本为 0.1.9（以你实际安装的包为准）。
浏览器 WebUI（npm）¶
先停止正在运行的 dsh web。以下示例安装到 web profile；若使用自定义 profile，将 web 换成你的 profile 名称，并用同一 profile 启动 Harness。
联网安装最新版：
dsh plugin --profile web add dsh-quorfloat
dsh web
固定版本时，将包名改为 dsh-quorfloat@<version>。
浏览器 WebUI（离线 tgz）¶
下载与操作系统匹配的自包含包，例如 macOS 的 dsh-quorfloat-<version>-darwin.tgz、Windows 的 dsh-quorfloat-<version>-win32.tgz，无需解压，用绝对路径安装：
dsh plugin --profile web add "/绝对路径/dsh-quorfloat-<version>-darwin.tgz"
dsh web
Windows PowerShell 示例：
dsh plugin --profile web add "C:/Downloads/dsh-quorfloat-<version>-win32.tgz"
dsh web
Harness 官方桌面版¶
- 启动桌面应用，左侧栏打开「插件」→「添加插件」。
- 输入
dsh-quorfloat或dsh-quorfloat@<version>，点击安装并按提示启用。 - 完全退出并重新启动 Harness 桌面应用。
离线安装时在弹窗中输入 tgz 的绝对路径，安装启用后同样需重启桌面应用。
典型用法¶
安装并重启 Harness 后，按默认 Alt + Space（macOS：Option + Space）呼出面板，再按一次可收起；也可通过菜单栏或系统托盘操作。
输入与导航：
- 输入框：Enter 发送，Shift + Enter 换行；生成中可停止；Esc 优先关闭菜单或返回对话页，在对话页且无菜单时收起面板（收起不会停止后台会话）。
- 点击顶部工作区或会话名：选真实工作区并在会话菜单选「新会话」（首次发送才创建）；或从列表继续已有会话；会话旁固定按钮可在下次呼出时继续同一会话；新会话状态下可固定工作区作为默认创建位置。「未分组」仅浏览，不能固定且无「新会话」。
设置：齿轮图标可调主题、语言、快捷键与「失焦时保持展开」。默认快捷键若冲突，可先经菜单栏/托盘打开面板再改。
适用场景与注意¶
适合：经常在 IDE、终端、设计工具里工作，又需要随时向 DSH 提问、续聊、批工具调用，且希望少切换窗口的 macOS/Windows 用户。
注意：
- 插件与侧车以当前 DSH 进程权限运行；安装前建议查看 GitHub 仓库 源码与 MIT 许可证。
- DSH 生态是「一切皆插件」；社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系。
- Linux 未出现在当前 README 的安装/发布说明中；请以仓库最新文档为准。
- 需要自行构建时，README 要求 Node.js 22+、Rust 1.88+ 及 Tauri 相关环境，产物在
bundles/下；一般用户走 npm 或 tgz 即可。
结尾¶
dsh-quorfloat 把 Harness 的对话、会话切换和工具审批收到一块悬浮面板里，用全局快捷键即可接入，适合「主窗口在别的应用里、Harness 在后台跑」的日常用法。更多说明与界面预览见仓库 README；安装与版本信息也可在 SkillHub 目录页核对。
- 目录页：https://www.skillhub.cn/plugins/Azetus/dsh-quorfloat
- GitHub：https://github.com/Azetus/dsh-quorfloat
