# 附件、工作目录与产物

知道资料从哪里读取、结果保存在哪里，以及远程时哪些文件可用。

更新于: 2026-11-02
Desktop rc.75 Mac ARM and Windows 10 runtime acceptance; installer lifecycle and Windows 11 unverified · Web Desktop execution scope; no new headless attachment worker deployed
Canonical: https://ai.z-group.cn/docs/zh/files/

## 三种位置不要混淆
附件属于当前会话的输入；工作目录是工具执行和读取文件的上下文；项目资产目录用于归档项目资料。三者可能位于不同路径。
## 添加和使用资料
1. 给原件保留清晰文件名与版本，例如“材料清单_演示_v1.csv”。
2. 在输入区添加附件，或启用相应本地文件夹数据源。
3. 要求 AI 先确认读取的文件列表；解析失败的文件单独列出。
4. 写明输出目录及新文件名，避免把原件当作输出文件覆盖。
5. 任务完成后从结果链接打开文件，检查是否包含完整内容。
## 可以读取就一定理解吗？
不一定。扫描图纸、图片文字、复杂表格的解析需要检查；图像理解还取决于所选模型能力。涉及规格、单位、尺寸和材料编码时，逐项对照原件。图片或 PDF 解析失败时，补充清晰页图或可选择文字的版本。
## 远程文件怎么处理？
电脑上的路径只在相应电脑上有效。网页/手机看到文件名或历史中的链接，不代表拿到了原件；附件和完整工具输出可能需要回到执行电脑查看。详见[多端与远程操作](../remote-access/)。
## 验收清单
检查文件真实存在、能打开、命名正确、版本明确；对表格核对单位和行数，对报告核对来源，对图片核对清晰度。聊天中的“已完成”不能替代打开成品。

## 内置文档工具报错（未发布维修预览）

维修预览保留原始报错和退出状态，并附带工具报告的解释器类别、Python 版本、允许的依赖版本及失败阶段。参数校验错误与 Python 异常分开记录；元数据不含脚本正文、文件路径或凭据，也不改变权限和执行结果。外部或用户自定义 Python 不会被自动安装或修复；实际运行时无法确认时保留未知。历史异常仍需原始证据，不能仅凭错误类别认定已修复。

<a id="附件本地预处理-rc-75-候选"></a>

## 附件本地预处理（rc.75 beta）

本轮发布 Mac Apple Silicon 与 Windows x64 桌面包；网页和手机上的文件仍由所连接的执行电脑处理。Windows 11、最终安装器覆盖升级/卸载及真实材料长期试用尚未验证，不承诺固定节省比例。

完整原件保存在当前执行端的会话附件目录。大文本的预览可以截断，但保存的原件保持完整；需要缩放的图片另外生成分析副本，点击附件打开原件。

Word、Excel、PPT 和 PDF 复用离线解析能力并建立分段索引。PDF 优先提取文字层，扫描页使用本地中英文 OCR。Excel 分析文本保留单元格坐标、公式及文件中已有的计算值，不执行宏或重新计算公式。附件卡片显示已建立索引、部分提取、解析失败或需本地工具读取；发送前会显示保存、等待解析和处理进度；扫描 PDF 会显示页码。长时间解析可以取消，原件不会删除。失败或取消后，可从已保存原件重试、发送已保存原件，或返回编辑；待发送文字与附件保留在草稿中。没有保存成功的附件会单独提示。

对话可按需检索和读取分段，并保留读取范围记录。 小文件（最多4段）可一次直接读取，无需先查概览；大文件按需选段，整份分析仍须读完全部分段。Excel 已提取的单元格、原公式与缓存值可直接作为文字依据；缺失、歧义、版式和图表再核对原件。检索片段不算完整读取；记录表示工具返回了对应文字，不保证模型理解，也不表示检查了图像、版式或所有公式。要求整份分析时，应覆盖所有分段并说明缺失部分；规格、颜色、纹理、图纸和复杂表格仍需核对原件。旧附件继续通过原路径读取。

原件和解析在执行端保存；使用在线模型时，选取的文本、视觉内容和工具结果仍会发送给模型。不同模型后端的原生 PDF/图片通道保留兼容行为，文件引用并不保证后续历史不再传输。