前言¶
在 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 在对话中展示本地文件的需求，适合需要频繁查看截图、文档或媒体素材的开发者使用。
