Qwen Code 架构概览

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

核心组件

Qwen Code 主要由两个核心包组成，并配套一系列工具；这些工具可在系统处理命令行输入的过程中被调用。

用途： 该包包含 Qwen Code 面向用户的部分，例如处理初始用户输入、呈现最终输出以及管理整体用户体验。

核心功能：

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

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

核心功能：

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

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

常用工具包括：

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

用户输入：用户在终端中输入提示词或命令，该终端由 packages/cli 管理。
向核心模块发起请求：packages/cli 将用户输入发送至 packages/core。
请求处理：核心模块执行以下操作：
- 根据所配置的模型 API 构造合适的提示词（prompt），其中可能包含对话历史及可用工具定义。
- 将该提示词发送至模型 API。
模型 API 响应：模型 API 处理提示词并返回响应。该响应可能是直接答案，也可能是调用某个可用工具的请求。
工具执行（如适用）：
- 当模型 API 请求调用某工具时，核心模块准备执行该工具。
- 若所请求的工具涉及文件系统修改或执行 Shell 命令，则核心模块会首先向用户提供该工具及其参数的详细信息，并需用户明确批准后方可执行。
- 对于只读操作（例如读取文件），可能无需用户显式确认即可继续执行。
- 用户确认后（或无需确认时），核心模块将在对应工具内执行相应操作，并将结果返回给模型 API。
- 模型 API 处理工具返回的结果，并生成最终响应。
向 CLI 返回响应：核心模块将最终响应发送回 CLI 模块。
向用户展示：CLI 模块对响应进行格式化，并在终端中显示给用户。

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