Finicky 4.0.0版本配置迁移指南：关键API变更解析

Finicky作为一款macOS浏览器路由工具，在4.0.0版本中进行了重要的API调整。本文将为开发者详细解析这些变更，帮助用户顺利完成配置迁移。

核心API变更说明

域名匹配函数升级

原matchDomains方法已调整为更符合语义的matchHostnames。新版本会智能识别旧配置并输出警告信息，但为了最佳实践，建议开发者尽快更新配置。

示例变更：

// 旧版本
matchDomains: ["example.com"]

// 新版本
matchHostnames: ["example.com"]

键盘修饰键获取方式重构

在事件处理函数中获取键盘修饰键的方式发生了重要变化：

// 旧版本（已废弃）
match: ({ keys }) => keys.function

// 新版本（推荐）
match: () => finicky.getModifierKeys().function

这个变更使得API更加明确，将键盘状态获取与路由逻辑解耦，提高了代码的可读性和可维护性。

迁移建议

1. 渐进式迁移：虽然v4.0.0-alpha.2版本仍兼容部分旧API，但建议尽快完成迁移
2. 利用警告信息：运行时控制台会输出详细的弃用警告，包含具体的替换建议
3. 全面测试：修改配置后，建议全面测试各种路由场景

技术背景

这些API变更反映了Finicky项目向更清晰、更模块化的架构演进。matchHostnames比matchDomains更能准确表达其功能，而将键盘状态获取独立为getModifierKeys方法则遵循了单一职责原则。

对于正在从3.x版本升级的用户，理解这些变更将有助于编写更健壮、更易维护的浏览器路由配置。Finicky团队通过警告机制和渐进式升级策略，尽可能降低了迁移成本，使开发者能够平滑过渡到新版本。