استخدام Obsidian وClaude Code لبناء سرب بحثي: 6 خطوات لإضافة نتائج البحث تلقائيًا إلى قاعدة المعرفة

في الأيام الماضية، حظي منشور على X بعدد كبير من المشاهدات: «مطوّر صيني يبلغ من العمر 23 عامًا» شغّل 300 نسخة من Claude Code بالتوازي، وقارن كل مخرجاتها بالملفات المصدرية خلال نحو 100 مللي ثانية، ثم أضاف أكثر من 100 ملف تعريفي لشركات إلى Obsidian «من دون أي أخطاء».

الفكرة الأجدر بالتعلّم في المنشور هي: دع نموذجًا مكلفًا ينجز العمل، ونموذجًا رخيصًا يتحقق من صحة النتائج؛ أعد غير المقبول للمراجعة، ولا تحفظ إلا ما اجتاز التحقق.

دليل عملي يمكنك اتباعه لتشغيل هذا النظام. تعتمد العملية بأكملها أساسًا على الواجهة الرسومية والتحدث إلى Claude Code بلغة طبيعية، ولا تتطلب معرفة بالبرمجة.

الفائدة الأساسية: بعد قراءة هذا المقال، ستتمكن من إعداد سرب بحث صغير على حاسوبك. تتولى الجلسة الرئيسية تقسيم الموضوع إلى مهام، بينما يبحث عدد من الوكلاء الفرعيين بالتوازي، ويتولى وكيل فرعي منخفض التكلفة التحقق من كل نتيجة وتمحيصها. وتُحفظ الاستنتاجات التي تجتاز التحقق تلقائيًا في مكتبة Obsidian، مرفقةً بالمصادر وعلامة التحقق.

استخدام Obsidian مع Claude Code لإنشاء سرب بحثي: قبل البدء

قبل أن تبدأ، تأكد من استيفاء الشروط التالية:

• الهدف: تتولى الجلسة الرئيسية (Opus) تقسيم الموضوع وتلخيص النتائج، بينما يبحث وكيلان أو ثلاثة وكلاء فرعيين للبحث (Sonnet) عن المعلومات بالتوازي، ويتحقق وكيل فرعي واحد (Haiku) من صحة كل معلومة على حدة. تُدوَّن النتائج التي اجتازت التحقق في مجلد «ملاحظات البحث» داخل Obsidian.
• الوقت المطلوب: خصص فترة بعد ظهر لإعداد النظام للمرة الأولى. بعد ذلك، يكفي إعداد قائمة مهام لكل بحث وإرسالها بجملة واحدة.
• المتطلبات المسبقة: تثبيت تطبيق Obsidian لسطح المكتب وClaude Code، وتجهيز حساب APIYI، والتأكد من أن الكمبيوتر متصل بالإنترنت ويمكنه الوصول إلى روابط المصادر المستهدفة.
• مستوى الصعوبة: للمبتدئين. لن تحتاج إلى كتابة أي شيفرة، ولن تظهر ملفات الإعداد إلا في أقسام اختيارية قابلة للطي.

فيما يلي مخطط عام للمسار، مع معيار قبول لكل خطوة. أنجز كل خطوة، ثم قارن النتيجة بمعيار القبول للتأكد من صحتها قبل الانتقال إلى الخطوة التالية.

أبرز نقاط بحث السرب

لماذا نقسّم أدوار سرب البحث إلى «إنجاز العمل» و«التحقق من صحة المعلومات»؟

إن زيادة عدد الوكلاء من دون إضافة التحقق تؤدي إلى تسلل مزيد من الهلوسات كلما زاد التوازي. وعند توزيع البحث والتحقق على نموذجين، لا يحتاج المدقق إلا إلى الإجابة عن سؤال واحد: هل يوجد ما يسند هذا الاستنتاج في الاقتباس المأخوذ من المصدر الأصلي؟ هذه المهمة أبسط بكثير من إجراء البحث نفسه، لذا يكفي إسنادها إلى Haiku الأقل تكلفة.

