Bantuan & maklumat

Sambungkan akaun anda.
Fahami bacaan anda.

Daripada akaun pertama anda hingga memahami bacaan yang disimpan, inilah cara AIUsageWatch berfungsi pada Mac anda.

Keperluan dan maklumat keluaran

AIUsageWatch ialah aplikasi bar menu natif percuma untuk macOS 14 atau lebih baharu. Keluaran awam sedang disediakan. Pautan muat turun yang disahkan akan ditambahkan pada laman web ini apabila tersedia. Akaun penyedia anda dan caj pelannya sendiri adalah berasingan.

Pindahkan aplikasi yang telah dikeluarkan ke Applications sebelum mengaktifkan Buka semasa log masuk. Aplikasi berada pada bar menu dan tidak memerlukan ikon Dock. Membuka aplikasi yang sedang berjalan daripada Finder membawa Keutamaan ke hadapan.

Sambungkan penyedia anda

Codex: pasang Codex CLI dan log masuk. Tetapkan akaun kepada direktori konfigurasinya, biasanya ~/.codex. Aplikasi menggunakan log masuk tersimpan bagi direktori itu melalui app-server CLI setempat.
Claude: akaun lalai ~/.claude menggunakan sesi Safari anda di claude.ai. Dalam Keutamaan, berikan akses kepada fail Cookies.binarycookies Safari. Untuk direktori konfigurasi Claude yang berasingan, log masuk dengan Claude Code menggunakan CLAUDE_CONFIG_DIR tersebut; aplikasi membaca .credentials.json.
Cursor: log masuk di cursor.com dalam Safari dan berikan akses kepada fail kuki Safari dalam Keutamaan. Cursor tidak menggunakan direktori akaun untuk bacaannya.
Grok: pilih direktori Grok yang mengandungi logs/unified.jsonl. Jalankan Grok untuk mengemas kini bacaan pengebilan dalam log itu.

Aplikasi membaca maklumat kuota yang tersedia bagi setiap sumber. Sumber CLI Claude dan Codex memerlukan log masuk tersimpan masing-masing. Pratonton laman web tidak pernah mengakses akaun anda.

Akaun peribadi dan kerja bersama

Buka Keutamaan… daripada menu, atau tekan ⌘,. Setiap akaun mempunyai label, penyedia, direktori, warna dan huruf. Gunakan + untuk menambah direktori; aplikasi meneka penyedia berdasarkan kandungannya. Semak penyedia sebelum menggunakan akaun baharu.

Untuk log masuk Codex lain, pilih CODEX_HOME yang berasingan. Untuk log masuk Claude lain, gunakan CLAUDE_CONFIG_DIR yang berasingan dengan bukti kelayakan tersimpannya sendiri. Sesi Safari Claude lalai boleh tidak jelas apabila mengandungi berbilang organisasi; gunakan direktori konfigurasi berasingan dalam keadaan itu. Pembaca Cursor menggunakan sesi Safari yang tersedia, jadi menambah baris Cursor pendua tidak menghasilkan log masuk bebas.

Lebih banyak akaun menambah lajur, dengan paling banyak tiga baris dalam setiap lajur. Huruf dan warna tersuai membantu mengenal pasti akaun. Tetapan umum merangkumi masa penyegaran, penanda peratus, huruf dan amaran bagi maklumat luput set semula kuota tersimpan Codex yang disokong.

Fahami bar

Bahagian terisi bermaksud baki kuota. Pada 0% berbaki, tiada bar terisi. Warna mengenal pasti akaun. Menu menunjukkan peratus, masa set semula yang tersedia, butiran tempoh yang berkaitan dan status bacaan.

Claude merangkumi butiran mingguan dan lima jam apabila tersedia; Codex memilih had mingguan utama. Cursor menggunakan angka penggunaan yang termasuk dalam pelannya sendiri, dengan muatan data yang tidak menyatakan tempoh penggunaan. Grok menggunakan angka kredit mingguan daripada log CLI. Peratus daripada penyedia yang berbeza tidak bersamaan dengan bilangan token, prom atau dolar yang sama.

Kenal pasti set semula kuota tersimpan Codex sebelum luput

