前言¶
DeepSeek Harness (DSH) 提供了 Chat 和 Work 兩種核心工作模式。Chat 模式專注於對話交互，而 Work 模式則要求開發者具備文件瀏覽和命令行執行能力。在標準的 DSH Work 模式界面中，這兩項功能均處於缺失狀態。插件化是 DSH 的核心架構理念，omdsh-sidepanel 旨在爲 Work 模式補充這兩個必要的界面元素，使其具備輕量級的文件管理和終端運行能力。
插件簡介¶
omdsh-sidepanel 是一個爲 DeepSeek Harness Web GUI 設計的插件，由社區開發者 omdsh-plugins 維護。它爲 Work 模式提供了右側的文件面板（支持預覽）和底部的終端面板。這兩個面板在 Chat 模式下不會出現，因爲 Chat 模式沒有對應的項目目錄。
核心功能¶
- 文件面板：位於界面右側，顯示當前會話目錄的文件樹，並支持文件預覽。
- 終端面板：位於對話列下方，提供 Shell 訪問能力。
- 控制開關：通過會話標題工具欄中的開關控制面板的顯示與隱藏。
- 命令接口：提供
panel.files和panel.terminal兩條命令，具體綁定按鍵由omdsh-shortcuts插件管理。 - 交互操作：
- 調整大小：拖動手柄調整面板寬度，雙擊手柄可重置默認大小（320px）。
- 複製路徑：點擊面板標題欄的複製按鈕，或右鍵點擊文件/文件夾行以複製路徑。
- 佈局定位：面板固定定位在
shell.overlay層，通過調整#root和[data-slot="conversation"]的邊距來避免遮擋主界面。 - 設置存儲：面板大小保存在
localStorage的omdsh-sidepanel.panels鍵下。
安裝與啓用¶
該插件通過 DeepSeek Harness 的插件中心或 GitHub 倉庫安裝。安裝後，面板僅在 Work 模式下出現。
典型用法¶
- 開啓面板：在會話標題欄的工具行中找到對應的開關（文件面板或終端面板）並開啓。
- 快捷命令：通過
omdsh-shortcuts配置的快捷鍵（如CmdOrCtrl+Shift+E等）快速喚起面板。 - 調整面板：鼠標拖動面板邊緣的手柄改變寬度，雙擊手柄恢復默認。
- 獲取路徑：在文件樹中右鍵點擊目標項，選擇複製路徑；或點擊面板頂部的複製按鈕。
- 終端默認狀態：終端面板默認關閉。如果同時安裝了
omdsh-codemode，終端默認會開啓。
適用場景與注意¶
- 模式限制：插件僅對 Work 模式有效，Chat 模式下不會渲染任何面板。
- 依賴關係：依賴
omdsh-shortcuts（處理快捷鍵）、omdsh-chatmode、omdsh-basemode和omdsh-codemode。 - 功能邊界：面板不包含編輯器、Git 界面、瀏覽器或選項卡條，專注於輕量級的文件查看和終端運行。
- 安全提示：插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證（MIT）。
短結尾¶
omdsh-sidepanel 爲 DSH Work 模式補全了文件瀏覽和終端功能，通過簡潔的側邊欄設計避免了界面臃腫。對於需要在 Harness 中直接管理文件和執行命令的開發者，這是一個實用的補充。
資源鏈接：
* 插件目錄：https://www.skillhub.cn/plugins/omdsh-plugins/omdsh-sidepanel
* GitHub 倉庫：https://github.com/omdsh-plugins/omdsh-sidepanel
