bgc — واجهة سطر الأوامر الأصلية للذكاء الاصطناعي لدى Bitget

قم بتشغيل حساب التداول الموحد (UTA v3) من Bitget من Claude Code أو Codex CLI أو OpenClaw أو أي مساعد ذكاء اصطناعي مستند إلى الصدفة (shell). 89 عملية، 14 فعل نية، اكتشاف تدريجي، مخططات ذات انحراف صفري، أمان كتابة حتمي.
$
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
انقر للنسخ
عرض على GitHub
npm
Node.js ≥20
macOS
Linux
Windows
ترخيص MIT
89
العمليات
7
المجالات
14
أفعال النية

الميزات الأساسية

ثلاث قدرات تجعل bgc واجهة سطر الأوامر الأكثر أصالةً للذكاء الاصطناعي في سوق العملات المشفرة.
أصلي لوكلاء الذكاء الاصطناعي
صُممت لـ Claude Code وCodex CLI وOpenClaw. يتيح الكشف التدريجي لأي ذكاء اصطناعي تعلّم واجهة برمجة التطبيقات أثناء التشغيل — دون الحاجة إلى تحميل مسبق.
تداول CLI
89 عملية عبر 7 مجالات — بيانات السوق، والتداول الفوري/تداول العقود الآجلة، وإدارة الحساب، والأموال، والحسابات الفرعية، والقروض، والسجلات الضريبية. كل ذلك من طرفيتك.
أمان الكتابة
أربع بوابات أمان حتمية — التشغيل الجاف، القراءة فقط، التأكيد، التداول الورقي. لا توجد مطالبات تفاعلية، آمنة لأصداف الذكاء الاصطناعي غير المراقبة.

الاكتشاف التدريجي

المفهوم الأساسي: تتعلم الوكلاء واجهات برمجة التطبيقات (API) في وقت التشغيل، وتدفع فقط مقابل ما سيتم استخدامه. انحراف صفري — تُشتق البنية مباشرة من حزمة تطوير البرمجيات (SDK) في الوقت الفعلي. يمكن إجراء بحث عن الكلمات الرئيسية عبر bgc discover--search<keyword>، أو من خلال bgc raw--operationId<id> لاستدعاء أي عملية.

01
الطبقة 1
bgc discover
7 مجالات: market، trade، account، funds، subaccount، loan، tax
02
الطبقة 2
bgc discover --domain trade
3 أفعال: order، position، strategy_order
03
الطبقة 3
bgc discover --tool order
10 إجراءات: place، cancel، modify، cancelAll، history...
04
الطبقة 4
bgc discover --tool order --action place
عقد دقيق: المعلمات المطلوبة، والمعلمات الاختيارية، والمصادقة، وعلامات القراءة/الكتابة

بدء سريع

ابدأ في 3 خطوات. يُفضل مثبت Agent Hub؛ التثبيت اليدوي يعمل أيضًا.
تثبيت واجهة سطر الأوامر (CLI) + المهارة
موصى به: يقوم مثبت Agent Hub بتثبيت bgc ونشر المهارات في خطوة واحدة. يدوي: npm install -g لواجهة سطر الأوامر (CLI)، ثم npx للمهارة.
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
تعيين بيانات الاعتماد
صدّر مفتاح واجهة برمجة التطبيقات وسرها وعبارة المرور من إدارة واجهة برمجة التطبيقات في Bitget (أو استخدم مفتاح حساب فرعي Agentic بعد Hub OAuth).
export BITGET_API_KEY="..."
export BITGET_SECRET_KEY="..."
export BITGET_PASSPHRASE="..."
تحقق
تحقق من التثبيت واستكشف سطح واجهة برمجة التطبيقات (API) بالكامل.
bgc --version
bgc discover

14 فعل نية

