Simulator Controller：AI驱动的模拟赛车自动化控制平台-编程阁

1. 项目概述：你的虚拟AI赛车工程师与策略团队

如果你是一名模拟赛车（Sim Racing）爱好者，那么你肯定对比赛中那些繁琐的操作深有体会：一边要全神贯注地操控方向盘，一边还要分心去调整TC（牵引力控制）、ABS（防抱死刹车系统）、准备进站策略、查看天气预报对轮胎的影响……手忙脚乱之下，一个失误就可能让整场比赛的努力付诸东流。SeriousOldMan开发的“Simulator Controller”项目，正是为了解决这个核心痛点而生。它不是一个简单的宏工具，而是一个集成了人工智能的、模块化的赛车控制与自动化管理平台。

简单来说，Simulator Controller 为你组建了一支虚拟的AI赛车工程师团队。这支团队包括：负责车辆状态监控和进站操作的“比赛工程师”（Race Engineer）、纵观全局制定和调整比赛策略的“策略师”（Race Strategist）、帮你盯防周围车辆避免事故的“观察员”（Race Spotter），以及能分析你的驾驶数据、提供针对性指导的“驾驶教练”（Driving Coach）。所有这些助手都能通过语音与你进行自然对话，让你在比赛中真正做到“手不离盘，眼不离路”。

项目的核心是一个基于 AutoHotkey 构建的强大自动化框架，它能将你的任何硬件控制器——无论是自制的按钮盒（Button Box）、商业化的 Stream Deck，还是方向盘上的多功能按键——映射到复杂的自动化流程上。更重要的是，它通过插件体系深度整合了主流的赛车模拟器（如 ACC、iRacing、rF2、LMU 等）以及周边软件（如 SimHub、SimFeedback），让硬件控制、软件联动和AI决策形成一个闭环。这意味着，你可以用一个按钮触发一连串动作：比如，按下“进站”按钮，AI工程师会自动为你计算最佳进站窗口、设置好轮胎和油量、并在进站前自动降低TC等级。

提示：这个项目的学习曲线并非一马平川。它的强大源于其高度可定制性，因此初期配置需要一些耐心。但一旦搭建完成，它将彻底改变你的模拟赛车体验，从单机练习到多人团队耐力赛，都能获得职业车队般的后台支持。

2. 核心架构与设计哲学解析

2.1 模块化与插件化：一切皆可扩展

Simulator Controller 的设计精髓在于其彻底的模块化。整个系统不像一个 monolithic（单体）应用，而更像一个由许多乐高积木搭建起来的生态系统。这种设计带来了几个关键优势：

硬件无关性：核心框架不关心你用的是哪种按钮盒。它通过抽象的“控制器插件”（如Button Box、Stream Deck插件）来统一管理输入。无论你是用 Arduino 自制的，还是购买的现成产品，只要能被 Windows 识别为游戏控制器或键盘宏设备，就能被整合进来。
模拟器兼容性：对特定模拟器的支持（如读取游戏遥测数据、发送按键指令）也是通过插件实现的。目前官方已支持 ACC、iRacing、rFactor 2、Le Mans Ultimate、Automobilista 2 等主流平台。如果你想支持一个较冷门的模拟器，理论上可以参照现有插件自行开发。
功能解耦：AI工程师、策略师、震动反馈（通过 SimHub）、座椅运动反馈（通过 SimFeedback）等功能都是独立的插件。你可以按需启用或禁用。比如，如果你没有运动平台，完全可以关闭 Motion Feedback 插件，系统依然能正常运行。

这种架构使得项目极具生命力。社区开发者可以为其编写新的插件，而普通用户则可以通过图形化配置工具（Simulator Setup和Simulator Configuration）来组合这些模块，构建属于自己的专属控制中心。

2.2 混合AI引擎：规则系统与LLM的强强联合

项目的另一大亮点是其AI助手的实现方式。它没有单纯依赖时下流行的大语言模型（LLM），而是采用了一种混合架构：一个高效的规则引擎（Rule Engine）作为核心决策层，再辅以LLM来增强自然语言交互能力。

