carlclouder/dsh-image-serve

你一定遇到过这个场景：你让 AI "给我看看刚那张截图" / "把生成的封面图展示一下"， 它一本正经地回复"图片已保存到 D:\shots\fig1.png"——然后呢？什么都不会出现。 那只是一行打不开的死文本。

原因：DeepSeek Harness 的 web 会话里，markdown 渲染器只认 http/https 图片源。 你的截图、AI 生成图、本地文档全在硬盘上，file: 和 data: 引用一律被过滤， 而 DSH 官方没有提供任何本地文件路由。这不是配置问题，是这个能力缺口从第一天 就在——直到装上这个插件。

装完之后：同样一句"给我看看 fig1.png"，AI 回复的是 ![fig1](http://127.0.0.1:3080/ws/D:/shots/fig1.png)——图片直接渲染在对话里。 任意盘、任意目录、中文路径、NAS 共享，全都直接显示，不需要复制到任何特定文件夹。

---

dsh-image-serve

DeepSeek Harness 的本地文件展示插件：安装一次，会话 markdown 即可通过 /ws/<本地绝对路径> 直接渲染磁盘上任何位置的图片与文件。

English: register a /ws route in dsh web that maps /ws/<absolute local path> to any file on disk, so session markdown can render local images via same-origin http URLs (the renderer accepts http/https only). No root, no whitelist, no staging directory — any drive, any folder.

效果预览 / Demo

九个不同位置的文件（跨 C/D/E/F 盘、中文路径、深层嵌套、UNC），全部经 /ws 路由直接渲染：

前后对比：

它解决什么问题 / What it solves

没装本插件	装了本插件
AI：图片已保存 D:\shots\fig1.png（一行死路径，什么也看不到）	AI： ← 图片直接显示在对话里
出图后要自己切到文件夹打开看	出图即看，零切换
想展示别的目录的图？先手动复制到约定目录	任何位置直接引用，包括 C:\、E:\、NAS

典型场景：让 AI 展示它刚处理的截图、AI 出图后当场验收、多张图表并排对比、 导出的文档/网页快照直接预览。

快速上手（30 秒）

dsh plugin --profile web add dsh-image-serve   # 在线安装
# 或离线：dsh plugin --profile web add <本包 .tgz 路径>（零依赖，自包含）

重启 dsh web。之后 markdown 里写（/ws/ 后跟本地绝对路径）：

http://127.0.0.1:3080/ws/D:/AI任务/Generated/cover.png
http://127.0.0.1:3080/ws/D:/AI任务/                 （指向目录 → 返回可浏览的文件列表页）
http://127.0.0.1:3080/ws/D:\截图\对比图.png        （反斜杠写法等价）
http://127.0.0.1:3080/ws//NAS/share/方案.png       （UNC 网络路径）

相对路径会返回 400 并附提示；只支持 GET/HEAD；MIME 自动识别 （png/jpg/webp/svg/md/json…）。

安全须知（装前必读）

/ws 是本地任意文件的读取通道，没有白名单（v2.1 起应用户明确决策移除白名单设计）：

• 路由的可达范围 = dsh web 的可达范围：默认仅本机回环 127.0.0.1；
• 但如果你通过 Tailscale 等反把 web 暴露到远程，远程设备同样能读取本地任意文件；
• 只读，无写入/删除/列目录。

从 v2.0 / 文件式旧版迁移

旧短链接 …/ws/<文件名>（隐含 D:\AI任务 根目录）已失效，请改写为完整 …/ws/D:/AI任务/<文件名> 形式。root 配置已不存在，profile patch 里的覆盖行 （如 - id: web-workspace-files, config: {root: ...}）可删除。

特性一览 / Features

• 目录浏览：/ws 指向目录时返回可点击的 HTML 文件列表（子目录优先、大小/修改时间、上一级导航，文件名已做 HTML 转义）
• 零运行时依赖的标准 npm bundle；可在 dsh-market 中热启停/更新/卸载
• 跨盘符（C:/D:/E:/…）、中文路径、深层嵌套目录、UNC 均实测可用
• 明确报错：相对路径 400 + 提示、文件不存在 404、非 GET/HEAD 405

License

MIT