Direct / Agent 模式

执行变更时可选择两种模式。它们的区别在于**「谁来决定具体的 CLI 命令」**。

Direct（确定性编辑）

• 谁决定命令：Gateway 直接套用 provider 的 CLI 命令模板。
• 适合：目标明确、可直接落到某个 block / record / field 的编辑。
• 例子：把选中的这段文字替换为「……」；把这个单元格的值改成 42。
• 特点：确定性强、可预期、无需本地 Agent 进程。

选区 + 明确目标文本  →  CLI 模板  →  dws doc block update ...

Agent（自然语言）

• 谁决定命令：本地 qodercli 先理解你的自然语言意图，再决定调用哪些 CLI 命令。
• 适合：需要推理、拆解或多步操作的任务。
• 例子：把这张表按季度汇总；把这段话改写得更正式并保留要点。
• 特点：表达自由，代价是依赖本地 Agent 进程（可选组件）。

选区 + 自然语言指令  →  qodercli 推理  →  一个或多个 CLI 调用

如何选择

你的输入	建议模式
明确的目标文本 / 目标值	Direct
「改写 / 汇总 / 归类 / 按…处理」等需要理解的描述	Agent

若在 Direct 模式输入了明显需要推理的自然语言，UI 会提示切换到 Agent 模式。

前置条件

• Direct：只需对应官方 CLI 已安装并登录。
• Agent：额外需要本地 qodercli 可用（Gateway 的 Process Manager 负责拉起）。

两种模式的执行结果都会在「执行结果」区流式回显。