工具
文件与 Finder
打开、定位、操作文件 —— 限定在你授权的路径内。
ToShop 的文件工具像 Finder 那样工作:用默认应用打开文件、在 Finder 中显示、或把文件递给 Agent 作输入。直接编辑要走授权,并在落盘前展示 Diff。
内置工具
open_path—— 用系统默认应用打开文件或文件夹。reveal_in_finder—— 在 Finder 中显示。file_read—— 把文件内容读进任务。file_write—— 把输出写到已授权的路径。
作用域如何工作
Agent 没有全盘文件权限。它只能在以下范围内动手:
Prompt 里提到的路径
"总结 ~/Documents/notes.md" 隐式授权读该文件。
持久授权
一旦你批准了"~/Documents/ 下所有读取",该树下的后续读取自动放行。在 设置 → 权限 里管理。
技能声明的作用域
需要特定位置(例如某个 Obsidian Vault)的技能在安装时申请。
以上之外的路径,落盘前一定弹窗。
写入前显示 Diff
修改已有文件时,Agent 会在聊天里先展示 Diff,你批或拒后再应用。新建文件则先看全部内容。
常见模式
| 目标 | Agent 怎么做 |
|---|---|
| "总结这个 PDF" | open_path 读取 → 抽文 → 聊天里给摘要 |
"在 notes.md 里加一段" | 读 → 提交 Diff → 通过后写入 |
| "我那张截图存哪了?" | 列出 ~/Pictures/ 和 ~/Desktop/ 的近期文件 |
ToShop文档