词元广场TOKPUB.COM - 欢迎您，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
2.1d 使用图片与 AI 对话
💡 新手进阶：截图发给 AI，让 bug 无处藏身
📝 课程笔记
学完你能做什么
你现在的困境
什么时候用这一招
| 场景 | 例子 |
|---|---|
| 分析报错 | 截图错误弹窗，让 AI 给出解决方案 |
| 界面审查 | 传设计稿让 AI 提改进建议 |
| OCR 文字识别 | 截图 PDF 或网页，让 AI 提取文字 |
| 代码审查 | 截图代码片段，让 AI 解释或重构 |
🎒 开始前的准备
模型支持情况
国内模型：只有 Kimi K2.5 支持图片，GLM-5、MiniMax 2.5、DeepSeek、豆包、通义千问等不支持
核心思路
1.
2.
@图片路径 或粘贴文件路径3.
[Image 1]、[Image 2] 这样的虚拟标记。发送后，AI 就能看到并分析图片内容。跟我做
第 0 步：各平台截图方法
| 系统 | 区域截图 | 全屏截图 | 窗口截图 |
|---|---|---|---|
| Windows | Win + Shift + S | PrtScn | Alt + PrtScn |
| Mac | Cmd + Shift + 4 | Cmd + Shift + 3 | Cmd + Shift + 4 然后按空格 |
| Linux (GNOME) | PrtScn 选区域 | PrtScn | Alt + PrtScn |
| Linux (KDE) | Meta + Shift + S | PrtScn | Meta + PrtScn |
Ctrl + Cmd + Shift + 4 可直接复制到剪贴板:::
第 1 步：截图并粘贴
1.
2.
3.
Ctrl+V[Image 1] 标记┌─────────────────────────────────────┐
│ 请帮我分析这个报错 [Image 1] │
└─────────────────────────────────────┘OpenCode 会自动检测剪贴板里的图片内容，并转换为 base64 格式发送给 AI。
第 2 步：Linux 用户安装剪贴板工具（如需要）
如果你按
Ctrl+V 后没有出现 [Image 1]，且你使用的是 Linux，就需要安装剪贴板工具。Linux 的 X11/Wayland 图形协议需要额外工具才能读取剪贴板图片。
xsel 作为备选
Ctrl+V。Ctrl+V 粘贴图片正常工作[Image 1] 标记第 3 步：引用本地图片文件
1.
@2.
3.
1.
2.
[Image 1] 标记第 4 步：发送并查看 AI 回复
1.
[Image 1] 前后添加你的问题描述2.
Enter 发送用户：这个报错是什么意思？[Image 1]
AI：这个错误表示模块找不到。从截图看，问题出在...第 5 步：删除已添加的图片
Backspace 或 Delete 删除 [Image 1] 标记删除虚拟标记就等同于取消这张图片的发送。图片不会随消息发出。
检查点 ✅
[Image 1]）🚑 故障排除：Ctrl+V 不能粘贴图片
第 1 关：确认图片真的在剪贴板
Ctrl+V，如果能粘贴出文字说明截图工具复制的是文字描述第 2 关：Linux 专用检查
第 3 关：确认不是模型问题
[Image 1]，但 AI 说看不到图。| 提供商 | 支持图片的模型 |
|---|---|
| OpenAI | GPT-5.2、GPT-5 |
| Anthropic | Claude Opus 4.6、Claude Sonnet 4.6 |
| Gemini 3.1 Pro/Flash | |
| 月之暗面 | Kimi K2.5（国内首推） |
国内模型注意
At least one of the image dimensions exceed max allowed sizegpt-5.2-codex 模型目前有图片粘贴问题：[Image 1]，但发送时提示 "File not found: Image 1"GPT-5.2（非 Codex）或其他支持图片的模型。第 4 关：快捷键冲突检查
Ctrl+V 输入框出现了 ^V 或其他奇怪字符。Ctrl+V。Ctrl+V 绑定的是「粘贴」Cmd+V 绑定Ctrl+V 而不是 Cmd+V第 5 关：终端多路复用器问题
第 6 关：WSL 环境特殊问题
踩坑提醒
| 现象 | 原因 | 解决 |
|---|---|---|
| Ctrl+V 没反应 | Linux 缺少剪贴板工具 | 安装 xclip 或 wl-clipboard |
粘贴后出现 ^V | 终端快捷键冲突 | 检查终端设置 |
| 粘贴后 AI 说看不到图 | 模型不支持图片输入 | 切换到 GPT-5.2、Claude 4.6、Kimi K2.5 等支持图片的模型 |
[Image 1] 删不掉 | 在只读模式或输入框锁定 | 确保输入框处于编辑状态 |
| 图片太大发送失败 | Anthropic 模型限制 2000 像素 | 压缩 图片或截图时选较小区域 |
| Mac 截图后粘贴没图 | 截图保存到了桌面，没进剪贴板 | 用 Ctrl + Cmd + Shift + 4 区域截图 |
| JetBrains IDE 内粘贴失败 | IDE Terminal 快捷键处理不同 | 用 Ctrl+V 而不是 Cmd+V（Mac） |
| Zellij/tmux 中复制失败 | 多路复用器拦截 OSC52 序列 | 暂时退出多路复用器使用 |
| 某些输入法下粘贴失败 | macOS 输入法切换导致快捷键识别异常 | 切换到英文输入法再试 |
| WSL 中粘贴不稳定 | Windows/Linux 剪贴板桥接问题 | 直接在 Windows Terminal 中运行 OpenCode |
本课小结
1.
2.
3.
4.
5.
6.
Ctrl+V 而非 Cmd+V7.
[Image N] 是虚拟标记：可随时删除下一课预告
下一课我们学习 2.2 管理对话。 你会学到： 新建、切换多个对话会话 撤销误发的消息 导出对话记录
附录：源码参考
点击展开查看源码位置
更新时间：2026-03-01（v1.2+）
| 功能 | 文件路径 | 关键逻辑 |
|---|---|---|
| 剪贴板图片读取 | src/cli/cmd/tui/util/clipboard.ts | 跨平台图片读取实现 |
| Windows 图片粘贴 | src/cli/cmd/tui/component/prompt/index.tsx | Ctrl+V 拦截图片粘贴 |
| 粘贴事件处理 | src/cli/cmd/tui/component/prompt/index.tsx | onPaste 事件处理 |
| 图片标记插入 | src/cli/cmd/tui/component/prompt/index.tsx | pasteImage 函数实现 |
| 图片文件引用 | src/session/prompt.ts | @ 引用文件处理 |
| 图片发送给 AI | src/acp/agent.ts | image block 发送逻辑 |
| 快捷键配置 | src/config/config.ts | input_paste 默认 ctrl+v |
clipboard.ts:30-74）：