前言¶
DeepSeek Harness(DSH)的理念是「一切皆插件」,設置側欄裏的每個板塊都是插件通過 settings.section slot 註冊的。插件裝多了,導航板塊隨之變多,順序又取決於註冊順序,用不到的板塊也只能一直掛在導航裏。dsh-settings-sections 就是爲這個場景準備的:把設置側欄的顯示、隱藏和排序交給用戶自己管理。下面介紹它的功能、安裝方式和使用步驟。
這是什麼¶
dsh-settings-sections 是 ovo669 維護的一個輕量插件,當前版本 1.0.1,MIT 許可證。一句話定位:在 DeepSeek Harness 設置面板裏管理「側欄板塊」顯示、隱藏與排序,純客戶端實現,狀態保存在 localStorage。
兩個特點先交代清楚:
- 純客戶端,無宿主端邏輯,兼容 DeepSeek Harness EAC(桌面客戶端);
- 隱藏板塊只是不在導航裏顯示,不會刪除任何設置內容,隨時可以重新開啓。
核心功能¶
按 README 描述,插件提供這些能力:
- 在「設置」導航頂部新增一個「設置板塊」管理頁;
- 每個板塊一個開關,點擊立即顯示或隱藏對應板塊;
- 拖動某一行左側的手柄可調整板塊順序,順序同步到左側導航;
- 「全部顯示」「恢復默認排序」一鍵恢復;
- 隱藏狀態與排序保存在 localStorage,重啓後自動恢復。
實現原理¶
DSH 設置側欄的每個板塊都是插件通過 settings.section 這個 slot 註冊的,本插件的做法是:
- 向
settings.section註冊一個自己的管理頁,放在最頂部; - 讀取所有已註冊板塊,渲染成開關列表;
- 切換開關時,通過 MutationObserver 把左側導航裏被隱藏板塊對應的按鈕隱藏(
display:none); - 拖動排序時,按自定義順序重排左側導航按鈕的 DOM 位置;
- 隱藏列表與排序都寫入 localStorage。
整個過程純客戶端完成,不涉及宿主端邏輯。
安裝¶
README 提供兩種安裝方式,未給出 CLI 安裝命令。
方式一:手動安裝¶
先把倉庫(或 dsh-settings-sections 文件夾)放到 profile 的 node_modules:
C:\Users\<用戶名>\.dsh\profiles\<profile>\node_modules\dsh-settings-sections\
再在 profile 的 cordis.patch.yml 末尾加入:
- insert:
- id: settings-sections
name: 'dsh-settings-sections'
然後完全退出 DSH 再打開,按 Ctrl+Shift+R 刷新頁面。經過上面的步驟,管理頁就會出現在設置導航頂部。插件聲明的 peerDependency 是 @deepseek-ai/cordis ^4.0.1。
方式二:插件市場¶
倉庫帶有 dsh-plugin 標籤,可以在 DSH 的 Zat 插件市場搜索 dsh-settings-sections 安裝。
典型用法¶
打開「設置」→ 頂部「設置板塊」進入管理頁:
- 勾選或取消勾選各板塊右側的開關,顯示或隱藏對應板塊;
- 按住某一行左側的「⠿」手柄上下拖動,調整板塊在左側導航裏的順序;
- 想恢復原狀時,點「全部顯示」或「恢復默認排序」一鍵恢復。
切換開關立即生效;隱藏列表與排序寫入 localStorage,重啓 DSH 後仍會保留。
適用場景與注意事項¶
適合的場景:
- 安裝的插件較多,設置側欄板塊擁擠,想隱藏不常用的板塊;
- 對板塊順序有偏好,想讓高頻板塊排在導航前面;
- 順序被打亂後,需要一鍵恢復默認排序。
安裝前需要注意:
- 插件以當前 dsh 進程的權限運行,安裝前建議查看倉庫源碼,確認行爲符合預期;
- 許可證爲 MIT,倉庫地址見文末;
- 隱藏板塊不會刪除任何設置內容,隨時可在管理頁重新開啓。
結尾¶
dsh-settings-sections 解決的是一個小而具體的問題:設置側欄的顯示與排序。如果 DSH 裏的板塊越裝越多,可以用它整理一遍,成本低,隨時可逆。
- 社區插件目錄頁:https://www.skillhub.cn/plugins/ovo669/dsh-settings-sections
- GitHub 倉庫:https://github.com/ovo669/dsh-settings-sections
其中 skillhub.cn 是獨立的社區插件目錄,與 DeepSeek、幻方沒有官方從屬關係。