前言¶
DeepSeek Harness（DSH）桌面端可以把主侧栏收起，把更多空间留给会话区。侧栏一旦合上，工作区树、最近会话、定时任务和插件管理往往要再点一次「展开」才能到达。如果你习惯在 macOS 上长时间保持侧栏收起，又需要在这些入口之间频繁切换，dsh-sidebar-rail 把一条窄图标轨挂在窗口左缘：指针移入触发区即可滑出，不必先恢复完整侧栏。
下面按定位、能力、安装、用法和注意事项说明该插件。事实以仓库 README 与 npm 包元数据为准；社区目录页见文末链接。
这是什么¶
@skylerfee/dsh-sidebar-rail（GitHub：SkylerFee/dsh-sidebar-rail）由 SkylerFee 维护，分类为 客户端 插件，当前发布版本 v0.3.3，许可证 MIT。它通过 Cordis patch 注入 DSH 客户端 UI，在 macOS Desktop、主侧栏 已收起 且视口宽度 ≥ 768px 时，在窗口左侧提供一条默认隐藏的 56px 图标轨；用户把指针移入窗口左缘约 12px 的感应条即可显示。主侧栏展开时、Web 端、以及 README 中标注为未测试的 Windows / Linux Desktop 上均 不显示 该轨（Web 仍使用宿主自带的收起态行为）。
插件以当前 DSH profile 为单位安装与启用，不修改 DSH 本体；安装与使用前宜自行查看源码与许可证，并理解插件与宿主同进程运行、具备相应权限。
核心功能¶
图标轨初始隐藏。收起宿主侧栏后，从左缘滑出后悬停图标约 120ms 会打开对应 flyout；离开约 200ms 后关闭。在多个图标间移动时，flyout 会切换而轨不收回。
| 入口 | 作用（据 README） |
|---|---|
| Workspaces | 浏览置顶项目与按名称列出的项目；点击名称切换工作区，可用 pin 按钮置顶或取消置顶 |
| Recent sessions | 在工作区 flyout 底部独立滚动，按时间从新到旧；排除已归档、空白与 subagent 会话；可打开会话并查看相对时间与宿主状态标记 |
| Scheduled tasks | 浏览未结束或未暂停的定时任务；点行或 Open panel 进入任务面板 |
| My plugins | 浏览已安装且启用的用户插件 bundle（不含宿主 bundle）；点行进入插件管理 |
| More | 打开其他宿主面板或展开原生侧栏 |
| Account and settings | 显示头像、余额与 bonus、View usage / Top up 等链接；未登录有提示；登录、登出与支付仍在宿主或目标页完成 |
展开宿主侧栏后，仍可使用宿主自带的搜索、工作区树、账户菜单与设置；插件只读侧栏收起状态，不接管展开态布局。
键盘：Tab 聚焦到图标可显示轨；顶行功能图标上按 ↓ 或 → 进入 flyout，再在列表中 Tab；flyout 内 Escape 关闭并回到触发器；Enter 激活当前聚焦按钮（直接激活图标则导航而不进入列表）。
本地偏好：最近会话条数默认 5，可在 1–20 之间调整（工作区 flyout 底部步进器或插件详情页）。数据保存在 localStorage['dsh.sidebar-rail.v1']，字段包括 pinnedWorkspaceIds（置顶工作区 ID，最近置顶在前）与 recentCount。禁用或卸载插件后，这些本地偏好仍可能保留。
安装与启用¶
需要已配置的 DSH Desktop 或 Web 客户端 与 profile；实际轨行为以 macOS Desktop 满足条件时为准。
方式一：插件页（推荐）
在 DSH 侧栏打开 Plugins，右上角 Add plugin，在输入框填入 npm 包名并安装：
@skylerfee/dsh-sidebar-rail
按提示重启或重载 DSH，在插件列表确认 Sidebar rail 已启用。
方式二：命令行
将 desktop 换成你实际使用的 profile 名：
dsh plugin --profile desktop add @skylerfee/dsh-sidebar-rail
dsh plugin 会把参数转发到 profile 目录内的 pnpm；亦可在该目录直接 pnpm add。完成后重启 DSH。
方式三：助手安装
在已开启插件管理的 profile 中，可由助手发起工具请求（非终端命令）：
{
"action": "install_bundle",
"target": "@skylerfee/dsh-sidebar-rail"
}
禁用与卸载
| 操作 | 做法 |
|---|---|
| 禁用 | 插件页关闭 Sidebar rail 开关（依赖仍保留，可即刻再开） |
| 卸载 | 详情页 Uninstall，或 dsh plugin --profile desktop remove @skylerfee/dsh-sidebar-rail |
README 记载在 macOS Desktop 0.2.2-rc.1 上做过桌面端验证；与其他宿主版本的兼容范围见仓库 package.json 中的 peerDependencies。从源码开发或跑检查需 Node.js ≥ 22.19.0，README 说明该仓库无依赖安装或构建步骤要求。
典型用法¶
- 用宿主按钮 收起侧栏。将指针移到窗口左缘、窗口控制按钮下方，进入左缘感应区以显示图标轨。
- 悬停某一图标打开 flyout，在列表中选择条目即可导航，轨会收回。
- 需要完整搜索、设置或工作区管理时，再 展开宿主侧栏。
若视口宽度小于 768px，README 说明不会出现该轨，仍可通过宿主按钮展开侧栏。部分新设置与余额展示路径在仓库 docs/verify.md 中仍有未核实项，遇界面差异可先对照该验证记录。
适用场景与注意¶
适合：主要在 macOS DSH 桌面客户端 使用、希望侧栏常收起、又需要快速切换工作区、查看最近会话、打开定时任务或插件管理的用户。
不适合或无效：纯 Web 工作流、Windows / Linux 桌面（README 标明未测试且不提供轨）、侧栏保持展开、或窄窗口（< 768px）下的「左缘轨」预期。
DSH 生态强调「一切皆插件」；SkillHub 插件目录 为社区站点，与 DeepSeek / 幻方无官方从属关系。安装第三方 bundle 前请阅读 GitHub 仓库 源码与 MIT 许可证，并仅在信任的 profile 中启用。
结尾¶
dsh-sidebar-rail 在 macOS 桌面端侧栏收起时，用左缘感应条补上一条图标轨，把项目、最近会话、定时任务、插件与账户相关入口收到 flyout 里，减少为单次导航反复展开侧栏的次数。包名 @skylerfee/dsh-sidebar-rail，当前版本 v0.3.3。
- 目录页：https://www.skillhub.cn/plugins/SkylerFee/dsh-sidebar-rail
- 源码与文档：https://github.com/SkylerFee/dsh-sidebar-rail
