工具调用理由

工具调用理由让你在工具消息旁看到一句简短目的：不只知道助手读了哪个文件，也知道它这次想确认什么。例如，读取 src/export/csv.ts 时显示“确认当前导出字段”。路径仅为教学示例。

先说清任务，再看调用目的

先安装插件 @jetcrab/pi-desk-tool-reason，按提示加载。它没有独立页面或设置表单，生效后直接用于聊天工具调用。已有会话要在空闲时打开“更多 → 重载 Pi 配置”，让会话读取更新的扩展；仅加载界面变更不等于更新已有会话的工具。

向助手说清目标和限制，例如：“核对当前 CSV 导出字段，运行现有导出测试，先不要改代码。”目的应说明这一步希望确认什么，而不是重复路径或命令。

在消息里核对动作与结果

• 先看目的：工具名旁显示简短说明，下方保留路径或命令，便于把动作与任务对应起来。
• 再展开结果：点击工具卡片或右侧折叠箭头。read 展示完整路径和读取内容，摘要上的范围对应读取参数；bash 的命令和输出则用于核对实际检查。文件预览按钮是另一个入口。
• 最后核对结论：目的不替代输出，工具失败或结果不符合预期时，应回到具体结果继续判断。

所有演示文件、调用和输出都是教学示意，未实际执行。

它不代表什么

这是一句调用目的，不是完整思考过程，也不是权限确认、安全审核或执行结果保证。插件不会拦截它认为不合理的命令；仍需核对路径、命令和输出。

当前适用于 read、write、edit、bash、grep、find、ls。助手附上的理由在执行前会剥离，原工具仍接收原有参数。理由并非必填，不保证每次都有；第三方工具或自定义消息展示也不保证呈现同样的形式。