Lewati ke konten utama
Panduan penyiapan Studio Asisten AI saya akan menyiapkannya

Biarkan asisten AI Anda menyiapkan Studio

Asisten coding AI di komputer Anda, seperti Claude Code, Codex, atau Cursor, dapat menayangkan Studio secara online untuk Anda. Anda menempelkan petunjuk siap pakai. Asisten Anda membaca petunjuk penyiapan yang disertakan di dalam unduhan Studio, menentukan bersama Anda apakah hosting web atau akun Cloudflare yang paling cocok, dan bertanya sebelum mengubah apa pun.

Terbaik untuk
Orang yang sudah memakai asisten coding AI yang dapat menjalankan perintah di komputernya, untuk kedua jenis Studio: di hosting web atau di Cloudflare.
Yang Anda butuhkan
Maxisnap untuk Windows atau Mac, yang sudah masuk dengan akun yang memiliki Studio; asisten coding AI di komputer Anda; serta login hosting Anda atau akun Cloudflare.
Waktu
Sebagian besar ditangani asisten: Anda menjawab pertanyaan asisten dan menyetujui setiap perubahan.
Yang Anda dapatkan
Studio yang sama seperti pada opsi penyiapan lainnya, di hosting web Anda atau di akun Cloudflare Anda sendiri.

Yang diikuti asisten Anda

Setiap unduhan Studio berisi petunjuk yang ditulis untuk asisten AI. Petunjuk itu menjelaskan kedua edisi Studio, langkah pemasangan yang tepat, apa yang harus tetap privat, dan cara memeriksa hasilnya. Petunjuk itu juga meminta asisten Anda untuk:

  • Bertanya kepada Anda sebelum setiap unggahan, deployment, atau perubahan pada server atau akun, dan menyebutkan dengan tepat apa yang akan diubahnya.
  • Tidak pernah menghapus, menimpa, atau mengganti nama apa pun yang sudah ada: file situs web, record DNS, Worker, bucket, atau database. Studio hanya menambahkan hal baru.
  • Menjaga kunci dan kata sandi tetap di luar file yang dibuatnya.
  • Memberi Anda alamat Studio dan kunci Admin di akhir, agar Anda dapat menghubungkan Maxisnap.

Dapatkan Studio di komputer Anda

  • Di Windows: di Maxisnap, buka Pengaturan → Akun → Wizard penyiapan Maxisnap Studio, klik “Mulai”, lalu “Unduh dasbor”. Maxisnap menyimpan ZIP Studio ke folder Unduhan Anda dan membuka folder tersebut.
  • Di Mac: di Maxisnap, buka Settings → Welcome & Help → Studio Setup Guide, klik “Get Started”, lalu “Download Dashboard”. Maxisnap menyimpan ZIP Studio ke folder Unduhan Anda.

Ekstrak file ZIP. Di Windows, klik kanan file tersebut dan pilih “Ekstrak Semua”. Di Mac, klik dua kali file tersebut.

Salin lokasi folder yang sudah diekstrak; Anda akan menempelkannya di langkah 3. Di Windows, klik kanan folder tersebut dan pilih “Salin sebagai jalur”. Di Mac, pilih folder tersebut lalu tekan Option+Command+C.

File petunjuk untuk asisten AI ada di folder itu:

AGENTS.md

Yang akan Anda lihat Folder Studio yang sudah diekstrak: tiga folder (cloudflare, docs, dan snaps), halaman Start Here, dan petunjuk untuk asisten AI.

Kunci branding Anda, jika Anda mau

Klik dua kali “Maxisnap Studio - Start Here.html”, rancang logo, warna, dan font Anda, lalu klik “Lock in my branding”. Asisten Anda akan memakainya. Anda juga dapat melewati langkah ini dan mengubah branding nanti di dasbor Anda, di bagian Branding.

Salin petunjuk

Salin petunjuk ini, ganti baris dalam tanda kurung sudut dengan folder Studio Anda, lalu tempelkan ke asisten Anda.

Set up Maxisnap Studio for me.

