把截图直接拖进对话框：Agent Client for Obsidian如何向AI智能体发送图片与文件
【免费下载链接】obsidian-agent-clientBring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-agent-client
Agent Client for Obsidian 是一款把 Claude Code、Codex 等 AI 智能体接入 Obsidian 的插件。除了用@提及笔记，它还有一个新手最爱用的功能——把截图和文件直接拖进对话框，让智能体"看懂"你的图片。本文带你快速掌握向 AI 智能体发送图片与文件的全部方法。
📌 为什么要把截图发给智能体？
用文字描述"帮我看看这张架构图里的问题"往往说不清，但把截图直接丢给智能体就行：识别 OCR 文字、分析报错截图、解读图表、理解 UI 设计……附件功能让 AI 智能体真正进入你的工作流，而不是只处理纯文本。
发送图片与文件的两种方法
插件提供了两种发送方式，操作逻辑一致：附件会以缩略图（图片）或文件图标（其他文件）出现在文本框下方，发送时随消息一起发出。
方法一：拖拽到输入框（最快上手）
- 从资源管理器（Finder / Explorer）中按住文件
- 拖到 Agent Client 的对话框输入区域——拖过时输入区域会高亮提示
- 松手，缩略图即刻出现在文本区下方
实现代码位于 src/ui/InputArea.tsx 的handleDrop处理函数中。
方法二：剪贴板粘贴（截图党首选）
- 截图或复制文件到剪贴板
- 点击聚焦对话框的输入框
- 按
Cmd/Ctrl + V粘贴
粘贴逻辑在 src/ui/InputArea.tsx 的handlePaste中实现。
附件预览：发送前随时可撤回
所有附件统一由 src/ui/shared/AttachmentStrip.tsx 组件渲染成一个横向预览条：
- 图片→ 显示缩略图
- 其他文件→ 显示文件图标 + 文件名
- 撤回→ 鼠标悬停在附件上，点击×按钮即可移除
支持哪些图片格式？
插件采用白名单机制，只识别这几种图片类型（定义见 src/ui/InputArea.tsx）：
| 格式 | MIME 类型 |
|---|---|
| PNG | image/png |
| JPEG | image/jpeg |
| GIF | image/gif |
| WebP | image/webp |
非图片文件没有格式限制——PDF、代码、数据文件都可以发，插件会以文件路径引用的方式交给智能体，由智能体根据自己的工具能力决定如何读取。
⚠️ 两条硬限制要记牢
| 限制 | 数值 |
|---|---|
| 单张图片最大尺寸 | 5 MB |
| 每条消息附件总数（图片 + 文件） | 10 个 |
这两个常量定义在 src/ui/InputArea.tsx。超限时插件会弹出通知提示你，比如[Agent Client] Image too large (max 5MB)。截图通常远小于 5MB，日常使用基本不会碰到这个上限。
智能体不支持图片时会怎样？
这里有个重要细节："智能体看懂图片"取决于智能体本身的能力，而非插件。
- 智能体支持图片 → 图片以 base64 内嵌进消息发送（见 src/services/message-sender.ts 的提示词构造逻辑）
- 智能体不支持图片 → 图片自动降级为文件路径引用，智能体可用自己的工具读取该文件
- 若粘贴时智能体不支持图片粘贴，插件会提示：This agent does not support image paste. Try drag & drop instead.（试试拖拽）
也就是说，最坏情况也只是"智能体去读文件"，而不是发送失败。
组合技：图片 + 笔记上下文一起发
发送图片时，别忘了同时用@提及相关笔记——智能体就能"图文对照"地分析。例如把一段选中文字和一张截图一起发给它，让它解释截图中的报错。
常见问题速查
- 发不了图片？确认格式是 PNG/JPEG/GIF/WebP 且不超过 5MB
- 一次想发很多文件？图片+文件合计最多 10 个，分批发送即可
- 智能体"没看"我的图？检查该智能体是否支持图片输入，详见 docs/usage/sending-images.md 官方文档
掌握"拖拽 + 粘贴"这两个动作，你就已经把 Obsidian 变成了 AI 智能体的前端。接下来可以进一步了解 docs/usage/context-files.md 中的上下文文件配置，让智能体更懂你的仓库。
【免费下载链接】obsidian-agent-clientBring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-agent-client
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
