GitHub Action 同步说明

部分同步服务会使用你的 GitHub Action 运行同步任务。这样可以让任务在独立环境中执行，便于查看日志，也能减少服务器排队。

什么时候需要绑定 GitHub

如果插件在运行前提示绑定 GitHub，就按提示完成绑定。

绑定后，NotionHub 会在你的 GitHub 账号下创建或更新 notionhub-runner 仓库，并为已配置的同步服务生成对应的 Action。

如果插件没有提示绑定 GitHub，可以继续按当前流程使用。

GitHub Action 会做什么

一次同步通常会经历这些步骤：

• 检查本次运行是否有权限。
• 准备当前服务所需配置。
• 下载同步程序。
• 按服务模块同步数据到 Notion。
• 在运行日志中记录成功、失败或需要重新登录的提示。

一些服务会拆成多个 Job，例如微信读书会分别同步书籍和阅读时长。多个 Job 会按顺序执行，不会同时写入同一份数据。

会泄露隐私吗

NotionHub 会尽量把敏感信息写入 GitHub Secret，而不是直接展示在日志中。

敏感信息包括：

• Notion Token
• 第三方平台 Cookie 或 Token
• 激活码
• 通知 Webhook
• 手机号、邮箱等账号信息

请不要把 GitHub Action 日志公开发到社区或群里。如果需要技术支持，可以只发送 Action 链接和错误截图。

如何查看运行结果

打开你的 GitHub 仓库：

https://github.com/<你的 GitHub 用户名>/notionhub-runner/actions

点击最近一次运行，可以看到每个 Job 的状态。

常见结果：

• 绿色对勾：同步成功。
• 红色叉号：同步失败，需要查看错误提示。
• 黄色圆点：正在运行。
• 灰色取消：任务被取消，可能是你触发了新的同步。

为什么会自动取消旧任务

NotionHub 同一个服务同一时间只允许一个任务运行。

如果你在旧任务还没结束时再次点击「开始同步」，新任务会取消旧任务。这是为了避免多个任务同时写入 Notion，产生重复数据。

免费体验和 GitHub Action

免费体验用户也可能会使用 GitHub Action。

如果免费体验次数已用完，Action 会在前置检查阶段停止，并提示购买激活码，不会继续下载或运行同步程序。

购买说明见 获取激活码。

常见问题

可以删除 notionhub-runner 仓库吗？

不建议删除。删除后，已经配置好的 GitHub Action、Secret 和运行记录都会丢失。

如果确实删除了，可以回到插件重新绑定 GitHub 并重新生成配置。

可以手动修改 GitHub Secret 吗？

不建议手动修改。插件保存配置、重新登录或重新复制模板后，会自动更新需要的 Secret。

手动修改可能导致预检通过但运行失败，或者被后续配置校准覆盖。

可以自己点 GitHub 里的 Run workflow 吗？

一般建议从插件点击「开始同步」。插件会先检查登录状态、Notion 模板和试用次数，再触发 GitHub Action。

直接在 GitHub 里运行可能跳过插件侧提示，遇到错误时不容易理解。

GitHub Action 很慢怎么办？

GitHub Action 的网络速度不稳定，尤其是下载第三方音频、视频或大量图片时会比较慢。

可以先关闭大文件上传，只同步文字、链接、封面等核心数据。