Trae

Vendor: ByteDance Nama instalasi: trae Status: GA Konfigurasi native: <project>/.trae/rules/apothem-rules.md

InstalasiCopy Anchor Link

apothem install --harness trae --project /path/to/project

Adapter menulis satu berkas aturan Trae berlingkup proyek dari aturan dan permukaan tata kelola Apothem bersama, serta helper Apothem sebagai subagent Trae di dalam proyek (lihat Subagent).

Adapter juga menulis skill Apothem, beserta aturan dan templat yang dikutipnya, ke direktori home pengguna Anda, sebelum menyentuh proyek (lihat Berkas di luar proyek).

Berkas yang ditulis:

• <project>/.trae/rules/apothem-rules.md, berkas aturan.
• <project>/.trae/agents/<name>.md untuk setiap helper Apothem, di dalam proyek.
• ~/.trae/skills/<name>/SKILL.md untuk setiap skill dan command Apothem, di direktori home pengguna Anda.
• ~/.config/apothem/rules/ dan ~/.config/apothem/templates/, di direktori home pengguna Anda.

Berkas di luar proyekCopy Anchor Link

Instalasi juga menulis skill Apothem ke direktori home pengguna Anda, sebelum mengubah apa pun di dalam proyek:

Folder-folder ini dipakai bersama. Folder ini tidak privat bagi proyek:

• Setiap proyek tempat Anda memasang trae memakai salinan ~/.trae/skills/ yang sama, dan instalasi menulis berkas yang sama ke dalamnya setiap kali. Trae adalah satu-satunya alat yang membaca folder itu. Aturan dan templat di bawah ~/.config/apothem/ juga ditulis oleh instalasi alat-alat lain, dengan berkas yang sama.
• --project memilih berkas aturan yang ditulis dan proyek tempat instalasi itu berada. Opsi ini tidak mengubah ke mana skill ditulis.
• Instalasi tidak menambahkan berkas skill atau aturan ke repositori Anda. Proyek mendapatkan berkas aturan dan berkas subagent di .trae/agents/, ditambah folder data .apothem/ yang dibuat oleh setiap instalasi proyek.
• Folder home ditulis lebih dulu. Jika itu gagal, misalnya karena sebuah folder di jalur tersebut adalah tautan yang keluar dari direktori home Anda (tautan yang tetap berada di dalamnya diikuti) atau tidak dapat ditulisi, instalasi berhenti dengan galat sebelum apa pun di dalam proyek berubah.
• Folder skill dengan nama skill Apothem yang tidak ditulis oleh Apothem dibiarkan, dan instalasi mencetak peringatan yang menyebutkan namanya. Ganti nama atau pindahkan folder itu, lalu jalankan apothem update. apothem verify gagal selama nama itu masih terpakai.
• Total ukuran berkas-berkas tersebut beberapa megabita.

Instalasi mencetak catatan yang menyebutkan folder yang ditulisnya di luar --project, dan --dry-run mencantumkannya.

SubagentCopy Anchor Link

Trae membaca subagent dari berkas Markdown di <project>/.trae/agents/, menurut dokumentasi subagent Trae. Instalasi menulis satu berkas per helper Apothem ke folder tersebut. Instalasi ini hanya untuk proyek: dokumentasi menyebut folder tingkat pengguna sebagai ~/.trae-cn/agents/ sementara setiap folder pengguna Trae lainnya berada di bawah ~/.trae/, dan Apothem belum memastikan folder mana yang dibaca oleh instalasi internasional, sehingga Apothem tidak menulis keduanya.

Setiap berkas mempertahankan instruksi helper tanpa perubahan dan membawa kunci frontmatter berikut:

Hanya nama alat yang ada di halaman subagent Trae yang ditulis:

Bash, Edit, Glob, Grep, Read, Skill, TodoWrite, WebFetch, WebSearch, Write, LSP

Alat yang disebut sumber tetapi tidak ada dalam daftar itu (misalnya MultiEdit atau PowerShell) dihilangkan dari kedua bidang. Alat dengan pola, seperti Bash(rm *), tidak memiliki bentuk dalam daftar berpisah koma: sebagai alat yang diizinkan, alat itu dihilangkan, dan sebagai alat yang ditolak, alat itu menolak seluruh alat. Helper yang tidak dapat menyunting berkas mempertahankan batas itu: helper tersebut tidak mencantumkan Write atau Edit di antara alatnya dan menolak keduanya. Trae tidak mendokumentasikan batas giliran, sehingga maxTurns milik helper tidak ditulis. Instalasi tidak menulis kunci model, sehingga helper memakai model yang dipilih di kotak obrolan, dan tidak menulis kunci mcpServers.

Hal yang perlu diketahui:

• Dokumentasi Trae berbahasa Inggris meminta Anda menyalakan Settings > Beta > Subagents > Enable Subagents Directory sebelum Trae memuat .trae/agents/. Halaman berbahasa Mandarinnya, yang diperbarui kemudian, menyatakan fitur ini biasanya aktif secara default. Jika Trae tidak mencantumkan satu pun helper, periksa sakelar tersebut.
• Berkas subagent adalah berkas proyek biasa. Commit berkas itu bersama proyek atau cantumkan .trae/agents/ di .gitignore; Apothem tidak memilihkannya untuk Anda.
• Berkas milik Anda dengan nama helper Apothem disimpan di bawah ~/.apothem/backups/ lalu diganti. Pencopotan tidak mengembalikannya. Berkas dengan nama lain tidak pernah disentuh.
• Dokumentasi Trae tidak menyebutkan bagaimana Trae memperlakukan kunci frontmatter yang tidak dicantumkannya, atau apakah .trae/agents/ berlaku di jendela kedua dari "all-new TRAE" yang digabungkan sebagaimana berlaku di jendela IDE.

