故障排除
先从托盘图标入手:其工具提示会显示 Input.Observer 所处的状态(托盘图标),控制台的 系统 部分会说明出了什么问题(查看位置)。
绘制手势时没有任何反应
不显示轨迹,按键的行为就像 Input.Observer 不存在一样。
| 原因 | 如何判断 | 解决方法 |
|---|---|---|
| Input.Observer 未在运行 | 没有托盘图标(也请检查隐藏的图标) | 从“开始”菜单启动 Input.Observer(无法启动) |
| 它已关闭 | 工具提示为“i.o - 已禁用” | 在托盘菜单中勾选 启用 |
| 前台程序暂停了所有功能 | 工具提示为“i.o - 已自动禁用(…)”并显示组名 | 该应用程序组打开了 获得焦点时暂停所有功能(应用程序组) |
| 窗口位于忽略组中 | 只在某些程序中出现 | 检查 忽略组(忽略组) |
| 安全模式 | 工具提示为“i.o - 安全模式(重新启动以恢复正常运行)” | 不按住 Ctrl 重新启动 Input.Observer(安全模式) |
| 按下了全部停止热键,或同时运行的操作过多 | 所有功能(包括热键)同时停止 | 从托盘菜单中选择 重新加载配置(常规) |
| 您按住了忽略的修饰键 | 只在您按住 Ctrl(默认)时出现 | 这正是该键的用途(常规) |
| 您使用的按键不是绘制按钮 | 默认只有右键用于绘制 | 在 常规 页面的 绘制按钮 中选择按键 |
| 程序的应用程序组关闭了 在此处用绘制按钮开始手势 | 只在该组的程序中出现;绘制键在那里仍可绘制 | 在 应用程序组 中打开该开关(高级模式),或用绘制键绘制(应用程序组) |
| 绘制键无法绘制 | 在日语键盘上,Caps Lock 无法用于绘制。在远程桌面或虚拟机窗口上方,远程程序可能会先接收该键 | 在 常规 页面的 绘制键 中选择其他按键(绘制键) |
| 指针位于排除区域内 | 只在屏幕的某个区域出现 | 检查 排除区域(排除区域) |
| 以管理员身份运行的程序位于前台 | 只在此类窗口拥有焦点时出现 | 请参阅以管理员身份运行的程序 |
| 窗口不属于任何应用程序组,且 回退到全局 已关闭 | 只在没有自己组的程序中出现 | 打开 回退到全局(常规)或添加一个组(作用范围与回退) |
| 另一个程序在沙盒程序的窗口位于前台时发送了输入 | 只在另一个程序发送的输入中出现 | 请参阅其他程序发送的输入 |
绘制了轨迹但没有运行操作,或运行了错误的操作
- 观察提示。 绘制时,提示会显示笔划所匹配的操作名称。没有提示就表示没有匹配。提示和消息列出了它何时出现。
- 笔划与保存的手势不够接近。 多加练习、为其添加另一个示例,或在 手势 页面上让匹配更宽松(匹配)。
- 该操作在这里不适用。 它可能位于另一个应用程序组中、限定于某些屏幕区域、限定于未激活的手势配置方案,或者已关闭(作用范围、配置方案、区域)。
- 操作运行了,但没有可见的效果。 打开控制台:失败的脚本会在 系统 部分中说明原因。操作发送的按键会传给前台窗口;激活手势下方的窗口(常规)会先将您绘制时所在的窗口置于前台。以管理员身份运行的程序可能不接受这些按键(见下文)。
- 手势被取消了。 如果按住按键停顿的时间超过 取消超时(默认为半秒),手势会被取消,按下会传给窗口(常规)。
右键单击感觉迟缓或在某个程序中不起作用
当右键是绘制按钮时,Input.Observer 会暂时保留每次右键按下,直到它知道您是否在绘制。如果您在移动距离未超过 最小手势移动距离(5 像素)时松开,按下和松开会作为普通单击交给窗口。因此:
- 上下文菜单在您松开按键时打开,而不是在按下时打开。这是预期行为。
- 在程序中进行右键拖动(游戏、设计程序、用右键拖动文件)会变成手势。以下任一方法都可以解决:
- 远程桌面和虚拟机窗口(远程桌面、Hyper-V、VMware、VirtualBox、TeamViewer、AnyDesk、Parsec)已被入门套件忽略,因此其中的计算机会原样收到右键。
热键不触发
- 另一个程序已在使用该组合键。 向 Windows 保留的热键只能由一个程序占用。该操作会显示“Windows 或其他程序已在使用这些按键”。请选择其他组合键,或关闭另一个程序,然后从托盘菜单中选择 重新加载配置(热键)。
- 热键属于另一个应用程序组。 它只在其组的窗口中有效(如果位于全局组中,则在所有地方有效,除非某个组覆盖了它)。
- 热键使用了绘制键。 在手势有效的地方,按下绘制键会开始手势,因此该热键只在手势无效的地方运行。该操作会显示 此按键是绘制键。请选择其他按键,或在 常规 页面上选择其他绘制键。
- 前台窗口被忽略或暂停了所有功能。
- 正在进行手势、宏录制或手势训练。 在此期间热键不会触发。全部停止热键是例外:它总是有效。
- 前台窗口以管理员身份运行(见下文)。
- 另一个程序在沙盒程序的窗口位于前台时发送了按键(见下文)。
- 处于安全模式,或 Input.Observer 已关闭。 这时不会注册任何热键。
文本扩展在某个程序中不触发
- 文本扩展已关闭,或者应当结束缩写的按键(Space、Tab、Enter 或标点符号)未启用:请查看 文本扩展 的 设置 选项卡(文本扩展)。
- 缩写包含句号、逗号、感叹号或问号,而 按标点符号时展开 已打开:该标点会结束缩写。请在 设置 选项卡中关闭此设置。
- 该缩写属于另一个应用程序组,或者该窗口被忽略。
- 该程序以管理员身份运行(见下文)。
- 打开了日语、中文或韩语输入法。 输入法打开期间不会扩展文本;请将其切换为直接输入(文本扩展)。
- 文本出现乱序或缺少字符。 请增大 脚本 页面上的 键入延迟(脚本设置)。
以管理员身份运行的程序
Windows 不允许普通程序读取发往以管理员身份运行的程序的输入,也不允许控制此类程序。使用安装程序安装并从安装文件夹启动的 Input.Observer 被允许与此类程序协作。从其他任何位置启动的副本则不行:当以管理员身份运行的程序拥有键盘焦点时,手势不会开始,您在其中键入的按键不会到达 Input.Observer(因此文本扩展和某些热键不会触发),操作也无法向其发送按键或单击。托盘图标的菜单也可能无法打开。
- 控制台的 系统 部分会在此类程序首次来到前台时显示其名称,每次运行只显示一次。
- 单击任务栏或任何普通窗口,Input.Observer 就会恢复工作。
- 要与管理员程序协作,请使用安装程序安装 Input.Observer,并从“开始”菜单启动它。便携版始终有此限制。
其他程序发送的输入
由另一个程序代您发送的手势、热键和缩写(AutoHotkey、键盘鼠标共享程序、远程控制程序)与您自己的操作效果相同。例外情况是沙盒程序(Windows 以比普通程序更少的权限运行的程序)的窗口位于前台时:此时 Input.Observer 会将程序发送的输入直接传给该窗口,这样沙盒程序就无法借此运行您的操作。您自己的鼠标和键盘始终有效。单击任何普通窗口,其他程序发送的输入就会恢复有效。
Input.Observer 无法启动
| 您看到的内容 | 原因 | 解决方法 |
|---|---|---|
| “Input.Observer 已在运行。” | 另一个副本正在您的会话中运行。 | 在通知区域中查找其图标。 |
| 密码提示,选择 取消 后没有任何反应 | 您的配置受保护;没有密码就无法启动。 | 再次启动并输入密码(安全)。 |
| “Input.Observer 无法加载您的配置” | 配置文件已损坏或丢失。 | 选择对话框中的某个选项(恢复)。 |
| 许可协议,选择 拒绝 后没有任何反应 | 必须接受该协议。 | 再次启动并选择 我接受(关于和许可证)。 |
| “您的 30 天试用期已结束。” | 试用期已结束。 | 输入许可证密钥,或选择 退出(关于和许可证)。 |
| 一条提到 Windows 版本的消息 | Input.Observer 需要 Windows 10 版本 1809 或更高版本。 | 更新 Windows。 |
| 便携版显示 Windows 已保护你的电脑 | 便携版程序未签名。 | 选择 更多信息,然后选择 仍要运行(便携版)。 |
| 它能启动,但配置中的某些内容立即挂起或出现异常 | 配置已加载 事件或某个操作 | 以安全模式启动并修复它(安全模式)。 |
配置窗口无法连接
配置窗口需要 Input.Observer 正在运行。
- 打开时显示 “Input.Observer 未运行”:请启动 Input.Observer,然后从其托盘图标打开窗口。
- “配置窗口无法连接到 Input.Observer”:Input.Observer 没有响应。在它运行后选择 重试。
- 窗口状态栏中显示 “无法连接到引擎 — 正在重试”:窗口打开期间 Input.Observer 停止了响应。您的编辑会保留;在它再次响应之前无法保存,窗口会一直重试。如果在此期间关闭带有未保存更改的窗口,保存到文件… 会将这些更改保存在一个文件中供您以后参考;该文件无法导入。
- 大于 8 MB 的配置文件 无法在窗口中打开;Input.Observer 会在启动时对此发出警告。
插件无法启动,或轨迹显示为普通线条
- 当渲染器未在绘制时,外观 页面顶部会说明情况和原因,如果它已停止,还会提供 重新启动(外观)。在此期间,由经典轨迹、提示和消息窗口进行绘制。
- 在 插件 页面上(高级模式),检查插件的状态。对于不是渲染器的绘制插件,未使用 是正常的。已自动禁用——启动失败 和 已被插件关闭 需要 重试(插件)。
- 安全模式下不会运行任何插件。
- 您选择的样式改为绘制 霓虹光晕:说明该样式已被锁定,例如因为许可证发生了变化(外观)。
绘制导致全屏游戏或视频卡顿
打开 在两次手势之间将绘制层保持在窗口后面——对于 Styles 插件在 自定义… 中,对于经典线条在 轨迹选项 选项卡上——或者将游戏放入一个仅在其全屏运行时适用的忽略组(保持轨迹轻量)。
安全模式
安全模式会在不运行任何可能引起问题的内容的情况下启动 Input.Observer,以便您修复配置。
- 退出 Input.Observer(托盘菜单,退出)。
- 按住 Ctrl 的同时启动它,并一直按住,直到出现“是否以安全模式启动 Input.Observer?”。
- 选择 是。
在安全模式下,没有手势、热键或文本扩展,没有插件,您的任何操作以及 配置已加载 / 引擎正在关闭 脚本都不会运行。系统仍会照常要求您输入密码和许可证。托盘图标会显示安全模式,配置窗口可以正常使用,因此您可以更改导致问题的内容并保存。您自己在控制台 脚本 部分中运行的脚本可以运行。
安全模式会一直持续到 Input.Observer 重新启动;在启动时按住 Ctrl 是进入安全模式的唯一方法。
从错误的更改中恢复
- 仍在配置窗口中: 放弃 会恢复自窗口打开以来的所有内容,包括您已应用的更改。
- 某个操作失控: 按全部停止热键,默认为 Ctrl+Shift+Alt+F9(常规)。然后修复该操作并选择 重新加载配置。
- 一启动就出现异常: 使用安全模式。
- 恢复到较早的配置: 从
Backup文件夹中还原一个副本(备份)。 - 您手动编辑了
config.toml,而“重新加载配置”显示“配置未重新加载”: 之前的配置仍然有效。消息会说明原因:指定行和列处的错误、无法打开的文件、受密码保护的文件,或指向不存在文件的指针(重新加载配置、手动编辑文件)。
查看位置
- 控制台的“系统”部分(托盘菜单,显示控制台)会列出引擎注意到的情况:配置中的问题、失败的操作和脚本及其原因、渲染器不可用。控制台关闭期间到达的行会在您打开它时显示(控制台)。
- 配置窗口 在 Input.Observer 修复了您的配置或对其有建议时,会在保存栏上方显示“引擎关于此配置的 n 条通知”,并附有 显示。
- 您的脚本通过
UtilityPrint打印的内容 位于控制台的 用户 部分。 - Input.Observer 不写入日志文件。报告错误时,请从 关于 页面复制版本(复制)以及控制台的文本。如果这些不足以找到原因,支持人员可能会请您提供一份跟踪(录制跟踪)。
录制跟踪
跟踪是在您重现问题期间,对引擎所做决定的详细记录:一次按下为什么开始了手势或被传给了窗口、匹配了哪个操作、脚本做了什么、插件为什么停止。为此,安装程序会在 Input.Observer.exe 旁边安装引擎的第二个副本 Input.Observer.Trace.exe;便携版则从 Extras ZIP 获得它。它使用您的配置、许可证和插件,在其他各方面都与 Input.Observer 相同。
- 退出 Input.Observer(托盘菜单,退出)。同一时间只能运行一个副本。
- 打开安装文件夹
C:\Program Files\Input.Observer(便携版则打开它自己的文件夹),然后启动Input.Observer.Trace.exe。 - 在 i.o - 跟踪类别 中选择要录制的区域,然后选择 确定。第一次时,除 输入钩子(非常详细) 之外的所有区域都已勾选;除非支持人员指定了其他区域,否则请保持不变。窗口会记住您的选择,供下次运行使用。
- 重现问题。记下时间,以便轻松找到相关的行。
- 退出跟踪副本(托盘菜单,退出),然后从“开始”菜单再次启动 Input.Observer。
每次运行会在配置文件旁边的 Logs 文件夹中写入文件 Trace-<date>-<time>.log(除非您移动了配置文件,否则为 %APPDATA%\Input.Observer\Logs:配置文件)。文件开头是一段供支持人员查看的简短摘要:Input.Observer 和 Windows 的版本、显示语言、是否以管理员身份运行、配置所在位置以及录制的区域。文件达到 50 MB 时,录制会继续写入 Trace-<date>-<time>-2.log,然后是 -3,依此类推。
- 只选择您需要的区域。 输入钩子(非常详细) 会记录每一次鼠标移动和您按下的每一个键,包括您在密码框中键入的内容。只在支持人员要求时才勾选它,并且在录制期间不要键入任何私密内容。
- 未勾选输入钩子时,跟踪中绝不会包含: 您提供给 Input.Observer 的密码、许可证密钥、文本扩展键入或替换的文本、剪贴板内容、其他程序窗口的标题。程序名称和窗口类名会被记录。
- 分享前请检查。 跟踪是纯文本。其中的文件路径包含您的 Windows 用户名,您的操作、应用程序组和脚本的名称也会出现在其中。在发布或发送之前,请阅读它并删除您不想分享的任何内容。
- 它保留在您的电脑上。 不会发送到任何地方;这些文件由您自行删除。
Logs文件夹保留最新的 20 个跟踪文件:新文件开始时,最旧的文件会被删除,因此请将要保留的跟踪复制到其他位置。 - 下次跳过此窗口: 清除 每次启动时显示此窗口,跟踪副本每次启动时都会录制相同的区域。要再次显示该窗口,请删除配置文件旁边的
trace.toml。 - 不要让它一直运行。 跟踪副本可以正常工作,但会持续写入磁盘,并且勾选 输入钩子(非常详细) 后会迅速写满一个又一个文件。随 Windows 启动 始终启动普通副本。