4.2 添加附件
本节目标
学会把图片、文档和其他文件喂给 agent，让它"看到"你的设计稿、截图，或直接拿到你的文件来干活。
为什么要加附件
对话只靠文字，很多场景说不清楚：
- 你想让它照着设计稿做页面，光描述颜色、间距太费劲，把图发过去它直接看
- 你截图了一个报错弹窗，直接发图，它读图就知道问题在哪
- 你想让它按流程图改逻辑，把图拖进去，它照着改
- 你有一份现成的文档或数据文件，直接拖进去，省去复制粘贴
这就是附件的作用：让 agent 直接拿到你手里的素材，而不是靠转述。
怎么添加附件
添加方式很直接，和聊天软件发文件一样：
- 整页拖拽：把文件直接拖进主界面任意位置，松开即添加
- 粘贴：复制一张图片（比如截图后 Ctrl+C），在输入框里按 Ctrl+V 粘贴
添加成功后，输入框上方会出现附件预览：图片显示缩略图，非图片文件显示文件名和大小。确认无误后正常发送即可。
发送后，附件会作为消息的一部分出现在对话流里，agent 会先处理附件（看图或读文件）再回答你。
支持哪些文件
0.1.3-alpha.1 起，dsh 的附件不再限于图片，任意文件都能拖进来上传。两类文件各有各的呈现方式：
图片（PNG、JPEG、WebP、GIF）走图片预览卡，agent 可以直接"看图"：
| 格式 | 用途 |
|---|---|
| PNG | 截图、设计稿 |
| JPEG / JPG | 照片、效果图 |
| WebP | 网页素材 |
| GIF | 动图、演示 |
非图片文件（PDF、代码、文本文档、数据文件等）走文件卡片：240×64 像素的圆角卡，显示文件名、扩展名标签和大小。上传中会显示圆形转圈与底部进度条，失败时卡片描边变红、文件名下方一行红色错误信息，卡片整体可点击重试，悬停或聚焦右上角出现 × 删除按钮。agent 不会"看"这些文件，而是收到一个内容寻址的文件引用（sha256），按需在工作区里读取。
什么时候用文件上传
文件上传适合临时给 agent 一个它工作区里没有的文件。如果文件已经在工作区里，直接让 agent 读文件路径就行，不用上传。图片仍然走拖拽或粘贴，因为多模态模型需要直接看图。
图片有哪些限制
dsh 对图片做了明确的配额和归一化，了解它能避免"图发不出去"：
- 单条消息上限：最多 20 张图，原始数据合计不超过 200 MiB
- 单张原图上限：最大 20 MiB、6400 万像素、任一边不超过 8192 像素
- 自动归一化：缩进 2048×2048 像素的归一化预算（长边上限 8192 像素）、编码后约 4 MiB；超大幅图会被缩小，但关键信息基本保留
- 方向修正：按 EXIF 信息自动摆正，不用手动旋转
- 查看尺寸：读图返回的是归一化后的实际尺寸，不是你原图的尺寸
非图片文件没有像素归一化，走的是常规文件大小限制。
看图的模型
只有声明了图片模态的模型才收得下图片。DeepSeek 自带的 deepseek-v4-flash-vision-exp 是多模态模型，配好后直接在对话里粘贴图它就能看；普通文本模型即使贴了图也会在发送前被拒绝。非图片文件不受此限制，因为 agent 是读文件内容而不是"看图"。
图片进了上下文，就占 token
每张图片都会被模型提供智能的大模型服务，dsh 负责调度它来思考与生成。"看"一遍，占用上下文的 token。图片越多越大，对话开销越高。用完的图片可以从消息里删掉，控制上下文模型一次请求中可见的信息范围，包括对话历史、注入的提示和工具结果。在合理范围。
v41 估算更准
0.1.5-rc.2 起，DeepSeek 提供方的图片 token 估算改用官方 v41 计算器：统一 544×544 放大下限、约 1300×1300 缩小目标、单图 1024 token 上限，按宽高比自适应网格尺寸。因此你在 Turn usage 看到的「Cached/Uncached input」会变精确而不是给出最坏情况上界，横向对比不同模型的图片成本时更可靠。
常见问题
问：拖文件没反应？
确认拖的是文件（图片或文档），并且拖进了主界面区域而不是系统任务栏。如果拖拽不行，改用截图后直接粘贴（仅限图片）。
问：agent 说看不懂图？
图太糊、文字太小的图识别效果差。截图时放大关键区域，或者用文字补充说明重点。
小结
- 拖拽或粘贴文件到界面，图片走预览卡、非图片文件走文件卡
- 图片支持 PNG、JPEG、WebP、GIF，非图片文件不限类型
- 图片占 token，能用工作区agent 干活的项目目录，包含路径、显示名和归属的会话。读的文件就不必传
附件搞定了，下一节解锁输入框的隐藏效率：斜杠命令和引用。