Skip to content
Apothem
Adaptor harness

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-code

Adapter 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-code

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 qwen-code

Menyegarkan settings.json, QWEN.md, command native, skill, subagen, dan pohon pendukung Apothem.

Pencopotan

apothem uninstall --harness qwen-code

Menghapus 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

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

Tombol konfigurasi

FlagDefaultDeskripsi
--dry-runfalsePratinjau instalasi tanpa menulis berkas.

Lihat juga

On this page