规则引擎（核心）：这是一个基于 RETE 算法（经过优化）的推理系统。你可以把它理解为一个极其复杂且高效的“如果-那么”（If-Then）规则集合。例如，规则可能是：“如果当前燃油量低于10升且距离进站窗口开启还有2圈且天气预报显示3分钟后下雨那么建议车手立即进站并更换雨胎”。规则引擎实时处理来自游戏遥测、计时器、用户输入等渠道的“事实”（Facts），并触发相应的动作（Actions），如语音提示、自动更改车辆设置、准备进站指令等。这种方式响应速度快、决策逻辑透明且稳定，非常适合赛车这种对实时性要求高、逻辑相对固定的场景。
大语言模型（交互层）：为了让与AI助手的对话更自然、更智能，项目引入了“对话增强器”（Conversation Booster）。你可以将助手连接到 OpenAI 的 GPT、Mistral 或本地运行的 Llama 等LLM服务。当用户提出规则引擎预设模式之外的问题时（例如，“工程师，为什么我这圈在T3弯出弯时感觉尾部不稳定？”），问题会被传递给LLM。LLM结合当前的比赛上下文（由规则引擎提供）生成更人性化、更具洞察力的回答。这相当于为严谨的规则系统披上了一层“人情味”的外衣。

这种设计非常务实。规则引擎保证了核心功能（如进站自动化、安全车策略）的可靠性与即时性，而LLM则负责处理开放域的、创造性的对话，两者互补，既强大又灵活。

2.3 数据驱动：从遥测到智能的闭环

所有AI决策和辅助功能都建立在数据之上。Simulator Controller 构建了一个完整的数据采集、存储与分析管道。

实时遥测采集：通过各模拟器插件，系统以高频率采集车辆数据（速度、转速、G值、轮胎温度/磨损、燃油量等）、赛道数据（位置、圈速）以及比赛数据（对手位置、天气变化）。
会话数据库：所有采集的数据都会被结构化地存入本地数据库。这不仅包括单圈数据，还包括完整的比赛事件日志、车辆设置、策略历史等。
分析与应用：
- 策略工作台（Strategy Workbench）：你可以基于历史赛道数据（自己的或队友的），模拟不同进站策略、轮胎选择、天气变化下的比赛结果，从而在赛前制定最优策略。
- 设置工作台（Setup Workbench）：你可以描述车辆的操控问题（如“转向不足”、“刹车时尾部摆动”），AI会分析你的遥测数据，并结合其知识库（或从社区数据中学习），给出具体的车辆调校建议。
- 驾驶教练分析：教练可以对比你的单圈与参考圈（可以是自己的最佳圈速，或导入的高手数据），在弯道中实时或赛后给出改进建议，例如“在5号弯刹车点可以再晚5米，入弯速度可以提高3kph”。
- 团队数据共享：在多人耐力赛中，通过“团队服务器”（Team Server），所有车手的遥测数据、车辆设置、策略信息可以实时共享。策略师可以基于全队数据制定换人策略，工程师可以为正在驾驶的队友远程调整进站设置。

这个数据闭环使得AI助手不再是简单的语音应答机器人，而是真正拥有“经验”和“记忆”的智能体。

3. 核心功能组件深度剖析

3.1 AI赛车助手团队：你的四位虚拟队友

这四位助手各司其职，共同构成了你的比赛智慧中枢。

1. 比赛工程师（Jona）他是你在赛车中的“主理人”。他的工作完全是事件驱动的：

车辆监控：持续监控燃油、轮胎磨损、发动机温度、部件损伤。当任何参数接近危险阈值时，他会主动语音提醒你。
进站自动化：这是他的核心职责。你可以通过语音命令（如“Jona，准备一次进站，换前胎，加50升油”）或硬件按钮来触发。他会自动计算进站的最佳时机（考虑安全车、交通状况），并提前设置好所有进站选项（轮胎选择、胎压、加油量、维修项目）。在支持的游戏（如ACC）中，他甚至能自动操作游戏内的进站菜单。
天气应对：监控实时天气变化，在降雨来临前建议你进站换雨胎，并自动调整雨胎的预设胎压。
与策略师协同：接收来自策略师（Cato）的策略指令，并负责执行。

