#!/usr/bin/env python3
"""OpenClaw 快捷指令用户指引。

包含快捷指令下载链接、手动创建教程、自动化设置说明。
"""


def main():
    guide = """
╔══════════════════════════════════════════════════════════════╗
║      📱 OpenClaw 快捷指令 — 用户指引（提醒事项 + 备忘录）  ║
╚══════════════════════════════════════════════════════════════╝

iCloud Drive 中两个独立文件夹（由 sync 命令按 target 自动分类）：
  • Shortcuts/Tasks/tasks_latest.json  → 提醒事项（target=reminder）
  • Shortcuts/Notes/notes_latest.json  → 备忘录（target=note）

每个文件夹只有一个文件，快捷指令直接读取，无需筛选。


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 快速安装（推荐）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

在 iPhone Safari 中打开以下链接，点击「获取快捷指令」即可导入：

  Tasks Import（提醒事项导入）:
  https://www.icloud.com/shortcuts/de68c5443f054355bdb332f246c24a94

  Notes Import（备忘录导入）:
  https://www.icloud.com/shortcuts/2229591d96a849a6ad9b4e44b4b6ce80

导入后请各运行一次（会提示授权，内容为空不影响）。
⚠️ 首次运行会在 iCloud Drive 中创建 Tasks / Notes 文件夹，
   后续 sync 命令才能正确推送 JSON 文件到这些文件夹。


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 设置自动化（可选）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

快捷指令 App → 底部「自动化」→ +
→ 特定时间 → 每天 22:05
→ 运行快捷指令 → 选「Tasks Import」
→ 关闭「运行前询问」

再创建一个自动化:
→ 特定时间 → 每天 22:06
→ 运行快捷指令 → 选「Notes Import」
→ 关闭「运行前询问」


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 最终效果
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  每晚 22:00 OpenClaw sync 上传到 iCloud 两个独立文件夹:
    Shortcuts/Tasks/tasks_latest.json (提醒事项)
    Shortcuts/Notes/notes_latest.json (备忘录)
  每晚 22:05 Tasks Import 自动:
    读取 Tasks 文件夹 → 创建提醒事项 → 删除文件 → 通知
  每晚 22:06 Notes Import 自动:
    读取 Notes 文件夹 → 循环拼接 → 创建一个日期备忘录 → 删除文件 → 通知


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 附录：手动创建教程（链接无法导入时使用）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

 一、Tasks Import（提醒事项导入）— 共 8 步
─────────────────────────────────────────

打开 iPhone「快捷指令」App → 右上角 + → 「添加操作」

【第 1 步】搜索「创建文件夹」，添加
  你看到:  在 (Shortcuts) 中创建文件夹 (新建文件夹)
  改成:    在 (Shortcuts) 中创建文件夹 (Tasks)

【第 2 步】搜索「获取文件夹中的文件」，添加
  你看到:  从路径 (示例.txt) 获取 (已创建的文件夹) 中的文件
  改:      ① 点「示例.txt」→ 清空，留空
           ② 「已创建的文件夹」→ 不用改，自动指向第 1 步

【第 3 步】搜索「获取文件夹内容」，添加
  不用改。⚠️ 关键步骤！把文件引用变成文件内容。

【第 4 步】搜索「从输入中获取词典」，添加
  不用改。自动解析 JSON。

【第 5 步】搜索「获取词典值」，添加
  改: 键 → 输入 tasks

【第 6 步】搜索「针对每一项重复」，添加
  循环内添加:
    6a.「获取词典值」→ 键输入 title
    6b.「添加新提醒事项」→ 标题选键盘上方的「词典值」

【第 7 步】搜索「删除文件」，添加（循环外）
  输入: 魔法变量 → 选第 2 步输出
  关闭「确认删除」

【第 8 步】搜索「显示通知」，添加
  标题: ✅ 待办已导入
  正文: 任务已添加到提醒事项

命名为「Tasks Import」。


 二、Notes Import（备忘录导入）— 共 11 步
──────────────────────────────────────────

每天创建一个备忘录，标题为「2026-03-12 备忘录」，
当天所有笔记合并写入。

打开 iPhone「快捷指令」App → 右上角 + → 「添加操作」

【第 1 步】搜索「创建文件夹」，添加
  改: 文件夹名 → Notes

【第 2 步】搜索「获取文件夹中的文件」，添加
  改: 路径清空留空

【第 3 步】搜索「获取文件夹内容」，添加
  不用改。

【第 4 步】搜索「从输入中获取词典」，添加
  不用改。

【第 5 步】搜索「获取词典值」，添加
  改: 键 → 输入 tasks

【第 6 步】搜索「设定变量」，添加
  改: 变量名称 → body，输入 → 留空

【第 7 步】搜索「针对每一项重复」，添加
  输入源: 魔法变量 → 选第 5 步的词典值
  循环内添加:
    7a.「获取词典值」→ 键输入 title
    7b.「获取词典值」→ 输入源选 Repeat Item，键输入 notes
    7c.「文本」→ 内容:
        (body变量)
        （空行）
        ## (7a的词典值)
        (7b的词典值)
    7d.「设定变量」→ 变量名称 body，输入自动选 7c 文本

【第 8 步】循环外，搜索「格式化日期」，添加
  改: 自定义 → yyyy-MM-dd

【第 9 步】搜索「文本」，添加
  内容: (格式化后的日期) 备忘录

【第 10 步】搜索「创建备忘录」，添加
  正文: 魔法变量 → body
  名称: 魔法变量 → 第 9 步的文本

【第 11 步】搜索「删除文件」，添加
  输入: 魔法变量 → 选第 2 步输出
  关闭「确认删除」

【第 12 步】搜索「显示通知」，添加
  标题: 📝 备忘录已导入
  正文: 笔记已添加到备忘录

命名为「Notes Import」。

"""
    print(guide)


if __name__ == "__main__":
    main()