# QuotaDock
[English](./README.md) | [한국어](./README.ko-KR.md) | [简体中文](./README.zh-CN.md) | [繁體中文（臺灣）](./README.zh-TW.md) | [日本語](./README.ja-JP.md)
QuotaDock 是一款常駐最上層的輕巧 Windows 桌面小工具，讓你一眼掌握 **Claude、OpenAI Codex 與
Google Antigravity** 的用量額度 —— 工作階段/每週配額，以及重設倒數。
[](https://github.com/jungdosa/QuotaDock/releases)
[](LICENSE)
[](https://go.dev/)
[](https://fyne.io/)
[](#支援平台)
使用 Claude Code、Codex CLI 與 Antigravity IDE 時，你總是在問同樣的問題：*5 小時的工作階段還剩多少？
每週上限什麼時候重設？* QuotaDock 幫你盯著，不必再一個個開儀表板查看。
| 服務供應商 | 顯示內容 | 連線方式 |
|---|---|---|
| **Claude**（Claude Code） | 5 小時工作階段 · 7 天每週 · Fable 每週 | 使用 Claude Code 既有的 OAuth 認證資訊（認證檔案或環境變數）；無須在應用程式內貼上，也不擷取瀏覽器 Cookie |
| **OpenAI Codex** | 工作階段 · 每週上限 | 官方 Codex CLI app-server（stdio JSONL） |
| **Google Antigravity** | Gemini 與 Claude/GPT 群組的工作階段 · 每週 | Antigravity CLI 唯讀用量報告；CLI 無法使用時使用本機語言伺服器（loopback） |
即使其中一個供應商連線失敗，其餘仍照常運作。每一列都會在**分段長條（已用量）**下方繪製一條
**細長連續長條（距離重設的剩餘時間）**，讓你一眼判斷額度是否消耗得比時間更快。超過警告或危險
門檻值時，長條與數值會切換成警示色。
## 檢視模式
三種小工具檢視外加設定畫面。工具列按鈕會依 `一般 → 精簡 → 迷你` 循環切換，迷你檢視只要點一下
即可回到精簡檢視。
### 一般 —— 資訊最完整
依供應商分組，顯示方案標章、用量長條與重設長條、倒數計時與重設時刻。
### 精簡 —— 每列一行
較窄的檢視，百分比旁邊直接顯示距離重設的剩餘時間。將滑鼠停留在時間上會出現精確重設時刻的
提示訊息。
### 迷你 —— 極小長條
每個供應商佔一格，高度約 78px，適合固定在螢幕角落。滑鼠停留在某一列時會顯示三行提示：
`供應商 · 區間 / 剩餘時間 / 重設時刻`。
## 功能
- **淺色 · 深色 · 跟隨系統佈景主題**，12/24 小時日期格式，各供應商可個別配色，警告門檻值可調整
- **十二種語言** —— 英文、韓文、德文、法文、義大利文、印尼文、葡萄牙文（巴西）、
西班牙文（西班牙/拉丁美洲）、日文、簡體中文、繁體中文（臺灣）。選擇 `系統` 則跟隨 Windows 顯示語言
- **連線方式按鈕** —— 每個供應商列都會顯示它透過哪種方式（`CLI`、`Auth`、`IDE`）連線及目前狀態。
若缺少對應的 CLI，點一下按鈕就會在卡片內展開安裝說明
- **內建更新** —— 啟動時檢查一次 GitHub Releases，也可隨時手動檢查。下載的檔案會與發行資產的
SHA-256 比對**兩次**：下載完成後一次，執行安裝程式前再一次。不做定期輪詢，也不送出任何認證資訊
- **釘選到工作列（Windows 11）** —— 讓系統匣圖示不會被收進溢位區域
## 安裝
最快的方式是使用 Windows 套件管理員：
```powershell
winget install jungdosa.QuotaDock
```
請至 [**Releases**](https://github.com/jungdosa/QuotaDock/releases) 下載。
| 檔案 | 用途 |
|---|---|
| `QuotaDock-<版本>-win-x64-Setup.exe` | 安裝版 —— 建立開始功能表項目，可選擇開機時啟動 |
| `QuotaDock-<版本>-win-x64-portable.exe` | 免安裝單一執行檔 |
執行檔未經程式碼簽署，SmartScreen 可能會出現警告。請用 `SHA256SUMS.txt` 驗證完整性。
不需要任何設定 —— QuotaDock 會自動尋找你已登入的官方 CLI 與 IDE 並連線。
> 目前版本請查看本頁頂端的**發行徽章**以及
> [Releases](https://github.com/jungdosa/QuotaDock/releases) 頁面。完成 Windows 功能驗證後將提升為 `1.0.0`。
## 初次執行
沒有設定精靈，沒有登入畫面，也不需要貼上任何東西。
1. 啟動 **QuotaDock**，它會以常駐最上層的小視窗出現。
2. 它會自動尋找你已經在用的官方工具並連線 —— Claude Code CLI、Codex CLI 與 Antigravity IDE。
3. 已登入的供應商會在幾秒內開始顯示用量。
若某一列提示缺少 CLI，請開啟 **設定 → 連線**，點一下該供應商的 `CLI` 按鈕。安裝說明會直接在
卡片內展開 —— 要執行的指令、如何登入，以及 QuotaDock 的搜尋路徑。裝好後按 `重新搜尋` 即可，
不必重新啟動。
### 連線 Claude 的三種方式
QuotaDock 最多可並排顯示五個 Claude 帳號。在 **設定 → 連線** 的最後一張 Claude 卡片按 `+` 新增帳號，
按 `−` 移除最後一個；每個帳號都有自己的顯示名稱與顏色。每張 Claude 卡片上有三個連線方式按鈕，每個帳號選一種。
| 方式 | 讀取什麼 | 適用情境 |
|---|---|---|
| `CLI` | 這台電腦的 Claude Code 已保存的憑證 | 你在這台電腦上使用 Claude Code。CLI 只保存一個登入，所以**只能一個帳號**。 |
| `Auth` | 在 QuotaDock 自帶的瀏覽器視窗完成的 Claude 登入 | 第二個帳號，或沒有 Claude Code 的電腦。 |
| `其他` | 環境變數 `CLAUDE_CODE_OAUTH_TOKEN` | 你自己管理的長期權杖 —— 例如透過 SSH 登入的機器。 |
`其他` 沒有貼上欄位 —— 這是刻意的，QuotaDock 從不要求你輸入權杖。使用步驟：
1. 在終端機執行 `claude setup-token` 並依提示操作，會輸出一個長期權杖（需要 Claude 訂閱）。
2. 把它存為名為 `CLAUDE_CODE_OAUTH_TOKEN` 的**使用者環境變數**
（Windows：*設定 → 系統 → 關於 → 進階系統設定 → 環境變數*）。
3. 重新啟動 QuotaDock —— 環境變數在程式啟動時讀取 —— 然後按 Claude 卡片上的 `其他`。
卡片會顯示該變數已設定。
這個變數對你執行的任何程式都可見，請像對待密碼一樣對待它：不要寫進共用的指令碼，外洩後請到
Anthropic 帳號撤銷。
日常使用：
- 工具列按鈕依 `一般 → 精簡 → 迷你` 循環，迷你檢視點一下就回到精簡檢視。
- `✕` 是收進系統匣而不是結束程式。要結束請從系統匣選單操作。
- 拖曳標題列即可移動視窗，位置會在下次啟動時保留。
## 隱私
QuotaDock **使用官方工具已經建立的認證狀態**。它不要求你貼上機密資訊，不擷取瀏覽器 Cookie，
不做網頁抓取，不傳送遙測，也不產生計費的 AI 請求。
- **使用既有登入，而非蒐集認證資訊。** 對 Claude，QuotaDock 會從本機認證檔案或環境變數讀取
Claude Code 的 OAuth 認證資訊；當檔案型認證資訊需要續期時，會將 refresh token 傳送至
Anthropic 的權杖端點並以原子方式更新該檔案，接著將 access token 傳送至 Anthropic 的用量端點，並每六小時傳送至其個人資料端點以讀取目前方案等級。
Codex 用量透過 stdio 與官方 Codex CLI 的 app-server 溝通，Antigravity 用量來自經驗證的
`127.0.0.1` 語言伺服器（當 Antigravity CLI 無法使用時）。優先使用已登入 Antigravity CLI 的唯讀用量報告
（`agy -p "/usage" --output-format json`，最多每五分鐘一次），此報告不會啟動代理回合，也不消耗配額；
CLI 未安裝或未登入時才讀取上述語言伺服器。若收到無法確認為唯讀的報告，本次工作階段內將不再使用 CLI 路徑。沒有輸入認證資訊的欄位，不擷取瀏覽器 Cookie，沒有瀏覽器自動化，
也沒有非官方網頁抓取。
- **機密不會進入介面與記錄。** 權杖、Cookie 與認證檔案原文既不會繪製到介面，也不會寫入記錄。
傳給介面的只有正規化後的用量比例、經允許清單驗證的方案標籤，以及重設時刻。
- **診斷記錄只保留在本機。** 正常使用時會將小型且有大小上限的 JSON 診斷記錄寫入
`%LOCALAPPDATA%\QuotaDock\quotadock.log`。異常結束時，同一資料夾還可能留下 `crash.log`。
密鑰與電子郵件位址會在寫入前遮蔽，兩份記錄都不會傳送到任何地方。
- **對外連線僅限一份簡短的允許清單。** 供應商請求只能連往 `api.anthropic.com`、
`platform.claude.com` 與 `grok.com`；內建登入視窗只能開啟 `claude.ai`、`anthropic.com`、
`grok.com` 與 `x.ai` 的頁面，其用量讀取只能連往 `claude.ai` 與 `grok.com`；QuotaDock 啟動的官方
Codex 與 Antigravity CLI 會連線至各自的服務；更新檢查只能連往 `api.github.com` 與 GitHub 的發行主機，且不夾帶任何
認證資訊。其餘全部是回送連線。沒有遙測、沒有分析，也沒有當機回報。
- **設定屬於你。** 設定存放在 `%APPDATA%\QuotaDock\settings.json`，解除安裝後仍會保留，也不會
同步到任何地方。
- **不產生計費請求。** 更新用量絕不會消耗你的額度或點數。
## 設計原則
- **不打擾。** 只要官方工具已安裝並登入，它就會自動連線。沒有首次啟動的登入精靈，也沒有強制彈出視窗。
- **不碰機密資訊。** 權杖、Cookie 與 `auth.json` 原文不會進入介面或記錄檔。傳給介面的只有正規化後的
用量比例、經允許清單驗證的方案標籤，以及重設時刻。
- **只連本機。** 沒有遙測，也沒有外部分析伺服器。loopback 連線僅允許連往已驗證的處理程序與固定端點。
對外請求僅限上述允許清單；更新檢查不夾帶任何認證資訊，且只在啟動時或你點選時發生。
- **不消耗額度。** 更新用量絕不會送出需要計費的 AI 請求。
- **夠輕巧。** Go + Fyne 原生繪製，閒置時 CPU 佔用為 0%，記憶體也主動管理。
## 支援平台
| 優先順序 | 平台 | 狀態 |
|---|---|---|
| 第一 | Windows 10 22H2+ / 11, x64 | **可用**（0.7.x） |
| 第二 | macOS 14+, Apple Silicon | 規劃中 |
## 從原始碼建置
Fyne 使用 CGO，因此光有 Go 無法完成建置。
- Go 1.26 以上
- C 編譯器（Windows：MinGW-w64 / macOS：Xcode Command Line Tools）
```sh
git clone https://github.com/jungdosa/QuotaDock.git
cd QuotaDock
go build ./cmd/quotadock
```
發行產物（Setup.exe、portable、SHA256SUMS）由 `build/windows/build-release.ps1` 產生。
## 授權條款
MIT —— 請參閱 [LICENSE](LICENSE)。
QuotaDock 的原始碼、文案、畫面設計與應用程式圖示皆為原創。後續工作規劃記錄於
[docs/REMAINING-WORK.md](docs/REMAINING-WORK.md)。
### 第三方資源
| 資源 | 來源 | 授權 |
|---|---|---|
| `assets/fonts/Pretendard-*.ttf` | [Pretendard](https://github.com/orioncactus/pretendard) | SIL OFL 1.1 —— [`Pretendard-OFL.txt`](assets/fonts/Pretendard-OFL.txt) |
| `assets/providers/*.svg` | [lobe-icons](https://github.com/lobehub/lobe-icons) | MIT —— [`LICENSE-lobe-icons.txt`](assets/providers/LICENSE-lobe-icons.txt) |
供應商標誌為各自所有者（Anthropic、OpenAI、Google）的商標，此處僅用於識別 QuotaDock 所顯示
用量的對應服務。
---
keywords: Claude 用量監控 · Claude Code 速率限制 · OpenAI Codex 配額 · Gemini
Antigravity 用量 · AI 配額追蹤 · 桌面小工具 · 系統匣 · Windows · Go · Fyne