企业官网建设流程全解析

Itsyhome 是一款原生的 macOS 菜单栏智能家居 App，支持控制 HomeKit 和 Home Assistant 设备。它的 Deeplinks 功能（Pro 特性）通过itsyhome://深链接，让你用 Shortcuts、Alfred、Raycast 等工具一句话控制家里的灯、窗帘、门锁和场景——无需打开任何界面，一句话直达设备。本文提供完整的 17 个 Deeplink 动作速查表和三种工具的接入方法。

Deeplink 是什么？为什么值得用

Deeplink 就是一条特殊的网址（URL Scheme），格式固定为：

itsyhome://<action>/<target>

• action：要执行的动作，如on、off、scene
• target：目标设备，通常是房间/设备名

当系统打开这条链接时，Itsyhome 会自动解析并执行对应命令，HomeKit 和 Home Assistant 两种模式都支持。解析逻辑在 URLSchemeHandler.swift 中实现，注册在 Info.plist 的CFBundleURLSchemes里。

好处在于：任何能打开 URL 的工具都能变成智能家居遥控器，包括 Stream Deck、快捷指令，甚至浏览器书签。

17个Deeplink动作速查表

以下是全部 17 个动作的完整清单（与 README.md 中的 Deeplinks 文档一致）：

💡 注意：房间或设备名中的空格必须写成%20，例如Living%20Room。

目标命名规则：如何精确指向设备

设备组（Groups）是 Itsyhome 的特色功能，可以先在菜单中把多个灯归为一组，再通过group.前缀整组控制，非常适合"一键全屋关灯"这类场景。设备解析逻辑在 DeviceResolver.swift 中实现。

Shortcuts、Alfred 和 Raycast 的接入方法

三者原理相同：打开 URL，然后把itsyhome://...填进去即可。

1. Shortcuts（快捷指令）— 推荐首选

1. 打开"快捷指令"App，新建快捷指令
2. 添加"Open URL"（打开网址）操作
3. 输入 Deeplink，如itsyhome://scene/Goodnight
4. 命名为"晚安"，之后说一句 Siri 语音即可触发

由于 Deeplink 本身支持参数化，你可以让快捷指令接收变量（如亮度值），再拼进 URL，实现"把卧室灯调到 40%"这类灵活控制。

2. Alfred — 用 Workflow 一键触发

1. 新建 Workflow，触发器选 Keyword（如hm）
2. 动作选择 "Utilities → Run Script"（Shell Script）
3. 填入命令：open "itsyhome://off/Bedroom/Lamp"
4. 以后在 Alfred 输入hm加关键词即可执行

也可以直接把 Deeplink 配成 Alfred 的 Web Search 模板，搜索即触发。

3. Raycast — 自定义命令

1. 在 Raycast 中新建 Custom Script 或使用自带的 "Open URL" 扩展
2. 命令内容填open "itsyhome://toggle/Office/Spotlights"
3. 绑定一个快捷键，如⌘⇧L

从今往后，按一下组合键，办公室的灯就切换了——这就是 Deeplink 最爽的使用方式。

终端快速测试：先验证再配置

在配置第三方工具之前，建议先在终端里验证链接是否有效。macOS 的open命令即可：

open "itsyhome://toggle/Office/Spotlights" open "itsyhome://scene/Goodnight" open "itsyhome://brightness/50/Bedroom/Lamp"

执行后菜单栏中的 Itsyhome 会立刻响应。如果设备没有反应，优先检查设备名是否拼写正确、空格是否写成了%20。

在设置页面查看可复制的 Deeplink 示例

Itsyhome 的 设置 → Deeplinks 页面内置了完整的动作参考表和一键复制按钮（源码见 DeeplinksSection.swift），配置 Shortcuts 或 Alfred 时直接复制粘贴即可，省去手写 URL 的麻烦：

实用小贴士

• 🔑Deeplinks 是 Pro 功能：免费版无法使用，升级 Pro 后自动生效
• 🏠HomeKit 和 Home Assistant 通用：只要设备在菜单栏中能显示，就可用 Deeplink 控制
• 📦动作引擎：URL 解析为命令字符串后由 ActionParser.swift 解析、ActionEngine.swift 执行，与 Webhook/CLI 共用同一套动作体系
• 🧪完整测试用例可参考 URLSchemeHandlerTests.swift，里面演示了每个动作的正确与错误写法
• 🔍排查问题：动作无效时，先用终端open测试排除第三方工具问题，再检查目标命名格式

掌握这 17 个动作后，你的 Mac 就变成了一台智能家居中央控制器——配合 Stream Deck、Webhook 或 even-g2 眼镜端（见 README.md 的 Even Realities G2 支持），Itsyhome 的自动化玩法远不止于此。