在 DeepSeek Harness (DSH) 的原生聊天中描述佈局或 UI 細節時，通常依賴文字或外部截圖，信息傳遞效率較低。dsh-sketch-reference 插件通過接入 Excalidraw，將可編輯的草圖板直接集成到 DSH 工作區中。它允許 Agent 按需讀取草圖、定位批註並提出修改，實現從構思到落地的可視化協作閉環。
核心功能¶
接入 Excalidraw 編輯器，提供可持續編輯的草圖與參考圖。繪圖、保存和導出功能獨立可用，DSH Agent 可在此基礎上繼續完成網頁、UI 和 PPT 的開發。
Agent 具備按需讀取能力，能夠理解當前草圖的結構與內容，定位具體的批註區域，並基於這些信息提出修改建議。畫板修改操作受圖形白名單限制，Agent 提議修改後，會展示同視角預覽，需用戶確認後才應用。
安裝與啓用¶
插件通過 DSH 官方插件管理器安裝，無需提前單獨安裝 Excalidraw。安裝前請確保 DSH Web 環境版本爲 0.2.1-alpha.1 或 0.2.1-alpha.2。
安裝完成後，執行以下命令：
dsh plugin --profile web add /絕對路徑/dsh-sketch-reference-0.6.5.tgz
運行 dsh web 啓動服務即可使用。
典型用法¶
創建會話並畫圖
1. 選擇工作區並創建會話。
2. 點擊輸入框旁的「參考板」按鈕。
3. 在畫板中繪製草圖，並添加用途說明。
4. 點擊「已保存」返回聊天，或點擊「作爲參考發送」將草圖以圖片形式加入輸入框。
直接對話與修改
1. 在原生聊天中直接輸入指令，例如：“按當前草圖實現一個網頁”。
2. 選中畫板上的元素，使用批註菜單的「追問 / 糾正 / 修改這裏」功能，起草下一條消息。
3. Agent 標註某個區域後，可從菜單中發起修改請求。
4. Agent 提出畫板修改時，系統會展示預覽。用戶確認後，修改纔會應用到草圖中。
注意事項¶
模型與權限
圖片讀取功能需要模型支持視覺輸入。模型與認證沿用 DSH 配置。插件以當前 DSH 進程權限運行，安裝前請檢查源碼與許可證。
修改限制
畫板修改受圖形白名單限制，不會任意修改鎖定、綁定、成組元素或樣式。
數據存儲
草圖與圖片存儲在本地 DSH 中。模型讀取時，這些數據會發送至已配置的服務。歷史附件尚無自動回收機制，升級或卸載前建議導出草圖備份。
功能邊界
插件不包含內置網頁或 PPT 生成器，也不支持草圖與代碼的自動雙向綁定。
