故障排除

先从托盘图标入手：其工具提示会显示 Input.Observer 所处的状态（托盘图标），控制台的 系统 部分会说明出了什么问题（查看位置）。

绘制手势时没有任何反应

不显示轨迹，按键的行为就像 Input.Observer 不存在一样。

原因	如何判断	解决方法
Input.Observer 未在运行	没有托盘图标（也请检查隐藏的图标）	从“开始”菜单启动 Input.Observer（无法启动）
它已关闭	工具提示为“i.o - 已禁用”	在托盘菜单中勾选 启用
前台程序暂停了所有功能	工具提示为“i.o - 已自动禁用（…）”并显示组名	该应用程序组打开了 获得焦点时暂停所有功能（应用程序组）
窗口位于忽略组中	只在某些程序中出现	检查 忽略组（忽略组）
安全模式	工具提示为“i.o - 安全模式（重新启动以恢复正常运行）”	不按住 Ctrl 重新启动 Input.Observer（安全模式）
按下了全部停止热键，或同时运行的操作过多	所有功能（包括热键）同时停止	从托盘菜单中选择 重新加载配置（常规）
您按住了忽略的修饰键	只在您按住 Ctrl（默认）时出现	这正是该键的用途（常规）
您使用的按键不是绘制按钮	默认只有右键用于绘制	在 常规 页面的 绘制按钮 中选择按键
指针位于排除区域内	只在屏幕的某个区域出现	检查 排除区域（排除区域）
以管理员身份运行的程序位于前台	只在此类窗口拥有焦点时出现	请参阅以管理员身份运行的程序
窗口不属于任何应用程序组，且 回退到全局 已关闭	只在没有自己组的程序中出现	打开 回退到全局（常规）或添加一个组（作用范围与回退）

绘制了轨迹但没有运行操作，或运行了错误的操作

• 观察提示。 绘制时，提示会显示笔划所匹配的操作名称。没有提示就表示没有匹配。提示和消息列出了它何时出现。
• 笔划与保存的手势不够接近。 多加练习、为其添加另一个示例，或在 手势 页面上让匹配更宽松（匹配）。
• 该操作在这里不适用。 它可能位于另一个应用程序组中、限定于某些屏幕区域、限定于未激活的手势配置方案，或者已关闭（作用范围、配置方案、区域）。
• 操作运行了，但没有可见的效果。 打开控制台：失败的脚本会在 系统 部分中说明原因。操作发送的按键会传给前台窗口；激活手势下方的窗口（常规）会先将您绘制时所在的窗口置于前台。以管理员身份运行的程序可能不接受这些按键（见下文）。
• 手势被取消了。 如果按住按键停顿的时间超过 取消超时（默认为半秒），手势会被取消，按下会传给窗口（常规）。

右键单击感觉迟缓或在某个程序中不起作用

当右键是绘制按钮时，Input.Observer 会暂时保留每次右键按下，直到它知道您是否在绘制。如果您在移动距离未超过 最小手势移动距离（5 像素）时松开，按下和松开会作为普通单击交给窗口。因此：

• 上下文菜单在您松开按键时打开，而不是在按下时打开。这是预期行为。
• 在程序中进行右键拖动（游戏、设计程序、用右键拖动文件）会变成手势。以下任一方法都可以解决：
  • 按下按键时按住 Ctrl（忽略的修饰键）；
  • 按下按键后，在拖动之前保持指针静止达到 取消超时（默认为半秒）：这样按下就会交给程序；
  • 将该程序放入忽略组（不干预某个程序），或仅在其全屏运行时忽略它（忽略组）。
• 远程桌面和虚拟机窗口（远程桌面、Hyper-V、VMware、VirtualBox、TeamViewer、AnyDesk、Parsec）已被入门套件忽略，因此其中的计算机会原样收到右键。

热键不触发

• 另一个程序已在使用该组合键。 向 Windows 保留的热键只能由一个程序占用。该操作会显示“Windows 或其他程序已在使用这些按键”。请选择其他组合键，或关闭另一个程序，然后从托盘菜单中选择 重新加载配置（热键）。
• 热键属于另一个应用程序组。 它只在其组的窗口中有效（如果位于全局组中，则在所有地方有效，除非某个组覆盖了它）。
• 前台窗口被忽略或暂停了所有功能。
• 正在进行手势、宏录制或手势训练。 在此期间热键不会触发。全部停止热键是例外：它总是有效。
• 前台窗口以管理员身份运行（见下文）。
• 处于安全模式，或 Input.Observer 已关闭。 这时不会注册任何热键。

文本扩展在某个程序中不触发

• 文本扩展已关闭，或者应当结束缩写的按键（Space、Tab 或 Enter）未启用：请查看 文本扩展 的 设置 选项卡（文本扩展）。
• 该缩写属于另一个应用程序组，或者该窗口被忽略。
• 该程序以管理员身份运行（见下文）。
• 文本出现乱序或缺少字符。 请增大 脚本 页面上的 键入延迟（脚本设置）。

以管理员身份运行的程序

Windows 不允许普通程序监视或控制以管理员身份运行的程序。使用安装程序安装并从安装文件夹启动的 Input.Observer 被允许与此类程序协作。从其他任何位置启动的副本则不行：当以管理员身份运行的程序拥有键盘焦点时，手势不会开始，您在其中键入的按键不会到达 Input.Observer（因此文本扩展和某些热键不会触发），操作也无法向其发送按键或单击。托盘图标的菜单也可能无法打开。