2. 比赛策略师（Cato）他是团队的“大脑”，专注于宏观比赛形势。

策略制定与模拟：基于当前排名、对手进站情况、剩余比赛时长、轮胎磨损模型和天气预报，实时计算并推荐最优策略（如：一停还是两停？何时进站？用什么轮胎？）。
动态调整：比赛是动态的。一次事故安全车、一个对手的意外进站都会改变局势。Cato 会持续重新评估策略，并通过语音向你汇报调整建议（“安全车出来了，建议我们立即进站，这样可以免费追回大量位置”）。
燃油计算：精确计算完成比赛所需燃油，并考虑赛道状况变化（如下雨导致油耗增加）和安全车时段的影响。

3. 比赛观察员（Spotter）你的“第三只眼”，专注于赛道交通。

超越/被超越提示：比游戏内置的观察员更智能。他可以自定义提示内容和频率（例如，“左侧有车，保持线路”、“后方快车，注意让行”）。
关键区域警告：在事故高发弯道或并排争夺区域给予额外提醒。
基于位置的自动化：这是高级功能。通过“赛道映射”（Track Mapping），你可以定义在赛道的特定区域自动执行某些操作。例如，映射“T1刹车区”，并设置规则：“当车辆进入T1刹车区时，自动将TC（牵引力控制）从5降低到3”。这让你在激烈竞争中无需分心调整设置。

4. 驾驶教练（Aiden）你的私人培训师，不直接参与比赛操作，但致力于提升你的驾驶技术。

知识问答：你可以问他任何关于赛车技术、车辆动力学、赛道技巧的问题。例如，“Aiden，如何纠正转向过度？”、“蒙扎一号弯的刹车参考点是什么？”。
遥测分析教练：这是王牌功能。你可以载入一个参考圈速（可以是自己的目标，或职业高手的幽灵车数据）。当你驾驶时，Aiden 会实时分析你的数据，在每一个弯道通过语音给出具体指导：“T4出弯油门给得太急，损失了0.15秒，尝试更平顺地打开油门。”
专项训练：例如“刹车教练”模式，他会专注于分析你的刹车技巧，指出刹车点早晚、刹车力度曲线等问题。

实操心得：初次使用时，建议先只启用“比赛工程师”和“观察员”。这两个助手能最直接地减轻你的比赛负担。待熟悉他们的交互和配置后，再逐步引入功能更复杂的“策略师”和“驾驶教练”。同时，为每个助手设置独特且易辨的语音（在Windows语音设置中选择不同声音），这样在紧张的比赛中，光听声音你就知道是谁在和你说话。

3.2 硬件整合与控制中心

Simulator Controller 的核心价值之一是将你杂乱的外设统一管理起来。

1. 按钮盒（Button Box）与模式层你的按钮盒可能只有32个物理按钮，但通过“模式”（Modes）概念，你可以拥有数百个功能。

模式切换：你可以定义一个“比赛模式”（控制TC、ABS、雨刮、灯光等）、一个“进站模式”（控制进站选项、燃油设置等）、一个“多媒体模式”（控制音乐音量、语音聊天等）。通过一个特定的模式切换按钮，你可以在不同功能层之间循环。
虚拟可视化：项目提供了一个按钮盒布局编辑器。即使你的物理按钮盒没有屏幕，你也可以在电脑的第二块显示器或一个平板上，显示一个对应的虚拟按钮界面。这个界面会高亮显示当前激活的模式下每个按钮的功能，并且在你按下物理按钮时给出视觉反馈。
自定义脚本：每个按钮的功能不仅限于触发预设命令。通过 AutoHotkey 脚本，你可以编写复杂的逻辑。例如，长按某个按钮2秒，可以执行一系列操作：静音TeamSpeak、暂停模拟器、弹出策略界面。

2. Stream Deck 深度集成对于拥有 Stream Deck 的用户，项目提供了近乎原生的支持。