هناك نصيحة عملية أخرى في قسم التعليقات: يجب ألا يطّلع المدقق على مسار استدلال الباحث، بل على الاستنتاج والنص الأصلي فقط، وإلا فقد يتأثر بما يقوله الباحث. كذلك، يقتصر إخراج المدقق على «مقبول / مرفوض + السبب»، ولا يجوز له تعديل المحتوى بنفسه. فإذا تولى المدقق تعديل المحتوى أيضًا، اختلط دوره بدور الباحث. وقد أُعدّت الإعدادات في هذا المقال وفق هاتين القاعدتين تمامًا.

لماذا لا تحتاج إلى تثبيت إضافات أو MCP للبدء باستخدام Obsidian؟

مكتبة Obsidian في جوهرها مجلد، ويمكن لأدوات القراءة والكتابة المدمجة في Claude Code التعامل مباشرة مع ملفات .md فيه، بينما يحدّث Obsidian عرضها تلقائيًا. وفي الاختبار العملي من جهة خارجية المذكور سابقًا (مكتبة صغيرة تضم 560 ملاحظة، مع تشغيل كل أداة مرة واحدة فقط)، استهلكت المجموعة الضابطة التي لم تثبّت أي شيء أقل عدد من الرموز. لذا لا داعي إلى الانشغال بالإضافات في البداية. أما الأداء مع المكتبات الأكبر، فلا تتوفر عنه بيانات حتى الآن.

البدء السريع بسرب بحث باستخدام Obsidian وClaude Code

الخطوة ①: أنشئ مكتبة في Obsidian وأعدّ ملف CLAUDE.md

افتح Obsidian واختر «إنشاء مكتبة» (لإنشاء مكتبة فارغة جديدة). سمّها 调研库، واختر لها موقعًا يسهل العثور عليه، مثل «المستندات». لا تضع هذه المكتبة داخل مجلد مكتبة أخرى، لأن تداخل المكتبات قد يؤدي إلى تعطل الروابط الداخلية.

انقر بزر الفأرة الأيمن على «إنشاء مجلد جديد» في شريط الملفات الجانبي، وأنشئ المجلدات الأربعة التالية بالترتيب: 任务清单، 原始资料، 调研笔记، 打回记录.

بعد ذلك، أنشئ ملاحظة في جذر المكتبة وسمّها CLAUDE.md، ثم أضف إليها قواعد إدخال المحتوى إلى المكتبة. سيقرأ Claude Code هذا الملف كلما شُغّلت جلسة في هذا المجلد:

# 调研库入库规则
1. 只读写这 4 个文件夹：任务清单、原始资料、调研笔记、打回记录。绝不读写 .obsidian 文件夹。
2. 每条结论必须附来源链接和原文摘录（引号原样摘抄）。
3. 没有通过核查员核查的内容，不得写入「调研笔记」。
4. 打回超过 3 轮仍不通过的，写入「打回记录」并注明理由，等人工处理。
5. 调研笔记顶部写属性：status、来源、核查模型、日期。

بعد إتمام الخطوة، سترى: أربعة مجلدات وملف CLAUDE.md في الشريط الجانبي لـ Obsidian. وفي جذر المكتبة أيضًا مجلد إعدادات باسم .obsidian، يخفيه Obsidian افتراضيًا. يحتوي هذا المجلد على إعدادات Obsidian نفسه، ولا ينبغي لأي وكيل تعديله.

الخطوة ②: اربط رمز APIYI بـ Claude Code

لن نكرر في هذه الخطوة تفاصيل الإعداد. اتبع شرح استخدام magpie لربط Claude Code وCodex وPi وHermes وغيرها من الأدوات من نافذة موحدة لربط رمز APIYI من خلال الواجهة الرسومية، ثم عد إلى هنا.

لا تنسَ سوى هاتين النقطتين:

