dsh-settings-sections:管理 DeepSeek Harness 設置側欄的顯示、隱藏與排序

前言

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 註冊的,本插件的做法是:

  1. settings.section 註冊一個自己的管理頁,放在最頂部;
  2. 讀取所有已註冊板塊,渲染成開關列表;
  3. 切換開關時,通過 MutationObserver 把左側導航裏被隱藏板塊對應的按鈕隱藏(display:none);
  4. 拖動排序時,按自定義順序重排左側導航按鈕的 DOM 位置;
  5. 隱藏列表與排序都寫入 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 安裝。

典型用法

打開「設置」→ 頂部「設置板塊」進入管理頁:

  1. 勾選或取消勾選各板塊右側的開關,顯示或隱藏對應板塊;
  2. 按住某一行左側的「⠿」手柄上下拖動,調整板塊在左側導航裏的順序;
  3. 想恢復原狀時,點「全部顯示」或「恢復默認排序」一鍵恢復。

切換開關立即生效;隱藏列表與排序寫入 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、幻方沒有官方從屬關係。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