前言¶
DSH 客戶端在接入多個插件後,左側欄底部可能同時出現多個按鈕。按鈕來自不同插件時,順序、高度和顯示方式容易不一致;有些按鈕需要長期可見,有些只想收進次級入口,有些則希望暫時不顯示。
lywusichen/dsh-sidebar-buttons 是一個 DeepSeek Harness(DSH)客戶端插件,用來管理左側欄底部按鈕:拖拽排序、三種顯隱模式、統一高度。它只在客戶端運行,不修改 DSH 核心,卸載後恢復原始側欄。
這是什麼¶
- 插件名:
lywusichen/dsh-sidebar-buttons - 維護者:
lywusichen - 許可證:MIT
- 運行範圍:僅 DSH 客戶端,
dsh.client.platform聲明爲web - 依賴環境:
package.json聲明engines.node >= 22 - 核心作用:在 Settings 中新增 Sidebar Buttons 頁面,集中管理側欄底部註冊按鈕
這個插件不替換 DSH 核心功能,也不改變後端行爲。它把“側欄底部按鈕的顯示與排序”做成一個可設置的界面。
核心功能¶
排序¶
Settings 中的 Sidebar Buttons 頁面會列出側欄底部已註冊的按鈕。頁面支持拖拽行,拖完順序會即時更新到側欄。
顯隱模式¶
每個按鈕支持三種模式:
Show:按鈕固定在側欄顯示。Fold into More:按鈕移入 Settings 上方的 More 按鈕中,進入 More 菜單後仍可使用;More 按鈕僅在至少一個按鈕被摺疊時顯示。Hide:按鈕同時從側欄和 More 菜單移除;如果誤隱藏,只能從設置頁恢復。
高度¶
不同插件註冊的按鈕可能有不同高度。插件支持三種高度處理:
- 爲所有按鈕選擇統一高度
- 保留每個按鈕的原始高度
- 輸入自定義高度
安裝與啓用¶
安裝命令用於在 web profile 下添加該插件:
dsh plugin --profile web add github:lywusichen/dsh-sidebar-buttons
執行後需要重啓 DSH,讓客戶端加載插件。隨後打開設置頁查看新增的 Sidebar Buttons 頁面:
- 重啓 DSH
- 打開 Settings
- 進入 Sidebar Buttons
典型用法¶
下面這些步驟都發生在 Settings 的 Sidebar Buttons 頁面中:
- 拖拽按鈕行,調整左側欄底部按鈕的順序;側欄會即時更新。
- 爲每個按鈕選擇
Show、Fold into More或Hide。 - 如果按鈕高度不一致,選擇統一高度、保留原始高度,或輸入自定義高度。
- 如果某個按鈕被設爲
Hide,之後回到該設置頁重新選擇顯示模式即可恢復。
適用場景與注意¶
適合這些情況:
- 多個 DSH 客戶端插件同時註冊了側欄底部按鈕
- 希望把不常用的按鈕摺疊進 More,而不是直接刪除
- 需要把不同來源按鈕的高度對齊
- 只想在本地客戶端調整界面,不改 DSH 核心代碼
安裝前注意:
- 該插件以當前
dsh進程權限運行,安裝前應檢查源碼與許可證。 - 許可證爲 MIT。
- 僅用於 web 客戶端;
package.json中dsh.client.platform爲web。 Hide後按鈕不會出現在側欄和 More 菜單中,只能從設置頁恢復。- 社區目錄是獨立站點,不等同於官方應用商店;本文給出的目錄 URL 來自插件線索,未在當前資料中直接出現,使用時可按
lywusichen/dsh-sidebar-buttons覈對。
鏈接¶
- GitHub:lywusichen/dsh-sidebar-buttons
- 社區目錄(線索 URL,未直接覈實):lywusichen/dsh-sidebar-buttons