Cover

احتفظ بالبيانات الخاصة والبنية التحتية الداخلية والأسرار بعيدًا عن وكلاء البرمجة السحابيين دون تعطيل سير عملك.

التثبيت · البدء السريع · السياسات · المراقبة · Pi / OMP · الأمان

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

استخدم قواعد pseudonymize أو placeholder القابلة للعكس عندما يجب أن تستمر المحادثة في العمل من البداية إلى النهاية. استخدم قواعد mask أو redact أحادية الاتجاه عندما لا تكون الاستعادة ضرورية، وblock لإيقاف الطلب محليًا، وallow لاستثناء صريح.

تشمل العملاء المدعومين Codex وClaude Code وCursor وPi / Oh My Pi وحزم SDK والموجّهات المتوافقة مع OpenAI أو Anthropic.

التثبيت

يقوم المثبّت بتنزيل الإصدار الخاص بنظام التشغيل والمعالج لديك، والتحقق منه مقابل مجموعات اختبار SHA-256 المنشورة، وتثبيته بشكل ذري في ~/.local/bin/cover، وتهيئة العملاء المحددين، وبدء الوكيل.

curl -fsSL https://raw.githubusercontent.com/DavidCarliez/cover/main/scripts/install.sh | bash

لا حاجة إلى سلسلة أدوات Go أو نسخة Git محلية. تحتاج فقط إلى curl، وأداة لاستخراج الأرشيف (tar على Linux/macOS أو unzip على Windows)، وsha256sum أو shasum أو openssl للتحقق.

تتوفر أرشيفات جاهزة لأنظمة Linux وmacOS وWindows مع مجاميع التحقق الخاصة بها من إصدارات GitHub.

للتثبيت غير التفاعلي:

curl -fsSL https://raw.githubusercontent.com/DavidCarliez/cover/main/scripts/install.sh | \
  COVER_AGENTS=openai,claude bash

ثبّت إصدارًا محددًا أو ثبّت الملف التنفيذي فقط مع متغيرات البيئة المطبقة على عملية bash:

curl -fsSL https://raw.githubusercontent.com/DavidCarliez/cover/main/scripts/install.sh | \
  COVER_VERSION=v0.1.0 COVER_SKIP_SETUP=1 bash

git clone https://github.com/DavidCarliez/cover.git
cd cover
go build -o cover ./cmd/cover
install -m 0755 cover ~/.local/bin/cover

GOOS=linux GOARCH=arm64 go build -o cover-linux-arm64 ./cmd/cover
GOOS=windows GOARCH=amd64 go build -o cover.exe ./cmd/cover

أبرز الميزات

البدء السريع

cover init             # write ~/.config/cover/config.yaml
cover start --detach   # run in the background
cover doctor           # verify the local setup
cover test             # local redaction round trip, no network call
cover monitor          # watch privacy-safe request metadata

cover init يطلب OpenAI أو Anthropic أو خدمة upstream مخصصة. التوثيق الكامل للإعدادات موجود في configs/config.example.yaml.

مرجع الأوامر

إيقاف Cover لا يغيّر إعدادات العميل. العميل الذي لا يزال موجهاً إلى Cover سيفشل في الاتصال حتى يُعاد تشغيل Cover أو يُعاد توجيه العميل إلى مزوّده المباشر أو الموجّه الخاص به.

stop وrestart وupdate ترسل إشارة فقط إلى عملية تكون Cover: يجب أن يُبلّغ المستمع عن تلك العملية على نقطة النهاية /__cover/health المقتصرة على loopback، أو يجب أن يكون اسم الملف التنفيذي للعملية cover. يُزال أي pidfile قديم، بما في ذلك الذي أصبح معرّف العملية فيه ملكاً لبرنامج آخر، ولا يتم إيقاف برنامج آخر على منفذ Cover أبداً.

تُفرّغ عمليات الإيقاف وإعادة التشغيل الطلبات النشطة لمدة تصل إلى 30 ثانية، قابلة للضبط عبر shutdown_timeout_ms. على Windows، الذي لا يملك SIGTERM، يُنهي cover stop العملية دون تفريغ. بعد هذا الموعد النهائي، تُغلق الاتصالات المتبقية. قد تفشل الاتصالات الجديدة لفترة وجيزة أثناء إعادة التشغيل؛ هذا ليس تسليماً بدون توقف. يُبلّغ cover status وcover doctor عندما تختلف الخدمة الخلفية قيد التشغيل عن الملف التنفيذي المثبّت.