前言¶

在 DeepSeek Harness（DSH）裏裝多了客戶端插件後，側欄會出現大量「面板行」和第三方插件入口。默認佈局裏，這些條目各佔一行，底部 footer 區域也會隨插件增多而變長。若只靠手動滾動找入口，或頻繁在側欄與設置頁之間切換，日常開發體驗會變差。

社區插件 @qdnbd/dsh-panel-pins（倉庫 QDNBD/dsh-panel-pins）面向上述場景：把全局面板行與插件入口收進分組啓動器，配合持久化的固定/取消固定、緊湊 footer 和獨立設置頁，在不改寫宿主業務邏輯的前提下整理側欄。下面介紹其定位、能力與安裝用法。

這是什麼¶

dsh-panel-pins 由維護者 QDNBD 發佈，npm 包名爲 @qdnbd/dsh-panel-pins，當前資料中的版本爲 0.11.0，許可證 MIT。在 DSH 插件目錄中歸類爲客戶端插件；package.json 聲明客戶端運行於 web 平臺，且要求 DSH 版本 >=0.2.0-rc.1 <0.3.0-0。

一句話定位：側欄面板管理——分組啓動器、持久 pin/unpin、可切換的緊湊 footer，以及完整的「面板收納」設置頁。

核心功能¶

Panels 啓動器¶

側欄增加與宿主行像素對齊的 Panels 行（帶計數徽章）。點擊後打開分組、可搜索的菜單：

• Global panels：完整面板清單（含已固定與未固定）；當前打開項高亮；未固定面板可通過臨時 pin 的「peek」打開，結束後恢復原有 pin 狀態。
• Plugin entries：自動識別第三方插件入口行（README 說明爲結構推導，無硬編碼選擇器），從菜單打開時觸發原始按鈕，不改動各插件自有打開邏輯。
• 菜單內支持搜索與完整鍵盤導航（輸入過濾、↑↓ 移動、Enter 打開、Esc 關閉）。
• 分組可摺疊，摺疊狀態在菜單重開與應用重啓後保留。
• 懸停行可進行 pin / unpin / to-top 等快捷操作。

Ctrl+K 命令面板¶

任意位置 Ctrl+K 打開居中命令面板：同一套清單加上快捷命令（收集行、僅圖標模式、緊湊 footer、打開 Settings）。README 註明不會劫持宿主文本輸入框。

右鍵與僅圖標模式¶

任意側欄行可右鍵：打開、pin、unpin、to-top、keep-in-sidebar 等，支持鍵盤操作。

Icon-only panel rows 可將面板行收成約 18px 寬的 glyph 列，介於完整行與完全收進菜單之間的折中方案。

固定、置頂與分組摺疊¶

• pin/unpin 狀態持久化；固定項在側欄，未固定項仍可從菜單到達。側欄 More 菜單中提供 pin/unpin 相關入口。
• Top-pinning 可將選定面板置頂（摺疊圖標軌同樣生效）；在 Settings 中拖拽排序，實現方式爲負 CSS order，避免 DOM 改寫與宿主重渲染衝突。
• 可獨立摺疊「全局面板行」與「插件入口行」的顯示，狀態持久化。

緊湊 footer¶

默認開啓、可關閉的 Compact footer：限制 footer 插件操作區高度（15vh、內部滾動），縮小內聯配對 QR、收緊品牌行與 cost-meter。子開關覆蓋 QR 縮放、品牌行、cost-meter 及高度滑塊。

README 說明：底部 footer 條目本身不會被收進菜單，僅容器高度受限並內部滾動。

Settings → 面板收納¶

設置頁 Settings → 面板收納 集中管理：各類開關、四個實時高度滑塊（面板列表 / footer / 彈層 / QR 尺寸）、whitelist（按 id 優先存儲，便於界面語言切換後仍有效）、帶拖拽排序的 pin 管理列表，以及設置導出/導入（剪貼板 JSON）便於換機遷移。

主題¶

菜單與滾動條使用宿主主題 token（如 --dsw-menu-surface-fill 等），README 稱與主題及 dsh-any-background 等插件兼容，無硬編碼白/灰。

安裝與啓用¶

在 DeepSeek Harness Desktop 中，可通過 Settings → Plugins 從列出該包的插件市場安裝 @qdnbd/dsh-panel-pins，或在終端執行：

dsh plugin --profile <your-profile> add @qdnbd/dsh-panel-pins

將 <your-profile> 替換爲你的 DSH profile 名稱。安裝後重啓應用。

典型用法¶

1. 點擊側欄帶計數徽章的 Panels 行 → 在分組菜單中搜索並打開面板或插件入口。
2. 在任意界面按 Ctrl+K → 使用命令面板與完整清單。
3. 右鍵側欄任意行 → 打開、固定、置頂或保留在側欄。
4. 打開 Settings → 面板收納 → 調整開關、滑塊、白名單、pin 順序，或導出/導入 JSON 配置。

本地狀態與配置鍵¶

狀態保存在 localStorage，鍵前綴爲 dsh-panel-pins:，重啓後保留。資料中列出的鍵含義如下：

適用場景與注意¶

適合側欄插件與面板較多、希望統一入口、鍵盤操作和可遷移配置的 DSH 桌面用戶。README 平臺徽章標註 Windows；引擎字段仍以 package.json 中的 dsh 與 client.platform: web 爲準，安裝前請對照你的 DSH 版本是否在 >=0.2.0-rc.1 <0.3.0-0 範圍內。

DSH 插件在當前 dsh 進程權限下運行，安裝前應自行查看 GitHub 源碼 與 MIT 許可證，確認符合你的安全與合規要求。社區目錄 skillhub.cn 插件頁 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。

實現上，插件不對宿主樣式表做逐幀改寫，切換依賴 class / CSS 自定義屬性，README 稱可即時切換且減少閃爍。

結尾¶

dsh-panel-pins 把側欄面板與插件入口收成可搜索、可固定的啓動器，並用設置頁與白名單、導出導入補全長期使用的可控性。若你已在用 DSH 0.2.x 客戶端生態，可按上文命令安裝並在 面板收納 中微調佈局。

• 目錄頁：https://www.skillhub.cn/plugins/QDNBD/dsh-panel-pins
• GitHub：https://github.com/QDNBD/dsh-panel-pins