lore-hex/quill-routerمستودع TrustedRouter.com للتمرير الآمن عبر البروكسي لنماذج LLM
# TrustedRouter
[](https://github.com/Lore-Hex/quill-router/actions/workflows/ci.yml)
[](https://github.com/Lore-Hex/quill-router/actions/workflows/deploy.yml)
[](https://github.com/Lore-Hex/quill-router/actions/workflows/prod-smoke.yml)
[](https://github.com/Lore-Hex/quill-router/actions/workflows/trust-drift.yml)
[](https://status.trustedrouter.com)
[](https://trust.trustedrouter.com)
[](https://www.npmjs.com/package/@lore-hex/trusted-router)
[](https://pypi.org/project/trusted-router-py/)
[](LICENSE)
# نماذج لغوية كبيرة مشفّرة من طرف إلى طرف. واجهة برمجية واحدة. خصوصية مع إثبات.
توقّف عن القلق بشأن من يمكنه رؤية مطالباتك. اطلب من وكيل البرمجة الخاص بك نقل
مشروعك، واختر مستوى الخصوصية الذي تريده، واختر نموذجًا، وأدخل
مفتاحًا — انتهى الأمر. نفس الواجهة البرمجية، أكثر من 30 نموذجًا، مفتاح واحد. تعمل البوابة داخل
بيئات معزولة على مستوى العتاد ويمكنك التحقق تشفيريًا من أنها لا تسجّل بياناتك أبدًا.
### انقل مشروعك في مطالبة واحدة
الصق هذا في Codex أو Claude Code أو Cursor — وسيتولى الترحيل نيابةً عنك:
```text
Migrate this project to TrustedRouter, a privacy-first LLM router
(https://trustedrouter.com). Repoint my LLM client to base_url
"https://api.trustedrouter.com/v1" (or "https://api.trustedrouter.com" for the
Anthropic SDK), read the key from the TRUSTEDROUTER_API_KEY env var, and keep
all my existing calls working.
For a hard provider-side confidential-compute and end-to-end-encryption
requirement, add {"provider": {"min_privacy": "confidential"}}. TrustedRouter
fails closed when the selected model or provider cannot satisfy both controls.
Then tell me to sign up at trustedrouter.com, add a card, and paste my sk-tr
key into TRUSTEDROUTER_API_KEY.
```
ثم:
1. **اختر مستوى الخصوصية أو المنطقة** — استخدم
`{"provider": {"min_privacy": "zdr"}}` لحد أدنى صارم من عدم الاحتفاظ، أو
`{"provider": {"min_privacy": "confidential"}}` للحد الأدنى الأقوى من
الحوسبة السرية + التشفير من طرف إلى طرف. تُحدِّد الأسماء المستعارة المريحة `trustedrouter/zdr` و
`trustedrouter/e2e` (`trustedrouter/confidential`) تلك
المجموعات. استخدم `trustedrouter/eu` مع
`https://api-europe-west4.quillrouter.com/v1` للتوجيه الموجَّه نحو الاتحاد الأوروبي.
2. **اختر نموذجًا** — أيًّا من مئات النماذج، أو `trustedrouter/auto` للتبديل التلقائي
الاحتياطي عندما يكون اتساع المزوّدين أهم من أشدّ
مرشّح خصوصية صرامةً.
3. **سجّل، وأضف بطاقة، واحصل على مفتاحك** على https://trustedrouter.com.
4. **أطلِق** — تعمل الآن مطالباتك عبر مسار يمكنك التحقق منه.
<details>
<summary>تفضّل ربطه يدويًا؟</summary>
```bash
# Codex
export OPENAI_BASE_URL="https://api.trustedrouter.com/v1"
export OPENAI_API_KEY="sk-tr-v1-..."
# Claude Code
export ANTHROPIC_BASE_URL="https://api.trustedrouter.com"
export ANTHROPIC_API_KEY="sk-tr-v1-..."
```
```python
# Any OpenAI SDK
client = OpenAI(base_url="https://api.trustedrouter.com/v1", api_key="sk-tr-v1-...")
```
</details>
- **احصل على مفتاح / ادعمنا ماليًا:** https://trustedrouter.com
- **جرّبه أولًا (بدون تسجيل):** https://trustedrouter.com/chat
- **التفاصيل التقنية (للمهووسين تقنيًا):** https://trustedrouter.com/security
- **توليد الصور:** [docs/image-generation.md](https://github.com/lore-hex/quill-router/blob/main/docs/image-generation.md)
- **توليد الفيديو:** [docs/video-generation.md](https://github.com/lore-hex/quill-router/blob/main/docs/video-generation.md)
- **لماذا بنيناه:** https://jperla.com/blog/attestation-is-all-you-need
---
<details>
<summary><strong>للمهووسين تقنيًا: كيف يمكن إثبات الخصوصية</strong></summary>
تعمل بوابة TrustedRouter داخل GCP Confidential Space. توقّع المنصة
قياسًا للحاوية قيد التشغيل. تحقّق من ذلك الدليل الموقّع وقارن
بصمة صورته (image digest) بقياس الإصدار المنشور. مراجعة الشيفرة المصدرية
وأصل بناء الإصدار يحدّدان ما تفعله تلك الصورة المقيسة؛ ومطابقة
البصمة وحدها لا تثبت خلوّها من الأخطاء أو من التسجيل.
افحص أدلة GCP، دون حساب:
```bash
NONCE=$(openssl rand -hex 16)
curl --fail --silent --show-error \
"https://api-us-central1.quillrouter.com/attestation?nonce=$NONCE" \
--output attestation.jwt
# GCP returns a raw Google-signed JWT, not a JSON response.
# Decoded claims include eat_nonce and submods.container.image_digest.
# GCP evidence has no pcrs field; PCRs belong to AWS Nitro evidence.
```
حفظ JWT أو فك ترميزه **ليس تحققًا**. استخدم
[مدقق الإثبات](https://github.com/Lore-Hex/quill-cloud-proxy/blob/main/tools/verify-attestation.py)
من نسخة مُراجَعة من `quill-cloud-proxy` للتحقق من المُصدر/التوقيع،
وnonce الطازج، وربط شهادة TLS/exporter، وقياس الإصدار المتوقع.
بالنسبة لنقطة نهاية GCP، شغّل من تلك النسخة:
```bash
DIGESTS=$(curl --fail --silent --show-error \
https://trust.trustedrouter.com/trust/accepted-image-digests-gcp.txt)
test -n "$DIGESTS" && uv run --script tools/verify-attestation.py \
--api-host api-us-central1.quillrouter.com --expect-digest "$DIGESTS"
```
يتحقق المدقّق من أدلة حديثة على اتصال TLS الذي يتحقق منه. هذا الفحص لا يشهد على اتصال `curl` أو SDK لاحق ومستقل. تستخدم هذه الأمثلة اسم مضيف GCP المنشور في US Central لاختيار تنسيق أدلة GCP. يمكن لنقطة النهاية العالمية اختيار سحابة أخرى؛ استخدم سياسة التحقق الخاصة بتلك السحابة والقياسات من [موقع الثقة](https://trust.trustedrouter.com/).
| | نموذج الثقة |
|---|---|
| OpenRouter، المزوّدون المستضافون | "نحن لا نسجّل." سياسة لا يمكنك التحقق منها. |
| Portkey، Cloudflare AI Gateway | تسجيل كل شيء لأغراض المراقبة. |
| LiteLLM | استضافة ذاتية، لكن الوكيل العامل غير موثّق. |
| **TrustedRouter** | **مفتوح المصدر + إثبات عتادي. تحقّق من مسار الشيفرة؛ فهو لا يسجّل شيئًا.** |
النطاق الصادق: يُثبت الإثبات أن الملف التنفيذي العامل هو الملف التنفيذي المنشور على عتاد يمكنك تحديّه باستخدام nonce. وهو لا يتغلّب على دولة قومية تملك وصولًا ماديًا إلى المضيف، ولا يُثبت أن الملف التنفيذي مفتوح المصدر خالٍ من الأخطاء. مرتكز الثقة هو سلسلة الإثبات المدعومة بالعتاد من Google Confidential Computing. يتعامل المزوّدون upstream مع المطالبات وفقًا لسياساتهم الخاصة — ويُنشر موقف كل مزوّد على صفحات النماذج.
</details>
---
## تخطيط المستودع
ينفّذ هذا المستودع عقد مستوى التحكم: تغطية المسارات، وإدارة المصادقة/المفاتيح، ودلالات دفتر الفوترة، وبيانات الاستخدام الوصفية، وحظر تسجيل المطالبات/المخرجات، ومرشّحات Sentry، وتجريدات المزوّدين. يوجد تنفيذ البوابة الموثّقة في `quill-cloud-proxy`.
حدود الثقة: `api.trustedrouter.com` هو مسار المطالبات الموثّق ويجب أن يُنهي TLS داخل Confidential Space. أما `trustedrouter.com` فهو مستوى التحكم ويجب ألا يقدّم أبدًا بديلًا احتياطيًا للاستدلال في بيئة الإنتاج.
يظل `api.quillrouter.com` اسمًا مستعارًا دائمًا وعاملًا (نفس البوابة الموثّقة والشهادة)، لذا تستمر التكاملات القائمة في العمل دون أي ترحيل.
## محلي
```bash
uv sync
uv run pytest
uv run uvicorn trusted_router.main:app --reload
```
اختبار دخاني شامل من طرف إلى طرف مقابل نسخة قيد التشغيل:
```bash
TR_SMOKE_BASE_URL=http://127.0.0.1:18080/v1 uv run python scripts/smoke_e2e.py
```
للإنتاج، عيّن `TR_SMOKE_BASE_URL=https://api.trustedrouter.com/v1` و
`TR_SMOKE_INTERNAL_TOKEN` إذا كانت مسارات البوابة الداخلية محمية برمز مميز.
عيّن مفاتيح المشغّل/المزوّد المحلية في:
```text
/Users/jperla/claude/.quill_cloud_keys.private
```
يُحفظ هذا الملف دون تثبيت (commit) أبدًا. ومن المتوقع أن يكون بأسلوب dotenv:
```text
ANTHROPIC_API_KEY=...
OPENAI_API_KEY=...
GEMINI_API_KEY=...
CEREBRAS_API_KEY=...
DEEPSEEK_API_KEY=...
MISTRAL_API_KEY=...
STRIPE_SECRET_KEY=...
STRIPE_WEBHOOK_SECRET=...
SENTRY_DSN=...
```
يقبل سكربت النشر أيضًا أسماء مستعارة محلية مستخدمة بالفعل في بعض ملفات المشغّلين: `CLAUDE_API_KEY` لـ Anthropic، و`CHATGPT_API_KEY` لـ OpenAI، و`STRIPE_KEY` لـ `STRIPE_SECRET_KEY`.
يختلف Vertex عن منصات المزوّدين الأخرى: تستخدم عمليات نشر GCP الإنتاجية حساب خدمة Cloud Run أو Confidential Space ورموز وصول Google قصيرة العمر من metadata/ADC. لا تضع مفتاح Vertex طويل العمر في هذا الملف لمسار Vertex المدفوع مسبقًا من الطرف الأول؛ امنح حساب الخدمة وقت التشغيل أذونات Vertex بدلاً من ذلك.
## الترخيص
Business Source License 1.1. الشيفرة المصدرية عامة ليصبح بإمكان أي شخص قراءة الشيفرة الدقيقة الكامنة وراء ادعاءات الخصوصية والإثبات الخاصة بـ TrustedRouter والتحقق منها (https://trust.trustedrouter.com) — فهذا هو الغرض من وجودها هنا. الاستخدام غير الإنتاجي (المراجعة الأمنية، والتدقيق، والتقييم المحلي) مجاني. يتطلب الاستخدام الإنتاجي ترخيصًا تجاريًا من Lore Hex Corp: [email protected]. تتحول كل إصدار إلى Apache License 2.0 بعد أربع سنوات من النشر. تظل الشيفرة المنشورة قبل 3 يوليو 2026 خاضعة لـ Apache-2.0.
## إعدادات الأمان الافتراضية
- لا يتم تسجيل محتوى المطالبات والمخرجات مطلقًا. لا يحتفظ الاستدلال المتزامن والتدفقي العادي به. تحتفظ واجهة Batch API الاختيارية مؤقتًا بآثار مشفّرة داخل الـ enclave لمدة تصل إلى 30 يومًا.
- تحتوي سجلات الاستخدام على البيانات الوصفية فقط.
- تُخزَّن مفاتيح API كتجزئات SHA-256 مملّحة مع معرّفات مفاتيح مبهمة.
- تُخزَّن مفاتيح مزوّدي BYOK التي يرسلها المستخدم كصفوف نص مشفّر بتشفير مغلّف، وليس ككائن Secret Manager واحد لكل مفتاح. في الإنتاج، يغلّف Cloud KMS مفتاح DEK الخاص بكل مفتاح؛ وتبقى مراجع `env://...` الخارجية مدعومة للمفاتيح التي يديرها المشغّل.
- تتضمن تفويضات البوابة `byok_cache_key` غير سرّي لأظرف BYOK المشفّرة. تستخدمه البوابات الموثّقة للتخزين المؤقت للمفاتيح المفكوكة في الذاكرة فقط ولفترة TTL قصيرة؛ يؤدي تدوير BYOK إلى تغيير المفتاح، ويوقف الحذف إرجاع الظرف.
- مفاتيح BYOK الخام مدخلات لمرة واحدة فقط؛ تكشف استجابات الواجهة العامة/واجهة التحكم عن تلميح قصير للمفتاح الأول/الأخير وبيانات وصفية لمرجع مشفّر، ولا تكشف النص الصريح أبدًا.
- يفشل إعداد الإنتاج بشكل مغلق دون رمز بوابة داخلي، وسر webhook Stripe موقّع، وخلفية تخزين غير قائمة على الذاكرة.
- لا تسجّل تطبيقات واجهة التحكم الإنتاجية `/chat/completions` أو `/messages` أو `/responses` أو `/embeddings`؛ فهي تنتمي إلى مستوى API الموثّق.
- Sentry مخصص لواجهة التحكم فقط، ويحجب أجسام الطلبات وترويسات المصادقة ومفاتيح API ومفاتيح BYOK ورسائل المطالبات ونص المخرجات. تحدّ بوابة Sentry من جانب العميل من المشكلات المتكررة لكل بصمة وإجمالي الأحداث لكل عملية/نافذة، بحيث لا يتمكن تكامل واحد كثير الضجيج من استهلاك ميزانية الأخطاء بأكملها مرة أخرى.
- لا ينتمي أي إعداد لـ Sentry إلى الـ enclave الموثّق.
## قابلية المراقبة عبر Broadcast
يمكن لمالكي مساحات العمل تكوين وجهات Broadcast على `/v1/broadcast/destinations` أو في وحدة التحكم ضمن Broadcast. الوجهات المدعومة هي PostHog وwebhooks بصيغة OTLP JSON. Broadcast للبيانات الوصفية فقط افتراضيًا: النموذج، والمزوّد، وأعداد الرموز، وزمن الاستجابة، والتكلفة، ونوع المسار، والمنطقة، وبيانات التتبع المخصصة. لا يتم تصدير محتوى المطالبات/المخرجات إلا عندما تُمكّن وجهة ما `include_content` صراحةً؛ وتُعاد تلك الوجهات المشفّرة الممكّنة للمحتوى إلى البوابة الموثّقة فقط، وليس إلى استجابات الإدارة العادية. تُكتب عمليات التسليم الخاصة بالبيانات الوصفية فقط في صندوق صادر Broadcast دائم أولاً ويُفرَّغ بشكل غير متزامن بواسطة `/internal/broadcast/drain`، بحيث لا يؤدي انقطاع PostHog/webhook إلى حجب الاستدلال أو فقدان البيانات الوصفية المسوّاة بالفعل عند إعادة تشغيل العملية.
## مستويات التوجيه الثابتة
تستخدم هذه الأسماء المستعارة مجموعة نماذج مرتّبة صراحةً: العضو الأول مفضّل والباقي احتياطيون. تشغّل نموذجًا واحدًا لكل محاولة، دون تركيب أو تنسيق أو حد أدنى ضمني للخصوصية. اضبط `provider.min_privacy` صراحةً عند الحاجة. ينشر كتالوج `/v1/models` المباشر كل مجموعة في `auto_candidates`.
- `trustedrouter/frontier`: مجموعة نماذج frontier ثابتة.
- `trustedrouter/advanced`: مجموعة نماذج advanced ثابتة.
- `trustedrouter/professional`: مجموعة نماذج professional ثابتة.
- `trustedrouter/efficient`: مجموعة نماذج efficient ثابتة.
## المراقبة الاصطناعية
يمتلك TrustedRouter مستوى مراقبة اصطناعية منفصلًا لوقت التشغيل العام.
تعمل عمال المراقبة الاصطناعية خارج الـ enclave، وترسل طلبات حقيقية صغيرة إلى
واجهة API العامة الموثّقة، وتخزن البيانات الوصفية فقط. أسماء مراقبة النماذج هي:
- `trustedrouter/free`: مجموعة مجانية بنمط OpenRouter. مفيدة للمستخدمين، وليست
إشارة SLA.
- `trustedrouter/cheap`: أرخص مجموعة مدفوعة مع تنوع المزوّدين.
- `trustedrouter/eu`: مجموعة مزوّدين تركّز على الاتحاد الأوروبي. تفضّل المزوّدين
الأوروبيين والقابلين للتشغيل في منطقة الاتحاد الأوروبي والذين يهتمون بالخصوصية،
خصوصًا عند اقترانها بـ `https://api-europe-west4.quillrouter.com/v1`. هذه سياسة
توجيه، وليست ضمانًا شاملًا لإقامة البيانات.
- `trustedrouter/monitor`: مجموعة وقت التشغيل الداخلية لفحوصات PONG والاحتياط.
تظهر في الكتالوج للشفافية، لكن التفويض يتطلب
`TR_SYNTHETIC_MONITOR_API_KEY` المُهيّأ؛ وتتلقى مفاتيح API العادية 403.
ينبغي تشغيل العمال من `us-central1` و`europe-west4`، باستخدام مساحة عمل/مفتاح
مخصصين باسم `trustedrouter-synthetic-monitoring` مع حدود إنفاق صارمة وإعادة
تعبئة تلقائية. العينات الخام عبارة عن صفوف Bigtable للإلحاق فقط؛ وتقرأ صفحات
الحالة العامة ملخصات مضغوطة معروضة على `/status` و`/status.json` و
`/status/history?window=5m|24h|daily`. تستخدم التوليدات الاصطناعية تسمية التطبيق
`TrustedRouter Synthetic` وتُستبعد من تحليلات العملاء/التطبيقات.
كل استدعاء للمراقبة ينفّذ أيضًا إكمال محادثة بـ `stream: true` ويفشل ما لم
يستقبل حدث بيانات SSE وقطعة نهائية و`[DONE]`. وتضيف مهمة Stage D المتكررة
`--expect-stage-d`، ثم تبحث عن التفويض المُصنّف لذلك الطلب وتتطلب
`stage_d_boot_kid` مرتبطًا بالإضافة إلى `heartbeat_seq > 0`. مساحة عملها منفصلة
عمدًا: جهّزها باستخدام `scripts/provision_stage_d_probe_workspace.py` وأضف
معرّفها إلى `TR_STAGE_D_PILOT_WORKSPACE_IDS`. يجب أن يكون المفتاح مفتاحًا محليًا
مُصنّفًا قادرًا على heartbeat؛ ويقرأه النشر من
`trustedrouter-stage-d-probe-api-key` ويستخدم `trustedrouter/cheap` ليكون مستقلًا
عن مفتاح المراقبة العادي. يترك النشر العادي أهلية Stage D معطّلة، لذا فإن إنشاء
المفتاح وحده لا يفعّل Stage D.
يستخدم قياس المزوّد فئتين مستقلتين من الفحوصات:
- فحوصات PONG القصيرة تغطي عشوائيًا الكتالوج النشط بالكامل وتقيس وقت التشغيل،
وTTFB، وTTFT، وانحراف API للمزوّد.
- بث مستمر بطول 512 رمزًا يغطي أهم 200 مسار مزوّد/نموذج في تناوب حتمي من
`us-central1`. يقيس رموز الإخراج في الثانية بعد الرمز الأول. يعمل في Cloud Run
Job منفصل، لذا لا يمكن للبثوث البطيئة أن تؤخر فحوصات وقت التشغيل. لا تُحتسب
إخفاقات الفحوصات الطويلة أبدًا ضد وقت تشغيل المزوّد أو تنبيهات انحراف API.
يمنح الجدول الحالي ذو الدقيقتين كل مسار مستمر نحو 25 عينة في الأسبوع و108 في
30 يومًا. تحسب CI تقدير إنفاق بالحد الأقصى من الكتالوج المباشر وتفشل إذا تجاوز
السقف الشهري المُ راجع.
تفصل الحالة بين فئتي SLO للخدمة بدلًا من دمجهما مع سلوك المزوّد الأعلى:
- `router_core`: واجهة API الموثّقة قابلة للوصول، وتفويض المفتاح يعمل، ومرشحو
المسار/الاحتياط متاحون، والتسوية/الاسترداد متين.
- `control_plane`: لوحة التحكم، وواجهة الفوترة، والمفاتيح، والأرصدة، والمستندات،
والثقة، وأسطح الحالة.
تستخدم مراقبات النشر وتنبيهات معدل الاستهلاك الداخلية `router_core` افتراضيًا.
تُقاس إخفاقات المزوّد فقط لكل مزوّد على `/status` و`/leaderboard`؛ ولا تستهلك
ميزانية أخطاء router-core عندما يبقى الاحتياط متاحًا.
## التموضع العام
- التسعير: تُتبَّع الاستخدامات المدفوعة مسبقًا وBYOK كقيم صحيحة من الميكرودولار، وليس كدولارات عشرية، بحيث تبقى تكاليف الرموز الصغيرة قابلة للتدقيق في السجل.
- هدف وقت التشغيل: `trustedrouter/auto` هو اسم مستعار حقيقي لنموذج محادثة في الاستدلال المحلي/الاختباري لمستوى التحكم، وينتقل إلى المزوّد المُهيَّأ التالي عند فشل المزوّد الأعلى. يفضّل `trustedrouter/eu` مجموعة المزوّدين المركّزة على الاتحاد الأوروبي، ويفرض `trustedrouter/zdr` حدًّا أدنى من المزوّدين بعدم الاحتفاظ بالبيانات مع Anthropic أولًا، ويفرض `trustedrouter/e2e` مسارات سرّية + E2EE مع Tinfoil أولًا. تحترم طلبات المحادثة أيضًا مرشّحات التوجيه بنمط OpenRouter لكلٍّ من `models` و`provider` (`order`، `only`، `ignore`، `allow_fallbacks`، `min_privacy`، `data_collection`، `sort`، `max_price`، `require_parameters`، و`zdr`) بحيث يمكن للعملاء طلب سلاسل احتياطية صريحة أو تفضيلات مزوّد. يُعدّ `provider.order` تفضيلًا ما دامت السلاسل الاحتياطية مُفعّلة، ويبقى المزوّدون غير المدرجين مؤهّلين بعد القائمة المفضّلة. مع `allow_fallbacks=false`، يقتصر التوجيه على مجموعة المزوّدين المرتّبة ويُصرَّح فقط بأول مسار متاح منها. `provider.only` هو دائمًا قائمة سماح صارمة للمزوّدين. كما أن ضبط `allow_fallbacks=false` سواء على المستوى الأعلى للطلب أو كـ `provider.allow_fallbacks` يمنع استبدال النموذج بآخر. `min_privacy="confidential"` هو متطلب صارم من جانب المزوّد للحوسبة السرّية + E2EE ويفشل مغلقًا؛ وتختار الأسماء البديلة لقيمة الطلب `e2e` و`e2ee` نفس المستوى بدلًا من التراجع إلى مسار أضعف. تُرجع خيارات الطلب أو المزوّد غير المعروفة `400` مع اسم الحقل الدقيق. أما عناصر التحكم المعروفة في OpenRouter غير المُنفَّذة فتُرجع `501 not_supported_in_alpha` بشكل ثابت؛ ولا تُقبل أبدًا كعمليات لا أثر لها في الموجّه.
- الفوترة: أرصدة مدفوعة مسبقًا وBYOK أولًا؛ لا يُشترط أي اشتراك.
- الثقة: مفتوح المصدر ومُستضاف، مع نشر التزام المصدر الخاص بواجهة API العاملة، ومرجع الصورة، وبصمة الصورة، وسياسة الإثبات على `trust.trustedrouter.com`.
- التسجيل: ينشئ التسجيل بالبريد الإلكتروني مفتاح إدارة لمرة واحدة لمساحة العمل.
- المحفظة/العملات المشفّرة: يتم ربط الدفع بالعملات المستقرة عبر طريقة الدفع Crypto في Stripe Checkout عند الطلب. ويبقى الدفع بالبطاقة/Checkout الافتراضي هو المسار الافتراضي.
## هدف التوسّع
الهدف هو دعم توسّع بمستوى OpenRouter:
- تريليون رمز/يوم، أو نحو 11.6 مليون رمز/ثانية في المتوسط على مدار اليوم.
- 1-4 مليون حساب مطوّر.
- أكثر من 300 نموذج قابل للتوجيه النشط.
- أكثر من 60 مزوّدًا.
- تكلفة توجيه عالمية تنافس الموجّهات المنشورة على الحافة.
النشر الإنتاجي الحالي **لا** يحقق ذلك الهدف بعد. فهو يشغّل مستوى التحكم في أربع مناطق GCP خلف موازن تحميل عالمي مع Serverless NEGs لكل منطقة وأربع مناطق API حيّة مُثبتة. تتوسّع السعة أفقيًا مع انضمام المزيد من المجموعات المُثبتة؛ بينما الاستقامة والثقة والفوترة وتوافق SDK في حالة استقرار.
يعتمد حجم الطلبات بشكل كبير على متوسط حجم التوليد. عند تريليون رمز/يوم:
| متوسط الرموز/الطلب | الطلبات/يوم | متوسط معدّل الطلبات |
| ---: | ---: | ---: |
| 1,000 | 1.0B | 11.6k rps |
| 2,500 | 400M | 4.6k rps |
| 10,000 | 100M | 1.2k rps |
يمكن تطوير البنية للوصول إلى هذا التوسّع، لكن فقط إذا تجنّب المسار الساخن الاختناقات العالمية لكل طلب. وهذا يعني أساطيل بوابات إقليمية عديمة الحالة، ومجموعات مزوّدين إقليمية، وتأجيرات حصص مُجزَّأة، وكتابات بيانات وصفية بالإلحاق فقط، وتجميعًا غير متزامن.
## زمن الاستجابة الحالي
مقيس من جهاز التطوير هذا إلى واجهة API المُثبتة المركزية في GCP `us-central1` في 2 مايو 2026:
| الفحص | p50 | p95 | ملاحظات |
| --- | ---: | ---: | --- |
| رفض `/v1/chat/completions` غير المُصادَق | 174 ms | 184 ms | يشمل DNS وTCP وTLS العام ومعالجة طلب الـ enclave. |
| اتصال TCP | 55 ms | 59 ms | مسار الشبكة إلى `us-central1` من هذا الجهاز. |
| اكتمال مصافحة TLS | 112 ms | 124 ms | شهادة ACME العامة تنتهي داخل الـ enclave. |
| `/attestation` | 1.06 s | 1.12 s | يشمل توليد رمز إثبات GCP، لذا ليس ممثلًا لتكلفة التوجيه العادية. |
يُعدّ عبء الشبكة المركزي أعلى بكثير من عبء الحافة المعلن من OpenRouter، لكن زمن استجابة النموذج عادةً ما يطغى على الطلبات التفاعلية. ينبغي أن تكون خطوة التوسّع الإنتاجية الأولى متعددة المناطق بدلاً من بناء حافة عالمية مخصّصة على الفور.
## شكل التوسّع الأفقي
صُمّم مسار الإنتاج ليتوسّع عبر إبقاء بوابة الموجّهات (prompt gateway) عديمة الحالة:
- يمكن تكرار نسخ `api.trustedrouter.com` خلف تمرير TCP الشفّاف. فهي تُجري التفويض والحجز والتسوية عبر مستوى التحكّم، لكن بايتات الموجّهات لا تغادر المسار الموثّق أبداً.
- يخزّن Spanner حالة مستوى التحكّم والفوترة المتّسقة بقوة: المستخدمون، ومساحات العمل، والمفاتيح، وبيانات BYOK الوصفية، وعدم تكرار أحداث الدفع، والأرصدة، والتجميعات، والحجوزات النشطة، ونافذة تدقيق الطلبات المنتهية لمدة 30 يوماً.
- يخزّن Bigtable بيانات وصفية للنشاط عالية الحجم ومحدودة الحجم مفهرسة حسب مساحة العمل والتاريخ. تحتفظ أنشطة وقياسات مزوّدي الخدمة بـ 30 يوماً، وتحتفظ العيّنات الاصطناعية الخام بـ 14 يوماً، وتحتفظ ملخّصات الحالة المدمجة بـ 24 شهراً. لا تُخزَّن الموجّهات والمخرجات ووسائط استدعاء الأدوات.
- يستخدم التحقّق من مفتاح API تجزئة بحث عالية الإنتروبيا لقراءات النقاط؛ فهو لا يمسح المفاتيح.
- تُفرَض حدود المعدّل قبل معالجات المسارات وتستخدم المخزن المُهيّأ، لذا تُشارَك عدّادات الإنتاج عبر نسخ Cloud Run.
عند حركة مرور بحجم OpenRouter، لن يكون عنق الزجاجة التالي هو ثنائي الـ enclave؛ بل مسار الفوترة/التفويض المتزامن. تحتاج البنية إلى حجوزات مقسّمة (sharded)، وعناقيد Bigtable إقليمية، وحدود حافة Cloud Armor، ونسخ متعددة من البوابة قبل السماح بتصاعد حركة المرور العامة.
## خطة متعددة المناطق
التعدد الإقليمي ممكن مع الحفاظ على حدود الثقة، لكن يجب تنفيذه بعناية:
تبقى ساو باولو (`southamerica-east1`) مستوى تحكّم Cloud Run نشطاً: يواصل `trusted-router` النشر والخدمة عبر موازن التحميل العالمي. أُحيل للتقاعد فقط MIG الخاص ببوابته في الـ enclave (quill-cloud-proxy #309)؛ وحُذف سجل DNS الإقليمي القديم لبوابته. تبقى مناطق نشر مستوى التحكّم هي `us-central1` و`us-east4` و`europe-west4` و`southamerica-east1`.
أوريغون (`us-west1`) هي الحالة المعاكسة: منطقة بوابة فقط. تشغّل مجموعة بوابات موثّقة على `api-us-west1.quillrouter.com` ولا تملك مستوى تحكّم Cloud Run. تصل بوابتها إلى مستوى التحكّم عبر موازن التحميل العالمي، الذي يوجّهها إلى أقرب منطقة لمستوى التحكّم (`us-central1`). لا شيء في `scripts/deploy` ينشئ خدمة Cloud Run أو مهمة scheduler أو NEG هناك، وليس لها مدخل في إعدادات المناطق الدافئة أو الحد الأدنى من النسخ الافتراضية.
---
[Read more](https://github.com/lore-hex/quill-router)