# 发布测试报告

[English](./TEST_REPORT.md)

本页面是 `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 或更高版本中，可以用以下命令复现自动检查：

```bash
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` 历史只读基线：

```bash
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 校验和安全解压行为。新下载使用
以下目录结构：

```text
<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 初始化并收到 `-32042` URL 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 及客户端烟测只能在
账号所有者明确同意后执行，并继续使用同等的隐私保护措施。