راهنمای نسخه و API سفارشی FinRobot

مشخص کنید کدام FinRobot را اجرا می‌کنید

README رسمی که در d2219100 در September 5, 2026 بررسی شد، FinRobot Desktop v0.1.0 را با PydanticAI، FastAPI و React/Tauri توضیح می‌دهد. همین README یک گردش‌کار Pro به نام finrobot_equity و آموزش‌های قدیمی AutoGen را هم نگه داشته است. این‌ها سطوح پیکربندی قابل‌جایگزینی نیستند. نسخه دسکتاپ در desktop-v0.1.0 با 6a8161ff tag شده و snapshot master هویت منبع جداگانه‌ای است. release یا commit واقعی، فرمان ورود و فایل پیکربندی را ثبت کنید. وجود دستورهای قدیمی OAI_CONFIG_LIST در همان مخزن نشان نمی‌دهد برنامه دسکتاپ مدل‌ها را چگونه بارگذاری می‌کند.

مسیرهای مستند برنامه را مقایسه کنید

انتخاب نسخه را نخستین کنترل سازگاری بدانید. مستندات دسکتاپ هماهنگ‌سازی، نقش‌های تخصصی پژوهش و محاسبه قطعی مالی را توضیح می‌دهد، اما این بررسی مسیر endpoint سفارشی APIsRouter آن را تثبیت نکرده است. script Pro و agentهای قدیمی Python تنظیمات متفاوتی دارند که در source دیده می‌شود. درخواست موفق یکی، دیگری را تأیید نمی‌کند. پیش از نصب، یادداشت‌های رسمی پلتفرم و signing دسکتاپ را هم بررسی کنید؛ فقط برای تکمیل آموزش یکپارچه‌سازی کنترل‌های امنیتی سیستم‌عامل را دور نزنید.

فیلدهای endpoint Pro را فقط برای script Pro استفاده کنید

فایل فعلی finrobot_equity/core/config/config.ini.example شامل openai_api_key، openai_base_url و openai_model است. generate_financial_analysis.py، base URL و model اختیاری را می‌خواند و به مسیر text-generation می‌دهد. قالب زیر این فیلدهای تأییدشده را سازگار می‌کند؛ placeholderهای uppercase را محلی جایگزین کنید. این فایل INI معنای interpolation متغیر محیطی را تضمین نمی‌کند. فایل واقعی را با مجوزهای محلی محافظت و از version control خارج کنید و آن را در log پشتیبانی منتشر نکنید. کلید داده مالی مستقل از اعتبارنامه مدل می‌ماند.

[API_KEYS]
fmp_api_key = YOUR_FINANCIAL_DATA_KEY
openai_api_key = YOUR_APISROUTER_KEY
openai_base_url = https://api.apisrouter.com/v1
openai_model = CURRENT_CATALOG_MODEL_ID

مسیر تولید متن Pro را با ورودی‌های صریح اجرا کنید

از script تحلیل Pro با هویت شرکت و فایل پیکربندی محافظت‌شده استفاده کنید و پیش از render گزارش، تحلیل تولیدشده را بررسی کنید. دریافت مالی، فرض‌های پیش‌بینی و محاسبات عددی از مسیر روایت مدل زیر جدا می‌مانند. برای ناشر بین‌المللی، پیش از مقایسه نتیجه، پوشش بورس، ارز گزارشگری و مبنای حسابداری ارائه‌دهنده داده را بررسی کنید. تعداد سهام، دوره مالی و هر تبدیل ارز را صریح حل کنید. هنگام ساخت نخستین بسته گزارش قابل‌بررسی فقط مرحله‌های لازم را اجرا کنید.

python finrobot_equity/core/src/generate_financial_analysis.py \
  --company-ticker "$RESEARCH_TICKER" \
  --company-name "$RESEARCH_COMPANY" \
  --config-file finrobot_equity/core/config/config.ini \
  --generate-text-sections

محاسبات مالی را بازتولیدپذیر نگه دارید

