第 13 章

高级特性与并发控制

思考深度、Worktree 并发、上下文管理与自动化工作流

当 CLI 能自主思考、并行执行、自动纠错，AI 才真正成为工程伙伴

从基础到高级

你已经掌握了 CLI 的基本用法，但还需要更精细的控制和工程化能力

需要只读分析又要控制成本

让 AI 分析项目但担心它改坏文件；希望它想深一点但又不想每次都花太多 token。

多任务无法并行

TUI 只能一次处理一个会话。同时处理 5 个 PR？没有并行会话机制。

长对话越来越慢

聊了半小时，token 爆炸，响应变慢。需要压缩但又怕丢上下文。

本章解决「高级控制」四类问题：① Plan 模式让 AI 只读不写；② effort 平衡深度与成本；③ Worktree 支持并发会话；④ /compact /resume 管理上下文生命周期。

Plan 模式

先想清楚再动手——只读分析的安全模式

Plan 模式让 AI 偏向"规划"而非"执行"：它可以读取、分析项目，但写入需要批准（除非计划文件或显式规则允许）。

qodercli --permission-mode plan

> 分析这个模块的架构，给出重构建议
（AI 读取代码、分析、产出建议，但不改任何文件）

什么时候用 Plan

代码审查、架构评估
排查问题但不急着改
让 AI 先出方案你 review
CI 里的只读分析任务

Plan vs accept_edits

Plan：偏分析，写入受控。
accept_edits：偏执行，写入顺畅。

评审用 Plan，干活用 accept_edits。

思考深度

/effort 调整 AI"想多久"——平衡质量与成本

不同任务需要的思考深度不同。用 /effort 命令（或 --effort 参数）调整：

档位	适用场景	成本
低	简单任务、快速响应、批量处理	省 Credits
中	日常开发、常规重构	平衡
高	复杂设计、疑难 bug、架构决策	消耗大

选档原则：简单任务用低档（省 60%+ Credits），复杂任务才用高档。把贵的思考留给真正需要的问题——这是用 AI 的经济学。

Worktree 并行

用 Git Worktree 让多个 AI 会话互不干扰

想同时让 AI 处理多个任务（改 feature A、修 bug B、重构 C），但它们改的是同一个仓库——会互相覆盖。Git Worktree 解决这个问题。

Worktree 让同一仓库的多个分支同时检出到不同目录，每个目录独立工作。Qoder CLI 支持在独立 worktree 中工作：

# 主仓库目录
/projects/my-app (main 分支) → 跑测试、看主分支

# worktree 1
/projects/my-app-feat-a (feature-a 分支) → AI 改 feature A

# worktree 2
/projects/my-app-fix-b (fix-b 分支) → AI 修 bug B

每个 worktree 启动一个 qodercli 实例，它们改各自的分支，互不干扰。这让你能真正并行地让 AI 干多件事——像有了多个 AI 同事。

上下文管理

/compact 压缩、/resume 恢复——长任务的续航

/compact — 压缩历史

对话太长快爆上下文时，用 /compact 把历史总结压缩，保留要点、丢弃冗余。

压缩后 AI 仍记得关键决策，但 token 消耗大降。长任务中途必用。

/resume — 恢复会话

昨天没干完的任务，今天用 /resume（或启动时 -c）继续上次的上下文。

支持选择特定历史会话恢复。跨天工作流的关键。

--max-turns — 限制轮数

给单次会话设最大对话轮数，防止 AI 无限循环消耗 Credits：

qodercli --max-turns=15

/clear — 彻底重来

切换到完全不同的任务，/clear 清空所有历史，避免旧上下文污染。

排错指南

高级特性相关的高频问题

Plan 模式仍然修改了文件

原因：plan 模式并非绝对只读，部分工具可能绕过。修复：配合 --permission-mode plan 使用，检查是否有 allow 规则覆盖。

Worktree 会话混杂

原因：多个实例搞混了分支。修复：每个 worktree 严格对应一个分支；用 -w 明确指定工作目录。

/compact 后 AI "失忆"

原因：压缩时丢失了关键上下文。修复：把稳定规则写入 AGENTS.md（不受 /compact 影响）；压缩后用 /status 验证。

effort 设置不生效

原因：模型不支持或参数拼写错误。修复：确认模型是否支持 effort；检查参数名拼写。

动手练习

掌握高级特性的实战手法

练习 1：体验 Plan 模式

用 --permission-mode plan 启动
让 AI 分析项目，观察它无法修改文件

练习 2：Worktree 并行

用 qodercli -w 在不同分支启动两个会话
让它们分别处理不同任务，验证互不干扰

练习 3：上下文管理

开启一个长对话，用 /compact 压缩
用 /resume 恢复，验证关键上下文未丢失

本章回顾

带走的三条核心认知

控制手段丰富

Plan 模式、effort、Worktree、compact/resume 覆盖只读、成本、并发、长对话四大场景。

并发即效率

Worktree 让多个 AI 会话互不干扰地并行，成倍提升吞吐。

上下文是黄金

用 /compact 压缩、/resume 恢复、AGENTS.md 保底，三者组合管好长对话。

核心结论：高级控制让 AI 从"需要时刻盯着"变成"可以放心托付"。掌握 Plan、effort、Worktree、上下文管理，你就有了指挥 AI 的精细摇杆。

下一章，学习 Print 模式与 CI/CD 工程化 —— 让 CLI 走出终端，接入流水线。