كيميكود كبديل لـ Cursor: إعداد نقطة النهاية المخصصة

ما الذي يعمل وما يمكن توقعه

تتيح لك العديد من محررات الأكواد ذات الدردشة المدمجة استبدال نقطة النهاية الخاصة بـ OpenAI بنقطة نهاية خاصة بك. هذا الإعداد هو ما يمكّن ذلك. تزوّد المحرر بثلاثة أشياء: عنوان URL الأساسي، ومفتاح API، واسم النموذج. كل شيء آخر هو سلوك المحرر الخاص به.

تتمثل الـ API هنا في خدمة مستضافة ومتوافقة مع OpenAI، تعتمد نموذجًا واحدًا مفتوح الأوزان، وتشغّلها جهة مستقلة ومضبوطة للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين. إنها ليست خدمة Kimi الخاصة وليست وسيطًا بين عدة موردين، لذا لا يوجد خيار اختيار النموذج. تحصل على uncensored، وهذا هو معرف النموذج الوحيد.

كن واقعياً بشأن ما يتعلق بالملاءمة. لا ادّعي أن هذا النموذج يتفوق على محرر الأداة الافتراضي في كتابة الكود، وليس لديّ معيار أداء لعرضه عليك. ما تحققه هو التحكم: نقطة النهاية الخاصة بك، والفوترة لكل رمز بسعر $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مخرج، ونموذج لا يرفض الطلب بسبب موضوعه. ما تخسره هو الميزات التي يتيحها المحرر فقط لنماذجه الخاصة.

خطوة بخطوة: تجاوز العنوان الأساسي

1. سجّل الدخول وافتح صفحة مفتاح API. أنشئ مفتاحًا. يمكن للمستخدمين الجدد المطالبة برصيد تجريبي مجاني بقيمة $0.50 بنقرة واحدة، بدون بطاقة، صالح لمدة 7 أيام.
2. في محررك، افتح إعدادات النموذج أو الـ API. على سبيل المثال، يحتوي Cursor على خيار لتجاوز العنوان الأساسي لـ OpenAI في إعدادات النموذج. يتغير اسم وموقع هذا الخيار بين الإصدارات، لذا تحقق من وثائق المحرر الخاصة به إذا لم تتمكن من العثور عليه.
3. أدخل العنوان الأساسي: https://api.kimicode.cc/v1. لا تضيف /chat/completions.
4. الصق مفتاحك في حقل مفتاح OpenAI.
5. أضف نموذجاً مخصصاً باسم uncensored وحدده في لوحة الدردشة.
6. قم بتشغيل سؤال اختبار صغير. إذا أظهر المحرر خطأً، افتح وحدة التطوير أو السجلات وابحث عن حالة HTTP. 401 يعني مشكلة في المفتاح، و404 يعني مشكلة في العنوان، و429 يعني تجاوز حدّ المعدل.

بعض المحررات تتحقق من صحة المفتاح عن طريق استدعاء اسم نموذج مستضاف لا يوجد هنا. إذا فشل التحقق ولكن الدردشة تعمل، تجاهل خطوة التحقق. إذا رفض المحرر الحفظ بدونها، استخدم أداة أخرى من القسم التالي.

احتفظ بحدود التجربة في الاعتبار أثناء الاختبار: طلبان متزامنان و60 في الدقيقة. قد يؤدي المحرر الذي يطلق عدة طلبات خلفية في وقت واحد، مثل الاكمال التلقائي والدردشة، إلى تجاوز حدّ الطلبات المتزامنة. المفتاح الكامل يسمح بـ 8 طلبات متزامنة و300 في الدقيقة.

محررات وأدوات أخرى تقبل نقطة نهاية مخصصة

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

يقرأ Aider متغيرات البيئة القياسية الخاصة بـ OpenAI ويأخذ نموذجًا متوافقًا مع OpenAI مع بادئة openai/:

Copyexport OPENAI_API_BASE="https://api.kimicode.cc/v1"
export OPENAI_API_KEY="YOUR_KEY"
aider --model openai/uncensored

يقبل Continue، وهو امتداد لـ VS Code وJetBrains، إدخال نموذج مع تعيين المزود إلى openai وعنوان أساسي للـ API. يختلف تنسيق الملف حسب الإصدار، لذا هذا هو الشكل الذي يجب البحث عنه:

Copy{
  "models": [
    {
      "title": "Kimicode API",
      "provider": "openai",
      "model": "uncensored",
      "apiBase": "https://api.kimicode.cc/v1",
      "apiKey": "YOUR_KEY"
    }
  ]
}

يقدم Cline مزودًا متوافقًا مع OpenAI في إعداداته، حيث تدخل نفس العنوان الأساسي والمفتاح ومعرف النموذج. في جميع الحالات، النمط هو نفسه: اختر المزود المتوافق مع OpenAI، وليس المزود المسمى باسم مورد.

موجّه نظام يناسب عمل البرمجة

تضيف المحررات عادةً تعليماتها الخاصة، لكن العديد منها يتيح لك إضافة قواعد مخصصة أو موجّه نظام. يتفوق الموجّه القصير والمحدد على الطويل. إليك نقطة بداية يمكنك تعديلها:

أنت مساعد برمجة يعمل في مشروع المستخدم. أجب بأقل تغيير يحل المشكلة. أظهر الاختلافات أو الدالة المعدلة، وليس الملف بأكمله. إذا كان المتطلب غير واضح، اسأل سؤالاً واحدًا قبل كتابة الكود. اذكر أي افتراض تتخيله حول الإصدارات أو أطر العمل.

