Merge pull request #140 from flashcatcloud/docs/miniprogram-sdk-review-fixes

docs: fix WeChat miniprogram SDK docs (package name, tracing sampleRate, domain allowlist, error sources)

Author: Fiona2016

en/rum/quickstart/app-management.mdx

@@ -75,7 +75,7 @@ The console provides detailed integration guides for each platform:
 - **JavaScript (Web)**: After configuring parameters like service name, preview the `flashcatRum.init()` initialization code in real-time
 - **Android**: Shows complete integration steps including adding Gradle dependencies (`cloud.flashcat:dd-sdk-android-core` and `cloud.flashcat:dd-sdk-android-rum`), initializing the SDK in `Application.onCreate()` with RUM enabled, and optional WebView tracking integration
 - **iOS**: Shows complete integration steps including adding Swift Package Manager dependency (`fc-sdk-ios`, from version 0.3.0), initializing the SDK in `AppDelegate.didFinishLaunchingWithOptions` with RUM enabled, and optional WebView tracking integration
-- **WeChat Mini Program**: Fill in `env`, `service`, `version`, and `sessionSampleRate` in the form, and the `flashcatRum.init()` snippet built on `@flashcatcloud/fc-sdk-miniprogram` is generated and previewed in real time (see "WeChat Mini Program SDK Configuration Assistant" below)
+- **WeChat Mini Program**: Fill in `env`, `service`, `version`, and `sessionSampleRate` in the form, and the `flashcatRum.init()` snippet built on `@flashcatcloud/miniprogram-rum` is generated and previewed in real time (see "WeChat Mini Program SDK Configuration Assistant" below)
 
 Each platform's SDK configuration page automatically fills in the current application's `applicationId` and `clientToken`, so you can copy the code directly into your project.
 
@@ -141,15 +141,15 @@ No save action is needed — the preview snippet updates as you type. `applicati
 Install the SDK in your Mini Program project and run the npm build through WeChat DevTools:
 
 ```bash
-npm install @flashcatcloud/fc-sdk-miniprogram
+npm install @flashcatcloud/miniprogram-rum
 ```
 </Step>
 
 <Step title="Copy the Initialization Snippet">
 Use the copy button at the top-right of the right-hand code block, then paste the generated snippet into your Mini Program's `app.js`:
 
 ```typescript
