CLI
更新
使用 CLI 检查和安装 North Coder 版本。
update 命令用于从发布源检查和安装新版本。它不提供版本列表;默认升级到稳定版最新版,也可以指定 alpha、beta 或明确的版本号。
基本用法
# 检查稳定版是否有更新
ncoder update check
# 升级到稳定版最新版
ncoder update
# 安装最新 alpha 或 beta
ncoder update --channel alpha
ncoder update --channel beta
# 安装指定版本
ncoder update --version 0.0.72-alpha.3选项
| 选项 | 默认值 | 说明 |
|---|---|---|
--channel, -c | stable | 发布通道,支持 stable、alpha、beta。 |
--version | — | 安装指定版本。指定后允许升级或降级。 |
--force, -f | false | 自动停止运行中的 daemon,不再交互确认。 |
--check | false | 仅检查更新,等价于 update check。 |
版本选择
| 用法 | 行为 |
|---|---|
ncoder update | 只在稳定版目标版本高于当前版本时更新。 |
ncoder update --channel alpha | 安装 alpha 通道的最新版本,仍遵守只升级不降级。 |
ncoder update --channel beta | 安装 beta 通道的最新版本,仍遵守只升级不降级。 |
ncoder update --version <version> | 安装用户指定版本,只要目标版本不同就执行。 |
指定版本时,CLI 不枚举远端版本列表,也不替用户判断版本是否存在。版本号对应的发布产物不存在时,安装会失败并返回错误。
运行中的服务
更新前如果发现本机 daemon 正在运行,CLI 会先提示停止服务。脚本或 CI 场景可以使用 --force:
ncoder update --channel alpha --force停止服务只针对 CLI 管理的本机 daemon;远程服务不会被本地 CLI 更新命令替换。
平台行为
| 平台 | 行为 |
|---|---|
| macOS 桌面版内置 CLI | 下载 DMG 并替换当前 North Coder.app,与 install.sh 的安装语义一致,保证桌面壳与后端版本锁步。 |
| macOS 独立 CLI | 下载对应架构的 CLI/server 二进制并替换当前命令路径。 |
| Linux | 下载对应架构的 CLI/server 二进制并安装到本机命令路径。 |
| Windows | 通过 Windows 安装器完成升级;不执行 POSIX install.sh。 |
JSON 输出
所有更新命令都支持 --json:
ncoder --json update check | jq .status
ncoder --json update --channel alpha --forceJSON 输出包含当前版本、目标版本、通道、安装状态和错误信息等字段,适合脚本判断。