Qwen Code 执行与部署

本文档介绍如何运行 Qwen Code，并解释 Qwen Code 使用的部署架构。

运行 Qwen Code

有几种方式可以运行 Qwen Code。你选择哪种方式取决于你的使用场景。

这是推荐终端用户安装 Qwen Code 的方式。需要从 NPM registry 下载 Qwen Code 包。

全局安装：
```
npm install -g @qwen-code/qwen-code
```
然后可以在任意位置运行 CLI：
```
qwen
```

使用 NPX 执行：


# 无需全局安装，直接从 NPM 执行最新版本
npx @qwen-code/qwen-code

为了安全性和隔离性，Qwen Code 可以在容器内运行。这也是 CLI 执行可能产生副作用的工具时的默认方式。

直接从 Registry 运行： 你可以直接运行已发布的沙箱镜像。这在你只有 Docker 并希望运行 CLI 的环境中非常有用。
```
# 运行已发布的沙箱镜像
docker run --rm -it ghcr.io/qwenlm/qwen-code:0.0.7
```
使用 --sandbox 参数： 如果你已经在本地安装了 Qwen Code（使用上述标准安装方式），你可以指示它在沙箱容器内运行。
```
qwen --sandbox -y -p "your prompt here"
```

项目贡献者会希望直接从源码运行 CLI。

生产模式（链接包）： 此方法通过链接本地包来模拟全局安装。适用于在生产工作流中测试本地构建。


# 将本地 cli 包链接到全局 node_modules
npm link packages/cli
 
# 现在你可以使用 `qwen` 命令运行本地版本
qwen

你可以直接从 GitHub 仓库运行最新提交的 Qwen Code 版本。这对于测试仍在开发中的功能非常有用。


 
# 直接从 GitHub 的 main 分支执行 CLI
npx https://github.com/QwenLM/qwen-code

上述执行方式的实现依赖于以下架构组件和流程：

NPM 包

Qwen Code 项目是一个 monorepo，会将核心包发布到 NPM registry：

在执行标准安装或从源码运行 Qwen Code 时，都会使用到这些包。

构建与打包流程

根据不同的分发渠道，会使用两种不同的构建流程：

NPM 发布：在发布到 NPM registry 时，@qwen-code/qwen-code-core 和 @qwen-code/qwen-code 中的 TypeScript 源码会通过 TypeScript Compiler（tsc）被转译为标准 JavaScript。最终生成的 dist/ 目录会被发布为 NPM 包。这是 TypeScript 库的标准发布方式。
GitHub npx 执行：当直接从 GitHub 运行最新版本的 Qwen Code 时，会由 package.json 中的 prepare 脚本触发另一个构建流程。该脚本使用 esbuild 将整个应用及其依赖项打包成一个独立的 JavaScript 文件。这个 bundle 是在用户机器上即时生成的，并不会被提交到代码仓库中。

Docker 沙箱镜像

基于 Docker 的执行方式由 qwen-code-sandbox 容器镜像支持。该镜像会被发布到容器镜像仓库中，并包含一个预装好的全局版本的 Qwen Code。

发布流程通过 GitHub Actions 自动化执行。发布工作流包含以下操作：