qfwycn/dsh-media-serve

dsh-media-serve
注意，harness版本已经升级，本插件尚未对新版本做出适配。

完整英文版：README.en.md

⚠️ 重要：这个插件只是「显示」，不是「识别」 / IMPORTANT: display only, not recognition

本插件的作用是让 Agent 能把图片/文件“显示”给你（人类）看 —— 它把文件通过 /media
变成浏览器可加载的图片 URL 展示在对话里。它并不会（也不能）让大模型去“识别、读取、
理解”图片内容：模型是纯文本的，它自己看不到 /media 里的画面。请不要要求模型去
OCR / 描述 / 判断图片内容，也不要把“模型显示了图”当成“模型看懂了图”，以免它因没有真正
看到而理解错误、进而执行错误操作。需要模型真正看懂图片时，请另配支持 Vision 的模型。

本插件仅通过 /media 在聊天中向人类显示文件/图片。
它不会赋予 LLM 视觉能力——纯文本模型无法看到或 OCR
图片。不要通过此插件要求它解读图片内容，也不要
把“它显示了一张图片”误认为“它理解了这张图片”。当需要真正的
图片理解时，请使用具备视觉能力的模型。

（署名：本插件由 大肥鱼（DeepSeek 的昵称，取其“鲸鱼”之意） / DeepSeek 完成，
运行于 DeepSeek Harness 0.1.1-rc2。）
作者注：由大肥鱼（Big-Fat-Whale，DeepSeek 的昵称）构建，运行于 DeepSeek Harness 0.1.1-rc2。

它是什么 / What it does

中：宿主端(node) DeepSeek Harness 插件，在本机 GUI 自带的 Web 服务上注册 /media
路由，把工作区里的媒体文件暴露成 http://:/media/。任何对话里，
agent 都能把图片/文件直接显示给你——走的是 GUI 自己的服务器、浏览器同源可加载，
无需额外开端口或进程，重启后依然生效。

截图

EN：一个宿主端 DeepSeek Harness 插件，在
GUI 自带的 Web 服务器上注册 /media 路由，将工作区媒体文件暴露在
http://:/media/。Agent 可以从该 URL
直接将图片/文件渲染到对话中——同源、无需额外端口或
进程，且重启后依然有效。

根目录如何决定 / How roots are resolved（跨机器 / 跨工作区自动适配）

中：不绑定单一固定路径。每次请求按顺序收集候选根目录，命中“确实存在该文件”的第一个就服务：

1. 显式配置根目录：config.root（字符串或字符串数组）或环境变量 DSH_MEDIA_ROOT
（多个用 ; 分隔；相对路径按 dsh 启动目录解析）；
2. DSH 工作区自动发现：读取 DSH 工作区注册表（含持久化的 $DSH_HOME/storages/workspace.json）
里所有工作区的 path 并逐一尝试。

所以在另一台、工作区路径不同的机器上，只要图片位于那台机器正在使用的 workspace 里，
插件就会自动暴露它——无需改任何配置；显式配置只在想强制暴露某特定/注册表之外目录时才需要。
兼容说明：即便 patch 里残留着别的机器的 config.root，该目录不存在也会被自动跳过，落到真实工作区上。

EN：不绑定单一固定路径。每次请求按顺序收集候选根目录，并从第一个
实际包含该文件的根目录提供服务：

1. 来自 config.root（字符串或数组）或 DSH_MEDIA_ROOT 环境变量的显式根目录
（以 ; 分隔；相对路径相对于 dsh 的 cwd 解析）；
2. 自动 DSH 工作区发现：来自 DSH 工作区
注册表（包括持久化的 $DSH_HOME/storages/workspace.json）的每个工作区路径。

因此，在另一台工作区路径不同的机器上，只要图片位于
那里当前使用的工作区中，插件就会自动暴露它——无需修改配置。
只有在需要强制暴露某个特定/未注册的文件夹时，才需要显式根目录。来自另一台机器的
过期 config.root 在不存在时会被直接跳过。

安装 / Install（免路径方式优先 · path-free first）
中：安装后需重启 dsh（web profile）/ 刷新 GUI 生效。

