Qwen Code
Adapter harness Apothem untuk Qwen Code (Beta).
Vendor: Alibaba Cloud
Nama instalasi: qwen-code
Status: Beta
Konfigurasi native: ~/.qwen/
Instalasi
apothem install --harness qwen-codeAdapter menulis pengaturan Qwen Code, memasang jangkar konteks QWEN.md,
mendaftarkan dispatcher hook Apothem, mengonversi command Apothem menjadi berkas
command Markdown Qwen, memasang skill sebagai direktori SKILL.md, dan
mengadaptasi definisi helper sebagai subagen Qwen.
Berkas yang ditulis:
~/.qwen/settings.json
~/.qwen/QWEN.md
~/.qwen/apothem/rules/00-apothem-profile.md
~/.qwen/commands/
~/.qwen/skills/
~/.qwen/agents/
~/.qwen/.apothem/support/{rules,templates,hooks}/Berkas ~/.qwen/apothem/rules/00-apothem-profile.md adalah dokumen profil.
Berkas ini membawa identitas dan preferensi Anda dari profil bersama.
Pemetaan profil ke konfigurasi native
Adapter merender kunci settings.json yang terdokumentasi untuk konteks dan
hook, menulis QWEN.md, serta menjalin command, skill, dan definisi helper
Apothem melalui direktori penemuan native Qwen Code. Aturan, templat, dan materi
sumber hook tetap menjadi materi pendukung di bawah ~/.qwen/.apothem/support/.
Catatan kompatibilitas
~/.qwen/.apothem/support/ adalah materi pendukung yang dirujuk oleh QWEN.md
dan command hook pada pengaturan; ini bukan namespace penemuan milik vendor.
Blok Apothem di QWEN.md diakhiri dengan bagian berkas pendukung Apothem yang
menyebutkan direktori absolut di bawah ~/.qwen/.apothem/support/ yang menjadi
acuan resolusi setiap sitasi bergaya repositori (rules/<name>.md,
templates/..., hooks/...).
Daftar alat skill. Qwen Code membaca daftar-izin alat sebuah skill dari
kunci frontmatter camelCase allowedTools, dan nilainya harus berupa list YAML.
Alat ini mengabaikan kunci allowed-tools bertanda hubung yang ditulis untuk
agen lain. Karena itu, skill yang terpasang membawa allowedTools sebagai list,
satu entri per baris, menggantikan string allowed-tools yang dipisahkan koma
dari korpus sumber. Setiap entri mempertahankan ejaan sumbernya, termasuk pola
seperti Bash(git status *). Setiap kunci skill lainnya, dan isi skill,
terpasang tanpa perubahan.
Folder skill. Adapter menulis skill ke ~/.qwen/skills/. Qwen Code juga
membaca ~/.agents/skills/ dan, di dalam proyek, .qwen/skills/ dan
.agents/skills/. Ketika dua folder memuat skill dengan nama yang sama, yang
berada di bawah .qwen yang menang, sehingga skill Apothem di ~/.qwen/skills/
lebih diutamakan daripada skill bernama sama yang ditulis adapter lain ke
~/.agents/skills/.
Event hook. Adapter menyambungkan SessionStart, PreToolUse, PreCompact,
PostCompact, dan Stop. Qwen Code mendefinisikan 22 event hook dan
masing-masing dari kelima event ini termasuk di antaranya. Tiga dari 22 event
tersebut (SessionDelete, TodoCreated, dan TodoCompleted) tidak memiliki
event Claude Code dengan nama yang sama (Claude Code menamai event todo
TaskCreated dan TaskCompleted); adapter tidak menyambungkan satu pun dari
ketiganya.
Verifikasi
apothem verify --harness qwen-codePerintah 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 qwen-codeMenyegarkan settings.json, QWEN.md, command native, skill, subagen, dan
pohon pendukung Apothem.
Pencopotan
apothem uninstall --harness qwen-codeMenghapus entri yang ditambahkan adapter ke ~/.qwen/settings.json (kunci Anda
sendiri, server MCP, dan handler hook tetap ada, dan berkas itu dihapus hanya
ketika Apothem yang membuatnya dan tidak ada lagi yang tersisa milik Anda).
Menghapus blok Apothem dari ~/.qwen/QWEN.md dan dari dokumen profil
~/.qwen/apothem/rules/00-apothem-profile.md dan mempertahankan teks lain di
dalamnya; setiap berkas dihapus hanya ketika tidak ada lagi yang tersisa di
dalamnya. Juga menghapus berkas Apothem di ~/.qwen/commands/,
~/.qwen/skills/, ~/.qwen/agents/, dan ~/.qwen/.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 qwen-code |
| Verifikasi gagal | Jalankan apothem update --harness qwen-code, lalu verifikasi lagi |
| Konten konfigurasi tidak terduga | Periksa ~/.config/apothem/profile.yaml atau --profile PATH, lalu jalankan ulang apothem update --harness qwen-code |
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