悬停侧栏 VanlxyG/dsh-hover-sidebar

dsh-hover-sidebar

DeepSeek Harness 左栏悬停展开，移开收起。 手动打开的侧栏保持展开。

English · 发行版本 · 反馈问题

零运行时依赖，无需构建，无安装脚本。插件通过 Harness 的 layout.toggleSidebar() 操作左栏；不修改宿主文件，不读取会话或凭据，不发送网络请求。

安装与开关

在官方桌面版 设置 → 插件 的添加插件入口，填入发行包地址：

https://github.com/VanlxyG/dsh-hover-sidebar/releases/download/v0.2.0/dsh-hover-sidebar-0.2.0.tgz

也可以下载发行页中的 .tgz，在添加插件处选择本地包。安装后按宿主提示刷新页面或重启。

安装完成后，在 设置 → 插件 找到「侧边栏悬停展开」，使用旁边的开关启停。宿主会保存选择，并管理卸载。支持热卸载的宿主会即时清理监听、计时器和动画；宿主要求刷新时，刷新后完成启停。

Web 版可用命令行：

dsh plugin --profile web add https://github.com/VanlxyG/dsh-hover-sidebar/releases/download/v0.2.0/dsh-hover-sidebar-0.2.0.tgz

桌面配置档请使用桌面端自己的插件管理入口。不要仅手工复制到 node_modules：正式安装需要同时记录依赖、来源和 bundle；否则宿主重装依赖后可能丢包。

从旧手工版本迁移时，应先备份并删除用户 cordis.patch.yml 中旧的 - insert: ... id: hover-sidebar / name: dsh-hover-sidebar 登记块，再通过管理器安装，避免重复实例。保留其他插件和配置。

使用

| 操作 | 结果 |
| 收起后，在窗口左边缘停留 120ms | 自动展开。桌面默认热区 12px；Web 版整个收起图标栏都有效 |
| 鼠标离开侧栏右边缘及 24px 缓冲区 | 300ms 后收起；返回侧栏取消收起 |
| 手动点击原生开关或使用宿主快捷键打开 | 固定展开，不自动关闭 |
| 手动收起时鼠标仍停在左缘 | 移出热区再回来才重新展开 |
| 在临时展开的侧栏里输入、使用键盘导航或菜单 | 保持展开，交互结束后重新判断 |
| 拖拽、调整栏宽、按住鼠标按钮 | 暂停自动触发 |
| 按 Escape | 收起临时展开的侧栏 |

仅处理鼠标和悬停笔事件，不用触摸手势触发。动画遵循系统「减少动态效果」设置。

兼容性

当前适配基线：官方 DSH 0.2.1-rc.2 的布局契约。桌面收起宽度 0、Web 图标栏宽度 56 的交互与动画有独立浏览器验收。

宿主处于快速迭代阶段，官方明确提示可能出现破坏性变更。任何插件都无法保证永远不受更新影响。这里用以下措施减少维护成本：

- 无宿主内部模块导入、无锁定版本的 DSH peer 依赖、无 React 或打包器依赖。
- 只调用布局服务公开动作；DOM 适配集中在一个函数中，接受变化的 CSS 模块哈希。
- 侧栏 DOM 被热替换后自动重新绑定；无法识别布局或缺少能力时停止增强，不猜测其他按钮。
- 幂等卸载与单实例替换，禁用后不继续拦截事件或改变动画。
- 提交自动运行逻辑测试、打包检查和真实 Chromium 回归。

兼容宿主更新不等于阻止宿主删除或重置整个配置档。正式安装能让依赖管理器知道此包存在；整份配置档被覆盖仍需从备份或发行包恢复。

调参

默认值适合直接使用。高级参数可在页面开发者工具设置；保存在当前浏览器源的本地存储，立即生效：

__dshHoverSidebar.configure({ hotzonePx: 16, leaveDelayMs: 450 })
__dshHoverSidebar.setEnabled(false) // 当前浏览器的功能开关
__dshHoverSidebar.setEnabled(true)
__dshHoverSidebar.configure({}) // 恢复默认
__dshHoverSidebar.state() // 诊断，不含会话或凭据信息
__dshHoverSidebar.stop() // 卸载本次实例，下次刷新恢复

浏览器功能开关与宿主的包启用状态分别保存。需要跨重启、跨页面稳定停用时，使用宿主插件管理开关。随机端口的桌面源可能使浏览器参数在重启后回到默认。

| 参数 | 默认 | 允许范围 |
| 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，用于识别收起图标栏 |
| smooth / enabled | true | 布尔值 |
| easing / closeEasing | 见源码 | 标准 easing 名称或合法 cubic-bezier |

开发与发布

Node.js 22 或更新版本，使用内置测试运行器。无需 npm install。

npm test
npm run check
npm run test:browser
npm run pack:release

浏览器测试自动启动隔离的无界面 Chrome / Edge，使用随机回环端口和临时用户目录；不接入日常浏览器，不读取 DSH 凭据。无法自动找到浏览器时，设置 BROWSER_BIN 为其可执行文件路径。测试产物在被忽略的 artifacts/，发行包及校验和在 dist/。
main 的 CI 全部通过后，自动为新的 package.json 版本创建 GitHub Release，附上 .tgz 和 SHA256SUMS；已存在的发行版本不覆盖。发布新版本时，同步更新 package.json、client.js 中的版本号和安装示例，再维护 CHANGELOG.md。

市场与安全

标准 bundle 可以由宿主管理。要在 dsh-market 的公开「发现」列表中搜到，还需要向 awesome-dsh-plugin 社区目录提交收录申请；市场官方说明明确由该目录维护列表。建仓或安装成功本身不表示已经收录。

见 SECURITY.md 的边界与漏洞报告方式，见 CONTRIBUTING.md 的维护约定。MIT 许可证。