Split days by local time zone, fix collector deadlock and secret exposure

.github/workflows/ci.yml

@@ -8,6 +8,9 @@ on:
 jobs:
   build:
     runs-on: macos-15
+    env:
+      # Test fixtures encode day boundaries in this zone.
+      TOKENSTEP_TIMEZONE: Asia/Shanghai
     steps:
       - uses: actions/checkout@v4
       - name: Check release safety contract
@@ -20,5 +23,11 @@ jobs:
         run: ./script/test_codex_cumulative_collector.sh
       - name: Run accounting migration checks
         run: ./script/test_usage_recalibration_migration.sh
+      - name: Run time zone collector checks
+        run: ./script/test_time_zone_collector.sh
+      - name: Run Claude incremental collector checks
+        run: ./script/test_claude_incremental_collector.sh
+      - name: Run settings Codable checks
+        run: ./script/test_settings_codable.sh
       - name: Build TokenStep
         run: ./script/build_swiftui_and_run.sh --no-launch

.gitignore

@@ -2,14 +2,15 @@
 __pycache__/
 *.pyc
 
-logs/
-data/
-dashboard.html
-config/settings.json
-config/autostart-default-applied
+# Runtime output of the legacy Python prototype (see legacy/README.md).
+legacy/logs/
+legacy/data/
+legacy/dashboard.html
+legacy/config/settings.json
+legacy/config/autostart-default-applied
+legacy/TokenUsageMenuApp/dist/
 
 TokenStepSwift/.build/
 TokenStepSwift/dist/
-TokenUsageMenuApp/dist/
 release/
 docs/validation/

CHANGELOG.md