Apabila Codex melaporkan set semula kuota tersimpan yang tersedia dan tarikh luputnya, AIUsageWatch boleh menunjukkan titik amaran di sebelah akaun sebelum set semula kuota tersimpan seterusnya luput. Buka menu untuk melihat bilangan yang tersedia dan maklumat luput. Set semula kuota tersimpan yang tidak digunakan boleh hilang apabila luput; ini berasingan daripada masa biasa kuota mingguan anda diset semula.

Aktifkan Amaran sebelum set semula dalam Keutamaan dan pilih 1–14 hari lebih awal. Nilai lalai ialah dua hari, dengan titik amaran merah; anda boleh menukar warnanya. Titik kekal kelihatan apabila huruf akaun dimatikan. Amaran bergantung pada aplikasi yang sedang berjalan, amaran yang diaktifkan dan data luput yang tersedia serta terkini. Aplikasi tidak menggunakan set semula kuota tersimpan secara automatik atau menghantar pemberitahuan sistem.

Permintaan pemula automatik Codex

Apabila bacaan mingguan langsung Codex menunjukkan 100% berbaki, AIUsageWatch menghantar satu permintaan kecil codex exec menggunakan log masuk CLI tersimpan bagi direktori itu. Tujuannya ialah memulakan tempoh mingguan yang mungkin belum bermula. Permintaan ini menggunakan model lalai Codex yang tersedia dan menggunakan sedikit kuota akaun itu.

Titik merah menandakan akaun semasa permintaan sedang berjalan atau jika permintaan gagal. Menu menjelaskan status dan menyediakan percubaan semula secara manual. Aplikasi mengingati percubaan dalam memori untuk tempoh mingguan itu. Semakan berulang tidak menghantar lebih banyak permintaan bagi percubaan yang diingati tersebut; melancarkan semula aplikasi mengosongkan memori dan mungkin menghasilkan permintaan lain jika bacaan langsung masih 100%.

Sumber sandaran transkrip terdahulu tidak menghantar permintaan pemula. Permintaan pemula automatik Claude tidak diaktifkan dalam binaan semasa. Ini berasingan daripada membaca penggunaan, dan keutamaan semasa tidak menyediakan suis permintaan pemula Codex.

Angka sudah lama, tiada atau tidak dijangka

Bacaan yang disimpan: bacaan sah yang terakhir dicache pada Mac anda dan dipulihkan semasa pelancaran. Menu menyatakan usia bacaan apabila penyegaran gagal.
Had kadar atau kegagalan sambungan: percubaan semula ditangguhkan selama 15 minit selepas had kadar dan 2 minit selepas ralat lain. Segar semula sekarang memintas tempoh tangguh itu.
Sambungan Safari: semak bahawa penyedia yang betul telah log masuk, semak kebenaran akses fail kuki dan pastikan sesi itu jelas.
Grok: jalankan CLI untuk merekodkan bacaan penggunaan baharu. Tempoh yang telah tamat atau log lama ditunjukkan sebagai bacaan terdahulu dan bukannya baki langsung.
Codex: pastikan CLI tersedia dan direktori yang dikonfigurasi mempunyai log masuk yang dikehendaki. Sumber sandaran transkrip mungkin menunjukkan maklumat lama jika app-server tidak tersedia.

Titik akhir dan muatan data penyedia boleh berubah. Bacaan tidak menjamin bahawa penyedia akan menerima permintaan seterusnya. Semak halaman akaun penyedia sendiri apabila baki atau set semula kelihatan salah.

Tetapan setempat dan sambungan penyedia

Keutamaan dan bacaan cache disimpan dalam ~/Library/Application Support/AiUsageWatch/. Aplikasi tidak membaca Keychain secara langsung. CLI penyedia mengendalikan cara log masuk masing-masing. Pembaca langsung menghubungi penyedia yang berkaitan menggunakan sesi atau bukti kelayakan sedia ada. Baca dasar privasi untuk memahami perbezaan antara storan aplikasi setempat, sambungan penyedia dan mesej sokongan.

Laporkan masalah

Hubungi sokongan AIUsageWatch dengan versi aplikasi, versi macOS, penyedia, status bacaan dan langkah untuk menghasilkan semula masalah. Jika anda menggunakan mod diagnostik --dump tersebut, semak outputnya sebelum menghantarnya. Buang token, nilai kuki, laluan akaun peribadi dan sebarang maklumat sensitif lain. Jangan muat naik fail bukti kelayakan.