前言¶
DeepSeek Harness（DSH）採用插件化架構，允許開發者擴展官方客戶端的功能。在開發智能體或調試長對話時，常需要在主對話流之外進行輔助思考、代碼分析或檢查推理步驟，同時不希望中斷當前上下文或切換到新標籤頁。
dsh-sidechat 是一個獨立的 DeepSeek Harness Web 插件，它模仿 Codex 的分屏設計，將主對話與側邊欄對話分爲兩個可調整大小的面板，並提供了獨立控制模型和推理強度的能力。
核心功能¶
該插件主要解決多會話並行處理的需求，核心能力如下：
- 分屏佈局：將主對話與側邊欄對話並排顯示，支持拖拽調整兩個面板的寬度。
- 獨立會話管理：從當前主對話中創建子會話。支持選中特定文本進行引用創建，且引用不會自動發送，允許用戶先編輯再提交。
- 模型與推理配置：側邊欄會話擁有獨立的模型選擇和推理強度設置。新建會話時默認繼承主對話的配置。
- Codex 風格導航：提供緊湊的歷史回合導航（Turn rails）。在空閒狀態下顯示靜音刻度，懸停時支持魚眼效果和預覽卡片，便於在兩個會話中快速定位。
- 元數據展示：側邊欄展示父會話標題、短會話 ID、摘要以及一個“實時”指示器。
- 命令支持：
/sidechat：打開當前或最近更新的側邊欄會話。/sidechat content：將內容填充到側邊欄會話的草稿區。
- 通用渲染：渲染用戶消息、Markdown、推理過程、工具活動、審批請求、斜槓命令生命週期及未知事件。
安裝與啓用¶
插件以本地 link: 包形式分發。請確保插件目錄與 DeepSeek Harness 源碼目錄相鄰，以便相對路徑解析。
1. 構建插件¶
在插件目錄下執行以下命令：
cd path\to\dsh-sidechat
$env:HTTP_PROXY='http://127.0.0.1:7890'
$env:HTTPS_PROXY='http://127.0.0.1:7890'
pnpm install
pnpm run build
2. 安裝到 Harness Web 個人資料¶
構建完成後，切換回 Harness 目錄並添加插件：
cd ..\deepseek-harness-proxy
pnpm dsh plugin --profile web add link:..\dsh-sidechat
3. 啓動 Web 個人資料¶
啓動 Web 服務以加載插件：
pnpm dsh web --host 127.0.0.1 --port 3080
注意：插件使用 lib/client.js 作爲入口，修改 src/ 源碼後需重新運行 pnpm run build 並重啓 Web 個人資料。
典型用法¶
- 創建側邊欄會話：在主對話中選中一段代碼或上下文文本，通過插件提供的操作（通常在頭部或選中動作中）創建側邊欄會話。此時引用內容會進入草稿，需手動確認發送。
- 切換模型推理：在側邊欄會話中，可以單獨爲該會話選擇不同的模型（如 R1 或 V3）和推理強度，用於對比不同模型的輸出。
- 快捷命令：在輸入框輸入
/sidechat或/sidechat content即可快速喚起或填充側邊欄內容。
注意事項¶
- 依賴範圍：插件使用 peer 依賴，必須與當前 Harness 檢出的版本範圍匹配。建議在部署前進行測試。
- 連接邊界：側邊欄 RPC 調用被限制在本地 Web 連接邊界內，不涉及跨域或遠程 RPC。
- 數據存儲：圖片和消息草稿通過子會話發送，不會寫入插件的關係表。
- 日誌保留：刪除側邊欄關係記錄不會刪除或取消歸檔底層的會話日誌。
結語¶
dsh-sidechat 通過提供分屏和獨立控制，讓 DSH 用戶能夠在同一界面內高效地進行主對話與輔助對話的並行處理。它不僅保留了官方側邊欄的日誌完整性，還提供了 Codex 風格的緊湊交互體驗。
