yzhao062/pyodمكتبة بايثون لكشف الشذوذ في البيانات الجدولية والسلاسل الزمنية والرسوم البيانية والنصوص والصور والبيانات الصوتية. تضم أكثر من 60 كاشفًا، وتنسيق ADEngine المدعوم بالمعايير المرجعية، وسير عمل وكيلي لوكلاء الذكاء الاصطناعي.
.. image:: https://raw.githubusercontent.com/yzhao062/pyod/master/brand/pyod-icon.svg :target: https://pyod.dev :alt: نظام PyOD البيئي :width: 84px
PyOD 3: كشف الشذوذ الوكي على نطاق واسع
|badge_website| |badge_pypi| |badge_anaconda| |badge_docs| |badge_stars| |badge_forks| |badge_downloads| |badge_testing| |badge_coverage| |badge_maintainability| |badge_license| |badge_benchmark|
.. |badge_website| image:: https://img.shields.io/badge/website-pyod.dev-990000 :target: https://pyod.dev :alt: الموقع الإلكتروني
.. |badge_pypi| image:: https://img.shields.io/pypi/v/pyod.svg?color=brightgreen :target: https://pypi.org/project/pyod/ :alt: إصدار PyPI
.. |badge_anaconda| image:: https://anaconda.org/conda-forge/pyod/badges/version.svg :target: https://anaconda.org/conda-forge/pyod :alt: إصدار Anaconda
.. |badge_docs| image:: https://readthedocs.org/projects/pyod/badge/?version=latest :target: https://pyod.readthedocs.io/en/latest/?badge=latest :alt: حالة التوثيق
.. |badge_stars| image:: https://img.shields.io/github/stars/yzhao062/pyod.svg :target: https://github.com/yzhao062/pyod/stargazers :alt: نجوم GitHub
.. |badge_forks| image:: https://img.shields.io/github/forks/yzhao062/pyod.svg?color=blue :target: https://github.com/yzhao062/pyod/network :alt: تفرعات GitHub
.. |badge_downloads| image:: https://pepy.tech/badge/pyod :target: https://pepy.tech/project/pyod :alt: التنزيلات
.. |badge_testing| image:: https://github.com/yzhao062/pyod/actions/workflows/testing.yml/badge.svg :target: https://github.com/yzhao062/pyod/actions/workflows/testing.yml :alt: الاختبار
.. |badge_coverage| image:: https://coveralls.io/repos/github/yzhao062/pyod/badge.svg :target: https://coveralls.io/github/yzhao062/pyod :alt: حالة التغطية
.. |badge_maintainability| image:: https://api.codeclimate.com/v1/badges/bdc3d8d0454274c753c4/maintainability :target: https://codeclimate.com/github/yzhao062/Pyod/maintainability :alt: قابلية الصيانة
.. |badge_license| image:: https://img.shields.io/github/license/yzhao062/pyod.svg :target: https://github.com/yzhao062/pyod/blob/master/LICENSE :alt: الترخيص
.. |badge_benchmark| image:: https://img.shields.io/badge/ADBench-benchmark_results-pink :target: https://github.com/Minqi824/ADBench :alt: المعيار المرجعي
**PyOD جاهز للوكلاء.** يمكن لـ Claude Code و Codex استخدام مهارة ``od-expert`` لتوجيه تحقيقات ADEngine، بينما يمكن للوكلاء المتوافقين مع MCP الاستعلام عن معرفة كاشفات PyOD وأدوات التخطيط. تبقى واجهة ``fit``/``predict`` الكلاسيكية دون تغيير.
PyOD 3 هو المكتبة الأكثر شمولاً في بايثون لكشف الشذوذ. أربع ركائز:
=========================== ========================================================================================
الركيزة ما تعنيه
=========================== ========================================================================================
متعدد الوسائط 61 كاشفاً عبر بيانات جدولية، وسلاسل زمنية، ورسوم بيانية، ونصوص، وصور، وصوت، واجهة برمجية واحدة
دورة حياة كاملة من البيانات الخام إلى الشذوذات المفسّرة والإرشادات للخطوة التالية في استدعاء واحد
وكي od-expert يحوّل الطلبات باللغة الطبيعية إلى سير عمل ADEngine؛ و MCP يعرض أدوات منظمة لوكلاء آخرين
الأكثر استخداماً أكثر من 46 مليون تنزيل؛ توجيه مدعوم بالمعايير المرجعية (ADBench، TSB-AD، BOND، NLP-ADBench)
=========================== ========================================================================================
التثبيت ^^^^^^^
المكتبة الأساسية (مطلوبة لكل مسار تفعيل):
.. code-block:: bash
pip install pyod
ثم اختر مسار التفعيل الذي يناسب حزمة الوكلاء لديك:
.. code-block:: bash
# 1. Claude Code / Codex — enables the od-expert skill
pyod install skill # Claude Code: user-global (~/.claude/skills/)
pyod install skill --project # Codex: project-local (./skills/, Codex has no user-global dir)
# 2. Any MCP-compatible LLM — requires the optional mcp extra
pip install pyod[mcp]
pyod mcp serve # alias for `python -m pyod.mcp_server`
# 3. Pure Python — no extra step
# from pyod.utils.ad_engine import ADEngine
شغّل pyod info في أي وقت لعرض الإصدار، وعدد الكواشف،
وحالة التثبيت لكل مسار تفعيل. يكتشف pyod info أيضًا
حزمة الوكيل المثبّتة لديك (~/.claude/ لـ Claude Code،
و~/.codex/ لـ Codex) ويوصي بأمر التثبيت المناسب.
للحصول على conda، والتثبيت من المصدر، وتفاصيل التبعيات، واستكشاف الأخطاء وإصلاحها،
راجع دليل التثبيت <https://pyod.readthedocs.io/en/latest/install.html>__ الكامل.
لا يزال الأمر القديم pyod-install-skill من الإصدار v3.0.0 يعمل كـ
مرادف لـ pyod install skill.
كشف القيم الشاذة بخمسة أسطر من التعليمات البرمجية (pip install pyod):
.. code-block:: python
from pyod.models.iforest import IForest
clf = IForest()
clf.fit(X_train)
y_train_scores = clf.decision_scores_ # training anomaly scores
y_test_scores = clf.decision_function(X_test) # test anomaly scores
ثلاث طرق لاستخدام PyOD:
========= ===================== ====================================================================== =======================================
الطبقة الاسم متى تستخدمه نقطة الدخول
========= ===================== ====================================================================== =======================================
1 Classic API تعرف أي كاشف تريد أمثلة الطبقة 1 <https://pyod.readthedocs.io/en/latest/examples/tabular.html>__
2 ADEngine تريد أن يختار PyOD ويقارن ويقيّم تلقائيًا شرح الطبقة 2 <https://pyod.readthedocs.io/en/latest/examples/adengine.html>__
3 Agentic Investigation تريد أن يقود وكيل ذكاء اصطناعي كشف القيم الشاذة عبر محادثة طبيعية شرح الطبقة 3 <https://pyod.readthedocs.io/en/latest/examples/agentic.html>__
========= ===================== ====================================================================== =======================================
الطبقتان 2 و3 مدعومتان بـ ADEngine، نواة تنسيق دورة الحياة في PyOD. يتوفر تدفق التحقيق الكامل متعدد الأدوار للطبقة 3 عبر مهارة od-expert لـ Claude Code وCodex. يكشف خادم MCP (python -m pyod.mcp_server) عن عشرة أدوات عديمة الحالة لوكلاء LLM المتوافقة مع MCP، تشمل استعلامات المعرفة (list_detectors، explain_detector، compare_detectors، get_benchmarks)، والتخطيط (profile_data، plan_detection، build_detector)، والكشف (run_detection، analyze_results، explain_findings)؛ أما أدوات MCP ذات الحالة investigate / iterate فهي مؤجلة.
.. image:: https://raw.githubusercontent.com/yzhao062/pyod/development/docs/figs/agentic-demo.png :alt: عرض توضيحي للتحقيق الوكيلي في PyOD 3 على مجموعة بيانات cardiotocography :align: center :width: 720