لماذا هذه الأسطر؟ يقلل "أصغر تغيير" من رموز المخرجات، وهي الجانب الأغلى بسعر $0.50 لكل 1M. يقوم "إظهار الاختلافات" بذلك أيضاً ويجعل المراجعة أسهل. يمنع "اسأل سؤالاً واحداً" الحصول على إجابة طويلة وخاطئة. يتيح "اذكر الافتراضات" لك التقاط الخطأ قبل أن يصل إلى الكود الخاص بك.

حافظ على درجة حرارة منخفضة للكود. تعطي القيم حول 0.2 إلى 0.4 مخرجات أكثر استقراراً، ويمكنك تمرير seed إذا كنت تريد نتائج قابلة للتكرار أثناء تصحيح خطأ في الموجّه. يتم تمرير كلاهما إلى النموذج.

سكربت عندما يكون المحرر غير كافٍ

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

Copyimport os, sys
from openai import OpenAI

client = OpenAI(base_url="https://api.kimicode.cc/v1", api_key=os.environ["KIMICODE_KEY"])

SYSTEM = (
    "You are a careful code reviewer. List real bugs first, then risky spots. "
    "Quote the line you mean. Skip style comments."
)

path = sys.argv[1]
code = open(path, encoding="utf-8").read()

stream = client.chat.completions.create(
    model="uncensored",
    stream=True,
    temperature=0.3,
    messages=[
        {"role": "system", "content": SYSTEM},
        {"role": "user", "content": f"Review {path}:\n\n{code}"},
    ],
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
print()

شغّله كـ python review.py app/server.py. ملف مكون من 1,000 رمز ومراجعة مكونة من 600 رمز تكلف $0.00015 + $0.0003 = $0.00045. يمكنك مراجعة بضعة آلاف من الملفات بأقل من $2.

نفس النمط يعمل لرسائل الالتزام، وتوليد الاختبارات، وتعليقات التوثيق. اربط السكربت بمفتاح في محررك وستحصل على أمر مخصص بدون أي إضافات على الإطلاق.

أين يناسب هذا الحل وأين لا يناسب

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

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

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

حدود صادقة لنموذج نصي فقط

ثلاثة حدود تستحق معرفتها قبل التبديل.

نص فقط. لا توجد مدخلات صور ولا توجد نقطة نهاية للتضمين. إذا كان محررك يفهرس قاعدة بيانات برمجية باستخدام التضمين، فإن هذا الفهرس يحتاج مصدر آخر أو تظل الميزة معطلة. لن يعمل أيضاً لصق لقطة شاشة لخطأ؛ الصق نص الخطأ.

نافذة 100,000 رمز. هذا هو الموجّه بالإضافة إلى الإكمال. كقاعدة تقريبية، يعمل الكود بحوالي ثلاثة إلى أربعة أحرف لكل رمز، لذا فإن ملف كبير بحجم 40 كيلوبايت يتراوح بين 10,000 إلى 13,000 رمز. المحررات التي ترفق ملفات كثيرة قد تصل إلى السقف بسرعة. عندما ترى خطأ في السياق، ارفق ملفات أقل، وليس أكثر.

لا توجيه مخفي. تحصل على نموذج واحد. إذا أخطأ في مهمة، فلا يوجد نموذج احتياطي يعمل خلف الكواليس، لذا أعد صياغة الأمر، أضف مثالاً، أو حدّ من السؤال.

من حيث التكلفة، تبلغ تكلفة سؤال برمجي نموذجي يحتوي على 20,000 رمز إدخال و1,000 رمز إخراج $0.003 + $0.0005 = $0.0035. خمسون من هذه في اليوم تساوي $0.175. صفحة التسعير تذكر شحنات الرصيد من $20 إلى $500 مع مكافآت من $50، ولا ينتهي الرصيد. لا تُستخدم الموجّهات للتدريب.

قائمة التحقق قبل الالتزام

• اختبر مع رصيد التجربة في مهمة حقيقية من مشروعك الخاص، وليس موجهاً بسيطاً.
• تحقق من أن البث المتدفق يعمل في محررك. إذا ظهرت الإجابات فقط في النهاية، فقد يكون المحرر يقوم بالتخزين المؤقت.
• أكد أن استدعاء الدوال مربوط إذا كنت تستخدم ميزات الوكيل. تدعم هذه API tools وtool_calls المتدفق، لكن المحرر يقرر ما إذا كان سترسلها.
• اقرأ دليل البدء السريع مرة واحدة، بما في ذلك قسم أكواد الأخطاء.
• قرر سقف الشحن الشهري. بما أن الفوترة مسبقة الدفع، فإن أقصى ما يمكنك إنفاقه هو ما أضفته.

التصميم المسبق للدفع هو شبكة أمان للمحررات التي تشغل حلقات الوكيل. تتوقف الحلقة التي تخرج عن المسار عندما ينتهي الرصيد، بدلاً من إنتاج فاتورة مفاجئة.

المزيد من الأدلة

• أسعار Kimi Code API مقابل الرموز حسب الاستخدام
• Kimi Code API URL: إعداد Base URL لعملاء OpenAI
• Groq API: خرافات مقابل حقائق حول نماذج اللغة الكبيرة بدون رقابة