QuickAgent - Panduan

Panduan Pengguna QuickAgent

QuickAgent ialah ruang kerja ejen AI berasaskan setempat. Ia menukar matlamat kepada Run yang tahan lama, mengehadkan Run itu dengan Workspace Profile, meminta semakan sebelum tindakan sensitif dan menyimpan hasil yang disahkan dalam Artifacts.

Bermula

Buka Settings > AI, tambahkan penyedia dan jalankan ujian sambungannya.
Buka Settings > Workspace Profiles. Pilih penyedia, alatan, sambungan, punca fail, sumber Knowledge dan skop Memory yang boleh digunakan.
Pilih New Chat, pilih profil dan sahkan destinasi penyedia yang dipaparkan di atas perbualan.
Huraikan hasil yang diingini. Tambahkan hanya fail, folder, media, Knowledge atau Memory yang diperlukan untuk Run ini.
Semak pelan, kelulusan, pengesahan Critical dan Data Send Preview apabila ia muncul.
Jejak kerja dalam Timeline. Buka output yang siap daripada Artifacts dan periksa jejak audit dalam Sejarah.

Petua: Mulakan dengan Workspace Profile yang sempit. Luaskan alat atau puncanya hanya apabila QuickAgent memaparkan sebab khusus bahawa ia tidak tersedia.

Gambaran Keseluruhan Antara Muka

Bahagian	Tujuannya
Chats	Perbualan, destinasi penyedia, Context Tray, pelan, kelulusan dan Timeline Run aktif.
Runs	Setiap tugas yang dirancang, sedang berjalan, dijeda, dijadualkan, gagal atau selesai.
Approval Inbox	Semakan tindakan, Critical dan Data Send yang belum selesai dan memerlukan keputusan anda.
Artifacts	Fail, laporan, log, media, jadual dan manifes operasi yang disahkan, yang dicipta oleh Runs.
Automations	Jadual, pemantau, webhook, peristiwa aplikasi dan pencetus Shortcut/App Intent.
Skills	Arahan boleh guna semula dengan input ditaip, alatan dibenarkan, sambungan diperlukan, risiko dan output.
Connections	Penyedia, profil pelayar, punca fail/VFS, SSH, MCP, HTTP/SaaS, jambatan rumah dan saluran pemberitahuan.
Knowledge	Folder diindeks, kandungan QuickNote, klip web, PDF dan sumber Office.
Sejarah	Keputusan keselamatan, tindakan alat, destinasi dan cap masa yang hanya boleh ditambah.
Tetapan	Penampilan, bahasa, AI, alatan, keselamatan, Workspace Profiles, pintasan, kebenaran, Help dan Pro.

Providers dan Workspace Profiles

QuickAgent boleh menggunakan System AI apabila sistem pengendalian mendedahkan keupayaan yang serasi, penyedia setempat seperti Ollama, LM Studio atau DeskLLM, titik akhir serasi OpenAI pada LAN atau tersuai, serta penyedia awan yang dikonfigurasi seperti Anthropic atau Gemini. Ketersediaan ditentukan oleh ujian keupayaan langsung; nama penyedia sahaja tidak bermakna ia sedia.

Workspace Profile ialah sempadan kebenaran Run. Ia merakam syot penyedia/model yang dipilih, alatan dibenarkan, sambungan, punca fail, sumber Knowledge, skop Memory, penggantian keselamatan dan belanjawan. Perubahan konfigurasi kemudian menjadikan syot itu lapuk dan memerlukan semakan.

Peraturan destinasi: QuickAgent tidak pernah bertukar secara senyap daripada penyedia pada peranti atau setempat ke awan. Destinasi aktif kekal kelihatan dalam Chat dan dalam setiap semakan Data Send.

Runs, Approvals dan Recovery

Kawalan Run

Pause meminta hentian kerjasama pada titik semak yang tahan lama.
Resume meneruskan Run yang sama dan kerja yang telah selesai.
Henti membatalkan kerja penyedia dan alat. Kesan luaran yang dihentikan atau tidak pasti tidak dilaporkan sebagai berjaya.
Retry hanya tersedia apabila QuickAgent dapat mengenal pasti sempadan cuba semula yang selamat.

