讓你的 AI 助理設定 Studio

在你的電腦上取得 Studio

• 在 Windows 上：在 Maxisnap 中開啟「設定 → 帳戶 → Maxisnap Studio 設定精靈」，按一下「開始使用」，再按一下「下載儀表板」。Maxisnap 會把 Studio ZIP 檔儲存到你的「下載」資料夾，並開啟該資料夾。
• 在 Mac 上：在 Maxisnap 中開啟「Settings → Welcome & Help → Studio Setup Guide」，按一下「Get Started」，再按一下「Download Dashboard」。Maxisnap 會把 Studio ZIP 檔儲存到你的「下載項目」資料夾。

解壓縮 ZIP 檔。在 Windows 上，請以滑鼠右鍵按一下該檔案，選擇「全部解壓縮」。在 Mac 上，按兩下即可。

複製解壓縮後資料夾的位置；你會在第 3 步貼上它。在 Windows 上，請以滑鼠右鍵按一下該資料夾，選擇「複製為路徑」。在 Mac 上，請選取該資料夾並按下 Option+Command+C。

給 AI 助理的指示檔案就在那個資料夾中：

AGENTS.md

如果你想要，可以鎖定你的品牌設定

按兩下「Maxisnap Studio - Start Here.html」，設計你的標誌、色彩和字型，再按一下「Lock in my branding」，助理就會使用它。你也可以略過這一步，之後再到儀表板的「Branding」中變更品牌設定。

複製指示

複製這些指示，把角括號中的那一行換成你的 Studio 資料夾，然後貼到你的助理中。

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”).

回答助理的問題

1. 告訴它你的網站在哪裡：在虛擬主機上（cPanel、hPanel、Plesk 等等）、在 Cloudflare 上，或還沒有網站。如果沒有網站，Cloudflare 版是穩妥的選擇。
2. 如果是虛擬主機，它會告訴你要上傳什麼、上傳到哪裡；如果你讓它存取你的主機，它也可以替你上傳。
3. 如果是 Cloudflare，它會要求你提供 Cloudflare API 權杖。請到 Cloudflare 的「My Profile → API Tokens」，依助理列出的權限建立權杖，並自己把它貼到終端機中。

Cloudflare 帳戶、儲存空間和權杖的步驟，請參閱免費 Cloudflare 帳戶指南。

在你同意之前，先檢查它的計畫

在進行 Cloudflare 部署之前，助理會先把計畫顯示給你看。「Will create」會列出一個 Worker、一個 R2 儲存貯體和一個 D1 資料庫，「Will not touch」則列出帳戶中的其他所有項目。如果是虛擬主機，助理會告訴你它要新增哪個資料夾。確認清單沒問題後，再回答同意。

連接 Maxisnap 並試試看

成功之後，助理會給你 Studio 的網址和管理員金鑰。請把金鑰存放在安全的地方，例如你的密碼管理員。

• Windows 版 Maxisnap：開啟「設定 → 帳戶 → Maxisnap Studio 設定精靈」，按一下「開始使用」，然後一直按「下一步」，直到第 4 步「連接 Maxisnap」。貼上 Studio 網址和金鑰，按一下「測試連線」，再按「下一步」，到最後一頁時按一下「完成並儲存」。設定時取得的管理員金鑰可以使用，儀表板「People & access」中的上傳代碼也可以。
• Mac 版 Maxisnap：開啟「Settings → Welcome & Help → Studio Setup Guide」，選擇「I already have a dashboard」。貼上 Studio 網址和金鑰，按一下「Test Connection」，再按「Next」，最後按一下「Finish & Save」。

擷取一些畫面，然後在編輯器中按一下「上傳」。在 Windows 上，按 Ctrl+Alt+7 會擷取一個區域並立即上傳。分享連結會放到你的剪貼簿中。

接下來：在儀表板的「People & access」中加入你的團隊（每個人都會有自己的代碼和角色），並隨時可以在「Branding」中更改標誌或色彩。