Home Assistant 中使用 Remember The Milk Complete Task 动作从自动化与脚本完成任务【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本篇技术指南聚焦于 Home Assistant 中 Remember The MilkRTM集成提供的remember_the_milk.你的用户名_complete_task动作讲解如何通过可视化界面和 YAML 两种方式在自动化或脚本中按 ID 完成由 Home Assistant 创建的任务。读完本文你将掌握该动作的完整参数、调用约定、与 Create task 动作的配套用法以及一个传感器触发即创建任务、恢复即完成任务的可运行自动化范例。该文档对应的动作参考页位于 source/_actions/remember_the_milk.complete_task.markdown配套的创建任务动作为 remember_the_milk.create_task.markdown集成整体说明见 source/_integrations/remember_the_milk.markdown。动作概览它做什么remember_the_milk.用户名_complete_task动作用于完成一个由 Home Assistant 创建的 Remember The Milk 任务。它的核心约束是只能完成任务带有 ID的任务即通过create_task动作显式传入id参数创建的任务动作名中必须带上你在配置集成时使用的 RTM 用户名形如remember_the_milk.my_rtm_username_complete_task该动作不支持 targets即不能把动作作用到多个实体上。从仓库结构看动作文档按一个 markdown 文件对应一个动作组织在 source/_actions 目录下与create_task、notify等动作文档采用相同的 Front Matter 规范action、domain、description、related_actions字段便于站点自动生成Related actions关联区块。在界面中调用UI 操作步骤若你更习惯可视化构建自动化或脚本source/_includes/actions/ui_header.md 说明 Home Assistant 会引导你逐步完成动作配置无需编写 YAML。按以下步骤操作进入设置 自动化与场景Settings Automations scenes。打开一个现有的自动化或脚本或者选择创建自动化 创建新自动化。如果是新建自动化在When何时区域添加一个触发器脚本不需要触发器它们由其他内容调用时才运行。在Then do然后执行区域选择添加动作Add action。搜索并选择Remember The Milk:你的RTM用户名_complete_task。在右上角选择菜单三个点图标编辑为 YAMLEdit in YAML。参照下文在 YAML 中使用本动作输入 YAML。选择保存Save。在 YAML 中使用本动作source/_includes/actions/yaml_header.md 指出直接编写 YAML 时需要明确每个字段名、类型与是否必填。动作名中包含你的 RTM 用户名若用户名为my_rtm_username则动作名为remember_the_milk.my_rtm_username_complete_taskaction: remember_the_milk.my_rtm_username_complete_task data: id: water_plants上述示例会完成 ID 为water_plants的任务。注意必须把my_rtm_username替换为你实际配置的 RTM 用户名只能完成从 Home Assistant 创建且带 ID的任务因此使用前需要先通过create_task动作并携带id创建任务。YAML 选项参数参数描述必填类型id要完成的任务的标识符。该 ID 由创建任务时传入是字符串string该动作仅有一个参数id且必填动作不支持 targets。与 Create task 动作配套使用完成任务的先决条件是创建时带了 ID。与之配套的 remember_the_milk.create_task.markdown 文档说明创建任务时可传入name任务名称支持 RTM 智能语法如Water the plants ^today #home与可选的id若提供了id且该 ID 已存在则更新已有任务而不是新建若不提供id每次调用都会新建任务更新任务时不支持智能语法智能语法指令会被当作普通文本创建与完成应使用同一个 ID这正是完成任务的匹配键。完整自动化示例传感器状态驱动任务闭环source/_integrations/remember_the_milk.markdown 给出了一个把两个动作串成闭环的自动化当sensor.mysensor变为on时创建请关闭我的提醒任务变为off时完成该任务借此提醒你关掉某设备。通过把实体 ID 作为任务 ID同一规则可复用于多个传感器automation: - alias: Match fan to ceiling light triggers: - trigger: state entity_id: sensor.mysensor to: on actions: - action: remember_the_milk.my_rtm_username_create_task data: name: Please switch off {{ trigger.entity_id }} id: {{ trigger.entity_id }} triggers: - trigger: state entity_id: sensor.mysensor to: off actions: - action: remember_the_milk.my_rtm_username_complete_task data: id: {{ trigger.entity_id }}要点解读id使用模板{{ trigger.entity_id }}使任务 ID 与传感器实体唯一对应传感器关闭时无需知道具体 ID 即可完成对应任务该集成通过官方 API 与 RTM 云端轮询同步ha_iot_class: Cloud Polling列表在 Home Assistant 与 RTM 账户间双向同步集成基于 to-do 平台ha_platforms: todo实现RTM 列表以 to-do list 实体形式出现在 Home Assistant 中也可在To-do list仪表盘卡片中管理。常见问题与注意事项动作名带用户名忘记替换my_rtm_username会导致动作不存在而调用失败。ID 必须匹配complete_task只认创建时传入的 ID如果创建时未设置 ID则无法用本动作完成。多账户集成支持同时连接多个 RTM 账户参考 remember_the_milk.markdown每个账户对应一组以各自用户名命名的动作。不支持 targets本动作没有目标实体概念请勿在动作中配置target:。如需进一步排查可参考动作页底部Still stuck指引向 Home Assistant 社区提供你调用的动作与预期行为以获取帮助。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
