# File 就是文件——而这已经很有力量

File 不是一次性的附件。它代表 Canvas 上的规范 filesystem 来源，让人清楚工作应该读取、评审、修改或作为
输入使用哪些材料。

[![Kavor Canvas 上显示的 PDF File Node 及使用它的 CodingAgent](https://agentkavor.com/kavor-pdf-canvas-agent-demo-poster.jpg)](https://agentkavor.com/zh/videos/pdf-canvas-agent)

*File 让材料保持可见，同时你在它周围组织 agents、决定和执行。*

## File 能做什么

File 自身允许你查看并使用 Workspace 来源。根据格式，Kavor 提供文本编辑、搜索、阅读偏好和丰富预览。

文本格式包括 Plain Text、Markdown、JSON、SQL、TypeScript、JavaScript、YAML、Shell、HTML 和 CSS。图片和 PDF
可以在 Canvas 上查看；SVG 可以在预览和 source 之间切换。

File 仍然指向真实来源。如果文件在 Kavor 外部发生变化，Node 会反映该变化，并在本地编辑需要协调时发出
提示。这样可以避免把上下文副本误认为最终要版本控制的工件。

## File 作为明确范围

连接 CodingAgent 后，File 会把一般意图变成具体工作来源。它可以限定一个模块，提供输入契约，保留图片或
PDF 供分析，或指出需要评审的配置。

可以这样开始：

> 将连接的 File 作为这项任务的规范来源。说明需要改变什么，保持范围，并在我确认计划后再编辑。

如果 agent 只需要查看材料，可以在直接 Connection 上使用 file_read_only Guardrail。agent 仍可到达 File，但不能
通过 Kavor 的中介操作修改其来源。

## File 作为 Terminal 输入

File + Terminal Connection 会通过你选择的环境变量名，把文件的规范绝对路径导出到 session。变量值是路径，
不是内容副本。

路径会在 Terminal session 启动时应用。如果 shell 已经打开时修改 Connection 或参数，界面会提示你重启
session 才能获得新值。

这对脚本、SQL、配置和报告很有用：File 让来源在 Canvas 上保持明确，Terminal 可以执行命令，而不必在窗口
之间复制路径。

## 三种使用方式

### 评审已有来源

将 File 连接到 CodingAgent，并要求它按风险进行阅读。进行视觉评审时，可让 File、用于记录 findings 的
Sticky Note 和用于检查的 Terminal 位于同一图中。

### 在明确范围内实现

连接 Specification、File 和 Builder。Specification 说明结果，File 标出具体来源，CodingAgent 进行修改并在
合适的位置记录证据。

### 将工件变成可执行输入

将 SQL 或脚本 File 连接到 Terminal，为变量命名，并从 shell 执行命令。如果也连接了 agent，它可以帮助解释
输出，而你仍能跟随过程。

## 重要限制

- Connection 不会把 File 变成通用 filesystem 访问；Node 仍只代表配置好的规范来源；
- 并非所有二进制格式都能作为文本编辑；
- 导出到 Terminal 的路径不包含文件正文；
- File 专属 Guardrail 需要与 CodingAgent 的直接 Connection；
- 外部或并发变更必须在替换本地编辑前完成协调；
- 在 Canvas 上靠近 File 不会授予内容访问权。

## 继续阅读

- 查看 [Connections 矩阵](./connections.md)，包括 File + Terminal 和 CodingAgent + File。
- 了解 [CodingAgents 如何查看图](./coding-agents-and-canvas.md)。
- 将 File 与 [Sticky Note](./sticky-note.md) 组合，分开规范来源和工作记忆。
- 使用 [第一个 loop](./first-loop.md) 串联意图、实现、证据和评审。