Skip to the content.

新版 Garmin SDK 与 DSH 插件发布检查(2026-10-16,更新于 2026-10-17)

最新进度: 0.1.15 已发布官方 npm并完成本机正式 registry 安装、来源审计及重启验收。Harness 0.2.1-rc.1 / Node 24.21.0 下插件无异常,1 个组件运行、两个主账号已登录,设置表单及添加按钮正常;来源为 [email protected],已无 file: 来源。0.1.14 的发布和兼容阻断作为历史保留,最新记录见文末。

判断

维护 SDK 与插件 0.1.15 均已发布官方 npm,registry 完整性与精确发布包一致。插件已从官方 registry 安装至本机,并通过新 Host 上的完整性、兼容声明及重启 UI 验收。

新增接口已经接通 SDK、插件客户端、共享 service、DSH registry 和 MCP。中国区和国际区各一个账号的 13 个新方法实测均通过,完整数据与空数据都能通过工具层。

@likenttt/[email protected] 已于 2026-10-17 发布至官方 npm。插件的 package.json 和 package-lock.json 已改为 npm:@likenttt/[email protected] 别名与官方 registry tarball,保留 garmin-connect 导入名称。发布包完整性与之前验证过的 SDK tarball 一致:

sha512-P8oLO9ykOfceUlIDphO1Dw2be9wbmqtt32ojyPCgZQ55SJ2a53+eqVHCYZFM8dlbYXvgX7qdkG0/SJvCsYn5+g==

此前 Git 依赖被 Harness 的 pnpm 安全策略拒绝;registry 预编译包已去掉 Git 安装和构建要求。安全策略仍保持启用。早期候选包已通过桌面官方 CLI 正式安装并重启验证,旧开发覆盖标记已移除;插件随后以 0.1.14 正式发布,详见文末。

新增 13 个 API

SDK 方法 DSH / MCP 工具
getHrvData get_garmin_hrv
getHrvSummaries get_garmin_hrv_summaries
getStressData get_garmin_stress
getStressSummaries get_garmin_stress_summaries
getBodyBattery get_garmin_body_battery
getTrainingReadiness get_garmin_training_readiness
getDailyTrainingStatus get_garmin_daily_training_status
getTrainingStatus get_garmin_training_status
getTrainingLoadBalance get_garmin_training_load_balance
getMaxMetrics get_garmin_max_metrics
getMaxMetricsRange get_garmin_max_metrics_range
getRacePredictions get_garmin_race_predictions
getRacePredictionsRange get_garmin_race_predictions_range

插件工具总数由 10 增至 23。单日方法使用 date;范围方法使用 startDate / endDate,默认今天至今天;预测范围可选 aggregation: daily | monthly,最大日期差 366 天。DSH 多账号环境使用设置页中的稳定 account ID,MCP 使用当前进程配置的账号。比赛预测不接受外部 displayName 来改变查询对象。

方法保留原始对象、全部设备、时序和快照,不做 compact 裁剪。null、空数组、零值和未知字段都保留;DSH 输出 schema 也已允许正常的 null。

已完成的验证

检查 结果
SDK 构建及严格 TypeScript 消费者声明检查 通过
SDK 单元测试 59 / 59 通过
插件 host、client declarations、client bundle 构建 通过
插件完整单元测试(npm alias 候选) 42 套、992 / 992 通过;随后新增 8 项锁校验测试,专项 28 / 28 通过;当前共 1,000 用例,未声称一次全量跑完 1,000 项
首轮源码干净安装(此前 Git 候选) 无 node_modules、lib 或私密配置,禁止 SSH 的 npm ci、构建和 check:sdk 均通过;npm alias 候选另经桌面官方 CLI 安装验证
Harness 内置 Node 24.18.1 下 SDK 单元测试 59 / 59 通过
同一 Node 24 下关键插件测试 138 / 138 通过,覆盖新增 wrapper、DSH、MCP、DI 与 interceptor
SDK 打包检查 维护版 1.7.0:64 文件,47,420 字节压缩;含全部新方法与声明,无 session、账号配置或测试文件
插件打包检查(npm alias 候选) 185 文件,353,420 字节压缩;无凭据,包含公开模板 .env.example
真实 session 的 DSH execute 两区各 13 个,共 26 / 26 通过
真实 MCP callTool 对照 两区共 26 / 26 与 DSH 完整结果深比较一致,缓存命中且无新增 HTTP 响应
旧功能基线 两区的 profile、最近一条活动、单日睡眠,共 6 / 6 通过
桌面官方 CLI 安装 --ignore-scripts + 官方 registry 安装退出 0;实际 npm alias、SDK 身份、13 个方法及 pnpm 锁完整性均通过;60 个 SDK dist 文件与已发布包逐字节一致
桌面界面 安装后重启 Harness 0.2.0-rc.2,Garmin 组件显示“运行中”;两主账号“已登录”,第三账号待登录

