前言¶
在 DeepSeek Harness（DSH）里配好模型和账号之后，日常提问往往还要切回主窗口或终端。若希望像豆包悬浮窗那样，随时有一个置顶、可缩放的小面板，并能框选屏幕区域直接提问，就需要在 desktop profile 上挂一个客户端插件。dsh-float 由社区维护者 18840024879 发布，分类为「客户端」，当前 GitHub 星标为 0；它复用 dsh 里已有的模型与账号，不需要单独填 API Key。下面介绍它的定位、能力与安装用法。
这是什么¶
dsh-float 是面向 Windows 10/11 x64 的桌面浮动助手：独立 Electron Helper 提供常驻置顶的对话面板，宿主为 DSH 插件（lib/index.js），通过本地桥接调用已配置的会话能力。插件版本 0.1.0，许可证 MIT，要求 Node.js >= 20、dsh >= 0.2.1-rc.2 且 < 0.3.0。关闭 dsh 后 Helper 会自动退出，不留后台进程。
核心功能¶
打开方式与窗口行为¶
安装了 dsh-pet 时，可在系统双击间隔内、位置基本不变地双击桌宠本体打开或隐藏面板；单击或拖动桌宠不会误触。未装桌宠时，可用默认快捷键 Alt+Space（被占用时自动降级为 Ctrl+Alt+Space）或系统托盘菜单显示/隐藏。面板可拖标题栏移动，拖右边缘、底边或右下角缩放；位置与大小写入 ~\.dsh\dsh-float\window.json 并自动记忆，最小约 320×420。
对话与渲染¶
支持流式回答、停止生成、模型选择、新对话；历史保留最近 8 轮（history.json 存最近 40 条，面板显示最近 12 条）。回答中的 LaTeX（$...$、$$...$$、\(...\)、\[...\]）用本地 KaTeX 渲染；Markdown 标题、列表、表格、引用、代码块等也会正常排版，而不是裸符号。
截图提问¶
左下角相机按钮进入框选：拖拽选区后松开完成，Esc 取消。截图作为附件发送，历史里保留缩略图。遮罩窗口常驻预热，悬停相机时即开始取屏幕流；遮罩在画面绘好后才淡入。文本模型遇到图片时，会按 README 说明寻找含 image 能力的视觉路由（优先 modlens）；找不到会报 VISION_UNAVAILABLE，不会静默丢图。
与 dsh-pet 的配合¶
双击桌宠打开面板是可选集成；不依赖桌宠也能完整使用快捷键与托盘。Electron 运行时查找顺序包括 DSH_FLOAT_ELECTRON_PATH、DSH_PET_ELECTRON_PATH、插件依赖与 ~\.dsh\electron\electron.exe，都没有时首次启动会下载 Electron 43.3.0 到 ~\.dsh\dsh-float\electron\（约 110 MB，仅一次）。
安装与启用¶
普通用户从命令行安装（命令来自官方 README）：
dsh plugin --profile desktop add dsh-float
装完后重启 DeepSeek Harness。启动成功时 dsh 日志中应出现 [dsh-float] loaded 和 helper ready on 127.0.0.1:…。Helper 是独立 Electron 进程；若需跳过自动下载，可设置环境变量 DSH_FLOAT_ELECTRON_PATH 指向已有的 electron.exe。
卸载时从 desktop profile 的 package.json 去掉 dsh-float 依赖及 dsh.profile.bundles 中的 "dsh-float"，重新 pnpm install，或删除 node_modules/dsh-float 链接后重启 dsh。本地开发安装步骤见 GitHub README，本文不展开。
典型用法¶
- 双击 dsh-pet 桌宠（或按
Alt+Space/ 托盘「显示」）打开面板；再次双击、Esc或右上角「—」隐藏。 Enter发送，Shift+Enter换行；生成过程中可点停止。- 面板顶部模型名可切换；选「跟随 dsh 默认」即使用 dsh 当前会话模型（对应
config.json里model: null）。 - 相机按钮框选屏幕区域提问；托盘菜单同样提供截图提问与退出。
配置与数据目录均为 ~\.dsh\dsh-float\。config.json 示例：
{
"hotkey": "Alt+Space",
"systemPrompt": "你是一个常驻桌面的 AI 助手……",
"model": null,
"maxHistoryRounds": 8,
"autoVision": true,
"opacity": 1
}
删除 config.json 可恢复默认。截图暂存于 %TEMP%\dsh-float\shot-*.png，发送后由宿主删除。
适用场景与注意¶
适合已在 DSH desktop profile 下日常使用、希望在 Windows 桌面上快速问答或「框选即问」的开发者。插件以当前 dsh 进程权限运行，安装前应在 GitHub 查看源码与 MIT 许可证，并自行评估截图、网络与模型路由行为。
仅支持 Windows，Linux/macOS 不可用。社区插件目录站点（SkillHub）与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，dsh-float 是其中一条客户端扩展，不是官方应用商店内置应用。
排障时可查看 ~\.dsh\dsh-float\helper-debug.log（面板打不开、Electron 下载失败、截图黑屏等，README 有分场景说明）；彻底重置可退出 dsh 后删除整个 ~\.dsh\dsh-float\ 再重启。
结尾¶
dsh-float 把 DSH 已配好的模型与账号接到一个可置顶、可缩放、支持截图与 KaTeX/Markdown 渲染的桌面小窗，并与 dsh-pet 双击联动。目录页：https://www.skillhub.cn/plugins/18840024879/dsh-float；源码与完整文档：https://github.com/18840024879/dsh-float。
