Texteditor
Der Texteditor bearbeitet Geräteskriptprojekte und normale Textdateien. Nach dem Öffnen eines Entwicklungsprojekts kann er außerdem ein Testgerät verbinden, Skripte ausführen, stoppen und debuggen sowie verschlüsselte Artefakte oder Zentralenpakete erzeugen.
Texteditor öffnen
Häufige Einstiege:
- Doppelklicken Sie im Dateimanager auf eine Textdatei oder wählen Sie nach einem Rechtsklick die Textbearbeitung.
- Klicken Sie in der Geräteliste mit der rechten Maustaste auf ein Gerät, durchsuchen Sie die Gerätedateien und öffnen Sie dort eine Textdatei.
- Klicken Sie im
开发目录mit der rechten Maustaste auf einen Projektordner, wählen Sie打开项目und klicken Sie anschließend im Projektbaum auf eine Datei. - Klicken Sie in der Geräteliste mit der rechten Maustaste auf ein Gerät und erstellen Sie eine temporäre Lua-Datei, um einen kurzen Skriptabschnitt schnell zu testen.
Häufige Bearbeitungsaktionen
- Klicken Sie auf
保存, um die aktuellen Änderungen in die Datei zu schreiben. - Klicken Sie auf
重新读取, um den Dateiinhalt am ursprünglichen Speicherort erneut zu laden. - Klicken Sie mit der rechten Maustaste auf einen Tab, um die Datei im Dateimanager anzuzeigen, umzubenennen oder ihren Pfad zu kopieren.
- Die Statusleiste unten zeigt Zeile/Spalte, Einrückung, Kodierung, Zeilenende und Dateityp. Lassen Sie im Zweifel die Standardwerte bestehen.
- Mit der Minimap-Schaltfläche können Sie die Code-Minimap rechts ein- oder ausblenden.
Wenn eine Datei nach dem Öffnen durch einen anderen Vorgang geändert wurde, erscheint beim Speichern eine Überschreibbestätigung. Beim erneuten Laden oder Schließen eines ungespeicherten Tabs wird ebenfalls vor möglichem Datenverlust gewarnt.
Entwicklungstestgerät festlegen
Wählen Sie vor Online-Ausführung und Debugging ein Entwicklungstestgerät aus. Das Gerät muss importiert, online und über XXTouch erreichbar sein; Offline-Geräte können weder Dateien durchsuchen noch ausführen oder debuggen.
Häufige Einstiege:
- Klicken Sie in der Geräteliste mit der rechten Maustaste auf das Zielgerät und wählen Sie
设为开发测试设备. - Klicken Sie oben links im Texteditor auf die Geräteschaltfläche, öffnen Sie
选择测试设备und wählen Sie das Zielgerät.
Wählen Sie zum Wechseln ein anderes Gerät aus. Wenn die Verbindung nicht mehr benötigt wird, klicken Sie an derselben Stelle auf 断开测试.
Online ausführen
Öffnen Sie ein Entwicklungsprojekt oder eine darin enthaltene Datei, klicken Sie auf Ausführen und lesen Sie die Ausgabe im Protokollbereich darunter.
Ausführbar sind normalerweise Skriptdateien in einem Entwicklungsprojekt oder direkt ausführbare .lua-Dateien. Bei normalen Textdateien, unbekannten Projekten oder Projekten ohne Einstieg erscheint 当前文件不能运行.
Klicken Sie zum Beenden des Skripts auf 停止.
Online debuggen
Klicken Sie auf 调试, um das Projekt im Debugmodus zu starten. So lassen sich Variablen, Stackframes und Verzweigungen während der Ausführung untersuchen.
Häufige Aktionen:
- Setzen oder entfernen Sie Breakpoints im Zeilennummernbereich links im Editor.
- Steuern Sie die Ausführung mit
继续,单步,进入und跳出. - Sehen Sie im Aufrufstapel, in welcher Funktion das Skript angehalten ist. Durch Anklicken eines Eintrags springt der Editor dorthin.
- Prüfen Sie im Variablenfenster die am Haltepunkt sichtbaren Variablen. Per Rechtsklick können Sie Werte kopieren oder ändern.
- Geben Sie im Debugkonsolenfenster eine einzelne Lua-Zeile ein und werten Sie sie bei angehaltenem Skript aus.
- Klicken Sie auf
断开调试, um die aktuelle Debugverbindung zu beenden.
Projektkonfiguration
Nach dem Öffnen eines Projekts bietet die Titelleiste des Texteditors 项目配置. Dort können Sie Projektname, Projekt-ID, Version, Beschreibung, ignorierte Pfade, gemeinsam genutzte Bibliotheken und Sample-Workbench-Einstellungen pflegen.
Klicken Sie nach Änderungen an der Projektkonfiguration auf 保存. Für reine Skriptänderungen müssen Sie die Konfiguration nicht jedes Mal öffnen; verwenden Sie sie nur für Projektname, Veröffentlichungsdaten, Ressourcenpfade oder Pipetteneinstellungen.
Projektartefakte
Die Projektaktionen des Texteditors bieten außerdem die Artefakterzeugung:
加密: erzeugt ein verschlüsseltes Artefakt für Verteilung oder Bereitstellung. Nach Abschluss wird der Speicherort angezeigt; Sie können es auch im Projektbaum oder Dateimanager anzeigen und herunterladen.中控包: paketiert das Projekt als Skriptpaket zur Installation und Verwaltung im Skriptverzeichnis der Zentrale. Dies ist nur für unterstützte Projekttypen verfügbar.
Speichern Sie vor der Artefakterzeugung alle geöffneten Projektdateien und prüfen Sie den Lauf einmal mit dem Entwicklungstestgerät.
KI-Autovervollständigung
Die KI-Autovervollständigung ist eine optionale Funktion des Texteditors. Nach der Aktivierung zeigt der Editor beim Tippen von der KI erzeugte Geistervorschläge.
Konfigurieren Sie sie zuerst in den globalen Einstellungen:
- Öffnen Sie
系统配置 → AI 供应商. - Klicken Sie auf
添加配置und geben Sie Profilname, KI-Dienst, Modell und API Key ein. Bei kompatiblen schlüssellosen Diensten kann der API Key leer bleiben. - Klicken Sie bei Bedarf auf
获取模型, um Modellnamen abzurufen, oder geben Sie den Namen manuell ein. - Öffnen Sie
系统配置 → 文本编辑器. - Wählen Sie das soeben erstellte Profil unter
AI 配置aus. - Aktivieren Sie
AI 补全und klicken Sie auf保存设置.
Wenn der Dienst eine bestimmte Client-Kennung oder zusätzliche Anfrage-Header erfordert, füllen Sie beim Hinzufügen oder Bearbeiten eines KI-Profils die Felder User-Agent und Benutzerdefinierte Header unter dem API Key aus. Geben Sie pro Zeile ein Paar Name: Wert ein, zum Beispiel X-Custom-Header: value. Diese Optionen gelten auch beim Abrufen der Modelle. Lassen Sie die Felder leer, wenn keine zusätzliche Konfiguration erforderlich ist.
Header-Name für die Sitzungs-ID ist standardmäßig session-id. Tragen Sie bei Bedarf den vom Dienst verlangten Namen ein, etwa x-opencode-session für OpenCode Go. Ein ID-Wert ist nicht erforderlich; ein leeres Feld deaktiviert die Funktion.
Nach der Aktivierung zeigt der Editor beim Tippen in unterstützten Textdateien graue Vorschläge an. Häufige Aktionen:
- Drücken Sie
Tab, um den aktuellen Vorschlag zu übernehmen. - Drücken Sie
Esc, um den aktuellen Vorschlag zu verwerfen. - Drücken Sie
Alt + Backslash, um die Vervollständigung manuell auszulösen. - Bei mehreren Vorschlägen wechseln Sie mit
Alt + [/Alt + ]zwischen ihnen.
Diese Optionen können Sie unter 系统配置 → 文本编辑器 weiter anpassen:
补全偏好: Beschreiben Sie den Codestil oder die Projektgewohnheiten, die die KI befolgen soll.适用文件扩展名: Legen Sie fest, welche Dateitypen die KI-Autovervollständigung auslösen, und fügen Sie eigene Erweiterungen hinzu.补全上下文: Beziehen Sie neben der aktuellen DateiXXTouch 文档oder项目文件ein, damit Vorschläge besser zum Skriptprojekt passen.
Wenn keine Vorschläge erscheinen, prüfen Sie, ob ein KI-Anbieterprofil hinzugefügt und AI 补全 aktiviert ist, ob die Dateierweiterung zulässig ist und ob Modell/API Key funktionieren. Nach größeren Projektänderungen können Sie 刷新 AI 补全上下文 anklicken, damit die Vervollständigung den Projektinhalt neu einliest.