• عند إنشاء رمز في لوحة تحكم APIYI، اختر ClaudeCode ضمن المجموعة.
• أدخل عنوان الواجهة https://api.apiyi.com، ولا تضف /v1 في نهايته.

بعد الربط، افتح الطرفية من مجلد 调研库 وشغّل Claude بكتابة claude. اطرح عليه أي سؤال؛ وإذا أجاب بشكل طبيعي، فهذا يعني أن الاتصال يعمل.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apiyi.com",
    "ANTHROPIC_AUTH_TOKEN": "你的 APIYI 令牌"
  }
}

بعد إتمام الخطوة، سترى: أن Claude Code يجيب عن الأسئلة بشكل طبيعي. وستظهر أيضًا سجلات استخدام لهذا الرمز في لوحة تحكم APIYI، وهذا يعني أن الطلبات أُرسلت باستخدامه بالفعل.

الخطوة ③: اطلب من Claude Code إنشاء وكيلي البحث والتحقق بجملة واحدة

الوكيل الفرعي عبارة عن ملف Markdown يتضمن ترويسة YAML؛ لست بحاجة إلى كتابته بنفسك، إذ يمكن أن يتولى Claude ذلك. أرسل إليه النص التالي في Claude Code:

请在当前项目的 .claude/agents/ 下创建两个子代理：
1. researcher（调研员）：模型 claude-sonnet-5-5。只用 WebFetch 读任务清单里给的链接，
   每条结论附来源链接和原文摘录，把结果写到「原始资料」文件夹。不给 Agent 工具。
2. fact-checker（核查员）：模型 claude-haiku-5-5。只给 Read、Grep、Glob，
   不给 Write、Edit、Agent。它只接收“结论 + 原文摘录 + 来源文件路径”，
   不看调研员的推理过程，只输出「通过」或「打回 + 理由」，不得自己修改任何内容。

تستخدم الجلسة الرئيسية نفسها claude-opus-5-5، وتتولى تقسيم المهام وتوزيعها وتجميع النتائج. يمكنك التبديل إليه بعد بدء التشغيل باستخدام /model، أو ضبطه مباشرةً في الأداة المستخدمة في الخطوة ②.

---
name: researcher
description: 按任务清单读取给定链接，产出带来源和原文摘录的调研结论
tools: Read, Grep, Glob, WebFetch, Write
model: claude-sonnet-5-5
maxTurns: 20
---
你是调研员。只读取任务里给出的链接。每条结论格式：
结论 / 来源链接 / 原文摘录（原样引用）。写入「原始资料」文件夹，不碰其他目录。

---
name: fact-checker
description: 逐条核对结论是否被原文摘录支持，只判定不修改
tools: Read, Grep, Glob
model: claude-haiku-5-5
maxTurns: 8
---
你是核查员。只看结论和原文，不接受任何推理说明。
每条输出「通过」或「打回：理由」。摘录不支持、数字对不上、来源缺失一律打回。
你没有写权限，也不得建议替换措辞以外的任何修改。

ملاحظة: بعد إنشاء مجلد .claude/agents/ للمرة الأولى، عليك إنهاء جلسة Claude Code وإعادة فتحها مرة واحدة. بعد ذلك، تسري التعديلات التي تجريها على ملفات الوكلاء الفرعيين تلقائيًا خلال بضع ثوانٍ. ولا يمكن للوكيل الفرعي الذي لم يُمنح أداة Agent أن يكلّف وكلاء فرعيين آخرين، ما يمنع التداخل المتسلسل وفقدان السيطرة.

بعد إتمام الخطوة، سترى: عند إدخال /agents، يظهر researcher وfact-checker في القائمة، مع النموذج المحدد لكل منهما.

الخطوة ④: اكتب قائمة المهام وأرسل طلبًا واحدًا لتوزيع البحث بالتوازي

