opencode وكيل برمجة مفتوح المصدر يعمل في الطرفية. والمزوّدون غير الموجودين في فهرسه المدمج يُضافون كمزوّدين مخصّصين في opencode.jsonc. ولأن BroadNet Inference يتعامل بصيغة إكمال المحادثات من OpenAI، فهو يستخدم حزمة التشغيل المتوافقة مع OpenAI في opencode. يتبع هذا الدليل وثائق opencode الحالية (V2).
الإعداد
- صدّر مفتاحك في الطرفية التي تشغّل منها opencode:
export BROADNET_API_KEY='your-broadnet-key'
- أنشئ ملف الإعداد. ضعه في مشروعك باسم
opencode.jsonc، أو في~/.config/opencode/opencode.jsoncلاستخدامه في كل مكان.
{
"$schema": "https://opencode.ai/config.json",
"model": "broadnet/glm-5.3",
"providers": {
"broadnet": {
"name": "BroadNet Inference",
"env": ["BROADNET_API_KEY"],
"package": "@opencode/ai/providers/openai-compatible",
"settings": {
"baseURL": "https://inference.broadnet.ai/v1"
},
"models": {
"glm-5.3": {
"modelID": "broadnet/glm-5.3",
"name": "GLM 5.3",
"capabilities": { "tools": true, "input": ["text"], "output": ["text"] },
"limit": { "context": 1048576, "output": 16000 }
},
"deepseek-v4.1-flash": {
"modelID": "broadnet/deepseek-v4.1-flash",
"name": "DeepSeek V4.1 Flash",
// BroadNet's docs don't list tool calling for this model: test it first
"capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
"limit": { "context": 1048576, "output": 16000 }
},
"qwen3.8-27b": {
"modelID": "broadnet/qwen3.8-27b",
"name": "Qwen3.8 27B",
"capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
"limit": { "context": 262144, "output": 16000 }
}
}
}
}
}
- شغّل opencode واختر النموذج بالأمر
/models. المرجع هوbroadnet/<map key>، مثلbroadnet/glm-5.3. ويرسل opencode قيمةmodelIDإلى BroadNet.
تُدمَج ملفات الإعداد. يطبّق opencode الملف العام أولًا، ثم ملفات المشروع التي يجدها صعودًا من المجلد الحالي (الأبعد أولًا)، ثم أي إعداد في .opencode/، لذا يمكن لملف المشروع أن يتجاوز المزوّد العام. أما إعداد النظام المُدار، إن كانت شركتك تستخدمه، فيتقدّم على الاثنين. احتفظ بالمفتاح في متغيرات البيئة لا في الملف، حتى يمكن إدخال الإعداد في نظام التحكم بالإصدارات.
لماذا الأسماء البديلة
تحتوي معرّفات BroadNet أصلًا على شرطة مائلة (broadnet/glm-5.3). مفتاح الخريطة models هو ما يعرضه opencode ويختاره، وmodelID هو ما يرسله. والمفاتيح القصيرة تُبقي المراجع سهلة القراءة.
اضبط capabilities وlimit بنفسك. فمع نموذج خارج فهرسه، يفترض opencode دعم أدوات JSON، وإدخال النص والصور، وسياقًا من 200,000 رمز، و32,000 رمز للمخرجات. وتسمّي وثائقه هذه القيم افتراضات احتياطية لا قيمًا مكتشَفة. أما قيمة output البالغة 16000 أعلاه فهي اقتراحنا وليست حدًّا من BroadNet؛ فهي تترك مساحة للاستدلال المنطقي.
إعدادات V1 الأقدم
ما زال opencode V2 يقرأ صيغة V1، لذا تظل كتلة موجودة مثل هذه تعمل:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"broadnet": {
"npm": "@ai-sdk/openai-compatible",
"name": "BroadNet Inference",
"options": {
"baseURL": "https://inference.broadnet.ai/v1",
"apiKey": "{env:BROADNET_API_KEY}"
},
"models": {
"broadnet/glm-5.3": { "name": "GLM 5.3" }
}
}
}
}
في صيغة V2 الأصلية يصبح provider هو providers، وnpm هو package (aisdk:@ai-sdk/openai-compatible إن أردت الإبقاء على حزمة AI SDK)، وينتقل options.baseURL وoptions.apiKey إلى settings. ويربط دليل الانتقال من V1 في opencode كل حقل بمقابله.
أي نموذج تختار
| المهمة | النموذج | ملاحظات |
|---|---|---|
| البرمجة بالوكلاء مع الأدوات | GLM 5.3 | الأدوات والمخرجات المنظَّمة مدرجة؛ سياق 1M |
| لقطات الشاشة، والعربية | Qwen3.8 27B | أدوات وصور؛ سياق 262K |
| جلسات طوال اليوم بسعر ثابت | DeepSeek V4.1 Flash | خطط غير محدودة؛ لا يدرج BroadNet الأدوات له |
يعتمد opencode على استدعاءات الأدوات. ولا تدرج وثائق BroadNet استدعاء الأدوات لنموذج DeepSeek V4.1 Flash، لذا يَسِمه الإعداد بأنه افتراض يجب اختباره. نفّذ مهمة حقيقية خلال ساعة من خطة الشهاب (Meteor) ($1) قبل أن تشتري شهرًا من خطة البدر (Full Moon) ($60).
حل المشكلات
- 401. المفتاح في
BROADNET_API_KEYخاطئ أو منتهي الصلاحية، أو استُنفدت حصة الدفع حسب الاستخدام. تأكّد من ضبط المتغير في العملية التي تشغّل opencode. - النموذج غير موجود أو مرفوض. اختر مفتاح الخريطة (
broadnet/glm-5.3)، وتأكّد من تطابقmodelIDمع معرّف BroadNet تمامًا. المراجع حساسة لحالة الأحرف. تحتاج النماذج المدفوعة إلى شحن الرصيد؛ فرصيد $5 لا يغطي إلاbroadnet/gemma-4-26b-a4bونموذجَي Transcribe. - إجابات فارغة. ارفع
limit.output. لماذا تصل الإجابات فارغة. - 429. تسمح مفاتيح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ. وإعادات المحاولة تُحتسب أيضًا. راجع الأخطاء وإعادة المحاولة.
- وكلاء فرعيون على خطة. تعالج كل جلسة خطة طلبًا واحدًا في كل مرة، لذا تصطفّ الوكلاء الفرعية المتوازية في طابور ما لم تكن لكل منها جلسة خاصة.
