Перейти к основному содержимому

Текстовый редактор

Текстовый редактор предназначен для редактирования проектов скриптов на устройстве и обычных текстовых файлов. После открытия проекта разработки он также подключается к тестовому устройству, запускает, останавливает и отлаживает скрипты, а также создаёт зашифрованные артефакты или пакеты консоли.

Открытие текстового редактора​

Основные способы:

  • Дважды щёлкните текстовый файл в файловом менеджере или выберите редактирование текста в его контекстном меню.
  • Щёлкните устройство правой кнопкой в списке устройств, выберите просмотр файлов устройства и откройте текстовый файл на устройстве.
  • Щёлкните папку проекта правой кнопкой в 开发目录, выберите 打开项目, затем нажмите файл в дереве проекта.
  • Щёлкните устройство правой кнопкой в списке и создайте временный файл Lua для быстрого тестирования небольшого фрагмента скрипта.

Основные операции редактирования​

  • Нажмите 保存, чтобы записать текущие изменения в файл.
  • Нажмите 重新读取, чтобы заново загрузить содержимое из исходного места.
  • Щёлкните вкладку правой кнопкой, чтобы просмотреть файл в файловом менеджере, переименовать его или скопировать путь.
  • В строке состояния снизу видны строка и столбец, отступы, кодировка, окончания строк и тип файла; если не уверены, оставьте значения по умолчанию.
  • Кнопка миниатюры показывает или скрывает миниатюру кода справа.

Если после открытия файл изменён другой операцией, при сохранении появится запрос на перезапись. При перечитывании или закрытии несохранённой вкладки также появится предупреждение о возможной потере изменений.

Настройка устройства разработки и тестирования​

Перед запуском и отладкой на устройстве нужно выбрать устройство разработки и тестирования. Оно должно быть импортировано, подключено к сети и доступно через XXTouch; для офлайн-устройства просмотр файлов, запуск и отладка недоступны.

Основные способы:

  1. В списке устройств щёлкните нужное устройство правой кнопкой и выберите 设为开发测试设备.
  2. Нажмите кнопку устройства в левом верхнем углу текстового редактора, откройте 选择测试设备 и выберите цель.

Чтобы сменить устройство, выберите другое; когда подключение больше не нужно, нажмите 断开测试 там же.

Запуск на устройстве​

Откройте проект разработки или файл в нём, нажмите Запустить и просмотрите вывод в области журналов внизу.

Обычно запускаются файлы скриптов в проекте разработки или отдельные запускаемые файлы .lua. Для обычного текста, нераспознанного проекта или проекта без входа показывается 当前文件不能运行.

Чтобы завершить скрипт, нажмите 停止.

Отладка на устройстве​

Нажмите 调试, чтобы запустить проект в режиме отладки и исследовать переменные, стек вызовов и ветвления.

Основные действия:

  • устанавливать и снимать точки останова в области номеров строк слева;
  • управлять выполнением с помощью 继续, 单步, 进入 и 跳出;
  • просматривать в стеке вызовов, на какой функции остановился скрипт; щелчок по элементу переносит редактор к нужному месту;
  • просматривать доступные в текущей точке остановки переменные; контекстное меню позволяет скопировать или изменить значение;
  • вводить однострочный Lua в консоли отладки и выполнять выражения, пока скрипт приостановлен;
  • нажать 断开调试, чтобы завершить текущее соединение.

Конфигурация проекта​

После открытия проекта в заголовке текстового редактора доступна 项目配置. Здесь можно изменить имя, ID, версию, описание, игнорируемые пути, общие библиотеки и настройки рабочей области образцов.

После изменения конфигурации проекта нажмите 保存. Для обычного редактирования скрипта открывать её каждый раз не нужно; используйте её при изменении имени, сведений о публикации, путей ресурсов или параметров выбора цвета.

Артефакты проекта​

В операциях проекта текстового редактора также доступны:

  • 加密: создаёт зашифрованный артефакт для распространения или развёртывания. После завершения показывается место сохранения; файл можно открыть или скачать из дерева проекта или файлового менеджера.
  • 中控包: упаковывает проект в пакет скрипта, который можно установить и управлять им в каталоге скриптов консоли. Доступно только для поддерживаемых типов проектов.

Перед созданием артефакта сохраните все открытые файлы проекта и проверьте запуск на устройстве разработки и тестирования.

Автодополнение AI​

Автодополнение AI — дополнительная функция текстового редактора. После включения при вводе отображаются призрачные подсказки, созданные AI.

Для использования сначала настройте функцию в общих параметрах:

  1. Откройте 系统配置 → AI 供应商.
  2. Нажмите 添加配置 и укажите имя конфигурации, сервис AI, модель и API Key. Для совместимых сервисов без ключа API Key можно оставить пустым.
  3. При необходимости проверить имя модели нажмите 获取模型 или введите его вручную.
  4. Откройте 系统配置 → 文本编辑器.
  5. В AI 配置 выберите созданную конфигурацию.
  6. Включите 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 补全上下文, чтобы перечитать его содержимое.