dsh-sidebar-hover

Readme

# dsh-sidebar-hover

鼠标悬停自动展开 / 离开自动收起 **DeepSeek Harness 网页版**左侧边栏，给懒得点折叠按钮的人。

- 鼠标进入**收起态的整条侧栏**（不限上下），停留一小会 → 自动展开
- 鼠标离开侧栏 → 自动收回
- 你手点过折叠按钮 → 20 秒内不自动跟你抢
- 窄屏（<768px，官方抽屉模式）自动禁用，无任何常驻 UI

只触发 DSH 自带的折叠效果（和你手点左上角折叠按钮完全一样），不自创状态、不读会话、不碰凭据、无网络请求。

## 安装

```sh
dsh plugin --profile web add github:qq-24/dsh-sidebar-hover
```

装完**重启 dsh web**，再硬刷新一次浏览器（Ctrl+Shift+R）即可。

## 行为参数（写死在 `client.js` 头部 `CFG`，改完硬刷新生效）

| 参数 | 默认 | 说明 |
|---|---|---|
| `enterDelayMs` | 150 | 在收起栏停留多久后展开（防划过误触） |
| `leaveDelayMs` | 300 | 离开侧栏多久后收起 |
| `edgeBufferPx` | 24 | 侧栏右侧缓冲带，范围内不算离开 |
| `cooldownMs` | 600 | 每次触发后的冷却期（覆盖折叠动画） |
| `manualHoldMs` | 20000 | 手动点折叠按钮后暂停自动逻辑 |
| `breakpointPx` | 768 | 窄于此宽度禁用 |

收起栏的宽度是**每次实测**的（不是写死的 56px），主题/缩放/官方改版都不怕。
离开判定的右边界同样**每轮现量**（手动拖拽改过侧栏宽也不会陈旧）。

## 兼容性

- DSH `0.1.0-rc.6` 实测可用；原理只依赖官方折叠按钮的 `aria-label`（收起/打开侧边栏，中英双语）与 `ctx.layout.toggleSidebar()`，任一可用即工作
- 与整体替换左栏的插件（如 Codex 风格侧栏）同用时，以按钮兜底分支工作，未逐个验证

## 卸载

```sh
dsh plugin --profile web remove dsh-sidebar-hover
```

## License

[MIT](LICENSE)