DeepSeek Harness（DSH）支持插件化擴展。dsh-raw-html 插件旨在解決 Agent 輸出的 HTML 代碼僅作爲純文本顯示的問題，通過 VCP（Visual-Synesthesia，視覺通感）協議規範，將其渲染爲真實 UI 界面，並支持卡片、數學公式、圖表及字體渲染。
插件定位¶
這是一個 VCP 視覺通感協議規範插件。由開發者 plolpl789 維護，目前獲得 65 個 Star。它將 DeepSeek Harness 的 HTML 輸出轉化爲可交互的視覺組件，幫助 Agent 按照一套可維護的設計規範輸出內容。
核心功能¶
插件提供以下核心能力：
- VCP 視覺通感協議支持：建立一套統一的視覺輸出規範。
- HTML/SVG 卡片渲染：將代碼塊中的 HTML/SVG 渲染爲界面組件。
- KaTeX 數學公式渲染：支持數學公式的可視化展示。
- Mermaid 圖表渲染：支持流程圖、時序圖等圖表渲染。
- 內置精選字體：包含 7 款開源字體（文楷/文楷細/馬善政楷書/思源黑/思源細黑/思源粗黑/GreatVibes 花體），全部 OFL 授權，零配置即可使用。
- vcp-fast 緩存增量加速引擎：通過容器感知塊級緩存和增量追加，顯著提升渲染性能。
- 可信模式與安全過濾：提供安全過濾機制，僅放行
onclick橋接等可控事件，防止腳本注入。
安裝與啓用¶
安裝過程分爲打補丁和註冊插件兩步。
- 運行一鍵安裝器（推薦）。該命令會同時安裝渲染能力補丁和可信模式補丁：
node "本插件路徑\patch\install-all.cjs"
- 註冊插件：
dsh plugin --profile web add "本插件路徑"
-
重啓與刷新。重啓 DSH 服務並刷新瀏覽器頁面（建議使用 Ctrl+F5 清除舊緩存）。
-
啓用開關。在瀏覽器界面中，打開「</>」開關以啓用 HTML 渲染與美學注入。
使用方法¶
啓用插件後，Agent 可以接收 VCP 協議指令：
- 瀏覽器開關：點擊發送按鈕旁的「</>」按鈕，可選擇「渲染 HTML」（僅渲染）或「ON」（渲染+美學）。
- 交互橋接：點擊 VCP 按鈕，通過
onclick="input('...')"橋接將內容填充到輸入框併發送。 - 協議輸出：Agent 收到協議後，會自動輸出符合規範的
#vcp-root視覺容器。
重要注意¶
- vcp-root 內部禁止空行。這是 Markdown HTML 塊的特性，如果
<div id="vcp-root">內部出現連續兩個換行（\n\n），卡片會被解析斷裂，導致樣式錯亂。所有子元素必須使用單個換行或單行排列。 - 安全提示。插件會對腳本和危險協議進行過濾，但樣式與外部圖片仍然可達。請只對可信模型開啓以避免潛在風險。
維護¶
- 修改代碼後，建議運行
node --check lib/client.js和node --check lib/index.js驗證語法。 - 當 DSH 升級覆蓋了前端文件後，需重新運行
node patch/install-all.cjs進行補丁修復。 - 所有第三方依賴必須在
package.json中顯式聲明，以確保模塊解析的穩定性。
