Home Assistant Habitica 集成操作指南使用 habitica.create_daily 自动创建每日任务【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文是一份面向 Home Assistant 用户的实战指南讲解如何通过habitica.create_daily操作为你的 Habitica 角色自动创建每日任务Daily。读完本文你将掌握在自动化与脚本中通过可视化界面和 YAML 两种方式调用该操作的方法、全部参数的取值范围与含义以及如何结合定时、状态触发等场景把刷牙、浇花、运动这类每日习惯交给 Home Assistant 自动登记进 Habitica。操作定位为 Habitica 角色创建每日任务habitica.create_daily是 Home Assistant 中 Habitica 集成的核心操作之一用于为选定的 Habitica 角色创建一个每日任务。Habitica 是一款将每日目标与待办事项游戏化的任务管理工具把日常习惯变成角色扮演游戏完成每日任务即可获得经验、金币并提升角色等级。在 Home Assistant 中Habitica 集成见集成总览文档支持日历、传感器、待办列表、按钮控制、通知等多个平台其中**每日任务Dailies**以todo.habitica_dailies待办列表实体暴露而habitica.create_daily则提供了比待办列表更精细的编程式创建能力——你可以在创建时直接指定重复频率、星期、难度、提醒、标签等完整属性这正是它适合自动化场景的原因。前置条件在调用该操作前需要先完成 Habitica 集成配置拥有一个有效的 Habitica 账号。在 Home Assistant 中通过设置 设备与服务添加 Habitica 集成登录方式二选一Login to Habitica使用用户名/邮箱 密码登录Login to other instances使用User ID和API Token在 Habitica 网站Settings Site Data中获取并填写实例 URL默认https://habitica.com也支持自托管实例。配置完成后集成会为你的角色创建一系列传感器、待办列表和日历实体habitica.create_daily操作即可使用。需要留意的是Habitica 对第三方应用有每分钟 30 次请求的速率限制该限制对所有工具与集成合计生效本集成每次数据更新每 60 秒消耗 3 次请求每次执行操作消耗 1 次请求并在操作 5 秒后再发 1 次请求用于同步数据。在设计高频率自动化时请务必把这些开销计入预算。从用户界面调用该操作如果你更习惯可视化构建自动化Home Assistant 会逐步引导你完成操作配置无需编写任何 YAML进入设置 自动化与场景。打开一个现有的自动化或脚本也可以选择创建自动化 创建新自动化。如果是新建自动化在当When部分添加触发器脚本不需要触发器它们在被其他对象调用时运行。在然后执行Then do部分选择添加操作Add action。在搜索框中搜索并选择Habitica: Create a daily。选择角色的配置条目Config entry填写任务名称Task name其余字段按需设置。点击保存Save。重要说明该操作不支持目标targets。在 UI 中你不会被提示选择区域、设备、实体或标签——因为 Habitica 角色是由config_entry直接指定的。UI 中的可选参数参数说明是否必填配置条目Config entry要为其创建每日任务的 Habitica 角色必填任务名称Task name每日任务的标题必填备注Notes每日任务的说明文字可选清单Checklist添加到每日任务清单中的项目可选清单折叠/展开清单默认显示为折叠还是展开可选难度Difficultytrivial、easy、medium或hard可选开始日期Start date每日任务开始生效的日期也是其重复的基准日可选重复间隔Repeat intervaldaily、weekly、monthly或yearly可选每 X 个间隔重复基于所选频率的重复间隔数值为 0 时每日任务变为不活跃灰色每日任务可选每周重复日每日任务在一周中的哪些天重复仅在频率为 weekly 时生效可选每月重复日每月任务按相同日历日day_of_month还是按相同星期几day_of_week重复基于开始日期计算仅在频率为 monthly 时生效可选提醒Reminders为每日任务添加提醒可选标签Tags为每日任务添加标签若标签不存在则自动创建可选任务别名Task alias用于替代名称或任务 ID 的别名仅支持字母数字、短横线和下划线且必须在所有任务中唯一可选在 YAML 中调用该操作在 YAML 中该操作的名称为habitica.create_daily。以下是一个官方示例创建一个名为 Brush teeth 的每周任务分别在周一、周三、周五重复action: habitica.create_daily data: config_entry: 6b4be47a1fa7c3764f14cf756dc9899d name: Brush teeth frequency: weekly repeat: - m - w - f一个更完整的实战示例——在每天早晨自动创建带清单、难度和提醒的晨练任务action: habitica.create_daily data: config_entry: 6b4be47a1fa7c3764f14cf756dc9899d name: Morning workout notes: 30 minutes of exercise before breakfast frequency: daily every_x: 1 priority: medium add_checklist_item: - Warm up - Main workout - Cool down reminder: - 07:00 tag: - health alias: morning_workoutYAML 参数完整参考参数类型说明必填config_entrystring要创建每日任务的 Habitica 角色是namestring每日任务标题是notesstring每日任务的备注说明否add_checklist_itemstring / list添加到每日任务清单中的项目否collapse_checkliststring清单显示为折叠还是展开否prioritystring难度trivial、easy、medium、hard否start_datestring任务开始生效并作为重复基准的日期否frequencystring重复间隔daily、weekly、monthly、yearly否every_xinteger基于所选频率的间隔数0 表示不活跃灰色每日任务否repeatlist每周重复的天数仅在frequency: weekly时生效否repeat_monthlystringday_of_month按日历日或day_of_week按星期几仅在frequency: monthly时生效否reminderstring / list为每日任务添加提醒否tagstring / list添加标签标签不存在时自动创建否aliasstring替代名称或任务 ID 的别名仅限字母数字、-、_且全任务唯一否参数细节与使用要点关于every_x与灰色每日任务every_x决定每日任务隔几个周期重复一次every_x: 1表示每个周期都重复every_x: 2表示每隔一个周期。特别地当every_x为 0 时每日任务会变为不活跃状态——Habitica 中这类任务以灰色显示不会造成伤害也不会获得奖励常用于暂时搁置某个习惯。你无需删除任务即可通过该参数临时停用。关于repeat的取值当frequency为weekly时repeat使用单字母缩写列表指定一周中的重复日m周一、t周二、w周三、th周四、f周五、s周六、su周日。上述官方示例中的[m, w, f]即周一、周三、周五。关于priority与start_datepriority接受trivial、easy、medium、hard四个等级对应 Habitica 中的难度设置直接影响任务完成时获得的经验与金币倍率。start_date既是任务生效的日期也是重复周期的锚点weekly频率下每周重复日、monthly频率下的repeat_monthly计算都基于该日期。自动化实战把每日习惯交给 Home Assistanthabitica.create_daily最典型的用法是与定时触发器组合在每天或每周固定时间自动把当天的任务写入 Habitica。例如配合time触发器在每天早晨创建当日任务triggers: - trigger: time at: 06:30:00 actions: - action: habitica.create_daily data: config_entry: 你的config_entry_id name: Take vitamins frequency: daily priority: trivial也可以与状态触发器联动例如传感器检测到洗碗机运行结束后不仅可以通过todo.add_item向todo.habitica_to_dos添加待办见集成文档中的自动化示例还能用本操作直接创建带提醒的每日任务形成设备状态 → 游戏化任务的闭环。若需对已存在的每日任务做修改重命名、调整难度、增减清单项、调整连续打卡次数等请使用配套操作habitica.update_daily见操作文档它支持按名称、任务 ID 或别名定位任务创建一次性任务则使用habitica.create_todo见操作文档。动手验证与疑难排查快速试运行不想写 YAML可以在设置 工具 操作Actions中搜索habitica.create_daily填写字段后点击执行操作Perform action即可在真实角色上看到效果。常见问题请求超限Habitica 限流为每分钟 30 次。若自动化触发频繁或多个自动化并发很容易超过配额请在设计中预留余量必要时加节流或去抖参考集成文档的速率限制说明。别名冲突alias必须在所有任务中唯一且只能包含字母数字、短横线与下划线违反规则会导致创建失败。数据同步延迟操作执行后集成会在约 5 秒后额外发一次请求同步数据若立即查询待办列表实体可能看到旧状态。相关操作一览以下操作与本操作搭配使用效果更佳更新每日任务按名称、任务 ID 或别名更新现有每日任务创建待办为角色创建一次性待办任务使用技能施放角色技能更新习惯更新现有习惯任务更新待办更新现有待办任务创建奖励为角色创建奖励项。完整的角色实体、传感器与自动化示例可继续阅读 Habitica 集成文档。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考