Tahap keselamatan

Tahap	Maksud
Safe	Baca, periksa atau transformasi dalam profil aktif.
Approve	Semak tindakan tulis atau luaran biasa.
Sahkan	Semak perubahan yang berimpak lebih tinggi atau lebih sukar dipulihkan.
Critical	Pengesahan kukuh setiap kali; peraturan tidak pernah meluluskannya secara automatik.

Kelulusan memaparkan sasaran, destinasi, argumen dicadangkan, risiko dan status Undo yang tepat. Jika anda menyunting argumen, QuickAgent mengesahkan dan menyemak risiko tindakan yang disunting sekali lagi.

Hasil tidak pasti: selepas gangguan, periksa sistem sasaran dahulu. Pilih “I checked — retry” hanya apabila pengulangan tindakan sesuai. “Resume” sahaja tidak pernah mengulangi kesan luaran yang tidak pasti.

Runs Berbilang Ejen

Matlamat kompleks boleh menggunakan perancang, pekerja pakar ditaip, penyemak dan penyemak keselamatan. Timeline menunjukkan setiap serahan, semakan, cuba semula, sandaran dan sempadan respons akhir. Pekerja hanya menerima persilangan empat hala antara alatan Skill, alatan Workspace Profile, alatan peranan dan alatan yang sedang aktif.

Belanjawan global dan setiap peranan mengehadkan panggilan, masa, kos, bait rangkaian dan token. Apabila belanjawan dicapai, QuickAgent dijeda. Ia memaparkan had semasa dan yang dicadangkan, lalu meningkatkannya hanya selepas semakan jelas. Belanjawan yang diluluskan dan sejarah peranan yang selesai kekal selepas mula semula.

Context, Knowledge dan AI Memory

Context Tray

Tambahkan fail, folder, imej, bingkai video, audio, nota suara, kandungan QuickNote, Knowledge atau Workspace Memory. QuickAgent mengekstrak atau meringkaskan kandungan yang disokong dan menunjukkan sama ada lampiran akan dihantar terus kepada penyedia.

Knowledge

Sumber Knowledge diindeks secara berasingan daripada chat. Run hanya boleh mencari sumber yang dibenarkan oleh Workspace Profile, dan petikan mengekalkan identiti sumbernya.

Memory

Memory disengajakan, bukan sejarah chat automatik. Skop User, Workspace, Project dan Tool/Connection adalah berasingan. Setiap permintaan cipta, sunting atau padam menerima kelulusan baharu, dan pratonton kelulusan menunjukkan skop serta nilai tepat yang dicadangkan.

Tools dan Connections

Katalog langsung meliputi operasi fail/VFS; Office, PDF dan data berstruktur; media dan OCR; pelayar serta penggunaan komputer; arahan pembangunan; SSH; MCP; HTTP dan SaaS; jambatan rumah pintar; pemberitahuan; jadual; pemantau; dan kawalan automasi. Pelayan MCP yang disambungkan boleh menambah alatan dinamik selepas pengesahan skema dan penilaian semula risiko QuickAgent.

Settings > Tools menunjukkan sebab sesuatu alat sedia atau dinyahdayakan. Sebab biasa ialah sambungan tiada, kebenaran sistem pengendalian, platform tidak disokong, sekatan Workspace Profile, titik akhir belum diuji atau keupayaan penyedia tidak tersedia.

Penggunaan komputer: tangkapan skrin dan kawalan kebolehcapaian/input ialah kebenaran berasingan. Kekalkan pratonton yang kelihatan dan Stop kecemasan tersedia. Platform mudah alih tidak menyediakan kawalan desktop tanpa sekatan yang sama.

Automations

Automations boleh bermula daripada pencetus masa, fail/folder, web, webhook, e-mel, kalendar, rangkaian, hos, peranti, penderia, lokasi, peristiwa aplikasi, Shortcut/App Intent, arahan atau manual apabila platform menyokongnya. Pencetus mencipta Run biasa; ia tidak memintas semakan Workspace Profile, approval, Critical atau Data Send.

