# 附件与按需读取

> Cube Agent 2.2.0 正式版（构建 2002007）使用说明。
> 分类：聊天。内容基准：2026-11-07。
> 网页：https://cubeagent.app/docs/attachments/

## 照常上传，告诉 AI 你想做什么

点击输入框旁的 **加号** 添加图片或文档，再像平常一样提问。也可以从中转站、相册或网页拖入文本和图片：图片成为附件，文本填入输入框。

## 上传附件会怎样处理？

输入框上传的可解析文档默认解析，正文随消息发送；视觉模型直接接收图片，非视觉模型沿用已配置的辅助识图或端侧 OCR。文件工具是否开启，不改变这些行为。解析中、失败或加密的文档会显示状态；完成解析后再发送，不能完整解析时请先处理错误。

## 拍照是否保存到系统图库？

进入 **设置 → 通用偏好 → 输入与交互 → 拍照**，调整 **拍照时保存到系统图库**，默认关闭。关闭时，聊天拍摄的照片只作为应用内附件保留，拍摄临时文件在处理结束后清理；开启后交由系统相机流程保存到图库。开关只影响之后在聊天中拍摄的照片，不清理已有图库照片，也不改变从相册选择图片的行为。

## 发送前裁切图片

图片添加到输入栏后，长按缩略图选 **裁切**，或点开全屏预览在底栏点 **裁切**。可以拖动四角和边框自由裁切，选择常用比例，或旋转 90°；完成后替换待发送的图片。原图会保留，再次裁切时可以 **还原**；直接返回则放弃本次修改。拍照和选图流程不变，裁切只是可选步骤，也不影响「拍照时保存到系统图库」。

## 文件格式、ZIP 与旧版 PPT

文件入口支持添加各类原文件，能添加不等于模型能理解该格式。旧版 **.ppt** 与 **.pptx** 演示文稿均支持正文解析，可用于总结和问答；解析正文不等于完整还原幻灯片版式或动画。PDF、Office、EPUB 等仍受解析器、文件大小及模型上下文限制。

ZIP 保留原包，并尝试展开可解析的子附件；解压失败仍可保存原包。未知或不能提取正文的二进制格式按原文件保存，不会把二进制当文字或整份 Base64 发给模型。已发送文件可在当前会话工作目录的输入文件区域只读浏览，按格式预览或导出；上传不会自动启用文件工具。

## 工作目录中的文件如何读取？

**图片来源与准备进度**：点击附件 **照片** 默认打开本机相册。支持跨设备导入的设备可 **长按照片（鼠标右键）→ 从其他设备导入**，使用系统提供的远端相册、拍照或扫描来源；可用设备与业务由系统决定。DeepSeek 官方接口发送图片时会显示准备进度，可展开查看上传与复用情况；是否能理解图片仍取决于所选模型。生成文件中的图片仅显示文件名与大小，点击文件行后打开预览；回复正文中的工作区图片仍可内联显示。

在聊天的 **工具** 面板明确开启需要的能力：**文件操作** 负责列举工作目录、读取文档和修改文件；**读取图片** 负责查看已知路径的图片；**列出资源** 负责发现已挂载知识库中的资料和历史图片记录，不列举工作目录或原始会话附件。知道路径或资源 ID 时可以直接读取，无需先列举。工作目录中的文档在实际读取时解析，图片在实际调用时识别。工具不会因上传附件而自动开启；在本对话启用挂载文件夹时，会自动开启文件操作并提示。

已有文件夹授权还需要在工具栏的 **挂载文件夹** 中启用；未启用的目录不会随对话提供给模型。也可从 **＋ → 文件夹** 调整，目录授权只在当前设备有效。

工具读取仍会消耗上下文和调用次数，具体用量取决于任务和文件。普通附件的解析、识图与历史处理保持原来的用法，没有额外的附件加载方式开关。

可以调整的是 **识别与解析方式**：

- **图片**：进入 **设置 → 模型与用量 → 默认模型 → OCR 识图**，配置辅助识图模型及「优先使用大模型识别」偏好。模型需要辅助识图时，可根据你的问题指定观察内容；这不是附件加载方式开关。
- **PDF**：点开附件正文预览，选择 **更换解析方式 / 文档 OCR**。核对新正文并采用后，后续读取会使用更新的内容；已发送的 PDF 也可以这样处理，正在回复时需等本次回复结束。
- **文档解析服务**：在 **设置 → 模型与用量 → 默认模型 → 文档解析** 管理。选择服务不会立即上传文件，开始解析时再核对上传范围。

## 会影响原来的用法吗？

- **普通聊天**：照常输入和发送，无需额外操作。
- **图片**：支持视觉的模型直接随消息看到图片，追问时可按需重看或查看局部。不支持视觉的模型可使用已配置的辅助识图模型或端侧 OCR，识别效果取决于所用方式。
- **文档**：上传后默认解析并随消息发送；工作目录中的文档只有调用已启用的工具时才解析。文件过大、损坏或无法完整解析时会提示原因，不会把不完整正文当作全文发送。
- **无痕／临时会话**：文档与图片沿用直接准备内容的方式，已有 OCR 和解析配置继续生效。
- **视频**：已撤回相册视频专用入口与按时间点抽帧。通过文件入口添加的视频仅保存为原文件，不提供画面或声音理解；需要理解内容时请提供截图或文字说明。旧版专用视频附件会在加载或导入时过滤。

## 一次读取很多图片会怎样？

图片输入受模型视觉能力、上下文容量、图片数量与请求大小限制，历史图片还受历史范围和图片预算约束。不要把原文件仍在聊天记录中理解为每轮都会重新发送全部图片。需要核对具体细节时，可重新附上对应图片，或在启用读取图片工具后明确指定目标。

读取图片和辅助识图仍会消耗模型调用与上下文；具体费用和限制以所选服务商为准。

## 预览原文件

- **发送前**：点击待发送的文件附件查看正文面板，再点 **预览原文件** 打开原件。尚未解析时，没有正文不代表附件不能发送。
- **聊天记录中**：PDF 先打开正文预览，可更换解析方式或点 **预览原文件**；其他文件按支持的方式打开原件。多选消息时，点击用于选择消息。
- Markdown、纯文本和支持的代码文件在应用内预览；PDF、Office 等使用系统预览或「打开方式」，可用性取决于设备和已安装应用。

打开原文件供你查看，不代表模型已读取，也不会自动发送。若提示原件不存在或无法访问，请重新添加；只剩解析正文的旧记录无法还原原件。