跳至文档内容

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

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

Kavor Canvas 上显示的 PDF File Node 及使用它的 CodingAgent (在新标签页中打开)

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 不会授予内容访问权。

继续阅读

最后审核 2026年9月8日验证版本 Kavor 1.6.2分享文档反馈