برای بنیانگذاران فنی، توسعهدهندگان و سازندگان عامل
به عامل هوش مصنوعی خود یک دفتر کل بدهید
ابزار خط فرمان bea را نصب کنید، سپس یک کار را در عامل هوش مصنوعی دارای پوسته که از قبل استفاده میکنید، جای دهید. چند دقیقه بعد، یک دفتر کل محلی معتبر تحویل میگیرد — بدون نیاز به حساب Beancount.io.
نصب bea
دو روش منتشر شده برای دریافت همان دستور. روشی را انتخاب کنید که با دستگاه شما سازگار است، سپس تأیید کنید که نسخه را پاسخ میدهد.
با uv (هر جا با پایتون 3.12 یا جدیدتر)
uv tool install beancount-ioبا Homebrew (macOS یا لینوکس)
brew install bex-co/tap/beabea --versionمثال تأیید شده با bea 0.1.0: توزیع پایتون beancount-io است و اجرایی که نصب میکند bea است.
آنچه نیاز دارید
یک ترمینال، اتصال شبکه، و یا Homebrew یا uv با پایتون 3.12 یا جدیدتر. حسابداری محلی نیازی به حساب Beancount.io ندارد — این فقط برای مرحله میزبانی اختیاری زیر مطرح میشود.
دفاتر شما روی دستگاه شما میمانند
هر دستور زیر روی فایلهای متنی .bean در دایرکتوری انتخابی شما کار میکند. فایلهای دفتر جدید برای کاربر شما خصوصی هستند و هر افزودنی قبل از جایگزینی فایل، در برابر کل دفتر اعتبارسنجی میشود — در مسیر پیشفرض CLI محلی، حساب ناشناخته یا تراکنش نامتوازن خطا با راهنمایی است و فایل دستنخورده باقی میماند.
اولین کار عامل شما
این را در عامل خود جای دهید. با 1,000 دلار در حساب جاری شروع میشود، یک قهوه 12.50 دلاری ثبت میکند، دفتر را اعتبارسنجی میکند و موجودی را به همراه پرسوجوی استفاده شده گزارش میدهد.
متن کار عامل
You have shell access and the `bea` CLI installed. First run `bea --help` and read what it offers. Then, in a NEW empty demo directory (do not touch any existing ledger): 1) create a USD ledger opening Assets:Checking at 1000 on 2026-08-01; 2) add a 12.50 USD purchase narrated "Coffee" to Expenses:Dining on 2026-08-02; 3) run `bea check`; 4) report the Assets:Checking balance together with the exact BQL query you used. Expected result: 987.50 USD.همان مراحل به صورت دستورات ساده
bea --no-input init demo-books --currency USD --date 2026-08-01 --opening-balance "Assets:Checking 1000"
cd demo-books
bea add transaction --date 2026-08-02 --narration "Coffee" --posting "Expenses:Dining 12.50" --posting "Assets:Checking"
bea check
bea query "SELECT account, sum(position) WHERE account = 'Assets:Checking' GROUP BY account"نتیجه مورد انتظار: Assets:Checking دارای 987.50 دلار است.
مطالعه شروع سریع CLIاختیاری: کمک هوش مصنوعی میزبانی شده
هیچکدام از موارد بالا به حساب کاربری نیاز ندارد یا دفتر شما را به جایی ارسال نمیکند. دو مورد اختیاری این کار را میکنند و هر دو جدا از نصب CLI هستند.
bea ask به سؤالات مربوط به دفتر محلی از طریق سرویس هوش مصنوعی میزبانی شده پاسخ میدهد. به افزونه ask نیاز دارد — uv tool install 'beancount-io[ask]' — به علاوه اعتبارنامه Beancount.io شما.
سرور MCP و دفاتر میزبانی شده نیز برای مجوز دسترسی با حساب Beancount.io شما وارد میشوند. با حالت محلی شروع کنید؛ میزبانی را فقط اگر خواستید متصل کنید.
مهارتهای عامل برای Beancount در مخزن محصول قرار دارند و جداگانه در عامل شما بارگذاری میشوند — نصب CLI آنها را نصب یا پیکربندی نمیکند.
سؤالات سازندگان عامل
آیا به حساب Beancount.io نیاز دارم؟
برای هیچچیز در این صفحه نه. نصب bea، ایجاد دفتر محلی، ثبت خریدها و بررسی موجودی بدون حساب کاربری انجام میشود. فقط برای موارد اختیاری میزبانی شده وارد میشوید: bea ask، سرور MCP و دفاتر میزبانی شده.
آیا نصب CLI عامل هوش مصنوعی من را راهاندازی میکند؟
خیر. نصب، دستور bea را به شما میدهد؛ عامل شما دقیقاً همانطور که هست باقی میماند. شما کار بالا را در عامل دارای پوسته که از قبل استفاده میکنید جای میدهید و بارگذاری مهارتهای عامل یک مرحله جداگانه است.
آیا دفتر من از دستگاه من خارج میشود؟
دستورات محلی روی فایلهای .bean محلی کار میکنند و هیچ تماس شبکهای برقرار نمیکنند. فقط دستورات میزبانی شده — bea cloud و bea ask، که تماسهای مدل آنها از طریق پروکسی هوش مصنوعی میزبانی شده انجام میشود — با سرویسهای Beancount.io ارتباط برقرار میکنند.
اگر عامل من ورودی اشتباهی بنویسد چه اتفاقی میافتد؟
در مسیر پیشفرض CLI محلی، هر افزودنی قبل از جایگزینی فایل، در برابر کل دفتر بررسی میشود. یک حساب ناشناخته یا تراکنش نامتوازن با راهنمایی ناموفق میشود و فایل شما را دستنخورده میگذارد — همچنین از عامل بخواهید بعد از هر ویرایش دستی bea check را اجرا کند.
bea ask دقیقاً به چه چیزی نیاز دارد؟
دو چیز فراتر از این صفحه: افزونه وابستگی ask و اعتبارنامه میزبانی شده برای ورود. نصب پیشفرض bea عمداً وابستگیهای هوش مصنوعی را حذف میکند تا زمانی که آنها را درخواست کنید.
با قهوه شروع کنید، برای کتابها بمانید
یک نصب، یک کار جایگذاری شده، یک موجودی تأیید شده — سپس با شروع سریع کامل ادامه دهید.