ReiRui/dsh-image-preview

README excerpt

dsh-image-preview 本地图床插件：让会话里的聊天能 内嵌显示图片 。 功能 - 在 web profile 自带的 HTTP 服务（ ctx.webServer ，同源 127.0.0.1:3080）上注册 /preview/ 路由，静态托管一个预览目录（默认 /.dsh/preview ）里的图片。同源 URL（ http://127.0.0.1:3080/preview/ ）在聊天里可直接渲染，无混合内容/CORS 问题。 - 注册模型工具 preview image(file path) ：把已存在的本地图片复制进预览目录（已在目录内则直接引用），返回可内嵌的 URL。AI 截图/下载图片后，调它即可把图贴进会话。 安装 安装后 重启 web profile 生效。 配置 在 $DSH HOME/profiles/web/cordis.patch.yml 里覆盖该行的 config ： 使用 1. 让 AI 生成/下载一张图（截图、渲染预览等）到本地； 2. AI 调用 preview image 工具传入绝对路径； 3. 工具返回 http://127.0.0.1:3080/preview/ ，AI 在回复里贴该链接； 4. 页面内联显示图片。 也可以直接访问 http://127.0.0.1:3080/preview/ 查看。 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，…

Category