شنو كيدير Equity Research Agent
كيحوّل Equity Research Agent المعطيات المالية العمومية المؤرخة لتقرير بالإنجليزية حول الأسهم، مع إمكانية تعديل ملف Word وإخراج PDF مطابق ليه. كيدعم الأسهم الأمريكية، وأسهم A فشنغهاي، والأسهم ديال هونغ كونغ، مع الحفاظ على الخلاصات الرقمية المهمة وشرح محركات الربحية، وتحويل الأرباح لنقد، والتقييم.
المشروع كيفصل بين جمع المعطيات، والحسابات المالية، ومراجعة الافتراضات، وتنسيق الوثائق. المحرك المالي الحتمي كيحسب نتائج التقييم محلياً، بينما DeepSeek يقدر يعاون فمناقشة الفرضية واقتراح افتراضات محتملة لـ DCF.
الخصائص الرئيسية
- تغطية ثلاثة أسواق: اختار رمز سهم أمريكي، أو رمز شنغهاي من ستة أرقام، أو رمز سهم من هونغ كونغ.
- مدخلات تقييم واضحة: ضبط النمو، والهامش، والضريبة، وإعادة الاستثمار، وWACC، والنمو الدائم، وROIC، وافتراضات الربط بين قيمة المؤسسة وحقوق الملكية.
- DCF بثلاثة سيناريوهات: راجع سيناريوهات المتفائل والأساسي والمتشائم، مع نمو وهامش وإنفاق رأسمالي وتغييرات فالرأسمال العامل خاصة بكل سيناريو.
- إخراج قابل للتعديل: صدّر تقرير Word، وPDF مطابق فأنظمة Windows المدعومة.
- الأدلة ومصدر المعطيات: حافظ على لقطات المصادر، والتواريخ، والعملات، والبصمات، وملخصات التحقق.
- إعادة التشغيل بلا إنترنت: عاود حسب اللقطات المالية المرفقة بلا ما تدير طلب لـ LLM.
التثبيت وبداية مساحة العمل
خاصك Python 3.10 أو إصدار أحدث. من مجلد المستودع المستخرج، صايب بيئة افتراضية، وثبّت المشروع مع اعتماديات الاختبار، وبدا مساحة العمل المحلية.
python -m venv .venv
.venv/Scripts/python.exe -m pip install -e ".[test]"
.venv/Scripts/python.exe -m equity_research_agent.cli serve --port 8766
حلّ http://127.0.0.1:8766 فالمتصفح ديالك. فـ Windows، تقدر حتى تطلق Start Workspace.cmd من بعد التثبيت.
جمع المعطيات العمومية المباشرة كيحتاج اتصال بالإنترنت، ولكن ما كيحتاجش مفتاح API منفصل للمعطيات. DeepSeek اختياري. باش تفعّلو، نسخ .env.example لـ .env وزد المفتاح ديالك محلياً. بيانات الدخول كاتبقى فبيئتك المحلية.
إنشاء تقرير أساسي على شركة
فمساحة العمل، اختار السوق والورقة المالية بالضبط. تفقد هوية الشركة المحمّلة، وعملة التقارير، وعملة التسعير، وتغطية المعطيات، وحقول التقييم المتاحة قبل ما تنشئ التقرير.
إلى بغيتي مثال أوفلاين قابل لإعادة الإنتاج، استعمل لقطة NVIDIA المجمّدة المرفقة:
.venv/Scripts/python.exe -m equity_research_agent.cli company --market US --symbol NVDA --snapshot examples/nvda/company_snapshot.json --skip-pdfهاد الأمر كيستعمل لقطة الشركة المحفوظة، وما كيديرش طلب للنموذج، وكيخرج تقرير Word بلا ما يحاول يحوّلو لـ PDF. نفس المسار تقدر تطبقو على أوراق مالية أخرى مدعومة باستعمال السوق والرمز ولقطة المعطيات المناسبة، أو معطيات عمومية مباشرة.
ضبط افتراضات DCF
ضبط افتراضات التقييم مباشرة فمساحة العمل. المدخلات المتاحة كتشمل نمو الإيرادات، وهوامش التشغيل، والضريبة، وإعادة الاستثمار، وWACC، والنمو الدائم، وROIC، والربط بين قيمة المؤسسة وحقوق الملكية. أدوات السيناريوهات كتخليك تبدل النمو والهامش والإنفاق الرأسمالي وتحولات الرأسمال العامل فالحالتين المتفائلة والمتشائمة.
المحرك المالي كيستعمل هاد المدخلات المراجعة باش يحسب سيناريوهات التدفقات النقدية الثلاثة. التقرير كيبين الافتراضات، وحسابات FCFF السنوية، والتدفقات النقدية المخصومة، وإعادة الاستثمار النهائية، والربط بين قيمة المؤسسة وحقوق الملكية، بلا ما يخبي منطق التقييم وراء رقم واحد مستهدف.
ناقش الافتراضات مع DeepSeek
استعمل واجهة المناقشة ملي بغيتي تختبر فرضية استثمارية، وماشي غير تدخل الافتراضات. دخل السؤال أو الفرضية ديالك، وقدّم اختيارياً روابط المصادر العمومية. DeepSeek كيراجع الأدلة المسترجعة، وكيطرح أسئلة على الرأي، وكيقترح افتراضات مع نطاقات، وأسباب، ومراجع، وحجج مضادة.
- دخل الفرضية أو سؤال التقييم ديالك.
- زد روابط المصادر العمومية المرتبطة إلا كانت متوفرة.
- راجع النطاقات المقترحة، والأدلة، والحجج المضادة.
- اختار غير الاقتراحات اللي بغيتي تطبق.
- تفقد التغيير الناتج فالتقييم داخل المحرك المالي المحلي.
- عدّل أي حقول يدوياً قبل إنشاء التقرير.
النموذج كيقترح وكيكتب؛ المحرك المحلي كيحسب الأرقام. DeepSeek كيبدا بإعداد التفكير العميق وبسقف تراكمي للميزانية قدره CNY 100. الواجهة ما كتفرضش الاقتراحات تلقائياً داخل النموذج: التطبيق كيبقى إجراءً صريحاً من طرف المستخدم.
راجع التقرير المُنشأ
التقرير المكتمل كيتضمن تحليلاً مالياً، وتمثيلاً بصرياً لـ DCF، وجداول الحسابات، ومعلومات الحساسية، وحدود المصادر، والافتراضات المعلنة ديال السيناريوهات. صفحة التقييم كتجمع سيناريوهات التدفقات النقدية الثلاثة مع إغلاق السهم المؤرخ، وربط حقوق الملكية، والافتراضات النهائية.
تأكّد باللي عملات التقارير والتقييم واضحة، وأن إقفال السهم مؤرّخ، وأن الافتراضات كاتطابق السيناريو اللي بغيتي تراجع. فإعدادات Windows المدعومة، تصدير PDF كيحتاج Microsoft Word وpdftoppm ديال Poppler يكون فـPATH، ولا خاص يكون متغيّر البيئة EQUITY_PDFTOPPM محدّد. فالأنظمة الأخرى تقدر تنشئ وثيقة Word باستعمال --skip-pdf.
تحقّق من التثبيت
من بعد التثبيت، شغّل مجموعة الاختبارات العمومية ديال المستودع:
.venv/Scripts/python.exe -m pytest tests -qالمستودع كيوثّق 35 اختبار عمومي كيغطي المحرّك المالي، تقارير الشركات، التنسيق، مناقشة الافتراضات، مسارات HTTP المحلية، وضوابط الميزانية. والتحقّق من الإصدار كيشمل حتى إعادة الحسابات المالية، هوية DuPont، تحويل العملات، قيم الرسوم البيانية، اتساق الوثائق، ومصدر المعطيات.
التحقّق كيثبت اتساق الحسابات والوثائق، ولكن ما كيعوّضش مطابقة مع إفصاحات المُصدِر ولا البحث الاستثماري الخاص بالشركة.
الاستعمال المتقدّم والقيود المهمة
استعمل لقطات مجمّدة باش تضمن قابلية إعادة الإنتاج
الأمثلة المرفقة كاتدعم إعادة التشغيل بلا اتصال بالإنترنت ديال اللقطات والسيناريوهات المالية المحفوظة. هاد الشي مفيد للاختبار، ومراجعة تنسيق التقارير، وإعادة إنتاج الأمثلة المرفقة بلا ما تدير طلب جديد للنموذج.
فحّص الأدلة قبل ما تقبل الافتراضات
خاص مراجعة اقتراحات DeepSeek جنباً إلى جنب مع النطاقات ديالها، والأسباب، والمراجع، والحجج المضادة. الافتراضات العامة كتحتاج مراجعة خاصة بكل شركة، وحقول المعطيات الثانوية يمكن تحتاج مطابقة مع إفصاحات المُصدِر.
فهم نطاق القطاعات
حساب FCFF ديال الشركات معطّل بالنسبة للبنوك، وشركات التأمين، وصناديق الاستثمار العقاري REITs، واختيارات أخرى من القطاع المالي. والأرصدة السنوية يمكن تحتاج تحديثات بسبب توزيعات الأرباح، والتمويل، والتخفيف اللاحق.
راجع التصديرات الجديدة بصرياً
المستودع فيه تحقّق للتقارير المرفقة، ولكن التصديرات الجديدة ديال السرد والتنسيق كتحتاج مراجعة بصرية خاصة بها. تأكّد باللي الرسوم البيانية، وجداول الحسابات، والعملات، والتواريخ، والملفات المحمّلة كاتطابق المعطيات المختارة.
الخلاصة
Equity Research Agent كيوفّر مسار منظّم من الحقائق العمومية المؤرّخة حتى بحث شفاف وقابل للتعديل. ثبّتو محلياً، اختار ورقة مالية مدعومة، راجع أو ناقش افتراضات DCF، حسب السيناريوهات بالمحرّك المحدّد، وفحّص تقرير Word أو PDF الناتج. اعتبر المخرجات مسودات بحث مشروطة، وماشي تقييمات استثمارية ولا أسعاراً مستهدفة مضمونة.