新增离线测试覆盖账号隔离、认证切换时丢弃旧缓存及进行中响应、并发合并、超时恢复、严格参数校验、366 天边界、MCP 认证弹窗与错误脱敏。维护库依赖门槛现共 28 项专项测试,拒绝上游包、浮动 Git 分支、短 SHA、错误仓库、缺失 API、错误的 npm alias 版本,以及别名切换后残留的旧 Git 锁记录;存在锁文件时验证根别名、安装包名/版本和官方 registry 精确 tarball URL。

本次真实查询范围

机器可读证据见 脱敏实测结果。

本机实际替换情况

本次没有使用主工作目录中的旧 0.1.6 插件。开发源为:

/Users/kent/.codex/worktrees/activity-full-default-018/garmin-connect-plugin-for-dsh
branch: codex/health-recovery-tools

/Users/kent/deepseek/garmin-connect
branch: codex/health-recovery-apis

通过官方 CLI 安装 npm alias 候选

2026-10-17,桌面自带 CLI 已成功安装,进程退出 0:

'/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh' \
  plugin --profile desktop add \
  '/Users/kent/.codex/garmin-release-checks/2026-10-17/plugin-npm-candidate/dsh-plugin-garmin-connect-0.1.13.tgz' \
  --ignore-scripts --registry=https://registry.npmjs.org/

profile 的 package.json 现在登记该候选的 file: tarball,插件真实依赖为 npm:@likenttt/[email protected]。实际安装目录为:

~/.dsh/profiles/desktop/node_modules/dsh-plugin-garmin-connect
~/.dsh/profiles/desktop/node_modules/garmin-connect

实际 SDK 包名为 @likenttt/garmin-connect、版本 1.7.0,13 个新方法均存在;pnpm 锁文件的官方 npm 完整性与已发布 tarball 匹配,SDK 全部 60 个 dist 文件逐字节一致。LOCAL-DEVELOPMENT.json 已不存在,不再使用此前手工覆盖的标记。安装后重启 Harness 0.2.0-rc.2,组件显示运行中,中国区与国际区两个主账号已登录,第三账号待登录。

pnpm 自动追加了唯一的发布时间豁免:

minimumReleaseAgeExclude:
  - [email protected]
  - '@likenttt/[email protected]'

其他策略与原值一致,blockExoticSubdeps 默认保持启用,没有添加 SDK 的 allowBuilds。安装使用预编译 registry 包,不需要 Git 子依赖或依赖构建放行。

桌面显示的插件版本仍为 0.1.13,这是本地候选,不代表 npm 上的 0.1.13 已有这些功能。本次安装的候选包为 185 文件、353,420 字节,其完整性记录在机器可读证据中;最终 README/CHANGELOG 文档是在此候选安装后补全,属于后续插件发版准备,未重新打包或发布插件。

本机脱敏安装记录:

/Users/kent/.codex/garmin-release-checks/2026-10-17/desktop-npm-install-report.json

历史 Git 候选安装阻塞

此前曾尝试桌面官方 dsh plugin --profile desktop add 安装 Git 依赖候选 tarball,依次遇到:

  1. ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED:Git 源需执行 TypeScript 编译。曾仅为这个固定提交添加构建允许项。
  2. 编译成功后,ERR_PNPM_EXOTIC_SUBDEP:Host 的 blockExoticSubdeps 策略拒绝 Git 子依赖。

没有关闭该策略;临时构建允许项已移除。这次 Git 候选安装失败属于历史记录;发布 SDK 并切换为 npm alias 后,新的桌面 CLI 安装已经通过。

本次正式 npm 来源安装前的插件、SDK 和 profile 清单/锁文件/策略已备份,未复制账号 session:

/Users/kent/.codex/garmin-release-checks/2026-10-17/desktop-before-npm-source

较早开发覆盖前的历史备份仍保留在 2026-10-16/desktop-before。

