Skip to content
FunCoding

Search

Search docs, Skills and MCP

发布渠道与工作流

理解 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@nightly

latest 对应稳定渠道;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

这个检查会获取并执行对应包,只验证该环境能够启动并报告版本。它不验证认证、真实模型调用、所有工具或其他平台的独立归档。发布结果异常时先核对实际版本与产物,避免把重新发布当成普通重试操作。