شما در حال حاضر پایگاه کد، ترمینال و سختترین جلسات اشکالزدایی خود را به عامل هوش مصنوعی میسپارید. حالا دفترهای خود را نیز به آن بسپارید — با هر ورودی که پیشنویس میکند، از طریق پیشنمایشی که شما تأیید میکنید و یک اعتبارسنج که ریاضیات را بررسی میکند، عبور میکند. ابزار خط فرمان bea با دو دستور نصب میشود، روی فایلهای دفتر کل متن ساده روی ماشین خودتان کار میکند و برای دفترداری محلی به هیچ حسابی نیاز ندارد.
آن را با دو دستور نصب کنید
دو روش منتشرشده برای دریافت همان دستور وجود دارد. روشی را انتخاب کنید که با ماشین شما سازگار است، سپس تأیید کنید که با نسخه خود پاسخ میدهد:
$ uv tool install beancount-io
$ brew install bex-co/tap/bea
$ bea --version
bea 0.1.0توزیع پایتون beancount-io است و اجرایی که نصب میکند bea است که در حال حاضر در نسخه 0.1.0 قرار دارد. مسیر uv در هر جایی با پایتون 3.12 یا جدیدتر کار میکند؛ مسیر Homebrew سیستمعاملهای مک و لینوکس را پوشش میدهد. راهنمای کامل در صفحه نصب قرار دارد، با همان مراحل در شروع سریع CLI.
اولین کار عامل شما چند دقیقه طول میکشد
شما به عامل جدید، افزونه یا مهاجرت پلتفرم نیازی ندارید. این را در عامل هوش مصنوعی دارای دسترسی به شل که در حال حاضر استفاده میکنید، در یک دایرکتوری آزمایشی خالی و جدید جایگذاری کنید:
شما به شل دسترسی دارید و CLI
beaنصب شده است. ابتداbea --helpرا اجرا کنید و ببینید چه امکاناتی ارائه میدهد. سپس، در یک دایرکتوری آزمایشی خالی و جدید (به هیچ دفتر کل موجود دست نزنید): 1) یک دفتر کل دلاری ایجاد کنید که Assets:Checking را با 1000 در تاریخ 2026-08-01 افتتاح کند؛ 2) یک خرید 12.50 دلاری با عنوان «Coffee» به Expenses:Dining در تاریخ 2026-08-02 اضافه کنید؛ 3)bea checkرا اجرا کنید؛ 4) مانده Assets:Checking را به همراه کوئری دقیق BQL که استفاده کردید گزارش دهید. نتیجه مورد انتظار: 987.50 دلار.
همان مراحل با دستورات ساده:
$ 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 دلار آمریکا است — 1000 منهای 12.50، که توسط check تأیید شده و با کوئری که آن را محاسبه کرده گزارش شده است. وقتی عامل شما آن عدد را تحویل میدهد، اولین حلقه بسته خود را انجام داده است: پیشنویس، اعتبارسنجی، گزارش. راهنمای عامل بر اساس همان حلقه با دو دستورالعمل کاملتر بنا شده است — وارد کردن CSV بانکی با بررسی اول پیشنمایش، و پاسخ به سؤال مانده از خروجی کوئری.
آنچه نیاز دارید و این برای چه کسی مناسب است
یک ترمینال، اتصال شبکه، و یا Homebrew یا uv با پایتون 3.12 یا جدیدتر. دستورات وارد کردن، کوئری، گزارش و بررسی محلی به هیچ حساب Beancount.io نیاز ندارند و فایلهای دفتر کل شما در دایرکتوری که انتخاب میکنید به صورت متن ساده باقی میمانند که میتوانید آنها را diff، پشتیبانگیری و کنترل نسخه کنید.
این برای بنیانگذاران فنی که دفترهای استارتاپ خود را نگهداری میکنند، توسعهدهندگان مستقل که در حال حاضر در ترمینال زندگی میکنند، و سازندگان عامل که به دنبال دفتر کلی هستند که هوش مصنوعی بتواند تغییرات را بدون نوشتن بیصدا در برابر آن پیشنویس کند، مناسب است. اگر دفترهای شما در حال حاضر در یک محصول ابری زندگی میکنند، پاسخ صادقانه متفاوت است — بخش مقایسه زیر را ببینید.
مسیر میزبانیشده اختیاری و جدا است
هیچکدام از موارد بالا به حساب نیاز ندارد یا دفتر کل شما را به جایی نمیفرستد. دو مورد اضافی این کار را انجام میدهند و هر دو عمداً از نصب CLI جدا هستند:
bea askبه سؤالات درباره یک دفتر کل محلی از طریق سرویس هوش مصنوعی میزبانیشده پاسخ میدهد. به افزونه ask نیاز دارد —uv tool install 'beancount-io[ask]'— به همراه اعتبارنامههای Beancount.io شما. نصب پیشفرض وابستگیهای هوش مصنوعی را تا زمانی که درخواست نکنید حذف میکند.- سرور MCP و دفترهای کل میزبانیشده نیز با حساب Beancount.io شما وارد سیستم میشوند تا دسترسی را مجاز کنند. مهارتهای عامل برای Beancount در مخزن محصول قرار دارند و به طور جداگانه در عامل شما بارگذاری میشوند — نصب CLI آنها را نصب یا پیکربندی نمیکند.
محلی شروع کنید؛ فقط اگر میخواهید، میزبانی را وصل کنید.
اثبات: یک عامل، سه ردیف، دفترهای بررسیشده
ادعای راهاندازی فقط به اندازه بازتولید آن خوب است. بنابراین همراه با CLI یک چالش سه ردیفی مصنوعی ارائه میشود که پاسخ آن قبل از اجرای هر گزارشی از محاسبات به دست آمده است: دفترها در 2026-09-01 با 1000 دلار در حساب جاری باز میشوند، صورت حساب شامل پرداخت مشتری 2000.00 دلار، صورتحساب میزبانی 29.00- دلار و بازدید کافه 12.50- دلار است، و پاسخهای مورد انتظار 2958.50 دلار در حساب جاری (1000 + 2000 − 29 − 12.50) و 1958.50 دلار سود سپتامبر (2000 − 29 − 12.50) است.
یک تأییدکننده CLI نصبشده کل حلقه را در یک دایرکتوری موقت جدید اجرا میکند: پیشنمایش 3 آماده را گزارش میکند و چیزی نمینویسد، اولین اعمال 3 ورودی مینویسد، یک واردات مجدد یکسان 0 را با حفظ بایتهای دفتر کل مینویسد، یک نوشتن نامتعادل (بررسی 5- در برابر غذاخوری 4+) با کد خروج 1 و حفظ بایتها خارج میشود، و check معتبر برمیگرداند. ورودیهای دقیق به صورت main.bean، statement.csv و rules.toml قابل دانلود هستند.
سپس یک عامل واقعی همان چالش را اجرا کرد: مشتری muse 1.1.1 (Muse Code) با مدل muse-spark-1.3-contributor، بدون سر، 22 فراخوانی ابزار، کد خروج 0، بدون مداخله انسانی — و مهمتر، بدون rules.toml ارائهشده، بنابراین عامل دستهبندی خود را استخراج کرد. 3 آماده را پیشنمایش کرد، 3 ورودی اعمال کرد، یک بررسی تمیز اجرا کرد و مانده 2958.50 دلاری و سود سپتامبر 1958.50 دلاری را گزارش کرد، که هر دو پس از آن در برابر مقادیر مستقل مورد انتظار دوباره تأیید شدند. رکورد کامل — دستور واقعی، هر فراخوانی ابزار، و تنها شکست واقعی که خودش تشخیص داد (قفل کش سندباکس، با اشاره به XDG_CACHE_HOME در داخل پوشه کاری ثابت شد) — به عنوان اجرای ثبتشده منتشر شده است، همراه با رونوشت خام.
جلسه ترمینال زیر یک بازپخش قطعی از مسیر کاری آن اجرا است که از دانلودهای متعارف توسط demo-replay.sh بازسازی شده است — دستورات را دوباره اجرا میکند، بنابراین قوانین دستهبندی را برای قطعیت جاسازی میکند تا اینکه دوباره آنها را استخراج کند. خروجی ثبتشده در demo-replay.txt همان اطلاعات تماشای آن را حمل میکند:
$ bea --version
bea 0.1.0
$ bea import (preview)
csv → Assets:Checking: 3 ready, 0 exact duplicates, 0 possible duplicates
$ bea import --apply
Wrote 3 entries to $WORK/books/main.bean.
$ bea check
$WORK/books/main.bean: no errors
$ bea balance Assets:Checking
Checking 2,958.50 USD
$ bea report income-statement -t 2026-09
Net Profit: 1,958.50 USD
checking: 2958.50 USD (expected)
profit: 1958.50 USD (expected)
REPLAY OK: preview 3/0, applied 3, check clean, 2958.50 / 1958.50 USD.دو محدودیت صادقانه با این شواهد همراه است. این تأیید خروجی CLI از یک اجرای یک مشتری روی داده مصنوعی است — نه یک معیار مدل، و هیچ ادعایی درباره سایر مشتریان یا استفاده تولیدی بدون نظارت ندارد. و یک check موفق ثابت میکند که دفتر کل متوازن است، هرگز اینکه عامل حساب درست را برای کافه انتخاب کرده است: قضاوت دستهبندی کار عامل است، اعتبارسنجی ساختاری کار bea است. یک اسباببازی سه ردیفی حلقه را آزمایش میکند، نه قضاوت را.
انتخاب بین ابزارها
اگر برای گردش کار عامل به جای این یکی، یک دفتر کل انتخاب میکنید، مقایسه پنج ابزار را بخوانید: Beancount.io، Xero، QuickBooks Online، Puzzle و hledger با معیارهای یکسان هفتگانه گردش کار عامل امتیازدهی شدند — نصب، احراز هویت، دامنه خواندن/نوشتن، داده محلی در برابر ابری، پیشنمایش و اعتبارسنجی، خروجی ساختاریافته، و رفتار واردات مکرر — با منابع رسمی تاریخدار که در 2026-09-10 بررسی شدند. Beancount.io تنها ابزار آنجا با یک اجرای سرتاسری مشاهدهشده پشت آن است؛ صفحه این را میگوید، ناشر آن را نام میبرد و آنچه را آزمایش نکرده برچسب میزند.
از اینجا به کجا بروید
- صفحه نصب — دو دستور، اولین کار و دانلودهای چالش در یک مکان.
- شروع سریع CLI — نصب به همراه مثال کارشده 987.50 دلاری.
- راهنمای عامل — دو دستورالعمل: وارد کردن CSV با بررسی اول پیشنمایش، و سؤالات مانده از خروجی کوئری.
- اجرای ثبتشده — داستان اثبات کامل با روششناسی، شکستها و محدودیتها.
- مقایسه پنج ابزار — کدام ابزار برای کدام گردش کار عامل مناسب است.
مدیریت مالی خود را ساده کنید
سریعترین راه برای قضاوت در مورد هر یک از این موارد، نسخه نمایشی بالا است: bea را نصب کنید، کار را در عاملی که در حال حاضر استفاده میکنید جایگذاری کنید و 987.50 دلار را خودتان بررسی کنید. Beancount.io حسابداری متن ساده را فراهم میکند که هر مانده را قابل بازتولید و هر تغییر را قابل بررسی نگه میدارد — بدون جعبه سیاه، بدون قفل فروشنده. اولین دفتر کل را به عامل خود بدهید و ببینید چه چیزی به شما برمیگرداند.