@cc-x/cc-x 0.4.7 → 0.4.8

package/README.en.md

@@ -89,6 +89,19 @@ xx DeepSeek -s     # Use this session, launch Claude now
 xx DeepSeek        # Set as default for new terminals
 ```
 
+### Updating
+
+Updating just means **re-running the install command** — the installer downloads the latest
+release and overwrites the old binary in place, no uninstall needed. **Open a new terminal**
+afterward; `xx --version` should show the new version.
+
+- **Windows**: `irm https://github.com/becomeless/cc-x/releases/latest/download/install.ps1 | iex`
+- **macOS / Linux**: `curl -fsSL https://github.com/becomeless/cc-x/releases/latest/download/install.sh | sh`
+- **npm**: `npm i -g @cc-x/cc-x@latest`
+
+> With the menu's "Update check" set to "notify", CC-X shows a banner at the top of the menu
+> when a new version is out, with the matching upgrade command for your platform.
+
 ---
 
 ## 60-second quick start

package/README.md

@@ -87,6 +87,16 @@ xx DeepSeek -s     # 本次启用，立即启动 Claude
 xx DeepSeek        # 设为默认，以后新终端自动生效
 ```
 
+### 更新到新版本
+
+更新就是**重新跑一遍安装命令**——安装器会下载最新版覆盖旧的，不用先卸载。跑完**新开一个终端**，`xx --version` 即为新版本。
+
+- **Windows**：`irm https://github.com/becomeless/cc-x/releases/latest/download/install.ps1 | iex`
+- **macOS / Linux**：`curl -fsSL https://github.com/becomeless/cc-x/releases/latest/download/install.sh | sh`
+- **npm**：`npm i -g @cc-x/cc-x@latest`
+
+> 把菜单里的「更新检查」开到「提醒」后，有新版时 CC-X 会在菜单顶部横幅提示，并直接给出上面对应平台的升级命令。
+
 ---
 
 ## 60 秒上手

package/dist/env/default.js

@@ -18,23 +18,33 @@ export function computeManagedVals(p) {
     }
     return vals;
 }
