前言¶
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
