拾取选区并编辑
这是产品的主链路：拾取 → 确认选区 → 输入指令 → 执行 → 查看结果。
1. 进入拾取态
在侧边栏「当前选区」卡片点击 「拾取选区」，页面进入拾取态：
- hover 高亮候选目标；
- 点击 确认选择；
- ESC 取消拾取。
2. 拾取什么
| 类型 | 示例 | 结果 |
|---|---|---|
| 文字段落 | 钉钉文档里的一段文字 | surface: text，带 blockId |
| 多维表单元格 / 记录 | AI 表格的某个单元格 | surface: table，带 recordId / fieldId |
拾取成功后，选区卡片展示：provider、surface、定位方式（精确 / 内容）、文档与块/记录/字段信息、以及内容摘要。
内容定位提示：当无法拿到稳定 id 时会回退到「按内容定位」，卡片会提示「可能不精确」。尽量选择结构清晰的目标以获得精确定位。
3. 输入指令并选择模式
在指令框输入要做的修改，并选择模式：
- Direct（确定性编辑）：输入明确的目标文本，直接套 CLI 模板执行。
- Agent（自然语言）：用自然语言描述，交给本地
qodercli推理后调用 CLI。
两者区别详见 Direct / Agent 模式。
4. 执行与查看结果
点击 「执行变更」：
- 执行阶段以标签展示：
running→applied/failed； - CLI 的真实输出在「执行结果」里流式回显；
- 成功后结果会回流到文档并高亮对应位置。
边界与失败
- NL + Direct 的边界：在 Direct 模式输入了明显需要推理的自然语言时，UI 会提示改用 Agent 模式。
- CLI 未登录：执行会失败并引导你去 Setup 向导 登录。
- CLI 失败：官方 CLI 的错误信息会原样透传到结果区，便于定位。
- 中止执行：执行中可中止当前任务。
常见错误处理见 常见问题。