@@ -0,0 +1,131 @@
+# 更新日志
+
+TokenStep 各版本的更新内容，新版本在前。每个版本的完整说明在 [docs/RELEASE_NOTES_<版本号>.md](docs/)。
+
+## 0.2.15 更新：按本地时区统计，采集更稳更省电
+
+每天的用量改为按 Mac 的系统时区切分，更换时区后自动重新统计；修复 Codex 从本地数据库回退统计时可能卡住的问题；Claude Code 长会话只读取新增内容，读取本地数据库不再启动额外进程；设置中填写的密钥不再出现在进程列表里；隐私页列出每一个联网请求。详见 [0.2.15 发布说明](docs/RELEASE_NOTES_0.2.15.md)。
+
+## 0.2.14 更新：恢复 AgentWork 榜单关联
+
+兼容 Token Rank 新版状态文件中的账号信息，同时保留旧版格式支持。已绑定的用户升级后可重新识别身份，无需删除状态文件或重新绑定。详见 [0.2.14 发布说明](docs/RELEASE_NOTES_0.2.14.md)。
+
+## 0.2.13 更新：修复自动更新的 Apple 公证门禁
+
+0.2.13 修复了 0.2.12 因发布包遗漏 Apple 公证票据而无法自动安装的问题。新版已经过 Developer ID 签名、Apple 公证、App/DMG 票据装订、macOS 分发策略检查和隔离更新安装验证；不需要关闭 Gatekeeper 或更改系统安全设置。发布流程也改为“先草稿上传、回下载验收，再公开”，未公证产物无法进入公开 Release。完整说明见 [0.2.13 发布说明](docs/RELEASE_NOTES_0.2.13.md)。
+
+## 0.2.12 更新：找回特洛伊火海的火焰动效
+
+0.2.12 找回了 0.2.11 中意外丢失的「特洛伊火海」火焰动效：火焰 shader 改由场景更新循环驱动的自定义时钟供能，不再依赖在常驻渲染架构下会冻结的内置时间变量。火焰在每次打开浮层时持续燃烧，多次开关后依然保持动画，0.2.11 修复的开浮层闪烁不会回归。完整说明见 [0.2.12 发布说明](docs/RELEASE_NOTES_0.2.12.md)。
+
+## 0.2.11 更新：修复特洛伊火海浮层闪烁
+
+0.2.11 修复了奥德赛「特洛伊火海」篇章打开菜单栏浮层时偶发的一帧闪烁。动态渲染层现在常驻并随窗口可见性暂停、恢复，不再在点击浮层后临时插入；截图稳定性、省电暂停以及其他主题行为保持不变。完整说明见 [0.2.11 发布说明](docs/RELEASE_NOTES_0.2.11.md)。
+
+## 0.2.10 更新：坠入黑洞的运镜方向
+
+0.2.10 修正了坠落模式的逼近方向：膨胀锚点从画面中部移到**黑洞本体**（左上视界阴影处），让黑洞成为整个画面的放射原点——所有元素从它向外流走，右侧弧线不断放大、冲出画面右缘，弧顶顺流右移，读起来就是"视角正在被吸进去"，而不是画面整体向上顶。
+
+<p align="center">
+  <img src="docs/images/tokenstep-0.2.10-motion-lab-plunge.gif" alt="TokenStep 0.2.10 坠落模式：视角被吸向黑洞" width="900" />
+</p>
+
+速度与强度维持 0.2.9 的节奏（9 秒吞没、亮度渐强 +16%），帧差指标进一步提升：前 3 秒全画面 31.5%、全程 69.1% 的像素发生明显变化。其余模式、主题与数据口径不变。完整说明见 [0.2.10 发布说明](docs/RELEASE_NOTES_0.2.10.md)。
+
+## 0.2.9 重大更新：引力动效实验室
+
+0.2.9 给「引力边界」主题装上了真正的引力动效。黑洞不再是一张静态壁纸：打开浮层或仪表盘的瞬间，你就在朝它坠落。
+
+<p align="center">
+  <img src="docs/images/tokenstep-0.2.9-motion-lab-plunge.gif" alt="TokenStep 0.2.9 坠落模式：黑洞向你压来" width="900" />
+</p>
+
+- **三档签名动效，浮层右上角随时切换**：静谧（只剩环境光呼吸）、轨道（白热等离子光斑拖着彗尾沿吸积盘弧线绕行，星尘坠落）、坠落（黑洞以自身为中心原地膨胀、越来越亮，9 秒内把你吞进去后悬置）。
+- **Token 坠落脉冲**：坠落模式下，今日 Token 增长或点击浮层波形按钮，会从视界方向涌出一圈进食波。
+- **每次打开都是一次新的坠落**：浮层关闭即复位，重新打开从头开始逼近；窗口失焦、被遮挡时动效自动暂停省电。
+- **低成本有底线**：最高 24 fps；低电量模式降到 12 fps 并冻结逼近；截图和 macOS「减少动态效果」下保持完全静态；所有动效由纯函数采样驱动，可用固定时间离线渲染逐帧校验。
+- **可感但克制**：静谧档保持接近静态的呼吸；轨道档持续有可察觉的流动；只有坠落档全力逼近。
+
+<p align="center">
+  <img src="docs/images/tokenstep-0.2.9-motion-lab-orbit.gif" alt="TokenStep 0.2.9 轨道模式：等离子光斑绕行" width="900" />
+</p>
+
+本次不改变 Token、金额、额度、排行榜及本地采集口径，经典与奥德赛主题不受影响。完整说明见 [0.2.9 发布说明](docs/RELEASE_NOTES_0.2.9.md)。
+
+## 0.2.8 更新：引力边界图标精修
+
+0.2.8 精修了「设置 → 通用 → 主题皮肤包」中的引力边界预览图标：黑洞、吸积盘和上下引力透镜弧重新居中并收进图标安全区，同时增加圆角裁切，修复图形穿出卡片边界的问题。
+
+本次只调整主题选择图标，不改变首页、浮层和其他界面的黑洞主视觉，也不改变 Token、金额、额度、排行榜及本地采集口径。完整说明见 [0.2.8 发布说明](docs/RELEASE_NOTES_0.2.8.md)。
+
+## 0.2.7 重大更新：引力边界黑洞主题包
+
+0.2.7 新增第三套完整皮肤包「引力边界」。它不是给首页换一张壁纸，而是把近距事件视界、象牙白吸积盘和低速引力光流接进 TokenStep 的整套界面。
+
+<p align="center">
+  <img src="docs/images/tokenstep-0.2.7-event-horizon-popover.jpg" alt="TokenStep 0.2.7 引力边界黑洞主题包浮层" width="900" />
+</p>
+
+- **第三套主题皮肤包**：在 `设置 → 通用 → 主题皮肤包` 中，可在经典、奥德赛和引力边界之间随时切换。
+- **黑洞是第一视觉层**：巨大事件视界占据左上，象牙白吸积盘横贯界面，并保留上方透镜弧和更暗的下方反转弧。
+- **全界面统一换肤**：菜单栏浮层、今日、历史、隐私、设置、更新窗口、Token Island 和两类分享卡全部覆盖。
+- **低成本动态光流**：吸积盘有缓慢相位漂移和轻微呼吸；窗口失焦、截图和 macOS“减少动态效果”状态会自动暂停，最高 24 fps。
+- **原创应用内标记**：主题启用时，TokenStep 的应用内 Logo 会切换为事件视界与吸积盘标记。
+- **更新检查更稳**：GitHub API 被限流时自动使用非 API 的最新 Release 通道；手动检查增加 10 秒防连点，并在双通道都失败时显示可理解的限流恢复时间。
+
+主题使用原创生成背景和通用黑洞科学结构，不包含电影 Logo、演员、剧照、飞船或第三方水印。完整说明见 [0.2.7 发布说明](docs/RELEASE_NOTES_0.2.7.md) 与 [引力边界主题实现说明](docs/INTERSTELLAR_THEME_PACK_0.2.7.md)。
+
+## 0.2.6 重大更新：检查更新后立即进入安装闭环
+
+0.2.6 修复了从浮层主动检查更新时“查到了，但没有继续弹出更新窗口”的断点，并把下载、验证、替换与自动重启做成可追踪的完整链路。
+
+- **发现新版立即弹窗**：点击浮层或主窗口的更新按钮后，若检测到新版，会立刻打开独立更新窗口。
+- **更新窗口确保可见**：菜单栏瞬时浮层自动收起，更新窗口切到当前桌面并保持在前台，不再被浮层遮住。
+- **一次点击完成升级**：点击“安装并重启”后自动下载 DMG、校验签名、公证与版本，备份旧 App、替换 `/Applications/TokenStep.app` 并重新打开。
+- **全过程可诊断**：检查、弹窗、安装启动和失败都会写入生命周期日志；新增隔离安装验证脚本，避免把“能下载”等同于“能升级”。
+- **不改变自动检查策略**：后台检查仍采用非打扰提醒；只有用户主动点击检查并发现新版时才强制弹出窗口。
+
+本次不改变 Token、金额、额度、排行榜及本地采集口径。完整说明见 [0.2.6 发布说明](docs/RELEASE_NOTES_0.2.6.md)。
+
+## 0.2.5 重大更新：动态特洛伊火焰、模型用量与更新提醒
+
+0.2.5 让奥德赛主题从静态电影画面进入动态状态，同时把菜单栏浮层和更新体验补得更完整。
+
+- **特洛伊火焰动起来了**：特洛伊火海篇章会在浮层可见时呈现火焰明暗、烟雾、火星和余烬；关闭浮层后立即暂停，截图仍保持稳定静态画面。
+- **浮层增加今日模型用量**：在 Agent 来源下方展示今日模型；模型较多时自动整理为 Top 3 +「其他」，不改变统计口径。
+- **更新入口覆盖整个 App**：菜单栏浮层、主窗口和设置共用同一套检查状态；启动、定时和回到前台时可自动检查新版。
+- **更新提醒更明确**：发现新版后，菜单栏出现标记，浮层和主窗口显示更新卡；仍由用户确认后安装，不做静默强制更新。
+- **修复检查动画不停止**：检查完成后立即显示结果，不再残留一直旋转的图标。
+
+经典主题、其他奥德赛篇章、Token/金额/额度/排行榜口径及本地优先原则保持不变。完整说明见 [0.2.5 发布说明](docs/RELEASE_NOTES_0.2.5.md)。
+
+## 0.2.4 重大更新：奥德赛主题包
+
+TokenStep 第一次从“更换配色”升级为完整的**主题皮肤包系统**。你可以继续使用熟悉的经典界面，也可以切换到更有电影质感的奥德赛主题；数据、统计口径与本地优先原则保持不变。
+
+<p align="center">
+  <img src="docs/images/tokenstep-0.2.4-odyssey-theme-pack.jpg" alt="TokenStep 0.2.4 奥德赛主题包四个视觉篇章" width="900" />
+</p>
+
+### 两套皮肤包，随时切换
+
+- **经典**：保留青绿、海蓝、紫藤、琥珀和石墨五种原版配色。
+- **奥德赛**：新增导演剪辑、爱琴海冷雾、特洛伊火海和灰烬神像四个视觉篇章。
+- TokenStep 会分别记住你上次使用的经典配色和奥德赛篇章，来回切换不用重新设置。
+
+| 视觉篇章 | 核心元素 |
+| --- | --- |
+| 导演剪辑 | 根据不同界面自动组合冷雾头盔、特洛伊木马与灰烬神像 |
+| 爱琴海冷雾 | 深海、冷雾、青铜头盔与竖向骨节冠 |
+| 特洛伊火海 | 焦黑木马、火焰背光、烟尘与余烬 |
+| 灰烬神像 | 破损大理石战士、裂纹、玄武岩与希腊回纹 |
+
+### 不只是换一张背景图
+
+- 菜单栏浮层重构为“今日用量 / Agent 用量 / 订阅额度”三段式电影构图。
+- Agent 消耗榜收为底部横向信息带，不再形成第五列或把浮层横向撑宽。
+- Today、历史、隐私、设置、更新窗口、分享卡与 Token Island 全面换肤。
+- 新增奥德赛弓箭阶梯 Logo；用量采用骨金、冷金或余烬橙，绿色只保留给同步成功等状态反馈。
+- 关闭排行榜后浮层会自动收短，多来源额度则使用紧凑布局完整展示。
+
+打开 `设置 → 通用 → 主题皮肤包` 即可切换。完整说明见 [0.2.4 发布说明](docs/RELEASE_NOTES_0.2.4.md)，或直接[下载已签名并通过 Apple 公证的最新版](https://github.com/Backtthefuture/TokenStep/releases/latest/download/TokenStep-0.2.14.dmg)。