lingcang728/ZeppBridge v3.0.0

ZeppBridge 3.0.0

on GitHub

腕上所记，尽归于你。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.