Maxisnap Studio is a self-hosted dashboard for the screenshots and screen recordings the Maxisnap desktop app uploads: a private library plus branded share links. It comes in two editions with the same features: a PHP app for ordinary web hosting, and a Cloudflare Worker that uses R2 and D1.

Everything is in this folder on my computer:
  <the folder where I extracted the Studio download>

Start by reading AGENTS.md in that folder. It explains both editions, the exact install steps, what must stay private, and how to check the result.
If I locked in my branding, it is in snaps.zip; AGENTS.md says what to do if it is missing.

Goal: Work out with me whether the PHP edition (my web hosting) or the Cloudflare Workers edition fits my setup, then install it.

Rules:
- Ask me before you upload, deploy, or change anything on a server or in an account, and tell me exactly what you will change.
- Never delete, overwrite or rename existing website files, DNS records, Workers, buckets or databases. Studio only adds new things.
- Keep keys and passwords out of files you create and out of chat transcripts where you can.
- When it works, give me the Studio address and the Admin key so I can connect the Maxisnap app (on Windows, Settings, Account, Maxisnap Studio setup wizard, step 4; on a Mac, Settings, Welcome & Help, Studio Setup Guide, “I already have a dashboard”).

Jawab pertanyaan asisten Anda

  1. Beri tahu asisten di mana situs web Anda berada: di hosting web (cPanel, hPanel, Plesk, dan seterusnya), di Cloudflare, atau belum di mana pun. Jika belum punya situs web, edisi Cloudflare adalah pilihan yang aman.
  2. Untuk hosting web, asisten memberi tahu Anda apa yang harus diunggah dan ke mana, atau mengunggahnya untuk Anda jika Anda memberinya akses ke hosting Anda.
  3. Untuk Cloudflare, asisten meminta token API Cloudflare kepada Anda. Buat token di Cloudflare melalui My Profile → API Tokens dengan izin yang disebutkan asisten Anda, lalu tempel sendiri ke terminal.

Lihat langkah akun, penyimpanan, dan token Cloudflare di panduan akun Cloudflare gratis.

Periksa rencananya sebelum Anda menjawab ya

Sebelum deploy ke Cloudflare, asisten Anda menampilkan rencananya kepada Anda. “Will create” mencantumkan satu Worker, satu bucket R2, dan satu database D1, sedangkan “Will not touch” mencantumkan semua yang lain di akun tersebut. Pada hosting web, asisten memberi tahu folder mana yang akan ditambahkannya. Jawab ya hanya jika daftarnya sudah benar.

Yang akan Anda lihat Ringkasan dari asisten Anda tentang apa yang akan dibuatnya dan apa yang dibiarkannya, menunggu jawaban ya dari Anda.

Hubungkan Maxisnap lalu coba

Jika sudah berhasil, asisten Anda memberikan alamat Studio dan kunci Admin-nya kepada Anda. Simpan kunci itu di tempat yang aman, seperti pengelola kata sandi Anda.

  • Maxisnap untuk Windows: buka Pengaturan → Akun → Wizard penyiapan Maxisnap Studio, klik “Mulai”, lalu “Berikutnya” sampai langkah 4, “Hubungkan Maxisnap”. Tempel alamat dan kunci Studio Anda, klik “Uji koneksi”, lalu “Berikutnya”, lalu “Selesai & Simpan” di halaman terakhir. Kunci Admin dari penyiapan dapat dipakai, begitu juga kode unggah dari People & access di dasbor Anda.
  • Maxisnap untuk Mac: buka Settings → Welcome & Help → Studio Setup Guide dan pilih “I already have a dashboard”. Tempel alamat dan kunci Studio Anda, klik “Test Connection”, lalu “Next”, lalu “Finish & Save”.

Ambil tangkapan apa saja dan klik “Unggah” di editor. Di Windows, Ctrl+Alt+7 menangkap sebuah area dan langsung mengunggahnya. Tautan berbagi akan masuk ke papan klip Anda.

Langkah berikutnya: tambahkan tim Anda di dasbor, di bagian People & access (setiap orang mendapat kode dan perannya sendiri), dan ubah logo atau warna Anda kapan saja di bagian Branding.

Jika terjadi masalah

