DeepSeek Harness (DSH) 是一個基於插件的系統。在構建智能體或 Agent 時，通常需要綁定特定的會話、工作目錄和工具鏈。如果你只是想“隨手問一句”，不需要複雜的 agent 循環或文件讀寫，需要一個輕量的、不干擾當前項目的聊天窗口。dsh-sidebar-chat 就是這樣一個插件，它向 DSH 的右側欄註冊了一個原生頁籤，提供了與 DeepSeek 官網同款外觀的交互界面。
安裝¶
安裝過程不依賴 dsh plugin add 命令，而是使用 profile 安裝腳本。腳本會執行三件事：將包軟鏈（或複製）進 profile 的 node_modules；在 profile 的 package.json 中記錄 link: 依賴並掛載 bundle；清理舊版本可能留在 cordis.patch.yml 裏的手寫配置。
node tools/install-into-profile.mjs
安裝完成後，profile 的 bundles 列表與 cordis.patch.yml 會被熱重載，存盤幾秒後刷新頁面即可生效。
核心功能¶
1. 原生右側欄頁籤¶
插件註冊爲右側欄自己的頁籤類型“聊天”，與文件、終端、瀏覽器等頁籤並列。它有兩個入口：右側欄“＋”菜單裏的“聊天”膠囊，以及主輸入框左側的聊天氣泡按鈕（一鍵喚到前臺）。
2. 外觀與交互¶
界面完全復刻 DeepSeek 官網網頁版的設計系統。
* 樣式：跟隨 DSH 的淺色/深色主題，氣泡、芯片、輸入卡片都使用同一套 token。用戶消息爲靠右的淡藍氣泡，助手回答直接落在頁面上。
* 思考與搜索：支持“深度思考”和“聯網搜索”兩個獨立芯片。深度思考芯片支持等級調節，聯網搜索默認開啓。
* 流式與摺疊：支持流式輸出，思考過程以摺疊行形式展示，回答下方懸浮複製按鈕。
3. 模型選擇¶
模型列表直接來源於部署中真正可路由的供應商（通過 ctx.llm.listProviders/listModels/resolveModelInfo 獲取）。模型卡片按供應商分組，並標註圖片能力與上下文長度。
4. 文字與圖片¶
- 輸入：支持文字輸入，
Enter發送，Shift+Enter換行。 - 圖片：支持粘貼（
Cmd+V）、拖拽、文件選擇四種方式。圖片會先上傳到 host 的臨時文件夾，發送時才向框架換取可被模型讀取的引用，不污染項目目錄。
5. 回合小結¶
每次回答末尾會顯示統計信息，格式爲 輸入 N · 輸出 M tokens · 耗時 X 秒。該數據來自供應商的 usage 和框架記錄的落盤時間戳。
數據與原理¶
數據存放¶
- 圖片：原圖存入系統臨時目錄
<os.tmpdir()>/dsh-sidebar-chat/files/，索引文件爲同級index.json。插件會做 14 天未使用清理的兜底。 - 會話：會話與消息持久化在
$DSH_HOME/dsh-sidebar-chat/conversations/下，一個會話一個 JSON 文件，重啓後保留。
技術細節¶
- 不綁定工作目錄：插件不創建 DSH 會話，不設置 cwd，不讀寫會話工作區，只借用
llm和attachments兩個框架能力。 - 依賴平臺模塊：界面渲染依賴平臺內置模塊
@deepseek-ai/dsh-client-ui-primitives（seed word）。爲了保證 Markdown 渲染不報錯，插件需補全labels（如code.copyLabel）。 - 純文本模型：如果選了不支持圖片的模型但發送了圖，會提示“圖片會被替換成佔位文字”，而不是讓模型假裝沒看見。
適用場景¶
適合需要在 DSH 環境中快速查詢模型能力、調試提示詞或進行純文本對話，但又不想切換到瀏覽器或創建複雜智能體的場景。
