Перейти к основному содержимому
Руководства по настройке Studio Всё настроит мой ИИ-ассистент

Поручите настройку Studio вашему ИИ-ассистенту

ИИ-ассистент для программирования на вашем компьютере, например Claude Code, Codex или Cursor, может запустить Studio в Интернете за вас. Вы вставляете готовые инструкции. Ассистент читает руководство по настройке из пакета Studio, вместе с вами выясняет, что подойдёт лучше — ваш веб-хостинг или аккаунт Cloudflare, — и спрашивает, прежде чем что-либо изменить.

Лучше всего подходит для
Тех, кто уже пользуется ИИ-ассистентом для программирования, способным выполнять команды на их компьютере, — при любом варианте Studio: на веб-хостинге или в Cloudflare.
Что понадобится
Maxisnap для Windows или Mac с выполненным входом в аккаунт, у которого есть Studio; ИИ-ассистент для программирования на вашем компьютере; а также данные для входа в хостинг или аккаунт Cloudflare.
Время
Почти без вашего участия: вы отвечаете на вопросы ассистента и одобряете каждое изменение.
Что вы получите
Тот же Studio, что и в других вариантах настройки, на вашем веб-хостинге или в вашем собственном аккаунте Cloudflare.

Чем руководствуется ваш ассистент

В каждом пакете Studio есть инструкции, написанные для ИИ-ассистентов. В них описаны оба варианта Studio, точные шаги установки, что должно оставаться закрытым и как проверить результат. Кроме того, они предписывают ассистенту:

  • Спрашивать вас перед каждой загрузкой, развёртыванием или изменением на сервере или в аккаунте и точно говорить, что именно будет изменено.
  • Никогда не удалять, не перезаписывать и не переименовывать то, что уже есть: файлы сайта, DNS-записи, Workers, хранилища или базы данных. Studio только добавляет новое.
  • Не сохранять ключи и пароли в создаваемых файлах.
  • В конце сообщить вам адрес Studio и ключ администратора, чтобы вы могли подключить Maxisnap.

Скачайте Studio на свой компьютер

  • В Windows: в Maxisnap откройте Настройки → Аккаунт → Мастер настройки Studio, нажмите «Начать работу», затем «Скачать панель управления». Maxisnap сохраняет ZIP-архив Studio в папку «Загрузки» и открывает эту папку.
  • На Mac: в Maxisnap откройте Settings → Welcome & Help → Studio Setup Guide, нажмите «Get Started», затем «Download Dashboard». Maxisnap сохраняет ZIP-архив Studio в папку «Загрузки».

Распакуйте ZIP-архив. В Windows щёлкните его правой кнопкой мыши и выберите «Извлечь все». На Mac дважды щёлкните его.

Скопируйте расположение распакованной папки; вы вставите его на шаге 3. В Windows щёлкните папку правой кнопкой мыши и выберите «Копировать как путь». На Mac выберите папку и нажмите Option+Command+C.

Файл с инструкциями для ИИ-ассистентов находится в этой папке:

AGENTS.md

Что вы увидите Распакованная папка Studio: три папки (cloudflare, docs и snaps), страница Start Here и инструкции для ИИ-ассистентов.

При желании зафиксируйте оформление

Дважды щёлкните «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 ассистент попросит у вас токен API Cloudflare. Создайте токен в Cloudflare в разделе My Profile → API Tokens с теми разрешениями, которые перечислит ассистент, и сами вставьте его в терминал.

Шаги по аккаунту Cloudflare, хранилищу и токену см. в руководстве по бесплатному аккаунту Cloudflare.

Проверьте план ассистента, прежде чем сказать «да»

Перед развёртыванием в Cloudflare ассистент показывает вам план. В списке «Will create» — один Worker, одно хранилище R2 и одна база данных D1, а в списке «Will not touch» — всё остальное в аккаунте. На веб-хостинге он сообщает, какую папку добавит. Отвечайте «да», только когда список выглядит правильно.

Что вы увидите Сводка ассистента о том, что он создаст и чего не тронет, в ожидании вашего «да».

Подключите Maxisnap и попробуйте

