让 AI 读取文件
默认 AI 不能读取文件正文。需要分析代码、日志或配置时,先把文件放进 ~/.kaya/ 可信目录,再告诉 AI 路径。
步骤#
mkdir -p ~/.kaya/my-project
cp ~/my-project/main.ts ~/.kaya/my-project/然后在对话里说:
读取 ~/.kaya/my-project/main.ts 并解释它做了什么AI 会用允许的读取命令展示内容。用完后删除不再需要的副本:
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/之外的符号链接不会被识别为可信。