Pemantauan desktop berterusan hanya semasa proses aplikasi berjalan.
Platform mudah alih memulihkan kerja tertunggak apabila aplikasi kembali ke latar depan.
Gunakan Shortcut/App Intent atau geganti peristiwa yang dipercayai apabila penghantaran sistem pengendalian diperlukan.
Peristiwa berbaris, jeda, batal dan pemadaman kekal jelas supaya peristiwa tidak dibuang secara senyap.

Skills dan Skill Packs

Skill menyimpan gesaan berfokus hasil, pemboleh ubah ditaip, cadangan penyedia, alatan dibenarkan, sambungan serta keupayaan diperlukan, risiko maksimum dan Artifacts yang dijangka. Sebelum digunakan, QuickAgent memaparkan input dan kebenaran berkesan; pratonton itu sendiri tidak memberikan kebenaran.

Tujuh Packs terbina dalam menyediakan Skills sebenar untuk Office, Coding, Smart Home, Research, Browser Automation, Personal Admin dan Incident Response. Anda boleh memasang, mengemas kini, menyahpasang, menyesuaikan, menduplikasi, mengimport dan mengeksport Skills. JSON yang diimport menerima pratonton kepercayaan, penerbit, tandatangan, kebenaran, risiko, platform dan konflik. “Keep both” mencipta terbitan setempat tanpa tandatangan dan bukannya mewarisi kepercayaan penerbit lain.

Artifacts, History dan Undo

Artifacts menyimpan bait output, metadata, versi, asal usul, Run sumber dan manifes operasi. Bergantung pada keupayaan platform, anda boleh membukanya, berkongsinya, mengeksportnya atau mendedahkannya. Operasi yang layak menawarkan Undo yang disemak; kerja yang memusnahkan atau tidak pasti tidak pernah dimainkan semula secara automatik.

History hanya boleh ditambah. Tapis mengikut Safe, Approve, Confirm atau Critical, dan eksport audit apabila anda memerlukan rekod luaran.

Tetapan

Umum: penampilan, bahasa, Workspace Profiles, pintasan, Help dan kebenaran.
AI: penyedia, titik akhir, model, kelayakan dan ujian langsung.
Tools: kesediaan katalog, sokongan platform dan sebab persediaan.
Safety: peraturan kelulusan, tingkah laku Data Send, pengesahan peranti dan dasar Memory berskop.
Advanced: pemulihan dan diagnostik yang ditujukan untuk penyelesaian masalah.

Pintasan Papan Kekunci

Pada macOS, aplikasi memetakan pintasan Ctrl kepada kekunci Command platform apabila sesuai. Halaman Shortcuts dalam aplikasi adalah berkuasa dan menyokong penyesuaian.

Pintasan	Tindakan
`Ctrl` + `N`	New Chat
`Ctrl` + `L`	Fokus pada penyusun mesej
`Ctrl` + `Shift` + `Space`	Jeda atau sambung semula Run aktif
`Ctrl` + `.`	Hentikan Run aktif
`Ctrl` + `1` … `9`	Buka Chats melalui History
`Ctrl` + `,`	Buka Settings
`F1`	Buka Help & Privacy
`Esc`	Tutup dialog atau batalkan interaksi semasa yang tidak memusnahkan

Nota Platform

Platform	Sempadan penting
macOS	Dalam sandbox pada Debug dan Release. Akses fail menggunakan punca terpilih/penanda buku berskop keselamatan. Screen Recording dan Accessibility ialah kebenaran sistem berasingan. Integrasi proses setempat dan Shortcut kekal diuji keupayaannya.
Windows	Ciri fail, Office/PDF/data, pelayar, pembangunan, jauh dan kawalan desktop bergantung pada masa jalan serta kebenaran yang dipasang. Integrasi khusus Apple tidak tersedia dengan sebab yang kelihatan.
iPhone / iPad	Fail menggunakan pemilih sistem. Kamera, mikrofon, pertuturan, foto, rangkaian setempat dan pemberitahuan diminta mengikut konteks. Pemantauan latar belakang tidak dijamin; gunakan Shortcuts/App Intents atau susulan latar depan.
Android	Fail dan folder menggunakan Storage Access Framework. Kerja latar belakang mengikut sekatan Android. Kawalan input berasaskan Accessibility tidak pernah dianggap telah diberikan hanya kerana perkhidmatan diisytiharkan.
Web	Menggunakan storan sesi sahaja untuk ciri yang memerlukan ketekalan asli dan menyahdayakan dengan jelas keupayaan peranti, punca fail, proses setempat dan latar belakang yang tidak disokong.

