Home Assistant habitica.transformation 教程3 个参数把队友变成雪人【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io背包里躺着一颗雪球时一个 habitica.transformation 动作就能让队友变身为雪人。本文给出动手前核对清单、四种变形物品的参数取值、UI 与 YAML 两条配置路径以及在每分钟 30 次请求限额下的正确调用与排障步骤。动手前核对清单先检查这 4 项一个有效的 Habitica 账号官网注册集成已完成配置。两种登录方式任选其一Login to Habitica登录 Habitica用户名或邮箱密码Login to other instances登录其他实例需要User ID与API Token登录 Habitica 后进入Settings设置Site Data站点数据获取实例 URL 默认https://habitica.com自托管实例可改自签名证书场景需关闭Verify SSL certificate验证 SSL 证书配置项 ID 已记下Settings设置Devices services设备与服务中对应条目的 ID32 位十六进制字符串即 YAML 里config_entry的取值变形物品已在该角色背包中机制速览habitica.transformation 是做什么的调用后你能观察到的现象Habitica 里目标角色的形象变成雪人、幽灵、海星或花朵Home Assistant 侧的角色数据最迟约60 秒后跟随更新。底层原因是集成向 Habitica API 发送一条请求从config_entry所指角色的背包里消耗一件物品施加到target所指的角色上。该集成自0.78版本提供质量等级platinum属于服务型集成ha_integration_type: service采用 Cloud Polling云轮询模式因此所有状态都是拉取回来的而非实时推送。四件物品的参数取值固定只接受第二列的写法物品item取值变身后的形象Snowball雪球snowball雪人snowfriendSpooky sparkles惊悚闪光spooky_sparkles幽灵ghostSeafoam海沫seafoam海星starfishShiny seed闪亮种子shiny_seed花朵flower物品必须存在于使用者背包动作才不会空转。两种配置路径路径 AUI 可视化配置进入Settings设置Automations scenes自动化与场景。打开已有自动化或脚本或经Create automation创建自动化Create new automation创建新自动化新建自动化需在When何时加触发器脚本不需要。在Then do然后执行中点Add action添加动作。搜索并选中Habitica: Use a transformation itemHabitica使用变形物品。依次选择Config entry配置项物品所属角色、Transformation item变形物品、Target character目标角色。点Save保存。该动作不支持 targets界面不会让你选 area、device、entity 或 label——目标不是 Home Assistant 实体而是按文本匹配的 Habitica 角色只能在动作字段内指定。路径 BYAML 参数参考最小可运行示例与 动作文档 一致action: habitica.transformation data: config_entry: 6b4be47a1fa7c3764f14cf756dc9899d item: snowball target: Bob参数必填类型说明config_entry是string持物角色的配置项 IDitem是string变形物品取值见上表target是string目标角色按显示名/用户名/用户 ID 匹配在 UI 里插入动作后可切到 YAML 编辑器核对实际生成的data。场景示例每天 21:00 把队友变成幽灵alias: Halloween ghost transformation triggers: - trigger: time at: 21:00:00 actions: - action: habitica.transformation data: config_entry: 6b4be47a1fa7c3764f14cf756dc9899d item: spooky_sparkles target: Bob触发器只选单一时间点避免高频条件反复消耗请求配额item与target都是固定值无需模板。限制与配额为什么要留意请求数集成的固定开销是自身数据每60 秒同步一次每次3 个请求队伍数据含队员子条目每15 分钟刷新一次每个动作1 个请求动作结束后5 秒再追加1 个请求拉回角色数据。限制项数值影响自身数据同步每60 秒每次 3 个请求队伍数据刷新每15 分钟队友变化反映较晚第三方请求限额每分钟 30 次所有集成与工具共享单次动作1 个请求5 秒后再加 1 个同步请求高频触发或并发运行的自动化会快速耗尽配额后续动作可能被限流。Habitica 集成文档在已知限制一节明确要求创建自动化时保持对速率限制的警觉。排障清单动作没生效时按序查这 5 处物品是否存在item必须真的在config_entry角色的背包里。名称是否唯一target按显示名、用户名或用户 ID 三选一匹配重名时建议直接用用户 ID。配置项是否指向正确对象多账号场景下config_entry决定消耗谁的背包。是否触发限流刚密集调用过动作就稍等几分钟对照上一节的请求数核算。收集证据启用 debug log调试日志、重启集成、问题复现后停止日志文件会自动下载并附上 diagnostics诊断数据再提交问题报告流程见集成文档的 Troubleshooting 章节。快速验证不必写 YAMLSettings设置Tools工具Actions动作中搜索habitica.transformation填好三个参数点Perform action执行动作即可。延伸同一识别方式下的其他动作habitica.cast_skill施放职业技能如盗贼pickpocket、战士smash、法师fireball、habitica.score_habit给习惯打分、habitica.start_quest开启任务副本、habitica.accept_quest接受队伍邀请都使用同样的config_entry定位方式并共享每分钟 30 次的请求配额规划成套 Habitica 自动化时把它们的触发频率合并计算。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考