前言¶
DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。在調試智能體或使用 run_code 生成圖片和表格時，內容通常以文本或文件路徑形式呈現，用戶難以直觀查看。dsh-csv-and-image-preview 插件解決了這一痛點，它將圖片、SVG 和 CSV/TSV 數據直接渲染爲瀏覽器原生元素，嵌入到對話流中，無需手動打開文件。
功能概覽¶
該插件由 jetecho 維護，開源（MIT）。
- 原生渲染：使用原生
<img>標籤渲染圖片，使用原生<table>渲染表格。 - 交互能力：支持粘性表頭、320px 內部滾動，點擊表頭可循環切換排序（升序、降序、原始）。
- 調用方式：支持直接調用、
run_code嵌套調用以及舊版meta格式。 - 數據格式：支持多種圖片格式（SVG, PNG, JPEG, GIF, WebP 等）和 CSV 分隔符（自動識別逗號、分號、Tab、豎線）。
- 歷史回放：支持快照保存和歷史回放。刷新或重啓 DSH 後，同一會話仍顯示生成時的快照。
安裝與配置¶
插件需 DSH 0.1.5-rc.1 或兼容版本。安裝後需重啓 dsh web 並刷新瀏覽器。
dsh plugin --profile web add @jetecho/dsh-csv-and-image-preview
使用方法¶
Agent 調用工具時，需傳入 JSON 格式的參數。
- 預覽圖片：
preview_image {"path":"D:/assets/logo.svg","label":"Logo 預覽"}
- 預覽 CSV 文件：
preview_csv {"path":"D:/data/sales.csv","label":"銷售數據","maxRows":100}
- 預覽內聯 CSV 內容：
preview_csv {"content":"姓名,分數\n張三,90\n李四,85"}
說明：
* path 與 content 同時存在時，優先讀取 path。
* 相對路徑以當前會話工作目錄爲基準。
* 內聯 SVG 可直接傳入 content。
* 圖片和 CSV 輸入均限制爲 8 MiB。
注意事項¶
- CSV 編碼：僅支持 UTF-8 CSV（支持 BOM），其他編碼會提示轉換。
- 存儲位置：預覽快照保存在
$DSH_HOME/storages/csv-and-image-preview/。未設置DSH_HOME時使用~/.dsh/storages/csv-and-image-preview/。 - 調用反饋：工具返回“預覽數據已生成”僅代表快照保存成功，不代表瀏覽器已解碼顯示。
- 工作流建議：插件遵循“預覽優先”約定，建議 Agent 在生成或修改文件前先調用預覽，待用戶認可後再寫入目標文件。
