وكيل البرمجة OpenCode مفتوح المصدر: التثبيت والمراقبة

وكيل البرمجة OpenCode مفتوح المصدر (MIT): التثبيت بحسب README، والأذونات، والعزل، ومتابعة السجلات والرموز والتكاليف لكل جلسة.
OpenCode agent de code open source : installer et superviser

وكيل البرمجة OpenCode مفتوح المصدر: يقدّم المستودع anomalyco/opencode نفسه بأنه «وكيل البرمجة المفتوح المصدر بالذكاء الاصطناعي». هو وكيل يعمل في الطرفية (terminal) (مع تطبيق سطح مكتب في طور بيتا)، ويقرأ مستودعك ويقترح تعديلات ويشغّل أوامر، بالنموذج الذي تختاره. بلغ عدد نجومه نحو 219900 في أكتوبر 2026، وهذا يجعله من أكثر مستودعات السلسلة متابعة.

وكيل برمجة ينفّذ أوامر ويكتب ملفات هو فاعل إضافي في سلسلة التسليم لديك. يتبع هذا المقال README ووثائق المشروع: ما هو، والتثبيت، وما يُرى من الواجهة، وحدود الأمان التي يصفها المشروع بنفسه، وكيف تُتابَع السجلات والرموز والتكاليف. وللمراقبة على مستوى المؤسسة، راجع مراقبة وكيل برمجة في المؤسسة.

توضيح للأمانة: لم تثبّت span.observer أداة OpenCode ولم تختبرها. الأوامر مأخوذة من README والوثائق. اللقطة الأولى منشورة في المستودع؛ واللقطتان الأخريان مقتطفان من هذه الوثائق صيّرناهما بأنفسنا.

وكيل البرمجة OpenCode مفتوح المصدر: ما الذي يقوله المستودع

  • الجهة: المستودع ملك لمنظمة GitHub المسماة anomalyco. ويحمل ملف LICENSE عبارة «Copyright (c) 2025 opencode».
  • الترخيص: MIT.
  • أرقام قُرئت يوم 22 أكتوبر 2026 من صفحة المستودع: نحو 219900 نجمة، ونحو 29400 فرع، و20722 commit في الفرع dev.
  • الإصدار: يلزم التحقق، انظر أدناه. يصف CHANGELOG في المستودع «OpenCode V2» وآخر مدخل فيه هو v2.1.2 بتاريخ 21 أكتوبر 2026، بينما كانت صفحة الإصدارات تعرض v1.19.3 بتاريخ 16 أكتوبر. للمشروع خطا إصدارات، V1 وV2، ولم يعودا يُثبَّتان جنبًا إلى جنب افتراضيًا.
  • الوكلاء المدمجون: build (وصول كامل، وهو الافتراضي) وplan (للقراءة فقط: يرفض تعديل الملفات ويطلب الإذن قبل أوامر shell)، ويُبدَّل بينهما بمفتاح Tab. ووكيل فرعي general للبحوث المعقدة.
  • النماذج: المشروع مستقل عن أي مزوّد؛ وتصف الوثائق إعداد المزوّدين والنماذج. وتُظهر اللقطة أدناه نموذجًا من Claude وخدمة «OpenCode Zen».

جولة في الواجهة

هذه لقطة الطرفية المنشورة في المستودع (وهي من الصفحة الرئيسية للمشروع ومن إصدار أقدم). تعرض ترويسة الجلسة عدد الرموز (tokens) ونسبة السياق المستخدم والتكلفة بالدولار. وتُسرد استدعاءات الأدوات (Grep وGlob وRead) على امتداد المحادثة، ثم يطرح الوكيل سؤالًا قبل تعديل أي شيء.

لقطة من مستودع OpenCode: طرفية فيها جلسة بعنوان Homepage button color change in repo workflow، واستدعاءات Grep وGlob وRead مسرودة، وعدّاد 39413 رمزًا و20% من السياق و0.29 دولار، وشريط الاختصارات
Source : github.com

هذا العداد مفيد للمراقبة: تعرض كل جلسة تكلفتها بالرموز على الشاشة، قبل ربط أي مقياس. وتذكّر الاختصارات في الأسفل بالوظائف الرئيسية: Esc للمقاطعة، وTab لتغيير الوكيل، وCtrl+T لمتغيرات النموذج، وCtrl+P للوحة الأوامر.

