@coze/cli 0.3.0 → 0.3.1-alpha.ae71a9

package/README.md

@@ -809,6 +809,23 @@ coze upgrade --tag beta
 | `--force`     | Force upgrade even if already on the latest version    |
 | `--tag <tag>` | Specify the dist-tag to upgrade to (default: `latest`) |
 
+#### Auto-Upgrade
+
+By default Coze CLI keeps itself up to date: it checks for new versions in the background (throttled, never blocking the current command) and, in `auto` mode, installs the update silently so it takes effect on your **next run**. Behavior is controlled via `coze config set`:
+
+| Config            | Values                          | Default  | Description                                                                                          |
+| ----------------- | ------------------------------- | -------- | --------------------------------------------------------------------------------------------------- |
+| `upgrade.mode`    | `auto` / `notify` / `off`       | `auto`   | `auto`: silent background upgrade; `notify`: only prompt to run `coze upgrade`; `off`: disable checks |
+| `upgrade.channel` | `latest` / `beta` / `alpha` / … | `latest` | npm dist-tag to track                                                                               |
+
+```bash
+coze config set upgrade.mode notify    # only prompt, don't auto-install
+coze config set upgrade.mode off       # disable upgrade checks entirely
+coze config set upgrade.channel beta   # track the beta channel
+```
+
+Upgrade checks are automatically skipped in CI (the `CI` env var is set), for dev/local builds, and when `COZE_CLI_NO_UPDATE_NOTIFIER` is set. Version checks are throttled to at most once every **4 hours**; a failed background upgrade is retried at most once every **10 minutes**. In JSON output the hint is attached as `_notice.update` with a ready-to-run `command` field. See [`docs/auto-upgrade.md`](docs/auto-upgrade.md) for details.
+
 ### Other Commands
 
 | Command      | Description                                                       |
@@ -855,7 +872,9 @@ The CLI reads configuration from multiple sources with the following priority (h
 | `COZE_PROJECT_ID`        | Default Project ID (used by `message` commands)     |
 | `COZE_CONFIG_FILE`       | Custom configuration file path                      |
 | `COZE_CONFIG_SCOPE`      | Config write scope: `global` or `local`             |
-| `COZE_AUTO_CHECK_UPDATE` | Enable/disable auto update check: `true` or `false` |
+| `COZE_CLI_NO_UPDATE_NOTIFIER` | Set to any non-empty value to skip the upgrade check for this run (overrides `upgrade.mode`) |
+| `COZE_CLI_NO_SKILL_NOTIFIER`  | Set to any non-empty value to suppress the bundled-skill version-mismatch notice            |
+| `CI`                     | When set (to any value other than `false`/`0`), auto-skips upgrade checks and skill notices |
 
 ## Exit Codes
 

package/bin/postinstall.js

@@ -18,7 +18,7 @@ try {
   const { spawnSync } = require('child_process');
 
   // CI 环境不执行同步（不可控环境不写家目录）
-  // 开发仓库内的安装（rush update / pnpm install）也跳过：发布包不含 src/
+  // 开发仓库内的依赖更新（rush update / pnpm add 等）也跳过：发布包不含 src/
   if (process.env.CI || existsSync(join(__dirname, '..', 'src'))) {
     process.exit(0);
   }