Asisten Anda mengatakan tidak bisa membuka file atau menjalankan perintah

Gunakan asisten coding yang berjalan di komputer Anda dan dapat bekerja di dalam folder, seperti Claude Code, Codex, atau Cursor. Chat di tab browser tidak dapat melihat folder Studio Anda atau menjalankan alat deploy.

Asisten Anda tidak dapat menemukan file petunjuk

Periksa folder yang Anda tempelkan ke dalam petunjuk. Folder itu harus folder Studio yang sudah diekstrak, bukan file ZIP-nya, dan di dalamnya terdapat file petunjuk untuk asisten AI.

Asisten Anda mengatakan Node.js tidak ada atau versinya terlalu usang

Alat deploy Cloudflare memerlukan Node.js 20 atau yang lebih baru. Pasang versi LTS terkini dari nodejs.org, atau biarkan asisten Anda memasangnya setelah asisten itu memberi tahu apa yang akan dilakukannya, lalu mulai lagi. Studio di hosting web tidak memerlukan Node.js.

Asisten Anda meminta Anda menempelkan token atau kata sandi ke chat

Sebagai gantinya, tempel di terminal saat perintahnya memintanya, agar tidak tersimpan di riwayat chat. Jika Anda sudah menempelkan token Cloudflare ke chat, hapus token itu di Cloudflare melalui My Profile → API Tokens setelah Studio Anda berjalan, lalu buat token baru saat Anda membutuhkannya lagi.

Asisten Anda ingin menghapus, menggantikan, atau mengganti nama sesuatu

Jawab tidak. Studio hanya menambahkan hal baru, dan petunjuknya meminta asisten Anda untuk tidak pernah menghapus, menimpa, atau mengganti nama file situs web, record DNS, Worker, bucket, atau database yang sudah ada. Minta asisten itu memilih nama baru sebagai gantinya.

Asisten Anda mengatakan file branding Anda tidak ada

Anda belum mengunci branding. Buka “Maxisnap Studio - Start Here.html”, rancang branding Anda lalu klik “Lock in my branding”, atau katakan kepada asisten Anda untuk melanjutkan dengan tampilan Maxisnap. Anda dapat mengubahnya nanti di dasbor Anda, di bagian Branding.

Pemeriksaan akhir asisten Anda mengembalikan 401 atau 404

{"error":"unauthorized"}

401 berarti kuncinya salah: gunakan kunci Admin persis seperti yang ditampilkan saat penyiapan. 404, atau halaman web alih-alih jawaban singkat, berarti alamat atau foldernya salah, atau pada hosting web aturan .htaccess Studio diabaikan.

Deploy ke Cloudflare berhenti di tengah jalan

Minta asisten Anda menjalankan lagi perintah deploy yang sama dari folder yang sama. Perintah itu membaca deployment.json dan melanjutkan dari titik berhenti tanpa membuat apa pun dua kali.

Maxisnap tidak terhubung dengan alamat dan kunci dari asisten Anda

Alamat yang dimaksud adalah alamat tempat Anda membuka dasbor Studio, diawali dengan https://, misalnya https://yourcompany.com/snaps. Salin kunci tanpa spasi sebelum atau sesudahnya. Panduan untuk menghubungkan Studio yang sudah ada menjelaskan arti setiap pesan.

Masih butuh bantuan?

Kirim email kepada kami dan seseorang akan membalas, biasanya dalam satu hari kerja. Detail berikut membantu kami menjawab sekaligus:

  • Opsi penyiapan yang Anda pilih dan langkah yang sedang Anda kerjakan.
  • Screenshot layar, dengan pesan kesalahan apa pun secara lengkap.
  • Di mana Studio Anda akan dipasang: akun Cloudflare baru atau yang sudah ada, atau nama perusahaan hosting web Anda.
  • Versi Maxisnap Anda: di Windows pada Pengaturan, lalu Tentang; di Mac pada Maxisnap, lalu About Maxisnap.

Mohon jangan kirimkan kunci Admin, kunci Cloudflare, atau kata sandi Anda. Kami tidak membutuhkannya untuk membantu Anda.

Panduan penyiapan lainnya