Skip to content

ZeppBridge 3.0.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 14 Oct 12:25
· 7 commits to main since this release
v3.0.0
da1cfc0
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Important

macOS: “ZeppBridge is damaged and can’t be opened”? Download from this repository's Releases, move ZeppBridge into Applications, then open Terminal and run the command below. Reopen the app afterwards. This removes the quarantine attribute for ZeppBridge only.

macOS 首次打开提示「已损坏，无法打开」？ 从本仓库下载并信任应用后，将 ZeppBridge 拖入「应用程序」，在「终端」执行以下命令，再次打开应用。该命令仅移除 ZeppBridge 的隔离标记。

xattr -dr com.apple.quarantine /Applications/ZeppBridge.app

腕上所记，尽归于你。Everything your wrist remembers. Yours to keep.

中文在前，English below.

升级前请先读

  • 升级是单向的。 3.0 第一次打开时会升级本机数据库，升级以后 2.x 就打不开这个库了。
  • 升级前会自动留一份快照。 确认新库完好以后，这份快照会自动删除。如果你想保留回到 2.x 的退路，请在升级前自己把 data 文件夹复制一份。
  • AI 工具要重新连接一次。 如果你在 Claude Code、Codex 等工具里连过旧版的 zeppbridge-mcp，3.0 会提醒你；到设置的「交给 AI 工具」卡里点一下对应按钮就能重新连接。

新增

用 Zepp 官方授权登录

  • 在系统浏览器里完成授权，用第三方账号登录 Zepp 的用户也能连接。
  • 睡眠以官方数据为准（包括 REM、小睡），并补上每小时步数。
  • 官方暂时没有的指标（如 HRV、血氧、压力、准备度）继续由原来的连接方式补充，两条通道可以同时开。
  • 隐私：授权这一步会经过我们的中转服务器，健康数据不会。数据只在你的电脑上。

训练计划，交给 AI

  • 把身体状况连同睡眠、训练记录交给你常用的 AI（ChatGPT、Claude、Gemini、Kimi、DeepSeek、豆包、Grok），排出一周训练。
  • AI 的回复粘回来就成了计划：按周查看、拖动交换日期、逐天精调每一步，确认后发到手表。
  • 训练可以存成模板，也可以导入 .zwo 和训练 .fit 文件。
  • 早上恢复状况差时，可以一键把当天的间歇换成轻松练。
  • 发到手表的计划可以撤销上一次，也可以一键清空。

交给 AI，更省事

  • 选好日期和内容，生成一个文件，自动放进剪贴板，在 AI 对话框里按 Ctrl+V（Mac 上是 ⌘V）就附上了。
  • Windows 上可以打开「全自动交给 AI」，替你粘贴并发送。每一步都会先确认浏览器界面，这个功能默认关闭。
  • 复用你已有的 AI 订阅，不额外花钱。

MCP 随安装包附带

  • 在设置里一键连接 Claude Code、Codex、Claude Desktop，本机 AI 工具可以直接读取你的数据。
  • AI 也能起草训练计划；要让它直接发布，需要你打开「允许 AI 直接发布训练计划」（默认关闭）。

界面全部重做

  • 深浅两套主题，导航、开关和滚轮都改成了玻璃材质。
  • 卡片展开成页面，返回时回到原来的位置。
  • 日期用扑克牌来挑：7 天、1 个月、6 个月一层层展开，挑好的放进收集箱，一起交给 AI。
  • 设置页改成卡叠，可以只看一张，也可以全部铺开。
  • 首页可以固定自己最关心的 3 到 4 个指标。
  • 生活事件（感冒、旅行、出差等）可以直接记在时间轴上。
  • 运动详情新增爬升卡；路线默认在本地画，也可以切换到在线地图（会先征得你的同意）。
  • 第一次使用时有新手引导，用示例数据演示，可以跳过。
  • 界面支持十种语言。

静默更新

  • 打开应用后，新版本会在后台下载并校验签名。左上角的标志会显示下载进度，下好以后亮起绿环。
  • 点「更新」时才会替换程序；如果正在同步，会等同步结束再替换。

平台说明

  • Windows：已经在真机上长期使用。
  • macOS、Linux：安装包由 CI 自动构建，全部测试都已通过，但还没有在真机上验证过。遇到问题欢迎反馈。

Before you upgrade

  • The upgrade is one-way. The first time 3.0 opens, it upgrades the local database. After that, 2.x can no longer open it.
  • A snapshot is taken before the upgrade. It is deleted automatically once the new database checks out. If you want to keep a way back to 2.x, copy the data folder yourself before upgrading.
  • Reconnect your AI tools once. If you connected the old zeppbridge-mcp in Claude Code, Codex or a similar tool, 3.0 will remind you. Open the “AI tools” card in Settings and click the matching button to reconnect.

New

Sign in with official Zepp authorization

  • Authorize in your system browser. Zepp accounts that sign in through a third party work too.
  • Sleep follows Zepp’s official data, including REM and naps, and hourly steps are filled in.
  • Metrics the official API does not offer yet (such as HRV, blood oxygen, stress and readiness) still come from the original connection. Both can stay on at the same time.
  • Privacy: the authorization step passes through our relay server. Your health data does not. It stays on your computer.

Training plans, made with AI

  • Hand your condition, sleep and training records to the AI you already use (ChatGPT, Claude, Gemini, Kimi, DeepSeek, Doubao or Grok) and get a week of training.
  • Paste the reply back and it becomes a plan: view it by week, drag to swap days, fine-tune every step of every day, then send it to your watch once you confirm.
  • Save workouts as templates, or import .zwo files and workout .fit files.
  • On a morning when recovery is poor, swap the day’s intervals for an easy session in one tap.
  • Plans sent to your watch can be undone one push at a time, or cleared in one go.

Handing off to AI, simpler

  • Pick the dates and content, and ZeppBridge builds one file and puts it on your clipboard. Press Ctrl+V (⌘V on a Mac) in the AI chat to attach it.
  • On Windows, turn on “Hand off to AI automatically” to have it paste and send for you. It checks the browser window before every step. Off by default.
  • Uses the AI subscription you already have. No extra cost.

MCP included with the installer

  • Connect Claude Code, Codex or Claude Desktop from Settings in one click, so local AI tools can read your data directly.
  • AI tools can draft training plans too. Letting them publish directly requires turning on “Let AI publish training plans directly” (off by default).

A completely new interface

  • Dark and light themes, with glass navigation, switches and wheels.
  • Cards open into pages and return to their place when you go back.
  • Pick days like playing cards: 7 days, 1 month and 6 months fan out layer by layer, and the ones you keep go into a collection box to hand to AI together.
  • Settings is now a card stack. Open one card, or spread them all out.
  • Pin the 3 or 4 metrics you care about most to the home page.
  • Note life events (a cold, a trip, a business week) right on the timeline.
  • Workout details gain an elevation card. Routes are drawn locally by default, with an optional online map (only after you agree).
  • A guided tour with sample data on first use. You can skip it.
  • Ten interface languages.

Silent updates

  • New versions download and have their signatures checked in the background. The logo in the top-left shows the progress and lights up with a green ring when the update is ready.
  • The app is only replaced when you click “Update”. If a sync is running, it waits until the sync finishes.

Platforms

  • Windows: in long-term daily use on real hardware.
  • macOS and Linux: built automatically by CI with all tests passing, but not yet verified on real machines. Feedback is welcome.
Assets 16
Loading