前言¶
DeepSeek Harness (DSH) 採用插件化架構，旨在通過擴展組件豐富智能體能力。在默認對話中，AI 的回覆往往侷限於文本、Markdown 代碼塊或靜態表格。用戶需要手動複製粘貼數據、在腦海中計算或逐項填寫表單，這增加了交互成本。
dsh-genui 插件將這種單向的文字輸出轉變爲雙向的交互界面。它允許 DSH 在對話中直接渲染圖表、表單、計算器等 UI 元素，用戶的點擊或輸入會迴流到對話流中，供模型繼續處理。
插件定位¶
dsh-genui 是 DeepSeek Harness 的一個客戶端插件，由開發者 lhuans 維護，遵循 MIT 協議。它通過在 DSH 前端注入渲染邏輯，將模型返回的指令轉化爲可視化的交互組件。
核心功能¶
該插件支持將自然語言指令直接轉換爲多種 UI 組件：
- 交互圖表：支持柱狀圖、折線圖、餅圖、環形圖、雷達圖、儀表盤、漏斗圖、散點圖和瀑布圖。
- 表單控件：文本框、文本域、下拉菜單、單選、複選、開關、數字步進器、日期選擇器、搜索框和穿梭框。
- 小應用：計算器、BMI 計算器、貨幣轉換器、待辦事項列表。
- 數據展示與佈局：支持分頁與搜索的表格、樹形視圖、時間軸、麪包屑導航、選項卡、摺疊面板、卡片、輪播圖和提示框。
- 多輪交互：交互動作可以迴流至模型，支持構建“點擊-繼續”的複雜工作流。
安裝與啓用¶
安裝過程需要確保環境依賴已就緒。
前置條件¶
- 安裝 Node.js。
- 安裝 pnpm（DSH 使用 pnpm 管理插件）。可通過
corepack enable或npm i -g pnpm安裝，並打開新終端驗證版本。 - 確保已啓動 DeepSeek Harness 服務（默認運行在 http://127.0.0.1:3080）。
安裝步驟¶
在終端中執行以下命令將插件添加到 web 配置文件中：
dsh plugin --profile web add dsh-genui
安裝完成後，必須重啓 DSH 才能使插件生效。重啓步驟如下：
- 在運行 DSH 的終端按
Ctrl+C停止服務。 - 重新啓動：
dsh web。 - 刷新瀏覽器頁面。
- 開始新的對話。
驗證安裝¶
在新的對話窗口中輸入以下指令：
Generate a calculator
如果對話中出現了可用的計算器界面，說明插件已成功激活。
典型用法¶
無需學習特殊語法或編寫 JSON，直接使用自然語言描述需求即可。
生成圖表：
“Chart revenue for the last three quarters as bars, and mark year-over-year growth”
構建表單：
“Make a time-off request form with leave type, start and end date, days, and reason”
創建計算工具：
“Build a BMI calculator — enter height and weight, get the result”
製作對比表格：
“Put these options in a comparison table: price, timeline, risk”
適用場景與注意事項¶
該插件適合需要快速展示數據趨勢、收集結構化輸入或構建簡單交互工具的場景。
注意事項：
* 插件依賴 Node.js 和 pnpm 環境。
* 安裝後必須重啓 DSH 進程，否則界面不會更新。
* 默認開啓 GenUI 編寫引導，重啓後會記住上一次的選擇。
總結¶
dsh-genui 通過將靜態文本轉化爲交互組件，降低了 DSH 使用者在數據處理和表單填寫上的操作成本。它保持了 DSH 原有的插件化生態理念，無需修改源碼即可擴展前端渲染能力。
