Windows system troubleshooting guide__Lingma_intelligent coding assistant - AI Coding Assistant Lingma

This topic describes how to use the Lingma script to troubleshoot startup and connectivity issues with Lingma. The script lets you quickly diagnose and resolve potential issues by automatically gathering system environment information, network configurations, the Lingma service status, and related logs.

Before you start

Before running the diagnostic script, ensure the following:

Operating system: Windows
Permissions: Run the script with administrator privileges for full access to system settings and logs.
Script file: Download and save the windows_lingma.bat script as a .bat file (example: Lingma_Debug.bat).
Installation path: Confirm that Lingma is installed in the default directory C:\Users\<YourUsername>\.lingma.

Procedure

Run the script: Double-click the saved .bat file to run the script.
View the log: After the script finishes, the generated log file opens automatically. The log file path is displayed in the command-line window. The log file is typically located in the same folder as the script and named in the format Lingma_Log_Date_Time.txt.

Common issues

Issue type	Issue	Solution
Network	Check proxy settings	The script checks whether a proxy is enabled. Check the [Network settings: 0x0 indicates that no proxy is enabled] section to verify the configuration. If a proxy is enabled, manually configure the network proxy for Lingma in Settings.
Lingma service status	Lingma.exe existence	The script first verifies that Lingma.exe exists. If an error occurs, check whether the installation path is correct. Then, delete the .lingma folder and restart the IDE to regenerate the .lingma folder.
	Version and startup test	Check the "[version test]" and "[start Lingma]" sections to confirm the Lingma version information and its ability to connect to the Internet. If the test fails, use the URL from the error message to configure a proxy in the settings to access the Internet.
	The Lingma.exe process starts but logon is unresponsive	Add the process file to the Windows Firewall whitelist and then retry logging on. The path is C:\Users\xxx\.lingma\bin\2.X.X\x86_64_windows\lingma.exe. You can find the whitelist settings in Control Panel > System and Security > Windows Defender Firewall > Allowed apps.
	An "incompatible program" error is reported	If you use IntelliJ IDEA, this error might be caused by insufficient heap memory, which leads to a decompression failure. To fix this, click the Lingma icon in the lower-right corner, select Advanced Settings, and change the path to a location on a non-C drive that ends with an empty folder. Then, restart IntelliJ IDEA. Note Some companies may lock binary programs, which prevents them from running.
	What to do if the status is "Lingma is starting" (or a startup exception is reported and the service is unresponsive)?	Confirm that your operating system and system architecture are supported. If they are, check for a Lingma process in Task Manager. If no process is found, upgrade Lingma to the latest version and try the following steps: End the Lingma process. Delete the .lingma folder (Windows: C:/Users/[Username]/.lingma; macOS: ~/.lingma). Restart the IDE with administrator permissions. If the issue persists, open a command-line window (cmd) in the .lingma/bin/x.x.x/x86_64_windows/ folder and run `Lingma.exe start`. After running the command, wait for the process to appear in Task Manager, and then try to log on again. Note: If the Windows cmd program is corrupted, Lingma cannot run. If an "incompatible program" error is reported, it is likely due to a decompression failure. This can be caused by insufficient heap memory in IntelliJ IDEA, which leads to logon failure. To fix this, click the Lingma icon in the lower-right corner, select Advanced Settings, and change the path to a location on a non-C drive that ends with an empty folder. Then, restart the IDE. Note: Some companies may lock binary programs, which prevents them from running. If the process still does not appear, or if it appears but logon is unresponsive, add the process file to the Windows Firewall whitelist and then retry logging on. The path is C:\Users\xxx\.lingma\bin\2.1.x\x86_64_windows\lingma.exe. You can find the whitelist settings in Control Panel > System and Security > Windows Defender Firewall > Allowed apps.
System compatibility	System and hardware information	The script collects the operating system version and CPU model. Check the "[Operating system info]" section to confirm that your system meets the requirements for Lingma.
Log analysis	Lingma application log	The generated log file contains the last 80 lines of "lingma.log". This helps identify specific runtime errors or warnings. You can analyze the errors in the log.
	Directory structure and file sizes	The script also provides the structure and file sizes of the Lingma installation folder. Use this information to check disk space usage or verify file integrity.
	Issues beyond self-troubleshooting	Join the DingTalk group `53770000738` (Lingma Public Preview Communication Group), and contact the official support assistant.