动态图标与文本：Stream Deck 的每个按键图标和文本都可以根据游戏状态动态变化。例如，显示当前TC等级的按键，其图标颜色和数字会随TC值改变；显示剩余燃油的按键，数字会实时更新。
海量图标库：项目提供了数百个精心设计的图标，覆盖了所有模拟赛车常用功能，无需自己寻找或制作。
多页面支持：类似于按钮盒的“模式”，Stream Deck 也支持多页面（Pages）来扩展功能容量。

3. 第三方软件自动化通过插件，Simulator Controller 可以控制几乎任何赛车相关软件：

SimHub：自动切换仪表盘主题、调整震动反馈强度、控制LED灯带。
SimFeedback：根据比赛事件（如锁死轮胎、上路肩）自动切换运动平台预设。
语音聊天软件：比赛开始前自动启动 TeamSpeak/Discord 并加入指定频道。
OBS：开始录制、切换直播场景。

3.3 高级工具套件：策略、调校与数据分析

1. 策略工作台（Strategy Workbench）这是一个离线的、基于数据的策略模拟器。使用流程如下：

导入数据：从你的“会话数据库”中，导入过去在目标赛道驾驶目标车辆的单圈数据。数据越多、条件越丰富（不同燃油负载、轮胎磨损阶段），模拟越准。
设置参数：定义比赛长度、进站窗口、安全车概率、轮胎性能衰减曲线、不同天气条件下的圈速影响等。
模拟运行：工具会运行蒙特卡洛模拟，生成数十种可能的策略结果。
可视化分析：结果以图表形式展示，清晰对比不同策略（如“一停软胎” vs “两停中性胎”）在比赛结束时的预计名次、与对手的时间差等。
导出与执行：将最优策略导出。比赛时，策略师 Cato 会加载这个策略，并根据实际情况进行微调。

2. 设置工作台（Setup Workbench）车辆调校不再是玄学。这个工具将问题结构化：

描述问题：在界面中选择或描述你遇到的车辆动态问题，例如“高速弯中转向不足”、“刹车时车尾不稳定”。
AI分析：工具会结合以下因素给出建议：
- 你选择的车辆和赛道的基本特性。
- 内置的车辆动力学知识库。
- （可选）从社区共享的类似问题解决方案中学习。
生成建议：输出具体的调校修改建议，例如“将前防倾杆硬度增加2格”、“降低后轮胎压0.1 bar”。
直接应用：对于部分支持的模拟器（如 ACC），你可以直接加载你的车辆设置文件，让工具自动应用修改，然后保存回游戏。

3. 团队中心（Team Center）与服务器这是为多人耐力赛设计的指挥中心。团队服务器（可自建或使用作者提供的公共服务器）作为数据中枢。

状态看板：所有队员都能看到一个实时看板，显示当前车手、剩余燃油、轮胎状况、对手圈速、天气预报等信息。
远程控制：非驾驶队员（如车队经理）可以通过“团队中心”网页或应用，为正在赛道上拼搏的队友远程调整下一次进站的设置，真正做到“云端维修墙”。
数据池：所有车手的遥测数据汇聚在一起，策略师可以为每一位队员制定个性化的策略，并规划最佳的换人时机。

4. 从零开始：安装、配置与初步使用指南

4.1 系统准备与安装避坑

系统要求：

操作系统：Windows 10 或 11（64位）。由于核心基于 AutoHotkey，目前不支持 macOS 或 Linux。
硬件：建议至少8GB内存。如果计划运行本地LLM（如通过Ollama集成驾驶教练），则需要更强的CPU和至少16GB内存，甚至需要支持CUDA的NVIDIA显卡以获得较好体验。
必备运行库：安装程序通常会自动安装，但为确保无误，可手动安装最新版的 .NET Desktop Runtime 和 AutoHotkey v2 。

安装步骤：