-import { flashcatRum } from '@flashcatcloud/fc-sdk-miniprogram';
+import { flashcatRum } from '@flashcatcloud/miniprogram-rum';
 
 flashcatRum.init({
   applicationId: "<APPLICATION_ID>",

en/rum/sdk/wechat-miniprogram/advanced-config.mdx

@@ -50,7 +50,7 @@ flashcatRum.init({
   clientToken: "<YOUR_CLIENT_TOKEN>",
   tracing: {
     enabled: true,
-    sampleRate: 1,
+    sampleRate: 100,
     headerName: "traceparent"
   }
 });
@@ -59,7 +59,7 @@ flashcatRum.init({
 | Field | Type | Default | Description |
 |-------|------|---------|-------------|
 | `tracing.enabled` | boolean | `false` | Controls whether request trace headers are injected |
-| `tracing.sampleRate` | number | `1` | Request tracing sample rate. `1` means 100%, and `0.5` means approximately 50% |
+| `tracing.sampleRate` | number | `100` | Request tracing sample rate, from 0 to 100. `100` means all requests are sampled, and `50` means approximately 50% |
 | `tracing.headerName` | string | `traceparent` | Header name injected into requests |
 | `tracing.rootTraceContext` | object | - | Optional root Trace Context. When configured, the SDK creates child spans from this context |
 

en/rum/sdk/wechat-miniprogram/compatible.mdx

@@ -13,7 +13,7 @@ The WeChat Mini Program RUM SDK runs in the WeChat Mini Program environment and
 | Mini Program base library | `2.10.0+` | SDK initialization registers `wx.onUnhandledRejection`; runtimes below this version are not recommended |
 | Recommended base library | `2.12.0+` | Enables complete page rendering, startup, script execution, and setData update timing collection |
 | WeChat DevTools | Recent stable version | Must support npm dependency installation and **Tools > Build npm** |
-| npm package | `@flashcatcloud/fc-sdk-miniprogram` | Includes core functionality, platform adapter, and the RUM entry point |
+| npm package | `@flashcatcloud/miniprogram-rum` | Includes core functionality, platform adapter, and the RUM entry point |
 
 <Warning>
 If your Mini Program allows users to run on base library versions below `2.10.0`, SDK initialization may fail to register unhandled Promise rejection listeners. We recommend setting a minimum base library version in the Mini Program admin console, or evaluating low-version user coverage before integration.
@@ -49,7 +49,7 @@ If your Mini Program allows users to run on base library versions below `2.10.0`
 
 When integrating through npm, build npm dependencies in WeChat DevTools:
 
-1. Run `npm install @flashcatcloud/fc-sdk-miniprogram` in the Mini Program project root
+1. Run `npm install @flashcatcloud/miniprogram-rum` in the Mini Program project root
 2. Open the project in WeChat DevTools
 3. Run **Tools > Build npm**
 4. Confirm that the generated `miniprogram_npm` can be referenced by Mini Program code

en/rum/sdk/wechat-miniprogram/data-collection.mdx

@@ -13,7 +13,7 @@ After initialization, the WeChat Mini Program RUM SDK automatically collects use
 | Page views | Enabled | `Page` lifecycle hooks: `onLoad`, `onShow`, `onReady`, `onHide`, `onUnload` | `view` |
 | User actions | Enabled | Page methods that receive an event object with a `type` field | `action` |
 | Network requests | Enabled | `wx.request`, `wx.uploadFile`, `wx.downloadFile` | `resource` |
-| App errors | Enabled | `wx.onError`, `wx.onUnhandledRejection` | `error` |
+| App errors | Enabled | `wx.onError`, `wx.onUnhandledRejection`, `wx.onPageNotFound`, `wx.onLazyLoadError`, and failed network requests | `error` |
 | Performance metrics | Enabled | `wx.getPerformance` and page `setUpdatePerformanceListener` | `view` |
 | Custom events | Manual | `addCustomEvent()` | `custom` |
 
@@ -98,12 +98,15 @@ Network requests create resource events:
 
 ## Error Collection
 
-When `trackErrors` is enabled, the SDK subscribes to Mini Program app errors and unhandled Promise rejections.
+When `trackErrors` is enabled, the SDK subscribes to Mini Program app errors, unhandled Promise rejections, page-not-found events, and subpackage lazy-load failures. Failed network requests are also recorded as errors.
 
 | Source | SDK source | Description |
 |--------|------------|-------------|
 | `wx.onError` | `app` | Mini Program runtime errors |
 | `wx.onUnhandledRejection` | `promise` | Unhandled Promise rejections |
+| `wx.onPageNotFound` | `page-not-found` | The target page does not exist |
+| `wx.onLazyLoadError` | `lazy-load` | Subpackage lazy-load failures |
+| Failed network requests | `network` | For a failed request, the SDK creates an error event in addition to the resource event |
 | `addError()` | `custom` | Business errors that you report manually |
 
 Error events include the error message, optional stack, and source. When manually reporting an error, pass `error.stack` as the third argument to `addError()`.
@@ -135,7 +138,7 @@ Calling `addCustomEvent(name, context?)` creates a custom event. Use it to recor
 | `event.context` | Custom event context object |
 
 ```javascript pages/order/detail.js
-import { flashcatRum } from "@flashcatcloud/fc-sdk-miniprogram";
+import { flashcatRum } from "@flashcatcloud/miniprogram-rum";
 
 flashcatRum.addCustomEvent("order_status_changed", {
   orderId: "order-123",
@@ -157,7 +160,7 @@ The SDK associates non-view events with the page and session active at the event
 Disable collection types you do not need during initialization:
 
 ```javascript app.js
-import { flashcatRum } from "@flashcatcloud/fc-sdk-miniprogram";
+import { flashcatRum } from "@flashcatcloud/miniprogram-rum";
 
 flashcatRum.init({
   applicationId: "<YOUR_APPLICATION_ID>",

en/rum/sdk/wechat-miniprogram/sdk-integration.mdx

@@ -1,25 +1,26 @@
 ---
 title: "SDK Integration Guide"
 description: "Integrate the RUM SDK into a WeChat Mini Program to collect page, action, request, error, and performance data"
-keywords: ["RUM", "WeChat Mini Program SDK", "Mini Program monitoring", "user monitoring", "@flashcatcloud/fc-sdk-miniprogram"]
+keywords: ["RUM", "WeChat Mini Program SDK", "Mini Program monitoring", "user monitoring", "@flashcatcloud/miniprogram-rum"]
 ---
 
-The WeChat Mini Program RUM SDK provides the `flashcatRum` instance through `@flashcatcloud/fc-sdk-miniprogram`. After initialization, the SDK automatically collects page lifecycle events, user actions, network requests, app errors, and performance metrics, then reports them to Flashduty RUM.
+The WeChat Mini Program RUM SDK provides the `flashcatRum` instance through `@flashcatcloud/miniprogram-rum`. After initialization, the SDK automatically collects page lifecycle events, user actions, network requests, app errors, and performance metrics, then reports them to Flashduty RUM.
 
 ## Prerequisites
 
 Before integrating the SDK, complete these steps:
 
 - Create or select a RUM application in the Flashduty console, then obtain the **Application ID** and **Client Token**
 - Confirm that your Mini Program can access the RUM intake URL. The default URL is `https://browser.flashcat.cloud/api/v2/rum`; configure `proxy` if your network policy requires forwarding
+- Configure the request domain allowlist in the WeChat Official Platform: go to **Development > Development Management > Development Settings > Server Domain** and add `https://browser.flashcat.cloud` (or your proxy domain) to the **request legal domains**. Without this, WeChat blocks all reporting requests on real devices; during development, you can temporarily check the "Do not verify legal domains" option in WeChat DevTools
 - If you use WeChat DevTools, build npm so `miniprogram_npm` can reference the SDK package
 
 ## Install the SDK
 
 Install the RUM SDK in the Mini Program project root:
 
 ```bash
-npm install @flashcatcloud/fc-sdk-miniprogram
+npm install @flashcatcloud/miniprogram-rum
 ```
 
 After installation, run **Tools > Build npm** in WeChat DevTools.
@@ -29,7 +30,7 @@ After installation, run **Tools > Build npm** in WeChat DevTools.
 Initialize the SDK as early as possible in the Mini Program entry file. The SDK wraps page lifecycle hooks, request methods, and app error listeners during initialization, so initializing it in `app.js` is recommended.
 
 ```javascript app.js
-import { flashcatRum } from "@flashcatcloud/fc-sdk-miniprogram";
+import { flashcatRum } from "@flashcatcloud/miniprogram-rum";
 
 flashcatRum.init({
   applicationId: "<YOUR_APPLICATION_ID>",
@@ -112,7 +113,7 @@ The following toggles control automatic collection. They are all enabled by defa
 | `trackPages` | boolean | `true` | Collects page lifecycle data and creates view events |
 | `trackActions` | boolean | `true` | Collects user actions from page event handlers and creates action events |
 | `trackRequests` | boolean | `true` | Collects `wx.request`, `wx.uploadFile`, and `wx.downloadFile` calls and creates resource events |
-| `trackErrors` | boolean | `true` | Collects errors from `wx.onError` and `wx.onUnhandledRejection` |
+| `trackErrors` | boolean | `true` | Collects errors from `wx.onError`, `wx.onUnhandledRejection`, page-not-found events, subpackage lazy-load failures, and failed network requests |
 | `trackPerformance` | boolean | `true` | Collects page rendering, startup, and script execution metrics through `wx.getPerformance` |
 
 ## Use User Information and Global Context
@@ -141,7 +142,7 @@ flashcatRum.setGlobalContext({
 In addition to automatic collection, you can add business events, errors, actions, and custom timings manually.
 
 ```javascript pages/order/detail.js
-import { flashcatRum } from "@flashcatcloud/fc-sdk-miniprogram";
+import { flashcatRum } from "@flashcatcloud/miniprogram-rum";
 
 Page({
   onPayTap() {
@@ -167,7 +168,7 @@ Page({
 | `addError(message, source?, stack?)` | Manually reports an error event. The public API uses `custom` as the source |
 | `addTiming(name, time?)` | Records a custom timing on the current page view. Invalid characters in the name are replaced with `_` |
 | `addCustomEvent(name, context?)` | Reports a custom event with optional context |
-| `startPage(name)` | Manually starts a page view, useful for overriding the automatic page name or recording a virtual page |
+| `startPage(name?)` | Manually starts a page view, useful for overriding the automatic page name or recording a virtual page |
 | `stopSession()` | Clears the current session. The next event creates a new session |
 | `getInitConfiguration()` | Returns the latest initialization configuration |
 

zh/rum/quickstart/app-management.mdx

@@ -76,7 +76,7 @@ RUM 应用是承载前端性能监控数据的容器，用于采集、存储和
 - **JavaScript（Web）**：配置服务名等参数后，实时预览 `flashcatRum.init()` 初始化代码
 - **Android**：展示完整的集成步骤，包括添加 Gradle 依赖（`cloud.flashcat:dd-sdk-android-core` 和 `cloud.flashcat:dd-sdk-android-rum`）、在 `Application.onCreate()` 中初始化 SDK 并启用 RUM，以及可选的 WebView 追踪集成
 - **iOS**：展示完整的集成步骤，包括添加 Swift Package Manager 依赖（`fc-sdk-ios`，版本 0.3.0 起）、在 `AppDelegate.didFinishLaunchingWithOptions` 中初始化 SDK 并启用 RUM，以及可选的 WebView 追踪集成
-- **微信小程序**：通过表单填写 `env`、`service`、`version`、`sessionSampleRate` 后，实时预览基于 `@flashcatcloud/fc-sdk-miniprogram` 的 `flashcatRum.init()` 初始化代码（参见下方「微信小程序 SDK 配置助手」）
+- **微信小程序**：通过表单填写 `env`、`service`、`version`、`sessionSampleRate` 后，实时预览基于 `@flashcatcloud/miniprogram-rum` 的 `flashcatRum.init()` 初始化代码（参见下方「微信小程序 SDK 配置助手」）
 
 每个平台的 SDK 配置页面都会自动填入当前应用的 `applicationId` 和 `clientToken`，您可以直接复制代码到项目中使用。
 
@@ -142,15 +142,15 @@ flashcatRum.init({
 在小程序项目中执行以下命令安装 SDK，并通过微信开发者工具完成 npm 构建：
 
 ```bash
-npm install @flashcatcloud/fc-sdk-miniprogram
+npm install @flashcatcloud/miniprogram-rum
 ```
 </Step>
 
 <Step title="复制初始化代码">
 点击右侧代码块右上角的复制按钮，将生成的初始化代码粘贴到小程序的 `app.js`：
 
 ```typescript
-import { flashcatRum } from '@flashcatcloud/fc-sdk-miniprogram';
+import { flashcatRum } from '@flashcatcloud/miniprogram-rum';
 
 flashcatRum.init({
   applicationId: "<APPLICATION_ID>",

zh/rum/sdk/wechat-miniprogram/advanced-config.mdx

@@ -50,7 +50,7 @@ flashcatRum.init({
   clientToken: "<YOUR_CLIENT_TOKEN>",
   tracing: {
     enabled: true,
-    sampleRate: 1,
+    sampleRate: 100,
     headerName: "traceparent"
   }
 });
@@ -59,7 +59,7 @@ flashcatRum.init({
 | 字段 | 类型 | 默认值 | 说明 |
 |------|------|--------|------|
 | `tracing.enabled` | boolean | `false` | 是否启用请求追踪头注入 |
-| `tracing.sampleRate` | number | `1` | 请求追踪采样率。`1` 表示 100% 采样，`0.5` 表示约 50% 采样 |
+| `tracing.sampleRate` | number | `100` | 请求追踪采样率，取值范围 0-100。`100` 表示全量采样，`50` 表示约 50% 采样 |
 | `tracing.headerName` | string | `traceparent` | 注入到请求 header 中的字段名 |
 | `tracing.rootTraceContext` | object | - | 可选根 Trace Context。配置后，SDK 会基于该上下文创建子 span |
 

zh/rum/sdk/wechat-miniprogram/compatible.mdx

@@ -13,7 +13,7 @@ keywords: ["RUM", "微信小程序", "兼容性", "基础库"]
 | 小程序基础库 | `2.10.0+` | SDK 初始化会注册 `wx.onUnhandledRejection`，低于该版本的运行时不建议接入 |
 | 推荐基础库 | `2.12.0+` | 可完整采集页面渲染、启动、脚本执行和 setData 更新耗时 |
 | 微信开发者工具 | 使用近期稳定版 | 需要支持 npm 安装依赖并执行 **工具 > 构建 npm** |
-| npm 包 | `@flashcatcloud/fc-sdk-miniprogram` | 包含核心能力、平台适配层和 RUM 入口 |
+| npm 包 | `@flashcatcloud/miniprogram-rum` | 包含核心能力、平台适配层和 RUM 入口 |
 
 <Warning>
 如果小程序允许用户在低于 `2.10.0` 的基础库中运行，SDK 初始化阶段可能无法注册未处理 Promise 拒绝监听。建议在小程序管理后台设置最低基础库版本，或在接入前根据业务覆盖范围评估低版本用户占比。
@@ -49,7 +49,7 @@ keywords: ["RUM", "微信小程序", "兼容性", "基础库"]
 
 接入 npm 包时，需要在微信开发者工具中完成 npm 构建：
 
-1. 在小程序项目根目录执行 `npm install @flashcatcloud/fc-sdk-miniprogram`
+1. 在小程序项目根目录执行 `npm install @flashcatcloud/miniprogram-rum`
 2. 在微信开发者工具中打开项目
 3. 执行 **工具 > 构建 npm**
 4. 确认生成的 `miniprogram_npm` 可以被小程序代码引用

zh/rum/sdk/wechat-miniprogram/data-collection.mdx

@@ -13,7 +13,7 @@ keywords: ["RUM", "微信小程序", "数据收集", "小程序监控"]
 | 页面访问 | 开启 | `Page` 生命周期：`onLoad`、`onShow`、`onReady`、`onHide`、`onUnload` | `view` |
 | 用户操作 | 开启 | 页面方法收到带有 `type` 的事件对象时自动记录 | `action` |
 | 网络请求 | 开启 | `wx.request`、`wx.uploadFile`、`wx.downloadFile` | `resource` |
-| 应用错误 | 开启 | `wx.onError`、`wx.onUnhandledRejection` | `error` |
+| 应用错误 | 开启 | `wx.onError`、`wx.onUnhandledRejection`、`wx.onPageNotFound`、`wx.onLazyLoadError` 和失败的网络请求 | `error` |
 | 性能指标 | 开启 | `wx.getPerformance` 和页面 `setUpdatePerformanceListener` | `view` |
 | 自定义事件 | 手动上报 | `addCustomEvent()` | `custom` |
 
@@ -98,12 +98,15 @@ SDK 每 3 秒更新一次活跃页面的停留时长。页面进入后台、隐
 
 ## 错误采集
 
-启用 `trackErrors` 后，SDK 会订阅小程序应用错误和未处理 Promise 拒绝。
+启用 `trackErrors` 后，SDK 会订阅小程序应用错误、未处理 Promise 拒绝、页面不存在和分包懒加载失败事件，并把失败的网络请求同时记录为错误。
 
 | 来源 | SDK 标记 | 说明 |
 |------|----------|------|
 | `wx.onError` | `app` | 小程序运行时错误 |
 | `wx.onUnhandledRejection` | `promise` | 未处理的 Promise 拒绝 |
+| `wx.onPageNotFound` | `page-not-found` | 打开的页面不存在 |
+| `wx.onLazyLoadError` | `lazy-load` | 分包懒加载失败 |
+| 网络请求失败 | `network` | 请求失败时，SDK 在 resource 事件之外额外生成一条错误事件 |
 | `addError()` | `custom` | 你手动上报的业务错误 |
 
 错误事件会包含错误消息、可选堆栈和来源。手动上报错误时，可以把 `error.stack` 作为第三个参数传入 `addError()`。
@@ -135,7 +138,7 @@ SDK 每 3 秒更新一次活跃页面的停留时长。页面进入后台、隐
 | `event.context` | 自定义事件上下文对象 |
 
 ```javascript pages/order/detail.js
-import { flashcatRum } from "@flashcatcloud/fc-sdk-miniprogram";
+import { flashcatRum } from "@flashcatcloud/miniprogram-rum";
 
 flashcatRum.addCustomEvent("order_status_changed", {
   orderId: "order-123",
@@ -157,7 +160,7 @@ SDK 会把非 view 事件关联到事件发生时间对应的页面和会话：
 你可以在初始化时关闭不需要的采集类型：
 
 ```javascript app.js
-import { flashcatRum } from "@flashcatcloud/fc-sdk-miniprogram";
+import { flashcatRum } from "@flashcatcloud/miniprogram-rum";
 
 flashcatRum.init({
   applicationId: "<YOUR_APPLICATION_ID>",