اتصال Continue به هوشوانا

Continue دستیار کدنویسی متن‌باز برای VS Code و JetBrains است. مدل‌ها در فایل config.yaml تعریف می‌شوند و هر مدل می‌تواند ارائه‌دهنده و آدرس پایه‌ی خودش را داشته باشد. با ارائه‌دهنده‌ی openai و آدرس هوشوانا، همه‌ی مدل‌های هوشوانا در Continue در دسترس‌اند.

چه چیزی به دست می‌آورید

• چند مدل با نقش‌های مختلف، همه با یک کلید.
• embedding برای جست‌وجوی معنایی در کد پروژه.
• پرداخت ریالی و گزارش هزینه برای هر نقش.

پیش‌نیازها

1. حساب کاربری در هوشوانا.
2. یک کلید API از صفحه‌ی کلیدها.
3. اعتبار کافی در کیف پول.
4. افزونه‌ی Continue نصب‌شده در VS Code یا یکی از IDEهای JetBrains.

راه‌اندازی

1. پنل Continue را باز کنید، روی منوی انتخاب مدل یا آیکون تنظیمات بزنید و فایل پیکربندی را باز کنید. فایل محلی معمولاً در ~/.continue/config.yaml است.
2. بخش models را این‌طور بنویسید:

name: Hooshvana
version: 1.0.0
schema: v1

models:
  - name: Claude Sonnet (Hooshvana)
    provider: openai
    model: anthropic/claude-sonnet-4.6
    apiBase: https://hooshvana.ir/api/v1
    apiKey: hv-YOUR_KEY
    roles:
      - chat
      - edit
      - apply

  - name: GPT-4o mini (Hooshvana)
    provider: openai
    model: openai/gpt-4o-mini
    apiBase: https://hooshvana.ir/api/v1
    apiKey: hv-YOUR_KEY
    roles:
      - chat
      - summarize

  - name: Embeddings (Hooshvana)
    provider: openai
    model: openai/text-embedding-3-small
    apiBase: https://hooshvana.ir/api/v1
    apiKey: hv-YOUR_KEY
    roles:
      - embed

3. فایل را ذخیره کنید. Continue تغییرات را خودکار بارگذاری می‌کند.

نقش‌ها

درباره‌ی تکمیل خودکار

تکمیل خودکار (autocomplete) در Continue به مدل‌هایی نیاز دارد که حالت fill-in-the-middle را پشتیبانی کنند و با ارائه‌دهنده‌ی openai ممکن است به نقطه‌ی پایانی /completions درخواست بفرستد. هوشوانا نقطه‌ی پایانی /chat/completions را ارائه می‌دهد، پس تکمیل خودکار از طریق هوشوانا تضمین‌شده نیست. اگر نقش autocomplete را به یک مدل هوشوانا دادید و خطای 404 گرفتید، برای این نقش از یک مدل محلی استفاده کنید و چت و ویرایش را روی هوشوانا نگه دارید.

نکته درباره‌ی embedding

بعد از اضافه کردن مدل embed، Continue پروژه را دوباره فهرست‌سازی می‌کند. در پروژه‌های بزرگ این کار تعداد زیادی درخواست /embeddings می‌سازد. هزینه‌ی openai/text-embedding-3-small پایین است، اما بهتر است پوشه‌هایی مثل node_modules و خروجی‌های build در .continueignore یا .gitignore باشند.

بررسی اتصال

1. در پنل Continue مدل Claude Sonnet (Hooshvana) را انتخاب کنید و یک سؤال بپرسید.
2. یک قطعه کد را انتخاب کنید و با دستور ویرایش، تغییری بخواهید.
3. در گزارش‌ها باید درخواست‌های /chat/completions و /embeddings را ببینید.

مدل‌های پیشنهادی

شناسه‌ها نمونه هستند؛ فهرست کامل در کاتالوگ مدل‌ها است.

کنترل هزینه

• برای Continue یک کلید جدا بسازید و سقف خرج روزانه بگذارید.
• در مدل‌های مجاز فقط مدل‌های تعریف‌شده در config.yaml را باز بگذارید.
• نقطه‌های پایانی مجاز را روی chat و embeddings محدود کنید.
• کلید را در مخزن git قرار ندهید. اگر config.yaml را با تیم به اشتراک می‌گذارید، کلید را از سازوکار secrets خود Continue بخوانید.

رفع اشکال

اگر مشکل ادامه داشت، کد خطا و زمان درخواست را در تیکت پشتیبانی بفرستید.