مستندات نسخه ۰٫۴

شروع کار با تارتانک

تارتانک یک رابط ترمینالی برای مغز خصوصی Codex روی VPS است. این راهنما نصب، تشخیص حساب متصل، اجرای درخواست و مشاهده سهمیه را توضیح می‌دهد.

نکته امنیتی: برای استفاده از تارتانک نیازی به دریافت یا ذخیره‌کردن کلید OpenAI ندارید. حساب شما با یک توکن مستقل و قابل لغو به سامانه متصل می‌شود.

۱. نصب CLI

نسخه Node.js ۲۰ یا جدیدتر لازم است. برای جلوگیری از خطای permission در macOS و تداخل نصب NVM با نسخه قدیمی، بسته را مستقیماً در prefix کاربر نصب کنید:

$ npm install --global https://cli.tartanak.com/downloads/tartanak-cli-0.4.0.tgz --prefix "$HOME/.local"
$ hash -r
$ "$HOME/.local/bin/tartanak" --version

اگر ~/.local/bin در PATH شماست، فرمان معمول tartanak نیز همین نسخه را اجرا می‌کند. نسخهٔ ۰٫۴ خروجی RTL و پل ابزار محلی را فعال می‌کند؛ برای ترمینال ناسازگار می‌توان TARTANAK_RTL=0 تنظیم کرد. پس از انتشار عمومی، می‌توانید URL را با @tartanak/cli جایگزین کنید. SHA-256 بسته ↗

Tartanak CLI 0.4.0 · Codex engine 0.147.0 (stable)
$ tartanak engine
$ type -a tartanak

دستور ورود یک آدرس و کد موقت نمایش می‌دهد. آدرس را در مرورگر باز کنید و ایمیل خود را با OTP تأیید کنید. صفحه تأیید پیش از اتصال، ایمیل و نقش حساب فعلی را نشان می‌دهد؛ کد موقت فقط داخل صفحه وب وارد می‌شود و فرمان shell نیست.

$ tartanak login
۱) https://cli.tartanak.com/device را باز کنید
۲) کد ABCD-EFGH را داخل صفحه تأیید کنید
حساب تارتانک: owner@example.com
حساب Codex روی VPS: owner@example.com · plan

نشست با permission محدود در ~/.tartanak/auth.json نگهداری و با فرمان داخلی کوتاه‌عمر تمدید می‌شود. تارتانک هیچ auth شخصی را از ~/.codex نمی‌خواند. هر زمان با tartanak account می‌توانید حساب تارتانک، حساب Codex روی VPS، نام دستگاه و مانده سهمیه را دوباره ببینید.

۳. اجرای اولین درخواست

حالت عادی ابزارهای خواندنی مانند مشخصات CPU را مستقیم اجرا می‌کند و پیش از هر فرمان shell از شما تأیید می‌گیرد. حالت trusted برای دستگاه شخصی معادل full access است:

$ tartanak
$ tartanak --t
tartanak> CPU این دستگاه چیست؟
tartanak> پروژه را بررسی کن، خطا را رفع کن و تست‌ها را اجرا کن

tartanak --t فرمان‌ها را با دسترسی همان حساب سیستم‌عامل و بدون تأیید اجرا می‌کند. آن را فقط روی دستگاه مورد اعتماد اجرا کنید. مغز و حسابداری روی هاب می‌مانند، اما CPU، فایل‌ها، Git و shell روی خود دستگاه هستند.

فرمان‌های تعاملی

/usage مصرف دقیق ورودی/خروجی، رزرو و مانده
/goal TEXT هدف پایدار جلسه و /plan حالت برنامه‌ریزی
/skills مهارت‌های VPS و /plugins وضعیت پایدار Apps/MCP
/models، /model MODEL و /effort LEVEL برای کنترل مدل
/trusted دسترسی کامل و /normal بازگشت به approval

۴. اتصال هاب به Codex

مغز خصوصی دستگاه‌های مالک، بدون API key

