配置文件
您在配置窗口中设置的所有内容都保存在一个文件 config.toml 中。Input.Observer 在启动时以及每次应用更改时都会读取它。您永远不需要接触它：配置窗口会替您读写它。本页适用于您想知道它在哪里、将其保存在其他位置、恢复它或手动编辑它的情况。
位置
Input.Observer 按以下顺序查找 config.toml：
- 程序旁边，即包含
Input.Observer.exe的文件夹。如果那里有config.toml，Input.Observer 就使用它——从 U 盘运行的副本就是这样随身携带其设置的。 - 否则在 您的用户配置文件 中：
%APPDATA%\Input.Observer\config.toml。
如果该文件只包含指向另一个文件的指针，Input.Observer 会使用那个文件（见下文“将配置保存在其他位置”）。
要打开该文件夹，请从托盘菜单中选择 打开配置文件夹。在高级模式下，常规 页面的 配置文件 卡片会显示正在使用的文件以及它是否已加密，在文件夹中显示 会在文件资源管理器中显示它。
以下文件位于 config.toml 旁边，并始终与它在一起：
| 文件或文件夹 | 内容 |
|---|---|
license.dat | 您的许可证电子邮件地址和密钥 |
console.toml | 控制台脚本编辑器中的文本和窗口位置 |
gesture_profile.dat | 哪个手势配置方案处于活动状态 |
storage.toml | 脚本在多次运行之间存储的值 |
styles.toml | Styles 插件的设置（其他插件也可能在这里保存自己的文件） |
Backup\ | config.toml 的自动备份（见下文“备份”） |
Recordings\ | 保存的宏录制 |
Entitlements\ | 样式购买文件（外观） |
备份
每次 Input.Observer 退出时，它都会将 config.toml 复制到其旁边的 Backup 文件夹中——但前提是配置自最新备份以来确实发生了更改。注释、空白和条目顺序不算作更改。会保留最新的 10 个备份；更旧的备份会被删除。
- 备份名称包含 UTC 日期和时间，例如
config.20260923T180512Z.toml，因此按名称排序就是按时间排序。每个备份旁边都有一个.sha256文件，Input.Observer 用它来判断是否有任何更改。 - 受保护配置的备份会保持加密状态，使用当时所用的密码。当您设置密码时，纯文本备份会被删除（安全）。
- 要恢复到某个备份，请关闭 Input.Observer（托盘菜单，退出），将该备份复制并以
config.toml为名覆盖原文件，然后重新启动 Input.Observer。
文件无法加载时
如果 config.toml 存在但无法读取——它无效，或者它指向的文件不存在——Input.Observer 会在启动时显示“Input.Observer 无法加载您的配置”，并说明它查找的位置，以及在 详细信息 下说明出了什么问题。它提供三个选项：
| 选项 | 会发生什么 |
|---|---|
| 浏览配置文件 | 在这台计算机上选择另一个 config.toml。Input.Observer 会在其原位置使用该文件，并记住它：常规文件会变成指向它的指针。如果常规文件中保存有设置，则会先将其改名放到一旁。如果您选择的文件也无法加载，对话框会显示原因并再次询问。 |
| 使用新的默认配置重新开始 | 损坏的文件会被 重命名，而不是删除，并在原位置写入一个新的最小配置。 |
| 关闭 Input.Observer | 不做任何更改。请自行修复该文件，然后重新启动 Input.Observer。 |
被重命名的文件名类似于 config.toml.broken-20260923-180512.bak，位于同一文件夹中。如果文件无法重命名（例如另一个程序打开了它）或者文件夹无法写入，则不会覆盖任何内容：对话框会告诉您并再次询问。
对于受保护的配置，输错三次密码后也会出现同样的对话框——请参阅如果忘记了密码。
如果根本没有 config.toml，则视为首次运行：Input.Observer 会创建一个包含入门套件的新文件，并打开欢迎信息（首次运行）。
将配置保存在其他位置
您可以将真正的 config.toml 保存在另一个文件夹中（例如同步文件夹），并在常规位置留下一个指针。该指针是一个只包含以下内容的 config.toml：
[config_location]
path = "D:\\Sync\\Input.Observer\\config.toml"
- 相对路径从指针文件所在的文件夹开始解析。
- 与配置在一起的所有内容（上表中的文件）随后都位于目标文件旁边，而不是指针旁边。
- 恢复对话框中的 浏览配置文件 会为您写入此指针。
- 如果目标不存在，Input.Observer 会在启动时显示恢复对话框，而不是使用默认值启动。重新加载配置 会保留正在运行的配置，并说明目标不存在。
- 指针永远不会被加密，也永远不会被导出或导入。
更改指针后，请重新启动 Input.Observer，或从托盘菜单中选择 重新加载配置。
手动编辑文件
config.toml 是一个纯文本 TOML 文件，您可以用任何文本编辑器编辑它。请先了解以下几点：
- 受保护的配置无法手动编辑。 它是加密的；请先删除密码（安全）。
- 要应用您的编辑，请从托盘菜单中选择 重新加载配置，或重新启动 Input.Observer。配置窗口打开时，它会在您下次保存时察觉文件已更改，并询问是 重新加载（丢弃窗口中未保存的更改）、覆盖 文件，还是 继续编辑。
- 如果“重新加载配置”无法读取文件，它会告诉您。 之前的配置仍然有效，并且一条 配置未重新加载 消息会指出错误所在的行和列，以及文件读取器报告的英文原因（重新加载配置）。修正后再次重新加载。在下次启动时，同样的错误会弹出恢复对话框。
- Input.Observer 会修复它能修复的内容并告诉您。 无法使用的条目会被跳过，超出范围的值会被重置或限制。每项修复都会列在控制台的 系统 部分中，配置窗口会将它们显示为来自引擎的通知。少数严重情况还会立即显示一条消息。
- Input.Observer 可能会重写该文件。 当缺少它需要的某项设置时，它会写回包含所有设置的整个文件，此时您添加的注释会丢失。请将备注保存在其他地方。
- 大于 8 MB 的文件 仍然可以运行，但配置窗口无法打开它；Input.Observer 会在启动时发出警告。
- 在进行大量编辑之前请先备份。自动备份只涵盖截至上次退出时所做的更改。