Skip to main content

Integrasi OpenCode

Halaman ini menerangkan cara OpenCode (alat pengekodan ejen) berintegrasi dengan gerbang Yabanin — iaitu, kontrak sisi gerbang: ke model mana OpenCode dihalakan, cara pelaksana langganan diwakilkan, dan cara sesi yang didorong OpenCode ditadbir (bajet, penandaan tugas, cangkuk pengawal).

Pembangunan tempatan, pemasangan pelantar, dan pengendalian kelayakan diliputi dalam Panduan Pembangunan. Halaman ini tidak mengulang persediaan itu; ia mendokumentasikan permukaan integrasi itu sendiri.


Penghalaan model untuk ejen yabanin​

Ejen OpenCode yabanin bercakap dengan endpoint serasi OpenAI milik gerbang (POST /v1/chat/completions). Gerbang menghalakan setiap permintaan mengikut bentuk tugas, jadi "model berfikir" ejen dan "pengekod pantas"nya boleh menjadi penyedia yang berbeza di bawah satu kunci. Keputusan penghalaan didedahkan pada pengepala respons X-Yabanin-Decision (lihat Tadbir Urus Ejen — Pengepala keputusan) supaya sesi boleh mencatat dalam log mengapa respons tertentu menggunakan model tertentu.

Pendawaian ejen (make opencode-remote-wire, pelantar awam di https://yabanin.ai/gw) menghalakan ejen OpenCode melalui model gerbang Yabanin dan laluan mengikut bentuk tugas:

LaluanModelDigunakan untuk
Ejen utama yabaninmodel perancangan yang dikonfigurasiMemimpin sesi, perancangan, penaakulan kompleks.
Subejen reasonmodel analisis yang dikonfigurasiAnalisis mendalam, seni bina, tolak ansur, sintesis penyelidikan.
Subejen codepengekod tempatan yang dikonfigurasiSuntingan kod yang jelas dan ditentukan dengan baik — templat, ujian, dokumen, pemfaktoran semula yang dipacu arahan.
Subejen complex-codemodel flash yang dikonfigurasi (dengan sandaran)Penjanaan kod algoritma yang berat.

Nama model yang konkrit ialah konfigurasi pelaksanaan (tetapan registri / penghalaan organisasi), bukan sebahagian daripada kontrak gerbang. Apa yang kontrak jamin: permintaan dihalakan secara deterministik mengikut kelas, keputusan dilog, dan perakaunan cache / kos / peringkat semuanya terpakai tepat seperti bagi mana-mana klien kunci API.


Pewakilan langganan (tr_delegate)​

Untuk tugas pengekodan yang sukar, OpenCode boleh mewakilkan kepada pelaksana langganan Codex atau Cursor melalui alat MCP tempatan tr_delegate:

  • tr_delegate { mode: "analyze" | "implement", task: "…", provider?: "auto" | "codex" | "cursor" }
  • analyze ialah semakan baca sahaja; implement menulis ke ruang kerja.
  • provider: auto memilih pelaksana yang tersedia; codex / cursor memaksa satu.
  • tr_delegation_status melaporkan sama ada setiap pelaksana dikonfigurasi (ia tidak memulangkan kelayakan).

Pewakilan dimatikan secara lalai dan didayakan dengan YABANIN_DELEGATION_ENABLED=true. Kelayakan kekal pada mesin (Codex daripada ~/.codex/auth.json, Cursor daripada agent login rasmi); gerbang tidak sekali-kali melihatnya. Pewakilan ialah hal sidecar (services/subscription-bridge/); gerbang hanya mengendalikan trafik sembang/alat yang serasi dengan OpenAI.

Wakilkan hanya apabila laluan dalam ejen di atas tidak mencukupi — model utama sepatutnya menggunakan alat natifnya untuk kerja biasa.


Mentadbir sesi OpenCode​

Oleh kerana sesi yang didorong OpenCode hanyalah klien gerbang, permukaan tadbir urus ejen yang penuh terpakai. Cadangan praktikal:

  • Tag tugas pada setiap unit kerja logik. Hantar X-Yabanin-Task bagi setiap tugas (contohnya stand-opencode/feature-42). Ini menjadikan perbelanjaan sesi boleh diatribusi dalam CTOR / analitik tugas dan membolehkan anda mengehadkannya dengan YABANIN_TASK_TOKEN_BUDGET.
  • Hadkan sesi yang lari. Tetapkan YABANIN_TASK_TOKEN_BUDGET (disyorkan 500000) dan/atau YABANIN_SESSION_TOKEN_BUDGET (disyorkan 200000). Pada ≥80% gerbang menetapkan X-Yabanin-Budget-Warning; pada 100% ia memulangkan 429 supaya klien boleh undur.
  • Halakan kerja murah ke waktu murah. Dayakan YABANIN_TIME_ROUTING dengan YABANIN_TIME_CHEAP_WINDOW (lalai 22:00-07:00); kerja kelompok (X-Yabanin-Batch: true) sentiasa diturunkan, kerja interaktif boleh menarik diri dengan X-Yabanin-Priority: high.
  • Saring keluar. Untuk sesi yang mungkin mengeluarkan data sensitif, jalankan YABANIN_GUARD_MODE=log (perhati) dan ketatkan kepada redact / deny selepas profil positif palsu diketahui. Lihat kaveat FP cangkuk pengawal.
  • Sahkan garis keturunan. Selepas larian, yb lineage verify --org <org> mengesahkan rantai pengesahan per permintaan adalah utuh, dan yb lineage export … --s3 … --lock-compliance menghasilkan salinan bukti WORM. Lihat Garis keturunan — rantai hash + eksport.

Penilaian sebelum menghantar perubahan penghalaan​

Oleh kerana trafik OpenCode ialah beban sebenar pada penghala, uji regresi penghalaan dan perubahan pengawal dengan suit luar talian sebelum ia sampai ke pelantar:

make evaluate-routing
make evaluate-guards

Lihat Suit Penilaian.