jq.
شاهد الطلب الحقيقي
معرّف النموذج والرسائل والأدوات والمعاملات تمامًا كما أرسلها الوكيل
البث يبقى سليمًا
تُمرَّر الأجزاء فور وصولها، لذا يتصرف الوكيل بشكل طبيعي
بلا اعتماديات
ملف واحد، Node.js 18 أو أحدث، لا شيء لتثبيته
كيف يعمل
Authorization الخاصة بك، لذا يبقى مفتاح API في إعدادات الوكيل وتعمل كل نقاط نهاية Venice عبره: /chat/completions و/responses و/models و/embeddings وغيرها. التغيير الوحيد الذي تجريه على الوكيل هو عنوان URL الأساسي.
لكل طلب، يسجّل الـ proxy ما يلي:
- الطريقة والمسار ومتن الطلب، مع إخفاء مفتاح API باستثناء آخر أربعة أحرف منه
- حالة الاستجابة ومتنها. تُخزَّن الاستجابات المتدفقة كقائمة من الأجزاء المحلَّلة.
- استخدام الرموز، من كائن
usageالذي تُرجعه Venice - المدة الإجمالية والوقت حتى أول بايت
- ترويسات الاستجابة
x-venice-*وx-ratelimit-*، مثل الرصيد المتبقي وحالة حدّ المعدل وتحذيرات إيقاف النماذج
هذه أداة تصحيح أخطاء لجهازك الخاص. ترتبط بالعنوان
127.0.0.1 فقط، وليس لها مصادقة خاصة بها، وتكتب الموجّهات والشيفرة على القرص كنص عادي. لا تنشرها كبوابة مشتركة. إذا كنت تحتاج إلى بوابة، فراجع بناء بوابة LLM بلغة Rust.المتطلبات المسبقة
- Node.js 18 أو أحدث (
node --version) - مفتاح Venice API من venice.ai/settings/api
- وكيل برمجة يعمل بالفعل مع Venice، مثل Claude Code أو Codex CLI أو OpenCode أو Cline أو Aider
jqلقراءة السجلات (اختياري، لكنه موصى به)
الإعداد
1
أنشئ الـ proxy
احفظ ما يلي باسم هناك بعض النقاط الجديرة بالإشارة:
venice-debug-proxy.mjs في مجلد مؤقت:venice-debug-proxy.mjs
- البث يعمل بشكل طبيعي. يُكتب كل جزء من Venice إلى الوكيل لحظة وصوله، وتُحفظ نسخة منه للسجل. يرى الوكيل نفس البث رمزًا برمز الذي كان سيحصل عليه من Venice مباشرة.
- يُعالَج الضغط نيابة عنك. تفك دالة
fetchفي Node ضغط الاستجابة، لذا يحذف الـ proxy ترويسةcontent-encodingقبل تمرير الترويسات. وإلا لحاول الوكيل فك ضغط نص عادي وفشل. - يُمرَّر قطع الاتصال. إذا ألغيت دورة في الوكيل، يلغي الـ proxy أيضًا الطلب المرسل إلى Venice، حتى لا تستمر Venice في توليد رموز لا يقرؤها أحد.
2
شغّله
PORT أو LOG_FILE في البيئة لتغيير أي من القيمتين الافتراضيتين.3
تحقق منه باستخدام curl
في طرفية ثانية، أرسل طلبًا عبر الـ proxy:يطبع الـ proxy سطرًا واحدًا لكل طلب:هذا عدد كبير من رموز الموجّه مقابل “Say hello”. معظمها يأتي من موجّه النظام الافتراضي في Venice، الذي يُضاف إلى طلبات الدردشة ما لم تضبط
venice_parameters.include_venice_system_prompt على false. هذا بالضبط نوع الأشياء التي يكشفها الـ proxy.4
وجّه الوكيل إلى الـ proxy
في إعدادات Venice الخاصة بالوكيل، استبدل
https://api.venice.ai بـ http://127.0.0.1:8787 واترك بقية عنوان URL كما هي. يمرّر الـ proxy المسار الكامل، لذا يظل ما يطلب منك دليل الوكيل إدخاله صالحًا.لا يتيح مزوّد Venice المضمّن في OpenCode ولا مزوّد Venice الأصلي في Kilo Code تعيين عنوان URL أساسي، لذا انتقل إلى المزوّد اليدوي أو المتوافق مع OpenAI أثناء التصحيح.في OpenCode، امنح مزوّد التصحيح معرّفًا خاصًا به، مثل
venice-debug، وشغّله باستخدام -m venice-debug/<model-id>. إذا كنت قد حفظت مفتاحًا باستخدام /connect، فسيرسل OpenCode ذلك المفتاح المحفوظ لمعرّف المزوّد venice حتى عندما تعيّن إعداداتك apiKey.استخدم 127.0.0.1 بدلًا من localhost. في بعض الأنظمة يُحَل localhost إلى عنوان IPv6 ::1، وهو عنوان لا يستمع إليه الـ proxy.5
أعد إنتاج المشكلة
استخدم الوكيل كالمعتاد حتى تحدث المشكلة مرة أخرى، ثم اطّلع على مخرجات الـ proxy في الطرفية وعلى ملف السجل.
قراءة السجلات
كل سطر فيvenice-debug.jsonl هو كائن JSON كامل، لذا يمكن لـ jq تقسيمه بالطريقة التي تحتاجها.
اعرض أحدث طلب واستجابة:
ما الذي تبحث عنه
دون كتابة أي شيفرة
إذا كنت تفضّل تصفح الحركة بالنقر في متصفح، يمكن تشغيل mitmproxy كوكيل عكسي أمام Venice:http://127.0.0.1:8787/api/v1 بالطريقة نفسها، ثم افحص كل طلب في واجهة mitmweb. الـ proxy المبني على Node أسهل في الأتمتة بالسكربتات ويحتفظ بسجل يمكنك البحث فيه باستخدام grep لاحقًا. أما mitmproxy فهو أفضل لتصفح جلسة بشكل تفاعلي.
حافظ على خصوصية السجلات
لا تخزّن Venice موجّهاتك أو استجاباتك في الاستدلال العادي (راجع الخصوصية)، لكن ملف السجل هذا يخزّنها. فهو يحتوي على شيفرتك وموجّهاتك ومخرجات الأدوات واستجابات النموذج كنص عادي.- شغّل الـ proxy خارج مشروعك، أو أضف
venice-debug.jsonlإلى.gitignore. - احذف السجل عند الانتهاء من التصحيح.
- لا تلصق إدخالات سجل كاملة في issues عامة. استخرج بدلًا من ذلك
statusوerrorوالجزء ذا الصلة منresponse.
الختام
عند الانتهاء، أوقف الـ proxy باستخدامCtrl+C وأعد عنوان URL الأساسي للوكيل إلى https://api.venice.ai/api/v1. إذا نسيت، فسيفشل الوكيل بخطأ اتصال بمجرد توقف الـ proxy عن العمل، وهو أمر يسهل اكتشافه على الأقل.
شكرًا على القراءة! نأمل أن تتمكن في المرة القادمة التي يقول فيها الوكيل “something went wrong” من رؤية ما الذي حدث خطأً بالضبط.