Запуск Moonpool с USB-накопителя или синхронизируемой папки

Портативный режим хранит Moonpool и всё, что он записывает, внутри одной папки .moonpool\, поэтому вы можете носить её на USB-накопителе или положить в синхронизируемую папку и запускать на любом ПК.

Как это работает

При портативной установке Moonpool создаёт папку .moonpool\ внутри выбранного вами расположения. В этой папке лежат программа, ваша конфигурация и её справочное содержимое. Ничто не записывается в Windows AppData, поэтому перемещение или копирование папки переносит всю вашу настройку вместе с ней.

<chosen location>\.moonpool\

Чем отличается от установленной версии

	Установленная	Портативная
Программа	%USERPROFILE%\.moonpool\moonpool.exe	<chosen location>\.moonpool\moonpool.exe
Папка конфигурации	%USERPROFILE%\.moonpool\moonpool-config\	<chosen location>\.moonpool\moonpool-config\
Профиль браузера окна, размер и положение окна	В папке конфигурации	В папке конфигурации, поэтому они тоже переносятся
Меню «Пуск», ярлык на рабочем столе, запись в «Установке и удалении программ»	Да	Нет
Обновления	Заменяет собственный exe	То же, внутри папки .moonpool\. См. Обновление.
Удаление	«Установка и удаление программ» или --uninstall	Удалите папку

Ни один из режимов не пишет в Windows AppData.

Синхронизируемые папки

Портативную копию можно хранить в синхронизируемой папке (OneDrive, Dropbox и подобных), но запускайте её только на одном ПК за раз. Moonpool записывает state.json каждые пару секунд и ведёт журналы по мере работы приложений, поэтому два ПК, работающие с одной папкой, конфликтуют за одни и те же файлы, а конфликт синхронизации может оставить повреждённый apps.json. Закройте его на одном ПК, прежде чем запускать на другом.

Несколько копий одновременно

На каждую папку запускается один Moonpool. Установленный Moonpool и любое число портативных копий, каждая в своей папке, могут работать одновременно, и каждая полностью независима: свои приложения, значок в трее, окно, настройки, журналы и канал управления.

• Подсказка значка в трее и название на панели задач показывают, какая копия какая: Moonpool для установленной, Moonpool (<folder>) для портативной, где <folder> - это выбранная вами папка (та, в которой лежит .moonpool\).
• Повторный запуск той же копии возвращает её окно, а не открывает ещё одно. Запуск другой копии открывает эту копию.
• Чтобы дать ИИ-агенту больше одной копии, зарегистрируйте каждую под своим именем; см. Настройка MCP.
• Перемещение или переименование портативной папки даёт ей новую идентичность (новое имя канала управления). Закройте её перед перемещением.
• Копии ничего не знают о приложениях друг друга. Две копии, которые запускают один и тот же сервер на одном порту, всё равно будут конфликтовать, а остановка по имени процесса или порту может завершить то, что запустила другая копия; см. Остановка и перезапуск.

Как сделать так, чтобы приложения тоже переносились

Используйте токен {MP_HOME} в пути приложения, чтобы он указывал внутрь портативной папки, а не на фиксированное место на одном компьютере. В портативной копии {MP_HOME} - это папка, в которой лежит moonpool.exe, то есть сама папка .moonpool\, а не выбранная вами папка:

apps.json

{ "cwd": "{MP_HOME}/my-app" }

Здесь {MP_HOME}/my-app - это <chosen location>\.moonpool\my-app. Путь, начинающийся с ./, привязывается так же. Токены и пути ./ работают и в установленном Moonpool. О том, как разрешаются пути, см. Пути и окружение.

Выбор портативного режима в установщике

Портативный режим настраивается на карточке установщика, которая предлагает Портативная установка рядом с Установить Moonpool.

Выберите папку, и Moonpool создаст там папку .moonpool\, скопирует себя в неё и запустит новую копию с чистой конфигурацией.

Карточка также есть в меню «…» как Установить Moonpool…, как в установленном, так и в портативном режиме. Выбор Портативная установка оттуда закрывает работающий Moonpool и запускает вместо него новую портативную копию. Moonpool, из которого вы начали, остаётся там, где был, поэтому его можно запустить снова.

Портативная копия начинается с чистого листа и не копирует ваши существующие приложения. Чтобы перенести их, закройте портативную копию и скопируйте apps.json вручную:

	Путь
Откуда (установленная)	%USERPROFILE%\.moonpool\moonpool-config\apps.json
Куда (портативная)	<chosen location>\.moonpool\moonpool-config\apps.json

Записи с абсолютными путями по-прежнему работают на том же ПК, но не переносятся. Диалог «Изменить приложение» помечает их «не переносимо».

Как Moonpool понимает, что он портативный

Копия портативна, пока рядом с её moonpool.exe лежит файл moonpool.portable. Ничто другое её не отмечает, и ничего не регистрируется в Windows.

Чтобы удалить портативную копию, закройте её и удалите её папку .moonpool\. --uninstall удаляет только установленный Moonpool, а портативную копию никогда.