Qwen Code 架构概览

本文档提供了 Qwen Code 架构的高层概览。

核心组件

Qwen Code 主要由两个核心包组成，并附带一套工具集，系统在处理命令行输入时会调用这些工具：

用途： 包含 Qwen Code 面向用户的部分，负责处理初始用户输入、展示最终输出以及管理整体用户体验。

核心功能：

输入处理： 通过多种方式处理用户输入，包括直接文本输入、斜杠命令（如 /help、/clear、/model）、at 命令（@file 用于引入文件内容）以及感叹号命令（!command 用于执行 Shell 命令）。
历史记录管理： 维护对话历史，并支持会话恢复等功能。
显示渲染： 在终端中格式化并展示响应，支持语法高亮和正确的排版。
主题与 UI 自定义： 支持自定义主题和 UI 元素，提供个性化体验。
配置管理： 通过 JSON 配置文件、环境变量和命令行参数管理各项配置选项。

用途： 作为 Qwen Code 的后端。它接收来自 packages/cli 的请求，协调与已配置模型 API 的交互，并管理可用工具的执行。

核心功能：

用途： 这些是独立的模块，用于扩展 Qwen 模型的能力，使其能够与本地环境交互（例如文件系统、Shell 命令、网页抓取）。

交互方式： packages/core 根据 Qwen 模型的请求调用这些工具。

常用工具包括：

与 Qwen Code 的典型交互遵循以下流程：

用户输入： 用户在终端中输入提示词或命令，该过程由 packages/cli 管理。
请求转发至 Core： packages/cli 将用户输入发送至 packages/core。
请求处理： Core 包执行以下操作：
- 为已配置的模型 API 构建合适的提示词，可能包含对话历史和可用工具定义。
- 将提示词发送至模型 API。
模型 API 响应： 模型 API 处理提示词并返回响应。该响应可能是直接回答，也可能是请求使用某个可用工具。
工具执行（如适用）：
- 当模型 API 请求使用工具时，Core 包准备执行该工具。
- 如果请求的工具会修改文件系统或执行 Shell 命令，系统会先向用户展示工具详情及其参数，用户必须批准后方可执行。
- 只读操作（如读取文件）可能无需用户显式确认即可继续。
- 确认后（或无需确认时），Core 包在对应工具中执行相关操作，并将结果返回给模型 API。
- 模型 API 处理工具执行结果并生成最终响应。
响应返回至 CLI： Core 包将最终响应发送回 CLI 包。
向用户展示： CLI 包格式化响应并在终端中展示给用户。

Qwen Code 提供多种配置其行为的方式：