Digital Garden

📖 Garmin x Notion 同步助手：保姆级配置教程

欢迎使用 Garmin to Notion (CN Pro)！
这个工具不仅能帮你自动同步未来的运动数据，还能一键“穿越”，把你过去一年的运动记录、睡眠和步数全部拉取到 Notion 仪表盘上。
不需要你会写代码，只需要跟着下面的 4 步操作，10 分钟即可搞定。🚀

第一步：准备 Notion 模板 📥

  1. 打开我提供给你的 Notion 模板链接。←点击它
  1. 点击右上角的 Duplicate (复制) 按钮，把它保存到你自己的 Notion 空间里。
  1. ⚠️ 重要提示：
      • 请不要随意修改数据库里**“标题”和“属性”的名称**（例如“日期”、“运动类型”等列名），否则同步助手会找不到地方填数据。
      • 你可以随意美化封面、排版或添加新的视图。

第二步：获取 GitHub 仓库 🐱

这个“同步助手”是运行在 GitHub 上的（免费且稳定）。
  1. 注册/登录：如果你没有 GitHub 账号，请先注册一个。
  1. 打开项目链接：https://github.com/perinchiang/garmin-to-notion-cn
  1. Fork 项目：找到页面右上角的 Fork 按钮，点击它，然后点击 Create fork。
      • 这相当于把这个工具“复印”了一份到你自己的账号下，以后它就是你的了。

第三步：连接你的账号 (最关键一步) 🔗

我们需要把“钥匙”交给助手，它才能帮你搬运数据。

1. 找到填写位置

在你的 GitHub 仓库页面（刚才 Fork 好的那个）：
  • 点击顶部的 Settings (设置)。
  • 在左侧菜单栏找到 Secrets and variables -> 点击 Actions。
  • 点击绿色的 New repository secret 按钮。

2. 依次添加以下 7 个“钥匙” (Secret)

你需要重复点击“New repository secret” 7 次，分别填入以下内容：

A. 佳明账号信息

Name (名字)
Secret (内容)
说明
GARMIN_EMAIL
你的佳明邮箱
登录 Garmin Connect 的账号
GARMIN_PASSWORD
你的佳明密码
登录密码

B. Notion 授权

Name (名字)
Secret (内容)
说明
NOTION_TOKEN
ntn_xxxx...
👇 看下方如何获取
如何获取 Token？
  1. 访问 Notion Integrations。
  1. 点击 New integration，名字随便取（比如 "My Garmin"），提交。
  1. 复制那个以 ntn_ 开头的 Internal Integration Secret。
  1. 【至关重要】 回到你的 Notion 模板页面，点击右上角 三个点 (...) -> Connect (连接) -> 搜索并选择你刚才创建的 "My Garmin"。检查里面是否有刚刚创建的小助手。

C. 数据库 ID (告诉助手往哪填)

打开你的 Notion 模板，你需要找到 4 个数据库的 ID。
  • 如何找 ID？ 在浏览器打开数据库页面，网址中 notion.so/ 后面那一串乱码就是 ID（在 ?v= 之前的部分）。
    • 例如：notion.so/myworkspace/1a2b3c4d5e...?v=...，ID 就是 1a2b3c4d5e...
Name (名字)
Secret (内容)
对应模板里的哪个库？
NOTION_CN_DB_ID
你的ID
运动记录 (Activities)
NOTION_CN_STEPS_DB_ID
你的ID
每日步数 (Daily Steps)
NOTION_CN_SLEEP_DB_ID
你的ID
睡眠数据 (Sleep)
NOTION_CN_PR_DB_ID
你的ID
个人最佳纪录 (PRs)

第四步：一键初始化 (拉取历史数据) ⏳

配置好了！现在我们来启动“时光机”，把你过去的数据拉回来。
  1. 在 GitHub 页面顶部，点击 Actions 标签页。
  1. 点击绿色按钮：“I understand my workflows, go ahead and enable them”（我理解我的工作流，继续并启用它们）
  1. 在左侧栏点击 Manual History Backfill (手动回填历史)。
  1. 在右侧点击 Run workflow 按钮 -> 再点绿色的 Run workflow。
  1. 等待：页面会出现一个黄色/蓝色的圆圈在转，这表示正在运行。
      • 拉取一整年的数据可能需要 10-20 分钟，请喝杯咖啡耐心等待。
      • 完成后，圆圈会变成绿色的 ✅。
🎉 现在，打开你的 Notion，你会发现数据正在疯狂涌入！

📅 以后怎么用？

  • 全自动：你不需要再做任何操作！这个助手每天北京时间凌晨会自动运行，把你昨天和今天的新数据同步过来。
  • 手动补漏：如果你某天感觉数据没过来（比如佳明服务器抽风），你可以随时回到 GitHub Actions，点击 Manual History Backfill (手动回填历史)手动运行一次。默认是同步366天前的1200条数据，如果有更多时间、数据需求，到run_once_backfill.py修改然后commit提交再在Actions这里跑一次Manual History Backfill即可

❓ 常见问题

Q: 为什么显示“无睡眠数据”？
A: 佳明的数据有时候上传有延迟，或者那天你没戴表睡觉。回填脚本会自动跳过没有数据的日子。
Q: 我改了佳明密码怎么办？
A: 回到 GitHub 的 Settings -> Secrets 页面，点击 GARMIN_PASSWORD 旁边的铅笔图标，更新密码即可。
Q: 数据标题格式是 2026/01/01，我能改吗？
A: 目前模板内置格式为年/月/日，这最适合排序和统计。如需修改需要改代码，建议保持默认。