poe-code

Poe Code هو أداة توجّه وكلاء البرمجة المفضلين لديك (Claude Code، Codex، OpenCode، Goose، وغيرها) عبر Poe API، بحيث تحتاج فقط إلى اشتراك Poe واحد بدلاً من إدارة عدة مزودين أو حسابات. يعمل مع واجهات سطر الأوامر أو تطبيقات سطح المكتب العادية للوكلاء بعد تكوين لمرة واحدة، ويدعم أيضًا تشغيل مطالبات لمرة واحدة للبرمجة النصية وCI/CD. ## البدء السريع اضبط Poe Code كمزود افتراضي لوكيل (يحدّث ملفات التكوين): ```bash npx poe-code@latest configure npx poe-code@latest configure codex # أو claude، opencode، goose ``` أزل التجاوزات باستخدام `unconfigure`: ```bash npx poe-code@latest unconfigure claude ``` ## المصادقة يستخدم مفتاح Poe API الخاص بك. عند أول تشغيل، سيُطلب منك تسجيل الدخول عبر المتصفح (OAuth). يمكنك أيضًا تقديم المفتاح مباشرة: ```bash npx poe-code@latest login npx poe-code@latest login --api-key <مفتاحك> export POE_API_KEY=<مفتاحك> ``` تُخزَّن بيانات الاعتماد في `~/.poe-code/`. تحقق من الحالة باستخدام `poe-code auth status`، وأزلها باستخدام `logout`. ## الأدوات المساعدة - **تشغيل مطالبة لمرة واحدة**: `npx poe-code@latest spawn codex "قل مرحبًا" --mode read` (الأنماط: yolo، auto، edit، read؛ مطلوبة في CI بدون TTY). - **التشغيل مقابل مستودع GitHub**: `--cwd github://owner/repo` أو مع ref/subdir مثل `github://owner/repo#main:packages/auth`. - **تمرير المطالبة عبر stdin**: `echo "قل مرحبًا" | npx poe-code@latest spawn codex --mode read`. - **مراجعة طلب سحب على GitHub**: `code-review install`، `code-review run <url>`، `code-review commit <url> --dry-run`. - **اختبار خدمة مكوّنة**: `npx poe-code@latest test codex`. - **تثبيت واجهات سطر أوامر الوكلاء**: `install claude-code`، `install codex`، `install opencode`، `install goose`. - **خيارات إضافية**: `--dry-run` (عرض التغييرات دون لمس القرص)، `--yes` (قبول الافتراضيات). ## الاستخدام والفوترة تحقق من رصيد نقاط الحوسبة وسجل الاستخدام: ```bash poe-code usage poe-code usage list poe-code usage list --limit 100 poe-code usage list --filter claude ``` ## النماذج اعرض قائمة نماذج Poe API المتاحة، وصفِّ حسب نقطة النهاية أو المزود أو البحث: ```bash poe-code models poe-code models --endpoint /v1/responses poe-code models --endpoint /v1/chat/completions poe-code models --search claude ``` ## SDK استخدم Poe Code برمجيًا في الكود الخاص بك: ```typescript import { spawn, getPoeApiKey, getPoeAuthIdentity } from "poe-code"; const apiKey = await getPoeApiKey(); const identity = await getPoeAuthIdentity(); const result = await spawn("claude-code", { prompt: "أصلح الخطأ في auth.ts", cwd: "/path/to/project", model: "claude-sonnet-4-6" }); console.log(result.stdout); ``` - `spawn(service, options)` – يشغّل مطالبة واحدة؛ تشمل الخيارات `prompt` و`cwd` (مسار محلي أو محدد `github://`) و`model` و`mode` و`args`. يُرجع `{ stdout, stderr, exitCode }`. - `spawn.pretty(service, options)` – نفسه لكن يعرض تدفق أحداث ACP الملون. - `getPoeApiKey()` – يقرأ متغير البيئة `POE_API_KEY` أو ملف بيانات الاعتماد. - `getPoeAuthIdentity()` – يجلب هوية حساب Poe. للتكوين القائم على الإضافات، استخدم المسار الفرعي `poe-code/agent` مع `agent()` و`openaiResponsesPlugin()` و`systemPromptPlugin()`. ## معاينة بحثية ميزات قابلة لتغييرات جذرية: - **SafeJS** – مترجم JavaScript بقدرات مضيف صريحة، وميزانيات تنفيذ، ونقاط توقف قابلة للاستئناف. منشور كـ `@poe-platform/safe-js`. التوافق الكامل غير مثبت. - **Pipeline** – تشغيل خطط المهام بخطوات قابلة للتكوين، وتقدم مباشر، ومتابعات في قائمة الانتظار. - **Ralph** – حلقة بناء وكيلية تتكرر على مستند markdown. - **حلقة التجربة** – حلقة تحسين بأسلوب Karpathy (الوكيل يغيّر الكود، وتُقيَّم النتائج، ويُحتفظ بها أو يُتخلص منها عبر git). - **Poe Agent** – بيئة تشغيل وكيل قابلة للتكوين. ## التحديث ```sh npx poe-code@latest update npx poe-code@latest update --package-manager pnpm ``` للفحوصات الإصدارية، والتشغيل التجريبي، وأشجار العمل المُدارة، راجع المرجع الكامل.