Agent 权限确认 — 分级管控 AI 操作风险
为什么需要权限管控
Agent 能调用内置工具读写文件、修改配置、调用外部 MCP——这些操作不是"只看不改"。如果 AI 不小心改错了笔记或删了文件，影响会很大。
NoteGen 的解决方案是分级风险 + 按需确认。
风险等级
| 风险等级 | 典型操作 | 确认策略 |
|---|---|---|
| 只读 | 读取笔记内容、查询标签、搜索知识库 | 自动执行，不弹确认 |
| 低风险写入 | 创建新文件、添加新标签 | 可能自动执行或弹一次确认 |
| 高风险写入 | 覆盖已有文件、删除文件/标签、批量重命名 | 必须弹确认，逐项审阅 |
| 外部工具 | 调用 MCP、联网搜索、写图床 | 按工具权限策略确认 |
Diff 审阅
当 Agent 要修改（而不是创建新）Markdown 文件时，NoteGen 会先显示 Diff：
- 左侧是原文，右侧是 Agent 的修改建议
- 增删改用不同颜色标注
- 可以逐行/逐段接受或拒绝
- 也可以全部接受或全部拒绝
这和写作页的 AI 润色 Diff 是同一个机制——AI 改的内容不会直接覆盖原文，必须你确认。
多文件任务可以在变更面板逐项审阅——Agent 可能同时改 5 个文件，你可以一个一个看，哪个有问题就只改哪个。
三种确认选项
Agent 需要确认时弹出面板，给你三个选择：
| 选项 | 含义 |
|---|---|
| 允许一次 | 这次执行，下次遇到同类操作继续确认 |
| 当前会话允许 | 本次会话内不再确认同类操作 |
| 拒绝 | 中断当前步骤，Agent 会停在原地等你新指令 |
拒绝后的处理
如果拒绝了某个操作：
- Agent 会暂停，显示"用户拒绝执行"
- 你可以在面板中解释为什么拒绝（"不要覆盖旧版本"）
- Agent 会根据你的反馈调整计划，继续执行其他步骤
- 或者重新发起一个你允许范围更小的请求
建议
- 对重要文件夹（如已发布的笔记），在 Agent 操作前先备份
- 不要开"当前会话允许"后就不管了——Agent 可能执行连锁操作
- 看 Diff 时重点关注：是否改了你的核心观点、是否删除了整段内容、是否把图片位置改乱了
- 出现可疑操作时直接"拒绝"，不要勉强