.. image:: https://raw.githubusercontent.com/yzhao062/pyod/master/brand/pyod-icon.svg :target: https://pyod.dev :alt: نظام PyOD البيئي :width: 84px

كشف القيم الشاذة في بايثون (PyOD) 3

PyOD 3: كشف الشذوذ القائم على الوكلاء على نطاق واسع

.. |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/ لكلود كود، ~/.codex/ لكوديكس) ويوصي بأمر التثبيت الصحيح.

بالنسبة إلى conda، والتثبيت من المصدر، وتفاصيل التبعيات، واستكشاف الأخطاء وإصلاحها، راجع دليل التثبيت الكامل <https://pyod.readthedocs.io/en/latest/install.html>__. لا يزال الأمر القديم pyod-install-skill من الإصدار v3.0.0 يعمل كاسم مستعار لـ pyod install skill.

كشف الشذوذ في 5 أسطر من البرمجة (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 التحقيق الوكيل تريد أن يقود وكيل ذكاء اصطناعي عملية الكشف عن الشذوذ عبر محادثة طبيعية شرح الطبقة 3 <https://pyod.readthedocs.io/en/latest/examples/agentic.html>__ ========= ===================== ====================================================================== =======================================

الطبقتان 2 و3 مدعومتان بـ ADEngine، نواة تنسيق دورة الحياة في PyOD. التدفق الكامل متعدد الأدوار للتحقيق في الطبقة 3 متاح عبر مهارة od-expert لكلود كود وكوديكس. يُعرّض خادم MCP (python -m pyod.mcp_server) عشرة أدوات عديمة الحالة لنماذج لغوية كبيرة متوافقة مع 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 على مجموعة بيانات تخطيط قلب الجنين :align: center :width: 720

يوضح الشكل أعلاه محادثة وكيل حقيقية من 5 جولات على مجموعة بيانات UCI Cardiotocography. راجع الشرح الكامل <https://pyod.readthedocs.io/en/latest/examples/agentic.html>، أو مثال الوكيل القابل للتشغيل <https://github.com/yzhao062/pyod/blob/development/examples/agentic_example.py>، أو العرض التفاعلي بتقنية HTML <https://htmlpreview.github.io/?https://github.com/yzhao062/pyod/blob/development/examples/agentic_demo.html>__.

النظام البيئي والموارد لـ PyOD: NLP-ADBench <https://github.com/USC-FORTIS/NLP-ADBench>__ (كشف الشذوذ في معالجة اللغة الطبيعية) | TODS <https://github.com/datamllab/tods>__ (السلاسل الزمنية) | PyGOD <https://pygod.org/>__ (الرسوم البيانية) | ADBench <https://github.com/Minqi824/ADBench>__ (قياس الأداء) | AD-LLM <https://arxiv.org/abs/2412.11142>__ (كشف الشذوذ المعتمد على نماذج اللغة الكبيرة) [#Yang2024ad]_ | الموارد <https://github.com/yzhao062/anomaly-detection-resources>__

pyod

الأكثر شعبية

كشف القيم الشاذة في بايثون (PyOD) 3