@bryanhu/codexly 0.22.0 → 0.22.1

package/CHANGELOG.md

@@ -4,6 +4,12 @@
 
 ## [Unreleased]
 
+## [0.22.1] - 2026-09-16
+
+### 修复
+
+- 修复内置更新和全局安装复用过期 npm 元数据、可能无法及时发现新版本的问题。
+
 ## [0.22.0] - 2026-09-16
 
 ### 新增

package/README.md

@@ -74,11 +74,11 @@ On first launch, sign in with ChatGPT or configure an OpenAI-compatible service
 For regular use, install Codexly globally:
 
 ```bash
-npm install --global @bryanhu/codexly@latest --registry=https://registry.npmmirror.com --prefer-offline || npm install --global @bryanhu/codexly@latest --registry=https://registry.npmjs.org --prefer-offline
+npm install --global @bryanhu/codexly@latest --registry=https://registry.npmmirror.com || npm install --global @bryanhu/codexly@latest --registry=https://registry.npmjs.org
 codexly
 ```
 
-The installation command tries the China mirror first, falls back to the official registry on failure, and reuses the npm cache. `||` works in Bash, Zsh, cmd, and PowerShell 7+. In Windows PowerShell 5.1, run the command to the right of `||` separately if the first command fails.
+The installation command tries the China mirror first, falls back to the official registry on failure, reuses the npm cache, and revalidates stale package metadata. `||` works in Bash, Zsh, cmd, and PowerShell 7+. In Windows PowerShell 5.1, run the command to the right of `||` separately if the first command fails.
 
 ## Usage
 
@@ -114,7 +114,7 @@ Run `codexly doctor` when startup, Codex, or local data checks fail. Run `codexl
 Interactive startup and **Settings > About** check for new releases. Built-in updates try the China mirror first for version checks, package downloads, and dependency installation, falling back to the official registry on failure and reusing your npm cache. New releases may appear later while the mirror synchronizes. A global installation can also be updated with:
 
 ```bash
-npm install --global @bryanhu/codexly@latest --registry=https://registry.npmmirror.com --prefer-offline || npm install --global @bryanhu/codexly@latest --registry=https://registry.npmjs.org --prefer-offline
+npm install --global @bryanhu/codexly@latest --registry=https://registry.npmmirror.com || npm install --global @bryanhu/codexly@latest --registry=https://registry.npmjs.org
 ```
 
 If an older Linux release was installed into a system directory with `sudo npm install --global`, manually run the command above with `sudo` once to reach a release that supports elevated updates. Later built-in updates request `sudo` access when needed.

package/README.zh-CN.md

@@ -44,11 +44,11 @@ Codexly 会自动打开浏览器。若未打开，请访问终端输出的地址
 经常使用时可以全局安装：
 
 ```bash
-npm install --global @bryanhu/codexly@latest --registry=https://registry.npmmirror.com --prefer-offline || npm install --global @bryanhu/codexly@latest --registry=https://registry.npmjs.org --prefer-offline
+npm install --global @bryanhu/codexly@latest --registry=https://registry.npmmirror.com || npm install --global @bryanhu/codexly@latest --registry=https://registry.npmjs.org
 codexly
 ```
 
-安装命令优先使用国内镜像，失败后回退官方源，并复用 npm 缓存。`||` 适用于 Bash、Zsh、cmd 和 PowerShell 7+；Windows PowerShell 5.1 请在第一条命令失败后单独执行 `||` 右侧的命令。
+安装命令优先使用国内镜像，失败后回退官方源，复用 npm 缓存并重新校验过期的包元数据。`||` 适用于 Bash、Zsh、cmd 和 PowerShell 7+；Windows PowerShell 5.1 请在第一条命令失败后单独执行 `||` 右侧的命令。
 
 ## 使用方式
 
@@ -84,7 +84,7 @@ codexly start --lan
 交互式启动和“设置 > 关于”会检查新版本。内置更新的版本查询、包下载和依赖安装优先使用国内镜像，失败后回退官方源；下载和安装复用用户的 npm 缓存。镜像同步期间可能稍晚显示新版本。全局安装也可以通过以下命令更新：
 
 ```bash
-npm install --global @bryanhu/codexly@latest --registry=https://registry.npmmirror.com --prefer-offline || npm install --global @bryanhu/codexly@latest --registry=https://registry.npmjs.org --prefer-offline
+npm install --global @bryanhu/codexly@latest --registry=https://registry.npmmirror.com || npm install --global @bryanhu/codexly@latest --registry=https://registry.npmjs.org
 ```
 
 如果 Linux 上的旧版本通过 `sudo npm install --global` 安装到系统目录，首次升级到支持提权更新的版本时需要手动执行一次上述命令并在前面加上 `sudo`。后续内置更新会在需要时请求 `sudo` 权限。

package/dist/cli.js

@@ -22,7 +22,7 @@ createRequire(import.meta.url);
 
 // package.json
 var package_default = {
-  version: "0.22.0"};
+  version: "0.22.1"};
 var INSTALL_TIMEOUT_MS = 2 * 6e4;
 function resolveNpmCommandInvocation(args, platform = process.platform, execPath = process.execPath, elevated = false) {
   const invocation = platform === "win32" ? {
@@ -107,9 +107,7 @@ function runNpmWithRegistryFallback(runNpm, args, options = {}) {
         `--registry=${registry}`,
         `--@openai:registry=${registry}`,
         `--@bryanhu:registry=${registry}`,
-        // 沿用用户的持久 npm cache，缺失内容仍联网获取，不创建随更新删除的缓存。
-        "--prefer-offline",
-        "--prefer-online=false",
+        // 沿用用户的持久 npm cache，并保留 npm 默认的过期元数据重新校验行为。
         // 限制单源等待，避免 npm 默认重试退避延迟官方源兜底。
         "--fetch-retries=0",
         "--fetch-timeout=30000",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bryanhu/codexly",
-  "version": "0.22.0",
+  "version": "0.22.1",
   "description": "通过 Web 操作本地 Coding Agent 的应用",
   "type": "module",
   "author": "BryanHu",