Home Assistant habitica.transformation 变形物品动作实战指南

Home Assistant habitica.transformation 变形物品动作实战指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.iohabitica.transformation是 Habitica 集成中消耗角色背包变形物品、把自己或队友变成雪人、幽灵、海星或花朵的动作。本文拆解它的 3 个参数字段、UI 与 YAML 两条配置通道、速率限制约束与结果验证方法读完即可在自动化里跑通一次完整变身。变形物品是什么从哪来 Habitica 是一款游戏化任务管理服务你的每日目标与待办事项会变成角色扮演游戏里的任务完成它们可以赚取奖励并升级。Home Assistant 的 Habitica 集成域habitica质量等级 platinum自 0.78 版本引入采用云轮询模式让你监控角色属性并操作任务、队伍与角色状态source/_actions/ 目录共收录了它的 19 个动作habitica.transformation负责其中一件事从使用角色的背包里取出一个变形物品施加到队伍成员或你自己身上。前提是使用角色的背包中必须已有该物品。四种变形物品主要来自节日活动或商店购买背包里没有时动作无法执行。此外要先按 Habitica 集成文档 完成配置需要一个有效的 Habitica 账号设置流程提供两种登录方式Login to Habitica用用户名或邮箱加密码登录Login to other instances提供User ID与API Token在 Habitica 的SettingsSite Data获取并指定实例 URL默认https://habitica.com可改为自托管实例SSL 证书校验可开关自签名证书需关闭。配置完成后SettingsDevices services会为角色建立配置条目其 32 位十六进制 ID形如6b4be47a1fa7c3764f14cf756dc9899d就是 YAML 里config_entry字段的取值——把它理解成角色身份证系统靠它确定从谁的背包里取物品。在 UI 中添加变形物品动作进入SettingsAutomations scenes进入自动化配置界面打开现有自动化或脚本或选择Create automationCreate new automation新建新建自动化时在When部分添加触发器脚本无需触发器被调用时才运行在Then do部分选择Add action在搜索框中搜索并选择Habitica: Use a transformation item依次填写三个选项Config entry从哪个角色的背包取物品、Transformation item使用哪个物品、Target character对谁变身选择Save完成。该动作不支持 targetsUI 不会提示你选择区域、设备、实体或标签。原因是目标不是 Home Assistant 实体而是按文本匹配的 Habitica 角色必须直接填在动作自己的字段里。在 YAML 里写 habitica.transformation把下面示例直接放进自动化或脚本action: habitica.transformation data: config_entry: 6b4be47a1fa7c3764f14cf756dc9899d item: snowball target: Bob三个字段各司其职config_entry是物品归属角色的配置条目 IDitem指定要消耗的变形物品target指定对谁使用按显示名称、用户名或用户 ID 匹配三者任一即可。字段缺一不可缺item无法确定消耗哪个物品缺target无法确定作用对象多账号场景下config_entry则防止取错角色的背包。item只有四个枚举取值效果一一对应UI 显示item取值变身效果Snowballsnowball变成雪人snowfriendSpooky sparklesspooky_sparkles变成幽灵ghostSeafoamseafoam变成海星starfishShiny seedshiny_seed变成花朵flower完整参数清单字段类型必填说明config_entrystring是使用变形物品的 Habitica 角色配置条目取自SettingsDevices servicesitemstring是变形物品取上表四个值之一物品必须在该角色背包中targetstring是目标角色按显示名称、用户名或用户 ID 匹配调用链路与请求预算池⚡ 一次变身的执行路径自动化或脚本或开发者工具→ Habitica 集成 → Habitica API 完成物品使用 → 动作结束后约 5 秒再发一次同步请求把角色数据背包、外观等拉回 Home Assistant。所有请求共享 Habitica 对第三方应用设定的每分钟 30 次上限相当于一个预算池且该池对你使用的所有工具与集成统一生效。集成自身开销每 60 秒数据同步消耗 3 个请求每个动作 1 个请求动作后 5 秒再追加 1 个同步请求。一次变形共消耗 2 个请求频繁触发或并发自动化能很快耗尽配额。另注意队伍数据含你添加的队伍成员子条目每 15 分钟才刷新变身队友后别指望立刻在 Home Assistant 里看到新形象先回 Habitica 侧确认。确认执行结果与排障 两条验证路径开发者工具直接执行打开SettingsToolsActions搜索habitica.transformation填好三个字段后点Perform action不写 YAML 即可确认参数组合是否有效触发自动化后回客户端核对运行自动化或脚本到 Habitica 客户端查看目标角色是否已变身Home Assistant 侧可查看队伍成员的 Avatar 图像实体按 15 分钟队伍数据周期更新。动作未生效时按此顺序排查查目标target填的名称能否唯一匹配显示名称、用户名、用户 ID 任一即可查背包物品归属角色的背包里是否确实有该物品没有就先获取查身份证config_entry是否指向正确角色多账号场景最常在这里取错背包查系统限制请求预算池耗尽时调用会被拒绝降低触发频率后恢复仍不解决启用调试日志并重启集成问题复现后停止日志并下载诊断数据配合 Habitica 集成文档 的 Troubleshooting 章节提交报告。同一张 config_entry 身份证还能做什么同一域名下的动作共享同一套config_entry定位方式与每分钟 30 次的预算池每个动作同样消耗 1 个请求加 1 个同步请求habitica.cast_skill对任务施放职业技能盗贼pickpocket/backstab、战士smash、法师fireball以任务名为目标与以角色为目标的变形形成对比habitica.score_habit/habitica.score_reward/habitica.score_daily对习惯、奖励、每日任务打分共用同一张config_entryhabitica.start_quest开启队伍任务副本结果确认同样受 15 分钟队伍数据周期影响habitica.accept_quest接受队伍任务邀请常与通知动作配合组成自动化habitica.update_todo编辑待办任务。如果你已经会用变形动作的三个字段切换这些动作只需改action名与 data 字段调用方式完全一致。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考