v0.1.0-rc.12

token-usage v0.1.0-rc.12

Note: This is a pre-release (v0.1.0-rc.12) for testing; behavior may change before the stable release.

Changed

• macOS and Windows upgrade verification target (same codebase as rc.11)

Assets

• token-usage-darwin-arm64 — macOS (Apple Silicon)
• token-usage-darwin-amd64 — macOS (Intel)
• token-usage-windows-amd64.exe — Windows

Verify & install

1. Download the asset for your platform and SHA256SUMS.
2. Verify: shasum -a 256 token-usage-darwin-arm64 (Windows: certutil -hashfile token-usage-windows-amd64.exe SHA256).
3. Make it executable (macOS/Linux) and run ./token-usage version.

---

token-usage v0.1.0-rc.12（中文说明）

提示： 本版本为预发布（v0.1.0-rc.12），仅供测试；稳定版发布前行为可能调整。

变更

• macOS 与 Windows 升级验证目标（与 rc.11 同代码基线）

资产

• token-usage-darwin-arm64 — macOS（Apple 芯片）
• token-usage-darwin-amd64 — macOS（Intel）
• token-usage-windows-amd64.exe — Windows

校验与安装

1. 下载与你平台匹配的资产以及 SHA256SUMS。
2. 校验：shasum -a 256 token-usage-darwin-arm64（Windows：certutil -hashfile token-usage-windows-amd64.exe SHA256）。
3. 赋予执行权限（macOS/Linux）并运行 ./token-usage version。

v0.1.0-rc.11

token-usage v0.1.0-rc.11

Note: This is a pre-release (v0.1.0-rc.11) for testing; behavior may change before the stable release.

Fixed

• The updater now writes a per-run upgrade log at ~/.token-usage/logs/update-YYYY-MM-DD.log (mode 0600, 7-day retention), covering every step on both platforms with [update], [install], and [helper] prefixes, including all failure paths and the three-state helper result (ok / failure recorded / write failed)
• Stale files are now cleaned up: the result dead-letter file is consumed (read, logged, deleted) on the next update once provenance is trusted — including the no-update path; POSIX nonce remnants are swept; the external stage file is removed after install succeeds or fails

Assets

• token-usage-darwin-arm64 — macOS (Apple Silicon)
• token-usage-darwin-amd64 — macOS (Intel)
• token-usage-windows-amd64.exe — Windows

Verify & install

1. Download the asset for your platform and SHA256SUMS.
2. Verify: shasum -a 256 token-usage-darwin-arm64 (Windows: certutil -hashfile token-usage-windows-amd64.exe SHA256).
3. Make it executable (macOS/Linux) and run ./token-usage version.

---

token-usage v0.1.0-rc.11（中文说明）

提示： 本版本为预发布（v0.1.0-rc.11），仅供测试；稳定版发布前行为可能调整。

修复

• 更新器现会写入本次运行的升级日志 ~/.token-usage/logs/update-YYYY-MM-DD.log（0600，7 天保留），覆盖双平台每一步（[update]、[install]、[helper] 前缀），含全部失败路径与 helper 三态终态结果（ok / failure recorded / write failed）
• 残留文件现会清理：result 死信文件在下次更新 provenance 可信后被消费（读取、记录、删除），包含无更新路径；POSIX nonce 残留由 sweep 兜底；外部 stage 文件在安装成功或失败后删除

资产

• token-usage-darwin-arm64 — macOS（Apple 芯片）
• token-usage-darwin-amd64 — macOS（Intel）
• token-usage-windows-amd64.exe — Windows

校验与安装

1. 下载与你平台匹配的资产以及 SHA256SUMS。
2. 校验：shasum -a 256 token-usage-darwin-arm64（Windows：certutil -hashfile token-usage-windows-amd64.exe SHA256）。
3. 赋予执行权限（macOS/Linux）并运行 ./token-usage version。

v0.1.0-rc.9

token-usage v0.1.0-rc.9

Note: This is a pre-release (v0.1.0-rc.9) for testing; behavior may change before the stable release.

Fixed

• Windows: renamed the update stage and helper files to avoid the word "update" — Windows security policy blocks executing files whose names contain "update" (ERROR_ELEVATION_REQUIRED, reproduced on ARM64 VMs); the stage file is now named token-usage-stage-*.exe
• Failed version probes now clean up the downloaded stage file instead of leaving a ~24MB remnant

