跳至主要內容

文字編輯器

文字編輯器用於編輯裝置端腳本專案和一般文字檔案。開啟開發專案後，它還可以連接測試裝置，直接執行、停止、偵錯腳本，並產生加密成果或中控套件。

開啟文字編輯器​

常見入口：

  • 在檔案管理員中按兩下文字檔案，或右鍵檔案後選擇編輯文字。
  • 在裝置清單中右鍵裝置，選擇瀏覽裝置檔案，再開啟裝置上的文字檔案。
  • 在 開發目錄 中右鍵專案資料夾，選擇 開啟專案，再從專案樹中按一下檔案。
  • 在裝置清單中右鍵裝置，建立臨時 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 補全上下文，讓補全重新讀取目前專案內容。