下载：从项目GitHub的 Release 页面或使用提供的自动安装器Simulator Controller.exe下载最新稳定版。
杀毒软件警告：这是最关键的一步！AutoHotkey 脚本的一些自动化行为（如模拟键鼠操作）可能被误报为病毒。你需要在杀毒软件（如 Windows Defender）中为 Simulator Controller 的安装目录（例如C:\Simulator Controller）和其用户数据目录（通常位于文档\Simulator Controller）添加排除项/信任项。否则，关键文件可能会被误删，导致程序无法运行。
运行安装向导：解压后，运行Binaries文件夹下的Simulator Tools.exe。首次运行会启动配置向导（Simulator Setup）。
基础配置：向导会引导你完成：
- 选择主要游玩的模拟器（例如 Assetto Corsa Competizione）。
- 配置语音识别和合成引擎（建议使用 Windows 自带的，兼容性最好）。
- 设置你的玩家名称和偏好语言。

注意事项：强烈建议将 Simulator Controller 安装在非系统盘（非C盘）且路径中不要包含中文或特殊字符的目录下。这可以避免许多因权限和路径解析导致的潜在问题。安装完成后，不要急于连接所有硬件，先完成软件的基础配置。

4.2 核心配置工具详解

配置主要通过两个图形化工具完成，它们分工明确：

1. Simulator Setup（设置向导）这是面向新手的、任务导向的配置工具。它通过一系列清晰的步骤，帮你搭建起一个可用的基础框架。

模拟器配置：设置游戏执行文件路径、遥测数据共享内存名称（对于ACC等）或UDP端口（对于iRacing等）。
助手配置：逐个启用并配置AI助手。你可以在这里为每个助手选择不同的语音、调整语音响应的敏感度、设置唤醒词（如果需要）。
硬件连接：检测并配置你的按钮盒或 Stream Deck。对于常见设备，它可能提供预设的布局文件。
插件管理：启用或禁用你需要的插件（如 SimHub 控制、Motion Feedback 等）。

2. Simulator Configuration（高级配置）这是一个功能更全面、更底层的配置编辑器。当Simulator Setup无法满足你的高级定制需求时，就需要用它。

应用程序池：管理所有关联的应用程序（游戏、SimHub、Discord等）的启动顺序、参数和依赖关系。
事件与动作：这里是自动化逻辑的核心。你可以创建复杂的事件触发器（如“当游戏启动时”、“当圈速刷新时”、“当燃油低于10%时”）并关联一系列动作（如“启动TeamSpeak”、“切换按钮盒模式”、“播放提示音”）。
变量与状态：定义全局或会话变量，用于在不同插件和助手间传递信息。
脚本编辑器：直接编写或修改 AutoHotkey 脚本，实现高度自定义的逻辑。

配置顺序建议：

先用Simulator Setup完成90%的基础配置，确保核心功能（游戏连接、基础语音）能跑通。
进入游戏，进行一次简单的练习，确认遥测数据能被正确读取（可以通过内置的监控工具查看）。
再使用Simulator Configuration进行精细调整，例如创建复杂的按钮映射、编写自定义的语音命令响应。

4.3 首次实战：连接硬件与测试语音

假设你已经完成了软件的基础配置，接下来让硬件和语音动起来。

连接按钮盒/Stream Deck：

在Simulator Setup的硬件配置部分，选择你的设备类型。
如果是通用按钮盒，你需要手动映射每个物理按钮对应的“按键编号”。可以使用 Windows 的“设置 -> 游戏控制器”属性来测试每个按钮的编号。
加载或创建一个布局（Layout）。可以从社区下载现成的布局文件（.json格式），或使用内置的布局编辑器从头创建。
为布局分配“模式”。例如，将默认布局分配给“模式1”（比赛模式）。

测试语音交互：

确保你的麦克风工作正常，Windows 语音识别服务已开启。
启动 Simulator Controller 核心服务（通常通过Simulator Tools中的启动项）。
启动你的模拟器游戏。
在游戏中，尝试说出预设的唤醒词或直接命令。例如，在 ACC 中，你可以直接说：“Jona, box this lap.”（Jona，这圈进站）。你应该能听到AI工程师的语音确认，并在游戏界面上看到进站准备开始的提示。
如果语音无响应，检查：
- Simulator Controller的系统托盘图标是否显示为绿色（运行中）。
- 在Simulator Configuration中，确认对应助手的插件已启用，且语音输入/输出设备选择正确。
- 查看Logs文件夹下的日志文件，通常会有详细的错误信息。