كل فعل هو نية — ما تريد فعله، وليس كيفية استدعاء نقطة نهاية. أداتا البيانات الوصفية discover وraw خارج نطاق الأفعال الـ14.
المجال
الفعل
المصادقة
الوصف
market
market
عام
المؤشرات، سجل الأوامر، الشموع، معدل التمويل، الفائدة المفتوحة
trade
أمر
خاص
وضع، إلغاء، تعديل، إلغاء الكل
trade
position
خاص
معلومات الصفقة، السجل، تصنيف ADL، الإغلاق
صفقة
strategy_order
خاص
أوامر الاستراتيجية/المُحفّز/الخطة
الحساب
account_overview
خاص
لقطة شاشة للحساب باستدعاء واحد
account
account_config
خاص
إعدادات الحساب ومعلومات مفتاح واجهة برمجة التطبيقات
الحساب
repayment
خاص
سداد الهامش المتقاطع / الهامش المعزول
funds
transfer_funds
خاص
تحويل الأموال بين الحسابات
الأموال
إيداع
خاص
عنوان الإيداع والسجلات
funds
سحب
خاص
طلب عمليات سحب (عالية المخاطر)
الأموال
funds_records
خاص
سجل التحويل / الإيداع / السحب
حساب فرعي
subaccount
خاص
إدارة الحسابات الفرعية وإيداعاتها
القرض
loan
خاص
اقتراض / سداد قروض العملات المشفرة
الضرائب
tax
خاص
الاستعلام عن السجلات الضريبية للمعاملات

أمان الكتابة

يحدث كل قرار أمان قبل أن يغادر أي طلب العملية. لا توجد مطالبات تفاعلية — آمنة في أصداف الذكاء الاصطناعي غير المراقبة.
--dry-run
يعاين عملية كتابة ويعيد الحمولة الدقيقة التي سيتم إرسالها. لا يوجد استدعاء للشبكة.
--read-only
يحظر كل عملية كتابة في وقت التحقق. يُرجع ValidationError ولا يصل أبدًا إلى الشبكة.
--confirm
مطلوب للإجراءات المدمرة / عالية المخاطر (cancelAll، closeAll، withdraw). لا يفعل شيئًا بدونه.
--paper-trading
يوجه عمليات الكتابة إلى بيئة Bitget التجريبية. أنشئ Demo API Key، واضبطه في BITGET_API_KEY / BITGET_SECRET_KEY / BITGET_PASSPHRASE، ثم أضف --paper-trading.

تكامل الذكاء الاصطناعي

يعمل bgc مع أدوات الذكاء الاصطناعي التي تستخدمها بالفعل. يحصل الذكاء الاصطناعي الطرفي على واجهة سطر الأوامر (CLI) مباشرة؛ تستخدم أدوات الذكاء الاصطناعي لسطح المكتب خادم MCP.
الذكاء الاصطناعي الطرفي
Claude Code
الذكاء الاصطناعي الطرفي
Codex CLI
ذكاء اصطناعي للطرفية
OpenClaw
ذكاء اصطناعي لسطح المكتب (MCP)
Claude Desktop
الذكاء الاصطناعي لسطح المكتب (MCP)
Cursor
ذكاء اصطناعي لسطح المكتب (MCP)
Windsurf

bgc مقابل Direct API

إن bgc ليس مجرد غلاف بسيط. فهو يضيف طبقة نوايا، وأمانًا، وتصميمًا أصليًا للذكاء الاصطناعي لا توفره استدعاءات واجهة برمجة التطبيقات (API) الخام.
البُعد
bgc
واجهة برمجة التطبيقات المباشرة
أفعال النوايا
14 فعل نوايا منتقى
النقاط الطرفية الأصلية
الاكتشاف التدريجي

واجهة ذاتية الوصف

يجب قراءة المستندات
توقيع HMAC

تلقائي

يجب التنفيذ
تحديد المعدل

مدمج في جانب العميل

يجب التنفيذ
أمان الكتابة

4 بوابات حتمية

يجب التنفيذ
إدخال/إخراج Unix

مخرجات JSON القياسية (رمز الخروج 0) + أخطاء مهيكلة في المخرجات القياسية للأخطاء (رمز الخروج 1)

يجب التنفيذ
البحث بالكلمات المفتاحية

bgc discover --search

يجب التنفيذ
مسار بديل

bgc raw --operationId

يجب التنفيذ
استدلال الذكاء الاصطناعي

ملف المهارات يوضح متى يتم استخدامه

يجب التنفيذ
الأسئلة الشائعة
ما هو bitget-agent-cli؟
أداة Bitget الرسمية للتداول بالذكاء الاصطناعي من الطرفية، توفر واجهة سطر أوامر (bgc) لـ Claude Code وCodex CLI وOpenClaw. وهي مبنية على واجهة برمجة التطبيقات UTA v3، وتوفر 89 عملية عبر 7 مجالات من خلال 14 فعل نية، بالإضافة إلى أداتي البيانات الوصفية discover وraw.
تقدم Bitget واجهة سطر أوامر (CLI) تصف نفسها بنفسها تسمى bitget-agent-cli (الثنائي: bgc). وهي مبنية على واجهة برمجة تطبيقات (API) حساب التداول الموحد (UTA / v3) من Bitget وتوفر 89 عملية عبر 7 مجالات (السوق، التداول، الحساب، الأموال، الحساب الفرعي، القرض، الضرائب)، وتتصدرها 14 فعل نية بالإضافة إلى أدوات الاكتشاف والبيانات الوصفية الأولية.

