Codex 用量 · 文档

外观

验证与兼容性 ​

当前正式下载为 Windows 与 macOS v1.0.2。不同检查证明不同范围：构建和离屏图不能替代系统通知与真实鼠标操作；macOS 签名完整性不等于 Apple 公证，Rosetta 执行不等于所有实体 Intel Mac 通过。

macOS v1.0.2 的验证边界 ​

本轮在 Apple Silicon 上验证共享后端和原生逻辑，分别构建 arm64、x86_64 包，核对架构、嵌套签名、固定运行时以及 App 与 ZIP 源码摘要。用户已确认收起按钮与圆环重叠的修复、接缝贴合隐藏和持续跨屏拖动正常；系统通知横幅已观察到。

系统通知正文点击与冷启动跳转、实体 Intel、完整拔屏／Spaces／休眠路径尚未全部实机验收。发布不把这些缺口改写为通过；本轮无整机功耗收益百分比。源码和发布检查结果见 macOS 发行说明及关联 PR / CI。

Windows v1.0.2 的验证边界 ​

Windows 开发与交互验证在 Windows 11 x64 上进行。自动化检查使用合成用量、预算、任务与独立配置，覆盖以下范围：

  • 统计查询、筛选与导出；预算周期、草稿保存和错误恢复。
  • 主面板、浮窗、托盘详情的深浅主题、文字边界和键盘操作。
  • 圆环形变、整框拖动、贴边恢复、离开收起和菜单焦点返回。
  • 任务事件判定、订阅与未读分离、通知路由及重启去重。
  • 进程退出、独立主面板清理，以及发行包的运行组件和解包后源码检查。

合成多屏矩形可验证几何规则，不能代表每一种真实显示器与缩放组合。后台模式会明确跳过可见菜单、焦点等前台检查，跳过不算通过。任务通知的系统提交、通知中心保存、横幅显示与用户点击是不同结果，Windows 勿扰和前台状态仍可能限制实际显示。

正式资产和说明见 Windows v1.0.2 发行页。具体源码阶段记录和验证命令见Windows 工程文档。历史测试数量和某次预览结果不自动代表后来发行包已重新通过同一套实机检查。

本页不承诺所有 Windows 版本、ARM64 环境、全部多屏组合、组织限制下的通知或固定内存上限。Windows 工作集、私有内存与下文 macOS 的 physical footprint 不可直接横向比较。

macOS 已发布版本与历史记录 ​

macOS 下载已更新为 v1.0.2。下方保留 v1.0.0、v1.0.1 及安装助手开发阶段记录；结果只适用于注明的版本与环境，不替代新包验证。旧版打包记录见固定版本文档。

v1.0.0 正式发行记录 ​

来源：v1.0.0 基线 53c9cf4 的完整验证文档。环境为 Apple Silicon/macOS 26.5，运行组件 CPython 3.12.14。

  • 完整测试 160 项：158 项通过，2 项按平台跳过，耗时 40.909 秒。
  • 两种架构发行包均检查架构、嵌套签名、归档内容及固定运行组件摘要。
  • 在空临时目录检查正式 App 的宿主和嵌套主面板离线组件初始化，未打开 GUI 或读取个人聊天记录。
  • 本机已验收菜单栏定位与关闭、圆形浮窗鼠标行为、独立筛选、主题切换、图表悬停及独立窗口生命周期。

测试中包含抽取方法后编译执行与离屏 AppKit 检查；这些不能替代所有系统上的完整端到端操作。

Intel 启动反馈与安装助手验证 ​

一个实体 Intel/macOS 15.7.9 用户报告：原始 v1.0.0 的 x86_64 架构、执行权限、签名完整性均通过；隔离属性处理后可以启动。该反馈只证明这个案例的启动恢复，未覆盖任意 Intel 机型与全部功能。

