Поручите настройку 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
При желании зафиксируйте оформление
Дважды щёлкните «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”).Скопировать Скопировано Скопировано. Вставьте это в своего ассистента. Браузер заблокировал копирование. Вместо этого выделите текст и скопируйте его.
Ответьте на вопросы ассистента
- Скажите ассистенту, где находится ваш сайт: на веб-хостинге (cPanel, hPanel, Plesk и так далее), в Cloudflare или пока нигде. Если сайта нет, безопасный выбор — вариант на Cloudflare.
- Для веб-хостинга он сообщает, что и куда загрузить, либо загружает это сам, если вы дадите ему доступ к хостингу.
- Для Cloudflare ассистент попросит у вас токен API Cloudflare. Создайте токен в Cloudflare в разделе My Profile → API Tokens с теми разрешениями, которые перечислит ассистент, и сами вставьте его в терминал.
Проверьте план ассистента, прежде чем сказать «да»
Перед развёртыванием в 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 или пароль. Они не нужны нам, чтобы вам помочь.
Другие руководства по настройке
- У меня нет сайта
Разместите Studio в бесплатном аккаунте Cloudflare
- Моя компания уже использует Cloudflare
Добавьте Studio в аккаунт Cloudflare вашей компании
- У меня есть веб-хостинг
Установите Studio на свой веб-хостинг
- Я веб-разработчик
Настройка Studio для веб-разработчиков
- У меня уже есть Studio
Подключите Maxisnap к вашему Studio