文档 · 07

审批与权限

为什么需要审批

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

patch proposal

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

• 每个文件的差异（新增/删除行数、具体改动）。
• 你可以在审批卡片中逐个文件查看、展开详情。
• 待审批时可以选择应用或放弃；应用后仍能从原审批卡片查看差异。
• 如果文件仍保持为本次应用后的内容，可以执行冲突安全撤销；文件后来又被修改时，InkCraft 会拒绝覆盖新内容。

审批模式

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

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

命令执行

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

可追溯

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