把佳明训练数据接进 AI 之前,先弄清三条认证链
佳明 Connect 的数据能不能进模型上下文,分界线不在"读不读得到",而在"凭据走到了哪"。 Likenttt/garmin-connect-plugin-for-dsh 把登录、换票、落盘拆成三段接力,模型只看得到工具返回值。星标 55、周下载 949、综合分 52.7,latest 0.1.22,MIT。
佳明 Connect 的数据能不能进模型上下文,分界线不在"读不读得到",而在"凭据走到了哪"。Likenttt/garmin-connect-plugin-for-dsh 把登录、换票、落盘拆成三段接力,模型只看得到工具返回值。星标 55、周下载 949、综合分 52.7,latest 0.1.22,MIT。
三条链不是三个入口,是一次认证的三段接力
"三条认证链"不是可以任选的三套登录方式,而是同一次认证必须依次穿过的三段:
1. 网页登录链:Garmin 的 GAuth 页面嵌在随机端口的本机桥页里,账号、密码、MFA 验证码、CAPTCHA 都留在 Garmin 的 origin。
2. DI 交换链:登录后拿到一张短期、一次性的 service ticket,桥页校验来源与区域后交给 Host,换成 DI session 与 refresh 凭据。
3. 本地凭据链:结果以 owner-only 权限原子写盘,并绑定规范化账号、区域与刚探测到的 profile。
日常读取只是这三段的消费者,不是第四链。
第一条:登录表单始终留在 Garmin 那边
要做的不是把验证码框搬进聊天窗口,而是让输入框永远不出 Garmin。插件在本机起一个只监听 127.0.0.1 的桥页,用 iframe 嵌入官方 GAuth 页面,外层 dsh 只收进度。
难点全在细节:跨域消息、iframe 里的官方样式、CSP 与 Trusted Types、第三方 frame 策略、MFA 重定向与 ticket/service 的绑定。
窗口是硬的:登录、MFA 与 profile 确认必须在桥页的 10 分钟内完成。中国区与国际区的真实 MFA 都在 2026-08-29 于本机跑通过,但仅限同机,不是托管服务。
第二条:ticket 只到桥页,换票由 Host 完成
ticket 短期、一次性;中国区在 MFA 之后可能把它绑到本次精确的 http://127.0.0.1:<端口>。插件原样保留 ticket 与 service 的配对:不改写 service、不跟随重定向、不做后备重试。
能长期使用的是交换出来的 session 与 refresh 凭据,不是 ticket 本身,有效期仍由 Garmin 决定。交换后 Host 探测 profile,用户确认账号与邮箱对应才写盘;模型与工具都拿不到 ticket、token、密码或验证码。
第三条:落盘那一刻把三样东西钉在一起
DI v2 用不可逆摘要把规范化 username、region、profile(含 profileIdHash)绑在一起,不重复保存明文邮箱;运行时拒绝三者对不上的文件。
权限是底座:POSIX 下文件通常 0600、父目录 0700,整条祖先链都要过校验,某一级可被同组写入就拒绝启动,而不是悄悄 chmod;macOS 还查扩展 ACL。refresh token 会轮换,新值先写回再使用,同一文件不许被多进程并发共享。
读取阶段怎么用上这份 session
客户端只热加载"内容已变化、账号匹配、校验通过"的 session;token 提前刷新;只有幂等 GET 允许最多重放一次,写请求不因刷新重放;内存缓存压住调用量。
形态有三种:Harness 注册 30 个工具,共享工作区 MCP 31 个,旧版单账号 29 个,Personal API 15 个。装法可以看 dsh-plugin-garmin-connect 详情页。
四个容易踩的边界
坑一 · 浏览器策略一收紧,登录就停在半路
现象:桥页开了,Garmin 页面空白,或 MFA 提交后一直转圈。原因:GAuth 依赖第三方 Cookie 与 iframe,策略收紧时单次流程被阻断;插件只支持 loopback 本机网页。解决:先在常规浏览器里重试,必要时在对话框里启用兼容浏览器(CDP)后备,它用临时 profile 起独占的 Chromium 进程,不碰日常浏览器的 Cookie。
坑二 · 换了新版本,可用工具没变多
现象:升级了包与技能文件,可调用工具仍是原来那些。原因:工具在进程启动时注册,更新 SDK 或技能不会给运行中的旧连接加工具。解决:重启 MCP 进程、重载连接器,再按当前会话 schema 核对。
坑三 · 旧构建把宿主上界写死,装上去不加载
现象:装完在插件列表里看不到,或显示未启用。原因:旧版本把 dsh 上界声明成 <0.2.2-0,新宿主检查直接拒载。解决:装含修复的构建(0.1.21 起放行 0.x 客户端 SDK),再看是否"已挂载、已启用";本站 4 天前在 dsh 0.2.2-rc.1 上真实装过一次。
坑四 · 默认详情里带着精确路线
现象:只问"最近五次跑步",回来却是带位置的长文本。原因:get_garmin_activities 默认 full,保留扩展字段与分段摘要,可能含精确路线。解决:单次调用改 compact,或固定 GARMIN_ACTIVITY_DETAIL=compact。
总结
这套设计把"能不能看我的训练数据"拆成三个可分别检查的问题:密码有没有离开 Garmin 页面、ticket 有没有被复用、落盘有没有绑对人。想对照同类插件的中文清单与安装形态见 精选插件 Top 榜。
适合与不适合
适合:日常看 Connect 的佳明用户,想让模型直接读睡眠、HRV 与活动分段;需要两区双账号并行的人;在意凭据不出本机、能接受同机完成一次 MFA 的用户;想把活动 FIT 归档到本机分析的情况。
不适合:没有佳明设备、也不用 Connect 的,装了没数据可查;想在服务器或容器里跑远程登录的,它只支持本机 loopback 网页;在意健康与位置数据进上下文的,得自己先做脱敏;只想拿一份现成计划、却不愿回答六组问询的,个性化模式只会反复追问。
标签:dsh-plugin-garmin-connect、DeepSeek Harness、认证链、健康数据、browser 插件
本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。