easy-codex 0.2.2 → 0.2.4

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # 更新记录
 
+## v0.2.4（2026-10-19）
+
+- 菜单新增“更新版本”：后台复用 update，防重复点击；成功后自动重开浮窗，失败保留当前浮窗并提示，设置保持不变。
+
+## 0.2.3 — 2026-10-19
+
+### 修复
+
+- update先在线刷新latest并比较版本，按明确版本号安装，防止旧缓存降级；相同或更高的本地版本不安装，检查失败明确报错。
+- 保留上一版新增的update、show自动重开和绿色时段延长至18:00。
+
+
 ## 0.2.2 — 2026-10-19
 
 ### 新增

package/README.md

@@ -2,25 +2,12 @@
 
 显示当前本机 Codex 登录账号的剩余额度百分比和重置时间。第三方辅助工具，与 OpenAI 无官方隶属关系。
 
-## v0.2.2 新增与调整
+## v0.2.4 更新说明
 
-- **命令更新**：新增 `easy-codex update`，从官方 npm 更新当前全局安装。
-- **自动重开**：`easy-codex show` 会先退出自身旧浮窗，再打开新版；设置保持不变。
+- 菜单新增“更新版本”，后台检查并安装最新正式版，更新期间防止重复点击。
+- 更新成功后自动重开新版浮窗，保留时区、城市、位置和显示选择；失败时保留当前浮窗并提示原因。
 
-- 统一时间颜色：所选城市当地时间 **00:00–09:00 红色、09:00–18:00 绿色、18:00–24:00 橙色**，绿色时段延长到18:00。
-- 09:00转绿、18:00转橙、午夜转红，自动适应目标时区夏令时。
-- 保留已有时区、城市、位置和显示选择；额度圆环颜色阈值保持原有规则。
-
-完整版本说明见 [CHANGELOG](CHANGELOG.md)。
-
-## v0.2.1 新增功能
-
-- **快捷启动**：新增 `easy-codex show`，原 `overlay` 命令继续可用。
-- **重置倒计时**：周额度显示“5天后”等最大单位；5小时窗口显示“3小时2分后”，不足一小时只显示分钟。同时保留电脑本地时区的重置时刻。
-- **时间菜单优化**：开关改为“显示时间”；城市入口直接显示当前当地时间，如 `洛杉矶·05:23`，点号无空格。
-- **升级兼容**：保留已保存的时区、城市、位置和显示选择。
-
-完整更新记录见 [CHANGELOG](CHANGELOG.md)。
+历史版本更新记录见 [CHANGELOG](CHANGELOG.md)。
 
 ## 安装与使用
 
