跳到主要内容

文本编辑器

文本编辑器用于编辑设备端脚本项目和普通文本文件。打开开发项目后，它还可以连接测试设备，直接运行、停止、调试脚本，并生成加密产物或中控包。

打开文本编辑器​

常见入口：

  • 在文件管理器中双击文本文件，或右键文件后选择编辑文本。
  • 在设备列表中右键设备，选择浏览设备文件，再打开设备上的文本文件。
  • 在 开发目录 中右键项目文件夹，选择 打开项目，再从项目树中点击文件。
  • 在设备列表中右键设备，创建临时 Lua 文件，用来快速测试一小段脚本。

常用编辑操作​

  • 点击 保存，把当前修改写回文件。
  • 点击 重新读取，从原位置重新加载文件内容。
  • 在标签页上点右键，可以在文件管理器中查看、重命名或复制路径。
  • 底部状态栏可以查看行列、缩进、编码、行尾和文件类型；不确定时保持默认即可。
  • 点击缩略图按钮，可以显示或隐藏右侧代码缩略图。

如果文件在打开后被其它操作修改，保存时会出现覆盖确认。重新读取或关闭未保存标签时，也会提示可能丢失当前修改。

设置开发测试设备​

联机运行和调试前，需要先设置开发测试设备。设备需要已经导入、在线，并能被 XXTouch 正常访问；离线设备不能浏览文件、运行或调试。

常见入口：

  1. 在设备列表中右键目标设备，选择 设为开发测试设备。
  2. 在文本编辑器左上角点击设备按钮，打开 选择测试设备，选择目标设备。

设置后，文本编辑器会显示当前测试设备，并提供 浏览设备文件、打开样本工作台、运行、停止、调试 等操作。

需要更换设备时，重新选择其它设备即可；不再联机时，可以在同一位置点击 断开测试。

联机运行​

打开开发项目或项目内文件后，点击 运行。文本编辑器会先保存需要保存的内容，再把当前项目发送到测试设备并启动。运行期间可以在下方日志区域查看输出。

能够运行的内容通常是开发项目内的脚本文件，或可直接运行的 .lua 文件。普通文本文件、未识别项目、没有入口的项目，会提示 当前文件不能运行。

常见状态：

  • 运行中：脚本已启动或正在等待设备执行。
  • 停止中：正在向设备发送停止请求。
  • 暂无日志：日志连接正常，但设备暂时没有输出。
  • 请选择开发设备：还没有设置测试设备。
  • 当前文件不能运行：当前标签不属于可运行项目或没有可识别入口。
  • 保存失败，已停止运行：当前文件没有保存成功，运行不会继续。

需要终止脚本时，点击 停止。

联机调试​

点击 调试 可以以调试方式启动项目。适合定位运行过程中的变量、调用栈和分支问题。

常用操作：

  • 在编辑器左侧行号区域设置或取消断点。
  • 使用 继续、单步、进入、跳出 控制脚本执行。
  • 在调用栈中查看脚本停在哪一层函数，点击某一项后编辑器会跳转到对应位置。
  • 在变量面板中查看当前暂停位置能看到的变量，右键可复制变量值或修改变量值。
  • 在调试控制台输入单行 Lua，脚本暂停时可执行表达式。
  • 点击 断开调试 结束当前调试连接。

调试面板会显示 未调试、运行中、已暂停、调试已结束 等状态。只有支持调试的项目和设备才能启动调试；如果提示当前项目不能调试，可以先使用普通运行确认项目入口是否正确。

项目配置​

打开项目后，文本编辑器标题栏会提供 项目配置 入口。这里可以维护项目名称、项目 ID、版本、描述、忽略路径、公共库和样本工作台配置。

修改项目配置后点击 保存。如果只是编辑脚本内容，不需要每次都打开项目配置；只有项目名称、发布信息、资源路径或取色配置需要调整时再进入。

项目产物​

文本编辑器的项目操作中还提供产物生成能力：

  • 加密：生成适合分发或部署的加密产物。完成后会提示保存位置，也可以在项目树或文件管理器中查看、下载。
  • 中控包：把项目打包成可在中控脚本目录中安装和管理的脚本包。该操作只适用于支持打包的项目类型。

生成产物前，建议先保存所有已打开的项目文件，并用开发测试设备完成一次运行验证。

如果按钮不可用，通常是当前标签不属于项目、项目类型不支持该操作，或项目还没有保存到可操作状态。

AI 补全​

AI 补全是文本编辑器的附加能力。开启后，编辑器可以在输入时显示 AI 生成的虚影补全。

要使用它，先在全局设置中完成配置：

  1. 打开 系统配置 → AI 供应商。
  2. 点击 添加配置，填写配置名称、AI 服务、模型和 API Key。使用免密兼容服务时，API Key 可以留空。
  3. 需要确认模型名称时，可以点击 获取模型，也可以手动输入模型名称。
  4. 打开 系统配置 → 文本编辑器。
  5. 在 AI 配置 中选择刚创建的配置。
  6. 开启 AI 补全，再点击 保存设置。

开启后，在适用的文本文件里输入内容时，编辑器会自动显示灰色的补全建议。常用操作：

  • 按 Tab 接受当前建议。
  • 按 Esc 忽略当前建议。
  • 按 Alt + Backslash 手动触发补全。
  • 如果出现多个候选，按 Alt + [ / Alt + ] 切换候选。

可以在 系统配置 → 文本编辑器 里继续调整这些选项：

  • 补全偏好：写入你希望 AI 遵守的代码风格或项目习惯。
  • 适用文件扩展名：限制哪些文件会触发 AI 补全，也可以添加自定义扩展名。
  • 补全上下文：除了当前文件，还可以加入 XXTouch 文档 或 项目文件，让补全更贴近脚本项目。

如果补全没有出现，先检查是否已经添加 AI 供应商配置、是否开启 AI 补全、当前文件扩展名是否在适用范围内，以及模型/API Key 是否可用。打开项目后，如果项目文件刚有较大变化，可以点击 刷新 AI 补全上下文，让补全重新读取当前项目内容。