前言¶
在 DeepSeek Harness（DSH）里，左侧会话与导航栏占掉不少横向空间。若长期保持展开，中间工作区会变窄；若完全依赖手动点开关，频繁切换又打断节奏。常见做法是接受默认布局，或在不同场景下反复点开、收起侧栏。
下面介绍社区插件 dsh-hover-sidebar（维护者 VanlxyG）：侧栏收起后，鼠标移到窗口左缘可自动展开，移出后延迟收起；若你用手动方式固定打开侧栏，则不会自动关。插件通过 Harness 公开的布局动作操作左栏，不修改宿主文件，不读取会话或凭据，也不发网络请求。
这是什么¶
dsh-hover-sidebar 是面向 DSH 桌面版与 Web 版的布局增强插件：实现「悬停展开、移开收起」，并区分「临时悬停展开」与「手动固定展开」。零运行时依赖，无需构建，无安装脚本；在插件清单里对 Web 客户端注入布局相关能力，并调用 layout.toggleSidebar() 控制左栏。
仓库：VanlxyG/dsh-hover-sidebar。SkillHub 目录页：plugins/VanlxyG/dsh-hover-sidebar。许可证为 MIT。
核心行为¶
插件只处理鼠标与悬停笔事件，不用触摸手势触发；动画会遵循系统「减少动态效果」设置。README 中的交互约定如下。
| 操作 | 结果 |
|---|---|
| 收起后，在窗口左边缘停留 120ms | 自动展开。桌面默认热区 12px；Web 版整个收起图标栏都有效 |
| 鼠标离开侧栏右边缘及 24px 缓冲区 | 300ms 后收起；返回侧栏取消收起 |
| 手动点击原生开关或使用宿主快捷键打开 | 固定展开，不自动关闭 |
| 手动收起时鼠标仍停在左缘 | 移出热区再回来才重新展开 |
| 在临时展开的侧栏里输入、使用键盘导航或菜单 | 保持展开，交互结束后重新判断 |
| 拖拽、调整栏宽、按住鼠标按钮 | 暂停自动触发 |
| 按 Escape | 收起临时展开的侧栏 |
实现上不导入宿主内部模块，DOM 适配集中处理；侧栏 DOM 被热替换后会重新绑定。无法识别布局或缺少能力时会停止增强，禁用或卸载后不再拦截事件。
安装与启用¶
先做发行包安装，再在宿主里打开开关。
桌面版¶
在官方桌面版 设置 → 插件 的添加插件入口，填入发行包地址：
https://github.com/VanlxyG/dsh-hover-sidebar/releases/download/v0.2.0/dsh-hover-sidebar-0.2.0.tgz
也可以从 发行版本 下载 .tgz，在添加插件处选择本地包。安装后按宿主提示刷新页面或重启。
安装完成后，在 设置 → 插件 找到「侧边栏悬停展开」，用旁边的开关启停。宿主会保存选择并管理卸载；支持热卸载的宿主会即时清理监听、计时器和动画。
不要仅手工复制到 node_modules：正式安装需要同时记录依赖、来源和 bundle，否则宿主重装依赖后可能丢包。
从旧的手工 cordis.patch.yml 迁移时，应先备份并删除用户配置里旧的 - insert: ... id: hover-sidebar / name: dsh-hover-sidebar 登记块，再通过管理器安装，避免重复实例。
Web 版¶
Web 版可用 CLI 添加同一发行包：
dsh plugin --profile web add https://github.com/VanlxyG/dsh-hover-sidebar/releases/download/v0.2.0/dsh-hover-sidebar-0.2.0.tgz
桌面 profile 请使用桌面端自己的插件管理入口，不要与 Web 命令混用。
典型用法与调参¶
默认延时与热区宽度可直接使用：左缘停留约 120ms 展开，离开侧栏及缓冲约 300ms 后收起。需要固定侧栏时，用 Harness 原生侧栏开关或快捷键即可，插件会视为手动固定展开。
高级参数可在页面开发者工具中设置，写入当前浏览器源的本地存储并立即生效。浏览器侧开关与宿主插件管理里的包启用状态分别保存；若要跨重启稳定停用，应使用 设置 → 插件 里的开关。
__dshHoverSidebar.configure({ hotzonePx: 16, leaveDelayMs: 450 })
__dshHoverSidebar.setEnabled(false) // 当前浏览器的功能开关
__dshHoverSidebar.setEnabled(true)
__dshHoverSidebar.configure({}) // 恢复默认
__dshHoverSidebar.state() // 诊断，不含会话或凭据信息
__dshHoverSidebar.stop() // 卸载本次实例，下次刷新恢复
常用参数默认值与范围（摘自 README）：
| 参数 | 默认 | 允许范围 |
|---|---|---|
hotzonePx |
12 | 1–48px |
keepOpenMarginPx |
24 | 0–80px |
openDelayMs |
120 | 0–2000ms |
leaveDelayMs |
300 | 0–5000ms |
animMs / closeAnimMs |
260 / 200 | 0–1200ms |
railMaxPx |
100 | 48–160px，用于识别收起图标栏 |
兼容性与适用场景¶
当前适配基线为官 DSH 0.2.1-rc.2 的布局契约；桌面收起宽度 0、Web 图标栏宽度 56 的交互在仓库中有独立浏览器验收。官方 Harness 处于快速迭代，可能出现破坏性变更，任何插件都无法保证永远不受更新影响；本插件通过公开布局 API、单实例与幂等卸载等方式降低维护成本，但不等于阻止宿主删除或重置整个 profile。
适合希望侧栏默认收起、又需要靠左缘快速唤出导航的 DSH 用户。安装前建议自行查看仓库源码与 MIT 许可证：插件以当前 DSH 进程权限运行，只应安装你信任的来源。标准 bundle 可由宿主管理；要在 dsh-market 公开「发现」列表中被搜到，还需向 awesome-dsh-plugin 社区目录提交收录，建仓或安装成功本身不表示已收录。
结尾¶
dsh-hover-sidebar 用悬停与延迟收起补全 DSH 左栏的「临时展开」体验，并与手动固定展开区分开。当前发行版本为 v0.2.0，按上文地址安装并在插件列表中启用即可试用。
- 目录页：https://www.skillhub.cn/plugins/VanlxyG/dsh-hover-sidebar
- GitHub：https://github.com/VanlxyG/dsh-hover-sidebar
