# الإبلاغ عن المشكلات

هل فشل شيء ما، أو عمل أبطأ مما ينبغي، أو فاجأك، أو ينقصك؟ تُتابَع الأخطاء والطلبات علنًا في
[elide-dev/elide](https://github.com/elide-dev/elide/issues). اختر المسار الذي يناسبك.

| المسار | متى تستخدمه | البداية |
| --- | --- | --- |
| وكيل البرمجة لديك | تعمل في Claude Code أو Codex أو Cursor أو عميل MCP آخر. | [الإبلاغ من وكيلك](#report-from-your-agent) |
| مسألة على GitHub | تريد إنشاء المسألة ومتابعتها بنفسك. | [إنشاء مسألة على GitHub](#file-a-github-issue) |
| Discord | تريد مساعدة الآن، أو لست متأكدًا أنه خطأ. | [elide.dev/discord](https://elide.dev/discord) |
| إشعار أمني | المشكلة ثغرة أمنية. | [أبلغ عنها بشكل خاص](#security-vulnerabilities) |

## الإبلاغ من وكيلك

اربط [خادم MCP للتوثيق](/docs/mcp-docs) العام مرة واحدة:

```bash
claude mcp add --transport http elide-docs https://elide.help/mcp
codex mcp add elide-docs --url https://elide.help/mcp
```

ثم أخبر وكيلك بما حدث:

```text
elide test hangs after the last test passes. Report it to Elide.
```

يبحث الوكيل عن مسألة موجودة، ويجمع الأدلة باستخدام `elide agent`، ويعرض عليك معاينة أُزيلت منها الأسرار ومسارات
المجلد الشخصي وعناوين البريد الإلكتروني. لا يُرسل شيء حتى تؤكد. تصبح البلاغات المقبولة مسائل علنية، عادةً خلال ساعة.

وأثناء عملك، يطلب الخادم أيضًا من وكيلك ملاحظة حالات الفشل والتشغيل البطيء والسلوك المفاجئ، وعرض إبلاغ عنها عليك.

- [الإبلاغ من وكيلك](/docs/agentic-reporting): أنواع البلاغات وخطوة التأكيد والأدلة وما يُخزَّن.
- [من البلاغ إلى الإصلاح](/docs/agentic-triage): ما يحدث بعد ذلك وكيف تتابع بلاغًا.

## إنشاء مسألة على GitHub

يطبع `elide agent bug` نص مسألة مملوءًا بإصدار Elide ومنصتك. ولا يرسل شيئًا.

```bash
elide agent bug
```

```text
File this report at https://github.com/elide-dev/elide/issues
Or send it through the docs MCP server at https://elide.help/mcp

---

### What happened

<!-- the command you ran, what you expected, what occurred -->

### Environment

| key | value |
| --- | --- |
| version | 1.6.3 |
| platform | linux-amd64 |
…
```

افتح [مسألة جديدة](https://github.com/elide-dev/elide/issues/new)، والصق النص، واملأ ما حدث.

أرفق ما يناسب المشكلة:

| المشكلة | ما تُرفقه |
| --- | --- |
| خطأ أو انهيار | الأمر ومخرجاته كاملة وأحدث ملف في `crash_root` إن كُتب أي ملف. |
| نتيجة خاطئة | ما توقعته وما حصلت عليه والسبب: صفحة توثيق أو مخرجات بيئة تشغيل أخرى. |
| تشغيل بطيء | أزمنة `elide agent perf` مقارنةً ببيئة التشغيل أو إصدار Elide الذي قارنت به. |
| ميزة ناقصة | ما ستبنيه بها. |

يطبع `elide agent diagnostics` إصدارك ومنصتك ومجلد تقارير الانهيار (`crash_root`). وأصغر مشروع أو ملف يعيد إنتاج
المشكلة هو الذي يُصلَح أسرع.

```bash
elide agent diagnostics
elide agent perf --baseline "node app.ts" -- elide run app.ts
elide agent perf --against 1.6.2 -- elide run app.ts
```

يشغّل `--against` إصدار Elide مثبّتًا لديك بالفعل؛ ولا ينزّل أي إصدار أبدًا.

## الثغرات الأمنية

أبلغ عن الثغرة بشكل خاص عبر
[تنبيهات الأمان في GitHub](https://github.com/elide-dev/elide/security/advisories/new). لا تفتح مسألة علنية، ولا تنشرها
على Discord، ولا ترسلها عبر خادم MCP للتوثيق الذي ينشئ مسائل علنية.

## قبل الإبلاغ

- يغطي [استكشاف الأخطاء وإصلاحها](/docs/troubleshooting) الأخطاء الشائعة وحلولها.
- يسرد [التوافق](/docs/compatibility) و[نظرة عامة على واجهة API](/docs/api-overview) ما لا يدعمه Elide بعد.
- ينبغي أن يطابق `elide --version` أحدث إصدار؛ راجع [الترقية](/docs/upgrading).
- صفحة التوثيق الخاطئة أو المفقودة تستحق الإبلاغ أيضًا: استخدم **هل كانت هذه الصفحة مفيدة؟** في نهاية الصفحة، أو أبلغ
  عن `expectation` مع الصفحة أساسًا لها.