# إضافة Obsidian Copilot إلى QCode: دليل مصوّر على Windows 11

إذا أتممت الخطوات السبع عشرة أدناه، ستكون قد ثبّتت إضافة Copilot في Obsidian على Windows 11 وجعلتها تستخدم `gpt-6.2-sol` و`claude-opus-5-5` عبر QCode: افتح Quick Chat في الجانب الأيمن داخل ملاحظتك، وستحصل في ثوانٍ على شرح وتلخيص وإعادة صياغة.


**الإجابة المختصرة**: في إعدادات Obsidian ضمن «第三方插件 → Copilot → BYOK» (الإضافات الخارجية ← Copilot ← BYOK) انقر «+ Add a provider»، واختر «Add a custom provider»، واكتب في Base URL القيمة `https://api.qcode.cc/openai/v1`، والصق مفتاح `cr_`، وشغّل Enable CORS، وبعد أن يظهر Verified عند Test حدّد `gpt-6.2-sol` ثم احفظ.

| البند | ما تملؤه |
|---|---|
| عنوان الوصول (GPT والنماذج الصينية) | `https://api.qcode.cc/openai/v1` |
| عنوان الوصول (Claude) | `https://api.qcode.cc/api` |
| النموذج الافتراضي (GPT) | `gpt-6.2-sol` |
| النموذج الافتراضي (Claude) | `claude-opus-5-5` |
| صيغة المفتاح | `cr_xxxxxxxx` |

تم التحقق في 2026-11-22 · Obsidian 1.15.1 + Copilot 4.1.0 · Windows 11



- **ينطبق على**: Windows 10 / 11 (64 بت)
- **إصدار البرنامج**: Obsidian 1.15.1 + Copilot 4.1.0
- **تاريخ تحديث اللقطات**: 2026-11
- **الوقت المتوقع**: 20 دقيقة
- **ما تحتاج إليه**: مفتاح QCode API يبدأ بـ `cr_`؛ ومخزن Obsidian (vault) يمكن تثبيت إضافات خارجية فيه



