dsh-image-preview
本地图床插件：让会话里的聊天能内嵌显示图片。
功能
- 在 web profile 自带的 HTTP 服务（
ctx.webServer，同源 127.0.0.1:3080）上注册/preview/*路由，静态托管一个预览目录（默认~/.dsh/preview）里的图片。同源 URL（http://127.0.0.1:3080/preview/<name>）在聊天里可直接渲染，无混合内容/CORS 问题。 - 注册模型工具
preview_image(file_path)：把已存在的本地图片复制进预览目录（已在目录内则直接引用），返回可内嵌的 URL。AI 截图/下载图片后，调它即可把图贴进会话。
安装
# 本地路径
dsh plugin --profile web add ./plugins/dsh-image-preview
# 或从 GitHub 安装
dsh plugin --profile web add "github:ReiRui/dsh-image-preview#main"安装后重启 web profile 生效。
配置
在 $DSH_HOME/profiles/web/cordis.patch.yml 里覆盖该行的 config：
- id: image-preview
config:
root: !!js dshHomePath('preview') # 预览目录，可改成项目目录
prefix: /preview # URL 前缀使用
1. 让 AI 生成/下载一张图（截图、渲染预览等）到本地； 2. AI 调用 preview_image 工具传入绝对路径； 3. 工具返回 http://127.0.0.1:3080/preview/<name>，AI 在回复里贴该链接； 4. 页面内联显示图片。
也可以直接访问 http://127.0.0.1:3080/preview/<name> 查看。
AI 使用提示（给 agent 的约定）
- 必须调用
preview_image工具，禁止手动把文件复制进~/.dsh/preview：新会话的文件沙箱默认是workspace-write，AI 的文件工具写不进预览目录（会报"目录出错"）。工具内部不受该沙箱限制。 - 工具返回的
url字段是唯一有效的 URL，AI 应原样内嵌（），不要自行拼接或猜文件名。 - 通过工具复制的文件名为
8位随机-原名（如7faf2295-theme-gallery.png），这是与手动复制区分的特征。 - 工具返回
ok:false时，把error原样报告给用户（文件不存在 / 类型不支持等）。
安全（自审声明）
- 零依赖、零安装期脚本：只依赖 node 内置模块和
ctx；不联网、不读凭据、不起子进程、无 eval。 - 路径隔离：所有响应都经
realpath校验必须位于配置根目录内；拒绝..、反斜杠、NUL。 - 类型白名单：仅 png / jpg / jpeg / webp / gif / avif / bmp，其他扩展名返回 415。
- 无目录列表；未知路径 404。
- 工具只复制显式传入的文件，不会暴露预览目录以外的任意路径。
已知限制
- URL 固定用
127.0.0.1；局域网访问需自行替换为本机 IP（并确保 web 服务绑定 0.0.0.0，如dsh-lan-access插件）。 - 预览目录内的文件不设清理策略，长期使用请定期手动清理。