文档 · 05

审批与权限

为什么需要审批

你的正文是生产资料。InkCraft 的原则是：落笔前先给你看，你点头才写入。

patch proposal

当 Agent 需要修改项目文件时，会先生成修改建议：

• 每个文件的差异（新增/删除行数、具体改动）。
• 你可以在审批卡片中逐个文件查看、展开详情。
• 操作：应用（写入磁盘）、撤销（放弃本次修改）。

审批模式

权限模式控制 Agent 的自主程度：

• 请求批准：每次写入都需要你确认（默认，推荐）。
• 更宽松的模式可减少确认次数，但关键操作（删除、覆盖正文）仍会留痕可撤销。

命令执行

Agent 可以运行受控命令（如搜索、脚本），命令执行经过沙箱与权限边界，高风险命令需要审批。

可追溯

所有审批、应用、撤销都会记录在本地 trace 中：谁提议、谁批准、何时落盘，随时可查。