Assets

• token-usage-darwin-arm64 — macOS (Apple Silicon)
• token-usage-darwin-amd64 — macOS (Intel)
• token-usage-windows-amd64.exe — Windows

Verify & install

1. Download the asset for your platform and SHA256SUMS.
2. Verify: shasum -a 256 token-usage-darwin-arm64 (Windows: certutil -hashfile token-usage-windows-amd64.exe SHA256).
3. Make it executable (macOS/Linux) and run ./token-usage version.

---

token-usage v0.1.0-rc.9（中文说明）

提示： 本版本为预发布（v0.1.0-rc.9），仅供测试；稳定版发布前行为可能调整。

修复

• Windows：更新 stage 与 helper 文件名避开 "update" 字样——Windows 安全策略会拦截执行文件名含 "update" 的可执行文件（ERROR_ELEVATION_REQUIRED，ARM64 VM 实机复现）；stage 文件现命名为 token-usage-stage-*.exe
• 版本探针失败时清理已下载的 stage 文件，不再残留 ~24MB 大文件

资产

• token-usage-darwin-arm64 — macOS（Apple 芯片）
• token-usage-darwin-amd64 — macOS（Intel）
• token-usage-windows-amd64.exe — Windows

校验与安装

1. 下载与你平台匹配的资产以及 SHA256SUMS。
2. 校验：shasum -a 256 token-usage-darwin-arm64（Windows：certutil -hashfile token-usage-windows-amd64.exe SHA256）。
3. 赋予执行权限（macOS/Linux）并运行 ./token-usage version。

v0.1.0-rc.8

token-usage v0.1.0-rc.8

Note: This is a pre-release (v0.1.0-rc.8) for testing; behavior may change before the stable release.

Changed

• Windows upgrade verification target (same codebase as rc.7)

Assets

• token-usage-darwin-arm64 — macOS (Apple Silicon)
• token-usage-darwin-amd64 — macOS (Intel)
• token-usage-windows-amd64.exe — Windows

Verify & install

1. Download the asset for your platform and SHA256SUMS.
2. Verify: shasum -a 256 token-usage-darwin-arm64 (Windows: certutil -hashfile token-usage-windows-amd64.exe SHA256).
3. Make it executable (macOS/Linux) and run ./token-usage version.

---

token-usage v0.1.0-rc.8（中文说明）

提示： 本版本为预发布（v0.1.0-rc.8），仅供测试；稳定版发布前行为可能调整。

变更

• Windows 升级验证目标（与 rc.7 同代码基线）

资产

• token-usage-darwin-arm64 — macOS（Apple 芯片）
• token-usage-darwin-amd64 — macOS（Intel）
• token-usage-windows-amd64.exe — Windows

校验与安装

1. 下载与你平台匹配的资产以及 SHA256SUMS。
2. 校验：shasum -a 256 token-usage-darwin-arm64（Windows：certutil -hashfile token-usage-windows-amd64.exe SHA256）。
3. 赋予执行权限（macOS/Linux）并运行 ./token-usage version。

v0.1.0-rc.7

token-usage v0.1.0-rc.7

Note: This is a pre-release (v0.1.0-rc.7) for testing; behavior may change before the stable release.

Fixed

• Update download timeout increased from 30s to 20 minutes; 30s was insufficient for downloading the ~24MB binary on slow networks or VMs behind proxies

Assets

• token-usage-darwin-arm64 — macOS (Apple Silicon)
• token-usage-darwin-amd64 — macOS (Intel)
• token-usage-windows-amd64.exe — Windows

Verify & install

1. Download the asset for your platform and SHA256SUMS.
2. Verify: shasum -a 256 token-usage-darwin-arm64 (Windows: certutil -hashfile token-usage-windows-amd64.exe SHA256).
3. Make it executable (macOS/Linux) and run ./token-usage version.

---

token-usage v0.1.0-rc.7（中文说明）

提示： 本版本为预发布（v0.1.0-rc.7），仅供测试；稳定版发布前行为可能调整。

修复

• 更新下载超时从 30 秒增加到 20 分钟；30 秒在慢网络或代理 VM 上下载 24MB 二进制不够用

