jan0107/dsh-compact-window

dsh-compact-window

把 DSH NEXT 桌面窗口变成置顶的便签式小窗：只占 425px 宽，随时可以收成一个浮层，边栏变成抽屉，不挤压聊天区。

Small-window mode for the DSH NEXT desktop app (Windows): turn the main window into a 425px-wide, always-on-top sticky window. The other desktop client, dsh desktop, is not supported.

功能

• 一键进小窗：输入框右侧（发送键左边）的"画中画"图标。窗口切成 425 逻辑像素宽、置顶、不占任务栏
• 置顶开关：小窗顶部右上角、系统按钮左边的"图钉"。取消后其他程序可以盖住它；选择会被记住
• 拖动：小窗顶部 40px 是拖动带，跨显示器、不同缩放比例都保持 425 逻辑像素宽
• 抽屉式侧栏：小窗里展开侧栏会以抽屉形式浮在聊天上，不再把文字挤成一团
• 过渡动效：进出小窗有半透明遮罩 + 缓动动画；侧栏开合在普通窗口下也有 200ms 过渡
• 状态记忆：小窗位置、置顶偏好会记住；进入小窗前侧栏是开着的，退出时自动恢复

环境要求

要求 · 说明 Windows · 窗口操作走 Win32（user32），macOS/Linux 上插件会让按钮自动隐藏 DSH NEXT 桌面端 · 只支持 DSH NEXT。需要能操作原生窗口的桌面宿主；浏览器里的 Web GUI 只是网页，没有窗口可调 其他桌面客户端 · 另一个桌面端 `dsh desktop` 未适配，预计不可用；找不到窗口时插件只会隐藏按钮，不会误操作 koffi · DSH NEXT 自带（resources/app.asar.unpacked/node_modules/koffi）；找不到时会降级到 PowerShell，无拖动动效 PowerShell · 仅用于启动时发现一次窗口句柄；之后全部在 Node 内完成

已测试版本：DSH NEXT 0.2.1-rc.2（profile desktop）。

安装

在 DSH 的插件管理里搜索 dsh-compact-window 安装，或让 Agent 执行：

plugin_manager install_bundle dsh-compact-window

安装后进入任意会话，输入框右侧会出现小窗按钮；没有出现就刷新一次页面（Ctrl+R）。

已知限制

• 依赖 DSH 内部布局：抽屉与侧栏动画依赖框架层的 data-shell-overlay / data-sidebar-collapsed 和 grid-template-columns，这些不是公开契约。DSH 大版本改布局时可能失效，失效表现是"退回原来的挤压样式"，不会崩溃
• 不修改 DSH 安装目录：所有操作都在运行时通过 Win32 完成，升级 DSH 不会覆盖；卸载插件时会自动还原窗口
• 系统"减弱动态效果"不生效：为了让侧栏有动画，插件会覆盖框架里 prefers-reduced-motion 的禁用规则。不想要动画的话把 client.js 里的 FRAME_ANIM_CSS 去掉即可

实现

文件 · 作用 index.js · Host 半：窗口几何、置顶、隐藏任务栏、拖动循环、动画、/compact-window 路由 client.js · 客户端半：按钮、拖动带、图钉、遮罩、抽屉样式、侧栏过渡 window.ps1 · 启动时发现窗口句柄的兜底（koffi 不可用时才走） cordis.patch.yml · 插入 compact-window 插件行 locale/*.json · 插件管理页显示的名称与描述 icon.svg · 插件图标

窗口操作全部在 Host 进程内用 koffi 直接调 Win32，不拉起额外进程（首次窗口发现除外）。

License

MIT