Текстовый редактор
Текстовый редактор предназначен для редактирования проектов скриптов на устройстве и обычных текстовых файлов. После открытия проекта разработки он также подключается к тестовому устройству, запускает, останавливает и отлаживает скрипты, а также создаёт зашифрованные артефакты или пакеты консоли.
Открытие текстового редактора
Основные способы:
- Дважды щёлкните текстовый файл в файловом менеджере или выберите редактирование текста в его контекстном меню.
- Щёлкните устройство правой кнопкой в списке устройств, выберите просмотр файлов устройства и откройте текстовый файл на устройстве.
- Щёлкните папку проекта правой кнопкой в
开发目录, выберите打开项目, затем нажмите файл в дереве проекта. - Щёлкните устройство правой кнопкой в списке и создайте временный файл Lua для быстрого тестирования небольшого фрагмента скрипта.
Основные операции редактирования
- Нажмите
保存, чтобы записать текущие изменения в файл. - Нажмите
重新读取, чтобы заново загрузить содержимое из исходного места. - Щёлкните вкладку правой кнопкой, чтобы просмотреть файл в файловом менеджере, переименовать его или скопировать путь.
- В строке состояния снизу видны строка и столбец, отступы, кодировка, окончания строк и тип файла; если не уверены, оставьте значения по умолчанию.
- Кнопка миниатюры показывает или скрывает миниатюру кода справа.
Если после открытия файл изменён другой операцией, при сохранении появится запрос на перезапись. При перечитывании или закрытии несохранённой вкладки также появится предупреждение о возможной потере изменений.
Настройка устройства разработки и тестирования
Перед запуском и отладкой на устройстве нужно выбрать устройство разработки и тестирования. Оно должно быть импортировано, подключено к сети и доступно через XXTouch; для офлайн-устройства просмотр файлов, запуск и отладка недоступны.
Основные способы:
- В списке устройств щёлкните нужное устройство правой кнопкой и выберите
设为开发测试设备. - Нажмите кнопку устройства в левом верхнем углу текстового редактора, откройте
选择测试设备и выберите цель.
Чтобы сменить устройство, выберите другое; когда подключение больше не нужно, нажмите 断开测试 там же.
Запуск на устройстве
Откройте проект разработки или файл в нём, нажмите Запустить и просмотрите вывод в области журналов внизу.
Обычно запускаются файлы скриптов в проекте разработки или отдельные запускаемые файлы .lua. Для обычного текста, нераспознанного проекта или проекта без входа показывается 当前文件不能运行.
Чтобы завершить скрипт, нажмите 停止.
Отладка на устройстве
Нажмите 调试, чтобы запустить проект в режиме отладки и исследовать переменные, стек вызовов и ветвления.
Основные действия:
- устанавливать и снимать точки останова в области номеров строк слева;
- управлять выполнением с помощью
继续,单步,进入и跳出; - просматривать в стеке вызовов, на какой функции остановился скрипт; щелчок по элементу переносит редактор к нужному месту;
- просматривать доступные в текущей точке остановки переменные; контекстное меню позволяет скопировать или изменить значение;
- вводить однострочный Lua в консоли отладки и выполнять выражения, пока скрипт приостановлен;
- нажать
断开调试, чтобы завершить текущее соединение.
Конфигурация проекта
После открытия проекта в заголовке текстового редактора доступна 项目配置. Здесь можно изменить имя, ID, версию, описание, игнорируемые пути, общие библиотеки и настройки рабочей области образцов.
После изменения конфигурации проекта нажмите 保存. Для обычного редактирования скрипта открывать её каждый раз не нужно; используйте её при изменении имени, сведений о публикации, путей ресурсов или параметров выбора цвета.
Артефакты проекта
В операциях проекта текстового редактора также доступны:
加密: создаёт зашифрованный артефакт для распространения или развёртывания. После завершения показывается место сохранения; файл можно открыть или скачать из дерева проекта или файлового менеджера.中控包: упаковывает проект в пакет скрипта, который можно установить и управлять им в каталоге скриптов консоли. Доступно только для поддерживаемых типов проектов.
Перед созданием артефакта сохраните все открытые файлы проекта и проверьте запуск на устройстве разработки и тестирования.
Автодополнение AI
Автодополнение AI — дополнительная функция текстового редактора. После включения при вводе отображаются призрачные подсказки, созданные AI.
Для использования сначала настройте функцию в общих параметрах:
- Откройте
系统配置 → AI 供应商. - Нажмите
添加配置и укажите имя конфигурации, сервис AI, модель и API Key. Для совместимых сервисов без ключа API Key можно оставить пустым. - При необходимости проверить имя модели нажмите
获取模型или введите его вручную. - Откройте
系统配置 → 文本编辑器. - В
AI 配置выберите созданную конфигурацию. - Включите
AI 补全и нажмите保存设置.
Если сервис требует определённый идентификатор клиента или дополнительные заголовки запроса, при добавлении или редактировании конфигурации AI заполните поля User-Agent и Пользовательские заголовки под API Key. Вводите по одной паре Имя: Значение в строке, например X-Custom-Header: value. Эти параметры также применяются при получении моделей; оставьте поля пустыми, если дополнительная настройка не требуется.
По умолчанию в поле Имя заголовка ID сеанса указано session-id. Укажите имя, требуемое сервисом, например x-opencode-session для OpenCode Go. Значение ID вводить не нужно; оставьте поле пустым для отключения.
После включения в подходящих текстовых файлах редактор автоматически показывает серые подсказки. Основные действия:
- нажмите
Tab, чтобы принять подсказку; - нажмите
Esc, чтобы отклонить подсказку; - нажмите
Alt + Backslash, чтобы вызвать автодополнение вручную; - при нескольких вариантах переключайтесь клавишами
Alt + [/Alt + ].
Эти параметры можно изменить в 系统配置 → 文本编辑器:
补全偏好: стиль кода и правила проекта, которым должен следовать AI.适用文件扩展名: ограничивает файлы, для которых запускается автодополнение AI; можно добавить свои расширения.补全上下文: кроме текущего файла можно добавитьXXTouch 文档или项目文件, чтобы подсказки лучше учитывали проект скрипта.
Если подсказки не появляются, проверьте конфигурацию поставщика AI, включение AI 补全, расширение текущего файла и доступность модели/API Key. После значительных изменений проекта откройте проект и нажмите 刷新 AI 补全上下文, чтобы перечитать его содержимое.