5. 高级技巧与深度定制

5.1 打造个性化的语音命令与交互

虽然内置了大量命令，但真正的威力在于自定义。

1. 创建自定义语音命令：在Simulator Configuration中，导航到对应助手（如 Race Engineer）的插件配置部分，找到“语音命令”或“自定义触发器”。

命令模式：使用简单的模式匹配。例如，你可以添加一个模式：*fuel*。这样，当你说“Jona，报告燃油情况”或“还剩多少燃油？”时，只要包含“fuel”关键词，就会触发报告燃油剩余量的动作。
关联动作：一个命令可以触发多个动作。例如，自定义命令“红色警报”可以关联：1) 播放一段警报音效；2) 在屏幕上闪烁红色警告信息；3) 自动将按钮盒背光调为红色。

2. 集成GPT，让对话更智能：

在配置中，找到“Conversation Booster”或“LLM Integration”部分。
输入你的 OpenAI API 密钥（或其他兼容LLM服务的密钥）。注意保管密钥安全，不要泄露。
配置使用场景。例如，你可以设置：只有当用户的问题超出基础规则库范围时，才将问题转发给GPT；或者，让驾驶教练的所有回答都经过GPT润色，使其更像真人教练。
你可以为GPT提供“角色设定”和“知识背景”。例如，给驾驶教练Aiden的设定是：“你是一位拥有20年F1车队经验的资深性能工程师，擅长以简洁、直接、充满鼓励的方式指导车手。请用中文回答。”

5.2 利用赛道映射实现自动化

赛道映射（Track Mapping）是一个改变游戏体验的高级功能。它允许你根据车辆在赛道上的精确位置来触发动作。

创建赛道映射的步骤：

数据录制：在目标赛道上驾驶一圈，系统会自动记录你的GPS位置数据。
定义区域：在“赛道映射编辑器”中，加载录制的数据。然后，在赛道地图上，你可以用鼠标划分出不同的区域，例如：“主直道”、“T1刹车区”、“T2弯心”、“T3出弯区”等，并为每个区域命名。
创建自动化规则：在Simulator Configuration的事件系统中，创建新事件。
- 触发器：选择“车辆进入区域 [区域名称]”。
- 动作：可以是一系列操作，例如：
  - 设置车辆TC等级为 2。
  - 播放语音提示：“进入高速弯，注意路肩”。
  - 向SimHub发送指令，将仪表盘切换为“弯道显示”模式。
测试与校准：在测试模式下缓慢行驶，确保车辆进入和离开区域时，动作能被准确触发。

这个功能特别适用于那些需要频繁调整的设置。例如，在摩纳哥赛道，你可以设置进入游泳池弯（Swimming Pool）区域时自动大幅降低TC，以获得更灵活的过弯响应，出弯后再自动恢复。

5.3 为团队耐力赛搭建服务器

如果你想和朋友们进行严肃的团队耐力赛，自建团队服务器是必由之路。

基础搭建流程：

选择服务器：你可以使用一台闲置的旧电脑，或购买一台低配的VPS（虚拟私人服务器）。Simulator Controller 的团队服务器对资源要求不高。
安装服务器软件：在服务器上，同样安装 Simulator Controller，但在配置时选择“服务器模式”。
配置网络：在路由器上为服务器电脑设置端口转发（默认端口需参考文档），或者使用内网穿透工具（如 frp、ngrok）如果你没有公网IP。务必设置强密码，并考虑使用VPN确保连接安全。
客户端连接：在所有队员的 Simulator Controller 客户端配置中，填入服务器的IP地址和端口。
数据同步测试：创建一场测试团队赛，检查遥测数据、聊天信息、策略指令是否能实时同步。

服务器管理技巧：

定期备份：定期备份服务器上的数据库和配置文件。
权限管理：可以为不同队员分配不同角色（如车手、工程师、车队经理），控制其远程操作权限。
日志监控：服务器日志有助于排查连接问题和数据同步故障。

6. 故障排除与常见问题实录

