Rujukan teknikal CanAI
Templat, set alat MCP dan hooks, untuk pembina yang mahukan senarai lengkap. Pemalam ini percuma dan anda menggunakan ejen sendiri.
Apa yang dibina CanAI
Halaman dijana sebagai HTML semantik berasaskan templat Twig, tanpa kod pendek (shortcode) atau markup pembina halaman yang bersarang. Gaya menggunakan Tailwind dan interaktiviti ringan menggunakan Alpine.js, manakala ikon Lucide sedia digunakan sebaik sahaja dipasang.
- CSS yang dikompil dan disimpan dalam cache. Output Tailwind dibina dan disimpan dalam cache bagi setiap halaman, jadi ia tidak dikompil pada setiap permintaan.
- Penyunting dalam wp-admin. HTML, CSS dan JS dengan pratonton, untuk melaras secara manual apa yang ditulis oleh ejen. "Edit with WPCanAI" terletak pada bar pentadbir di mana-mana halaman bahagian hadapan.
Templat dan susun atur
Susun atur, pengepala, pengaki dan komponen ialah objek templat yang disusun mengikut taksonomi, jadi tiada apa-apa yang disalin dari satu halaman ke halaman lain.
- Delegasi susun atur. Sesebuah halaman boleh menyerahkan bingkai luarnya kepada susun atur yang dikongsi, jadi perubahan pada pengepala atau pengaki sampai ke setiap halaman yang berbuat demikian.
- Arkib dan halaman khas. Templat untuk kategori, tag, pengarang, carian serta 404, selain kiriman tunggal dan halaman.
- WooCommerce. Slot untuk halaman kedai, produk tunggal, kategori produk, gelung produk, troli, daftar keluar dan Akaun Saya, termasuk pesanan, order-pay, muat turun, alamat serta kaedah pembayaran.
Set alat MCP
Ejen mendapat lebih daripada 35 operasi yang mencerminkan skrin wp-admin (61 pada laman web yang alat berbilang bahasanya diaktifkan), jadi ejen dan wp-admin ialah dua pintu masuk ke ciri yang sama. Antaranya, mengikut tugas:
| Alat | Fungsi |
|---|---|
wpcanai-list-pages | Menyenaraikan halaman CanAI berserta format, susun atur dan saiznya. |
wpcanai-create-page | Mencipta halaman CanAI dengan slug, tajuk dan susun atur. |
wpcanai-read-meta | Membaca HTML, CSS, JS, susun atur dan konteks sesebuah halaman atau templat. |
wpcanai-write-meta | Mengkompil dan menyimpan markup Twig, Tailwind serta Alpine dalam satu langkah. |
wpcanai-replace-in-meta | Mencari dan menggantikan teks dalam halaman tanpa menghantar semula keseluruhan fail. |
wpcanai-create-template | Mendaftarkan bahagian templat (partial) yang boleh diguna semula atau susun atur seluruh laman web. |
wpcanai-sideload-url | Menarik imej dari URL ke dalam pustaka media. |
wpcanai-write-menu | Membina dan menyusun semula menu navigasi. |
wpcanai-read-settings | Membaca tema, persediaan Tailwind dan keutamaan laman web. |
wpcanai-purge-cache | Mengosongkan cache halaman dan cache edge. |
wpcanai-diagnostics | Menyemak pemasangan dan melaporkan masalah. |
wpcanai-export | Mengeksport setiap halaman dan templat CanAI, untuk pengklonan atau sandaran. |
Sejarah versi
Setiap perubahan yang dibuat oleh ejen direkodkan. Anda boleh menyenaraikan snapshot (salinan halaman pada satu masa) serta operasi lepas, memeriksa snapshot, memulihkan keseluruhan snapshot atau satu operasi, dan menyemat titik selamat sebelum perubahan besar supaya anda boleh kembali ke situ.
Pin the current state with CanAI, then redesign the home page hero. If I don't like it, restore the pinned snapshot.
Laman web berbilang bahasa
Apabila lapisan terjemahan aktif, ejen boleh membaca dan menulis tetapan setiap bahasa, terjemahan, rentetan global, pemetaan media serta gantian bagi kiriman atau istilah.
Hooks
Bahagian berikut ialah penapis (filter), jadi pembangun boleh mengubahnya:
- jenis templat yang wujud di laman web;
- hooks WooCommerce yang tersedia di dalam templat;
- pilihan WordPress yang boleh dibaca atau ditulis oleh ejen;
- cara data konteks halaman yang dihantar ke dalam templat dihimpunkan.
Sambungan dan akses
Ejen bersambung ke titik akhir CanAI di laman web anda melalui pengangkutan HTTP MCP. Pautan sambungan mengandungi kunci peribadi, yang bertindak sebagai bukti kelayakan:
https://your-site.com/wp-json/mcp/wpcanai/your-private-key
Sesiapa yang memiliki pautan ini mendapat akses penuh yang sama seperti ejen, jadi jangan letakkan pautan itu dalam fail atau repositori yang dikongsi. Pilihan yang boleh diakses oleh ejen dihadkan oleh senarai dibenarkan (allowlist) dalam CanAI → AI Client → Guardrails.
Keperluan
- WordPress 7.0 atau lebih baharu dan PHP 8.2 atau lebih baharu.
- Akaun pentadbir di laman web itu.
- Ejen AI yang boleh bersambung ke MCP server jarak jauh melalui HTTP, seperti Claude Code atau Cursor.
- WooCommerce, hanya jika anda mahukan templat kedai.