التثبيت بحسب README

الخطوة 1: ثبّت CLI

يقترح README سكربتًا وعدة مديري حزم:

curl -fsSL https://opencode.ai/v2/install | bash
npm i -g @opencode/cli@latest
brew install anomalyco/tap/opencode-v2
brew install opencode
sudo pacman -S opencode
mise use -g opencode
nix run github:anomalyco/opencode

تمرير سكربت بعيد إلى shell ممارسة محفوفة بالمخاطر: فضّل مدير حزم، أو اقرأ السكربت قبل تنفيذه. يحترم السكربت الترتيب $OPENCODE_INSTALL_DIR ثم $XDG_BIN_DIR ثم $HOME/bin ثم $HOME/.opencode/bin. ويوضح دليل الترحيل أن تثبيت V1 المُدار بحزمة يجب إزالته قبل تثبيت V2.

الخطوة 2: تطبيق سطح المكتب (بيتا)

يعطي README حزم macOS (Apple Silicon وIntel) وWindows وLinux (.deb و.rpm و.AppImage) والأمر brew install --cask opencode-desktop لـ macOS.

الخطوة 3: اضبط الأذونات

تصف الوثائق إعدادًا باسم permission تكون فيه قيمة كل إجراء allow أو ask أو deny. وتسود آخر قاعدة مطابقة؛ لذلك توضع القاعدة العامة "*" أولًا. ومثال الصفحة:

مقتطف من وثائق OpenCode: ملف opencode.json فيه قسم permission تكون القاعدة العامة فيه ask وshell تساوي allow وedit تساوي deny

يوافق الخيار --auto تلقائيًا على الطلبات التي لم تُرفض صراحةً؛ وتبقى قواعد deny مطبّقة. خصّصه لبيئة معزولة.

الأمان: ما يقوله المشروع عن نفسه

  • ملف SECURITY.md في المستودع صريح: لا يضع OpenCode الوكيلَ في صندوق رمل (sandbox). نظام الأذونات مساعد للانتباه عند المستخدم وليس عزلًا. ولعزل حقيقي يوصي المشروع بتشغيل الأداة في حاوية Docker أو جهاز افتراضي.
  • وضع الخادم (opencode serve وopencode web) اختياري. وتطلب الوثائق تعريف OPENCODE_SERVER_PASSWORD لتفعيل مصادقة HTTP الأساسية؛ وبدون كلمة مرور يعمل الخادم دون مصادقة مع تحذير.
  • البيانات المرسلة إلى مزوّد النموذج تخضع لشروطه؛ وخوادم MCP التي تعدّها خارج نطاق ثقة المشروع.

طبّق الاحتياطات نفسها على أي وكيل ذي صلاحيات: ضوابط حماية وكلاء الذكاء الاصطناعي في الإنتاج، وإن ربطت خوادم MCP فراجع دليل خادم MCP الخاص بـ GitHub.

الحدود والنقاط المفتوحة

  • خطا إصدارات: يتعايش V1 وV2. يغيّر V2 واجهة الإضافات وعقود الخادم وإعداد عميل الطرفية؛ وتُتجاهل حقول تجريبية من V1 (منها openTelemetry)، بحسب دليل الترحيل. تحقق من الإصدار المعروض قبل اتباع أي درس.
  • الوتيرة: أكثر من 20000 commit؛ ثبّت الإصدار في أجهزة التطوير.
  • النماذج المجانية: يذكر CHANGELOG نماذج بلا تكلفة ومتغيرًا OPENCODE_DISABLE_FREE_MODELS لإخفائها؛ تحقق مما يُرسَل إلى أي مزوّد قبل أن تضع فيها شيفرة مملوكة.
  • يوضح المشروع أنه لا يقبل تقارير الأمان المولَّدة بالذكاء الاصطناعي.

مراقبة OpenCode: السجلات والرموز والتكاليف

