Skip to content
Apothem
Adaptor harness

OpenCode

Adapter harness Apothem untuk OpenCode (Beta).

Vendor: OpenCode Nama instalasi: opencode Status: Beta Konfigurasi native: ~/.config/opencode/

Instalasi

apothem install --harness opencode

Adapter menulis konfigurasi JSON OpenCode, memasang skill Apothem ke permukaan skill OpenCode, mengonversi prompt command menjadi berkas command Markdown OpenCode, dan menormalkan definisi helper Apothem sebagai subhelper OpenCode.

Berkas yang ditulis:

~/.config/opencode/opencode.json
~/.config/opencode/apothem/rules/00-apothem-profile.md
~/.config/opencode/commands/
~/.config/opencode/skills/
~/.config/opencode/agents/
~/.config/opencode/.apothem/support/{rules,templates,hooks}/

Pemetaan profil ke konfigurasi native

Adapter merender opencode.json dengan daftar berkas instructions yang menyebut dokumen profil Anda, empat aturan inti, dan indeks aturan, lalu menyebarkan setiap kohor Apothem bersama ke permukaan native OpenCode atau ke support subtree milik Apothem. Anak yang dikelola Apothem dan cocok yang sudah ada dicadangkan sebelum penggantian.

Catatan kompatibilitas

OpenCode menggabungkan setiap berkas yang disebut daftar instructions ke dalam setiap sesi (aturan OpenCode). Karena itu, daftar tersebut menyebut dokumen profil Anda terlebih dahulu, lalu hanya aturan yang alwaysApply-nya bernilai true, masing-masing dengan satu jalur ~/.config/opencode/.apothem/support/rules/<name>.md eksplisit; OpenCode mengekspansi ~/ di awal terhadap direktori home Anda. Aturan-aturan itu adalah agnostic-posture, authority-inquiry, context-management, session-closure, dan indeks aturan, apothem-rule-index. OpenCode tidak membatasi aturan apa pun berdasarkan jalur, sehingga setiap aturan lain dibaca sesuai kebutuhan. Aturan tersebut tetap terpasang sebagai materi rujukan di bawah ~/.config/opencode/.apothem/support/, dan indeks menyebutkan setiap aturan serta situasi yang memerlukannya. Aturan, skill, atau command yang mengutip sebuah aturan, templat, atau prompt hook membacanya dari sana. Command, skill, dan definisi helper menggunakan lokasi penemuan native.

Dokumen profil ~/.config/opencode/apothem/rules/00-apothem-profile.md membawa identitas dan preferensi Anda dari profil bersama, dan diakhiri dengan bagian berkas pendukung Apothem yang menyebutkan direktori absolut di bawah ~/.config/opencode/.apothem/support/ yang menjadi acuan resolusi setiap sitasi bergaya repositori (rules/<name>.md, templates/..., hooks/...). Dokumen ini adalah entri instructions pertama, sehingga OpenCode memuatnya di setiap sesi.

opencode.json yang ditulis oleh rilis sebelumnya mencantumkan satu glob ~/.config/opencode/.apothem/support/rules/*.md, yang memuat setiap aturan, atau jalur eksplisit untuk masing-masing dari 28 aturan yang saat itu always-on. apothem install dan apothem update mengganti kedua bentuk tersebut dengan daftar di atas, yang membuang 24 jalur yang tidak lagi dimuat saat peluncuran, dan apothem uninstall menghapus semuanya. Entri instructions milik Anda sendiri dipertahankan dalam setiap kasus.

Verifikasi

apothem verify --harness opencode

Perintah verify memastikan bahwa:

  1. Konfigurasi native ada di jalur yang diharapkan.
  2. Setiap target terkelola ada; berkas terkelola tidak kosong, dan konfigurasi JSON atau YAML dapat diurai. Tambahkan --profile PATH untuk juga memastikan bahwa berkas yang terpasang cocok dengan profil tersebut.
  3. Rutin verifikasi khusus adapter melaporkan keberhasilan.

Pembaruan

apothem update --harness opencode

Menyegarkan opencode.json, command native, skill, definisi helper, dan pohon pendukung Apothem.

Pencopotan

apothem uninstall --harness opencode

Menghapus entri yang ditambahkan adapter ke ~/.config/opencode/opencode.json (kunci Anda sendiri, server MCP, dan entri instructions tetap ada, dan berkas itu dihapus hanya ketika Apothem yang membuatnya dan tidak ada lagi yang tersisa milik Anda). Menghapus blok Apothem dari dokumen profil ~/.config/opencode/apothem/rules/00-apothem-profile.md dan mempertahankan teks lain di dalamnya; berkas itu dihapus hanya ketika tidak ada lagi yang tersisa di dalamnya. Juga menghapus berkas Apothem di ~/.config/opencode/commands/, ~/.config/opencode/skills/, ~/.config/opencode/agents/, dan ~/.config/opencode/.apothem/support/; berkas lain di folder-folder tersebut tetap ada. Setiap berkas dicadangkan di bawah ~/.apothem/backups/ sebelum diubah atau dihapus. YAML profil bersama dan mesin Apothem tidak terpengaruh.

Gerbang konformitas

python -m apothem.conformity.gate --all .

Pemecahan masalah

GejalaPerbaikan
Berkas konfigurasi tidak ditemukanJalankan ulang apothem install --harness opencode
Verifikasi gagalJalankan apothem update --harness opencode, lalu verifikasi lagi
Konten konfigurasi tidak terdugaPeriksa ~/.config/apothem/profile.yaml atau --profile PATH, lalu jalankan ulang apothem update --harness opencode

Tombol konfigurasi

FlagDefaultDeskripsi
--dry-runfalsePratinjau instalasi tanpa menulis berkas.

Lihat juga

On this page