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动作可以替你完成这件事从角色背包里取出一件变形物品用在自己或任意一名队伍成员身上。下面会先讲清账号与集成配置这些前置门槛再带你走通 UI 零代码和 YAML 三行两种调用方式最后讲透请求配额、故障排查和同系列动作读完即可放心写自己的自动化。开工前账号、集成与 config_entry 三样先备好需要一个有效的 Habitica 账号在官网注册即可。在 Home Assistant 的设置流程中有两种登录方式选Login to Habitica用用户名或邮箱 密码登录选Login to other instances则填User ID和API Token登录 Habitica 后在Settings Site Data里获取还能指定实例 URL默认https://habitica.com并开关 SSL 证书校验。配置完成后Settings Devices services里会为你的角色生成一条配置条目它那个 32 位十六进制的 ID就是 YAML 里config_entry的取值。多角色时靠它区分谁在用物品。四种变形物品速览先看背包里有没有变身效果物品UI 名称YAML 取值雪人 snowfriendSnowball 雪球snowball幽灵 ghostSpooky sparkles 惊悚闪光spooky_sparkles海星 starfishSeafoam 海沫seafoam花朵 flowerShiny seed 闪亮种子shiny_seed硬性前提物品必须真实躺在使用角色的背包inventory里否则动作无法执行。变形物品一般来自节日活动或商店购买动手前先在 Habitica 里确认一下背包。方式一界面里零代码完成变身打开Settings Automations scenes进入一个现有自动化/脚本或新建一个新自动化记得在When里加触发器脚本则不需要。在Then do区域点Add action搜索并选中Habitica: Use a transformation item。依次填写三个必填项Select character背包所属角色、Transformation item要用的物品、Target character被变身的对象。点Save保存。你会注意到它没有 targets 选项——不提示选区域、设备、实体或标签。因为目标角色不是 Home Assistant 实体而是按显示名称、用户名或用户 ID 文本匹配出来的 Habitica 角色所以只能写进动作自己的字段里。方式二YAML 里三行搞定调用最简片段如下放在自动化或脚本的 actions 里action: habitica.transformation data: config_entry: 6b4be47a1fa7c3764f14cf756dc9899d item: snowball target: Bob三个参数缺一不可config_entry定位哪个角色在丢物品item只能取snowball、spooky_sparkles、seafoam、shiny_seed四值之一且背包里必须有货target是变身对象按显示名称、用户名或用户 ID 匹配。底层机制把请求当作一笔配额预算来花Habitica 对所有第三方应用统一限制每分钟 30 次请求你在所有工具和集成中的消耗合并计算这就像一笔共享预算。集成的固定开销是每 60 秒同步自身数据 3 次请求每 15 分钟刷新一次队伍数据而每次动作本身花 1 次请求动作结束后约 5 秒还会追加 1 次同步请求把背包、外观等新数据拉回来。 因此触发频繁的自动化或并发跑多个变形动作会明显蚕食预算写自动化时请给这个红线留出余量。变身没生效按这个顺序逐项排查背包里是否真的有该物品数量是否够用。target填写的名称/用户名能否唯一匹配到目标角色。config_entry是否指向了持有物品的那个角色别和另一个账号的 ID 搞混。是否因高频调用触发了每分钟 30 次的速率限制。以上都正常仍不行就启用调试日志、重启集成复现后停止日志并下载诊断数据附在问题报告里。延伸同系列动作也值得一试habitica.transformation只是该集成 18 个动作之一habitica.cast_skill对任务施放职业技能、habitica.score_habit等打分动作、habitica.start_quest开启副本与habitica.accept_quest接受队伍邀请都沿用同一套config_entry定位方式同样共享那笔请求配额掌握本文方法后可直接迁移使用。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Habitica 集成 habitica.transformation 动作实战指南：用变形物品变身队友一次讲透
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动作可以替你完成这件事从角色背包里取出一件变形物品用在自己或任意一名队伍成员身上。下面会先讲清账号与集成配置这些前置门槛再带你走通 UI 零代码和 YAML 三行两种调用方式最后讲透请求配额、故障排查和同系列动作读完即可放心写自己的自动化。开工前账号、集成与 config_entry 三样先备好需要一个有效的 Habitica 账号在官网注册即可。在 Home Assistant 的设置流程中有两种登录方式选Login to Habitica用用户名或邮箱 密码登录选Login to other instances则填User ID和API Token登录 Habitica 后在Settings Site Data里获取还能指定实例 URL默认https://habitica.com并开关 SSL 证书校验。配置完成后Settings Devices services里会为你的角色生成一条配置条目它那个 32 位十六进制的 ID就是 YAML 里config_entry的取值。多角色时靠它区分谁在用物品。四种变形物品速览先看背包里有没有变身效果物品UI 名称YAML 取值雪人 snowfriendSnowball 雪球snowball幽灵 ghostSpooky sparkles 惊悚闪光spooky_sparkles海星 starfishSeafoam 海沫seafoam花朵 flowerShiny seed 闪亮种子shiny_seed硬性前提物品必须真实躺在使用角色的背包inventory里否则动作无法执行。变形物品一般来自节日活动或商店购买动手前先在 Habitica 里确认一下背包。方式一界面里零代码完成变身打开Settings Automations scenes进入一个现有自动化/脚本或新建一个新自动化记得在When里加触发器脚本则不需要。在Then do区域点Add action搜索并选中Habitica: Use a transformation item。依次填写三个必填项Select character背包所属角色、Transformation item要用的物品、Target character被变身的对象。点Save保存。你会注意到它没有 targets 选项——不提示选区域、设备、实体或标签。因为目标角色不是 Home Assistant 实体而是按显示名称、用户名或用户 ID 文本匹配出来的 Habitica 角色所以只能写进动作自己的字段里。方式二YAML 里三行搞定调用最简片段如下放在自动化或脚本的 actions 里action: habitica.transformation data: config_entry: 6b4be47a1fa7c3764f14cf756dc9899d item: snowball target: Bob三个参数缺一不可config_entry定位哪个角色在丢物品item只能取snowball、spooky_sparkles、seafoam、shiny_seed四值之一且背包里必须有货target是变身对象按显示名称、用户名或用户 ID 匹配。底层机制把请求当作一笔配额预算来花Habitica 对所有第三方应用统一限制每分钟 30 次请求你在所有工具和集成中的消耗合并计算这就像一笔共享预算。集成的固定开销是每 60 秒同步自身数据 3 次请求每 15 分钟刷新一次队伍数据而每次动作本身花 1 次请求动作结束后约 5 秒还会追加 1 次同步请求把背包、外观等新数据拉回来。 因此触发频繁的自动化或并发跑多个变形动作会明显蚕食预算写自动化时请给这个红线留出余量。变身没生效按这个顺序逐项排查背包里是否真的有该物品数量是否够用。target填写的名称/用户名能否唯一匹配到目标角色。config_entry是否指向了持有物品的那个角色别和另一个账号的 ID 搞混。是否因高频调用触发了每分钟 30 次的速率限制。以上都正常仍不行就启用调试日志、重启集成复现后停止日志并下载诊断数据附在问题报告里。延伸同系列动作也值得一试habitica.transformation只是该集成 18 个动作之一habitica.cast_skill对任务施放职业技能、habitica.score_habit等打分动作、habitica.start_quest开启副本与habitica.accept_quest接受队伍邀请都沿用同一套config_entry定位方式同样共享那笔请求配额掌握本文方法后可直接迁移使用。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考