前言¶
用 DeepSeek Harness（DSH）做智能体开发时，桌面端往往占满屏幕：侧栏一展开，聊天区被挤窄，多任务时也不方便把对话「钉」在角落。浏览器里的 Web GUI 没有可调的原生窗口；另一个桌面客户端 dsh desktop 也未被这类窗口插件覆盖。维护者 jan0107 的 dsh-compact-window 面向 DSH NEXT 桌面端（Windows），把主窗口收成约 425 逻辑像素宽的置顶便签式小窗，侧栏以抽屉浮在聊天之上，不继续挤压正文。下面介绍它是什么、能做什么，以及如何安装与使用。
这是什么¶
dsh-compact-window 是 DSH 生态里的客户端类插件：在 Host 侧通过 Win32 调整 DSH NEXT 窗口几何与置顶，在 Web 客户端半注入输入框旁的控制按钮与样式。分类为客户端；当前 GitHub 星标为 0。许可证 MIT，package 版本 1.0.1（以仓库 package.json 为准）。只支持 DSH NEXT 桌面宿主，不支持 dsh desktop；找不到目标窗口时插件会隐藏按钮，避免误操作其他程序。
核心功能¶
以下能力均来自插件 README 与实现说明。
一键进入小窗¶
输入框右侧、发送键左侧有「画中画」图标。点击后窗口变为宽约 425 逻辑像素、置顶，且不占任务栏。进出小窗带有半透明遮罩与缓动动画。
置顶与拖动¶
小窗顶部右上角、系统按钮左侧有「图钉」：可开关置顶；取消置顶后其他窗口可以盖住小窗，选择会被记住。顶部 40px 为拖动带，跨显示器、不同 DPI 缩放仍保持 425 逻辑像素宽。
抽屉式侧栏与过渡¶
小窗内展开侧栏时以抽屉形式浮在聊天区域上，而不是把文字挤成一团。侧栏开合在普通窗口模式下也有约 200ms 过渡；框架层依赖 data-shell-overlay、data-sidebar-collapsed 等内部布局标记（非公开契约，大版本布局变更时可能退回旧挤压样式，一般不会崩溃）。
状态记忆¶
小窗位置、置顶偏好会持久记住。进入小窗前若侧栏是打开的，退出小窗模式时会自动恢复侧栏状态。
环境要求¶
| 要求 | 说明 |
|---|---|
| Windows | 窗口操作走 Win32（user32）；macOS/Linux 上相关按钮会自动隐藏 |
| DSH NEXT 桌面端 | 需能操作原生窗口的桌面宿主；纯浏览器 Web GUI 无法使用 |
| koffi | DSH NEXT 自带；缺失时降级用 PowerShell 发现句柄，拖动动效会受限 |
| PowerShell | 仅启动时发现一次窗口句柄，之后主要在 Node Host 内完成 |
README 记载已在 DSH NEXT 0.2.1-rc.2（profile desktop）上测试。插件要求 Node >= 20。
安装与启用¶
在 DSH 插件管理里搜索 dsh-compact-window 安装，或由 Agent 执行官方命令：
plugin_manager install_bundle dsh-compact-window
安装后进入任意会话，输入框右侧应出现小窗按钮；若未出现，刷新页面（Ctrl+R）。插件通过 cordis.patch.yml 注册 bundle，客户端脚本注入 @deepseek-ai/dsh-client-ui-conversation，immediately: true 即加载。
典型用法¶
- 在 Windows 上打开 DSH NEXT 桌面端（非
dsh desktop），确认插件已安装并刷新会话页。 - 在输入框右侧点击「画中画」图标，主窗口进入小窗模式。
- 需要临时让其他窗口盖住时，点击顶部「图钉」关闭置顶；需要移动位置时，拖动顶部 40px 拖动带。
- 在小窗内按需打开侧栏，观察抽屉浮层而非窄栏挤压聊天区。
- 再次点击画中画或按插件提供的退出路径回到普通窗口；侧栏与窗口位置按 README 所述恢复或保留。
卸载插件时会自动还原窗口；插件不修改 DSH 安装目录，升级 DSH 不会覆盖插件文件。
适用场景与注意¶
适合：在 Windows 上长期用 DSH NEXT 对话、希望对话窗口像便签一样置顶、缩窄占位，同时仍要用侧栏查会话或工具的用户。
务必知晓：
- 插件在当前 DSH 进程权限下运行，安装前建议阅读 GitHub 源码 与 MIT 许可证，确认可接受 Host 侧 Win32 调用与客户端 DOM/CSS 注入。
- 布局与动画依赖 DSH 内部 DOM/样式约定，非稳定 API；失效时表现为样式退回，而非必然报错。
- 为保留侧栏动画，插件会覆盖框架里对
prefers-reduced-motion的禁用规则；若不需要动画，可按 README 从client.js移除FRAME_ANIM_CSS。 - 社区目录 SkillHub 插件页 与 GitHub 为独立信息源，与 DeepSeek / 幻方无官方从属关系；安装与行为以仓库 README 为准。
结尾¶
dsh-compact-window 把 DSH NEXT 在 Windows 上的主窗口收成 425px 宽、可置顶、可拖动的便签式小窗，并用抽屉侧栏减轻窄窗下的布局挤压。需要安装命令、限制与实现文件划分时，可直接查阅仓库 README。
- 目录页：https://www.skillhub.cn/plugins/jan0107/dsh-compact-window
- GitHub：https://github.com/jan0107/dsh-compact-window
