问题排查指南
本文介绍通过使用 Lingma 排查脚本的方式进行通义灵码插件启动等问题的排查，Lingma 脚本可以在自动收集系统环境信息、网络配置、Lingma 服务状态以及相关日志，以便于快速诊断和解决可能遇到的问题。本文介绍如何使用 Lingma 排查脚本以及如何根据脚本输出排查问题。
前提条件
确认您的系统是 Windows，并且具有管理员权限运行此脚本；
下载并保存windows_lingma.bat脚本为“.bat”文件（例如“Lingma_Debug.bat”）；
确保已将通义灵码按照默认路径（“C:\Users\<YourUsername>\.lingma”）正确安装。
操作步骤
运行脚本：双击保存好的“.bat”文件启动脚本；
查看日志：脚本执行完毕后，会自动打开生成的日志文件。日志路径会显示在命令行窗口中，通常位于脚本同级目录下，名为“Lingma_Log_日期时间.txt”。
问题排查指南
问题类型 | 问题项 | 解决方式 |
网络 | 检查代理设置 | 脚本会查询代理是否启用。通过查看“[网络设置 0x0为未启动代理]”部分，确认是否符合预期，如果有代理则需要在设置中给灵码手动配置代理地址。 |
Lingma 服务状态 | Lingma.exe 存在性 | 脚本首先验证 Lingma.exe 是否存在。若报错，请检查安装路径是否正确，并尝试删除 .lingma 目录重启 ide，重新生成 .lingma 目录。 |
版本与启动测试 | 查看“[version测试]”和“[启动Lingma]”部分，确认 Lingma 版本信息并且可以连接到公网服务器，如果报 failed，请根据报错中的 URL 在设置中配置代理访问公网。 | |
系统兼容性 | 系统与硬件信息 | 脚本收集了操作系统版本和 CPU 型号，检查“[操作系统信息]”部分，确认是否满足 Lingma 的系统要求。目前不支持 aarch64 架构的 Windows 系统。 |
日志分析 | Lingma 应用日志 | 生成的日志文件会记录“lingma.log”的最后80行，有助于识别 Lingma 运行时的具体错误或警告，您可以自行分析日志中的错误。 |
目录结构与文件大小 | 脚本还提供了 Lingma 安装目录的结构和各文件大小，可用于空间占用检查或文件完整性验证。 | |
无法自主排查的问题 | 请进钉钉群“通义灵码公测交流群（答疑请先看群公告）”，群号为： |