文件与图片附件

适用 OpenCode V2 · 核验日期：2026-11-12。 来源：官方 Attachments↗。本文为官方当前文档的中文操作指南；未在本站执行安装、认证或模型请求。

桌面或 Web 可通过 Attach file、粘贴、拖放添加文件；终端通过 @ 引用文件。选择支持相应输入类型的模型，再请求它处理内容。

# V2 支持的内容#

SVG 作为文本。AVIF、BMP、音频、视频及其他二进制附件不会作为可读媒体加入模型请求；先转成支持格式。模型不支持类型时可能收到简短说明，而非文件内容。界面接收文件不代表模型看到完整内容。

# 程序化 URI#

V2 附件使用 uri，可加 name、description：

json
复制
1{
2  "uri": "file:///home/me/project/src/server.ts?start=20&end=60",
3  "name": "server.ts",
4  "description": "HTTP 服务入口"
5}

file: 必须是服务器可读取的绝对路径，行号从 1 开始。也支持内联 data: URL，不支持 HTTP/HTTPS 附件 URL。远程服务不能自动读取客户端本机路径。

# 大小限制#

每个直接附件解码后最多 20 MiB；桌面文件选择器单次选择总计最多 20 MiB，其他客户端可能更小。提供商还可施加自己的尺寸、格式和数量限制。改扩展名或 data URL MIME 类型不会把不支持的二进制变成支持格式。

# 图片处理#

json
复制
1{
2  "$schema": "https://opencode.ai/config.json",
3  "media": {
4    "image": {
5      "auto_resize": true,
6      "max_width": 2000,
7      "max_height": 2000,
8      "max_base64_bytes": 5242880
9    }
10  }
11}

以上为默认值，适用于提示图片和内置 read 返回的图片。V2 使用 media，不是旧 attachment。

自动缩放保持宽高比，并尝试更小的 PNG/JPEG 编码以满足 Base64 大小限制，因此输出格式可能改变。auto_resize: false 会拒绝超限图片，解码失败同样报错。

缩放器不可用时会原样传递图片。 这些设置是处理限制，不是上传或安全边界；提供商仍可拒绝。附加私有源码、人物照片或文件前检查将发送到哪个模型服务。