前言¶

DeepSeek Harness（DSH）客户端里，左侧栏在折叠与完全展开之间通常是二选一：折叠后主内容区变宽，但要看导航只能再点一次展开，主区域会被挤窄。若你习惯 VS Code 一类「贴边悬停先瞄一眼、再决定是否钉住」的交互，原生壳层并没有这种中间态。下面介绍社区插件 bqbs/dsh-toggle-leftside：在侧栏已折叠时，用指针悬停触发临时预览，并以浮动抽屉叠在主区域之上，不占用主内容宽度。

这是什么¶

dsh-toggle-leftside 由维护者 bqbs 发布，分类为客户端插件，当前版本 0.1.0，采用 MIT License。它复用壳层已有的 ctx.layout.toggleSidebar()，在折叠态下增加 PEEK（悬停预览） 状态，并把侧栏内层以 position: fixed 浮层绘制，主区域保持折叠时的几何与宽度不变。支持 web 与 desktop 两种 DSH 配置。

核心功能¶

悬停预览（PEEK）¶

侧栏处于折叠态时，将指针移到窗口左缘热区，或在 Web 端移到折叠图标列上，停留约 150ms 后，侧栏临时展开为浮动抽屉；指针离开约 200ms 后自动回到折叠态。主内容区全程不因预览而被横向挤压。

点击钉住（PINNED）¶

预览过程中点击折叠/展开切换按钮，会进入壳层原生的「完全展开」态；再次点击则按壳层默认行为折叠。

折叠态品牌标记¶

在 Windows 标题栏区域的折叠切换按钮上显示产品品牌标记（非 Windows 侧栏轨道已由壳层原生展示，插件不改动）。

设置开关¶

在 Settings → Compact left rail 下提供开关，值保存在 localStorage，改后立即生效，无需重载页面。偏好按浏览器/本机隔离，不会跨设备同步。

状态与动效（摘要）¶

COLLAPSED ──左缘悬停 150ms──▶ PEEK
PEEK      ──指针离开 200ms──▶ COLLAPSED
PEEK      ──点击 toggle────▶ PINNED
PINNED    ──点击 toggle────▶ COLLAPSED

抽屉进入/退出使用约 180ms 的 slide（left: -12px → 0）与 fade；z-index: 25，高于主区域 overlay（20），低于壳层菜单层，避免挡住下拉与 tooltip。

触发带：Web 端与可见的折叠图标列同宽（约 56px）；Desktop 折叠列无宽度时，回退为左侧 28px 固定边条。

安装与启用¶

DSH 以「一切皆插件」方式扩展能力；社区目录页见 SkillHub 插件页，与 DeepSeek / 幻方无官方从属关系，安装前请自行查看 GitHub 源码 与许可证。插件在当前 DSH 进程权限下运行，安装即信任其客户端注入逻辑。

图形界面： deepseek harness → Plugins → 搜索 github:bqbs/dsh-toggle-leftside → install。

命令行：

Web 配置：

dsh plugin --profile web add github:bqbs/dsh-toggle-leftside

Desktop 配置：

dsh plugin --profile desktop add github:bqbs/dsh-toggle-leftside

安装后验证：先折叠侧栏，再将指针移到窗口左缘或折叠图标上停留约 150ms，应看到浮动抽屉预览；移开约 200ms 后应收起；预览中点击 toggle 应钉住为完全展开。

典型用法¶

1. 日常保持侧栏折叠，需要查导航时将指针贴左缘或滑过折叠图标列，短暂预览即可，无需每次展开挤窄主区域。
2. 预览中若确定要长时间使用侧栏，点击 toggle 进入 PINNED，与原生展开一致。
3. 若不需要悬停行为，在 Settings → Compact left rail 关闭插件开关（localStorage），立即生效。

侧栏已经展开时，插件不附加行为（PEEK 只能从 COLLAPSED 开始）。

适用场景与注意¶

适合： 经常在折叠侧栏与全宽主区域之间切换、又希望「瞄一眼导航」的 DSH Web / Desktop 用户。

已知限制（摘自上游 README）：

• 仅指针驱动，无键盘快捷键触发 peek；触控设备上 hover 语义不同，体验弱于桌面悬停。
• 依赖壳层 DOM 结构（通过 class 后缀定位），布局大改可能失效。
• Desktop 折叠态触发带仅 28px，需贴边较准。
• 首次 peek 前 Windows 折叠按钮上的品牌 SVG 可能尚未缓存，仍显示原图标。
• 假定单一左侧栏，不处理多列或动态增删布局。
• 不处理系统「减少动效」偏好；修改 client.js 后需整窗重载（经 window.__ModuleLoader__ 快照加载）。

结尾¶

dsh-toggle-leftside 在 DSH 默认「折叠 ⟷ 展开」之外补上 悬停预览 + 浮动抽屉，让折叠态下的导航查看更轻量。进一步了解与安装：

• 目录页：https://www.skillhub.cn/plugins/bqbs/dsh-toggle-leftside
• 仓库：https://github.com/bqbs/dsh-toggle-leftside