发布渠道与工作流
理解 stable、preview、nightly,区分 dry run、归档验证和实际发布。
This page has not been translated into English yet. The original Chinese version is shown below.
发布流程把代码版本、npm 标签、GitHub Release 与独立归档关联起来。普通使用者只需选择安装渠道;维护者则需要核对工作流输入、测试和最终发布产物。
三种安装渠道
npm install -g @qwen-code/qwen-code@latest
npm install -g @qwen-code/qwen-code@preview
npm install -g @qwen-code/qwen-code@nightlylatest 对应稳定渠道;preview 用于预览版本,nightly 用于频繁构建。调度执行不保证每次都会产生新可用版本,测试、构建或发布失败都可能阻止更新。
当前 release.yml 将 nightly 安排在每日 21:00 UTC,preview 安排在每周二 17:00 UTC;稳定发布由手动流程控制。使用时以对应仓库工作流和实际发布记录为准。
手动输入
| 输入 | 作用 |
|---|---|
| ref | 选择发布引用,默认 main |
| version | 普通手动发布的目标版本;nightly 模式忽略它 |
| dry_run | 演练流程;默认 true,说明明确不创建发布分支、npm 包或 GitHub Release |
| create_nightly_release | 选择 nightly 发布模式,默认 false |
| create_preview_release | 选择 preview 模式,默认 false;可将普通版本号转换为 preview 形式 |
| force_skip_tests | 默认 false;用于明确控制是否跳过测试的维护输入 |
dry_run 是发布流程的输入,不是所有 shell 命令通用的无副作用保证。演练仍可能执行构建和验证;实际行为还受到 job 条件和仓库限制影响。
旧 npm 指南给出 npm run publish:npm --dry-run,但当前根 package.json 没有 publish:npm 脚本。不要照此当作可运行入口;应使用现有工作流的 dry_run 输入并核对具体实现。
验证什么
流程分别进行静态检查、构建和 workspace 测试,具体预算见CI variables。发布还要检查独立归档及其启动文件,不能仅以 TypeScript 构建成功代替分发验证。
OpenTUI preview 归档由 OPENTUI_PREVIEW_RELEASE_ENABLED 控制相应构建步骤。镜像同步应以实际生成的归档为依据,不能只看到开关启用就假定某平台已经有产物。
版本、release 分支和 npm tag 要保持一致。稳定版或 hotfix 的版本变更还需按上游流程回并主线;预发布模式不应直接套用所有稳定发布步骤。
安装后检查
可检查已发布渠道的 CLI 版本:
npx -y @qwen-code/qwen-code@latest --version这个检查会获取并执行对应包,只验证该环境能够启动并报告版本。它不验证认证、真实模型调用、所有工具或其他平台的独立归档。发布结果异常时先核对实际版本与产物,避免把重新发布当成普通重试操作。