أنشئ الملف 第一批.md في مجلد «任务清单» في Obsidian. فيما يلي مثال يبحث في خمسة منتجات، مع رابط مباشر لكل منتج. والسبب هو أن الوثائق الرسمية لا توضح ما إذا كان WebSearch متاحًا عند الاستدعاء عبر بوابة خارجية؛ لذا فإن تزويد الوكيل الفرعي بالروابط مباشرةً وطلب قراءتها باستخدام WebFetch هو الخيار الأضمن.

# 第一批：5 个产品定价与功能
1. 产品 A：定价页 https://example-a.com/pricing ，功能页 https://example-a.com/features
2. 产品 B：https://example-b.com/pricing
3. 产品 C：https://example-c.com/docs/plans
4. 产品 D：https://example-d.com/pricing
5. 产品 E：https://example-e.com/changelog
每条要回答：最低付费档价格、是否有免费版、最近一次功能更新。

عد إلى Claude Code وأرسل إليه العبارة التالية:

读取 任务清单/第一批.md，把 5 条任务分给 researcher 子代理并行调研，
各自写入「原始资料」。全部完成后告诉我每条的结论数量。

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

بعد إتمام الخطوة، سترى: ظهور خمسة ملفات تباعًا في مجلد «原始资料» في Obsidian، ويحتوي كل ملف على بنود بصيغة «الاستنتاج / رابط المصدر / اقتباس من النص الأصلي».

الخطوة ⑤: اضبط دورة التحقق، مع إعادة لا تتجاوز 3 جولات

واصل المحادثة مع الجلسة الرئيسية وقل لها:

对「原始资料」里的每条结论，只把“结论 + 原文摘录 + 来源路径”交给 fact-checker。
通过的，由你写入「调研笔记」，顶部属性填 status: 已核查、来源、核查模型: claude-haiku-5-5、日期。
打回的，把理由交给 researcher 重写后再核查，最多 3 轮；
3 轮仍不过的，写入「打回记录」并附理由，不要放进调研笔记。

هذا ما تسميه الوثائق الرسمية «الوكلاء الفرعيين المتسلسلين»: يُكمل الوكيل الفرعي A عمله أولًا، ثم تُمرر النتيجة إلى الوكيل الفرعي B. وتعمل الجلسة الرئيسية هنا كمنسّق، فتتحكم بدقة في المعلومات التي يمكن للمدقق الاطلاع عليها، ولا تعطيه سوى الاستنتاج والنص الأصلي، من دون مسار الاستدلال.

بعد إتمام الخطوة، سترى: ظهور الاستنتاجات التي اجتازت التحقق في «调研笔记»، وقد تجد بعض البنود المصحوبة بأسباب الرفض في «打回记录». ووجود سجلات رفض أمر طبيعي، فهو دليل على أن المدقق يؤدي دوره.

الخطوة ⑥: راجع الاستنتاجات التي اجتازت التحقق في Obsidian

افتح أي ملاحظة بحثية، وينبغي أن تظهر الخصائص في أعلاها بشكل مشابه لما يلي:

---
status: 已核查
来源: https://example-a.com/pricing
核查模型: claude-haiku-5-5
日期: 2026-10-21
---

أدخل [status:已核查] في مربع البحث في Obsidian لتصفية جميع الملاحظات التي اجتازت التحقق. عند المراجعة، يُستحسن اختيار ملاحظتين أو ثلاث عشوائيًا، وفتح روابط مصادرها للتحقق بنفسك من النص الأصلي.

بعد إتمام الخطوة، سترى: أن كل استنتاج في نتائج التصفية يمكن تتبعه إلى النص الأصلي، وأن المحتوى المشكوك فيه محصور في «打回记录» بانتظار تقييمك.

توزيع الأدوار والأسعار في سرب البحث

تستخدم الأدوار الثلاثة رمز APIYI نفسه، والاختلاف الوحيد هو اسم النموذج. الأسعار في الجدول أدناه مأخوذة من واجهة الأسعار في APIYI بتاريخ 2026-10-21 (مجموعة default)، بينما تحصل مجموعة ClaudeCode افتراضيًا على خصم قدره 5٪.