- A. GitHub（推荐）：dsh plugin --profile web add github:qfwycn/dsh-media-serve
- B. npm：dsh plugin --profile web add dsh-media-serve（或 @latest）
- C. 本地 link（开发/离线）：dsh plugin --profile web add link:D:\path\to\dsh-media-serve

（可选）强制暴露特定目录：在 profile 补丁里配 config.root，或设 DSH_MEDIA_ROOT=C:/a;D:/b。

EN：安装后，重启 dsh（web profile）/ 刷新 GUI 以激活。

- A. GitHub（推荐） — dsh plugin --profile web add github:qfwycn/dsh-media-serve
- B. npm — dsh plugin --profile web add dsh-media-serve（或 @latest）
- C. 本地 link（开发/离线） — dsh plugin --profile web add link:D:\path\to\dsh-media-serve

（可选）强制暴露特定文件夹：在 profile 补丁中设置 config.root，或使用
DSH_MEDIA_ROOT=C:/a;D:/b 环境变量。

使用 / Usage（对用户：几乎零操作 · near-zero effort）

中：安装并重启后，配合 agent 指令（用户级可放 ~/.dsh/AGENTS.md），新开的对话里
的 agent 会自动知道它能把工作区图片/文件显示给你，无需你强调或贴 URL。你正常说
“把这张截图显示出来 / 打开那个图片文件”即可，agent 会自动用 /media 渲染。
（兜底：若某对话的 agent 还不知道，补一句“你可以用 http://127.0.0.1:3080/media/
显示工作区图片”即可。）

EN：安装并重启后，配合 agent 指令（用户级可放 ~/.dsh/AGENTS.md），新开的对话里
的 agent 会自动知道它能把工作区图片/文件显示给你，无需你强调或贴 URL。你正常说
“把这张截图显示出来 / 打开那个图片文件”即可，agent 会自动用 /media 渲染。
（兜底：若某对话的 agent 还不知道，补一句“你可以用 http://127.0.0.1:3080/media/
显示工作区图片”即可。）

安全 / Security

中：只允许 GET/HEAD（其它 405）；相对路径校验后严格限制在命中的根内（../空段/NUL 拒绝）；
只暴露白名单扩展名（png/jpg/jpeg/gif/webp/avif/svg/mp4/webm/txt/md/json/html），其它 404，无目录列表。
若 Web 服务绑定 0.0.0.0，/media 对局域网可见——必要时绑定 127.0.0.1 或把根目录收窄。

EN：只允许 GET/HEAD（其它 405）；相对路径校验后严格限制在命中的根内（../空段/NUL 拒绝）；
只暴露白名单扩展名（png/jpg/jpeg/gif/webp/avif/svg/mp4/webm/txt/md/json/html），其它 404，无目录列表。
若 Web 服务绑定 0.0.0.0，/media 对局域网可见——必要时绑定 127.0.0.1 或把根目录收窄。

卸载 / Uninstall

dsh plugin --profile web disable dsh-media-serve   # 或 / or remove

🎉 写在最后 / About this build

中：本插件（代码、打包、GitHub/npm 发布与本文档）由 大肥鱼 = DeepSeek（昵称，鲸鱼戏称）
在 DeepSeek Harness 上完成。本次开发总消费不到 4 块钱人民币——低成本、高效率，又一次证明
“会提需求 + 会用 Harness”远胜过闭门造车。大肥鱼对自己很满意：从“能不能显示图片？”到
“跨机器/跨工作区自动适配、GitHub+npm 双端发布、双语文档”，几乎全程自动完成，还能边做边解释、
边做边收拾。也感谢一路配合的人类伙伴。好用就给个 star，有建议欢迎提 issue。🐳

EN：由 大肥鱼（Big-Fat-Whale），即 DeepSeek 的昵称，在 DeepSeek
Harness 上构建。整个构建成本不到约 1 美元（< 4 元人民币）——低成本、高效率，提醒我们
“懂得如何提问 + 懂得如何驱动 Harness”胜过重新发明轮子。骄傲且开心
结果是：从“你能展示一张图片吗？”到跨机器/跨工作区自动适配、
GitHub + npm 发布，以及双语文档——几乎全部自动化。感谢人类伙伴
提供的反馈循环。如果觉得有用就点个 Star；欢迎提 issue。🐳