PR #1 已于 2026-09-11 合并到 main，合并提交为 d6a9407。安装脚本与原验证提交 99c881d 的内容相同；以下是该验证提交完成的检查，并非合并后重新进行了一轮实机验收：

  • 新增 19 项安装器行为测试全通过；该分支完整测试 179 项，177 项通过，2 项 Windows 专用测试跳过，53.873 秒。
  • Apple Silicon/macOS 26.5 上，实际从 GitHub 在线下载安装 Apple Silicon 包；模拟 Intel 硬件识别后，使用原始 Intel ZIP 离线安装。
  • 两种架构安装后的宿主和嵌套主面板分别运行 --check-runtime，四次均退出 0；Python、SSL、SQLite 导入通过，Intel 执行使用 Rosetta。
  • 实际 Rosetta 终端能正确选择 Apple Silicon 安装包；隔离处理仅影响临时安装副本，已有文件不被覆盖。

这套安装器还没有完成实体 Intel/macOS 15.7.9 的完整安装与交互验收。它减少安装步骤，没有为现有 App 增加 Apple 公证。

v1.0.1 额度弧线配色：开发阶段验证 — 2026-09-11 ​

以下结果针对配色源码提交 f92dcec，对应 PR #3，已随 v1.0.1 发布，未包含在 v1.0.0 下载包中。

  • 项目现有 python -E -s -B test.py：160 项，158 项通过，2 项平台限定跳过，耗时 41.360 秒。
  • 使用真实 CapsuleSurface 和固定演示数据生成深浅主题 100/75/50/25/10/5% 对照图，与确认稿逐字节一致。README 的 50% 示意图也从当前源码重新生成。
  • 本机一次性离屏检查：20,000 个额度采样颜色连续、分量有效；实际绘制检查覆盖色点、0%、未知、非有限值和越界额度；400 次主题切换保留原窗口与视图，未触发额度动画。这些专项检查与上面的 160 项测试分别计数。
  • Apple Silicon / Intel 通用构建及严格递归签名检查通过；本机安装后检查深浅主题、展开/收起和数据刷新。以上结果不代表实体 Intel Mac 验收。

配色的具体色值与边界见 架构说明，文档示意图的生成方式见 本地验证工具。此次文档补充检查图片、链接和配色表，沿用上述代码验证结果，不重新操作未改动功能。下方内存数据属于 v1.0.0 开发阶段的历史观察，不是这次配色更新的内存测量。

来源：PR #3 合并后的验证记录。这里保留该次开发阶段记录，不将其改写为 v1.0.1 发行包的新一轮实机验收。

v1.0.0 历史内存观察 ​

以下为正式发行文档记录的 physical footprint，单位 MiB；不是 ps 的 RSS。自动刷新关闭，额度查询仍可能临时启动进程。

场景时长无辅助进程时宿主中位数观察到的相关进程合计峰值
冷启动、收起浮窗20.04 秒13.3613.46¹
两次主面板开关并操作浮窗后，收起70.06 秒24.8384.97
随后切换到菜单栏70.09 秒25.8185.79

¹ 冷启动采样未捕获额度辅助进程，不能据此推断查询峰值。后两组 97.5% 的样本没有辅助进程。采样可能漏掉瞬时进程和峰值；结果依赖日志规模、交互历史及系统缓存。

开发期一次单 GUI 与独立主面板版本观察得到 54.85 MiB 和 24.83 MiB，但它不是固定数据集上的严格受控对照，不能解释为编程语言变化的单独收益。有限离屏主题压力测试也不能证明完整应用长期没有内存增长。完整过程及边界保留在源文档中。

尚未承诺的范围 ​

  • 所有 Intel 机型、全部 macOS 11 及之后版本，以及企业管理策略下的安装。
  • Developer ID 签名、Apple 公证、所有浏览器/传输渠道的首次下载体验。
  • 多日持续运行、任意规模历史记录，以及未来 Codex 日志或额度协议变化。
  • 任意状态、任意机器均低于 10 MB 的内存占用。

未来结果应记录明确版本、设备、操作步骤与测量口径，再更新本页。未完成的实机检查不使用单元测试或交叉编译结果代替。