@@ -53,7 +40,7 @@ npm i -g easy-codex@latest
 easy-codex show
 ```
 
-`show` 从 v0.2.1 正式提供，`overlay` 保留兼容。更新前从 EC 菜单退出旧浮窗，再运行 `show`。已保存的城市、时区、位置与显示选择会保留；“恢复默认位置”只恢复位置，不重置时区。
+`show` 从 v0.2.1 正式提供，`overlay` 保留兼容。运行 `show` 会自动退出旧浮窗并打开新版。已保存的城市、时区、位置与显示选择会保留；“恢复默认位置”只恢复位置，不重置时区。
 
 周额度菜单示例：`周 · 77% · 5天后 25日 06:17 重置`。周倒计时只显示最大单位；若账号返回5小时窗口，其倒计时保留时分组合，例如 `3小时2分后 07:59 重置`，不足一小时仅显示分钟。绝对重置时间按电脑系统时区，独立时间浮窗按所选城市时区。
 
@@ -123,3 +110,5 @@ GitHub Actions 在 `v*` 标签上测试、构建通用 macOS 浮窗，并发布
 
 
 命令更新：`easy-codex update`，更新完成后运行 `easy-codex show`，会自动退出旧浮窗并打开新版。旧版本尚未提供 update 时，可先执行 `npm i -g easy-codex@latest`。更新过程中需要正常网络及原安装目录写入权限，不会自动使用 sudo。
+
+菜单中的“更新版本”会后台检查并更新，成功后自动重开浮窗；失败时保留当前浮窗并提示原因。更新期间不能重复点击，已保存设置保持不变。

package/native/Overlay.swift

@@ -233,6 +233,7 @@ final class Overlay: NSObject, NSApplicationDelegate, NSMenuDelegate {
     var status: NSStatusItem?
     var timer: Timer?
     var query: Process?
+    var updater: Process?
     var snapshot: Snapshot?
     var error: String?
     var lastAttempt = Date.distantPast
@@ -419,6 +420,7 @@ final class Overlay: NSObject, NSApplicationDelegate, NSMenuDelegate {
         zoneItem.submenu = zones
         menu.addItem(zoneItem)
         menu.addItem(.separator())
+        menu.addItem(item(updater == nil ? "更新版本" : "正在更新…", updater == nil ? #selector(updateVersion) : nil))
         menu.addItem(item("退出浮窗", #selector(quit)))
         return menu
     }
@@ -477,6 +479,54 @@ final class Overlay: NSObject, NSApplicationDelegate, NSMenuDelegate {
         UserDefaults.standard.removeObject(forKey: "bottomInset")
         tick()
     }
+    @objc func updateVersion() {
+        guard updater == nil else { return }
+        let cli = URL(fileURLWithPath: script).deletingLastPathComponent()
+            .appendingPathComponent("overlay-update.js")
+        let process = Process()
+        process.executableURL = URL(fileURLWithPath: node)
+        process.arguments = [cli.path]
+        var env = ProcessInfo.processInfo.environment
+        env["PATH"] = searchPath
+        process.environment = env
+        // npm 输出可能超过管道容量，写临时文件以免等待退出时死锁。
+        let output = FileManager.default.temporaryDirectory.appendingPathComponent(UUID().uuidString)
+        guard FileManager.default.createFile(atPath: output.path, contents: nil,
+            attributes: [.posixPermissions: 0o600]), let handle = try? FileHandle(forWritingTo: output) else {
+            showUpdateResult("无法创建更新日志，请检查临时目录权限。")
+            return
+        }
+        process.standardOutput = handle
+        process.standardError = handle
+        process.terminationHandler = { [weak self] process in
+            try? handle.close()
+            let data = (try? Data(contentsOf: output)) ?? Data()
+            try? FileManager.default.removeItem(at: output)
+            let message = String(decoding: data.suffix(4096), as: UTF8.self)
+            Task { @MainActor in
+                guard let self else { return }
+                self.updater = nil
+                self.showUpdateResult(process.terminationStatus == 0
+                    ? message : "更新失败，请检查网络或安装目录权限。\n" + message)
+            }
+        }
+        updater = process
+        do { try process.run() }
+        catch {
+            updater = nil
+            try? handle.close()
+            try? FileManager.default.removeItem(at: output)
+            showUpdateResult("无法启动更新，请重新运行 easy-codex show。")
+        }
+    }
+    func showUpdateResult(_ message: String) {
+        let alert = NSAlert()
+        alert.messageText = "更新版本"
+        alert.informativeText = message
+        alert.addButton(withTitle: "好")
+        NSApp.activate(ignoringOtherApps: true)
+        alert.runModal()
+    }
     @objc func quit() { NSApp.terminate(nil) }
     func applicationWillTerminate(_ notification: Notification) {
         timer?.invalidate()

package/native/build/EasyCodexOverlay.app/Contents/Info.plist

@@ -5,7 +5,7 @@
 <key>CFBundleIdentifier</key><string>com.unionschool.easy-codex.overlay</string>
 <key>CFBundleName</key><string>Easy Codex Overlay</string>
 <key>CFBundlePackageType</key><string>APPL</string>
-<key>CFBundleShortVersionString</key><string>0.2.2</string>
+<key>CFBundleShortVersionString</key><string>0.2.4</string>
 <key>LSMinimumSystemVersion</key><string>14.0</string>
 <key>LSUIElement</key><true/>
 <key>NSHighResolutionCapable</key><true/>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "easy-codex",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Codex usage limits and transparent world clock overlay",
   "type": "module",
   "bin": {

package/src/overlay-update.js

@@ -0,0 +1,12 @@
+import { pathToFileURL } from 'node:url';
+import { updatePackage } from './update.js';
+
+export async function updateAndShow({ update = updatePackage,
+  show = async () => (await import('./overlay.js')).launchOverlay() } = {}) {
+  await update('easy-codex');
+  await show();
+}
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  updateAndShow().catch(error => { console.error(error.message); process.exitCode = 1; });
+}

package/src/update.js

@@ -1,7 +1,10 @@
 import { access, realpath } from 'node:fs/promises';
+import { readFileSync } from 'node:fs';
 import { dirname, basename, join, delimiter } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { spawn } from 'node:child_process';
+import { spawn, execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const { version } = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
 
 export function installedPrefix(root, platform = process.platform) {
   const modules = dirname(root.replace(/[\\/]$/, ''));
@@ -10,6 +13,15 @@ export function installedPrefix(root, platform = process.platform) {
   return basename(parent) === 'lib' ? dirname(parent) : platform === 'win32' ? parent : null;
 }
 
+export function isNewer(latest, current) {
+  if (!/^\d+\.\d+\.\d+$/.test(latest) || !/^\d+\.\d+\.\d+(?:-[\w.-]+)?$/.test(current)) {
+    throw new Error('无法识别正式版本号，未执行更新。');
+  }
+  const a = latest.split('.').map(Number), b = current.split('-')[0].split('.').map(Number);
+  for (let i = 0; i < 3; i++) { if (a[i] !== b[i]) return a[i] > b[i]; }
+  return current.includes('-');
+}
+
 async function findNpmCli() {
   const directories = [dirname(process.execPath), ...(process.env.PATH ?? '').split(delimiter)];
   for (const directory of directories.filter(Boolean)) {
@@ -22,6 +34,14 @@ async function findNpmCli() {
   throw new Error('未找到 npm，请先安装 Node.js/npm，再使用 npm i -g 更新。');
 }
 
+async function readLatest(npmCli, name) {
+  try {
+    const { stdout } = await promisify(execFile)(process.execPath, [npmCli, 'view', name, 'dist-tags.latest',
+      '--json', '--prefer-online', '--registry=https://registry.npmjs.org'], { timeout: 30000, maxBuffer: 4096 });
+    return JSON.parse(stdout);
+  } catch { throw new Error('无法在线检查 npm 最新版本，请检查网络后重试。'); }
+}
+
 function runNpm(command, args) {
   return new Promise((resolve, reject) => {
     const child = spawn(command, args, { stdio: 'inherit', shell: false });
@@ -34,12 +54,19 @@ function runNpm(command, args) {
 }
 
 export async function updatePackage(name, { root = fileURLToPath(new URL('../', import.meta.url)),
-  getNpmCli = findNpmCli, run = runNpm, platform = process.platform } = {}) {
+  getNpmCli = findNpmCli, getLatest = readLatest, currentVersion = version,
+  run = runNpm, platform = process.platform } = {}) {
   if (!['easy-codex', 'easy-claude'].includes(name)) throw new Error('不支持的更新包名。');
   const npmCli = await getNpmCli();
+  const latest = await getLatest(npmCli, name);
+  if (!isNewer(latest, currentVersion)) {
+    console.log(`${name} 当前 ${currentVersion}，npm 最新 ${latest}，无需更新。`);
+    return;
+  }
   const prefix = installedPrefix(root, platform);
+  // 先在线检查再锁定版本，避免安装阶段复用旧 latest 缓存而降级。
   const args = [npmCli, 'install', '--global', ...(prefix ? ['--prefix', prefix] : []),
-    '--registry=https://registry.npmjs.org', `${name}@latest`];
+    '--prefer-online', '--registry=https://registry.npmjs.org', `${name}@${latest}`];
   await run(process.execPath, args);
-  console.log(`${name} 已更新；运行 ${name} show 自动重启浮窗。`);
+  console.log(`${name} 已更新到 ${latest}；运行 ${name} show 自动重启浮窗。`);
 }