前言¶

DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。在 Web 環境下，模型生成複雜的數據可視化、交互式組件或動畫往往需要編寫大量底層代碼，或者缺乏統一的驗證機制。dsh-motion-ui 解決了這個問題，它爲 DeepSeek Harness Web 提供了一套標準化的渲染工具，讓模型能夠直接生成經過驗證的 UI 組件、圖表和場景，而無需手動處理 HTML/SVG 源碼的細節。

這是什麼¶

dsh-motion-ui 是一個爲 DeepSeek Harness Web 0.2.0-rc.2 設計的插件，由開發者 Scorp1o117 維護，採用 MIT 許可證。

它複用了 MIT 項目 dsh-genui 的核心渲染與校驗邏輯，在此基礎上擴展了針對動畫、機制圖解和本地計算的支持。該插件不提供後端 API，所有渲染和計算均在本地完成，確保了數據安全，同時也避免了與 dsh-generative-ui 的衝突。

核心功能¶

插件提供了以下核心能力：

• 渲染場景：支持流程、方案對比、總量分配和預算四種場景的快速渲染。
• 文本排版：提供 8 種預設（閱讀、簡潔、對比、列表、高亮、評分、流程、極簡），支持自定義字體大小、顏色、對齊和佈局。
• UI 組件：提供經過驗證的原生組件，包括卡片、列表、表格、表單、時間線、選項卡等。
• 畫布繪製：支持 HTML/SVG 自由繪製。
• 機制圖解：支持裝配拆解、齒輪傳動和曲柄連桿等運動學場景。
• 樣式管理：內置 5 種風格（明亮扁平、清爽閱讀、柔和彩色、技術圖解、活力展示）。
• 本地計算與圖表：集成 ECharts、Mermaid、Three.js 和 KaTeX，支持本地數據排序、篩選和圖表生成。

安裝與啓用¶

在 DeepSeek Harness Web 環境中，可以通過命令行安裝此插件：

dsh plugin --profile web add dsh-motion-ui

安裝完成後，需要重啓 Web 進程並刷新瀏覽器頁面以加載新插件。如果在開發環境中安裝源碼構建版本，請確保先卸載 dsh-generative-ui，因爲兩者註冊了相同的工具。

典型用法¶

插件通過工具調用與模型交互，以下是一些典型的調用方式：

• 查看組件目錄：

    ui_catalog({topic:"text"})

• 渲染預算場景：

    render_scene({scene:"budget",title:"假設旅行預算",values:{people:3,nights:3,roomRate:600,transportPerPerson:800}})

• 渲染文本塊：

    render_text({preset:"reading",blocks:[
      {type:"text",spans:[{text:"重點："},{text:"先交付最小完整結果",weight:700,color:"success"}]}
    ]})

• 渲染自定義 UI：

    render_ui({document:{title:"Git 小測",items:[
      {type:"radio",group:"q1",label:"提交記錄什麼？",options:["暫存區快照","所有未暫存修改"],answer:0,explanation:"git commit 記錄暫存區快照。"},
      {type:"submit",label:"檢查答案",groups:["q1"]}
    ]}})

適用場景與注意¶

該插件適用於需要可視化輸出的場景，如數據報表、流程圖解、在線測驗和本地參數配置。

使用時需注意以下事實：

1. 版本兼容性：僅兼容 DeepSeek Harness Web 0.2.0-rc.2。
2. 環境限制：插件不提供 /panel 命令或自定義渲染器註冊 API。獨立 HTML 界面無法發送宿主 Agent 請求或打開本地文件（外部媒體需網絡），也無法訪問宿主文件系統權限。
3. 默認配置：默認風格爲「明亮扁平」，首次使用無需額外設置。
4. 開發環境：若需開發此插件，必須先卸載 dsh-generative-ui，否則會因工具註冊衝突導致安裝失敗。

短結尾¶

dsh-motion-ui 通過複用成熟的渲染核心並封裝成易用的工具，降低了在 DSH Web 中生成高質量交互界面的門檻。它專注於提供可靠的渲染工具和樣式管理，適合需要處理數據可視化、本地計算和結構化交互界面的開發場景。

項目目錄 | GitHub 倉庫