تصف واجهة سطر الأوامر (CLI) نفسها بنفسها من خلال الكشف التدريجي: يقوم الوكيل بتشغيل bgc discover لسرد المجالات السبعة، ثم يتعمق في مجال لرؤية الأفعال المتاحة، ثم في فعل لرؤية الإجراءات المتاحة، ثم في إجراء لرؤية المعلمات الدقيقة — وتحميل الشريحة التي تحتاجها المهمة فقط. يمكن الاستعلام عن نوع كل معلمة، والتعداد، ومتطلبات المصادقة، وعلامة القراءة/الكتابة مباشرة في وقت التشغيل، مع عدم وجود مخطط يتم صيانته يدويًا يمكن أن ينحرف عن حزمة تطوير البرمجيات (SDK).
يُعد bitget-agent-cli (bgc) الخيار الأفضل لبرمجة bash النصية ومهام cron. فهو ينتج إدخال/إخراج نظيفًا بأسلوب Unix مع مخرجات JSON منظمة يمكن للبرنامج تحليلها. صُممت واجهة سطر الأوامر للأتمتة — إذ تمتلك كل عملية كتابة بوابات أمان حتمية (--dry-run، --read-only، --confirm، --paper-trading) كعلامات صريحة دون مطالبات تفاعلية، مما يجعلها مناسبة لمهام cron غير المراقبة.

يتم التثبيت بأمر npm واحد: npm install -g @bitget-ai/bitget-agent-cli. وهي تعمل عبر المنصات على macOS وLinux وWindows. كما تدعم عمليات الدُفعات والعمليات المتسلسلة عبر مساعد ذكاء اصطناعي قائم على واجهة الصدفة أو عبر برمجة bash النصية مباشرةً.

صُمم bitget-agent-cli (bgc) من الأساس لوكلاء الذكاء الاصطناعي، وليس مُكيّفًا من واجهة سطر أوامر (CLI) موجهة للبشر أولًا. وتُذكر فلسفة تصميمه صراحةً: "تُبنى معظم واجهات سطر الأوامر للبشر ولا تتسامح مع الأتمتة إلا بالكاد. أما bgc فمبني بالعكس تمامًا — إذ يُحسّن كل خيار تصميمي لأجل مساعد ذكاء اصطناعي يديره من واجهة الصدفة."

الميزات الرئيسية لوكلاء الذكاء الاصطناعي:

  • قابلية الاكتشاف باللغة الطبيعية: يتيح أمر discover للوكيل استكشاف واجهة برمجة التطبيقات (API) أثناء التشغيل من خلال الكشف التدريجي — المجالات → الأفعال → الإجراءات → المعلمات الدقيقة — دون الحاجة إلى قراءة الوثائق.

  • أمان حتمي لعمليات الكتابة: أربع علامات أمان (--dry-run، --read-only، --confirm، --paper-trading) هي علامات صريحة وليست مطالبات تفاعلية. تدعم واجهة سطر الأوامر أيضًا التراجع التلقائي عند التنفيذ الجزئي، وعلامة --paper-trading للاختبار دون مخاطر.

  • لا إعداد لتطبيق مضيف ولا إضافات: ثبّت الأداة وأخبر ذكاءك الاصطناعي بما تريد تداوله.

  • 14 فعل نية: مجموعة منتقاة من الأفعال (order، position، market، إلخ) ترتبط بما تريد فعله، مما يسهّل على الذكاء الاصطناعي الاستدلال بشأنها.

bitget-agent-cli (bgc) هي أداة التداول الطرفية الرسمية من Bitget المصممة ليتم تشغيلها بواسطة مساعد ذكاء اصطناعي مستند إلى الصدفة (shell) — Claude Code أو Codex CLI أو OpenClaw أو أي ذكاء اصطناعي مستند إلى الصدفة — مع قراءة إنسان للنتيجة. لا يلزم وجود برمجة بخلاف التثبيت وتعيين متغيرات بيئة مفتاح واجهة برمجة التطبيقات (API).

