跳到正文
  • 首页
  • 插件说明
  • dsh-image-subagent

yuqingsh/dsh-image-subagent

50最近提交 2026年8月14日

dsh-image-subagent DSH 插件

dsh-image-subagent 将图片附件投影为显式文本占位符，使纯文本主模型能够委托多模态子代理读取图片。它集成于 DSH 插件系统，需要预设视觉子代理并配置 read_attachment/read_image 工具。

vision

如何安装 dsh-image-subagent DSH 插件

dsh plugin --profile web add github:yuqingsh/dsh-image-subagent#v0.1.1

复制不会执行命令。安装 dsh-image-subagent DSH 插件前请核对仓库和版本。

dsh-image-subagent DSH 插件数据来源

dsh-image-subagent DSH 插件快照日期：2026年8月16日

discovered

dsh-image-subagent DSH 插件能做什么

  • 让不支持图片的纯文本模型具备处理图片附件的能力
  • 自动将图片附件替换为含 attachmentId 的文本占位符
  • 委托视觉子代理（如 observer）读取图片并返回像素级描述
  • 支持通过 read_attachment/read_image 工具获取图片内容
  • 与 DSH 插件系统无缝集成，按 profile 激活

dsh-image-subagent DSH 插件适合哪些场景

  • 使用纯文本模型分析上传图片的内容
  • 让不支持图片的模型回答与图片相关的问题
  • 构建主模型协调视觉子代理的多模态工作流
  • 在 DSH 会话中自动生成图片描述或字幕

dsh-image-subagent DSH 插件适合谁

  • 需要在纯文本主模型中使用图片附件的 DSH 用户
  • 用 DSH 搭建多模态代理管道的开发者
  • 希望扩展 deepseek-v4-pro 等模型视觉能力的用户

dsh-image-subagent DSH 插件的限制

  • 需要预设视觉子代理，且其模型需声明 image 输入（如 MiniMax-M3）
  • 子代理工具集必须包含 read_attachment 或 read_image
  • 子代理必须在同一会话内派生（spawn/fork）才能读取附件
  • 当前为早期版本 v0.1.1，安装依赖 pnpm
  • 仅支持 DSH web 环境，安装后需重启

dsh-image-subagent DSH 插件的仓库 README 摘录

以下文字摘自 dsh-image-subagent DSH 插件的上游仓库 yuqingsh/dsh-image-subagent 的 README，版权归原作者，仅作引用。

让纯文本主模型（如 deepseek-v4-pro）也能接收图片附件：图片进入会话后投影为显式文本占位符，由主模型委托视觉子代理（多模态模型）读取。 ## 安装 ### 常规安装 ```sh dsh plugin --profile web add github:yuqingsh/dsh-image-subagent#v0.1.1 ``` 发布到 npm 后：`dsh plugin --profile web add dsh-image-subagent`。本地 checkout：`dsh plugin --profile web add ./dsh-image-subagent`。 需要 pnpm（`brew install pnpm`）。安装后重启 `dsh web` 并刷新页面。 ### 用 Prompt 安装 把下面这段发给你的 DSH 会话，让 Agent 代装： > 请安装 dsh-image-subagent 插件：运行 `dsh plugin --profile web add github:yuqingsh/dsh-image-subagent#v0.1.1`。完成后重启 dsh web 进程，刷新浏览器页面。 ## 使用 ### 前置条件（缺一不可） - 预设里有一个视觉子代理（如 observer），其模型声明 image 输入（如 MiniMax-M3）； - 该子代理的工具集包含 `read_attachment` / `read_image`； - 子代理须在本会话内派生（spawn / fork）——附件读取按会话日志授权； - 主模型委托时，把占位符中的 `attachmentId` 一并传给子代理。 ### 日常使用 贴图并附上问题 → 主模型收到占位符（含 `id=sha256:…`）→ 委托 observer 读图 → observer 用 `read_attachment` 返回像素级描述 → 主模型作答。 ### 验证安装 ```sh curl -s -X POST http://127.0.0.1:3080/image-subagent/status \ -H 'content-type: application/json' \ -d '{"type":"client-request","rpcId":"s1","method":"status","payload":{}}' ``` 预期 `bridged` 含 `"image"`，`real` 为路由真实声明。 ## License MIT

阅读完整 README仓库许可: MIT

dsh-image-subagent DSH 插件常见问题

如何安装 dsh-image-subagent？

在终端执行 `dsh plugin --profile web add github:yuqingsh/dsh-image-subagent#v0.1.1`。确保已安装 pnpm（`brew install pnpm`）。安装后重启 `dsh web` 进程并刷新浏览器。你也可以使用 README 中提到的 Prompt 方式让 Agent 代装。

使用这个插件需要什么前置条件？

你的预设里必须有一个视觉子代理（如 observer），其模型声明了 image 输入（例如 MiniMax-M3）。该子代理的工具集必须包含 `read_attachment` 或 `read_image`。子代理必须在同一会话内派生（spawn/fork），主模型委托时需将占位符中的 attachmentId 传给子代理。

为什么主模型没有处理我的图片？

首先检查视觉子代理是否正确配置并在同一会话中派生。确认子代理模型支持图片输入并拥有所需工具。同时确认主模型已将图片占位符委托给子代理。如果问题依旧，尝试重启 DSH web。

是否可以使用任意视觉子代理？

子代理必须声明 image 输入能力，并拥有 `read_attachment` 或 `read_image` 工具。README 以 MiniMax-M3 为例，任何满足要求的模型均可。请确保子代理已在预设中配置并在同一会话中派生。

如何验证插件已正常工作？

执行 curl 命令：`curl -s -X POST http://127.0.0.1:3080/image-subagent/status -H 'content-type: application/json' -d '{"type":"client-request","rpcId":"s1","method":"status","payload":{}}'`。返回的 `bridged` 字段应包含 `"image"`，`real` 为路由的真实声明。