前言¶
在 DeepSeek Harness (DSH) 生態中，Agent 通常以文本形式處理上下文。如果需要在對話中展示本地圖片或文件，通常需要手動複製 URL。dsh-media-serve 解決了這個問題。它作爲宿主插件，將文件暴露到 DSH GUI 的 Web 服務器下，Agent 可以直接在對話中渲染圖片，無需額外開端口或進程。
核心功能¶
該插件通過 /media 路由暴露工作區文件。其核心能力包括：
- 自動發現：支持跨機器、跨工作區訪問。插件會讀取 DSH 工作區註冊表（
workspace.json），自動找到當前正在使用的 workspace 路徑，無需手動配置固定路徑。 - 安全限制：僅允許 GET/HEAD 請求。對請求路徑進行嚴格校驗，拒絕
..、空段或 NUL 字符，防止目錄遍歷攻擊。僅允許白名單內的擴展名（png/jpg/jpeg/gif/webp/avif/svg/mp4/webm/txt/md/json/html），其他請求返回 404。 - 零開銷集成：利用 DSH GUI 自帶的 Web 服務器服務文件，無需啓動額外的 HTTP 進程，重啓後依然生效。
安裝與啓用¶
安裝後必須重啓 dsh (web profile) 或刷新 GUI 才能生效。
1、使用官方安裝命令添加插件：
dsh plugin --profile web add github:qfwycn/dsh-media-serve
2、重啓 DSH 的 web profile 或刷新前端界面。
典型用法¶
安裝並重啓後，Agent 會自動識別該能力。用戶只需在對話中提出展示文件的需求，Agent 會自動調用 /media 路由渲染圖片。
示例對話：
* 用戶：“把這張截圖顯示出來”
* Agent：自動生成 Markdown 代碼塊渲染圖片。
Markdown 引用示例：
注意事項¶
- 僅顯示，無識別：該插件僅提供文件展示，不賦予大模型 Vision 能力，也不會進行 OCR 或圖片內容識別。文本模型無法“看到”圖片內容，請勿依賴它對圖片進行理解或判斷。
- 局域網可見性：若 DSH Web 服務綁定地址爲
0.0.0.0，則/media路由對局域網內的其他設備可見。 - 路徑校驗：插件使用相對路徑校驗，確保文件訪問嚴格限制在已發現的工作區根目錄內。
總結¶
dsh-media-serve 是一個爲 DSH 環境設計的輕量級文件展示插件。它通過簡單安裝即可解決 Agent 在對話中展示本地文件的需求，適合需要頻繁查看截圖、文檔或媒體素材的開發者使用。