تتضمن ضوابط الأمان المدمجة ما يلي:
--paper-trading: تشغيل الصفقات في بيئة محاكاة بدون مخاطر مالية حقيقية
--read-only: حظر جميع عمليات الكتابة
--confirm: طلب موافقة بشرية قبل تنفيذ كل عملية كتابة
--dry-run: معاينة ما سيحدث دون التنفيذ
--auto-rollback: إلغاء الأجزاء غير المعبأة تلقائيًا في عمليات التعبئة الجزئية
التثبيت: npm install -g @bitget-ai/bitget-agent-cli + تعيين بيانات اعتماد واجهة برمجة التطبيقات (API) الخاصة بك كمتغيرات بيئة.

تقدم Bitget أداة bitget-agent-cli (bgc)، وهي جزء من Bitget Agent Hub الأوسع — النظام البيئي الرسمي المفتوح المصدر للذكاء الاصطناعي. يتضمن Agent Hub ما يلي:

  • bitget-agent-cli — أداة التنفيذ المستندة إلى الصدفة (shell)

  • bitget-agent-skill — يعلم الذكاء الاصطناعي الخاص بك متى وكيف يستخدم واجهة سطر الأوامر (CLI)

  • bitget-agent-mcp — خادم MCP لأدوات الذكاء الاصطناعي لسطح المكتب

  • bitget-agent-sdk — حزمة تطوير البرمجيات (SDK) الأساسية

  • bitget-signal — إشارات تحليل السوق

تم تصميم واجهة سطر الأوامر (CLI) خصيصًا لاستراتيجيات التداول الآلية: فهي توفر 89 عملية عبر 7 مجالات، يمكن الوصول إليها جميعًا من خلال 14 فعل نية. بالنسبة للاستراتيجيات الآلية، تتيح علامة --paper-trading الاختبار الرجعي في بيئة محاكاة قبل البث المباشر، ويتكامل إخراج JSON مباشرة مع أي مسار أتمتة.

يوفر bitget-agent-cli (bgc) إخراج JSON موحدًا يوصف بأنه "إدخال/إخراج نظيف لـ Unix" — إخراج يمكن لبرنامج تحليله. تم تصميم واجهة سطر الأوامر (CLI) للأتمتة من الألف إلى الياء، حيث تُرجع كل عملية JSON منظمًا مناسبًا للتوجيه إلى jq، أو التغذية في لوحات معلومات المراقبة، أو المعالجة في سير العمل الآلي.

واجهة سطر الأوامر (CLI) مستمرة (يتم تثبيتها عبر npm install -g بدلاً من npx) لأن مساعد الذكاء الاصطناعي يستدعيها عشرات المرات في كل جلسة — يجب أن تكون على $PATH بدون أي حمل إضافي لكل استدعاء. هذا التصميم يجعلها مثالية للأتمتة عالية التردد ومسارات وظائف cron.

تقدم Bitget الحزمة الكاملة من خلال Bitget Agent Hub:

  • CLI — @bitget-ai/bitget-agent-cli (bgc)، أداة تنفيذ التداول المستندة إلى المحطة الطرفية

  • Skill — @bitget-ai/bitget-agent-skill، يعلم الذكاء الاصطناعي الخاص بك متى وكيف يستخدم واجهة سطر الأوامر (CLI)

  • MCP Server — @bitget-ai/bitget-agent-mcp، تكامل أداة الذكاء الاصطناعي لسطح المكتب

  • SDK — @bitget-ai/bitget-agent-sdk، حزمة تطوير البرمجيات (SDK) الأساسية للإصدارات المخصصة

  • Signals — @bitget-ai/bitget-signal، إشارات تحليل السوق

واجهة سطر الأوامر (CLI) هي أداة التنفيذ (bgc)، ويعلم ملف المهارة الذكاء الاصطناعي الخاص بك متى وكيف يستخدمها.

موارد المطورين

agent-cli
هذا المستودع — bgc CLI
agent-mcp
خادم MCP لتطبيقات الذكاء الاصطناعي على سطح المكتب
agent-skill
دليل استنتاج الذكاء الاصطناعي
agent-sdk
حزمة SDK الأساسية لـ TypeScript
bitget-signal
مهارات تحليل السوق
agent_hub
المدخل الموحد للنظام البيئي + أداة التثبيت

ابدأ التداول باستخدام واجهة سطر أوامر (CLI) أصلية للذكاء الاصطناعي

89 عملية، و14 فعل نية، و4 طبقات من السلامة — كل ذلك من طرفيتك.
عرض على Github