Когда всё заработает, ассистент сообщит вам адрес вашего Studio и его ключ администратора. Храните ключ в надёжном месте, например в менеджере паролей.

  • Maxisnap для Windows: откройте Настройки → Аккаунт → Мастер настройки Studio, нажмите «Начать работу», затем нажимайте «Далее», пока не дойдёте до шага 4 — «Подключите Maxisnap». Вставьте адрес вашего Studio и ключ, нажмите «Проверить подключение», затем «Далее», а на последней странице — «Завершить и сохранить». Подойдёт ключ администратора, полученный при настройке, а также код загрузки из раздела People & access в вашей панели управления.
  • Maxisnap для Mac: откройте Settings → Welcome & Help → Studio Setup Guide и выберите «I already have a dashboard». Вставьте адрес вашего Studio и ключ, нажмите «Test Connection», затем «Next», затем «Finish & Save».

Сделайте снимок и нажмите «Загрузить» в редакторе. В Windows сочетание Ctrl+Alt+7 выполняет захват области и сразу загружает снимок. Ссылка для общего доступа оказывается в буфере обмена.

Что дальше: добавьте свою команду в панели управления в разделе People & access (у каждого будет свой код и своя роль), а логотип и цвета можно в любой момент изменить в разделе Branding.

Если что-то пошло не так

Ассистент сообщает, что не может открывать файлы или выполнять команды

Используйте ассистент для программирования, который запускается на вашем компьютере и умеет работать с папками, например Claude Code, Codex или Cursor. Чат во вкладке браузера не видит вашу папку Studio и не может запустить инструмент развёртывания.

Ассистент не может найти файл с инструкциями

Проверьте папку, которую вы вставили в инструкции. Это должна быть распакованная папка Studio, а не ZIP-файл, и в ней лежит файл с инструкциями для ИИ-ассистентов.

Ассистент сообщает, что Node.js отсутствует или слишком старый

Для инструмента развёртывания в Cloudflare нужен Node.js 20 или новее. Установите текущую LTS-версию с сайта nodejs.org либо позвольте ассистенту установить её, когда он расскажет, что собирается сделать, а затем начните заново. Для Studio на веб-хостинге Node.js не нужен.

Ассистент просит вставить токен или пароль в чат

Вместо этого вставьте его в терминал, когда команда его запросит, чтобы он не остался в истории чата. Если вы уже вставили токен Cloudflare в чат, удалите его в Cloudflare в разделе My Profile → API Tokens, когда ваш Studio заработает, а новый создайте, когда он понадобится в следующий раз.

Ассистент хочет что-то удалить, заменить или переименовать

Ответьте «нет». Studio только добавляет новое, а его инструкции требуют, чтобы ассистент никогда не удалял, не перезаписывал и не переименовывал существующие файлы сайта, DNS-записи, Workers, хранилища или базы данных. Вместо этого попросите его выбрать новое имя.

Ассистент сообщает, что файл с оформлением отсутствует

Вы ещё не зафиксировали оформление. Откройте «Maxisnap Studio - Start Here.html», настройте своё оформление и нажмите «Lock in my branding» либо скажите ассистенту продолжать с оформлением Maxisnap. Позже его можно изменить в панели управления в разделе Branding.

Итоговая проверка ассистента возвращает 401 или 404

{"error":"unauthorized"}

401 означает, что ключ неверный: используйте ключ администратора точно в том виде, в каком его показала настройка. 404 или веб-страница вместо короткого ответа означает, что адрес или папка указаны неверно либо, на веб-хостинге, что правила .htaccess от Studio игнорируются.

Развёртывание в Cloudflare остановилось на полпути

Попросите ассистента снова запустить ту же команду развёртывания из той же папки. Она считывает deployment.json и продолжает с того места, где остановилась, ничего не создавая дважды.

Maxisnap не подключается по адресу и ключу, которые дал ассистент

Это адрес, по которому вы открываете панель управления Studio; он начинается с https://, например https://yourcompany.com/snaps. Скопируйте ключ без пробелов до и после него. В руководстве по подключению существующего Studio объясняется, что означает каждое сообщение.

Нужна дополнительная помощь?

Напишите нам, и вам ответит человек, обычно в течение одного рабочего дня. Эти сведения помогут нам ответить с первого раза:

  • Выбранный вами вариант настройки и шаг, на котором вы находитесь.
  • Скриншот экрана, на котором целиком видно любое сообщение об ошибке.
  • Где будет работать ваш Studio: новый или существующий аккаунт Cloudflare либо название вашего хостинг-провайдера.
  • Ваша версия Maxisnap: в Windows — Настройки, затем О программе; на Mac — Maxisnap, затем About Maxisnap.

Пожалуйста, не присылайте ключ администратора, ключ Cloudflare или пароль. Они не нужны нам, чтобы вам помочь.

Другие руководства по настройке