問題排查指南
本文介紹通過使用 Lingma 排查腳本的方式進(jìn)行通義靈碼插件啟動等問題的排查，Lingma 腳本可以在自動收集系統(tǒng)環(huán)境信息、網(wǎng)絡(luò)配置、Lingma 服務(wù)狀態(tài)以及相關(guān)日志，以便于快速診斷和解決可能遇到的問題。本文介紹如何使用 Lingma 排查腳本以及如何根據(jù)腳本輸出排查問題。
前提條件
確認(rèn)您的系統(tǒng)是 Windows，并且具有管理員權(quán)限運(yùn)行此腳本；
下載并保存windows_lingma.bat腳本為“.bat”文件（例如“Lingma_Debug.bat”）；
確保已將通義靈碼按照默認(rèn)路徑（“C:\Users\<YourUsername>\.lingma”）正確安裝。
操作步驟
運(yùn)行腳本：雙擊保存好的“.bat”文件啟動腳本；
查看日志：腳本執(zhí)行完畢后，會自動打開生成的日志文件。日志路徑會顯示在命令行窗口中，通常位于腳本同級目錄下，名為“Lingma_Log_日期時間.txt”。
問題排查指南
問題類型 | 問題項 | 解決方式 |
網(wǎng)絡(luò) | 檢查代理設(shè)置 | 腳本會查詢代理是否啟用。通過查看“[網(wǎng)絡(luò)設(shè)置 0x0為未啟動代理]”部分，確認(rèn)是否符合預(yù)期，如果有代理則需要在設(shè)置中給靈碼手動配置代理地址。 |
Lingma 服務(wù)狀態(tài) | Lingma.exe 存在性 | 腳本首先驗證 Lingma.exe 是否存在。若報錯，請檢查安裝路徑是否正確，并嘗試刪除 .lingma 目錄重啟 ide，重新生成 .lingma 目錄。 |
版本與啟動測試 | 查看“[version測試]”和“[啟動Lingma]”部分，確認(rèn) Lingma 版本信息并且可以連接到公網(wǎng)服務(wù)器，如果報 failed，請根據(jù)報錯中的 URL 在設(shè)置中配置代理訪問公網(wǎng)。 | |
系統(tǒng)兼容性 | 系統(tǒng)與硬件信息 | 腳本收集了操作系統(tǒng)版本和 CPU 型號，檢查“[操作系統(tǒng)信息]”部分，確認(rèn)是否滿足 Lingma 的系統(tǒng)要求。目前不支持 aarch64 架構(gòu)的 Windows 系統(tǒng)。 |
日志分析 | Lingma 應(yīng)用日志 | 生成的日志文件會記錄“l(fā)ingma.log”的最后80行，有助于識別 Lingma 運(yùn)行時的具體錯誤或警告，您可以自行分析日志中的錯誤。 |
目錄結(jié)構(gòu)與文件大小 | 腳本還提供了 Lingma 安裝目錄的結(jié)構(gòu)和各文件大小，可用于空間占用檢查或文件完整性驗證。 | |
無法自主排查的問題 | 請進(jìn)釘釘群“通義靈碼公測交流群（答疑請先看群公告）”，群號為： |