• 单击任务栏或任何普通窗口，Input.Observer 就会恢复工作。
• 要与管理员程序协作，请使用安装程序安装 Input.Observer，并从“开始”菜单启动它。

Input.Observer 无法启动

您看到的内容	原因	解决方法
“Input.Observer 已在运行。”	另一个副本正在您的会话中运行。	在通知区域中查找其图标。
密码提示，选择 取消 后没有任何反应	您的配置受保护；没有密码就无法启动。	再次启动并输入密码（安全）。
“Input.Observer 无法加载您的配置”	配置文件已损坏或丢失。	选择对话框中的某个选项（恢复）。
许可协议，选择 拒绝 后没有任何反应	必须接受该协议。	再次启动并选择 我接受（关于和许可证）。
“您的 30 天试用期已结束。”	试用期已结束。	输入许可证密钥，或选择 退出（关于和许可证）。
一条提到 Windows 版本的消息	Input.Observer 需要 Windows 10 版本 1809 或更高版本。	更新 Windows。
它能启动，但配置中的某些内容立即挂起或出现异常	配置已加载 事件或某个操作	以安全模式启动并修复它（安全模式）。

配置窗口无法连接

配置窗口需要 Input.Observer 正在运行。

• 打开时显示 “Input.Observer 未运行”：请启动 Input.Observer，然后从其托盘图标打开窗口。
• “配置窗口无法连接到 Input.Observer”：Input.Observer 没有响应。在它运行后选择 重试。
• 窗口状态栏中显示 “无法连接到引擎 — 正在重试”：窗口打开期间 Input.Observer 停止了响应。您的编辑会保留；在它再次响应之前无法保存，窗口会一直重试。如果在此期间关闭带有未保存更改的窗口，保存到文件… 会将这些更改保存在一个文件中供您以后参考；该文件无法导入。
• 大于 8 MB 的配置文件 无法在窗口中打开；Input.Observer 会在启动时对此发出警告。

插件无法启动，或轨迹显示为普通线条

• 当渲染器未在绘制时，外观 页面顶部会说明情况和原因，如果它已停止，还会提供 重新启动（外观）。在此期间，由经典轨迹、提示和消息窗口进行绘制。
• 在 插件 页面上（高级模式），检查插件的状态。对于不是渲染器的绘制插件，未使用 是正常的。已自动禁用——启动失败 和 已被插件关闭 需要 重试（插件）。
• 安全模式下不会运行任何插件。
• 您选择的样式改为绘制 霓虹光晕：说明该样式已被锁定，例如因为许可证发生了变化（外观）。

绘制导致全屏游戏或视频卡顿

打开 在两次手势之间将绘制层保持在窗口后面——对于 Styles 插件在 自定义… 中，对于经典线条在 轨迹选项 选项卡上——或者将游戏放入一个仅在其全屏运行时适用的忽略组（保持轨迹轻量）。

安全模式

安全模式会在不运行任何可能引起问题的内容的情况下启动 Input.Observer，以便您修复配置。

1. 退出 Input.Observer（托盘菜单，退出）。
2. 按住 Ctrl 的同时启动它，并一直按住，直到出现“是否以安全模式启动 Input.Observer？”。
3. 选择 是。

在安全模式下，没有手势、热键或文本扩展，没有插件，您的任何操作以及 配置已加载 / 引擎正在关闭 脚本都不会运行。系统仍会照常要求您输入密码和许可证。托盘图标会显示安全模式，配置窗口可以正常使用，因此您可以更改导致问题的内容并保存。您自己在控制台 脚本 部分中运行的脚本可以运行。

安全模式会一直持续到 Input.Observer 重新启动；在启动时按住 Ctrl 是进入安全模式的唯一方法。

从错误的更改中恢复

• 仍在配置窗口中： 放弃 会恢复自窗口打开以来的所有内容，包括您已应用的更改。
• 某个操作失控： 按全部停止热键，默认为 Ctrl+Shift+Alt+F9（常规）。然后修复该操作并选择 重新加载配置。
• 一启动就出现异常： 使用安全模式。
• 恢复到较早的配置： 从 Backup 文件夹中还原一个副本（备份）。
• 您手动编辑了 config.toml，而“重新加载配置”显示“配置未重新加载”： 之前的配置仍然有效。消息会说明原因：指定行和列处的错误、无法打开的文件、受密码保护的文件，或指向不存在文件的指针（重新加载配置、手动编辑文件）。

查看位置

• 控制台的“系统”部分（托盘菜单，显示控制台）会列出引擎注意到的情况：配置中的问题、失败的操作和脚本及其原因、渲染器不可用。控制台关闭期间到达的行会在您打开它时显示（控制台）。
• 配置窗口 在 Input.Observer 修复了您的配置或对其有建议时，会在保存栏上方显示“引擎关于此配置的 n 条通知”，并附有 显示。
• 您的脚本通过 UtilityPrint 打印的内容 位于控制台的 用户 部分。
• Input.Observer 不写入日志文件。报告错误时，请从 关于 页面复制版本（复制）以及控制台的文本。