@aetheri-ai/dsh-show-image

English | README.md

一个 DeepSeek Harness 插件，添加 show_image 工具：模型可以把本地现有的 PNG、JPEG、WebP 或 GIF 文件展示给人类观众，在 Web 会话记录中内联渲染。

安装

在提供文件系统、工具运行时与持久附件的基础 profile（dsh-base 三者齐备）上安装。按 dsh 的安装方式选择对应命令：

# 已全局安装 dsh
dsh plugin --profile web add @aetheri-ai/dsh-show-image

# 直接从 npm 运行 dsh
npx @deepseek-ai/dsh plugin --profile web add @aetheri-ai/dsh-show-image

# deepseek-harness 源码 checkout
pnpm dsh plugin --profile web add @aetheri-ai/dsh-show-image

重启 Web profile 后新建会话。新发布版本可能尚未同步到配置的镜像源；需要时在安装命令末尾追加 --registry=https://registry.npmjs.org。

用以下命令确认 bundle 已进入组合树：

dsh --profile web --dump-config

输出中会有 @aetheri-ai/dsh-show-image 段和 show-image 行。卸载命令：

dsh plugin --profile web remove @aetheri-ai/dsh-show-image

使用

在新会话中让模型展示一张已有的受支持图片，例如“在会话中展示 docs/architecture.png”。模型会调用：

{ "file_path": "docs/architecture.png" }

相对路径按会话工作区解析。工具把图片提交到持久附件存储，返回 image block，Web 客户端内联渲染（复用既有的加载、重试与放大查看行为）。实际发起工具调用的模型路由仍需具备正常的 dsh provider/API key 配置。

设计

• 纯展示：工具面向人类观众，不要求模型具备视觉路由——模型需要检查像素时用 read_image。
• 尊重策略：路径经文件系统提供方解析，沙箱限制与文件策略原样生效。
• 持久化：图片以内容寻址附件存储，日志中不出现临时路径或内联 base64。
• 条件注册：仅在持久附件存储挂载时注册。

兼容性

peer 依赖跟随 dsh 的 npm 发版线（^0.1.1-rc.2，cordis ^4.0.1）。dsh 处于 developer preview，破坏性发版时本插件同步更新。

开发

pnpm install
pnpm run test        # 单元 + 真实 Loader 组合测试
pnpm run build       # tsdown 产出到 lib/
pnpm run typecheck

许可

MIT