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 构建合适的提示，可能包括对话历史和可用工具定义。
- 将提示发送给模型 API。
模型 API 响应： 模型 API 处理提示并返回响应。此响应可能是直接答案，也可能是使用某个可用工具的请求。
工具执行（如适用）：
- 当模型 API 请求一个工具时，核心包准备执行它。
- 如果所请求的工具可以修改文件系统或执行 shell 命令，则会首先向用户显示该工具及其参数的详细信息，并且必须获得用户的批准才能继续执行。
- 只读操作（例如读取文件）可能不需要显式的用户确认即可继续。
- 经用户确认后，或者如果无需确认，核心包将在相关工具内执行相应操作，并将结果通过核心包发回给模型 API。
- 模型 API 处理工具结果并生成最终响应。
响应返回 CLI： 核心包将最终响应发送回 CLI 包。
展示给用户： CLI 包对响应进行格式化并在终端中展示给用户。

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