资产

• token-usage-darwin-arm64 — macOS（Apple 芯片）
• token-usage-darwin-amd64 — macOS（Intel）
• token-usage-windows-amd64.exe — Windows

校验与安装

1. 下载与你平台匹配的资产以及 SHA256SUMS。
2. 校验：shasum -a 256 token-usage-darwin-arm64（Windows：certutil -hashfile token-usage-windows-amd64.exe SHA256）。
3. 赋予执行权限（macOS/Linux）并运行 ./token-usage version。

v0.1.0-rc.6

token-usage v0.1.0-rc.6

Note: This is a pre-release (v0.1.0-rc.6) for testing; behavior may change before the stable release.

Changed

• Windows upgrade verification target (same codebase as rc.5)

Assets

• token-usage-darwin-arm64 — macOS (Apple Silicon)
• token-usage-darwin-amd64 — macOS (Intel)
• token-usage-windows-amd64.exe — Windows

Verify & install

1. Download the asset for your platform and SHA256SUMS.
2. Verify: shasum -a 256 token-usage-darwin-arm64 (Windows: certutil -hashfile token-usage-windows-amd64.exe SHA256).
3. Make it executable (macOS/Linux) and run ./token-usage version.

---

token-usage v0.1.0-rc.6（中文说明）

提示： 本版本为预发布（v0.1.0-rc.6），仅供测试；稳定版发布前行为可能调整。

变更

• Windows 升级验证目标（与 rc.5 同代码基线）

资产

• token-usage-darwin-arm64 — macOS（Apple 芯片）
• token-usage-darwin-amd64 — macOS（Intel）
• token-usage-windows-amd64.exe — Windows

校验与安装

1. 下载与你平台匹配的资产以及 SHA256SUMS。
2. 校验：shasum -a 256 token-usage-darwin-arm64（Windows：certutil -hashfile token-usage-windows-amd64.exe SHA256）。
3. 赋予执行权限（macOS/Linux）并运行 ./token-usage version。

v0.1.0-rc.5

token-usage v0.1.0-rc.5

Note: This is a pre-release (v0.1.0-rc.5) for testing; behavior may change before the stable release.

Fixed

• Windows: added .exe extension to the update stage file so the version probe can execute it; Windows CreateProcess rejects extension-less PE files with an elevation-required error (observed on ARM64 emulation)

Assets

• token-usage-darwin-arm64 — macOS (Apple Silicon)
• token-usage-darwin-amd64 — macOS (Intel)
• token-usage-windows-amd64.exe — Windows

Verify & install

1. Download the asset for your platform and SHA256SUMS.
2. Verify: shasum -a 256 token-usage-darwin-arm64 (Windows: certutil -hashfile token-usage-windows-amd64.exe SHA256).
3. Make it executable (macOS/Linux) and run ./token-usage version.

---

token-usage v0.1.0-rc.5（中文说明）

提示： 本版本为预发布（v0.1.0-rc.5），仅供测试；稳定版发布前行为可能调整。

修复

• Windows：更新下载的 stage 文件加 .exe 扩展名，修复版本探针执行失败（Windows CreateProcess 对无扩展名 PE 报 elevation required，ARM64 仿真环境复现）

资产

• token-usage-darwin-arm64 — macOS（Apple 芯片）
• token-usage-darwin-amd64 — macOS（Intel）
• token-usage-windows-amd64.exe — Windows

校验与安装

1. 下载与你平台匹配的资产以及 SHA256SUMS。
2. 校验：shasum -a 256 token-usage-darwin-arm64（Windows：certutil -hashfile token-usage-windows-amd64.exe SHA256）。
3. 赋予执行权限（macOS/Linux）并运行 ./token-usage version。

v0.1.0-rc.4

token-usage v0.1.0-rc.4

Note: This is a pre-release (v0.1.0-rc.4) for testing; behavior may change before the stable release.

Changed

• Windows upgrade verification target (same codebase as rc.3)

Assets

• token-usage-darwin-arm64 — macOS (Apple Silicon)
• token-usage-darwin-amd64 — macOS (Intel)
• token-usage-windows-amd64.exe — Windows

Verify & install

