前言¶
DeepSeek Harness (DSH) 的设计理念是「一切皆插件」。在开发智能体或使用默认配置时,助手生成的图片往往需要更规范的展示方式。dsh-image-container 插件旨在解决这一问题,为对话中的生成图片提供 Codex 风格的画廊和灯箱功能。
这是什么¶
这是一个由 aa2246740 维护的客户端插件。它接管 DeepSeek Harness 中的 conversation.message.images 槽,将助手生成的图片转化为画廊形式进行展示。
核心功能¶
- 图片画廊与灯箱:提供点击查看灯箱、全屏翻页的交互体验。
- 网格布局:支持按比例铺开图片,并允许两三张并排显示。
- 槽位占用:占用公开的
conversation.message.images槽,优先级为-10,用于覆盖默认的内置画廊。
安装与启用¶
安装前请确保 PATH 环境变量中包含官方 dsh(如果没有,可使用 npx @deepseek-ai/dsh)和 pnpm。
使用以下命令安装:
dsh plugin --profile web add github:aa2246740/dsh-image-conatiner
或使用本地目录安装:
git clone https://github.com/aa2246740/dsh-image-conatiner.git
dsh plugin --profile web add ./dsh-image-conatiner
安装完成后,必须重启 Web Host 并刷新页面才能生效。
典型用法¶
当助手生成图片后,图片会自动按比例铺开,以两三张并排的网格形式展示。点击任意一张图片即可进入全屏灯箱模式,支持翻页操作。
适用场景与注意¶
- 目标版本:插件面向官方 DeepSeek Harness 0.2.0-rc.2(对应 npm
@deepseek-ai/dsh@0.2.0-rc.2)。同名包的 peer 依赖为>=0.2.0-rc.1 <0.2.1,不要对着0.1.7alpha 版装。 - 槽位冲突:由于插件占用
conversation.message.images槽,它会覆盖 Harness 自带的默认画廊。 - 旧安装更新:如果之前是通过
file:写入 profile 的旧安装,请改为指向本目录的link:,然后重启 Host。
总结¶
该插件通过接管图片槽位,为 DSH 提供了更现代化的图片展示方案。更多细节和源码可查阅其 GitHub 仓库。