如需回到公开旧版,先退出 Harness,再通过桌面官方 CLI 重新安装官方包,以同步恢复 profile 登记来源和实际安装内容:

'/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh' \
  plugin --profile desktop add \
  'https://registry.npmjs.org/dsh-plugin-garmin-connect/-/dsh-plugin-garmin-connect-0.1.13.tgz' \
  --ignore-scripts --registry=https://registry.npmjs.org/

安装后重新启动 Harness。这不会回滚正常刷新的账号 session。此前的 restore-desktop.cjs 只恢复安装文件,不能恢复本次改变的 profile 注册来源,不应作为这次正式安装的完整回滚方式。

已完成的分发步骤与剩余发布条件

  1. 维护 SDK 已发布官方 npm。 包为 @likenttt/[email protected],registry 完整性与已验证的 tarball 一致,已不需要 Git 依赖的构建允许项。
  2. 插件依赖已切换为正式 npm alias。 package.json 和 package-lock.json 已使用 npm:@likenttt/[email protected] 及官方 registry 归档。prepublishOnly 和 pack:smoke 已接入 check:sdk。该候选的 host/client 构建、42 套 992 项全量测试与增强锁文件来源检查已通过;随后新增 8 项防旧 Git 锁残留测试,相关专项 28 项通过。较早的源码干净安装与当前官方 CLI 的 registry 依赖安装分别记录。
  3. 旧 Host 上的候选安装入口曾通过。 此前 registry 候选安装退出 0,SDK 身份、13 个方法、锁文件完整性、全部 60 个 dist 文件与旧 Host 上的插件/账号状态均已核验;仅为精确 SDK 版本追加发布时间豁免,其他安全策略不变。随后正式 0.1.14 源安装完成,但 Host 自动升级引入 peer 兼容阻断,当前状态见文末。
  4. 插件已以 0.1.14 发布官方 npm。 早期 0.1.13 本地候选未作为该版本发布;正式 0.1.14 tarball 的 registry 完整性已读回确认,详见文末记录。

首轮中国区连接异常仍需留作稳定性观察。测试覆盖当前两个账号与这些日期;月度预测、更多设备和第三个账号不属于本次线上样本。桌面检查验证插件挂载与账号状态,没有在 Harness 中自动发送新的模型对话。

后续如何复测

已有可复用脚本 scripts/check-health-release.cjs。它会经过真实 GarminClient → GarminToolService → DSH execute / MCP callTool,并只输出状态和响应结构;私密 manifest 格式与运行命令见 中文测试说明。运行前关闭读取同一 session 的其他进程,manifest 必须为当前用户所有的 0600 文件,报告路径必须是新文件。

本机安装好维护版依赖后,基础离线复测为:

# SDK 仓库
npm test

# 插件开发 worktree
npm run build
npm run check:sdk
npm test -- --runInBand
npm run pack:smoke

0.1.14 发布记录(2026-10-17)

发布包与分发进度

本次发布已获用户授权,使用已校验的同一份精确 tarball。官方 npm 发布命令退出 0,registry 已确认 published:latest 为 0.1.14,完整性与本地发布包精确匹配,维护库依赖仍为精确 npm alias。

字段 记录
插件 [email protected]
Registry https://registry.npmjs.org/
发布时间 2026-10-17 15:29:06.060(Asia/Shanghai)
Registry 读回时间 2026-10-17 15:29:22.204(Asia/Shanghai)
Registry tarball 官方 0.1.14 发布包
发布包 dsh-plugin-garmin-connect-0.1.14.tgz
大小 361,188 字节压缩,1,467,464 字节解压,186 个文件
维护 SDK npm:@likenttt/[email protected]
源提交 9e0f3858917081975de1ec5538ca589b142a2eba
SHA-256 15dac70810e6f0480ba52ed8fa23725c386caf2ca2075cd909cc2263a5255153
文件检查 所需文件齐全;无私密文件,保留公开模板 .env.example
sha512-YUpwapBZFC51+jbII80nj+877HQANMbgIP+4Qs1tYl3y7TfY66WFRiqcSZq9AsIXkjNB+TvpTuPmNk426/4gPg==

本轮验证与历史结果的区分