ومن المهم توضيح بعض النقاط المتعلقة بالتكلفة: كلما زاد عدد الوكلاء الفرعيين، طالت النتائج التي يعيدها كل وكيل، فشغلت حيزًا أكبر من نافذة سياق الجلسة الرئيسية. كما يستهلك كل وكيل فرعي رموزًا بصورة مستقلة أثناء تشغيله.

جدول استكشاف أخطاء سرب البحث الشائعة وإصلاحها

إذا لم تكن متأكدًا من الأدوات المتاحة في الجلسة الحالية، فاسأل Claude مباشرةً: «ما الأدوات المتاحة لديك الآن؟» وسيعرضها لك.

متى لا يُنصح باستخدام Obsidian مع Claude Code لإنشاء سرب بحث؟

لهذه الطريقة كلفة ثابتة، لذا فهي لا تناسب جميع الحالات. في الحالات التالية، ستكون محادثة مباشرة مع Claude أبسط وأكثر توفيرًا للوقت:

• إذا كنت تبحث عن معلومة أو اثنتين فقط: ستفوق كلفة تقسيم المهمة وتوزيعها والتحقق منها كلفة البحث نفسه.
• إذا كانت كل المصادر في مقالة واحدة: اطلب من Claude قراءتها كاملةً ثم تلخيصها؛ فلا حاجة إلى تنفيذ المهام بالتوازي.
• إذا كنت بحاجة إلى بيانات آنية: مثل أسعار الأسهم أو أسعار الصرف المباشرة. من الأفضل جلب هذه البيانات عبر واجهات بيانات متخصصة، لأن محتوى صفحات الويب قد يكون قديمًا.
• إذا كانت الميزانية محدودة جدًا: يستهلك تعدد الوكلاء الفرعيين رموزًا أكثر بكثير؛ لذا من الأوفر أولًا تجربة المطلوب ضمن جلسة واحدة.

ورقة مرجعية سريعة لسرب البحث باستخدام Obsidian وClaude Code

احفظ هذا الجدول وارجع إليه كلما بدأت دفعة بحث جديدة.

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

النقاط الأساسية حول سرب البحث

• المنهج أهم من العدد: استخدم نموذجًا مكلفًا لإنجاز العمل، ونموذجًا منخفض التكلفة للتحقق من صحته؛ فعدد الوكلاء ليس هو العامل الحاسم.
• المكتبة مجرد مجلدات: يستطيع Claude Code قراءة ملفات Markdown وكتابتها مباشرةً، ولا تحتاج إلى إضافات للبدء.
• يجب أن تكون صلاحيات المدقّق للقراءة فقط: لا تمنحه صلاحيات Write أو Edit أو Agent؛ ودوره يقتصر على إخراج قرار بالقبول أو الإعادة.
• اعزل عملية الاستدلال: لا تعرض على المدقّق سوى الخلاصة والنص الأصلي، حتى لا يتأثر بآراء الباحث.
• استخدم WebFetch مع الروابط: لتجنب حدود WebSearch، ومن دون القلق بشأن دعم البوابة لهذه الميزة.
• إذا لم تُقبل المهمة بعد 3 جولات، فأحِلها إلى شخص: سجّلها في ملاحظات الإعادة، ولا تُدرجها في المكتبة قسرًا.
• اختبر التكاليف قبل تقديرها: استخدم رمز APIYI نفسه، ثم راجع الاستهلاك الفعلي في لوحة التحكم.

الخلاصة

يتلخص إعداد سرب بحث باستخدام Obsidian وClaude Code في ثلاث نقاط:

1. هيكل واضح: أربعة مجلدات وملف CLAUDE.md واحد، مع تحديد ما يمكن لكل طرف الكتابة فيه.
2. فصل المسؤوليات: يتولى Sonnet البحث، وHaiku التحقق، وOpus التنسيق؛ ولا يملك المدقّق صلاحية الكتابة.
3. حلقة متكاملة لإدخال المحتوى إلى المكتبة: لا تُضاف الملاحظات البحثية إلا بعد اجتياز التحقق. أما إذا لم تجتز، فتُعاد للمراجعة، وإذا أخفقت بعد 3 جولات، يتولى الأمر شخص.

ننصحك بالبدء بثلاث مهام صغيرة لاختبار سير العمل كاملًا، والتأكد من أن الملفات تُحفَظ في المواقع الصحيحة، وأن نتائج التحقق والتكاليف تلبي توقعاتك. بعد ذلك، استبدل الأمثلة بمهامك الخاصة، مثل متابعة المنافسين أو الأوراق البحثية أو أخبار القطاع. ويمكنك إعداد النماذج باستخدام رموز مجموعة ClaudeCode على APIYI apiyi.com؛ إذ تشترك النماذج الثلاثة في مفتاح واحد، ما يسهّل التبديل بينها.

📚 المراجع

1. وثائق الوكلاء الفرعيين في Claude Code: إنشاء الوكلاء الفرعيين، وأذونات الأدوات، وحقل النموذج، والبحث الموازي
2. الرابط: code.claude.com/docs/en/sub-agents

3. ملاحظة: المصدر الأساسي لإعداد الوكلاء الفرعيين في هذه المقالة

4. مرجع أدوات Claude Code: سلوك WebSearch وWebFetch والحد الأقصى لعدد مرات استخدامهما

5. الرابط: code.claude.com/docs/en/tools-reference

6. ملاحظة: يوضح سبب التوصية بإضافة الروابط مباشرةً إلى قائمة المهام

7. إعداد النماذج في Claude Code: الأسماء المستعارة للنماذج وأسماؤها الكاملة

8. الرابط: code.claude.com/docs/en/model-config

9. ملاحظة: للتأكد من الإصدارات المقابلة لـ opus وsonnet وhaiku

10. مستندات مساعدة Obsidian: الخزائن وطريقة تخزين الملفات

11. الرابط: obsidian.md/help

12. ملاحظة: للتأكد من أن الخزنة مجلد عادي، وأن التغييرات الخارجية تُحدَّث تلقائيًا

13. اختبار عملي من جهة خارجية: مقارنة أدوات الذكاء الاصطناعي في Obsidian (خزنة صغيرة تضم 560 مقالة، واختبار واحد)

14. الرابط: agentskillshub.top/best/obsidian-second-brain/

15. ملاحظة: مرجع للبدء دون تثبيت إضافات

16. دليل ربط Claude Code من APIYI

17. الرابط: docs.apiyi.com/scenarios/programming/claude-code
18. ملاحظة: يشرح مجموعة ClaudeCode والعنوان ومتغيرات البيئة

الكاتب: فريق APIYI التقني
للنقاش التقني: إذا واجهتكم أي مشكلة أثناء الإعداد، يسعدنا استقبال أسئلتكم في التعليقات. ولمزيد من إرشادات الربط، يمكنكم الرجوع إلى مركز التوثيق docs.apiyi.com التابع لـ APIYI.

مقالات ذات صلة

• دليل خطوة بخطوة: اربط جميع الوكلاء بمفتاح واحد عبر بوابة API موحّدة باستخدام Magpie مفتوح المصدر (مع Claude Code وCodex وPi وHermes أمثلةً): دليل عملي خطوة بخطوة: في نحو 30 دقيقة، اجعل جميع وكلاء البرمجة على جهازك (مثل Claude Code وCodex وPi وHermes) يستخدمون مفتاح API واحدًا وعنوان بوابة واحدًا، مع لقطات شاشة لواجهة magpie، وخطوات الربط، ومقارنة بالإعدادات الأصلية، وجدول لاستكشاف الأخطاء وإصلاحها.