前言¶
DeepSeek Harness（DSH）的側邊欄是日常切換會話、進設置和插件頁的主入口。若你分別安裝對話標記、活躍會話鈴鐺、側欄快捷入口和「返回當前會話」，要在插件頁維護四張卡片，還可能和組合包重複掛載同名模塊。下面介紹維護者 DEVbyQIN 發佈的客戶端插件 dsh-sidebar-expand（側邊欄增強包）：一次安裝帶上四個相關組件，在插件頁的組合包詳情裏逐個啓用或停用，不必爲少用一個功能而卸載整包。
這是什麼¶
dsh-sidebar-expand 是 DSH 的 bundle（多插件打包）插件，倉庫本身不含業務代碼，只通過 cordis.patch.yml 和依賴聲明把四個已有插件固定版本組合在一起：
| 組件 | 作用 | 版本 |
|---|---|---|
dsh-sidebar-marks |
對話標記：整行淡色底、行尾彩色圓點、自定義字號；入口在行「…」菜單、⌘⇧M、右鍵 | 0.1.1 |
dsh-active-sessions |
「工作區」標題旁的活躍會話鈴鐺：後臺任務呼吸綠點，一鍵呼出進行中/最近三天會話面板 | 0.1.1 |
dsh-sidebar-shortcuts |
把工作區上方的功能入口收成緊湊雙列或圖標宮格（設置 → 側欄快捷入口 可調） | 0.1.0 |
dsh-back-to-chat |
插件、自動化任務、上下文洞察頁面左上角的「← 返回當前會話」，保留輸入草稿 | 0.1.1 |
四個組件均爲零運行時依賴；組合包不註冊自己的 Loader entry，也不注入服務。許可證爲 MIT。
核心功能¶
對話標記（dsh-sidebar-marks）¶
在側欄會話列表裏給對話加視覺標記：整行淡色背景、行尾彩色圓點，字號可自定義。可從行「…」菜單、快捷鍵 ⌘⇧M 或右鍵進入相關操作。
活躍會話鈴鐺（dsh-active-sessions）¶
「工作區」標題旁顯示鈴鐺；後臺有任務時帶呼吸綠點，點擊可打開進行中及最近三天的會話面板。
側欄快捷入口（dsh-sidebar-shortcuts）¶
將工作區上方的功能入口壓縮爲雙列或圖標宮格；列數與樣式在 設置 → 側欄快捷入口 中調整（組合包詳情裏若該組件帶 配置 按鈕，也可從那裏進入原設置頁）。
返回當前會話（dsh-back-to-chat）¶
在插件頁、自動化任務、上下文洞察等頁面左上角提供「← 返回當前會話」，返回時保留輸入草稿。
組合包層面的行爲¶
裝一次後，插件頁會出現 側邊欄增強包 卡片。點進卡片可在「包含的組件」列表裏對每一行單獨 啓用 / 停用；關掉某組件會卸載其宿主半與瀏覽器半（profile 支持 HMR 時通常無需重啓）。開關狀態寫在當前 profile 的 cordis.patch.yml 裏，重裝或升級組合包不會丟失。注意：設置 → 內置插件 裏的列表是隻讀清單，實際開關在側邊欄「插件」頁的組合包詳情中。
安裝與啓用¶
組合包當前版本爲 0.1.0。環境要求：DSH 0.2.x（含桌面版 0.2.1-rc.4）；Node ^22.19.0 || >=24。
桌面版（圖形界面）：左側「插件」→「添加插件」，包名填 dsh-sidebar-expand，安裝後點「立即啓用」。
命令行（任選一種）：
# 桌面版自帶的 CLI（profile 固定爲 desktop）
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
plugin --profile desktop add dsh-sidebar-expand@0.1.0
# 或任意 dsh CLI，profile 換成你自己的
dsh plugin --profile web add dsh-sidebar-expand@0.1.0
# 從 GitHub 安裝（不經過 npm）
dsh plugin --profile web add github:DEVbyQIN/dsh-sidebar-expand#v0.1.0
裝完後在「插件」頁確認 側邊欄增強包 卡片已出現，再按需打開各組件開關。
典型用法¶
- 安裝並啓用組合包後，進入「插件」→ 打開 側邊欄增強包 → 在「包含的組件」裏只啓用需要的項（例如只要標記和返回會話，可停用快捷入口與鈴鐺）。
- 需要側欄快捷入口布局時：啓用
dsh-sidebar-shortcuts後，通過組合包行上的 配置 或 設置 → 側欄快捷入口 調整雙列/宮格等選項。 - 給某條會話加標記：在側欄該行用「…」菜單、⌘⇧M 或右鍵（具體以組件 UI 爲準）。
- 從插件或洞察頁回到對話：點擊左上角「← 返回當前會話」，草稿應仍保留。
適用場景與注意¶
適合誰：希望在 DSH 客戶端側欄統一增強標記、會話概覽、快捷入口和跨頁返回，又不想維護四個獨立插件安裝項的用戶。
不要與單裝組件並存：若已單獨安裝 dsh-sidebar-marks、dsh-active-sessions、dsh-sidebar-shortcuts、dsh-back-to-chat 中任意一個，請先卸載再裝組合包；反之，已裝組合包則不必再單裝這四個。混搭需求用組合包內的行開關即可，不要雙份安裝同一組件。
升級與卸載：升級組合包會同步升級表中釘死的組件版本；變更關係見倉庫 CHANGELOG.md。卸載組合包會移除四個組件；臨時不用某功能請用行開關，不必卸載整包。
安全與權限：插件在 DSH 當前進程的權限下運行。安裝前請自行查看 GitHub 倉庫 源碼與 MIT 許可證，確認符合你的使用環境。社區目錄 SkillHub 插件頁 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-sidebar-expand 把四個側邊欄相關客戶端能力收成一次安裝、分組件開關的 bundle，適合在 DSH 0.2.x 上快速補齊側欄工作流。更多信息見目錄頁與倉庫：
- 目錄頁：https://www.skillhub.cn/plugins/DEVbyQIN/dsh-sidebar-expand
- GitHub：https://github.com/DEVbyQIN/dsh-sidebar-expand
