跳到主要内容

# 文本编辑器

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

## 打开文本编辑器​

常见入口：

- 在文件管理器中双击文本文件，或右键文件后选择编辑文本。
- 在设备列表中右键设备，选择浏览设备文件，再打开设备上的文本文件。
- 在 `开发目录` 中右键项目文件夹，选择 `打开项目`，再从项目树中点击文件。
- 在设备列表中右键设备，创建临时 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 补全上下文`，让补全重新读取当前项目内容。