前言¶
在 DeepSeek Harness Web 裏，智能體一輪執行後經常會生成 Markdown、代碼、圖片或文本文件。默認點擊 produced-file chip 會把文件交給系統默認應用處理；如果只是快速確認產物，打開原生應用或新標籤頁的成本偏高。
dsh-markdown-preview 針對這個場景，將點擊行爲替換爲對話內預覽：保留原有 produced-files 行，但讓 Markdown、圖片、代碼和受限文本直接在會話中展開。
這是什麼¶
dsh-markdown-preview 是一個 DSH 社區插件，用於在 DSH Web 中預覽 produced files。當前 package.json 版本爲 0.3.0，許可證爲 MIT。
它解決的是“文件已經生成，但我想馬上看一下內容”的問題。插件不會改變文件落盤位置，也不提供寫入能力。
核心能力¶
點擊 chip 後在對話中預覽¶
安裝並重啓後，當某輪次生成文件時，點擊 produced-file chip 可切換預覽面板。
預覽不打開原生應用，也不打開新標籤頁。
Markdown、代碼、圖片和純文本¶
- Markdown 在服務端使用
markdown-it渲染，支持 GFM 表格、圍欄代碼、引用、鏈接和硬換行；圍欄代碼使用highlight.js高亮。 - 代碼文件支持 40+ 擴展名，在服務端使用
highlight.js高亮，並以深色編輯器樣式顯示。 - 圖片支持 PNG、JPEG、GIF、WebP、SVG，作爲 data URL 內聯預覽；SVG 通過
<img>加載時不會執行腳本。 - 其他文本文件使用純文本回退；二進制文件會被嗅探並拒絕預覽。
全屏與面板操作¶
預覽面板頭部提供文件大小、全屏、複製內容、在系統應用中打開和摺疊操作。
Markdown、圖片、代碼或純文本預覽可以展開爲全屏 overlay，通過按鈕或 Esc 關閉。
保留原有體驗¶
該插件保留原有 produced-files 行體驗：chips、“+ N files”、“Show in folder”和 inline code-mentions 仍可正常工作。
預覽面板使用 DSH 主題變量適配明暗主題，並修復深色模式下文字不可讀的問題。
安裝與啓用¶
先確認環境滿足：DSH 版本不低於 0.1.0-rc.6，並且 PATH 中有 pnpm，因爲 dsh plugin 會轉發到 pnpm。
安裝命令：
dsh plugin --profile web add dsh-markdown-preview
安裝後重啓 dsh web。
無需額外配置。插件生效後，只要某輪次生成了文件，點擊 produced-file chip 即可切換預覽面板。
卸載¶
dsh plugin --profile web remove dsh-markdown-preview
開發模式¶
如果想基於源碼修改，可以克隆倉庫後以本地路徑安裝：
git clone https://github.com/GitHubJiKe/dsh-markdown-preview.git
cd dsh-markdown-preview
npm install
dsh plugin --profile web add file:$(pwd)
完成後重啓 dsh web。該方式會使用當前工作副本，適合調試。
運行機制與安全邊界¶
插件分爲 host 端和 client 端。
Host 端註冊 /preview RPC channel，並放在 loopback trust fence 下。它負責讀取 Markdown、圖片、代碼或受限文本；打開系統應用的動作代理到 host.openPath。
Client 端接管 deliverables 事件和 conversation.chat.turnTail slot，禁用官方 ui-deliverables 行，並重新提供相關 prompt section/chatFileMentions。
渲染髮生在 host 端，瀏覽器側保持輕量並負責展示。
安全相關限制：
- 預覽通道僅限 loopback，並受 connection trust fence 保護。
- 預覽是隻讀的，沒有寫入端點。
- Markdown 使用
html:false，原始 HTML 會被轉義；鏈接受markdown-it默認validateLink限制爲http(s)/mailto/#。 - 文本文件上限爲 1 MiB，圖片上限爲 4 MiB；超限時顯示顯式截斷提示。
- 二進制文件會被嗅探並拒絕預覽。
因爲插件會在 DSH 進程中註冊通道並讀取文件，安裝前建議檢查源碼、依賴和許可證。當前依賴包含 highlight.js ^11.11.1 與 markdown-it ^15.0.0。
適合誰¶
適合經常使用 DSH Web 調試智能體產物的人，尤其是需要頻繁查看 Markdown、代碼和圖片，但不想每次切換原生應用的開發者。
如果主要需求是文件樹、路徑提及、HTML 導出或 Web 項目預覽，該插件不是對應工具；它專注於在官方 produced-files 行上提供內聯預覽。
鏈接¶
- GitHub：https://github.com/GitHubJiKe/dsh-markdown-preview
- 目錄頁：https://www.skillhub.cn/plugins/GitHubJiKe/dsh-markdown-preview
