دليل إصدار FinRobot وAPI المخصصة
Updated 2026-09-05
يوثق FinRobot الآن بنية سطح مكتب PydanticAI إلى جانب نصوص Pro ودفاتر AutoGen القديمة. طابق التعليمات مع تطبيقك الفعلي قبل تغيير بيانات الاعتماد.
حدد نسخة FinRobot التي تشغلها
تصف README الرسمية التي راجعت في d2219100 بتاريخ 5 سبتمبر 2026 FinRobot Desktop v0.1.0 باستخدام PydanticAI وFastAPI وReact/Tauri. وتحتفظ أيضًا بسير عمل finrobot_equity Pro ودروس AutoGen أقدم. هذه ليست أسطح تهيئة قابلة للتبادل. إصدار سطح المكتب موسوم desktop-v0.1.0 عند 6a8161ff؛ ولقطة master هوية مصدر منفصلة. سجّل الإصدار أو الالتزام الفعلي وأمر الدخول وملف التهيئة. لا يثبت وجود تعليمات OAI_CONFIG_LIST القديمة في المستودع نفسه كيفية تحميل تطبيق سطح المكتب للنماذج.
قارن مسارات التطبيق الموثقة
عامل اختيار الإصدار أول فحص توافق. تصف وثائق سطح المكتب التنسيق وأدوار البحث المتخصصة والحساب المالي الحتمي، لكن هذه المراجعة لم تثبت مسار نقطة نهاية APIsRouter المخصصة له. تعرض نصوص Pro والوكلاء Python القديمة إعدادات مختلفة ظاهرة في المصدر. لا يستطيع طلب ناجح عبر أحدها اعتماد الآخرين. راجع أيضًا ملاحظات النظام الأساسي وتوقيع سطح المكتب الرسمية قبل التثبيت؛ ولا تتجاوز فحوص أمن نظام التشغيل لمجرد إكمال درس تكامل.
| التطبيق | سطح التهيئة الذي راجعته المصادر | حد الدليل |
|---|---|---|
| Desktop v0.1.0 | تطبيق PydanticAI موصوف في README | تهيئة بوابة مخصصة غير متحققة |
| finrobot_equity Pro | config.ini API_KEYS ونص التحليل | حقول نقطة النهاية وتمريرها راجعها المصدر |
| دروس Python القديمة | قائمة تهيئة AutoGen وllm_config | سير قديم منفصل وليس إعداد سطح المكتب |
استخدم حقول نقطة نهاية Pro لنص Pro فقط
تتضمن finrobot_equity/core/config/config.ini.example الحالية openai_api_key وopenai_base_url وopenai_model. يقرأ generate_financial_analysis.py عنوان الأساس والنموذج الاختياريين ويمررهما إلى مسار توليد النص. يكيّف القالب أدناه هذه الحقول المتحققة؛ استبدل العناصر النائبة ذات الأحرف الكبيرة محليًا. لا تعني INI هذه استيفاء متغيرات البيئة. احمِ الملف الحقيقي بأذونات محلية واستبعده من التحكم بالإصدارات وتجنب نشره في سجلات الدعم. يظل مفتاح البيانات المالية مستقلًا عن بيانات اعتماد النموذج.
[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 بمدخلات صريحة
استخدم نص تحليل Pro مع هوية شركتك وملف التهيئة المحمي، ثم افحص التحليل المولّد قبل عرض التقرير. يظل الحصول على البيانات المالية وافتراضات التوقعات والحسابات الرقمية منفصلًا عن مسار سرد النموذج الموضح أدناه. بالنسبة لمُصدر دولي، افحص تغطية بورصة مزود البيانات وعملة التقرير والأساس المحاسبي قبل مقارنة النتائج. احسم عدد الأسهم والفترات المالية وأي تحويل عملة صراحةً. شغّل المراحل اللازمة فقط عند إعداد حزمة التقرير الأولى القابلة للفحص.
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. طبّق مبدأ القبول نفسه عند مراجعة أي أثر FinRobot: تتبع الرقم المعروض إلى مدخلات المصدر والوحدات والافتراضات والحساب الذي أنتجه. يظل التقييم الحتمي معتمدًا على توقعات غير مؤكدة؛ وإعادة الإنتاج ليست دليلًا على تحقق تلك التوقعات. أبقِ الافتراضات الأساسية والسيناريوهات البديلة منفصلة واحفظ الصيغ ودع النموذج يناقش الحساسيات بدل اختيار قيمة مستهدفة بصمت. اشترط بقاء المدخلات المفقودة مفقودة حتى يقدم مراجع افتراضًا مصرحًا به.
عامل دفاتر AutoGen القديمة كترحيل منفصل
يستورد finrobot/agents/workflow.py المحتفظ به AutoGen ويقبل llm_config. تحمّل الدروس القديمة إدخالات النموذج عبر OAI_CONFIG_LIST وتمرر قائمة تهيئة إلى ذلك السير. إذا كنت تصون هذا المسار، فتابع إصدار الدفتر والتبعيات معًا. لا تنقل تهيئة PydanticAI الحديثة إليه ولا تصف OAI_CONFIG_LIST بأنها إعداد FinRobot عالمي. يتطلب ترحيل عملية تقرير قائمة فحص أدواتها وتحميل مفتاح البيانات وسلوك تنفيذ الكود وتوليد التقرير لا استبدال عنوان أساس فقط.
تحقق من تقرير واحد من الإدخال إلى محدد المصدر
ابدأ بحزمة إيداع عامة محدودة وسؤال ضيق. بعد اختبار عميل مصرح به منفصلًا، تحقق من أداة بيانات مطلوبة وحساب رقمي واحد وقسم تقرير باستشهادات. سجّل مراجعة التطبيق وتجزئات المصدر والتهيئة من دون أسرار ومعرّف النموذج المحلول والاستخدام المرصود. تحقق من احتفاظ النص المولد بالوحدات وتمييزه الحقائق المعلنة عن الإسقاطات. تثبت تحية النقل أو استجابة مصنع النموذج تلك المرحلة فقط. ويحتاج قبول التقرير الكامل أيضًا إلى اكتمال البيانات ومراجعة الحساب ومخرج مقروء وادعاءات قابلة للتتبع.
ضع الميزانية واستعد عند حدود المراحل
افصل رسوم البيانات المالية وطلبات النموذج وموارد عرض التقرير ومراجعة المحلل. استخدم الأسعار الحالية للتقدير، ثم طابق سجل الطلب بما فيه الإعادات والإخفاقات. إذا تم تجاهل حقل API، افحص نص الدخول الدقيق قبل إضافة ملفات تهيئة أخرى. إذا كان التقرير فارغًا، افحص سجلات الحصول والتحليل قبل تغيير النموذج. عند تعارض المدخلات الرقمية، أوقف التقرير للمراجعة واحتفظ بقيمتي المصدر. استأنف من المرحلة المصححة حتى يحتفظ التقرير المكتمل بسبب كل تغيير.
الأدلة والقيود
راجعت وثائق المصدر والإصدار في 5 سبتمبر 2026. تأكدت حقول نقطة نهاية Pro وتمريرها في d2219100؛ ولا يزال مسار البوابة المخصصة لسطح المكتب غير متحقق. لم تُنفذ طلبة APIsRouter أو تقرير كامل أو حالة تكلفة مقاسة لهذا الدليل. تنطبق أمثلة Pro على النصوص المسماة لا سطح المكتب أو كل دفتر قديم.
الأسئلة الشائعة
هل لا يزال FinRobot الحالي مشروع AutoGen فقط؟
لا. توثق README التي راجعناها مكدس سطح مكتب PydanticAI مع الاحتفاظ بنصوص Pro وسير AutoGen القديمة. طابق الدليل مع إصدار التطبيق.
هل يعرض Pro إعداد عنوان أساس حاليًا؟
نعم. عند d2219100، تتضمن config.ini.example openai_base_url وopenai_model، ويقرأ نص التحليل الحقلين ويمررهما إلى مسار توليد النص.
هل يثبت ذلك دعم تطبيق سطح المكتب لـ APIsRouter؟
لا. لم يتحقق هذا الاستعراض من مسار نقطة النهاية المخصصة لسطح المكتب. لا تثبت تهيئة Pro والدفاتر القديمة توافق سطح المكتب.
هل أضع أسماء متغيرات البيئة مباشرة في ملف INI؟
لا تفترض الاستيفاء. القيم المعروضة عناصر نائبة تستبدل في تهيئة محلية محمية ما لم يدعم المحمل الدقيق لديك آلية أخرى صراحةً.
هل التقييمات المحسوبة بالكود توقعات موثوقة؟
هي حسابات قابلة لإعادة الإنتاج ضمن مدخلات وافتراضات محددة. لا تزال درجة عدم يقين التوقع وجودة البيانات واختيارات النمذجة تحتاج إلى مراجعة مستقلة.
ماذا أراجع قبل توليد التقرير النهائي؟
افحص اكتمال المصدر والفترات والوحدات ومدخلات الحساب وادعاءات النص المولد. احتفظ بالعناصر غير المحسومة والتصحيحات اليدوية مع الأثر.