در صفحه مدیریت، بخش «مغز خصوصی Codex» را باز کنید و «شروع ورود با Device Code» را بزنید. VPS یک کد رسمی از Codex app-server می‌گیرد؛ شما در صفحه رسمی OpenAI وارد حساب ChatGPT خود می‌شوید و همان کد را تأیید می‌کنید. credential داخل volume خصوصی tartanak_codex_home می‌ماند و به CLI ارسال نمی‌شود.

سقف ماهانه توکن

سهمیه ورودی و خروجی مستقل‌اند. مقدار پیش‌فرض هر دستگاه جدید یک میلیون ورودی و یک میلیون خروجی در ماه میلادی است؛ مالک می‌تواند برای هر دستگاه مقدار بیشتری ثبت کند. هاب پیش از هر اجرا ۵۰هزار ورودی و ۲۰هزار خروجی را موقتاً رزرو می‌کند و پس از دریافت رویداد رسمی usage از Codex، مصرف قطعی را جایگزین می‌کند.

این شمارنده برای کنترل داخلی ChatGPT/Codex است و هزینه تومانی API نیست. rate limit حساب ChatGPT نیز جداگانه نمایش داده می‌شود.

۵. اعتبار و محاسبه مصرف

پیش از ارسال درخواست، تارتانک تعداد ورودی را با شمارنده رسمی OpenAI به دست می‌آورد و اعتبار لازم برای بدترین حالت را موقتاً رزرو می‌کند. پس از پاسخ، صورتحساب فقط از usage نهایی ساخته و اضافه رزرو آزاد می‌شود. مقدار قابل استفاده همیشه «موجودی کل منهای رزروشده» است.

ورودی عادی، خواندن کش و نوشتن کش با سه نرخ مستقل محاسبه می‌شوند.
توکن reasoning داخل عدد خروجی قرار دارد و بار دوم شارژ نمی‌شود.
برای prompt بیش از ۲۷۲هزار توکن، نرخ long-context همان نسخه قیمت اعمال می‌شود.
شناسه هر درخواست برای هر کاربر یکتا است تا retry موجب دوباره‌کسرشدن نشود.
درخواست فاقد usage قطعی وارد صف تطبیق مالی می‌شود؛ مدیر می‌تواند پاسخ OpenAI را دوباره استعلام و با نسخه قیمت اصلی تسویه کند.

نرخ فروش از قیمت رسمی دلاری OpenAI، نرخ دلار ثبت‌شده توسط مالک و حاشیه سود ساخته می‌شود. نسخه قیمت هر درخواست تغییرناپذیر است تا گزارش تاریخی با تغییر تعرفه عوض نشود. مشاهده منبع رسمی قیمت‌ها ↗

۶. ثبت و انتشار در NPM

در npmjs.com/signup یک حساب بسازید، ایمیل را تأیید و 2FA را فعال کنید. سپس از منوی پروفایل Add an Organization را بزنید، نام tartanak و طرح رایگان public packages را انتخاب کنید. در ترمینال:

$ npm login
$ npm whoami
$ npm run pack:check --workspace @tartanak/cli
$ npm publish --workspace @tartanak/cli --access public --provenance=false

پس از انتشار اول، در Settings پکیج، GitHub Actions را به عنوان trusted publisher معرفی کنید و workflow موجود .github/workflows/publish-cli.yml را انتخاب کنید. ساخت حساب، پذیرش شرایط npm و تأیید 2FA باید توسط خود مالک انجام شود.

۷. امنیت

مغز خصوصی به ورود Device Code حساب ChatGPT روی VPS متصل است و API key لازم ندارد. اگر بعداً مسیر جداگانهٔ Platform API را برای tartanak exec فعال کنید، کلید آن فقط در secretهای سرور می‌ماند و هرگز به CLI ارسال نمی‌شود. توکن‌های کاربران کوتاه‌عمر، قابل چرخش و محدود به همان خانوادهٔ دستگاه هستند. در حالت عادی هر فرمان shell تأیید می‌خواهد؛ حالت --t این تأیید را عمداً حذف می‌کند و باید فقط روی دستگاه شخصی مورد اعتماد استفاده شود.