更新日志¶

基础 SDK 与 SessionReplay 按同一 NuGet 版本发布，分别记录变更。Native/vcpkg 与 Electron Adapter 使用各自的版本号；Native 的可选 Replay Feature 随同一个 port 版本交付。

Guance.Windows¶

0.1.0-alpha.11 (2026/10/19)¶

1. WebView2 中的 Browser RUM 新增 sdk_pkg_info，通过 web 记录页面 Browser SDK 版本，宿主 SDK 身份保持不变。
2. 修复 Browser RUM Bridge 依赖 Replay 开关的问题；关闭 Replay 或未安装可选组件时也可正常接入 Browser RUM。
3. 修复字符串字段中的换行可能拆分上报记录的问题，并避免 SDK 自身上传请求被重复采集为 Resource。
4. 新增 GetUploadQueueDiagnosticsSnapshot()，用于查看 RUM、Log 待写入数量和 Replay 队列状态。

0.1.0-alpha.9 (2026/10/07)¶

1. 基础包移除 Replay 实现，保留原有配置、录制控制和隐私 API。已有 Replay 应用升级时需添加同版本的 Guance.Windows.SessionReplay。
2. 新增客户端 IsSessionReplayAvailable，用于判断可选组件是否实际可用。组件缺失、版本不匹配或加载失败时输出诊断，普通 RUM、Log、Trace 继续工作；WebView2 仅在组件实际可用时声明 records 能力。
3. 基础包与 SessionReplay 按同版本打包和发布，Replay 组件的功能见下方独立版本说明。

0.1.0-alpha.7 (2026/08/15)¶

1. .NET RUM 与 Log Intake 请求现在默认启用压缩，可通过 CompressIntakeRequests = false 关闭。
2. 修复 .NET 与随包 Native 运行时的 Deflate 请求体格式，统一使用符合 Content-Encoding: deflate 的 zlib 包装。

0.1.0-alpha.6 (2026/08/13)¶

1. 新增按 RUM 应用 ID 隔离的持久化匿名用户标识，未登录用户在进程重启后仍保持一致，并自动关联 RUM 与 Log 数据。
2. 随包 Native 运行时默认自动采集应用冷启动和热启动 Action。
3. 随包 Native 运行时的 RUM 与 Log Intake 请求默认使用 Deflate 压缩。
4. 修复 Session Replay 可能上传缺少关联 View ID 分段的问题。

0.1.0-alpha.4 (2026/08/12)¶

1. 新增 GuanceConfig.DataModifier 和 GuanceConfig.LineDataModifier，支持在缓存前修改 RUM、Log 与 Resource 数据的标签和字段。
2. 新增 RumPrivacyConfig.CaptureHttpHeaders 和 RumPrivacyConfig.RedactedHeaderNames，支持按需采集 HTTP 请求与响应 Header，并对敏感 Header 脱敏。
3. 新增 GuanceConfig.DiagnosticListener、GuanceSdk.AddDiagnosticListener(...) 和 GuanceSdk.GetDiagnosticsSnapshot()，用于本地配置与运行状态排查。
4. GuanceClient.StartAction(..., bool needWait, ...) 与 GuanceSdk.StartAction(..., bool needWait, ...) 支持显式等待完成；Action 统一增加高频调用保护、View 切换完成和最长 5 秒持续时间限制。
5. Windows 崩溃、应用无响应和网络错误统一使用 RUM 错误分类与字段结构。
6. 隐私规则统一在应用数据修改器之后执行。

0.1.0-alpha.2 (2026/08/09)¶

1. 新增自动 Trace 传播、应用启动追踪和 Logging 数据上报能力。
2. 新增共享桌面端 Sample 配置，并补充公共 API 集成示例。
3. 新增 WPF、WinForms、WinUI 3 和 Electron Sample 的实验性 Session Replay 验证能力。
4. 加强解决方案级 NuGet 打包、Native 运行时资产和消费端验证。
5. 扩展有界缓存、诊断、隐私和上传配置 API。

0.1.0-alpha.1 (2026/08/09)¶

1. 首次发布实验性 观测云 Windows 可观测性 SDK。
2. 新增 RUM、分布式链路追踪、日志、上传调度和有界文件缓存的托管 API。
3. 提供 Windows x86、x64 和 ARM64 Native 运行时资产。
4. 支持 WPF、WinForms、WinUI 3、WebView2 和 Electron 集成。
5. 新增默认关闭、可按需启用的实验性 Session Replay 能力。

查看 Guance.Windows 源码更新日志