Pemetaan profil ke konfigurasi nativeCopy Anchor Link

Adapter membaca profil bersama Apothem dan merender berkas aturan proyek pada setiap kali apothem install atau apothem update dijalankan. Profil bersama adalah sumber kebenaran; suntingan lokal-proyek pada berkas yang dihasilkan dicadangkan sebelum sinkronisasi berikutnya mengganti konten yang dikelola Apothem.

Berkas dibuka dengan frontmatter YAML yang menetapkan alwaysApply: true dan sebuah description, yang merupakan mode Always Apply Trae menurut dokumentasi aturan Trae. Blok yang dikelola Apothem mengikutinya; teks yang Anda tambahkan setelah blok tersebut dipertahankan pada setiap sinkronisasi.

Catatan kompatibilitasCopy Anchor Link

Permukaan aturan Trae saat ini berlingkup proyek di bawah .trae/rules/; aturan global berada di bawah ~/.trae/user_rules. Adapter menulis berkas apothem-rules.md khusus dan tidak pernah menimpa berkas aturan lain di direktori tersebut maupun aturan global Anda. Permukaan server alat .trae/mcp.json dan permukaan skill .trae/skills/ proyek dimiliki operator; Apothem tidak menulisnya.

Trae mendokumentasikan ~/.trae/skills/ untuk skill global. Trae membaca folder lintas alat .agents/skills/ hanya setelah pengaturan Enable .agents Skills Directory dinyalakan, sehingga instalasi menulis folder Trae. Edisi Tiongkok (TRAE CN) mendokumentasikan ~/.trae-cn/skills/ sebagai gantinya; changelog-nya menyatakan direktori skill global TRAE CN dan edisi internasional kompatibel, hanya untuk edisi personal. Instalasi hanya menulis ~/.trae/skills/, dan Apothem belum memastikan apakah edisi TRAE CN lainnya membacanya. Apothem juga belum memastikan bagaimana Trae memperlakukan kunci header SKILL.md yang tidak dicantumkannya.

VerifikasiCopy Anchor Link

apothem verify --harness trae --project /path/to/project

Perintah verify memastikan bahwa:

1. Konfigurasi native ada di jalur yang diharapkan.
2. Setiap target terkelola ada, termasuk folder .trae/agents/; 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. Untuk .trae/agents/, yang diperiksa adalah keberadaan folder tersebut, bukan keberadaan setiap berkas helper di dalamnya; perintah apothem diff --harness trae --project /path/to/project mencantumkan berkas helper yang hilang atau usang.
3. Setiap folder skill Apothem ada di tempatnya dengan sebuah SKILL.md, instalasi mana pun yang menulisnya, dan tidak ada folder skill dengan nama Apothem yang milik sesuatu yang tidak ditulis Apothem. Pemeriksaan yang gagal menyebutkan folder yang hilang atau asing.
4. Rutin verifikasi khusus adapter melaporkan keberhasilan.

PembaruanCopy Anchor Link

apothem update --harness trae --project /path/to/project

Menurunkan ulang berkas aturan proyek dari keadaan profil bersama saat ini.

Pembaruan juga menulis ulang setiap folder skill yang berkasnya berbeda dari berkas saat ini. Jika Anda memasang dengan rilis sebelumnya yang tidak menulis skill, pembaruan menambahkannya. Pembaruan menulis ulang berkas subagent yang berbeda dari berkas saat ini, dan menambahkan yang hilang.

PencopotanCopy Anchor Link

apothem uninstall --harness trae --project /path/to/project

Menghapus blok Apothem, beserta frontmatter yang ditulis Apothem di atasnya, dari <project>/.trae/rules/apothem-rules.md dan mempertahankan teks lain di dalamnya. Berkas itu dihapus hanya ketika tidak ada lagi yang tersisa di dalamnya. Sebelum perubahan, salinan berkas bercap waktu disimpan di bawah ~/.apothem/backups/; tidak ada berkas cadangan yang tertinggal di proyek. YAML profil bersama dan mesin Apothem tidak terpengaruh.

Pencopotan juga menghapus berkas subagent yang ditulisnya di <project>/.trae/agents/ dan mempertahankan berkas lain di sana; folder itu dihapus ketika menjadi kosong. Pencopotan menghapus folder skill yang ditulisnya di ~/.trae/skills/ serta aturan dan templat di ~/.config/apothem/, tetapi hanya ketika tidak ada lagi instalasi Apothem lain yang memakainya. Proyek lain, atau alat lain yang berbagi folder itu, mungkin masih memakainya. Dalam kasus itu pencopotan mempertahankan folder tersebut, mencetak instalasi mana yang memakainya, dan pencopotan terakhir menghapusnya. Berkas yang Anda tambahkan ke folder tersebut tetap ada, dan folder yang menjadi kosong dihapus. Setiap folder dicadangkan di bawah ~/.apothem/backups/ sebelum dihapus.

Gerbang konformitasCopy Anchor Link

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

Pemecahan masalahCopy Anchor Link

Tombol konfigurasiCopy Anchor Link

Lihat jugaCopy Anchor Link

• Semua harness — katalog lengkap alat yang didukung
• Panduan instalasi — pasang Apothem ke dalam harness ini
• Referensi apothem harnesses — mencantumkan dan memeriksa adapter dari CLI