OpenCode أداة محلية وليست خدمة: تنطلق المراقبة من الجهاز أو الحاوية. هذه الأفكار صالحة مع Dynatrace SaaS ومع Dynatrace Managed إن جمعت البيانات عبر Collector من OpenTelemetry.

  • السجلات المحلية: تذكر صفحة استكشاف الأخطاء المسار ~/.local/share/opencode/log/ على macOS وLinux، وهي ملفات مؤرخة يُحتفظ بأحدث عشرة منها. ويفصّل opencode --log-level DEBUG المخرجات، ويعرضها --print-logs في الطرفية.
  • الرموز والتكاليف: يعرض opencode stats استخدام الرموز وتكلفة الجلسات، مع الخيارات --days و--tools و--models و--project. ولمتابعة هذه التكلفة في منصة خلفية، راجع تكلفة وكيل الذكاء الاصطناعي بالرموز مع OpenTelemetry.
  • تصدير OpenTelemetry (يلزم التحقق): في الشيفرة المصدرية للفرع الرئيسي، تقرأ الوحدة packages/util/src/observability.ts المتغيرين OTEL_EXPORTER_OTLP_ENDPOINT وOTEL_EXPORTER_OTLP_HEADERS وإن عُرّفت نقطة وصول أرسلت السجلات إلى /v1/logs والتتبعات إلى /v1/traces. هذه الميزة لا تظهر في الوثائق التي قرأناها: اختبرها على إصدارك قبل أن تعتمد عليها.
  • تدقيق الأوامر: القسم permission هو أيضًا سجل للنوايا؛ اشترط ask للإجراءين shell وedit على الأجهزة المشتركة.
أوامر مذكورة في README ووثائق OpenCode: التثبيت بسكربت، وopencode --log-level DEBUG، وopencode run --auto، وopencode stats

كيف تتحقق من أن كل شيء يعمل

  1. يفتح opencode الواجهة في مستودع تجريبي.
  2. مع الوكيل plan، يُرفض طلب تعديل: هذا هو وضع القراءة فقط.
  3. بعد جلسة، يُظهر opencode stats الرموز والتكلفة.
  4. يظهر ملف سجل مؤرخ في مجلد السجلات.

أفضل الممارسات

  • شغّل الوكيل في حاوية أو جهاز افتراضي للمستودعات الحساسة.
  • ابدأ بالوكيل plan وقواعد ask، ثم خفّف عند الحاجة.
  • عرّف OPENCODE_SERVER_PASSWORD دائمًا قبل فتح وضع الخادم أو الويب.
  • أبقِ مفاتيح المزوّدين خارج المستودعات والسجلات.
  • تابع التكلفة لكل جلسة وراجع الفروق دون البحث عن مذنب.

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

هل OpenCode مجاني فعلًا؟

البرنامج بترخيص MIT. وللنماذج تكلفة بحسب المزوّد المختار، ويشير CHANGELOG إلى نماذج مجانية تتغير حدودها؛ ولا يبيع المشروع رموز مزوّديك الآخرين.

هل تذهب شيفرتي إلى طرف ثالث؟

يذهب السياق المرسل إلى مزوّد النموذج الذي تعدّه، ويوضح SECURITY.md أن تعامله مع البيانات يعود إليه. اختره بحسب سياسة البيانات لديك.

هل يعزل OpenCode الأوامر التي يشغّلها؟

لا، بحسب SECURITY.md: الأذونات ليست صندوق رمل. استخدم حاوية أو جهازًا افتراضيًا.

الخلاصة

يستحق OpenCode شعبيته لمن يريد وكيل برمجة مفتوح المصدر، حرًّا في اختيار النموذج وقابلًا للضبط بملف. ينبغي اعتماده عن علم: التحقق من إصدار V1 أو V2، وأذونات صارمة، وعزل بحاوية، ومتابعة الرموز والسجلات. ولوكيل مفتوح المصدر آخر من السلسلة نفسها، راجع OpenClaw. المصادر: مستودع anomalyco/opencode.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا للمشاريع المذكورة. العلامات التجارية المذكورة ملك لأصحابها. الأدوات تتطور بسرعة، لذا تحقق دائمًا من الأوامر والخيارات في وثائقها الرسمية.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
CLI-Anything logiciels agents : piloter GIMP ou Blender en CLI

CLI-Anything للوكلاء: قيادة GIMP وBlender عبر سطر الأوامر

Next Post
wshobson agents marketplace : plugins pour agents de code

wshobson agents marketplace: إضافات لوكلاء البرمجة

Related Posts