@cc-x/cc-x 0.4.2 → 0.4.4

package/dist/ui/menus.js

@@ -10,6 +10,7 @@ import { launchSession } from '../actions.js';
 import { isOfficial, reconcileCurrent, saveStore } from '../config/store.js';
 import { setDefault } from '../env/default.js';
 import { getLang, providerDisplayName, setLang, T } from '../i18n/index.js';
+import { banner as updateBanner, maybeRefresh, MODE_NOTIFY, upgradeCommand } from '../update/update.js';
 import { padDisplay } from '../utils/display.js';
 import { editForm } from './edit.js';
 import { noteSuffix, stateLabel } from './format.js';
@@ -23,14 +24,27 @@ async function readLine(prompt) {
 /** 一级 · 主菜单。布局：[profiles…] '' 新增 语言 '' 退出。 */
 export async function openMenu(paths, store, scope, version, catalog) {
     let sel = 0;
+    let refreshed = false;
     for (;;) {
         const n = store.providers.length;
+        // 更新检查（仅 notify 模式）：首轮触发一次后台刷新；横幅永远读缓存（瞬时、不阻塞）。
+        let notice;
+        if (store.update === MODE_NOTIFY) {
+            if (!refreshed) {
+                maybeRefresh(paths.dir);
+                refreshed = true;
+            }
+            const latest = updateBanner(paths.dir, version);
+            if (latest)
+                notice = T('menu.updateAvailable', latest, upgradeCommand());
+        }
+        const updLabel = store.update === MODE_NOTIFY ? T('menu.updateNotify') : T('menu.updateOff');
         const buildItems = () => {
             const labels = store.providers.map((p) => {
                 const dft = p.name === store.current ? T('menu.default') : '';
                 return `${padDisplay(providerDisplayName(p), 16)}${padDisplay(dft, 8)}[${stateLabel(p)}]${noteSuffix(p)}`;
             });
-            return [...labels, '', T('menu.newProfile'), T('menu.language'), '', T('menu.exit')];
+            return [...labels, '', T('menu.newProfile'), T('menu.language'), updLabel, '', T('menu.exit')];
         };
         const onMove = (from, to) => {
             const ps = store.providers;
@@ -45,6 +59,7 @@ export async function openMenu(paths, store, scope, version, catalog) {
         };
         sel = await selectMenu({
             title: T('menu.mainTitle', version),
+            ...(notice ? { notice } : {}),
             items: buildItems(),
             colors: { [n + 1]: 'yellow' },
             start: sel,
@@ -53,7 +68,7 @@ export async function openMenu(paths, store, scope, version, catalog) {
             hint: T('menu.mainHint'),
             noNumber: true,
         });
-        if (sel < 0 || sel === n + 4)
+        if (sel < 0 || sel === n + 5)
             return; // 退出 / Esc / q
         if (sel === n + 1) {
             // 新增配置
@@ -71,6 +86,14 @@ export async function openMenu(paths, store, scope, version, catalog) {
             store.lang = next;
             saveStore(paths, store);
         }
+        else if (sel === n + 3) {
+            // 更新检查开关：关闭 <-> 提醒（关闭=删字段，与 Go 的 omitempty 对齐）
+            if (store.update === MODE_NOTIFY)
+                delete store.update;
+            else
+                store.update = MODE_NOTIFY;
+            saveStore(paths, store);
+        }
         else if (sel < n) {
             const target = store.providers[sel];
             if (target)

package/dist/ui/select.js

@@ -41,6 +41,9 @@ export async function selectMenu(opts) {
         if (opts.title) {
             lines.push(`  ${paint(opts.title, 'cyan')}`, '');
         }
+        if (opts.notice) {
+            lines.push(`  ${paint(opts.notice, 'yellow')}`, '');
+        }
         if (opts.status) {
             lines.push(`  ${paint(opts.status, 'green')}`, '');
         }

package/dist/update/update.js

@@ -0,0 +1,112 @@
+/**
+ * 「检查新版本」的轻量实现，对齐 Go 版 internal/update。
+ *
+ * 不走 GitHub API（仅用 releases/latest 的 302 重定向抠版本号，无速率限制），结果缓存在
+ * ~/.cc-mini/update-check.json，每 24h 才真去网络。显示永远读缓存（瞬时、不阻塞），过期时后台
+ * 异步刷新——新版本「下次打开」才提示。离线/失败一律静默。只写工具自己的 ~/.cc-mini/（铁律）。
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+export const MODE_OFF = '';
+export const MODE_NOTIFY = 'notify';
+const LATEST_URL = 'https://github.com/becomeless/cc-x/releases/latest';
+const CACHE_MAX_AGE_MS = 24 * 60 * 60 * 1000;
+const HTTP_TIMEOUT_MS = 2000;
+const CACHE_FILE = 'update-check.json';
+const UPGRADE_CMD = 'npm i -g @cc-x/cc-x@latest';
+const TAG_RE = /\/tag\/v?(\d+\.\d+\.\d+)/;
+/** 读缓存：若已知有比 current 更新的版本，返回最新版本号；否则 undefined。不联网。 */
+export function banner(storeDir, current) {
+    const c = readCache(storeDir);
+    if (!c || !c.latest)
+        return undefined;
+    return isNewer(c.latest, current) ? c.latest : undefined;
+}
+/** 缓存过期（或不存在）时后台异步联网刷新一次；不阻塞调用方。 */
+export function maybeRefresh(storeDir) {
+    const c = readCache(storeDir);
+    if (c && Date.now() - c.checkedAt * 1000 < CACHE_MAX_AGE_MS)
+        return; // 仍新鲜
+    void refresh(storeDir); // fire-and-forget
+}
+async function refresh(storeDir) {
+    const latest = await fetchLatest();
+    if (!latest)
+        return; // 失败静默；不动缓存
+    writeCache(storeDir, { checkedAt: Math.floor(Date.now() / 1000), latest });
+}
+/** 当前版本（npm 版）的升级命令。 */
+export function upgradeCommand() {
+    return UPGRADE_CMD;
+}
+function cachePath(storeDir) {
+    return join(storeDir, CACHE_FILE);
+}
+function readCache(storeDir) {
+    try {
+        const c = JSON.parse(readFileSync(cachePath(storeDir), 'utf-8'));
+        if (typeof c.checkedAt === 'number' && typeof c.latest === 'string')
+            return c;
+    }
+    catch {
+        /* 无缓存 / 损坏 -> 当作没有 */
+    }
+    return undefined;
+}
+/** 原子写（temp + rename），避免被进程退出打断写出半截文件。 */
+function writeCache(storeDir, c) {
+    try {
+        if (!existsSync(storeDir))
+            mkdirSync(storeDir, { recursive: true });
+        const tmp = `${cachePath(storeDir)}.tmp`;
+        writeFileSync(tmp, JSON.stringify(c), 'utf-8');
+        renameSync(tmp, cachePath(storeDir));
+    }
+    catch {
+        /* 写不了就算了 */
+    }
+}
+/** 用 releases/latest 的 302 重定向抠最新版本号；redirect:'manual' = 不跟随 = 不走 GitHub API。 */
+async function fetchLatest() {
+    try {
+        const resp = await fetch(LATEST_URL, {
+            redirect: 'manual',
+            signal: AbortSignal.timeout(HTTP_TIMEOUT_MS),
+        });
+        const loc = resp.headers.get('location');
+        if (!loc)
+            return undefined;
+        const m = TAG_RE.exec(loc);
+        return m ? m[1] : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** latest 是否严格新于 current（"a.b.c"，忽略前导 v 与后缀）。解析失败一律 false（不误报）。 */
+export function isNewer(latest, current) {
+    const lp = parseSemver(latest);
+    const cp = parseSemver(current);
+    if (!lp || !cp)
+        return false;
+    const [la, lb, lc] = lp;
+    const [ca, cb, cc] = cp;
+    if (la !== ca)
+        return la > ca;
+    if (lb !== cb)
+        return lb > cb;
+    return lc > cc;
+}
+function parseSemver(s) {
+    let v = s.trim().replace(/^v/, '');
+    const cut = v.search(/[-+]/);
+    if (cut >= 0)
+        v = v.slice(0, cut);
+    const parts = v.split('.');
+    if (parts.length !== 3)
+        return undefined;
+    const nums = parts.map((p) => Number.parseInt(p, 10));
+    if (nums.some((n) => Number.isNaN(n)))
+        return undefined;
+    return [nums[0], nums[1], nums[2]];
+}

package/package.json

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