Extension

Extension adalah paket kode yang berjalan di prosesnya sendiri di latar belakang. Di 0.1.41, Extension mendaftarkan Connector: bagian yang mengirim dan menerima pesan antara kanal luar dan Gateway Cowork. Dengan izin browser, Extension juga bisa membaca dan bekerja di halaman situs web yang disebutkannya.

Cara mengaktifkannya

1. Taruh paket di <folder utama Cowork>/extensions/packages/<name>/, atau pakai Instal dari folder di Pengaturan › Ekstensi untuk menyalin sebuah folder ke sana.
2. Pengaturan › Ekstensi menampilkannya sebagai menunggu persetujuan. Belum ada yang berjalan.
3. Anda menyetujui dan menyalakannya. Cowork menjalankan prosesnya dan memanggil fungsi activate.
4. Jika ada file di folder itu yang berubah, Extension menunggu persetujuan lagi.

Isi paket

File atau folder	Isinya
package.json	name, yang harus sama dengan nama folder (huruf kecil, angka, dan tanda hubung); version; description; pi.extensions, yang berisi tepat satu file entri; dan bagian Cowork, yang mendeklarasikan connectors, capabilities, origins, dan platforms
File entri, misalnya index.mjs	Mengekspor activate(api), yang memanggil api.registerConnector(...) untuk setiap Connector yang dideklarasikan
<folder utama Cowork>/extensions/logs/<name>.log	Log yang ditulis Extension; file ini ditulis oleh Cowork
<folder utama Cowork>/extensions/data/<name>/	Folder data milik Extension; prosesnya berjalan di folder ini

Yang bisa dideklarasikan

Item	Arti
connectors	ID Connector yang didaftarkannya. Mendaftarkan ID yang tidak tercantum akan ditolak
capabilities	browser untuk bekerja di halaman web; audio (perlu browser) untuk menangkap suara halaman; platform-gate-v1 untuk memakai platforms
origins	Wajib jika ada browser: situs web persis yang boleh dipakai, 1 sampai 20, misalnya https://example.com
platforms	Komputer yang didukung: darwin-arm64, darwin-x64, win32-x64

Connector

Sebuah Connector punya id dan tiga fungsi. start(ctx) menjalankannya: buka koneksi dan timer di sini, bukan di activate; batasnya 5 detik. stop() harus aman dipanggil lebih dari sekali; batasnya 5 detik. send(reply) mengirim satu balasan ke kanal; batasnya 30 detik. Lewat ctx, Connector menyerahkan pesan masuk ke Cowork (ctx.emit), menulis log (ctx.log), dan, dengan izin browser, memakai ctx.browser.

Batasan

• Hanya Anda yang bisa menyetujui Extension. AI tidak bisa.
• Persetujuan hanya berlaku untuk file yang Anda setujui. Mengubah satu byte berarti harus disetujui lagi.
• Satu paket paling banyak 200 file dan 5 MB. Paket dari npm dan dependencies tidak dipasang.
• Jika prosesnya berhenti karena error, Cowork menjalankannya lagi setelah jeda singkat.
• Di 0.1.41 Extension belum bisa menambahkan alat atau perintah untuk AI. Untuk memberi AI cara kerja baru, tulis Skill.

Terkait

• Ekstensi Memasang, menyetujui, dan menyalakan Extension
• Gateway: Pesan dari Luar Ke mana pesan Connector pergi
• Injection Skrip yang dijalankan Extension di halaman web