前言¶
在開發 DeepSeek Harness（DSH）智能體或使用 Web 界面時，助手經常會生成包含代碼、表格或引用的 HTML 方案。這些內容如果散落在對話流中，難以管理和查看。我們需要一種方式，將結構化的方案持久化存儲，並以可交互的方式展示在對話右側。
dsh-soln-panel 插件通過在對話右側提供一個可展開/收縮的抽屜面板，解決了這一問題。它支持多標籤頁切換、寬度拖拽調整以及未讀提示，並且能根據工作區獨立存儲方案數據。
插件介紹¶
- 名稱：dsh-soln-panel
- 功能定位：對話右側方案面板，支持 HTML 方案展示、多標籤頁、寬度拖拽、未讀提示、按工作區持久化。
- 維護者：PastSheep
- 許可：MIT
- 類別：客戶端
核心功能¶
- HTML 方案展示：支持渲染 HTML 內容，表格、代碼塊、引用等樣式均能原樣顯示。
- 多標籤頁：支持多個方案並存，以瀏覽器式標籤切換，標籤過多時自動壓縮並支持滾動。
- 寬度拖拽：面板寬度支持從 280px 到 900px 的動態調整。
- 未讀提示：當方案更新且未被查看時，對應標籤變爲橙色，點擊後清除未讀狀態。
- 按工作區持久化：數據存儲在當前工作區的指定目錄，重啓後保留，跨會話可見，且嚴格隔離不同工作區。
- 免構建：插件代碼直接可用，無需構建步驟。
安裝與啓用¶
- 在終端執行以下命令安裝插件：
dsh plugin --profile web add "github:PastSheep/dsh-soln-panel#main"
- 安裝完成後重啓 DeepSeek Harness。
- 在會話界面右側會出現“方案”標籤，點擊即可展開面板。
如需卸載，請執行：
dsh plugin --profile web remove dsh-soln-panel
典型用法¶
插件通過宿主級註冊的工具 show_solution 推送方案。調用該工具時，可通過參數控制方案的追加、更新、展開及清空。
工具參數說明¶
| 參數 | 說明 |
|---|---|
id |
方案 ID。提供此參數時爲更新方案，省略時爲追加新方案。 |
title |
方案標題。更新時可省略，保留原值。 |
html |
方案 HTML 內容。更新時可省略，保留原值。 |
activate |
是否跳轉至該方案標籤。追加時默認爲 true，更新時默認爲 false。 |
openPanel |
是否展開面板。省略時保持當前狀態。 |
clear |
清空當前工作區全部方案並收起面板。 |
調用邏輯¶
- 追加方案：不提供
id，activate默認爲true（自動跳轉）。 - 更新方案：提供
id，activate默認爲false（不跳轉），title和html可選擇性提供。 - 清空方案：調用時參數
clear設爲true。
每次調用後，工具會返回當前工作區所有方案的摘要信息（包含 id、標題和未讀狀態）。
數據與隔離¶
- 數據文件位置：
<工作區>/.dsh/soln-panel.json。 - 隔離機制：插件根據當前會話的工作區信息讀取對應的方案池。若當前會話沒有工作區信息，則返回空池，不會發生跨工作區數據泄漏。
適用場景與注意¶
該插件適合需要向用戶展示結構化 HTML 內容的場景，例如生成文檔、代碼片段列表或複雜的表格數據。
注意：作爲第三方插件，安裝前建議檢查其源碼與許可證。插件依賴 DSH 宿主環境的特定 API 版本（如 @deepseek-ai/dsh-tools 等）。
結語¶
dsh-soln-panel 爲 DSH 提供了一個輕量級、免構建的方案管理解決方案。通過持久化和交互式面板，它能夠顯著提升助手生成內容的可用性。更多詳情可查閱插件目錄或源碼倉庫。
