🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI
浏览器·0 次阅读·佳明数据助手 插件页

把佳明训练数据接进 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 自动整理,数据来源于插件详情页。

这篇内容有帮助吗
赞赏随意,不解锁任何内容,也不必留个人信息。
扫码用
查看 佳明数据助手 插件详情
安装命令 · 中文 README · 兼容性报告
前往插件页 →
回到顶部