Guance.Windows.SessionReplay¶

0.1.0-alpha.11 (2026/10/19)¶

1. 精确依赖同版本 Guance.Windows，配合基础 SDK 查询 Replay 待编码、待持久化队列状态。

0.1.0-alpha.9 (2026/10/07)¶

1. 首次发布独立的可选 NuGet 包，承载托管 Replay 的录制、编码、持久化和上传实现，精确依赖同版本 Guance.Windows。
2. 原有配置、录制控制和隐私 API 继续通过基础 SDK 使用。安装不会自动启用 Replay，仍需显式开启配置和录制；Replay 保持实验性能力。
3. 沿用基础 SDK 的 Session 关联、采样和隐私配置。组件不可用时由基础 SDK 输出诊断并继续普通 RUM、Log、Trace。
4. 该包不包含 Native Replay DLL；C/C++ 和 Electron 使用下方 Native/vcpkg 版本提供的可选运行时。

查看 Guance.Windows.SessionReplay 源码更新日志

Guance.Windows.Native¶

0.1.0-alpha.11 (2026/10/19)¶

1. 修复 0.1.0-alpha.10 拆分 Replay 组件后，Electron Bridge 转发的 Browser Session Replay 全量快照和增量记录被拒绝，导致 Replay 分段无法上传的问题。Session 标识继续由 Native Core 统一管理。
2. 使用 Replay 的 Electron Full Mode 升级时需同时更新同版本、同架构的基础 Native 运行时和 Replay 补充组件；Mixed Mode 需更新宿主的 guance-windows-native[replay] 依赖。Replay 修复本身无需修改 npm Adapter JavaScript 或 NuGet 托管 Replay 实现。
3. 配合 npm Adapter 0.1.0-alpha.6 新增 sdk_pkg_info：宿主 RUM / Log 记录 electron，Browser RUM / Log 在版本可用时额外记录 web，Full Mode 和 Mixed Mode 的规则一致。

0.1.0-alpha.10 (2026/10/07)¶

基础 Native SDK¶

1. 基础 DLL 移除 Replay 实现，保留原有 C 配置和控制接口。仅使用 RUM、Log、Trace 时安装基础 port 即可。
2. 新增 guance_rum_is_session_replay_available()；组件缺失或无法加载时禁用 Replay 并诊断，普通 RUM、Log、Trace 继续工作。

Session Replay Feature¶

1. 同一 port 的 replay Feature 安装独立 Replay DLL。基础 DLL 按需加载同目录组件，并校验模块 ABI 和 SDK 版本。
2. Replay DLL 需与基础 DLL 保持相同版本和架构。已有 Replay 应用升级时需补充选择该 Feature，安装后仍需显式启用 Replay。

Electron Windows 运行时¶

1. 随本版本为 x64、x86、ARM64 分别交付基础运行时和 Replay 补充归档，共六份归档及对应校验文件。
2. Full Mode 和 Mixed Mode 的 Bridge 均依据配置和实际组件可用性声明 Replay 能力；缺失组件时不声明 records。Mixed Mode 的 Replay 组件由宿主的 replay Feature 提供。

0.1.0-alpha.7 (2026/08/15)¶

1. 修复 Native RUM 与 Log Intake 请求的 Deflate 格式，改为使用符合 Content-Encoding: deflate 的 zlib 包装。

0.1.0-alpha.6 (2026/08/13)¶

1. Native RUM 与 Log Intake 请求默认使用 Deflate 压缩，并新增 compress_intake_requests 开关和 flush_interval_ms 周期 Flush 配置。
2. 新增按 RUM 应用 ID 隔离的持久化匿名用户标识，在进程重启后保持一致，并供 Native 与 Electron 遥测复用。
3. Native 与 Electron 集成默认自动采集冷启动和热启动 Action；可通过 enable_app_launch_tracking 或 enableAppLaunch 关闭。
4. Session Replay 不再上传缺少关联 View ID 的分段。

0.1.0-alpha.5 (2026/08/12)¶

1. 新增可选的 electron-adapter vcpkg Feature，为混合模式应用安装 SDK 提供的 Electron Main Process 与 Preload 公共入口。
2. 新增进程内 Electron Bridge Server C API，支持将 Browser 遥测数据写入由应用持有的 Native SDK Handle。
3. Electron Adapter 的全量模式和混合模式新增 Browser Log 与实验性 Browser Session Replay 转发。
4. electron-bridge vcpkg Feature 现在同时安装 Electron Adapter、Bridge EXE 和匹配的 Native 运行时。
5. Electron Session Replay 的启用状态与隐私级别统一以 Native Bridge 能力为准；Native Replay 关闭时不再声明 records 能力，并拒绝 Replay 输入。

