numable-codex-usage 0.1.0 → 0.1.1

package/README.md

@@ -1,6 +1,6 @@
 # Codex 用量采集器
 
-在电脑上统计 Codex 用量，并按需同步到 Numable。首发版本为 `0.1.0`；各平台验证范围见文末兼容矩阵。
+在电脑上统计 Codex 用量，并按需同步到 Numable。当前版本为 `0.1.1`；各平台验证范围见文末兼容矩阵。
 
 需要 Node.js 18.17 或以上；建议使用当前长期支持版本。采集器不假设 Codex 自带可供外部使用的 Node.js。
 
@@ -54,6 +54,20 @@ node codex/cli.cjs quota-auto-on
 
 主动读取通过本机 Codex 协议完成，不创建会话，不要求复制 OpenAI 登录凭证。账号标识在本机匿名化；加入同一空间后使用空间范围的匿名标识，以便服务端合并同账号多台电脑的额度。不能识别账号的日志快照按设备分别展示。
 
+0.1.1 的 `init` 在首次配置或旧版未设置时开启每五分钟只读额度检查；明确执行过 `quota-auto-off` 的选择保持不变。初始化本身不启动协议读取或后台进程，也不自动上传历史。
+
+从0.1.0升级后，请运行以下命令；已运行的后台进程必须重启才能使用新版本：
+
+```sh
+npm install -g numable-codex-usage@0.1.1
+numable-codex stop
+numable-codex init
+numable-codex start
+numable-codex status
+```
+
+`status` 会显示 `quotaAuto`、`quotaStatus` 和开启指引；如需主动开启，可运行 `numable-codex quota-auto-on`。额度观测超过15分钟或窗口到期后，页面只保留带过期标识的上次值，不将其当作当前额度。电脑休眠、离线、采集停止或读取失败均可能导致观测过期。
+
 `quota-auto-on` 显式开启每五分钟读取，需后台采集运行；`quota-auto-off` 关闭。多个目录分别连接，单个目录失败会保留其旧观测并标注不完整。macOS 的命令行启动器不可用时，会尝试已安装桌面端的内置可执行文件；也可显式指定路径。
 
 ## 手机同步

package/cli.cjs

@@ -270,7 +270,12 @@ async function main(argv = process.argv.slice(2)) {
     process.stdout.write('{}\n');
     return;
   }
-  if (args.command === 'init') { await saveConfig(p, config); output('本机采集已初始化，手机同步尚未开启'); return; }
+  if (args.command === 'init') {
+    // 首次配置或旧版未设置时启用只读额度检查，保留用户明确关闭的选择。
+    if (typeof read(p.config, {}).quotaAuto !== 'boolean') config.quotaAuto = true;
+    await saveConfig(p, config);
+    output(`本机采集已初始化；手机同步${config.sync ? '已开启' : '尚未开启'}。${config.quotaAuto ? '已启用每五分钟只读额度检查，运行 start 保持后台采集；可用 quota-auto-off 关闭' : '额度自动读取已关闭；可用 quota-auto-on 开启'}`); return;
+  }
   if (args.command === 'collect') {
     if (args.hookWorker) {
       let release;
@@ -321,7 +326,7 @@ async function main(argv = process.argv.slice(2)) {
   if (args.command === 'status') {
     const snapshot = read(p.snapshot, null);
     output({ initialized: fs.existsSync(p.config), sync: config.sync, paired: !!config.writeToken, live: config.live,
-      quotaAuto: config.quotaAuto === true, quotaStatus: config.quotaStatus || null, syncError: config.syncError || null,
+      quotaAuto: config.quotaAuto === true, quotaHint: config.quotaAuto ? '请保持后台采集运行；读取失败时检查 Codex 登录状态' : '运行 numable-codex quota-auto-on，再运行 numable-codex start', quotaStatus: config.quotaStatus || null, syncError: config.syncError || null,
       collectedAt: snapshot?.collectedAt || null, timezone: config.timezone, projects: config.projects,
       coverage: snapshot?.coverage || [], diagnostics: snapshot?.diagnostics || null, collection: snapshot?.collection || null,
       hooksInstalled: !!config.installed?.length, hooksTrust: config.installed?.length ? 'check-in-codex' : null });

package/lib/quota.cjs

@@ -46,7 +46,7 @@ function readQuota({ binary = process.env.NUMABLE_CODEX_BINARY || 'codex', home,
         finish(null, { observedAt, scope: hash(salt, 'quota-scope'), supported: quotas.length > 0, quotas });
       }
     });
-    send({ id: 1, method: 'initialize', params: { clientInfo: { name: 'numable_codex_usage', version: '0.1.0' }, capabilities: { experimentalApi: true } } });
+    send({ id: 1, method: 'initialize', params: { clientInfo: { name: 'numable_codex_usage', version: '0.1.1' }, capabilities: { experimentalApi: true } } });
   });
 }
 async function readQuotaHomes({ homes, salt, profileSalt = salt, previous, ...options }) {

package/package.json

@@ -1,10 +1,20 @@
 {
   "name": "numable-codex-usage",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "在本机统计 Codex 用量，并按需同步到 Numable",
   "license": "MIT",
-  "engines": { "node": ">=18.17" },
-  "bin": { "numable-codex": "cli.cjs" },
-  "files": ["cli.cjs", "lib/", "README.md"],
-  "scripts": { "test": "node --test ../test/codex-*.test.cjs" }
+  "engines": {
+    "node": ">=18.17"
+  },
+  "bin": {
+    "numable-codex": "cli.cjs"
+  },
+  "files": [
+    "cli.cjs",
+    "lib/",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test ../test/codex-*.test.cjs"
+  }
 }