前言¶

DeepSeek Harness（dsh）對話窗口通常以純文本形式展示代碼塊，缺乏直觀的渲染結果。dsh-viewer-kit 是一個給 dsh 用的可插拔內容渲染層，它讓代碼塊除了顯示源碼外，還能一鍵切換爲渲染結果，例如 HTML 預覽、圖表或表格。

功能概覽¶

該插件提供了一套渲染器，支持多種格式的切換。

1. 代碼與預覽切換

   • html / svg：支持預覽與源碼切換。
   • echarts：支持圖表與源碼切換。

2. 表格渲染

   • csv / tsv：支持表格與源碼切換。
   • json：支持表格與源碼切換。
   • markdown：支持管道表渲染與源碼切換。

3. 原型模式工具

   • 提供 apply_prototype_style 工具，用於注入 HTML 風格規範。

4. 配置項

   • 支持通過配置項自定義渲染行爲，例如控制腳本執行權限和替換原型風格規範。

安裝¶

使用官方插件安裝命令，將插件添加到當前環境中。

dsh plugin add file:E:\path\to\dsh-viewer-kit

典型用法¶

安裝並重啓 profile 後，可以通過以下方式使用插件功能。

1. 使用原型工具
   在對話中觸發模型調用 apply_prototype_style 工具，以注入 HTML 風格規範。

2. 使用圍欄進行渲染

   • 使用 html 圍欄進行沙箱渲染。
   • 使用 echarts 圍欄渲染圖表。

3. 配置腳本權限
   在 cordis.patch.yml 中配置 htmlAllowScripts: true，以允許預覽中的 HTML 執行腳本。

注意事項¶

1. 依賴版本
   該插件依賴 DSH Desktop 0.2.0-rc.2。

2. 強耦合
   插件強耦合 DSH 內部 DOM，版本升級可能導致失效。

3. 版本狀態
   當前版本號小於 1.0，配置鍵不保證穩定。

4. 渲染限制
   表格渲染有行數和列數上限（500 行 × 40 列）。

5. 安全提示
   開啓 htmlAllowScripts 後，僅渲染內容本身可能發起網絡請求。