前言¶
DeepSeek Harness(DSH)左側邊欄會堆上插件、插件市場、自動化任務、靈樞、上下文洞察、WSL 等入口。裝得多了,主導航就擠在一起,真正常用的往往只有幾項。官方側邊欄本身不提供「只顯示常用、其餘摺疊」的粒度控制;若靠改主題或手工改 DOM,既難維護,升級客戶端後也容易失效。
下面介紹社區插件 dsh-sidebar-overflow(維護者 cxv117793-blip):它不新增主導航按鈕的業務邏輯、也不替換官方側邊欄組件,而是在官方擴展槽位上註冊「更多」,由你在菜單裏逐項決定哪些入口留在側邊欄、哪些收進「更多」。當前 Release 爲 v0.1.0,許可證 MIT。
這是什麼¶
dsh-sidebar-overflow 是 DSH 客戶端類插件:在主導航列表末尾出現官方 shell 渲染的「更多」入口,點開可看到當前全部側邊欄項(含底部工具區),每一項都能單獨切換「收進『更多』/ 顯示到側邊欄」。收進去的入口並未刪除,仍可從「更多」打開;選擇寫入 profile 的 cordis.patch.yml,完全退出應用再啓動後仍會恢復。
插件目錄頁:https://www.skillhub.cn/plugins/cxv117793-blip/dsh-sidebar-overflow
源碼與說明:https://github.com/cxv117793-blip/dsh-sidebar-overflow
核心功能¶
資料中明確列出的能力如下。
| 能力 | 說明 |
|---|---|
| 逐個選擇 | 菜單列出全部入口,每行可切換收進「更多」或顯示到側邊欄 |
| 搜索過濾 | 菜單頂部搜索框按名稱篩選;無匹配時有明確空態 |
| 一鍵還原 | 「全部恢復」清空 panel: 與 footer: 兩類鍵,全部放回 |
| 失效條目清理 | 插件卸載後配置可能殘留 panel:<已刪除的 id>,菜單會提示,可用「全部恢復」清理 |
| 底部工具區 | 側邊欄底部小按鈕(用量、餘額等)也可隱藏 |
| 即時生效 | 點擊後立刻變化,無需刷新頁面 |
| 重啓保留 | 寫入 cordis.patch.yml,DSH 重啓後回放 |
| 中英雙語 | 跟隨 DSH 語言設置 |
使用上的固定規則(README 寫明):「插件」入口不能收起(插件管理器入口);「更多」按鈕在插件啓用後常駐列表末尾;本版不做拖拽排序;菜單不記憶滾動位置。
安裝與啓用¶
插件以當前 DSH 進程權限在客戶端運行,安裝前建議通讀倉庫源碼並確認 MIT 許可證。README 說明:僅寫一個配置字段 config.hidden,不寫會話數據、不聯網、不上報。
桌面版 不要 用 dsh plugin --profile desktop ... 改 profile——該 profile 由 Electron 應用內插件管理器獨佔,命令行會拒絕(profile "desktop" is managed exclusively by the Electron application)。
任選一種安裝方式:
1、從本地目錄(開發/自用)
在 DSH 內:設置 → 插件 → 添加插件 → 從本地目錄,選中倉庫根目錄。
2、從 GitHub 倉庫
在同一安裝框粘貼:
https://github.com/cxv117793-blip/dsh-sidebar-overflow
3、從 Release 的 .tgz
永遠指向最新版(文件名固定):
https://github.com/cxv117793-blip/dsh-sidebar-overflow/releases/latest/download/dsh-sidebar-overflow.tgz
鎖定 v0.1.0:
https://github.com/cxv117793-blip/dsh-sidebar-overflow/releases/download/v0.1.0/dsh-sidebar-overflow-0.1.0.tgz
也可先下載再裝:
curl -L -o dsh-sidebar-overflow.tgz \
https://github.com/cxv117793-blip/dsh-sidebar-overflow/releases/latest/download/dsh-sidebar-overflow.tgz
非 desktop 的 profile 纔可用命令行(路徑換成本地倉庫絕對路徑):
dsh plugin --profile <你的profile> add file:<本倉庫絕對路徑>
裝完之後必須 完全退出應用(文件 → 退出,或托盤右鍵退出)再啓動。僅刷新頁面不夠——客戶端模塊只在應用啓動時裝配一次;否則界面可能看不到「更多」。裝好後主導航末尾應出現「更多」(寬側邊欄帶文字,窄側邊欄爲圖標)。
開發與實測環境爲 DSH 0.2.1-rc.3(CLI 0.2.0-rc.2)。插件依賴 slots、locale、configForms 等服務面,未在 README 中聲明更老版本的驗證結果。Node 要求見 package.json:^22.19.0 || >=24.0.0。
典型用法¶
- 點側邊欄 更多。
- 在 已收進「更多」 分組中,點 顯示到側邊欄 把項放回主導航。
- 在 留在側邊欄 分組中,點 收進『更多』 挪走不常用項。
- 在 底部工具區 分組中,同樣雙向切換底部小按鈕。
- 分組標題旁 全部恢復 可一次清空收納狀態。
點「插件」會提示「該面板不能收起」。全部恢復後「更多」仍在,菜單可能顯示「還沒有收起來的按鈕」,側邊欄視覺與未收納時一致。
若需手工編輯配置,在 profile 的 cordis.patch.yml 中示例形如:
- id: dsh-sidebar-overflow
name: dsh-sidebar-overflow
config:
hidden:
- panel:dsh-wsl
- panel:dsh-market
- footer:0
鍵名規則:panel: 後接 sidebar.panellist 裏的面板 id;footer: 爲底部工具區按渲染順序從 0 起的序號(記位置而非 id)。改完後同樣需要完全退出再啓動;重置可刪除整個 hidden 段。
工作原理(簡要)¶
全部走官方擴展點,README 概括爲:向 sidebar.panellist.actions 槽位註冊一條,官方據此渲染「更多」;通過 sidebar 插件下發的 setPinned 與自身 Config.hidden 控制主列表顯示並持久化;底部工具區無官方 pin 機制,按 DOM 順序做 best-effort 隱藏。停用或卸載時會還原 pin 狀態並清理相關 DOM 標記。
適用場景與注意¶
適合誰: 已安裝多個 DSH 插件或常用功能較多、希望主導航只留少數入口、其餘從「更多」進入的用戶。
已知限制(資料原文):
- 底部工具區按順序記憶,裝卸插件後序號可能變化,表現爲隱藏錯位;可在菜單裏重新點選修正。
- 換主題後底部隱藏可能失效。
- 無拖拽排序;菜單每次從頂部打開。
安全與權限: 插件在 DSH 客戶端進程內執行;安裝前請自行審查 GitHub 倉庫 源碼。社區目錄 SkillHub 爲獨立站點,與 DeepSeek / 幻方無官方從屬關係;DSH 生態強調「一切皆插件」,本文介紹的是社區維護的客戶端插件,非官方內置功能。
裝完看不到「更多」時:確認已完全退出重啓、且在 設置 → 插件 中已啓用。若刷新頁面後收納狀態丟失,檢查 cordis.patch.yml 是否含有 dsh-sidebar-overflow 的 config.hidden。
結尾¶
dsh-sidebar-overflow 用官方「更多」槽位和配置持久化,把「側邊欄擁擠」變成可逐項管理的收納列表,且不改變被收入口的實際能力。需要安裝包或 Issue 時,以 GitHub 爲準: