Home Assistant Habitica 集成 habitica.transformation 动作怎么配参数、取值与请求预算一次讲清【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io深夜把一个整天刷红的队友变成雪人画面很滑稽实现它靠的是 Home Assistant 中 Habitica 集成的habitica.transformation动作——调用角色背包里的变形物品transformation item把变身效果施加到自己或队伍成员身上。本文给出这个动作的 UI 与 YAML 两种配法、四个物品取值以及配套的请求预算算法。开始前确认这几项Habitica 是一款把任务管理和习惯追踪游戏化的在线服务Home Assistant 的同名集成自 0.78 版本提供质量等级 platinum属服务型集成数据模式为云轮询Cloud Polling负责在本地监控角色属性、任务与队伍状态并允许直接执行操作。动手前先核对账号可用Habitica 账号处于活跃状态能登录并看到角色背包。集成已建配置项在SettingsDevices services中能找到该角色的配置项config entry且其传感器实体在线。背包持有目标物品想用的变形物品已在该角色背包中此类物品多来自节日活动或商店没有就先补货。登录方式已选定设置流程提供两条路径——Login to Habitica填用户名或邮箱加密码Login to other instances填User ID与API Token在 Habitica 的SettingsSite Data中获取同时指定实例 URL默认https://habitica.com可改为自托管实例以及 SSL 证书校验开关连接自签名证书实例时关闭。先看到效果开发者工具速验打开SettingsToolsActions设置 工具 动作搜索habitica.transformation把config_entry、item、target三个字段填好点Perform action。切到 Habitica 客户端就能亲眼看到角色变形的结果。先说结论开发者工具跑通后把同一份调用搬进自动化或脚本即可——脚本在被调用时执行自动化则按你设的触发器运行。两者参数完全相同区别只在入口。参数逐项拆解缺了会怎样动作在 habitica.transformation.markdown 中的官方描述是Uses a transformation item on a Habitica party member or yourself. —— source/_actions/habitica.transformation.markdown三个字段全部必填字段类型必填说明config_entrystring是使用物品的角色对应的配置项 ID32 位十六进制字符串itemstring是变形物品名取下方四个值之一物品必须在该角色背包中targetstring是被变身的角色按显示名称、用户名或用户 ID 匹配可取值与效果对照UI 显示名item取值变身结果Snowballsnowball雪人snowfriendSpooky sparklesspooky_sparkles幽灵ghostSeafoamseafoam海星starfishShiny seedshiny_seed花朵flower缺参时的表现缺config_entry多账号环境无法确定从谁的背包取物品缺itemAPI 不知道调用哪个物品缺target无法确定变身施加在谁身上。UI 表单中三者也都做了强制选择。两条配置路径UI 可视化配置打开SettingsAutomations scenes。进入已有自动化或脚本新建自动化时先在When部分添加触发器脚本无需触发器由调用方驱动。在Then do部分点Add action。在搜索框中定位并选择Habitica: Use a transformation item。依次选定Config entry背包所属角色、Transformation item物品、Target character变身对象。点Save。注意这一点该动作不支持 targets——UI 不会提示你挑选区域、设备、实体或标签。原因是变身对象不是 Home Assistant 实体而是按名称文本匹配的 Habitica 角色只能在动作字段里直接写。YAML 写法action: habitica.transformation data: config_entry: 6b4be47a1fa7c3764f14cf756dc9899d item: snowball target: Bobconfig_entry取自SettingsDevices services中该角色配置项的 ID形态为 32 位十六进制字符串例如示例中的6b4be47a1fa7c3764f14cf756dc9899d。在 UI 中插入动作后切到 YAML 模式可以核对生成的data是否一致。请求预算怎么算同步节奏参见 Data updates 章节自身数据每60 秒与 Habitica 同步一次队伍数据含你添加的队伍成员子条目每15 分钟刷新一次。请求消耗参见 Known limitations 章节每次数据更新 3 个请求每 60 秒一轮即约 3 个请求/分钟每个动作 1 个请求动作执行后 5 秒追加 1 个同步请求拉回背包与外观变化。官方限流每分钟 30 个请求且按第三方应用口径、对你使用的所有工具与集成合并生效。原文Habitica imposes a rate limit of 30 requests per minute for third-party applications, which applies collectively to all tools and integrations you use. —— source/_integrations/habitica.markdown推演一下基线同步已占掉约 3 个请求/分钟剩余约 27 个额度每个变形动作至少吃掉 2 个动作 5 秒后的同步一分钟里并发执行十几个变身动作就会触顶。所以官方在自动化示例旁提醒When creating automations, be mindful of the rate limits. Frequent triggers or multiple concurrent automations can quickly exceed the allowed number of requests. —— source/_integrations/habitica.markdown结论不要把它挂进高频触发器也避免多条自动化并发调用。故障自查四问物品持有吗在 Habitica 客户端查背包没有该物品就去活动或商店补齐。目标能匹配吗target可填显示名称、用户名或用户 ID 三者之一重名或查无此角色就改用唯一的那个标识。配置项对吗核对config_entry指向的确实是持有物品的角色多账号时最容易选错。被限流了吗单次手动能用、批量变身集中失败多半是那一分钟请求数超过了 30降频或错峰再试。仍无解时走 Troubleshooting 章节的流程开启调试日志、重启集成、复现后停止日志文件会自动下载再下载诊断数据一并附进问题报告。同族动作该集成共提供 19 个动作目录见 source/_actions/例如 habitica.cast_skill对任务施放职业技能如盗贼的pickpocket、法师的fireball、habitica.start_quest 与 habitica.accept_quest开启/接受副本以及habitica.score_*系列给习惯、每日任务、奖励打分。它们都用config_entry定位角色并同样受 30 请求/分钟的限制约束。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考