《多轮对话管理 - QueryEngine 会话编排与持久化》 文档中对于多种交互模式以及会话处理未明确区分，会话管理描述不够全面

[zhansan379]

文档中对于多种交互模式以及会话处理未明确区分。参考源码src\screens\REPL.tsx

添加如下内容相关描述以及多种交互模式区分：
onQueryImpl 是 REPL（Read-Eval-Print Loop）中与 AI 模型交互的核心控制器，它负责：

环境准备（IDE、诊断、权限）

会话标题的首次生成

构建动态系统提示和用户上下文

执行流式查询并实时更新 UI

收集性能指标和最终清理

该方法通过精细的状态管理、并行优化和特性开关，支撑了一个健壮、可扩展的 AI 编程助手主循环。

Summary by CodeRabbit

• Documentation
  • Expanded documentation on multi-turn conversation management, covering session orchestration, conversation flow architecture, persistence mechanisms, cost tracking, budget controls, and model switching capabilities.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 2cd24018-d86d-42b9-9f53-f0940ff95660

📥 Commits

Reviewing files that changed from the base of the PR and between a972ed7 and 664416d.

📒 Files selected for processing (1)

• docs/conversation/multi-turn.mdx

---

📝 Walkthrough

Walkthrough

This PR expands documentation for multi-turn conversation management in Claude Code, explaining the complete architecture from REPL/SDK entry points through QueryEngine orchestration, onQueryImpl execution flow, submitMessage() generator pattern, JSONL transcript persistence, cost tracking, and model hot-switching mechanics.

Changes

Multi-turn Conversation Architecture Documentation

Layer / File(s)

Summary

Conversation Architecture and Implementation Deep-Dive docs/conversation/multi-turn.mdx

Comprehensive documentation expansion covering REPL/SDK/ACP interaction patterns, onQueryImpl signature and complete execution flow (shouldQuery branches, context/prompt construction, streaming, cleanup callbacks), QueryEngine state management across turns, submitMessage() async generator turn progression, JSONL transcript persistence with recovery, cost tracking with budget enforcement, model hot-switching, file snapshot rewind, and minor clarification of submitMessage() SDK-only caller attribution.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• claude-code-best/claude-code#39: Overlapping documentation of the same conversation orchestration code paths (QueryEngine, query.ts loop, submitMessage) described in the learn-phase-2-conversation-loop documentation.

Poem

📚 A rabbit hops through docs so fine,
Detailing turns in neat design—
From SDK calls to transcript store,
The conversation flow laid bare once more! 🐰✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly describes the main change: adding comprehensive documentation about multi-turn conversation management, distinguishing between interaction modes, and explaining QueryEngine orchestration and persistence. It directly summarizes the documentation expansion in the PR.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}