需要什么帮助？

QGIS 插件无法加载

现象：没有 Tractrix 菜单或工具栏，或处理工具箱中没有 Tractrix 提供程序。

1. 在帮助 → 关于中检查 QGIS 版本：需要 3.34 或更高版本。
2. 打开插件 → 管理并安装插件 → 已安装，确认已勾选 Tractrix for QGIS (OpenAirside)。
3. 如果 ZIP 是您自己打包的，其顶层必须是 openairside/ 文件夹，且其中包含 metadata.txt——而不是整个代码仓库。
4. 打开视图 → 面板 → 日志消息，查看 Python error 和 Plugins 选项卡。将任何回溯信息复制到缺陷报告中。
5. 如果处理工具箱完全不见，请启用核心插件 Processing。

AutoCAD 或 Revit 中提示“Engine not found”

现象：TX 命令中止，提示“The Tractrix engine (tractrix-engine) was not found”，并列出已搜索的路径。

使用本地引擎时，插件会在以下位置查找 tractrix-engine：TXSETTINGS 中设置的路径；TRACTRIX_ENGINE 环境变量；%ProgramData%\Tractrix\engine\；插件的 engine 文件夹；以及 PATH。

1. 重新安装插件：安装程序会将内置引擎放入插件的 engine 文件夹。
2. 如果杀毒软件隔离了 tractrix-engine.exe，请将其恢复并添加例外。
3. 如果您用 pip 安装了引擎，请在 TXSETTINGS 或 TRACTRIX_ENGINE 中设置其完整路径。
4. 或者在 TXSETTINGS 中切换到 Cloud 引擎。

转向超限详解

现象：类型为 steering_limit 的问题，数值高于限值。

要沿您的线行进，前轮需要转过的角度超出了该航空器的最大转向角。引擎根据航向沿路径变化的快慢计算转角，δ = arctan(L dθ/ds)，并标出最不利点。通常意味着弯道对该机型过急，或线上有折点。

1. 检查线上是否有尖锐顶点或数字化产生的短小锯齿；用半径合理的圆弧替代转角。
2. 与转弯半径与 180°转弯工具给出的该机型最小转弯半径进行比较。
3. 检查机型库中的 steer_source：若使用的是默认限值（60° 或 65°），请查找制造商数值并作为覆盖值输入。
4. 推出时的限值是牵引转向限制，而非航空器的转向角限制。

边缘余量超限详解

现象：类型为 edge_margin 的问题，或最小边缘余量为负值。

主起落架外侧轮胎与道面边缘的距离小于标准规定的轮缘净距——例如国际民航组织对 A320 要求 3 m。负值表示轮胎驶出了道面。在弯道中，这通常是主起落架向弯内切入所致：道面需要增补面。

1. 确认使用了正确的跟踪点：滑行道设计应使用驾驶舱。
2. 确认道面图层覆盖整条路线，并且是有效的面。
3. 运行滑行道增补面 / 所需道面，绘制航空器所需的道面。
4. 检查从跟踪点位于线上时开始，因此最初几米不做检查。

坐标系与地理坐标输入

现象：结果位置或大小错误，或包络只有几厘米。

• QGIS：地理坐标系（以度为单位，如 EPSG:4326）下的图层会在当地 UTM 带中计算，输出也写入该 UTM 坐标系。QGIS 会实时重投影；如需精确作业，请整个项目使用以米为单位的投影坐标系。
• 以英尺为单位的投影坐标系按非米制处理，同样在 UTM 中计算。
• CAD：设置图形单位（INSUNITS）。无单位图纸使用每单位米数设置。
• Cloud：GeoJSON 必须为平面米制；DXF 单位从 $INSUNITS 读取，无单位的 DXF 按米读取并给出警告。

Cloud 登录和令牌问题

现象：无法登录、验证链接已过期，或 API 返回 401、402、403 或 503。

• 验证链接已过期（24 小时后）：在登录页面重新申请。密码重置链接有效期为 60 分钟。
• 尝试次数过多：登录有频率限制；请等待一分钟后重试。
• 401：令牌错误、已撤销或已过期。请新建令牌；令牌以 tx_ 开头。可用 GET /api/v1/whoami 检查。
• 403“Viewers cannot run simulations”：请管理员授予成员角色。
• 402：组织已达到方案限额；消息中会指明是哪一项。
• 503 繁忙：按 Retry-After 中的秒数稍后重试。504：仿真超过 30 s；请缩短路径或改用网页运行。
• 在 CAD 中，在另一台计算机或另一个 Windows 账户下保存的令牌无法解密：请在 TXSETTINGS 中重新粘贴。