前言¶
在 DSH Desktop 里长时间盯一块界面时，常见做法是调窗口大小、来回切标签，或者把聊天区和侧栏挤在同一屏里。这些做法能凑合用，但很难把「工作区列表」「输入区」这类固定布局里的某一块单独拎出来，边拖边缩放，关掉之后还尽量回到原来的 DOM 位置。
下面介绍社区插件 @metaone01/dsh-better-float（维护者 metaone01，分类：客户端）。它面向 DeepSeek Harness Desktop，把选中的界面区域做成应用内浮动面板，并提供浮窗管理器；可选的「外部窗口提取」处于预览阶段，需要额外本机配置。插件以预构建 npm 包分发，当前资料中的版本为 0.1.1，代码采用 MIT License。
这是什么¶
一句话：把 DSH Desktop 中常用的界面区域变成可拖动、缩放的应用内浮动面板，并在关闭时尝试将真实 DOM 节点放回原布局。
它是 DSH Desktop 插件，依赖宿主提供的插件管理及相关界面服务，不是独立桌面应用，也不是装到任意网页的浏览器扩展。资料未声明经过完整验证的最低 DSH 版本；若出现服务缺失，应更新 Desktop 并向维护者反馈版本信息。
核心功能¶
元素选择与浮动¶
- 用快捷键进入选择模式，鼠标移到目标区域；用滚轮或方向键调整选中层级与范围。
- 确认后把选区放入应用内面板，可拖动标题栏移动、拖右下角缩放，点击面板置前。
- 关闭面板（标题栏
✕）时尝试恢复控件到原位置。建议在切换工作区或关闭原页面之前先恢复。
实现上优先 移动真实 DOM 节点，以保留原有状态与交互。README 明确说明：复杂编辑器、虚拟列表、iframe、Canvas、媒体和 Shadow DOM 仍可能出现样式或状态变化，宜先在可恢复的区域试。
浮窗管理器¶
通过管理器浏览缩略图、找回已浮动的面板并重新摆放。放置采用 两步：先点缩略图，再在目标位置点一次以确定面板左上角；第二次点击前可按 Esc 取消。
界面语言¶
随 DSH 切换中英文界面。
外部窗口提取（预览）¶
可选功能：本机 companion 为部分受支持的内容与控件提供独立窗口，需额外配置，存在兼容性限制；默认安装不会自动配置 companion。面板上的相关按钮会检查后端；未配置、选区不支持或连接失败时，应继续使用应用内面板。连接可能传输选区文字与控件值，确认前需检查是否含私密内容。细节见仓库文档 docs/EXTERNAL-WINDOW-PREVIEW.md。
安装与启用¶
普通用户 无须 克隆仓库、安装开发依赖或运行构建脚本；也不要用 github:metaone01/dsh-better-float 作为常规安装入口（可能触发 Git 依赖与 allowBuilds 相关提示）。
在 DSH 的插件管理入口输入 npm 包名与版本：
@metaone01/dsh-better-float@0.1.1
安装完成后 完整退出并重新启动 DSH Desktop。
若此前装过旧的裸包名版本，先在插件管理器移除旧插件，再安装 @metaone01/dsh-better-float，避免重复注册相同快捷键。
离线或发布前测试时，可在支持本地包的入口填写维护者提供的 .tgz 绝对路径，例如：
C:/Downloads/metaone01-dsh-better-float-0.1.1.tgz
卸载时：先关闭所有浮动面板，在插件管理器移除 @metaone01/dsh-better-float，退出并重启 Desktop；若配置过外部窗口预览，还需按预览说明清理配置并停止手动启动的 companion。
典型用法¶
第一次使用可按 README 中的顺序操作：
- 按选择快捷键，将鼠标移到想浮动的区域上。
- 用滚轮或
↑/↓调整选中范围；点击、拖动后松开，或按Enter确认。按Esc取消。 - 拖动面板标题栏移动，拖动右下角调整大小，点击面板使其置前。
- 需要集中管理多个浮窗时，打开浮窗管理器，按两步放置重新摆放。
默认快捷键如下（可在 DSH 快捷键设置中查找 Better Float 相关命令并重新绑定）：
| 操作 | Windows / Linux | macOS |
|---|---|---|
| 开始选择；再次按下取消 | Ctrl+Shift+S |
Cmd+Shift+S |
| 打开／关闭浮窗管理器 | Ctrl+Alt+Shift+S |
Cmd+Option+Shift+S |
| 调整选择层级 | ↑ / ↓ 或滚轮 |
同左 |
| 确认选择 | 点击、拖动后松开或 Enter |
同左 |
| 取消选择、管理器或放置 | Esc |
同左 |
资料注明：快捷键表为默认绑定，不表示各平台均已完成真实宿主验收。
适用场景与注意¶
适合谁：需要在 DSH Desktop 同一会话里把侧栏、输入区等拆成可移动浮层、又不想完全依赖系统级分屏的开发者；愿意接受「先选区、再恢复」工作流，并在复杂控件上自行验证恢复效果的用户。
权限与安全：插件在 当前 DSH Desktop 进程权限 下运行，可访问宿主界面 DOM 与插件 API。安装前应阅读 GitHub 仓库 源码与 MIT 许可；外部窗口预览还会涉及本机 companion 与 Host 配对，需自行评估传输内容是否含敏感信息。
生态说明：DSH 社区插件目录（如 SkillHub 上的条目）由社区维护，与 DeepSeek / 幻方无官方从属关系，不等同于官方应用商店。
维护与反馈：问题可通过 GitHub Issues 提交，附上 DSH 版本、插件版本、操作系统、复现步骤，以及是否使用外部窗口预览。资料写明当前维护重点在 Windows；其他系统的外部窗口路径尚需单独验证。
结尾¶
@metaone01/dsh-better-float 用「选区 → 应用内浮动面板 → 关闭时尝试还原 DOM」这条路径，缓解 Desktop 固定布局下的屏面分配问题；浮窗管理器负责找回与重排，预览级外部窗口则留给愿意单独配置 companion 的场景。进一步了解安装细节与截图示例，可看目录页与仓库 README。
- 目录页：https://www.skillhub.cn/plugins/metaone01/dsh-better-float
- GitHub：https://github.com/metaone01/dsh-better-float