- الكمبيوتر يعمل بـ Windows 10 / 11 (64 بت)، ويستطيع فتح المتصفح والوصول إلى `obsidian.md`
- Obsidian 1.15.1 مثبّت مسبقًا؛ وإن لم يكن مثبّتًا فلا مشكلة، فقسم «التنزيل والتثبيت» أدناه يشرح تثبيته
- يوجد مخزن Obsidian (vault): ويكفي مخزن فارغ أُنشئ للتو
- مفتاح QCode API الذي يبدأ بـ `cr_` منسوخ مسبقًا من [لوحة التحكم](https://qcode.cc/ar/dashboard). ليس لديك حساب بعد؟ [أنشئ حساب QCode](https://qcode.cc/ar/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-obsidian-copilot-before) أولًا، واختر خطة من [صفحة الأسعار](https://qcode.cc/ar/pricing?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-obsidian-copilot-before)، ثم أنشئ المفتاح في [لوحة التحكم](https://qcode.cc/ar/dashboard).
- يستطيع الكمبيوتر الوصول إلى `api.qcode.cc` و`probe.qcode.cc`


## التنزيل والتثبيت

حزمة تثبيت Obsidian على Windows ملف `.exe` واحد فقط، ويُحمَّل من الموقع الرسمي؛ أما إضافة Copilot فليست داخل هذه الحزمة، بل تُثبَّت من سوق الإضافات داخل Obsidian بعد الانتهاء من تثبيته.

اختر منطقتك أولًا:

**أوروبا / اليابان**

- افتح [obsidian.md/download](https://obsidian.md/download) ونزّل نسخة Windows، أو اذهب مباشرة إلى [GitHub Releases](https://github.com/obsidianmd/obsidian-releases/releases) لأخذ `Obsidian-1.15.1.exe` من أحدث إصدار.
- نزّل `.exe` فقط؛ فملف `.dmg` في القائمة خاص بـ macOS و`.apk` خاص بأندرويد، ولن يعمل أي منهما.
- ولتوفير الوقت يمكنك تشغيل `winget install Obsidian.Obsidian` في «الطرفية» على Windows.


**البر الرئيسي للصين**

- افتح [obsidian.md/download](https://obsidian.md/download) وانقر «Download for Windows» لتحصل على `Obsidian-1.15.1.exe`.
- حزمة تثبيت Obsidian مستضافة فعليًا على GitHub؛ وإذا كان الاتصال المباشر بطيئًا أو ينقطع، فثبّت الإصدار نفسه من سطر الأوامر: `winget install Obsidian.Obsidian`.
- تُثبَّت الحزمة للمستخدم الحالي، فلا تظهر عادةً نافذة «التحكم في حساب المستخدم» (UAC)؛ وبعد التثبيت تجد Obsidian في قائمة ابدأ.


**أمريكا الشمالية**

- الموقع الرسمي وGitHub متاحان عادةً مباشرة: افتح [obsidian.md/download](https://obsidian.md/download) وانقر زر Windows، فهذا أسهل طريق.
- إن اختلف رقم الإصدار في الصفحة عن المطلوب، فابحث في [GitHub Releases](https://github.com/obsidianmd/obsidian-releases/releases) عن إصدار `v1.15.1` ونزّل ملف `.exe` بالاسم نفسه.
- وإذا ظهرت أثناء التثبيت نافذة «Windows 已保护你的电脑» (Windows حمى جهازك)، فانقر «更多信息» (مزيد من المعلومات) ← «仍要运行» (تشغيل على أي حال).


**مناطق أخرى**

- استخدم الموقع الرسمي [obsidian.md/download](https://obsidian.md/download) أولًا؛ وإذا لم يُفتح فاستخدم `winget install Obsidian.Obsidian`.
- ويمكن التنزيل من [GitHub Releases](https://github.com/obsidianmd/obsidian-releases/releases)، فصيغة اسم الملف ثابتة: `Obsidian-<الإصدار>.exe`.
- بعد التثبيت افتحه مرة واحدة وتأكد من الوصول إلى شاشة «新建仓库» (إنشاء مخزن) قبل المتابعة.


## اتبع اللقطات: Windows خطوة بخطوة

فيما يلي 17 خطوة، كل خطوة تفعل شيئًا واحدًا فقط. اللقطات من Windows 11 بواجهة صينية، والأرقام البرتقالية على الصور تقابل ①②③ في النص واحدًا بواحد.



### افتح صفحة التنزيل الرسمية لـ Obsidian

افتح في المتصفح [obsidian.md/download](https://obsidian.md/download). تتعرّف الصفحة تلقائيًا على نظامك، والزر البنفسجي عند ① «Download for Windows» هو حزمة تثبيت نسخة Windows.

![صفحة التنزيل الرسمية لـ Obsidian: تعرّفت الصفحة تلقائيًا على نظام Windows، وفي الوسط إلى الأسفل يظهر زر التنزيل البنفسجي Download for Windows](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/01-obsidian-download.webp)


إذا فعلتها بشكل صحيح فسترى: يبدأ المتصفح تنزيل ملف باسم `Obsidian-1.15.1.exe`، وليس `.dmg` أو `.apk`.


**تعثّرت؟ لا يحدث شيء عند النقر على الزر، أو يتوقف التنزيل عند 0%**

حزمة التثبيت مستضافة على GitHub، وقد تتعطل عند ضعف الشبكة. جرّب صيغة منطقة أخرى من «التنزيل والتثبيت»، أو شغّل في «الطرفية» على Windows الأمر `winget install Obsidian.Obsidian` لتثبيت الإصدار نفسه.




### أول تشغيل: انقر «创建» (إنشاء) لإنشاء مخزن جديد

انقر نقرًا مزدوجًا على حزمة التثبيت التي نزّلتها للتو، وأكمل التثبيت حسب التعليمات (للمثبّت زر واحد فقط، ويفتح التطبيق تلقائيًا بعده)، ثم افتح Obsidian من قائمة ابدأ. يظهر عند أول تشغيل بالصينية المبسّطة تلقائيًا، والصفحة الرئيسية ثلاثة أسطر من الخيارات: انقر الزر البنفسجي «创建» (إنشاء) على يمين ① «新建仓库» (إنشاء مخزن).

![الصفحة الرئيسية لأول تشغيل في Obsidian: يظهر الإصدار 1.15.1، والأسطر الثلاثة هي إنشاء مخزن وفتح مخزن محلي ومزامنة مخزن بعيد، وعلى يمين إنشاء مخزن زر «创建» (إنشاء) البنفسجي](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/02-obsidian-welcome.webp)


إذا فعلتها بشكل صحيح فسترى: يظهر نموذج «创建本地仓库» (إنشاء مخزن محلي)، وفي أعلى اليسار «返回» (رجوع)، وأعلى اليمين «版本 1.15.1» (الإصدار 1.15.1).




### املأ اسم المخزن وموقعه

اكتب في «仓库名称» (اسم المخزن) اسمًا سهل التذكّر مثل `QCodeDemo` (①)؛ وانقر ② «浏览» (استعراض) لاختيار مجلد يكون موقعًا للمخزن (اسم المستخدم في اللقطة محجوب)؛ وانقر أخيرًا ③ «创建» (إنشاء).

![نموذج إنشاء مخزن محلي: اسم المخزن QCodeDemo، وأدناه موقع المخزن وزر الاستعراض، وفي الأسفل زر «创建» (إنشاء) البنفسجي، واسم المستخدم في المسار محجوب](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/03-create-vault.webp)


إذا فعلتها بشكل صحيح فسترى: تُفتح نافذة Obsidian الرئيسية، ويعرض شريط العنوان `QCodeDemo - Obsidian`، وفي الوسط ملاحظة اسمها «欢迎» (ترحيب).


**تعثّرت؟ تظهر رسالة أن هذا الموقع يحتوي على مخزن بالفعل**

هذا يعني أن المجلد الذي اخترته يحتوي على مخزن Obsidian. اختر مجلدًا فارغًا آخر، أو أنشئ مجلدًا فرعيًا داخل «仓库位置» (موقع المخزن) ثم انقر «创建» (إنشاء).




### افتح «第三方插件» (الإضافات الخارجية) في الإعدادات

اضغط `Ctrl` + `,` في نافذة Obsidian لفتح الإعدادات. انقر في القائمة اليسرى ① «第三方插件» (الإضافات الخارجية)؛ وسيكون الجانب الأيمن في حالة مقيّدة، فانقر ② «退出受限模式» (الخروج من الوضع المقيّد).

![نافذة إعدادات Obsidian: عنصر الإضافات الخارجية محدَّد في القائمة اليسرى، وعلى اليمين شرح أمان الإضافات وزر «退出受限模式» (الخروج من الوضع المقيّد) البنفسجي](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/04-community-plugins-unlock.webp)


إذا فعلتها بشكل صحيح فسترى: تختفي رسالة الوضع المقيّد، ويظهر في الصفحة زر «浏览» (استعراض) وقائمة الإضافات المثبّتة.


**تعثّرت؟ لا تجد «第三方插件» (الإضافات الخارجية) في القائمة اليسرى**

هذا يعني أن إصدار Obsidian قديم. ارجع إلى «التنزيل والتثبيت» وثبّت 1.15.1، أو شغّل في «الطرفية» على Windows الأمر `winget upgrade Obsidian.Obsidian`، ثم أعد فتح الإعدادات بعد التثبيت.




### ابحث عن Copilot وثبّته

انقر «浏览» (استعراض) للدخول إلى سوق إضافات المجتمع. اكتب `Copilot` في حقل البحث (①)، واختر من النتائج ② إضافة Copilot التي مطوّرها Logan Yang، وتعرض صفحة التفاصيل على اليمين الإصدار 4.1.0، فانقر ③ «安装» (تثبيت).

![سوق إضافات المجتمع: كُتب Copilot في حقل البحث، والنتيجة الأولى Copilot 4.1.0 من تطوير Logan Yang، وفي أسفل صفحة التفاصيل على اليمين زر التثبيت](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/05-browse-copilot.webp)


إذا فعلتها بشكل صحيح فسترى: يبدأ الزر بالدوران، وبعد عشرات الثواني يتحول الموضع نفسه إلى «启用» (تمكين).




### انقر «启用» (تمكين) لتشغيل الإضافة

بعد اكتمال التثبيت يتحول الزر تلقائيًا إلى «启用» (تمكين)، فانقر ① «启用». وإذا ظهرت نافذة «信任作者并启用插件» (الوثوق بالمطوّر وتمكين الإضافة)، فانقر خيار الوثوق.

![صفحة تفاصيل إضافة Copilot: الإصدار المثبّت 4.1.0، وفي أسفل اليسار زر «启用» (تمكين) البنفسجي](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/06-enable-copilot.webp)


إذا فعلتها بشكل صحيح فسترى: بالعودة إلى قائمة «第三方插件» (الإضافات الخارجية) في الإعدادات يظهر Copilot في قائمة المثبّتة وحالته مُمكَّن.


**تعثّرت؟ تظهر رسالة تطلب الوثوق بالمطوّر**

هذا تأكيد معتاد من Obsidian لإضافات المجتمع. راجع اسم المطوّر (Logan Yang) وعنوان المستودع، ثم انقر «信任作者并启用» (الوثوق بالمطوّر والتمكين)، ولن يُسأل مرة أخرى.




### افتح صفحة BYOK في Copilot

اضغط `Ctrl` + `,` للعودة إلى الإعدادات، وانقر في القائمة اليسرى تحت مجموعة «第三方插件» (الإضافات الخارجية) على ① «Copilot»، ثم انتقل إلى ② علامة تبويب «BYOK»، وانقر ③ «+ Add a provider».

![صفحة Copilot في إعدادات Obsidian: التبويب العلوي على BYOK، والعنوان Bring your own key، وفي أعلى اليمين زر + Add a provider البنفسجي، وأدناه تنبيه بأنه لا يوجد أي مزوّد بعد](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/07-copilot-byok-entry.webp)


إذا فعلتها بشكل صحيح فسترى: تظهر نافذة «Add a provider» وفيها صف من أسماء المزوّدين.




### اختر «Add a custom provider»

تسرد النافذة المزوّدين الشائعين حسب الفئة. نماذج GPT والنماذج الصينية عبر QCode تستخدم بروتوكول OpenAI المتوافق، فانقر في الأسفل ① «+ Add a custom provider»؛ وإن أردت استخدام Claude أيضًا فانقر ② «Add Anthropic provider».

![نافذة Add a provider: في الأعلى قائمة المزوّدين الموصى بهم، وفي الأسفل زر + Add a custom provider، وفوقه عنصر Add Anthropic provider](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/08-byok-add-provider.webp)


إذا فعلتها بشكل صحيح فسترى: يظهر نموذج «Configure Custom OpenAI-compatible»، ومن الأعلى إلى الأسفل: Display name وAPI key وBase URL وEnable CORS وModels.




### املأ عنوان QCode والمفتاح

اكتب في Display name القيمة `QCode`؛ والصق في API key السلسلة كاملة التي تبدأ بـ `cr_`؛ واكتب في Base URL القيمة `https://api.qcode.cc/openai/v1` عند ①، إلى `/v1` فقط دون شرطة مائلة في النهاية؛ ثم شغّل مفتاح ② «Enable CORS»؛ وانقر أخيرًا ③ «Test».

![نموذج Configure Custom OpenAI-compatible: Display name هو QCode، وAPI key محجوب، وBase URL هو https://api.qcode.cc/openai/v1، ومفتاح Enable CORS مُشغَّل، وعلى اليمين زرا Test وSave](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/09-byok-qcode-openai-fill.webp)


إذا فعلتها بشكل صحيح فسترى: يظهر على يمين «Test» شعار «Verified» الأخضر، ويبدأ قسم Models أدناه بسرد أسماء النماذج.


**تحتاج مفتاح API؟**

إن لم يكن لديك حساب QCode بعد، [أنشئ حساب QCode](https://qcode.cc/ar/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-obsidian-copilot-key) أولًا. وإذا أردت الدفع حسب الاستخدام، فاشترِ أولًا [باقة الدفع حسب الاستخدام](https://qcode.cc/ar/pay-as-you-go?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-obsidian-copilot-key)، ثم أنشئ المفتاح في [لوحة التحكم](https://qcode.cc/ar/dashboard). انسخ السلسلة كاملة التي تبدأ بـ `cr_` والصقها في حقل API key. ويمكنك الدفع ببطاقة الائتمان / الخصم (Visa / Mastercard)، أو Apple Pay / Google Pay، أو العملات المشفرة — راجع [طرق الدفع](/docs/reference/payment-methods).


**تعثّرت؟ يعرض Test الحالة Verified، لكن إرسال الرسائل يعطي Failed to fetch**

السبب أن «Enable CORS» غير مشغّل. لوحة المحادثة في Obsidian تعمل عبر واجهات المتصفح، فبدون تشغيل هذا المفتاح ينجح الاختبار ولا تُرسل الرسائل. ارجع إلى هذه الخطوة وشغّل مفتاح ②، ثم انقر «Test» مرة أخرى.




### حدّد النموذج واحفظ

شعار «Verified» الأخضر عند ① بجوار المفتاح يعني أن العنوان والمفتاح صحيحان؛ حدّد في قائمة النماذج ② `gpt-6.2-sol`، ثم انقر ③ «Save».

![النموذج بعد نجاح Test: شعار Verified الأخضر بجوار API key، وأسفل Model ID قائمة النماذج المكتشفة تلقائيًا، وgpt-6.2-sol محدَّد، وفي أسفل اليمين زر Save](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/10-byok-qcode-openai-verified.webp)


إذا فعلتها بشكل صحيح فسترى: تُغلق النافذة، ويظهر في قائمة BYOK سطر جديد `QCode` وعلى يمينه «Verified» الأخضر.




### أضف نقطة وصول Claude أخرى (اختياري)

① هو شعار «Verified» الأخضر الذي يظهر بعد نجاح Test. وقبل الاختبار انقر «+ Add a provider» ← «Add Anthropic provider»، واكتب في Display name القيمة `QCode Claude`، والصق المفتاح نفسه `cr_`، واكتب في Base URL القيمة `https://api.qcode.cc/api` عند ②، وشغّل «Enable CORS»، ثم انقر «Test» وانتظر حتى يتحول إلى الأخضر، وأضف `claude-opus-5-5` في Model ID، وانقر أخيرًا ③ «Save».

![نموذج Configure Anthropic: Display name هو QCode Claude، وBase URL هو https://api.qcode.cc/api، وEnable CORS مُشغَّل، وشعار Verified بجوار المفتاح، ونموذج Claude Opus 5.5 محدَّد في قائمة النماذج](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/11-byok-qcode-anthropic.webp)


إذا فعلتها بشكل صحيح فسترى: بعد إغلاق النافذة تعود إلى قائمة BYOK، وهذه المرة ليست فارغة بل فيها سطرا مزوّدين.


**تعثّرت؟ تريد GPT فقط، فهل يمكن تخطي هذه الخطوة**

نعم. إن كنت ستستخدم `gpt-6.2-sol` فقط فتخطَّ هذه الخطوة بالكامل، وأتمّ ما بعدها، مع استبدال كل ما يتعلق بـ Claude بـ GPT.




### تأكد من نجاح نقطتي الوصول

ارجع إلى قائمة «BYOK» وتحقق من السطرين: ① `QCode` (متوافق مع OpenAI) و② `QCode Claude` (Anthropic)، ويجب أن يكون على يمين كل منهما «Verified» الأخضر.

![قائمة BYOK: سطرا المزوّدين QCode وQCode Claude، وعلى يمين كل سطر شعار Verified الأخضر، وفي أعلى اليمين زر + Add a provider](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/12-byok-saved-list.webp)


إذا فعلتها بشكل صحيح فسترى: السطران يحملان «Verified» الأخضر، ولا يوجد أي تنبيه أحمر أو «Invalid key».




### مكّن النماذج في Quick Chat

ارجع إلى ① علامة تبويب «Quick Chat» (وهي في صف Basic → Agents). تأكد من أن ② Default model هو `gpt-6.2-sol`؛ وعند ③ توجد قائمة مفاتيح النماذج، ويجب تشغيل `gpt-6.2-sol` في `QCode` و`Claude Opus 5.5` في `QCode Claude`.

![تبويب Quick Chat في إعدادات Copilot: التبويب العلوي محدَّد على Quick Chat، وقائمة Default model تعرض gpt-6.2-sol، وأدناه مجموعتا مفاتيح نماذج QCode وQCode Claude](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/13-quick-chat-models.webp)


إذا فعلتها بشكل صحيح فسترى: المفتاحان مفتوحان باللون البنفسجي، وسطر Default model يعرض `gpt-6.2-sol`.


**تعثّرت؟ قائمة النماذج فيها GPT فقط دون Claude**

تأكد أولًا من أن `QCode Claude` في الخطوة السابقة يحمل «Verified» الأخضر. ثم ارجع إلى هذه الصفحة وشغّل مفتاح `Claude Opus 5.5`؛ وإن لم يظهر بعد، فانقر «重新加载插件» (إعادة تحميل الإضافات) أعلى الإعدادات وادخل مرة أخرى.




### افتح Quick Chat من لوحة الأوامر

أغلق الإعدادات وارجع إلى نافذة الملاحظة، واضغط `Ctrl` + `P` لفتح لوحة الأوامر، واكتب `Quick Chat`، واختر ① «Copilot: Open Copilot Quick Chat window» ثم اضغط Enter.

![لوحة أوامر Obsidian: بعد كتابة Quick Chat تظهر أربعة أوامر ذات صلة، والثاني هو Copilot: Open Copilot Quick Chat window](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/14-command-palette-quick-chat.webp)


إذا فعلتها بشكل صحيح فسترى: تُفتح لوحة Copilot على يمين النافذة، وفي الأسفل حقل إدخال واسم النموذج، وفي الوسط تلميح إلى إمكانية إضافة سياق بالضغط على @.


**تعثّرت؟ النقر على «Open Copilot Chat» يطلب تنزيل شيء آخر**

ذلك هو وضع agent في Copilot V4، ويحتاج إلى تثبيت بيئة تشغيل منفصلة، وهو طريق مختلف عن BYOK في هذا الدليل. اعتمد على الأمر الذي يحتوي اسمه على «Quick Chat window».




### اطلب منه تلخيص الملاحظة الحالية

اكتب في حقل الإدخال على اليمين «用三句话总结当前笔记» (لخّص الملاحظة الحالية في ثلاث جمل) واضغط Enter. تُرفق اللوحة تلقائيًا ملاحظة «欢迎» الحالية، وبعد ثوانٍ يظهر عند ① التلخيص، وعند ② يظهر أن النموذج المستخدم هذه المرة هو `gpt-6.2-sol`.

![لوحة Quick Chat على اليمين: السؤال المرسل والتلخيص المكوَّن من ثلاث جمل، ومحدِّد النموذج في الأسفل يعرض gpt-6.2-sol، وفوق حقل الإدخال تظهر ملاحظة «欢迎» المرفقة حاليًا](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/15-quick-chat-gpt-reply.webp)


إذا فعلتها بشكل صحيح فسترى: الرد مكتوب بالصينية بأسلوب سليم، ومحتواه فعلًا عن ملاحظة «欢迎» (ترحيب)، واسم النموذج في الأسفل `gpt-6.2-sol`.




### بدّل إلى Claude واسأل سؤالًا آخر

① هو رد Claude بعد تبديل النموذج. بدّل أولًا في ② قائمة النماذج من `gpt-6.2-sol` إلى «Claude Opus 5.5»، ثم اكتب «你好，用一句话介绍你自己» (مرحبًا، عرّف بنفسك في جملة واحدة) واضغط Enter، وبعد ثوانٍ يظهر الرد عند ①.

![لوحة Quick Chat نفسها: السؤال ورد Claude بالصينية، ومحدِّد النموذج في الأسفل تُغيّر من gpt-6.2-sol إلى Claude Opus 5.5](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/16-quick-chat-claude-reply.webp)


إذا فعلتها بشكل صحيح فسترى: الجواب بالصينية، واسم النموذج في الأسفل أصبح «Claude Opus 5.5»، ويظهر في الوسط سطر «Thought for a while».




### تحقق من الطلبات في probe.qcode.cc

افتح [probe.qcode.cc](https://probe.qcode.cc/)، والصق المفتاح نفسه `cr_`، وانقر «查询» (استعلام)، وسيكون أول سطر في القائمة هو المحادثة الأخيرة: السطر المؤطَّر عند ① يطابق التوقيت، وحالته `200`.

![قائمة الطلبات في probe.qcode.cc: وقت وحالة أحدث الأسطر، وحالة أحدث سطر 200، ويمكن رؤية زمن الاتصال وزمن أول حرف وحجم الاستجابة](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/17-probe-requests.webp)


إذا فعلتها بشكل صحيح فسترى: عمود الحالة `200`، والوقت يطابق لحظة إرسال رسالتك، ما يعني أن الطلب مرّ فعلًا عبر QCode.




## التحقق من النجاح

إذا تحققت الأمور الأربعة التالية فقد أصبح Copilot في Obsidian موصولًا بـ QCode بالكامل:

- في الإعدادات ← «第三方插件» (الإضافات الخارجية) ← «Copilot» ← «BYOK» يعرض `QCode` و`QCode Claude` شعار «Verified» الأخضر؛
- في «Basic» ← Agents ← «Quick Chat» يكون `gpt-6.2-sol` هو Default model، ومفتاح `Claude Opus 5.5` مفتوحًا؛
- تشغيل «Copilot: Open Copilot Quick Chat window» من لوحة الأوامر وإرسال «用三句话总结当前笔记» (لخّص الملاحظة الحالية في ثلاث جمل) يُستلم رد في غضون ثوانٍ؛
- إدخال المفتاح نفسه في [probe.qcode.cc](https://probe.qcode.cc/) يعرض الطلب الأخير وحالته `200`.


### انتهى كل شيء

يمكنك الآن تحديد مقطع لم تفهمه في ملاحظاتك، واستخدام Quick Chat على اليمين لتطلب من `gpt-6.2-sol` أو `claude-opus-5-5` شرحه وتلخيصه وإعادة صياغته. ويمكنك بعد ذلك:

- [نقاط الوصول وصيغ API](/docs/getting-started/endpoints-and-api-paths)
- [النماذج الصينية](/docs/usage/cn-models)
- [شرح الفوترة](/docs/reference/billing)
- التالي: قارن الخطط في [صفحة الأسعار](https://qcode.cc/ar/pricing?utm_source=docs.qcode.cc&utm_medium=tut_done&utm_campaign=knowledge_base&src=docs-ide-obsidian-copilot-done)
- ارجع إلى [لوحة التحكم](https://qcode.cc/ar/dashboard) لمراجعة الاستخدام والرصيد


## الأخطاء الشائعة

| نص الخطأ | السبب | ما العمل |
|---|---|---|
| `Connection error. more message: Failed to fetch` | ينجح Test لكن لوحة المحادثة لا ترسل الرسائل، لأن «Enable CORS» غير مشغّل | افتح في BYOK السطر `QCode`، وشغّل مفتاح «Enable CORS»، وانقر «Test» مرة أخرى، ثم أعد فتح Quick Chat |
| `{"error":{"message":"Invalid URL (POST /v1/chat/completions/chat/completions)","type":"invalid_request_error"}}` | أُضيف `/chat/completions` إلى Base URL، فأضافه العميل تلقائيًا مرة أخرى | اكتب في Base URL القيمة `https://api.qcode.cc/openai/v1` فقط، دون شرطة مائلة في النهاية ودون `/chat/completions`، ثم أعد الإدخال وانقر «Test» |
| `401 invalid_api_key` | المفتاح غير كامل، أو حوله مسافات، أو أنه مفتاح مزوّد آخر | ارجع إلى لوحة التحكم وانسخ السلسلة كاملة التي تبدأ بـ `cr_`، والصقها في حقل API key دون مسافات قبلها أو بعدها، ثم انقر «Test» |
| `Missing API key` | حقل API key ما زال فارغًا، أو لصقت المفتاح ثم بدّلت التبويب دون حفظ | الصق المفتاح في API key، وتأكد من ظهور محتوى يبدأ بـ `cr_` في الحقل، ثم انقر «Test» و«Save» بالترتيب |

## الأسئلة الشائعة

### ماذا أفعل بعد انتهاء صلاحية المفتاح؟

الأمر يختلف بحسب نوع المفتاح: مفتاح الخطة الشخصية لا يمكن تجديده بعد انتهاء الصلاحية، بل يجب فتح خطة جديدة والحصول على مفتاح جديد؛ أما مفتاح باقة الدفع حسب الاستخدام فيعود للعمل تلقائيًا بعد شراء باقة جديدة بالمفتاح نفسه.

بعد الانتقال إلى مفتاح جديد ارجع إلى BYOK وافتح `QCode` (وكذلك `QCode Claude`)، وأعد لصق المفتاح، وانقر «Test»، ثم انقر «Save» بعد نجاحه.

### لا أرى النموذج المضاف حديثًا في Quick Chat؟

BYOK يربط المزوّد فقط، أما النماذج فتُشغَّل على حدة: اذهب إلى «Basic» ← Agents ← «Quick Chat»، وشغّل مفتاح النموذج المطلوب، واختره في Default model. وإذا لم تتحدث صفحة الإعدادات، فانقر «重新加载插件» (إعادة تحميل الإضافات) أعلى الصفحة ثم ارجع.

### هل يجب تشغيل «Enable CORS» دائمًا؟

نعم يجب تشغيله. فبدون تشغيله يعرض Test أيضًا «Verified»، لكن إرسال الرسائل في Quick Chat يفشل. ويجب تشغيل هذا المفتاح في نقطتي وصول GPT وClaude معًا.

### هل يمكن استخدام المفتاح نفسه في نقطتي الوصول معًا؟

نعم. المفتاح نفسه `cr_` صالح في نقطة وصول Anthropic (`https://api.qcode.cc/api`) وفي نقطة الوصول المتوافقة مع OpenAI (`https://api.qcode.cc/openai/v1`)، ويُحتسب الاستخدام كله في الحساب نفسه.

### هل أحتاج إلى ترخيص Copilot أو تسجيل دخول بحساب؟

لا. هذا الدليل يستخدم BYOK: مفتاحك الخاص يتصل بـ QCode مباشرة، دون تسجيل الدخول إلى حساب أي مزوّد نماذج، ودون ربط حساب Copilot مدفوع.

## نقاط وصول أخرى

النطاقات الثلاثة متكافئة في القدرات ويختلف بينها مسار الشبكة فقط، والمفتاح نفسه صالح فيها جميعًا. وإذا كان الاتصال بـ `api.qcode.cc` بطيئًا من شبكة البر الرئيسي، فاستبدل العنوان بعقدة آسيا وانقر «Test» مرة أخرى.

| العقدة | Anthropic (Claude) | متوافق مع OpenAI (GPT / النماذج الصينية) |
|---|---|---|
| عالمي | `https://api.qcode.cc/api` | `https://api.qcode.cc/openai/v1` |
| آسيا (المفضّلة من البر الرئيسي) | `https://asia.qcode.cc/api` | `https://asia.qcode.cc/openai/v1` |
| أمريكا الشمالية / أوروبا | `https://us.qcode.cc/api` | `https://us.qcode.cc/openai/v1` |

## النماذج المتاحة

| النموذج | Model ID الذي تكتبه في Copilot | الشرح |
|---|---|---|
| Claude Opus 5.5 | `claude-opus-5-5` | التوصية الافتراضية لنقطة وصول Anthropic |
| Claude Haiku 5.5 | `claude-haiku-5-5` | بديل خفيف، وردوده أسرع |
| GPT 6.2 Sol | `gpt-6.2-sol` | التوصية الافتراضية لنقطة الوصول المتوافقة مع OpenAI |
| GPT 6.2 Astra | `gpt-6.2-astra` | بديل أعلى طرازًا |
| GLM 5.3 | `glm-5.3` | النموذج الصيني الأساسي، عبر نقطة الوصول المتوافقة مع OpenAI |

نماذج Claude تُكتب فقط في نقطة وصول Anthropic المسماة `QCode Claude`، أما نماذج GPT والنماذج الصينية فتُكتب في نقطة الوصول المتوافقة مع OpenAI المسماة `QCode`. وإذا كتبتها في نقطة الوصول الخطأ فسيفشل Test. راجع [النماذج الصينية](/docs/usage/cn-models) للقائمة الكاملة.

## نظرة سريعة على التكامل

| البند | الشرح |
|---|---|
| الإضافة | Copilot for Obsidian 4.1.0 (المطوّر Logan Yang، تُثبَّت من سوق إضافات المجتمع) |
| البروتوكول وBase URL | Anthropic: `https://api.qcode.cc/api` · متوافق مع OpenAI: `https://api.qcode.cc/openai/v1` |
| المفتاح | مفتاح `cr_` من حساب QCode نفسه، ويصلح لنقطتي الوصول |
| المفتاح الإلزامي | «Enable CORS» (يُشغَّل في نقطتي الوصول) |
| مدخل المحادثة | «Copilot: Open Copilot Quick Chat window» من لوحة الأوامر |
| الوثائق الرسمية | [صفحة تنزيل Obsidian](https://obsidian.md/download) · [مستودع إضافة Copilot](https://github.com/logancyang/obsidian-copilot) |

## ما الفرق بينه وبين Copilot Chat

في Copilot V4 طريقان لا يتقاطعان:

- **Quick Chat (هذا الدليل)**: تطرح السؤال على الملاحظة الحالية في الشريط الأيمن، ويأتي النموذج من المزوّد الذي ربطته في BYOK، فيكفي عنوان ومفتاح للاستخدام.
- **Copilot Chat (وضع agent)**: يستدعي بيئات تشغيل مثل OpenCode وClaude Code وCodex، ويحتاج إلى تثبيت منفصل أو تسجيل دخول إلى الحساب المقابل، وإعداده أثقل بكثير.

إن أردت فقط أن يقرأ الذكاء الاصطناعي ملاحظاتك ويجيب عن الأسئلة ويعدّل النصوص، فـ Quick Chat يكفي؛ وإذا احتجت إلى أن يعدّل عدة ملفات ويشغّل الأوامر بنفسه، فحينها تعرّف على وضع agent.

## وثائق ذات صلة

- [نقاط الوصول وصيغ API](/docs/getting-started/endpoints-and-api-paths) — العناوين وعائلات النماذج لكل بروتوكول
- [النماذج الصينية](/docs/usage/cn-models) — معرّفات النماذج الصينية المتاحة في نقطة الوصول المتوافقة مع OpenAI
- [شرح الفوترة](/docs/reference/billing) — كيف يُحتسب الاستخدام
- [استكشاف الأخطاء](/docs/reference/troubleshooting) — مشكلات الاتصال والمصادقة الشائعة