即使配置再仔细，也难免会遇到问题。以下是一些常见问题及其排查思路。

问题现象	可能原因	排查步骤与解决方案
AI助手无语音响应	1. 语音合成服务未启动或配置错误。 2. 对应助手的插件未启用。 3. 麦克风权限未授予或语音识别失败。	1. 检查 Windows 语音设置，确保首选语音合成设备正常。在`Simulator Configuration`中测试语音播放。 2. 在`Simulator Tools`的应用管理器中，确认`Race Engineer`等插件进程正在运行。 3. 运行 Windows 语音识别训练，提高识别率。检查麦克风是否被其他应用独占。
游戏遥测数据无法读取	1. 游戏插件未正确配置或选择错误。 2. 游戏内的遥测共享功能未开启。 3. 防火墙/杀毒软件阻止了内存或网络访问。	1. 确认在`Simulator Setup`中选择了正确的模拟器，并指定了正确的游戏执行文件路径。 2. 对于 ACC，需在游戏设置中启用“共享内存”；对于 iRacing，需配置正确的 UDP 端口和地址。 3. 将 Simulator Controller 相关程序添加到防火墙白名单。彻底关闭杀毒软件实时防护进行测试。
按钮盒/Stream Deck 按键无反应	1. 硬件未被系统识别或驱动问题。 2. Simulator Controller 中设备未正确配置或布局未加载。 3. 按键映射冲突。	1. 在 Windows “设备管理器”和“设置->游戏控制器”中确认设备被识别且所有按钮有输入信号。 2. 在`Simulator Configuration`的硬件配置部分，重新检测设备并加载正确的布局文件。 3. 检查是否有其他软件（如游戏本身、JoyToKey）占用了相同的控制器输入。
“Simulator Tools” 启动时报错或闪退	1. 运行库缺失（.NET, AutoHotkey）。 2. 配置文件损坏。 3. 安装目录权限不足。	1. 重新安装最新版 .NET Desktop Runtime 和 AutoHotkey v2。 2. 尝试重命名`文档\Simulator Controller`文件夹（作为备份），然后重新启动配置向导，生成全新配置。 3. 以管理员身份运行程序，或将整个安装目录移动到非系统盘的非受控文件夹。
团队服务器无法连接	1. 服务器IP/端口错误。 2. 客户端/服务器防火墙阻止连接。 3. 服务器未正常运行。	1. 在服务器上使用`ipconfig`获取本地IP，并在路由器设置端口转发。客户端使用公网IP:端口连接。 2. 在服务器和客户端防火墙中为 Simulator Controller 程序添加入站/出站规则。 3. 登录服务器，检查`Simulator Controller Server`服务是否启动，查看服务器日志文件。
自定义脚本/插件不生效	1. 脚本语法错误。 2. 插件未正确放置或启用。 3. 脚本依赖的变量或事件不存在。	1. 使用`Simulator Tools`中的日志查看器，过滤错误信息。AutoHotkey 脚本错误通常会在这里显示。 2. 自定义插件应放在`Plugins`子目录下，并在`Simulator Configuration`的插件管理中启用它。 3. 仔细检查脚本中引用的动作名称、变量名是否与核心系统定义的一致，大小写敏感。

调试黄金法则：

查看日志：Logs文件夹下的日志文件是首要排查工具。设置日志级别为“Debug”或“Trace”可以获得最详细的信息。
简化测试：当出现复杂问题时，关闭所有非核心插件和助手，只保留最基本的游戏连接和按钮输入，逐步添加功能，定位问题模块。
利用社区：项目的 Discord 社区非常活跃。提问时，最好附上相关的日志片段和你的配置截图，能极大提高获得帮助的效率。

Simulator Controller 是一个庞大而精密的工具，初次接触可能会感到 overwhelming。但请记住，你不需要一次性掌握所有功能。从“让工程师帮你进站”这个单一目标开始，逐步探索，每解锁一个新功能，你的模拟赛车体验就会更沉浸、更专业一分。它最终带给你的，不仅是成绩的提升，更是那种置身于真实车队中、被专业团队支持的独特沉浸感。