carlclouder/dsh-image-serve

为什么你的 AI 助手永远“给你看不了”一张本地图？装这个插件就解决了。

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

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

装完之后：同样一句“给我看看 fig1.png”，AI 回复的是
fig1——图片直接渲染在对话里。
任意盘、任意目录、中文路径、NAS 共享，全都直接显示，不需要复制到任何特定文件夹。

dsh-image-serve

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

English：在 dsh web 中注册一条 /ws 路由，将 /ws/
映射到磁盘上的任意文件，使会话 markdown 能通过同源 http URL 渲染本地图片
（渲染器只接受 http/https）。无需 root、无需白名单、无需暂存目录——任意盘、任意文件夹。

效果预览 / Demo

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

9 个不同位置的图片全部直接渲染

前后对比：

before-after 对比

它解决什么问题 / What it solves

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

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

快速上手（30 秒）

dsh plugin --profile web add dsh-image-serve   # 在线安装
或离线：dsh plugin --profile web add （零依赖，自包含）

重启 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