@ohos-cpf/3rdloop 0.0.1

package/vendor/Server/Skills/rnoh-lib-demo-doc/assets/DEMO_DOC_TEMPLATE.md

@@ -0,0 +1,106 @@
+# Demo 描述文档模板
+
+> 生成 Demo 描述文档时可直接复制此模板，替换 `{占位符}` 内容。下方同时提供一份完整示例供参考。
+
+---
+
+## 模板
+
+```markdown
+# {库名} RN 测试 Demo 描述文档（HarmonyOS 平台）
+
+## 概述
+
+本文档基于 `{库名}` 库的接口规格（`interface-spec.json`）{和接口规格说明书（`{说明书文件名}`）}自动生成，
+提供该库各接口在 HarmonyOS 平台可用的 React Native 测试 Demo 描述，供开发者参考实现功能验证 Demo 页面。
+
+> **平台说明**：本文档基于 RN 鸿蒙三方库的接口规格生成，仅包含该库在 HarmonyOS 平台可用的测试 Demo。已过滤 iOS/Android 平台专用接口。
+
+## Demo 总览
+
+| Demo 数量 | 覆盖接口数量 | 生成日期 |
+|----------|------------|---------|
+| {N} 个    | {M} 个      | {YYYY-MM-DD} |
+
+## 测试 Demo 描述列表
+
+| 序号 | 测试 Demo 名称 | 测试 Demo 描述 | 测试 Demo 步骤 | 测试 Demo 预期结果 | 对应函数接口 |
+|-----|--------------|--------------|--------------|-----------------|------------|
+| 1 | {Demo名称} | {描述} | 1. 创建函数式组件...<br>2. 点击按钮触发...<br>3. 展示结果... | 1. 页面加载...<br>2. 点击后...<br>3. 验证... | `funcA(): Type`<br>`funcB(): Type` |
+| 2 | {Demo名称} | {描述} | ... | ... | ... |
+
+## 接口覆盖矩阵
+
+| 序号 | 接口名称 | 所在 Demo | 覆盖状态 |
+|-----|---------|----------|---------|
+| 1 | `{接口签名}` | {Demo名称} | ✅ 已覆盖 |
+| 2 | `{接口签名}` | {Demo名称} | ✅ 已覆盖 |
+```
+
+---
+
+## 完整示例
+
+以下为针对一个虚构的蓝牙 RN 三方库（`react-native-bluetooth-manager`）生成的 Demo 描述文档示例。
+
+> 📌 注意：以下所有接口均为示范用途，实际生成时应严格依据真实接口规格。
+
+```markdown
+# react-native-bluetooth-manager RN 测试 Demo 描述文档（HarmonyOS 平台）
+
+## 概述
+
+本文档基于 `react-native-bluetooth-manager` 库的接口规格说明文档自动生成，提供该库各接口的 React Native 测试 Demo 描述，供开发者参考实现功能验证页面。文档按功能相关性对接口进行分组，每组接口对应一个 Demo 页面描述。
+
+> **平台说明**：本文档基于 RN 鸿蒙三方库的接口规格生成，仅包含该库在 HarmonyOS 平台可用的测试 Demo。已过滤 iOS/Android 平台专用接口。
+
+## Demo 总览
+
+| Demo 数量 | 覆盖接口数量 | 生成日期 |
+|----------|------------|---------|
+| 4 个      | 12 个       | 2026-08-17 |
+
+## 测试 Demo 描述列表
+
+| 序号 | 测试 Demo 名称 | 测试 Demo 描述 | 测试 Demo 步骤 | 测试 Demo 预期结果 | 对应函数接口 |
+|-----|--------------|--------------|--------------|-----------------|------------|
+| 1 | 版本查询与蓝牙状态检测Demo | 展示如何调用 `getSDKVersion()` 获取 SDK 版本号，以及使用 `isBluetoothEnabled()` 检测当前设备蓝牙是否开启。同时演示通过 `addBluetoothStateListener` 订阅蓝牙状态变化事件，实时更新 UI 展示蓝牙状态。帮助开发者理解库的基本信息查询方式和蓝牙状态监听的事件驱动模式。 | 1. 创建函数式组件 Demo 页面（BluetoothStatusScreen.tsx），使用 `useState` 声明状态变量：`const [sdkVersion, setSdkVersion] = useState('')`、`const [btEnabled, setBtEnabled] = useState<boolean \| null>(null)`、`const [btState, setBtState] = useState('未知')`、`const [checkCount, setCheckCount] = useState(0)`、`const [callbackCount, setCallbackCount] = useState(0)`，布局中添加"查询版本"按钮、"检测蓝牙"按钮和状态 Text 展示区。<br>2. 在 `useEffect` 中调用 `addBluetoothStateListener(event => { setCallbackCount(c => c + 1); setBtState(event.state); })`，将返回的 `subscription` 对象保存，并在清理函数中调用 `subscription.remove()` 取消订阅。<br>3. 点击"查询版本"按钮，调用 `getSDKVersion()`（同步函数），执行 `setSdkVersion(getSDKVersion())`，Text 区域显示"SDK 版本: {版本号}"。<br>4. 点击"检测蓝牙"按钮，执行 `setCheckCount(c => c + 1)`，随后 `await isBluetoothEnabled()`，在 `then` 中执行 `setBtEnabled(result)`，Text 区域显示"蓝牙已开启 ✅"或"蓝牙已关闭 ❌"。<br>5. 双计数器展示：`<Text>检测调用次数: {checkCount}</Text>` 和 `<Text>状态事件次数: {callbackCount}</Text>`。 | 1. 页面加载完成，所有按钮可正常点击，蓝牙状态事件监听器已注册。<br>2. 点击"查询版本"后，Text 立即显示非空的版本号字符串（如 "2.1.0"），无异常。<br>3. 点击"检测蓝牙"后，`checkCount` 更新为 1，Text 显示当前蓝牙状态，结果为 true（开启）或 false（关闭）。<br>4. 手动切换设备蓝牙开关后，`callbackCount` 增加，`btState` Text 实时更新为 "on"/"off"。<br>5. 页面卸载时，事件监听器正确移除，无警告。 | `getSDKVersion(): string`<br>`isBluetoothEnabled(): Promise<boolean>`<br>`addBluetoothStateListener(callback): EmitterSubscription` |
+| 2 | 蓝牙开启与设备扫描Demo | 展示如何通过 `enableBluetooth()` 开启蓝牙（Android），使用 `startScan()` 启动设备扫描，通过 `addDeviceFoundListener` 订阅 `onDeviceFound` 事件实时接收扫描到的设备，以及调用 `stopScan()` 手动停止扫描。帮助开发者理解 NativeEventEmitter 异步事件驱动的完整模式，以及扫描生命周期的管理方式。 | 1. 创建函数式组件 Demo 页面（ScanScreen.tsx），声明状态变量：`const [devices, setDevices] = useState<BluetoothDevice[]>([])`、`const [scanning, setScanning] = useState(false)`、`const [scanCallCount, setScanCallCount] = useState(0)`、`const [deviceFoundCount, setDeviceFoundCount] = useState(0)`，布局中添加"开启蓝牙"按钮（Android 专用）、"开始扫描"按钮、"停止扫描"按钮及 FlatList 展示设备列表。<br>2. 在 `useEffect` 中调用 `addDeviceFoundListener(device => { setDeviceFoundCount(c => c + 1); setDevices(prev => [...prev, device]); })`，返回的 subscription 在清理函数中移除。<br>3. 点击"开启蓝牙"按钮（仅 Android 生效），执行 `await enableBluetooth()`，成功后 Text 显示"蓝牙已开启"；iOS/HarmonyOS 平台在按钮旁标注"仅 Android 有效，其他平台请手动开启"。<br>4. 点击"开始扫描"按钮，执行 `setScanCallCount(c => c + 1); setScanning(true); setDevices([])`，随后调用 `await startScan(10000)`，扫描过程中 FlatList 通过 `onDeviceFound` 事件实时渲染设备列表。<br>5. 点击"停止扫描"或扫描超时后，调用 `await stopScan()`，执行 `setScanning(false)`，Text 显示"扫描已停止"。<br>6. 双计数器展示：`<Text>扫描发起次数: {scanCallCount}</Text>` 和 `<Text>发现设备次数: {deviceFoundCount}</Text>`。 | 1. 点击"开启蓝牙"（Android）后，Text 显示"蓝牙已开启"；iOS/HarmonyOS 上按钮有平台限制说明。<br>2. 点击"开始扫描"后，`scanCallCount` 为 1，`scanning` 状态为 true，FlatList 开始逐条显示发现的蓝牙设备。<br>3. 每发现一台设备，`deviceFoundCount` 加 1，FlatList 列表同步更新。<br>4. 点击"停止扫描"后，`scanning` 变为 false，Text 显示"扫描已停止"。<br>5. 整个流程无 JS 红屏错误，无原生层崩溃。 | `enableBluetooth(): Promise<void>`<br>`startScan(timeoutMs?: number): Promise<void>`<br>`stopScan(): Promise<void>`<br>`addDeviceFoundListener(callback): EmitterSubscription` |
+| 3 | 设备连接与断开Demo | 展示如何使用 `connect(deviceId)` 连接扫描到的蓝牙设备，通过 `addConnectionStateListener` 监听连接状态变化事件，获取实时连接状态反馈，并调用 `disconnect(deviceId)` 断开连接。帮助开发者理解连接建立的异步流程、状态变化的事件监听方式以及连接资源的正确释放。 | 1. 创建函数式组件 Demo 页面（ConnectionScreen.tsx），声明状态变量：`const [targetDeviceId, setTargetDeviceId] = useState('')`、`const [connState, setConnState] = useState('未连接')`、`const [connectCallCount, setConnectCallCount] = useState(0)`、`const [connEventCount, setConnEventCount] = useState(0)`，布局中添加设备 ID 输入框（TextInput）、"连接"按钮、"断开"按钮及连接状态 Text 展示区。<br>2. 在 `useEffect` 中调用 `addConnectionStateListener(event => { setConnEventCount(c => c + 1); setConnState(event.state); })`，返回的 subscription 在清理函数中移除。<br>3. 在 TextInput 中输入要连接的设备 ID，点击"连接"按钮，执行 `setConnectCallCount(c => c + 1); setConnState('connecting')`，随后调用 `const device = await connect(targetDeviceId)`，成功后执行 `setConnState('connected')`。<br>4. 连接过程中，`addConnectionStateListener` 事件回调实时更新 `connState`（connecting → connected）。<br>5. 点击"断开"按钮，调用 `await disconnect(targetDeviceId)`，事件回调触发 `setConnState('disconnected')`。<br>6. 双计数器展示：`<Text>连接发起次数: {connectCallCount}</Text>` 和 `<Text>连接事件次数: {connEventCount}</Text>`。 | 1. 输入有效设备 ID 后点击"连接"，`connectCallCount` 为 1，`connState` Text 立即显示"connecting"。<br>2. 连接成功后，`connEventCount` 增加，`connState` Text 更新为"connected"。<br>3. `connect()` 返回的 `BluetoothDevice` 对象中 `id`、`name` 字段有效。<br>4. 点击"断开"后，`connState` Text 更新为"disconnected"，`connEventCount` 再次增加。<br>5. 整个流程无未捕获的 Promise reject。 | `connect(deviceId: string): Promise<BluetoothDevice>`<br>`disconnect(deviceId: string): Promise<void>`<br>`addConnectionStateListener(callback): EmitterSubscription` |
+| 4 | 特征数据读写Demo | 展示如何使用 `writeData()` 向已连接蓝牙设备的指定特征写入十六进制数据，以及使用 `readData()` 读取相同特征的当前数据，验证写入与读取的数据一致性。帮助开发者理解 BLE 特征读写接口的参数格式和 Promise 异步处理模式。 | 1. 创建函数式组件 Demo 页面（DataRWScreen.tsx），前提为已通过连接 Demo 建立蓝牙连接，声明状态变量：`const [deviceId, setDeviceId] = useState('')`、`const [serviceUUID, setServiceUUID] = useState('')`、`const [charUUID, setCharUUID] = useState('')`、`const [writeDataValue, setWriteDataValue] = useState('0x0A0B')`、`const [readResult, setReadResult] = useState('')`、`const [writeCallCount, setWriteCallCount] = useState(0)`、`const [readCallCount, setReadCallCount] = useState(0)`，布局中添加四个 TextInput、"写入"按钮、"读取"按钮及结果 Text 展示区。<br>2. 点击"写入"按钮，执行 `setWriteCallCount(c => c + 1)`，随后调用 `await writeData(deviceId, serviceUUID, charUUID, writeDataValue)`，成功后 Text 显示"写入成功 ✅"。<br>3. 点击"读取"按钮，执行 `setReadCallCount(c => c + 1)`，随后调用 `const data = await readData(deviceId, serviceUUID, charUUID)`，在 await 完成后执行 `setReadResult(data)`，Text 区域显示"读取结果: {data}"。<br>4. 先写入再读取，对比写入值与读取值是否一致。<br>5. 计数器展示：`<Text>写入调用次数: {writeCallCount}</Text>` 和 `<Text>读取调用次数: {readCallCount}</Text>`。 | 1. 填写有效参数后点击"写入"，`writeCallCount` 为 1，Text 显示"写入成功 ✅"。<br>2. 点击"读取"后，`readCallCount` 为 1，`readResult` Text 显示十六进制格式的返回数据，数据非空。<br>3. 先写入 "0x0A0B" 再读取，读取结果与写入内容一致。<br>4. 传入无效 UUID 时，Promise reject 被 catch 捕获，Text 展示错误信息，不崩溃。 | `writeData(deviceId, serviceUUID, characteristicUUID, data): Promise<void>`<br>`readData(deviceId, serviceUUID, characteristicUUID): Promise<string>` |
+
+## 接口覆盖矩阵
+
+| 序号 | 接口名称 | 所在 Demo | 覆盖状态 |
+|-----|---------|----------|---------|
+| 1 | `getSDKVersion(): string` | 版本查询与蓝牙状态检测Demo | ✅ 已覆盖 |
+| 2 | `isBluetoothEnabled(): Promise<boolean>` | 版本查询与蓝牙状态检测Demo | ✅ 已覆盖 |
+| 3 | `addBluetoothStateListener(callback): EmitterSubscription` | 版本查询与蓝牙状态检测Demo | ✅ 已覆盖 |
+| 4 | `enableBluetooth(): Promise<void>` | 蓝牙开启与设备扫描Demo | ✅ 已覆盖 |
+| 5 | `startScan(timeoutMs?: number): Promise<void>` | 蓝牙开启与设备扫描Demo | ✅ 已覆盖 |
+| 6 | `stopScan(): Promise<void>` | 蓝牙开启与设备扫描Demo | ✅ 已覆盖 |
+| 7 | `addDeviceFoundListener(callback): EmitterSubscription` | 蓝牙开启与设备扫描Demo | ✅ 已覆盖 |
+| 8 | `connect(deviceId: string): Promise<BluetoothDevice>` | 设备连接与断开Demo | ✅ 已覆盖 |
+| 9 | `disconnect(deviceId: string): Promise<void>` | 设备连接与断开Demo | ✅ 已覆盖 |
+| 10 | `addConnectionStateListener(callback): EmitterSubscription` | 设备连接与断开Demo | ✅ 已覆盖 |
+| 11 | `writeData(deviceId, serviceUUID, characteristicUUID, data): Promise<void>` | 特征数据读写Demo | ✅ 已覆盖 |
+| 12 | `readData(deviceId, serviceUUID, characteristicUUID): Promise<string>` | 特征数据读写Demo | ✅ 已覆盖 |
+```
+
+---
+
+## 示例中的关键规则应用说明
+
+1. **基础信息合并**：`getSDKVersion()`（同步）、`isBluetoothEnabled()`（异步）和 `addBluetoothStateListener`（事件订阅）合并到同一 Demo，因为共同完成"使用前环境检查 + 状态监听"阶段。
+
+2. **扫描生命周期组合**：`enableBluetooth()`、`startScan()`、`stopScan()`、`addDeviceFoundListener` 合并，共同描述蓝牙扫描的完整生命周期。
+
+3. **连接状态合并**：`connect()`、`disconnect()` 和 `addConnectionStateListener` 合并，形成"连接管理"完整业务场景。
+
+4. **平台差异标注**：`enableBluetooth()` 在 iOS/HarmonyOS 上不可用，Demo 步骤中标注"仅 Android 有效，其他平台请手动开启"。
+
+5. **异步回调双计数器**：所有涉及 Promise 或 NativeEventEmitter 事件的 Demo 均设计了双计数器，通过 `useState` setter 更新。
+
+6. **useState 强制更新**：所有状态变量更新均通过 `setXxx()` 执行，确保 RN 组件正确重新渲染。
+
+7. **函数式组件为载体**：每个步骤明确描述了对应的 RN 组件和用户操作，开发者可直接按步骤实现。

