让你的 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」，设计你的 Logo、颜色和字体，然后点击「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」下更改你的 Logo 或颜色。