发布测试报告
本页面是 0.1.6 正式版的静态验证快照，记录
已经验证的范围、主动排除的操作，以及仍需人工验证的项目。
验证范围： 下列自动检查已在本机源码树重新执行。新的系统浏览器与 MCP 认证路径 已有离线覆盖。2026-08-29 还在本机跑通了真实中国区 MFA 的浏览器、session 落盘与 只读调用链路；国际区真实 MFA 也已通过系统浏览器挑战、DI 交换、profile 确认与私有 session 落盘。真实 refresh token 轮换及具体 MCP 客户端的完整认证 UX 仍是兼容性测试缺口。 Codex CLI
0.147.0已在真实 stdio 工具调用中收到 URL elicitation， 但只在原始工具诊断里显示 URL，没有转成一级认证提示。
验证概览
| 项目 | 结果 |
|---|---|
| 测试日期 | 2026-08-29 |
| package manifest | 0.1.6 |
| 发布就绪度 | 自动门禁通过 — 浏览器 MFA 已正式支持中国区和国际区账号；refresh/具体客户端兼容性覆盖继续扩展 |
| 本机自动测试 | 通过 — 38 个套件、824 项测试 |
| TypeScript 构建 | 通过 |
| npm 打包烟测 | 通过 — 179 个文件；压缩后 299.5 kB；解压后 1.2 MB |
| 远程 CI | 发布门禁 — 本提交的 Linux Node 20/22、Windows ACL 与 macOS ACL 任务必须全部通过 |
| 真实 Garmin 集成 | 本次未重跑 — 2026-08-21 的 global 只读基线为 8/8 |
| 两步验证 | 已支持 — 真实 CN 浏览器/session/profile/活动读取链路与真实国际区系统浏览器 MFA/DI/session 落盘均已通过 |
自动验证
在 Node.js 20 或更高版本中，可以用以下命令复现自动检查：
npm ci
npm run test:coverage
npm run build
npm run pack:smoke
测试与覆盖率
| 指标 | 结果 |
|---|---|
| 测试套件 | 38 个通过 |
| 测试 | 824 项通过 |
| 语句覆盖率 | 85.91% |
| 分支覆盖率 | 79.53% |
| 函数覆盖率 | 87.42% |
| 行覆盖率 | 88.83% |
npm run build 已成功完成。npm run pack:smoke 也已通过，检查的 npm 包包含
179 个文件（包含新的本地认证与 MCP 认证 runtime、更新日志及中英文测试报告页面），
压缩后大小为 299.5 kB，解压后大小为 1.2 MB。
测试还覆盖了绝对路径、有界且无 shell 的 Windows PowerShell/.NET ACL 边界、静态编码的
精确 DACL 程序、当前 SID owner、全链重解析点与不可信根目录拒绝、逐层目录 fail-closed
验证/创建，以及在写入凭据字节前先保护空临时文件的顺序。windows-latest 任务会用真实
Windows ACL API 运行该套件，本正式版只会在发布提交的该任务通过后发布。
POSIX 覆盖还包括有效 UID owner 与 owner 写入/执行权限、不安全祖先拒绝、安全链接规范化、
逐级 0700 预创建、no-follow 临时文件，以及原子替换前的父目录/文件再次验证。读取时也会
规范化安全父目录别名，并在绑定已打开文件描述符前后验证完整祖先链和最终私有父目录。
本机 macOS 套件还真实创建了继承式及文件级扩展 ACL：即使 mode 是 0700/0600，任何
授权型 ACL 仍会被拒绝，系统 deny-only ACL 则可保留。CI 已新增 macos-latest 任务重复
这些 Darwin 专项检查。
认证覆盖还包括：Web/CLI/MCP 启动桥页前共用目标目录预检、按内容指纹热加载另一本机进程
写入的 session、只用明确 MFA／CAPTCHA 页面证据分类且不误判含糊 SDK no-ticket／密码／
网络错误、窄范围 Cloudflare managed challenge 识别、可由信号中止的终端提示、SSO 请求、
密码提交等待及自定义 MFA 输入、系统浏览器启动器非零退出、MCP 完成通知超时边界，以及保存
进入不可取消提交点后的排空等待，避免把仍可能成功的原子写入误报为“已取消”。测试还覆盖 Web
在不可取消写入期间卸载、broker 与 controller 的排空超时不串行叠加、失效内联 token 只能由
账号绑定 session 接管，以及 MCP
stdin/退出信号关闭会在有界凭据清理结束前持续拦截终止信号。CLI 的普通 login、browser、
canary 与 serve 关闭同样给首个信号一个有界优雅退出窗口，第二个信号则立即请求强制退出。
本机 dsh 客户端还覆盖每个 Host 粗粒度状态版本只自动打开一次，并串行轮询账号状态，慢 RPC
不会被持续取消；终端登录覆盖空密码与明确浏览器挑战转交共享系统浏览器 broker。
浏览器认证流程现在使用精确的 10 分钟有效期。测试会把已验证的 ticket service 从桥页
消息、服务端提交、流程管理一直原样传到 DI 表单；只接受对应区域的固定 embed service
或本次精确的 http://127.0.0.1:<端口> 桥页 origin。区域不符、其他主机/端口、路径、
查询、fragment、凭据、畸形变体，以及 service 回退/重试都会在 DI 请求前被拒绝。
真实 Garmin 只读集成
本次快照没有重跑真实 Garmin 集成。下表是 2026-08-21 使用本机私有 .env、连接
Garmin global 区域得到的 0.1.5 历史只读基线：
GARMIN_INTEGRATION_VERBOSE=false npm run test:integration
以下 8 项检查全部通过：
| 检查项 | 结果 |
|---|---|
| 身份验证／密码登录 | 通过 |
| 活动 | 通过 |
| 睡眠 | 通过 |
| 步数 | 通过 |
| 心率 | 通过 |
| 体重／身体成分 | 通过 |
| 训练库 | 通过 |
| 用户资料 | 通过 |
此前运行严格限于只读接口，没有创建、更新、安排或删除训练，也没有修改其他 Garmin 数据。运行时明确关闭了 verbose 输出，因此只显示状态和数量，不显示账号标识、活动 明细或健康数值。
中国区浏览器 MFA／DI 验证
经账号所有者明确同意，2026-08-29 使用可见浏览器完成了 Garmin 托管的中国区密码和 MFA 挑战。Garmin 将一次性 service ticket 绑定到本次随机 loopback origin；共享本地 runtime 原样保留 ticket/service 配对，完成中国区 DI 交换，显示安全化 profile 供确认， 并原子写入绑定账号与区域、且仅所有者可访问的 DI v2 session。
落盘文件进一步确认是当前用户所有、mode 为 0600、link count 为 1 的普通非符号链接
文件，schema version 为 2，绑定中国区，access/refresh 凭据均未过期，并通过私有 session
reader 校验。随后新建的只读 Garmin client 使用该文件，完成账号身份核验、profile 探测
及最近活动读取。同进程无需重启的热加载由自动测试覆盖，不作为本次真实账号运行结论。
全程只输出固定阶段名与结果，不记录邮箱、密码、MFA 验证码、Cookie、ticket、Token、 profile 内容、活动明细、响应正文或本地 session 路径。这证明了真实中国区浏览器到 session 再到只读调用的链路，但不代表真实 refresh token 轮换或具体 MCP 客户端的 URL elicitation UI 已通过。
国际区浏览器 MFA／DI 验证
经账号所有者明确同意，2026-08-29 使用已安装的 0.1.6-rc.1 CLI 在系统浏览器中打开
Garmin 国际区认证。账号完成了 Garmin 托管的密码与 MFA 验证；本地 runtime 随后完成
global DI 交换、profile 确认，并落盘了绑定账号和区域的 session。
不输出文件内容的本地检查确认：落盘结果是当前用户所有、mode 为 0600 的普通非符号链接
文件，可通过私有 session reader，绑定 global 区域，且与规范化后的配置账号标识匹配。
本报告不记录邮箱、密码、MFA 验证码、ticket、Token、profile 内容或私有路径。结合共享 runtime
的自动测试覆盖，这证明了 Garmin 两个区域的浏览器 MFA 均已正式支持。
FIT 导出验证
本次验证没有真实下载 FIT 文件，以免在未经用户明确同意时把个人活动文件写入本机。
自动测试已经覆盖 FIT 目标目录规则、ZIP 处理、CRC 校验和安全解压行为。新下载使用 以下目录结构：
<GARMIN_FIT_DOWNLOAD_DIR>/
GARMIN_FIT_<cn|global>_<规范化邮箱>/
<activityId>.fit
已有的 GARMIN_FIT_<邮箱> 目录不会自动迁移。旧文件继续保留在原目录中；只有
新的下载会进入带区域标志的
GARMIN_FIT_<cn|global>_<规范化邮箱> 目录。
由于没有执行真实导出，本报告不声称已经端到端验证 Garmin 压缩包下载、本地 .fit
文件落盘，或将该文件导入设备及第三方应用。
已知验证缺口
以下场景尚未使用真实账号或客户端完成端到端验证：
- 对浏览器生成的 session 实际触发 access/refresh token 轮换；自动 fixture 已覆盖刷新 逻辑，但本次未强制真实账号刷新。
- 在具体客户端中完成 MCP 浏览器认证、完成通知与重试。Codex CLI
0.147.0已完成 stdio 初始化并收到-32042URL elicitation，但 URL 只出现在原始工具 诊断中，未转成一级认证提示；Claude Code 与 ZCode 仍未验证。 - WorkBuddy MCP 客户端烟测。
- ZCode MCP 客户端烟测。
- 真实 FIT 下载以及后续文件导入。
这些项目是本次报告明确记录的限制，不代表测试通过。
隐私与发布说明
- 集成测试使用的私有
.env不属于本报告，禁止提交或发布。 - 本报告不包含密码、session token、MFA 验证码、账号标识、本地目标路径、活动明细 或健康数值。
- 本次没有执行 Garmin 数据写操作。经授权的真实中国区浏览器认证写入了一份本机私有 session，随后只执行 profile 与最近活动读取；经授权的国际区验证另行写入了一份私有 session。本报告不记录任何私密值或目标路径。
- package manifest 为
0.1.6；本快照验证该正式版。
后续每个版本都应重新运行上述自动检查。真实 refresh 轮换、FIT 及客户端烟测只能在 账号所有者明确同意后执行，并继续使用同等的隐私保护措施。