package/vendor/Server/Skills/rnoh-lib-demo-doc/references/COVERAGE_INCREMENTAL.md

@@ -0,0 +1,216 @@
+# 覆盖率增量过滤指南
+
+> 本文档说明如何解析 Demo 覆盖率报告（由 `rnoh-lib-demo-coverage` / `script_rn_analyze_demo_coverage` 生成），提取已覆盖接口，执行增量过滤。
+
+---
+
+## 1. 覆盖率报告结构
+
+覆盖率报告为 Markdown 文件，章节用 `---` 水平线分隔，按以下顺序排列：
+
+| 序号 | 章节标题 | 用途 |
+|------|----------|------|
+| 1 | `# {标题}` + 基本信息表 | 库名、源文件数、生成时间 |
+| 2 | `## 覆盖率总览` | 方法级覆盖率百分比、S/N/M 统计、进度条 |
+| 3 | `### 按接口类型统计` | method/property/function 等分类别覆盖率 |
+| 4 | `## 类级覆盖率` | 按类分组的覆盖明细 |
+| 5 | `## 未覆盖接口详情` | **核心**：未覆盖接口清单（含参数、返回类型） |
+| 6 | `## 已覆盖接口详情` | **核心**：已覆盖接口清单（含签名、覆盖文件） |
+| 7 | `## 文件覆盖详情` | 每个 Demo 文件覆盖的接口 |
+| 8 | `## 覆盖率提升建议` | 未覆盖接口补充清单 |
+
+> 增量过滤主要使用章节 5（未覆盖接口详情）和章节 6（已覆盖接口详情）。
+
+---
+
+## 2. 解析覆盖率总览
+
+### 2.1 章节格式
+
+```markdown
+## 覆盖率总览
+
+### 方法级覆盖率: {rate}% ({badge})
+
+| 统计项 | 数量 |
+|--------|------|
+| 类/接口总数 (S) | {S} |
+| 方法/属性总数 (N) | {N} |
+| 已覆盖 (M) | {M} |
+| 未覆盖 | {N - M} |
+
+覆盖率进度: [████████████████░░░░] {rate}%
+```
+
+### 2.2 提取字段
+
+| 字段 | 提取方式 | 示例值 |
+|------|----------|--------|
+| 覆盖率 | `### 方法级覆盖率: (\d+\.\d+)%` | `75.00` |
+| 状态 | `### 方法级覆盖率: \d+\.\d+% \((.+)\)` | `中` |
+| 类总数 S | `类/接口总数 \(S\) \| (\d+)` | `12` |
+| 接口总数 N | `方法/属性总数 \(N\) \| (\d+)` | `45` |
+| 已覆盖 M | `已覆盖 \(M\) \| (\d+)` | `30` |
+| 未覆盖数 | `未覆盖 \| (\d+)` | `15` |
+
+状态值仅四种：`高`(≥80%)、`中`(≥50%)、`低`(≥20%)、`极低`(<20%)。
+
+---
+
+## 3. 解析已覆盖接口详情
+
+### 3.1 章节格式
+
+```markdown
+## 已覆盖接口详情
+
+### {idx}. {className}
+
+| # | 接口 | 类型 | 层级 | 签名 | 覆盖文件 |
+|---|------|------|------|------|----------|
+| 1 | `memberName` | method | - | `signature` | `file1.tsx`, `file2.tsx` |
+```
+
+- 按类名分组，每组一个 `###` 子标题
+- 顶层导出接口的类名显示为 `(顶层)`
+- 空情况：`*暂无已覆盖接口*`
+
+### 3.2 提取已覆盖接口集合
+
+从每行表格提取：
+
+| 字段 | 提取方式 |
+|------|----------|
+| 类名 | `### \d+\. (.+)` |
+| 接口名 | `\| \`(.+?)\` \|` （第一列，反引号包裹） |
+| 类型 | 第二列（method/property/function/...） |
+| 签名 | 第五列，反引号包裹，注意 `\|` 转义需还原为 `\|` |
+
+构建 `coveredSet`：`{className}.{memberName}` 或仅 `memberName`（顶层导出）。
+
+### 3.3 注意事项
+
+- 表格单元格中的管道符 `|` 被转义为 `\|`，解析时需还原
+- 覆盖文件列最多显示 3 个，超出部分用 ` +{N}` 表示
+- 类型字段值：`method`、`constructor`、`property`、`field`、`enumValue`、`function`、`variable`、`type`
+
+---
+
+## 4. 解析未覆盖接口详情
+
+### 4.1 章节格式
+
+```markdown
+## 未覆盖接口详情
+
+### {idx}. {className} ({count} 个未覆盖)
+
+| # | 接口 | 类型 | 层级 | 参数 | 返回类型 | 说明 |
+|---|------|------|------|------|----------|------|
+| 1 | `memberName` | method | - | id: string | Promise<void> | 断开连接 |
+```
+
+- 按类名分组，**组标题含未覆盖数量**：`### {idx}. {className} ({count} 个未覆盖)`
+- 表格 7 列（比已覆盖多：参数、返回类型、说明；少：签名、覆盖文件）
+- 空情况：`*所有接口均已覆盖！*`
+
+### 4.2 提取未覆盖接口
+
+从每行表格提取：
+
+| 字段 | 提取方式 |
+|------|----------|
+| 类名 | `### \d+\. (.+?) \(\d+ 个未覆盖\)` |
+| 接口名 | 第一列，反引号包裹 |
+| 类型 | 第二列 |
+| 参数 | 第五列（格式：`name?: type, name: type`） |
+| 返回类型 | 第六列 |
+| 说明 | 第七列 |
+
+---
+
+## 5. 增量过滤流程
+
+### 5.1 整体流程
+
+```
+1. 读取覆盖率报告 Markdown 文件
+2. 解析"覆盖率总览"→ 提取 S/N/M 统计
+3. 解析"已覆盖接口详情"→ 构建 coveredSet
+4. 解析"未覆盖接口详情"→ 构建 uncoveredList（含详细信息）
+5. 将 uncoveredList 与接口规格 JSON 交叉验证：
+   - 确认未覆盖接口在规格中存在
+   - 补充规格中的平台标注
+6. 对 uncoveredList 执行 HarmonyOS 平台过滤（Phase 5.2）：
+   - 仅依据 README 文档「HarmonyOS Support」列过滤
+   - README 标注 no → 排除
+   - README 未列出 → 视为无平台标注，保留并生成 Demo
+   - 禁止通过源码（Platform.OS 分支、TurboModule Spec）过滤
+7. 最终得到待生成 Demo 的接口清单
+```
+
+### 5.2 交叉验证
+
+覆盖率报告中的接口名需与 `interface-spec.json` 中的接口匹配：
+
+| 匹配维度 | 说明 |
+|----------|------|
+| 类名匹配 | 报告中的 `className` 对应规格 JSON 中的类/模块名 |
+| 接口名匹配 | 报告中的 `memberName` 对应规格 JSON 中的方法/属性名 |
+| 签名一致性 | 报告中的签名应与规格 JSON 中的签名一致（参数、返回类型） |
+
+> 若报告中接口在规格 JSON 中找不到匹配，以规格 JSON 为准（报告可能基于旧版规格）。
+
+### 5.3 边界情况处理
+
+| 情况 | 处理方式 |
+|------|----------|
+| 报告标注 `*所有接口均已覆盖！*` | 输出文档标注"所有接口已覆盖，无需生成新 Demo"，终止流程 |
+| 报告标注 `*暂无已覆盖接口*` | 全部接口视为未覆盖，退化为全量模式 |
+| 报告中接口在规格中不存在 | 以规格为准，忽略报告中该接口 |
+| 规格中有接口但报告中没有 | 视为未覆盖，纳入待生成清单 |
+| 报告文件格式异常无法解析 | 输出警告，退化为全量模式 |
+
+---
+
+## 6. 增量模式输出文档差异
+
+增量模式下，输出文档的概述章节额外包含：
+
+```markdown
+## 概述
+
+本文档基于 `{库名}` 库的接口规格和 Demo 覆盖率报告生成。
+
+> **增量模式**：本文档仅针对 Demo 覆盖率报告中未覆盖的接口生成 Demo 描述。
+>
+> **覆盖率来源**：`{demoCoverage报告路径}`
+> **接口统计**：总接口数 {N}，已覆盖 {M}，本次生成 {待生成数}
+
+> **平台说明**：本文档仅包含 HarmonyOS 平台可用的测试 Demo。已过滤 iOS/Android 平台专用接口。
+```
+
+接口覆盖矩阵中仅列出本次生成的未覆盖接口，已覆盖接口不出现（或在备注中说明"已由现有 Demo 覆盖"）。
+
+---
+
+## 7. 报告章节分隔与解析技巧
+
+### 7.1 章节分隔
+
+报告各章节用 `---` 水平线分隔。解析时按 `^---$` 分割为章节块，每块以 `## ` 开头。
+
+### 7.2 表格行解析
+
+所有表格为标准 GitHub Markdown 格式，管道符 `|` 分隔。注意事项：
+
+- 单元格内管道符被转义为 `\|`，解析时需还原
+- 反引号包裹的字段：`接口`、`类名`、`签名`、`覆盖文件`，解析时去除反引号
+- 表头行和分隔行（`|---|---|...`）需跳过
+
+### 7.3 组标题解析
+
+已覆盖接口的组标题：`### {idx}. {className}`（无数量后缀）
+未覆盖接口的组标题：`### {idx}. {className} ({count} 个未覆盖)`（有数量后缀）
+
+通过是否有 `个未覆盖` 后缀区分两种章节。