Petua & Helah

Mulakan dengan Workspace Profile yang sempit dan tambahkan alat, sambungan atau punca fail hanya apabila Run menunjukkan keperluan khusus.

Berikan setiap permintaan hasil yang jelas, Artifact yang dijangka dan sempadan semakan supaya kemajuan mudah diaudit.

Gunakan Knowledge untuk sumber terindeks yang boleh guna semula dan Context untuk bahan yang diperlukan hanya oleh Run semasa.

Apabila kesan luaran tidak pasti, periksa destinasi sebelum mencuba semula; Resume tidak pernah mengulanginya secara automatik.

Penyelesaian Masalah

Masalah	Perkara untuk disemak
Penyedia tidak dapat berjalan	Buka Settings > AI. Semak konfigurasi, pengesahan, keupayaan model, kebolehcapaian titik akhir, masa tamat dan butiran had kadar, kemudian jalankan ujian sambungan.
Alat dinyahdayakan	Buka Settings > Tools dan baca sebab langsung. Semak platform, kebenaran, ujian sambungan, Workspace Profile dan punca terpilih semasa.
Run kelihatan tersekat	Buka Runs dan Timeline. Ia mungkin dijeda, menunggu input, kelulusan, pengesahan Critical, semakan Data Send atau semakan belanjawan. Stop kekal tersedia.
Kebenaran berubah	Buka Help > Overview atau Settings, kemudian buka tetapan sistem. Uji semula sambungan atau alat yang terjejas selepas kembali.
Tindakan luaran tidak pasti	Periksa sistem sasaran. Pastikan Run dijeda atau hentikannya melainkan anda telah mengesahkan bahawa mencuba semula adalah sesuai.
Satu Automation tidak berjalan di latar belakang	Sistem pengendalian mudah alih tidak menjamin peninjauan arbitrari. Kembali ke latar hadapan untuk mengejar semula atau konfigurasikan Shortcut/App Intent atau sumber peristiwa yang dipercayai.
Satu Artifact tidak dapat dibuka atau dieksport	Periksa sama ada baitnya masih tersedia, sama ada platform menyokong tindakan itu, dan sama ada kebenaran destinasi yang dipilih masih sah.

Privasi, Kebenaran dan Lesen

QuickAgent menyimpan perbualan, Runs, kelulusan, metadata Knowledge, Skills dan tetapan secara setempat. Kredensial menggunakan storan yang dilindungi platform. Kandungan hanya meninggalkan peranti melalui penyedia atau perkhidmatan tersambung yang anda konfigurasikan, dan penghantaran luaran menerima pratonton yang peka terhadap destinasi.

Kebenaran diminta mengikut konteks: fail/folder, foto, kamera, mikrofon, pengecaman pertuturan, rangkaian setempat, pemberitahuan, rakaman skrin dan kawalan kebolehcapaian/input adalah bebas antara satu sama lain. Mengalih keluar kebenaran menjadikan keupayaan terjejas tidak tersedia dan bukannya menghasilkan kejayaan palsu.

Buka Settings > Help & Privacy untuk jadual keupayaan platform semasa dan Lesen sumber terbuka untuk notis pakej dan natif terbina dalam.

Free dan Pro: semua ciri ejen kekal tersedia dalam Free. Percubaan tujuh hari adalah tanpa iklan; selepas itu, mudah alih mungkin memaparkan iklan dan desktop mungkin memaparkan peringatan harian. Pro mengalih keluar mesej tersebut melalui langganan tahunan atau pembelian seumur hidup.