OpenCode
Adapter harness Apothem untuk OpenCode (Beta).
Vendor: OpenCode
Nama instalasi: opencode
Status: Beta
Konfigurasi native: ~/.config/opencode/
Instalasi
apothem install --harness opencodeAdapter 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 opencodePerintah verify memastikan bahwa:
- Konfigurasi native ada di jalur yang diharapkan.
- Setiap target terkelola ada; berkas terkelola tidak kosong, dan konfigurasi
JSON atau YAML dapat diurai. Tambahkan
--profile PATHuntuk juga memastikan bahwa berkas yang terpasang cocok dengan profil tersebut. - Rutin verifikasi khusus adapter melaporkan keberhasilan.
Pembaruan
apothem update --harness opencodeMenyegarkan opencode.json, command native, skill, definisi helper, dan pohon
pendukung Apothem.
Pencopotan
apothem uninstall --harness opencodeMenghapus 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
| Gejala | Perbaikan |
|---|---|
| Berkas konfigurasi tidak ditemukan | Jalankan ulang apothem install --harness opencode |
| Verifikasi gagal | Jalankan apothem update --harness opencode, lalu verifikasi lagi |
| Konten konfigurasi tidak terduga | Periksa ~/.config/apothem/profile.yaml atau --profile PATH, lalu jalankan ulang apothem update --harness opencode |
Tombol konfigurasi
| Flag | Default | Deskripsi |
|---|---|---|
--dry-run | false | Pratinjau instalasi tanpa menulis berkas. |
Lihat juga
- Semua harness — katalog lengkap alat yang didukung
- Panduan instalasi — pasang Apothem ke dalam harness ini
- Referensi
apothem harnesses— mencantumkan dan memeriksa adapter dari CLI