跳到主要内容
本页内容

让 AI 读取文件

默认 AI 不能读取文件正文。需要分析代码、日志或配置时,先把文件放进 ~/.kaya/ 可信目录,再告诉 AI 路径。

步骤#

bash
mkdir -p ~/.kaya/my-project
cp ~/my-project/main.ts ~/.kaya/my-project/

然后在对话里说:

text
读取 ~/.kaya/my-project/main.ts 并解释它做了什么

AI 会用允许的读取命令展示内容。用完后删除不再需要的副本:

bash
rm -rf ~/.kaya/my-project

允许的读取命令#

在 ~/.kaya/ 下可以使用:

  • cat / bat:读取文件内容。

  • head / tail:读取开头或结尾。

  • grep / egrep / fgrep / rg / ag / ack / sed -n:搜索内容。

  • sort / uniq / tr / cut / nl:文本整理。

  • strings / xxd / hexdump / od / base64 / base32:查看二进制或编码内容。

  • Windows 另支持 PowerShell 的 Select-String(sls)与 findstr,路径同样必须在可信目录内。

wc 等只返回统计数字、不返回正文的元数据命令不限于 ~/.kaya/。

**IM 的文件读取有额外边界:**即使文件在 ~/.kaya/ 中,也不能通过 IM 的命令读取记忆、审计、会话、网关隐私明细、凭据配置等敏感内部存储;记忆内容只能经记忆工具脱敏后返回。云端上传状态及其临时文件不可读,用量事件文件仍可按原边界读取。这是 IM 渠道回合的专门限制,不能把它套到浏览器远程或跨机对话:浏览器远程复用桌面上下文,跨机对话本就不开放 shell 读取工具。

修改、写入与下载#

即使可信目录内,也仍然禁止:

  • 修改或移动已有文件(如 sed -i、mv)。

  • 删除文件。

  • 执行文件内容。

唯一写入例外:可以把命令输出重定向到 ~/.kaya/ 下的文件,例如 echo hello > ~/.kaya/note.txt,但目标必须带安全扩展名;无扩展名或 .sh / .exe 等危险后缀会被拦截。除此之外,AI 只能读、不能改已有文件。

AI 也能用 curl -o 等方式下载文件到可信目录,.sh、.exe、.dmg 等危险类型会被拦截。应用自身的内部配置、凭据、网关与上传状态等控制目录不能用作下载或输出重定向目标;需要临时分析文件时,请使用自己创建的普通子目录。

提醒#

  • 不要因为有脱敏就主动把密钥放进可信目录。

  • 用完及时删除副本。

  • 指向 ~/.kaya/ 之外的符号链接不会被识别为可信。

下一步#