فرصت مطالعه ندارید؟ چکیده این مطلب را همین‌جا گوش دهید:
مدیریت مصرف توکن و هزینه‌های سرسام‌آور ابزارهای مختلف هوش مصنوعی در پروژه‌های برنامه‌نویسی، یکی از چالش‌های اصلی توسعه‌دهندگان است. ابزار Token Monitor یک ویجت دسکتاپ متن‌باز و محور (Local-first) است که به شما اجازه می‌دهد مصرف توکن، هزینه‌ها، محدودیت‌ها و فعالیت‌های جلسات خود را در بیش از ۴۵ ابزار مختلف کدنویسی هوش مصنوعی به صورت یکجا و زنده ردیابی کنید. این ابزار از سیستم‌هایی مثل Claude Code، Codex، Cursor، GitHub Copilot و ده‌ها سرویس دیگر پشتیبانی می‌کند.
معرفی و قابلیت‌های کلیدی Token Monitor
این ابزار به صورت تخصصی برای افرادی طراحی شده که به صورت همزمان از چندین دستیار هوش مصنوعی استفاده می‌کنند و نیاز دارند مصرف خود را در چند دستگاه مختلف مدیریت کنند. برخی از مهم‌ترین ویژگی‌های آن عبارتند از:
- ردیابی زنده توکن: به‌روزرسانی رابط کاربری در چند ثانیه پس از هر تعامل با ابزارهایی نظیر Claude Code، Codex، Cursor و غیره.
- نمایش نرخ مصرف: قابلیت مشاهده سرعت تولید توکن (tok/s) یا حجم مصرف کل در دقیقه (tok/min).
- جزئیات هر جلسه (Session): بررسی دقیق توکن‌های مصرف شده به تفکیک پرامپت و پاسخ‌ها بدون نیاز به همگام‌سازی ابری اجباری.
- آمار هیت ریت کش (Cache hit): تفکیک توکن‌های ورودی (کش شده در برابر کش نشده)، توکن‌های خروجی و درصد بهره‌وری.
- مدیریت هزینه‌ها: نمایش هزینه‌ها به ارزهای مختلف با قابلیت به‌روزرسانی روزانه نرخ تبدیل.
ساخت ساعت پومودورو تعاملی و ذخیره آمار در یک فایل HTML می‌تواند در کنار ابزارهای مدیریت زمان توسعه، به بهینه‌سازی راندمان کاری شما کمک کند.
| موضوع | توضیحات |
|---|---|
| زبان برنامه‌نویسی | جاوا اسکریپت (JavaScript) |
| نوع لایسنس | MIT (رایگان و متن‌باز) |
| تعداد ابزارهای پشتیبانی‌شده | بیش از ۴۵ ابزار هوش مصنوعی |
| وضعیت دسترسی ایران | کاملاً قابل استفاده (محور محلی / بدون تحریم مستقیم ساختاری) |
| سیستم‌عامل‌های مقصد | مک‌او‌اس، ویندوز، لینوکس |
معماری اجرا و حالت‌های کارکرد
این ابزار به دو روش اصلی قابل راه‌اندازی است:
- حالت محلی (Mode A): حالت پیش‌فرض و بدون نیاز به تنظیمات پیچیده که ویجت (Electron) مستقیماً داده‌ها را از پوشه‌های محلی سیستم شما خوانش می‌کند.
- حالت همگام‌سازی (Mode B): حالت اختیاری و پیشرفته برای هماهنگی بین چند دستگاه مختلف از طریق یک هاب مرکزی.
راهنمای نصب و راه‌اندازی
اگر کاربر سیستم‌عامل مک هستید، می‌توانید این ابزار را به کمک پکیج‌منیجر Homebrew با دستور زیر نصب کنید:
brew install --cask token-monitorاین دستور پکیج رسمی دسکتاپ را روی سیستم شما نصب می‌کند. پس از نصب، ویجت به صورت خودکار مسیرهای پیش‌فرض ابزارهایی مثل Claude Code و Codex را در سیستم‌عامل اسکن کرده و اطلاعات را به نمایش می‌گذارد.
برای اجرای هاب مرکزی جهت همگام‌سازی بین چند دستگاه، می‌توانید از دستورات زیر استفاده کنید:
# روی سیستم همیشه روشن
cp .env.example .env
# متغیر TOKEN_MONITOR_SECRET را مقداردهی کنید، سپس:
npm run hubبخش .env تنظیمات امنیتی ارتباط بین دستگاه‌ها را مدیریت می‌کند. برای استقرار روی Cloudflare Worker نیز می‌توانید از دستورات زیر بهره بگیرید:
cd worker
npm install
npx wrangler login
npx wrangler secret put TOKEN_MONITOR_SECRET
npx wrangler deployساخت و کامپایل از سورس کد
اگر ترجیح می‌دهید سورس کد پروژه را کلون کرده و خروجی بگیرید، مراحل زیر را دنبال کنید:
git clone https://github.com/Javis603/token-monitor.git
cd token-monitor
npm ci
cp .env.example .env # تنظیم متغیرهای هاب، کلید امنیتی و شناسه دستگاه
npm run agent # اجرای مداوم ایجنتدستورات کامپایل برای خروجی‌های مختلف به شرح زیر است:
npm install
npm run dist:mac # نسخه مک‌او‌اس ARM64
npm run dist:mac:x64 # نسخه مک‌او‌اس اینتل
npm run dist:win # نسخه ویندوز
npm run dist:linux # نسخه لینوکس AppImage
npm run pack # پوشه استخراج شده بدون نصب‌کننده برای تست سریعبررسی حافظه کش (Cache) چیست؟ دلیل بروزرسانی نشدن سایت و پاکسازی به شما دیدبهتری درباره نحوه مدیریت داده‌های ذخیره‌شده موقت در سیستم‌عامل می‌دهد که مشابه سازوکار کش این ابزار است.
پرسش‌های متداول
آیا Token Monitor برای کارکردن نیاز به اتصال اینترنت دائمی دارد؟
خیر. این ابزار به صورت Local-first طراحی شده است؛ یعنی تمام لاگ‌ها و داده‌های مربوط به مصرف توکن روی حافظه محلی سیستم شما پردازش و خوانده می‌شوند. اتصال به اینترنت فقط در صورت فعال‌سازی قابلیت همگام‌سازی بین چند دستگاه مختلف مورد نیاز است.
چگونه مسیرهای سفارشی برای ابزارهایی که در مسیر پیش‌فرض نیستند را اضافه کنیم؟
شما می‌توانید از طریق تنظیمات برنامه (Settings) و بخش مسیرهای اسکن سفارشی (Custom scan paths)، پوشه‌های دلخواه خود را که حاوی فایل‌های لاگ یا جلسات ابزارهای هوش مصنوعی هستند به ابزار معرفی کنید.
آیا این ابزار اطلاعات حساب کاربری یا کلیدهای محرمانه من را به اشتراک می‌گذارد؟
خیر. تمام کلیدهای ای‌پیاِی و داده‌های حساس به صورت محلی روی دستگاه شما ذخیره می‌شوند و هیچ‌گونه ارسال اطلاعات ناخواسته‌ای به سرورهای شخص ثالث انجام نمی‌شود.
جمع‌بندی
ابزار Token Monitor یک راه‌حل متن‌باز، سبک و کاملاً رایگان برای توسعه‌دهندگانی است که به صورت حرفه‌ای با چندین دستیار هوش مصنوعی کار می‌کنند. با قابلیت ردیابی زنده بیش از ۴۵ ابزار مختلف، مدیریت هزینه‌ها، نرخ مصرف و همگام‌سازی بین دستگاهی، این ویجت دسکتاپ به شما کمک می‌کند کنترل کامل و دقیقی روی بودجه و منابع مصرفی خود داشته باشید. بدون نیاز به ابزارهای پیچیده، می‌توانید همین حالا این ابزار را نصب کرده و وضعیت مصرف توکن‌های خود را بهینه کنید.
