Home Assistant 实战用 Habitica 变形物品动作把队友变成雪人【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.iohabitica.transformation是 Home Assistant 中 Habitica 集成提供的动作作用是把使用角色背包里的变形物品施加在队伍成员或你自己身上。本文以把队友 Bob 变成雪人为场景讲清这个动作的 UI 配置、YAML 写法、参数取值以及调用频率的约束让你能在自动化或脚本中安全地用上它。四个物品四种变身效果habitica.transformation能做的效果一共只有四种由你选择使用的物品决定。该集成的item取值与变身效果一一对应全部固定没有第五种物品item取值变身效果雪球snowball雪人惊悚闪光spooky_sparkles幽灵海沫seafoam海星闪亮种子shiny_seed花朵使用的前提只有一个物品必须在使用角色的背包里。Habitica 是任务游戏化平台日常任务会被转换成 RPG 式成长变形物品通常来自节日活动或商店购买背包里没有对应物品时动作不会生效。配置动作前需要准备好什么配置这个动作之前有三项检查要做都只需要一两分钟集成已就绪打开SettingsDevices servicesHabitica能看到已登录的角色条目。集成自 0.78 版本起提供登录时可选账号密码或填写User ID加API Token在 Habitica 网页SettingsSite Data中获取默认连接https://habitica.com自托管实例可改 URL。记下config_entry的值选中 Habitica 配置项在条目详情里找到 32 位十六进制字符串例如6b4be47a1fa7c3764f14cf756dc9899d。这是 YAML 中定位角色背包的凭据。确认背包里有货登录 Habitica 客户端检查准备使用的物品数量大于零动作消耗的是背包拥有者身上的物品而不是目标身上的。在 UI 中给自动化添加变形动作的完整步骤UI 是大多数用户的主路径全程不写一行 YAML。以新建自动化为例进入SettingsAutomations scenes打开已有自动化或选Create automationCreate new automation新建。新建自动化需要在When部分添加触发器脚本没有触发器由其他自动化或按钮调用时运行。在Then do部分点Add action。在搜索框输入Habitica选择Use a transformation item。依次填写三个字段Select character选哪个角色的背包出物品、Transformation item选四个物品之一、Target character被变身的角色按显示名、用户名或用户 ID 匹配。点Save。注意这个动作没有Area、Device、Entity、Label选项目标角色不是 Home Assistant 实体无法通过实体选择器指认只能直接填文本。不写 YAML 也能试一次开发者工具的路径如果只是想看效果而不建自动化可以走开发者工具打开SettingsToolsActions搜索habitica.transformation在参数区填入config_entry、item、target点Perform action立即执行然后在 Habitica 客户端里确认变身。在自动化里插好动作之后也可以切到 YAML 模式直接查看实际内容它长这样action: habitica.transformation data: config_entry: 6b4be47a1fa7c3764f14cf756dc9899d item: snowball target: Bob三个必填参数怎么填常见错误在哪三个参数全部必填缺一个动作就无法执行。下表汇总了类型、含义与踩坑点参数类型含义常见踩坑config_entrystring指定用谁背包里的物品取 Devices services 中配置项的 32 位 ID误把目标角色的 ID 填进来结果消耗了错误账号的物品多账号时尤其容易混itemstring使用的变形物品取值为snowball、spooky_sparkles、seafoam、shiny_seed之一写了不存在的物品名或该物品不在背包中动作执行但无效果targetstring被变身的角色按显示名、用户名或用户 ID 匹配显示名与队友重名导致匹配歧义此时改用用户 ID 更稳妥动作的调用成本与频率上限Habitica 对第三方应用设了每分钟 30 个请求的速率限制所有工具和集成共享这一个池子。集成本身的开销是每 60 秒同步 3 个请求每次动作执行 1 个请求执行后 5 秒再补 1 个同步请求——也就是每次调用变形动作实际花 2 个请求配额而队伍数据每 15 分钟刷新一次。据此可以算出上限基础同步已占掉 3 个/分钟再叠 13 次左右的动作就会触顶超出后请求会被拒绝。 建议把这类动作放在手动脚本或低频触发器比如按天、按事件里不要挂在高频状态变化上。确认变身成功与失败后的排查顺序确认成功最快的办法是打开 Habitica 网页或 App看目标角色的外观是否已变化在 UI 里切 YAML 模式核对三个字段值是否与预期一致也是常用手段。动作没生效时按顺序查四点背包里真的还有该物品——使用会消耗背包物品用完了自然无效果。target是否唯一匹配先试显示名不唯一就换用户 ID。config_entry是否指向背包拥有者这是最常被填错的字段。是否触发了速率限制查看日志中来自 Habitica 的限流错误有则等一分钟再试。若依旧失败按 集成文档的 Troubleshooting 章节开启调试日志、下载诊断数据后再提交问题报告。与变形动作配合使用的四个相关功能habitica.cast_skill给任务施放职业技能如盗贼的pickpocket、法师的fireball。habitica.start_quest/habitica.accept_quest开启或接受队伍副本任务。habitica.abort_quest/habitica.leave_quest中止或退出正在进行的副本。habitica.send_message往队伍聊天或私聊发消息适合变身之后补一句调侃。这些动作和变形动作共用同一套config_entry定位方式也共享每分钟 30 个请求的速率上限批量编排时一起计入配额。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考