前言¶
DeepSeek Harness（DSH）的設計理念是「一切皆插件」。在智能體開發或長對話管理場景下，開發者往往需要同時監控或處理多個會話。此時，頻繁在會話列表中切換標籤頁會打斷工作流。dsh-split-view 插件借鑑了終端分屏的交互邏輯，直接將 DSH 主窗口改造爲多分屏容器，使你能在同一界面並排查看多個會話的狀態。
核心功能¶
該插件將 DSH 主窗口轉化爲一個可拖拽的佈局容器。每個分屏面板運行一個完整的 DSH 客戶端實例，具備以下能力：
- 分屏與佈局：支持向右分屏、向下分屏。分屏區域支持拖動分割條調整大小，支持橫豎任意嵌套佈局。
- 面板操作：雙擊面板標題欄可放大/還原；點擊面板聚焦；通過標題欄按鈕或快捷鍵關閉面板。
- 標題欄功能：每個面板帶有標題欄，實時顯示會話標題，並提供向右分屏、向下分屏、放大、刷新、關閉等操作按鈕。
- 會話管理：點擊標題可直接重命名會話；雙擊放大；支持一鍵複製「會話 ID + 會話標題」。
- 插件集成：插件將分屏能力暴露爲 Cordis 服務，其他插件可通過 API 調用面板操作或會話交互。
安裝與啓用¶
安裝插件需要使用 DSH 的命令行工具。
- 安裝插件：
dsh plugin --profile web add dsh-split-view
- 重啓生效：
安裝完成後，需要重啓 Web 進程才能加載插件：
dsh web
- 本地開發安裝：
如果需要從源碼開發或調試，使用-w參數指定本地路徑：
dsh plugin --profile web add -w /path/to/dsh-split-view
- 卸載：
若需要恢復單窗口模式或緊急恢復（插件出錯時會停止 Boot 進程，不會靜默白屏）：
dsh plugin --profile web remove dsh-split-view
快捷鍵與設置¶
在任意分屏面板內，打開設置，左側導航找到「分屏」選項即可配置。
默認快捷鍵¶
默認提供以下組合鍵，支持在設置中自定義修改。注意：自定義快捷鍵必須包含 ⌘（Mac）或 Ctrl（Windows/Linux）。
⇧⌘D：向右分屏⇧⌘V：向下分屏⇧⌘X：關閉聚焦面板⇧⌘Enter：最大化 / 還原聚焦面板
設置項¶
- 快捷鍵自定義：點擊動作組合鍵進入錄製模式，按新組合鍵修改綁鍵，Esc 取消。瀏覽器或系統佔用的組合鍵也可以綁定，系統會給出提示。
- 選中高亮色：聚焦面板的邊框描邊和標題欄染色。提供預設色板、自定義取色器，以及「跟隨主題」選項。開啓跟隨主題後，更換皮膚會自動適配。
- 標題欄：提供一個開關，用於隱藏所有面板的標題欄。注意：標題欄上集成了複製信息、重命名、最大化、關閉等按鈕，隱藏後這些操作只能通過快捷鍵觸發。
- 恢復默認：一鍵將上述設置還原。
注意事項¶
- 運行機制：插件以當前 dsh 進程的權限運行。安裝前建議檢查源碼與許可證（MIT）。
- 錯誤處理：如果插件代碼出錯，Boot 進程會報錯並停止，不會出現靜默白屏。此時卸載插件是恢復系統運行的緊急手段。
- 快捷鍵限制：自定義快捷鍵組合必須包含 ⌘ 或 Ctrl，這是硬性要求。
總結¶
dsh-split-view 通過將 DSH 主窗口重構爲分屏容器，解決了多會話並行查看時的切換痛點。無論是橫屏並排還是豎屏嵌套，它都能提供類似終端的多任務體驗。插件本身基於 MIT 協議開源，並提供了 Cordis 服務接口供生態內的其他插件調用。
