DeepSeek Harness (DSH) Web 模式支持通過插件擴展功能。在默認的聯網搜索流程中，搜到的網頁、圖片通常只顯示在工具調用面板中，面板往往會被摺疊，導致用戶看不到配圖，也無法追溯引用來源。dsh-better-display 解決了這兩個問題，它讓模型將引用和圖片寫入回答正文，並在前端進行渲染，讓智能體回答更加直觀。
核心功能¶
本插件主要提供以下能力：
- 引用角標：將模型寫入的
[n](url)渲染爲上標小圓角標。懸停時顯示站點圖標、域名和標題，點擊可在新標籤頁打開來源。 - 來源面板：回答結束後在末尾彙總所有被引用的網頁。面板會按 URL 去重並按首次出現排序，可展開爲卡片列表。
- 正文配圖：將搜到的相關圖片以 Markdown 圖片語法嵌入正文，渲染爲帶說明文字的圖片。
- 圖集：同一行的 2 張以上圖片會自動排成網格圖集。
- 大圖預覽：點擊圖片可全屏查看，支持跳轉原圖，按 Esc 關閉。
- 加載失敗兜底：圖片失效時退化爲可點擊的說明鏈接，不會留下破損圖片。
- 完整 Markdown：基於 markstream-react 的流式渲染，支持 Shiki 代碼高亮、Mermaid、KaTeX、表格、任務列表等。
安裝與配置¶
通過以下命令安裝插件：
dsh plugin --profile web add @copylee/dsh-better-display
安裝後，建議在 DSH 左側欄「插件」頁打開 @copylee/dsh-better-display，點擊組件行的配置按鈕進行調整。保存配置後，下一條回答即可生效，無需重啓進程。
配置項包括：
- 引用角標 (
citations)：默認開啓。讓模型用[n](url)標註聯網來源，並顯示爲角標和彙總面板。 - 正文配圖 (
inlineImages)：默認開啓。讓模型把搜到的相關圖片嵌入回答。 - 配圖數量 (
imageCount)：默認由 AI 決定。可設爲auto（模型按內容決定）或limit（限制每條回答最多張數）。 - 最多張數 (
maxImages)：默認 8。僅在設爲limit時生效，範圍 1–20。
兼容性與依賴¶
- 版本要求：需要 DeepSeek Harness >= 0.2.0-rc.2。
- 依賴插件：需要與
dsh-free-search等聯網搜索插件配合使用。 - 互斥關係：
- 與
dsh-better-markdown互斥，安裝後建議移除dsh-better-markdown以避免重複打包。 - 與
dsh-genui互斥，二者都會替換 assistant 渲染器，本插件優先級更高，只會生效一個。
- 與
工作原理¶
插件不修改 Harness 源碼，而是通過注入 Prompt 和覆蓋渲染 Slot 實現：
- 宿主端：在 System Prompt 中注入指令，告訴模型將引用寫成
[n](url)，相關圖片寫成。 - 瀏覽器端：覆蓋 Assistant 渲染 Slot。解析 Markdown 中的引用和圖片，分別渲染爲角標、圖集、預覽組件以及底部的來源面板。
安全說明¶
- 原始 HTML 一律轉義。
- 角標、鏈接、圖片只接受
http(s)地址，javascript:、相對路徑等保持爲不可點擊文本。 - 圖片與站點圖標使用
referrerPolicy="no-referrer"，並啓用懶加載。
典型用法¶
與 dsh-free-search 配合使用，可以直接這樣提問：
- 「介紹一下埃菲爾鐵塔，配幾張圖，並標註信息來源」
- 「最近一週 DeepSeek 有什麼新聞？每條註明出處」
- 「對比 iPhone 17 和 Pixel 10 的外觀，附圖」
回答中會出現上標角標、正文圖片/圖集以及末尾的「來源 · N」面板。