0.1.0-alpha.4 (2026/08/12)¶

1. 新增 guance_rum_start_action_ext(..., int need_wait)，支持创建需要显式结束的 Native RUM Action。
2. Native Action 统一增加高频调用保护、View 切换完成和最长 5 秒持续时间限制。
3. Native 崩溃和应用无响应事件统一使用 RUM 错误分类与字段结构。
4. 新增 guance_sdk_get_version()，支持读取编译进 Native 运行时的发布版本；RUM、Log 与 Session Replay 数据通过 sdk_version 上报该版本。
5. 新增 guance_sdk_write_electron_bridge_line(...)，支持将校验后的 Browser RUM、启动、错误、Log 与 Replay Bridge 消息写入由应用持有的 SDK Handle。
6. 新增 guance_rum_add_launch_action_ext(...)，支持将启动 Action 关联到已有的 Browser View。
7. Electron Bridge 统一由 Native Core 管理 Session 标识，不再接受 Browser 侧 Session 覆盖。
8. Electron 冷启动 Action 会在限定时间内等待并关联首个主 Browser View；未出现 View 时按超时回退处理。

0.1.0-alpha.3 (2026/08/11)¶

1. 新增 guance_configure_data_modifiers(...)，支持在缓存前修改 Native RUM 与 Log 数据的标签和字段。
2. 新增可选的 HTTP 请求与响应 Header 采集，并支持配置敏感 Header 脱敏。
3. 新增可选的 electron-bridge vcpkg Feature，用于安装 guance_windows_electron_bridge.exe 及其 Native 运行时依赖。
4. URL 与 HTTP Header 隐私规则统一在应用数据修改器之后执行。
5. Native Resource 完成事件支持携带请求与响应 Header，并在 SDK 内执行隐私过滤。

0.1.0-alpha.2 (2026/08/09)¶

1. 新增 Native Crash 和 UI Hang 监控，并支持在下次启动时恢复上报。
2. 新增 WinHTTP Trace 自动传播和 Resource 自动采集能力。
3. 新增 Native Console 集成 Sample，并扩展公共 C/C++ SDK 头文件。
4. 加强 Native 打包、CMake、Release Tag 和 vcpkg 注册表验证。
5. 扩展 Electron Native Bridge 和实验性 Session Replay 诊断能力。

0.1.0-alpha.1 (2026/08/07)¶

1. 首次发布实验性 Windows x64 动态库。
2. 提供 RUM、分布式链路追踪、日志、Native 监控和诊断的稳定 C ABI 接口。
3. 提供可安装的 GuanceWindowsNative CMake 包和 Guance::WindowsNative Target。
4. 提供不依赖默认 SQLite 的有界文件队列。
5. 新增默认关闭、可按需启用的实验性 Session Replay 能力。

查看 Guance.Windows.Native 源码更新日志

Electron Native Adapter¶

0.1.0-alpha.6 (2026/10/19)¶

1. Windows Full Mode 和 Mixed Mode 自动向 Native Core 提供 npm Adapter 版本，用于 sdk_pkg_info.electron；Browser RUM 和 Browser Log 保留页面 SDK 版本，用于 web。
2. Windows x64、x86、ARM64 的默认 Native Runtime 更新为 vcpkg_0.1.0-alpha.11，可选 Replay 补充组件使用同版本、同架构。macOS 默认仍为 1.6.8-alpha.6。

0.1.0-alpha.5 (2026/10/07)¶

1. @cloudcare/electron-native-adapter 新增 Windows Replay 补充组件安装，支持 --with-replay、--replay-archive 和对应 postinstall 环境变量。
2. 安装器校验基础与 Replay 清单的版本、架构、来源和文件哈希；stageWindowsRuntime() 同时复制已安装的 Replay DLL 和 replay-manifest.json 到 ASAR 外。
3. 已发布 npm 包的 Windows 默认 SDK 为 vcpkg_0.1.0-alpha.8，macOS 默认 SDK 为 1.6.8-alpha.6。使用 0.1.0-alpha.10 及后续拆包版本时，全量模式需显式选择对应 Native SDK，并安装匹配的 Replay 补充组件后启用配置。
4. 混合模式由 C++ 宿主提供 Replay 组件，Adapter 根据 Bridge 的实际能力决定是否转发录制数据。组件缺失时普通 RUM 继续工作。

查看 Electron Native Adapter 源码更新日志