1. Download the asset for your platform and SHA256SUMS.
2. Verify: shasum -a 256 token-usage-darwin-arm64 (Windows: certutil -hashfile token-usage-windows-amd64.exe SHA256).
3. Make it executable (macOS/Linux) and run ./token-usage version.

---

token-usage v0.1.0-rc.4（中文说明）

提示： 本版本为预发布（v0.1.0-rc.4），仅供测试；稳定版发布前行为可能调整。

变更

• Windows 升级验证目标（与 rc.3 同代码基线）

资产

• token-usage-darwin-arm64 — macOS（Apple 芯片）
• token-usage-darwin-amd64 — macOS（Intel）
• token-usage-windows-amd64.exe — Windows

校验与安装

1. 下载与你平台匹配的资产以及 SHA256SUMS。
2. 校验：shasum -a 256 token-usage-darwin-arm64（Windows：certutil -hashfile token-usage-windows-amd64.exe SHA256）。
3. 赋予执行权限（macOS/Linux）并运行 ./token-usage version。

v0.1.0-rc.3

token-usage v0.1.0-rc.3

Note: This is a pre-release (v0.1.0-rc.3) for testing; behavior may change before the stable release.

Fixed

• Windows: fixed SQLite invalid uri authority initialization error by normalizing drive-letter paths to the file:///C:/... form

Assets

• token-usage-darwin-arm64 — macOS (Apple Silicon)
• token-usage-darwin-amd64 — macOS (Intel)
• token-usage-windows-amd64.exe — Windows

Verify & install

1. Download the asset for your platform and SHA256SUMS.
2. Verify: shasum -a 256 token-usage-darwin-arm64 (Windows: certutil -hashfile token-usage-windows-amd64.exe SHA256).
3. Make it executable (macOS/Linux) and run ./token-usage version.

---

token-usage v0.1.0-rc.3（中文说明）

提示： 本版本为预发布（v0.1.0-rc.3），仅供测试；稳定版发布前行为可能调整。

修复

• Windows：将盘符路径规范化为 file:///C:/... 形式，修复 SQLite「invalid uri authority」初始化错误

资产

• token-usage-darwin-arm64 — macOS（Apple 芯片）
• token-usage-darwin-amd64 — macOS（Intel）
• token-usage-windows-amd64.exe — Windows

校验与安装

1. 下载与你平台匹配的资产以及 SHA256SUMS。
2. 校验：shasum -a 256 token-usage-darwin-arm64（Windows：certutil -hashfile token-usage-windows-amd64.exe SHA256）。
3. 赋予执行权限（macOS/Linux）并运行 ./token-usage version。

v0.1.0-rc.2

token-usage v0.1.0-rc.2

Note: This is a pre-release (v0.1.0-rc.2) for testing; behavior may change before the stable release.

Changed

• One-line installer script (scripts/install.sh) with automatic platform detection and SHA256 verification
• Installation guide reorganized: the official Release binary is now the recommended option, including a copy-paste instruction for AI agents

Assets

• token-usage-darwin-arm64 — macOS (Apple Silicon)
• token-usage-darwin-amd64 — macOS (Intel)
• token-usage-windows-amd64.exe — Windows

Verify & install

1. Download the asset for your platform and SHA256SUMS.
2. Verify: shasum -a 256 token-usage-darwin-arm64 (Windows: certutil -hashfile token-usage-windows-amd64.exe SHA256).
3. Make it executable (macOS/Linux) and run ./token-usage version.

---

token-usage v0.1.0-rc.2（中文说明）

提示： 本版本为预发布（v0.1.0-rc.2），仅供测试；稳定版发布前行为可能调整。

变更

• 新增一行安装脚本（scripts/install.sh），自动检测平台并做 SHA256 校验
• 安装指南重排：官方 Release 二进制成为推荐方式，含可直接复制给 AI Agent 的安装指令

资产

• token-usage-darwin-arm64 — macOS（Apple 芯片）
• token-usage-darwin-amd64 — macOS（Intel）
• token-usage-windows-amd64.exe — Windows

校验与安装

1. 下载与你平台匹配的资产以及 SHA256SUMS。
2. 校验：shasum -a 256 token-usage-darwin-arm64（Windows：certutil -hashfile token-usage-windows-amd64.exe SHA256）。
3. 赋予执行权限（macOS/Linux）并运行 ./token-usage version。