-export function setDefault(paths, store, p, scope) {
+export function persistDefaultEnv(p, scope) {
     const vals = computeManagedVals(p);
     const dryRun = scope === 'process';
     const result = { scope, dryRun };
-    let persisted = true;
     if (!dryRun) {
         if (process.platform === 'win32') {
             result.windows = persistWindows(vals);
-            persisted = result.windows.ok;
         }
         else {
             result.unix = persistUnix(vals);
-            persisted = !result.unix.unsupported; // fish 未写入 → 不算持久化成功
         }
     }
+    return result;
+}
+function envPersisted(result) {
+    if (result.dryRun)
+        return true;
+    if (result.windows)
+        return result.windows.ok;
+    if (result.unix)
+        return !result.unix.unsupported; // fish 未写入 → 不算持久化成功
+    return false;
+}
+export function setDefault(paths, store, p, scope) {
+    const result = persistDefaultEnv(p, scope);
     // [P1] 仅当持久化成功（或 dry-run）才改默认指向并落盘，避免「报失败却已改默认」的不一致。
-    if (dryRun || persisted) {
+    if (envPersisted(result)) {
         store.current = p.name;
         saveStore(paths, store);
     }

package/dist/i18n/messages.js

@@ -121,6 +121,7 @@ export const messages = {
     'error.storeRead': { zh: '配置文件读取失败：{0}', en: 'Failed to read config file: {0}' },
     'error.storeCorrupt': { zh: '配置文件解析失败（JSON 语法错误）：{0}', en: 'Failed to parse config file (invalid JSON): {0}' },
     'error.storeFormat': { zh: '配置文件结构不正确（顶层须为对象、providers 须为数组且条目结构合法）：{0}', en: 'Config file has invalid structure (top-level must be an object, providers must be an array with valid profile entries): {0}' },
+    'error.storeSave': { zh: '配置文件保存失败：{0}', en: 'Failed to save config file: {0}' },
     'error.storeCorruptHint': {
         zh: '为避免误删，未对它做任何改动。请修复后重试；或删除该文件以重新生成默认配置（会丢失已填的密钥）。',
         en: 'Left untouched to avoid data loss. Fix it and retry; or delete the file to regenerate defaults (loses any saved keys).',

package/dist/ui/menus.js

@@ -8,7 +8,7 @@
 import { launchSession } from '../actions.js';
 import { checkProfile } from '../check.js';
 import { getProviderEnvMap, getProviderState, isOfficial, reconcileCurrent, saveStore } from '../config/store.js';
-import { setDefault } from '../env/default.js';
+import { persistDefaultEnv, setDefault } from '../env/default.js';
 import { getLang, providerDisplayName, setLang, T } from '../i18n/index.js';
 import { currentTerminalLine, hostOf } from '../runtime-info.js';
 import { banner as updateBanner, maybeRefresh, MODE_NOTIFY, upgradeCommand } from '../update/update.js';
@@ -91,9 +91,7 @@ export async function openMenu(paths, store, scope, version, catalog) {
             if (shortcut === 'e') {
                 const old = target.name;
                 if (await editForm(target, store, catalog)) {
-                    if (store.current === old)
-                        store.current = target.name;
-                    saveStore(paths, store);
+                    ({ warn: warnFlash, toast: flash } = saveEditedProfile(paths, store, target, old, scope));
                 }
             }
             else if (shortcut === 's') {
@@ -137,9 +135,7 @@ export async function openMenu(paths, store, scope, version, catalog) {
                     // #9：无密钥的第三方配置，Enter 直达编辑并聚焦密钥行（铺平首次成功路径）。
                     const old = target.name;
                     if (await editForm(target, store, catalog, true)) {
-                        if (store.current === old)
-                            store.current = target.name;
-                        saveStore(paths, store);
+                        ({ warn: warnFlash, toast: flash } = saveEditedProfile(paths, store, target, old, scope));
                     }
                 }
                 else {
@@ -187,9 +183,7 @@ async function actionMenu(paths, store, p, scope, catalog) {
         else if (sel === 3) {
             const old = p.name;
             if (await editForm(p, store, catalog)) {
-                if (store.current === old)
-                    store.current = p.name; // 改了名/供应商时同步默认指向
-                saveStore(paths, store);
+                ({ warn: warnFlash, toast: flash } = saveEditedProfile(paths, store, p, old, scope));
             }
         }
         else if (sel === 4) {
@@ -212,14 +206,19 @@ function defaultDisplayName(store) {
         return '—';
     return providerDisplayName(store.providers.find((p) => p.name === store.current) ?? { name: store.current, env: {} });
 }
-/**
- * 设为默认，返回 { warn, toast }：warn 为黄字警告（缺密钥），toast 为绿色结果。
- * 分开返回让调用方各自上色，避免警告被染成「成功」绿。
- */
-function applyDefault(paths, store, p, scope) {
-    const name = providerDisplayName(p);
-    const warn = getProviderState(p).key === 'noKey' ? T('default.noKey', name) : '';
-    const r = setDefault(paths, store, p, scope);
+function saveEditedProfile(paths, store, p, oldName, scope) {
+    const wasDefault = store.current === oldName;
+    if (wasDefault)
+        store.current = p.name; // 改了名/供应商时同步默认指向
+    saveStore(paths, store);
+    if (wasDefault)
+        return syncDefaultEnv(p, scope);
+    return {};
+}
+function defaultWarning(p) {
+    return getProviderState(p).key === 'noKey' ? T('default.noKey', providerDisplayName(p)) : '';
+}
+function defaultResultMessage(warn, name, r) {
     if (r.dryRun)
         return { warn, toast: `${T('default.done', name)}  ${T('default.dryRun')}` };
     if (r.windows && !r.windows.ok)
@@ -228,6 +227,18 @@ function applyDefault(paths, store, p, scope) {
         return { warn, toast: T('default.fishUnsupported') };
     return { warn, toast: T('default.done', name) };
 }
+function syncDefaultEnv(p, scope) {
+    const name = providerDisplayName(p);
+    return defaultResultMessage(defaultWarning(p), name, persistDefaultEnv(p, scope));
+}
+/**
+ * 设为默认，返回 { warn, toast }：warn 为黄字警告（缺密钥），toast 为绿色结果。
+ * 分开返回让调用方各自上色，避免警告被染成「成功」绿。
+ */
+function applyDefault(paths, store, p, scope) {
+    const name = providerDisplayName(p);
+    return defaultResultMessage(defaultWarning(p), name, setDefault(paths, store, p, scope));
+}
 // hostSuffix 返回行尾的灰字 host（如 ` · api.deepseek.com`）；无 base（官方/未填）返回空。
 // 超宽时由 selectMenu 的 ANSI-aware 截断从行尾裁掉，不会切坏颜色。
 function hostSuffix(p) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cc-x/cc-x",
-  "version": "0.4.7",
+  "version": "0.4.8",
   "description": "Claude Code API 切换器（命令 xx）：在官方账号与第三方 Anthropic 兼容 API 间切换，纯环境变量、不碰 Claude Code 配置文件。",
   "keywords": [
     "claude",