Home Assistant Habitica 集成实战一键把队友变雪人、幽灵的 4 种变形物品用法【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io想让某个自动化在触发时直接把 Habitica 里的队友变成雪人这篇带你把 Home Assistant 的 Habitica 集成提供的habitica.transformation动作彻底用明白从查配置项 ID、三种调用入口开发者工具 / UI / YAML到背后的同步节奏和限流坑读完你就能独立跑通一次完整变身。动手之前先把三样东西备齐变形动作再简单也依赖下面三样东西缺一样都点不动一个可用的 Habitica 账号先在 habitica.com 注册好这是所有操作的地基。集成已经配好在 Home Assistant 的设置流程里用用户名或邮箱 密码登录或走Login to other instances填User ID和API Token登录 Habitica 后在 Settings Site Data 里拿自托管实例还要改实例 URL 并关掉 SSL 校验。配完后Settings Devices services里会出现一条对应的配置条目。物品真在背包里变形物品不是想变就能变它必须已经躺在你要用的那个角色的背包inventory中一般来自节日活动或商店。还有一样最容易被忽略的东西config_entry的值。它是那条配置条目的 ID形如6b4be47a1fa7c3764f14cf756dc9899d这样的 32 位十六进制串。在Settings Devices services里打开对应 Habitica 条目就能看到。它的作用是当你同时挂了多个角色比如好几个 Habitica 账号时告诉系统用哪一个的背包。如何 30 秒先验证变身真的生效别一上来就写自动化。最快的确认方式是走开发者工具进Settings Tools Actions。搜habitica.transformation。把config_entry、item、target三项填进去点Perform action。切回 Habitica 客户端看角色是不是已经变了个样子。这一步跑通了后面无论是 UI 还是 YAML都只是把同一组参数换个地方放而已。item一共只有四个合法取值分别对应四种变身snowball—— 雪球变雪人snowfriendspooky_sparkles—— 惊悚闪光变幽灵ghostseafoam—— 海沫变海星starfishshiny_seed—— 闪亮种子变花朵flowerUI 配置与 YAML 脚本二选一确认生效后按需挑一条路走到底。不想写代码的人走 UI。进Settings Automations scenes打开现有自动化/脚本或点Create automation Create new automation新建。若是新建自动化When部分要先加一个触发器脚本不用它们被调用时才跑。到Then do点Add action搜索框里选Habitica: Use a transformation item然后依次挑好 Config entry、Transformation item、Target character保存即可。注意这个动作在 UI 里不会让你选区域/设备/实体/标签——因为目标不是 Home Assistant 实体而是靠文字匹配的 Habitica 角色所以只能填在动作自己的字段里。要做自动化的人直接上 YAML。动作引用名是habitica.transformation最短示例action: habitica.transformation data: config_entry: 6b4be47a1fa7c3764f14cf756dc9899d item: snowball target: Bob三个字段缺一不可语义如下字段是否必填类型说明config_entry必填string用哪个角色的背包多账号时用于定位item必填string四取值之一物品必须在该角色背包里target必填string变身对象按显示名 / 用户名 / 用户 ID 三者任一匹配UI 里在Actions切到 YAML 视图也能看到它实际生成的就是上面这套data。背后发生了什么为什么不能高频触发Habitica 集成是云轮询模式数据不是实时刷的节奏是这样的你自己的数据每60 秒同步一次队伍数据含你添加的队伍成员子条目每15 分钟刷新一次。动作跑完还会补一刀约 5 秒后额外发一次同步把背包、外观这类变化拉回来。关键在于配额。Habitica 对第三方应用设了每分钟 30 次请求的上限而且这个额度是你在所有工具和集成里共享的。集成本身就在持续消耗——每 60 秒的数据更新占 3 个请求每个动作占 1 个动作后 5 秒再占 1 个。所以如果你写了一个高频触发、或多条并发跑的自动化去连发变形动作很容易把整分钟配额吃光后面正常的同步、技能调用就跟着卡住。把它想象成用水配额日常同步是固定开销动作是额外的额外用水猛开水龙头整缸很快就见底。集成文档里对这条限流有明确提示建自动化前务必先算一笔账。没生效怎么办按这个顺序自查物品真的在背包里吗这是最常见的翻车点背包没有对应物品动作就是空转。target能唯一匹配吗显示名、用户名、用户 ID 三者任一即可但要能对上名字撞了反而可能指向错人。config_entry指向对角色了吗多账号时填错条目等于拿错了背包。是不是被限流了短时间内连发多个动作可能撞上每分钟 30 次的墙。都排过了还没用就去开调试日志、重启集成复现后自动下载日志文件再顺手导一份诊断数据随报告一起提交。排障章节有完整步骤。举一反三同一套集成还能做点别的habitica.transformation只是其中一格。同集成里还有施放职业技能的habitica.cast_skill、给习惯/每日/待办打分的habitica.score_*系列、开副本的habitica.start_quest、接队伍邀请的habitica.accept_quest等全部在 source/_actions/ 目录里。它们共享同样的config_entry定位方式也一起受上面那条限流约束——用法思路可以照搬过来。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考