معماری جاری دسکتاپ محاسبه مالی را صریحاً از توضیح LLM جدا می‌کند. هنگام بازبینی هر artifact FinRobot همین اصل پذیرش را اعمال کنید: عدد نمایش‌داده‌شده را به ورودی منبع، واحد، فرض و محاسبه تولیدکننده آن وصل کنید. ارزش‌گذاری قطعی همچنان به پیش‌بینی‌های نامطمئن وابسته است؛ بازتولیدپذیری ثابت نمی‌کند پیش‌بینی‌ها محقق می‌شوند. فرض‌های پایه و سناریوهای جایگزین را جدا، فرمول‌ها را حفظ و از مدل بخواهید حساسیت‌ها را توضیح دهد، نه اینکه بی‌صدا مقدار هدف انتخاب کند. ورودی مفقود باید تا تأمین فرض مجاز توسط بازبین، مفقود بماند.

نوت‌بوک‌های قدیمی AutoGen را مهاجرتی جدا بدانید

finrobot/agents/workflow.py باقی‌مانده AutoGen را import و llm_config را قبول می‌کند. آموزش‌های قدیمی model entry را از طریق OAI_CONFIG_LIST بارگذاری و config list را به همان workflow می‌دهند. اگر این مسیر را نگه می‌دارید، نوت‌بوک و نسخه وابستگی را با هم دنبال کنید. پیکربندی مدرن PydanticAI را در آن منتقل نکنید و OAI_CONFIG_LIST را تنظیم عمومی FinRobot معرفی نکنید. مهاجرت فرایند گزارش موجود به بررسی ابزارها، بارگذاری کلید داده، رفتار code-execution و تولید گزارش نیاز دارد، نه فقط تعویض base URL.

یک گزارش را از ورودی تا مکان‌یاب منبع اعتبارسنجی کنید

با بسته گزارش عمومی محدود و پرسشی باریک شروع کنید. پس از آزمون جداگانه و مجاز کلاینت، یک ابزار داده لازم، یک محاسبه عددی و یک بخش گزارش دارای استناد را اعتبارسنجی کنید. revision برنامه، hashهای منبع، پیکربندی بدون secret، ID مدل resolveشده و مصرف مشاهده‌شده را ثبت کنید. بررسی کنید متن تولیدشده واحدها را حفظ و واقعیت گزارش‌شده را از projection جدا می‌کند. hello انتقال یا پاسخ factory فقط همان مرحله را ثابت می‌کند. پذیرش گزارش کامل به کامل‌بودن داده، بازبینی محاسبه، خروجی خوانا و ادعاهای قابل‌ردیابی هم نیاز دارد.

در مرز مرحله‌ها بودجه‌بندی و بازیابی کنید

هزینه داده مالی، درخواست مدل، منابع render گزارش و بازبینی تحلیلگر را جدا کنید. برای برآورد از قیمت جاری و سپس برای تطبیق از دفتر درخواست، شامل تلاش مجدد و شکست، استفاده کنید. اگر یک فیلد API نادیده گرفته می‌شود، پیش از افزودن فایل پیکربندی بیشتر script دقیق entry را بررسی کنید. اگر گزارش خالی است، پیش از تغییر مدل logهای دریافت و parsing را بررسی کنید. هنگام تعارض ورودی‌های عددی، گزارش را برای بازبینی متوقف و هر دو مقدار منبع را حفظ کنید. از مرحله اصلاح‌شده ادامه دهید تا گزارش کامل دلیل هر تغییر را نگه دارد.

شواهد و محدودیت‌ها

مستندات source و release در September 5, 2026 بررسی شدند. فیلدهای endpoint Pro و forwarding آن‌ها در d2219100 تأیید شده‌اند؛ مسیر gateway سفارشی دسکتاپ همچنان تأییدنشده است. برای این راهنما هیچ درخواست APIsRouter، گزارش کامل یا مورد مصرف اندازه‌گیری‌شده اجرا نشده است. نمونه‌های Pro فقط به scriptهای نام‌برده مربوط‌اند، نه دسکتاپ یا همه نوت‌بوک‌های قدیمی.

پرسش‌های پرتکرار