# CodexQuota

**Repository Path**: chazzorg/codex-quota

## Basic Information

- **Project Name**: CodexQuota
- **Description**: 一个原生、零第三方依赖的 Codex 额度菜单栏与悬浮面板。支持长条额度完整面板、横向极简悬浮模式、5 小时/周额度、重置倒计时、手动与定时刷新、置顶和 Codex 路径选择。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-16
- **Last Updated**: 2026-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Codex Quota for macOS

一个原生、零第三方依赖的 Codex 额度菜单栏与悬浮面板。支持长条额度完整面板、横向极简悬浮模式、5 小时/周额度、重置倒计时、手动与定时刷新、置顶和 Codex 路径选择。

## 安全边界

- 不读取或保存 `auth.json`、Token、Keychain 和浏览器 Cookie。
- 只以 `read-only` / `untrusted` 参数启动本机 `codex app-server`。
- 不启动 HTTP 服务，不开放端口，不申请辅助功能或完全磁盘访问。
- 只保留格式化后的额度、重置时间和 Codex 路径；原始响应和错误不会写入日志。

## 构建与运行

要求 macOS 14+、Swift 6.2+。

```bash
cd /Users/zz/临时/codes/CodexQuota
./Scripts/check.sh
./Scripts/package_app.sh
open dist/CodexQuota.app
```

首次运行会自动查找常见位置的 `codex`。如果未找到，从菜单栏选择“选择 Codex…”。

## 当前范围

- 已实现：菜单栏、长条额度完整面板、优先展示 5 小时额度的横向悬浮模式、动态额度环、重置倒计时、置顶、5 分钟刷新、手动选择 Codex。
- 暂未实现：开机启动、WidgetKit、自动更新、Developer ID 签名与公证。