验证 结果
0.1.14 host/client 构建 通过
check:sdk 通过;精确维护版 npm 依赖,13 个方法齐全
本轮 Node 26.3.0 全量尝试 严重本机内存压力下出现 25 项文件 I/O 超时,随后中止,退出码 130;未观察到语义断言差异,不能记为全量通过
Harness Node 24.18.1 最小会话恢复用例 默认 5,000 ms 限制下通过,用例耗时 1,485 ms
本轮 Node 24.18.1 缩小复测 client.test.ts 与 session-store.test.ts 共 2 套、99/99 通过,总耗时 4.558 秒;仍使用默认 5,000 ms 限制,覆盖此前全部 25 项超时用例
历史全量与后增测试 42 套、992/992 全量通过;之后新增 8 项锁校验,相关专项 28/28 通过;另有训练建议相关专项 135 项通过

这些运行分别保留,不合并成一次 1,000 项全量通过。本轮未修改测试超时或运行时源码;运行时源码从 a358e6b 起未变。维护 SDK 的 59 项测试与类型检查继续作为独立证据。

本机 DSH 状态

当前状态为 formal-registry-installed-host-incompatible。官方 registry 来源的 0.1.14 安装命令已退出 0,使用 pnpm 11.7.0;但 Harness 重启时从 0.2.0-rc.2 自动升级到 0.2.1-rc.1,界面中的 0.1.14 插件异常、running=false。该版本的 0.2 系列 client peer 范围仅声明 0.2.0-rc.1 和 0.2.0-rc.2,未包含新 Host。正式源安装完成不能记为插件已成功运行,officialRegistryInstallVerified 仍为 false;兼容修复需要另一个插件版本。

此前在 旧 Host 0.2.0-rc.2 上,通过这份 0.1.14 本地发布 tarball 完成的界面检查仍保留为历史:插件已启用、1 个组件运行中、两个主账号均已登录。这些结果不作为升级后 0.2.1-rc.1 的当前运行证据。机器可读记录中的 historicalLocalTarballCheck 保存旧检查;当前 desktop.status、desktop.hostVersion 和 desktop.running 单独记录本次兼容阻断。

本次追加记录只更新 GitHub 源文档,不改变已校验发布包。机器可读新增条目位于脱敏证据的 pluginRelease014;早期 0.1.13 候选记录保留。

0.1.15 兼容补丁发布记录(2026-10-17)

当前发布状态为 published,官方 npm 已确认 latest=0.1.15,registryConfirmed=true,完整性与精确 tarball 一致;本机 officialRegistryInstallVerified=true,localRuntimeVerified=true。本机 Harness 自动从 0.2.0-rc.2 升级到 0.2.1-rc.1,使已发布的插件 0.1.14 超出原 peer 兼容声明;0.1.15 已补齐并通过正式 registry 安装后的运行验证。

0.1.15 本机正式安装与运行验收

此前本地候选安装使用 pnpm 11.28.5,从 0.1.14 更新至精确的 0.1.15 本地 tarball,退出 0、耗时 1 分 30.1 秒,下载 3 个包、添加 7 个包。该阶段保留为历史,不作为当前来源。

随后正式 registry 安装使用 pnpm 11.28.5,命令退出 0,耗时 7.5 秒。当前本机状态为 formal-registry-installed-and-runtime-verified,正式来源切换已完成:

0.1.15 精确发布包

字段 记录
发布包 dsh-plugin-garmin-connect-0.1.15.tgz
Registry https://registry.npmjs.org/,latest=0.1.15
发布时间 2026-10-17 17:51:07.891(Asia/Shanghai)
Registry 读回时间 2026-10-17 17:51:27.101(Asia/Shanghai)
Registry tarball 官方 0.1.15 发布包
源提交 faaffbb2db85028b4625408a67ad1054c2f53e80,已推送 GitHub
Git tag v0.1.15 指向上述源提交,已推送 GitHub
大小 361,462 字节压缩,1,468,379 字节解压,186 个文件
SDK npm:@likenttt/[email protected]
SHA-256 a458b339456f9f78919d7898795c90801f8fbabf229c0ac6c297ff529f177848
私密文件检查 0 个私密文件
sha512-eJkxY5Ti02n1fww9BM5bNwnOqMzXZVw/zVVorgnhIEkRyFWLK7zX4b2QSKjbmd36xq3r6dm03QQtavRBTcfeUQ==

机器可读发布记录为脱敏证据中的 pluginRelease015。此前 0.1.14 的发布成功、旧 Host 运行及新 Host 兼容失败记录均保留。