@ohos-cpf/3rdloop 0.0.1 → 0.0.3

package/vendor/Server/Skills/arkts-library-demo-scenario/references/EXAMPLES.md

@@ -1,100 +1,100 @@
-# 示例：测试 Demo 描述文档
-
-本文档展示使用 `ohos-arkts-demo-doc-generator` 技能针对一个虚构的图像处理鸿蒙原生库（`ohos-blur-kit`）生成的测试 Demo 描述文档示例。
-
-> 📌 注意：以下所有接口均为示范用途，实际生成时应严格依据真实规格文档。
-
----
-
-## 假设的接口规格文档（输入）
-
-```typescript
-// Index.ets - 导出接口清单
-
-// 图像模糊处理管理类
-export class BlurManager {
-  constructor(radius: number)
-  blur(pixelMap: PixelMap): Promise<PixelMap>
-  blurSync(pixelMap: PixelMap): PixelMap
-  setRadius(radius: number): void
-  getRadius(): number
-  release(): void
-}
-
-// 工具函数
-export function createBlurConfig(radius: number, mode: BlurMode): BlurConfig
-export function isSupported(): boolean
-
-// 枚举
-export enum BlurMode {
-  GAUSSIAN = 'gaussian',
-  STACK = 'stack',
-  BOX = 'box'
-}
-
-// 接口
-export interface BlurConfig {
-  radius: number
-  mode: BlurMode
-  quality?: number
-}
-
-// 常量
-export const VERSION: string
-```
-
----
-
-## 生成的输出文档示例
-
-以下为技能输出的 `ohos-blur-kit测试demo描述.md` 内容：
-
----
-
-# ohos-blur-kit 测试 Demo 描述文档
-
-## 概述
-
-本文档基于 `ohos-blur-kit` 库的接口规格说明文档自动生成，提供该库各接口的 ArkTS 测试 Demo 描述，供开发者参考实现功能验证页面。文档按功能相关性对接口进行分组，每组接口对应一个 Demo 页面描述。
-
-## Demo 总览
-
-| Demo 数量 | 覆盖接口数量 | 生成日期 |
-|----------|------------|---------|
-| 4 个      | 8 个        | 2026-03-11 |
-
-## 测试 Demo 描述列表
-
-| 序号 | 测试 Demo 名称 | 测试 Demo 描述 | 测试 Demo 步骤 | 测试 Demo 预期结果 | 对应函数接口 |
-|-----|--------------|--------------|--------------|-----------------|------------|
-| 1 | 环境检测与配置创建 Demo | 展示如何在使用 BlurManager 前检测当前设备是否支持模糊能力，以及如何通过 `createBlurConfig()` 创建合法的模糊配置对象。帮助开发者理解使用前置条件检查和配置初始化的标准流程。 | 1. 创建 Demo 页面，包含"检测支持"按钮、BlurMode 选择器（Gaussian/Stack/Box）、radius 输入框和"创建配置"按钮，以及 JSON 展示区域。<br>2. 点击"检测支持"按钮，调用 `isSupported()`，将返回的布尔值显示在页面上（"当前设备支持模糊 ✅" 或 "当前设备不支持 ❌"）。<br>3. 选择 BlurMode 并输入 radius 值，点击"创建配置"按钮，调用 `createBlurConfig(radius, mode)`。<br>4. 在 JSON 展示区域展示返回的 `BlurConfig` 对象，格式化显示 radius、mode、quality 字段。 | 1. 页面加载完成，按钮与选择器可正常操作。<br>2. 调用 `isSupported()` 返回布尔值，页面相应显示支持/不支持状态。<br>3. 调用 `createBlurConfig()` 后成功返回 `BlurConfig` 对象，页面格式化展示该对象的 radius 和 mode 字段，无抛出异常。 | `isSupported(): boolean`<br>`createBlurConfig(radius: number, mode: BlurMode): BlurConfig` |
-| 2 | BlurManager 生命周期管理 Demo | 展示 `BlurManager` 的完整生命周期：构造（传入 radius）、设置/获取 radius、最终释放资源。帮助开发者理解 BlurManager 对象的创建方式、radius 属性的读写机制，以及释放资源的时机。 | 1. 创建 Demo 页面，包含 radius 输入框、"创建 BlurManager"按钮、新 radius 输入框、"更新 radius"按钮、"获取 radius"按钮和"释放"按钮，以及状态日志区域。<br>2. 填写 radius 值（如 15），点击"创建 BlurManager"，调用 `new BlurManager(15)`，在日志区域显示"BlurManager 已创建，初始 radius=15"。<br>3. 修改 radius 值（如 25），点击"更新 radius"，调用 `setRadius(25)`，日志显示"radius 已更新为 25"。<br>4. 点击"获取 radius"，调用 `getRadius()`，日志显示"当前 radius=25"，验证与上一步设置一致。<br>5. 点击"释放"，调用 `release()`，日志显示"BlurManager 已释放"，此后操作按钮禁用。 | 1. `new BlurManager(radius)` 成功创建实例，无异常。<br>2. `setRadius(newValue)` 调用后，再次 `getRadius()` 返回与设置值一致，验证读写一致性。<br>3. `release()` 调用后页面日志提示释放成功，后续调用不再可用（按钮变灰）。<br>4. 整个生命周期无内存泄漏提示，无崩溃。 | `new BlurManager(radius: number)`<br>`setRadius(radius: number): void`<br>`getRadius(): number`<br>`release(): void` |
-| 3 | 同步图像模糊处理 Demo | 展示使用 `blurSync()` 对 PixelMap 进行同步模糊处理的完整流程，帮助开发者理解同步调用方式、传参规范及处理后图像的获取与展示。 | 1. 创建 Demo 页面，包含"选择图片"按钮（调用图库选择器）、原图展示区域、radius 滑动条、"执行同步模糊"按钮和模糊后图片展示区域。<br>2. 点击"选择图片"，从图库选取一张图片，在原图展示区域预览。<br>3. 拖动 radius 滑动条调整模糊半径（范围 1-50）。<br>4. 点击"执行同步模糊"，创建 `BlurManager(radius)`，调用 `blurSync(pixelMap)`，传入原图 PixelMap。<br>5. 将返回的 PixelMap 在模糊后图片展示区域显示，并在图片下方标注"模糊半径: {radius}"。 | 1. 选图后原图在页面正常预览。<br>2. `blurSync()` 同步返回处理后的 PixelMap，页面立即更新展示模糊后图片。<br>3. 模糊后图片的尺寸（宽高像素数）与原图一致，仅视觉效果有模糊。<br>4. 调整不同 radius 值后重复操作，模糊程度随 radius 增大而加深。<br>5. 无异常抛出，UI 线程无卡顿超过 3 秒的提示。 | `new BlurManager(radius: number)`<br>`blurSync(pixelMap: PixelMap): PixelMap` |
-| 4 | 异步图像模糊处理 Demo | 展示使用 `blur()` 对 PixelMap 进行异步模糊处理的完整流程，以及与同步方式的对比体验。帮助开发者理解 Promise 异步调用方式、await 使用规范，以及如何在 ArkTS 中处理异步返回结果。 | 1. 创建 Demo 页面，包含"选择图片"按钮、原图展示区域、radius 输入框、"执行异步模糊"按钮、Loading 指示器和模糊后图片展示区域。<br>2. 选取一张图片，在原图区域预览。<br>3. 输入 radius 值，点击"执行异步模糊"，按钮变为禁用状态，显示 Loading 指示器。<br>4. 调用 `await blurManager.blur(pixelMap)`，等待 Promise resolve。<br>5. Promise 完成后，隐藏 Loading、启用按钮，将返回的 PixelMap 在结果区域显示，下方标注"异步模糊完成，耗时: {ms}ms"。 | 1. 点击"执行异步模糊"后，按钮立即变为禁用，Loading 指示器显示，表明异步任务已开始。<br>2. `blur()` 返回的 Promise 正常 resolve，Loading 消失，模糊后图片显示在结果区域。<br>3. 模糊后图片尺寸与原图一致，视觉上出现模糊效果。<br>4. UI 线程在等待期间不冻结（可滚动页面或切换其他控件）。<br>5. 页面正确展示异步耗时，无 Promise reject 或未捕获异常。 | `new BlurManager(radius: number)`<br>`blur(pixelMap: PixelMap): Promise<PixelMap>` |
-
-## 接口覆盖矩阵
-
-| 序号 | 接口名称 | 所在 Demo | 覆盖状态 |
-|-----|---------|----------|---------|
-| 1 | `isSupported(): boolean` | 环境检测与配置创建 Demo | ✅ 已覆盖 |
-| 2 | `createBlurConfig(radius, mode): BlurConfig` | 环境检测与配置创建 Demo | ✅ 已覆盖 |
-| 3 | `new BlurManager(radius: number)` | BlurManager 生命周期管理 Demo / 同步模糊 Demo / 异步模糊 Demo | ✅ 已覆盖 |
-| 4 | `setRadius(radius: number): void` | BlurManager 生命周期管理 Demo | ✅ 已覆盖 |
-| 5 | `getRadius(): number` | BlurManager 生命周期管理 Demo | ✅ 已覆盖 |
-| 6 | `release(): void` | BlurManager 生命周期管理 Demo | ✅ 已覆盖 |
-| 7 | `blurSync(pixelMap: PixelMap): PixelMap` | 同步图像模糊处理 Demo | ✅ 已覆盖 |
-| 8 | `blur(pixelMap: PixelMap): Promise<PixelMap>` | 异步图像模糊处理 Demo | ✅ 已覆盖 |
-
----
-
-## 关键生成规则说明
-
-上述示例展示了以下技能规则的应用：
-
-1. **生命周期合并**：`constructor`、`setRadius`、`getRadius`、`release` 四个接口合并到一个 Demo，因为它们共同描述 `BlurManager` 的完整生命周期管理流程。
-
-2. **前置条件合并**：`isSupported()` 与 `createBlurConfig()` 合并到一个 Demo，因为它们都属于"使用前准备"阶段，且 `createBlurConfig` 的结果可作为构造函数的配置依据。
-
-3. **异步/同步分开**：`blur()` 和 `blurSync()` 虽然功能类似，但因调用方式（异步 vs 同步）差异明显，分别在独立 Demo 中展示，便于开发者对比。
-
-4. **以页面为载体**：每个步骤都明确描述了对应的 UI 组件（按钮、展示区、日志区等）和用户操作，使开发者可直接按步骤实现 Demo 页面。
+# 示例：测试 Demo 描述文档
+
+本文档展示使用 `ohos-arkts-demo-doc-generator` 技能针对一个虚构的图像处理鸿蒙原生库（`ohos-blur-kit`）生成的测试 Demo 描述文档示例。
+
+> 📌 注意：以下所有接口均为示范用途，实际生成时应严格依据真实规格文档。
+
+---
+
+## 假设的接口规格文档（输入）
+
+```typescript
+// Index.ets - 导出接口清单
+
+// 图像模糊处理管理类
+export class BlurManager {
+  constructor(radius: number)
+  blur(pixelMap: PixelMap): Promise<PixelMap>
+  blurSync(pixelMap: PixelMap): PixelMap
+  setRadius(radius: number): void
+  getRadius(): number
+  release(): void
+}
+
+// 工具函数
+export function createBlurConfig(radius: number, mode: BlurMode): BlurConfig
+export function isSupported(): boolean
+
+// 枚举
+export enum BlurMode {
+  GAUSSIAN = 'gaussian',
+  STACK = 'stack',
+  BOX = 'box'
+}
+
+// 接口
+export interface BlurConfig {
+  radius: number
+  mode: BlurMode
+  quality?: number
+}
+
+// 常量
+export const VERSION: string
+```
+
+---
+
+## 生成的输出文档示例
+
+以下为技能输出的 `ohos-blur-kit测试demo描述.md` 内容：
+
+---
+
+# ohos-blur-kit 测试 Demo 描述文档
+
+## 概述
+
+本文档基于 `ohos-blur-kit` 库的接口规格说明文档自动生成，提供该库各接口的 ArkTS 测试 Demo 描述，供开发者参考实现功能验证页面。文档按功能相关性对接口进行分组，每组接口对应一个 Demo 页面描述。
+
+## Demo 总览
+
+| Demo 数量 | 覆盖接口数量 | 生成日期 |
+|----------|------------|---------|
+| 4 个      | 8 个        | 2026-03-11 |
+
+## 测试 Demo 描述列表
+
+| 序号 | 测试 Demo 名称 | 测试 Demo 描述 | 测试 Demo 步骤 | 测试 Demo 预期结果 | 对应函数接口 |
+|-----|--------------|--------------|--------------|-----------------|------------|
+| 1 | 环境检测与配置创建 Demo | 展示如何在使用 BlurManager 前检测当前设备是否支持模糊能力，以及如何通过 `createBlurConfig()` 创建合法的模糊配置对象。帮助开发者理解使用前置条件检查和配置初始化的标准流程。 | 1. 创建 Demo 页面，包含"检测支持"按钮、BlurMode 选择器（Gaussian/Stack/Box）、radius 输入框和"创建配置"按钮，以及 JSON 展示区域。<br>2. 点击"检测支持"按钮，调用 `isSupported()`，将返回的布尔值显示在页面上（"当前设备支持模糊 ✅" 或 "当前设备不支持 ❌"）。<br>3. 选择 BlurMode 并输入 radius 值，点击"创建配置"按钮，调用 `createBlurConfig(radius, mode)`。<br>4. 在 JSON 展示区域展示返回的 `BlurConfig` 对象，格式化显示 radius、mode、quality 字段。 | 1. 页面加载完成，按钮与选择器可正常操作。<br>2. 调用 `isSupported()` 返回布尔值，页面相应显示支持/不支持状态。<br>3. 调用 `createBlurConfig()` 后成功返回 `BlurConfig` 对象，页面格式化展示该对象的 radius 和 mode 字段，无抛出异常。 | `isSupported(): boolean`<br>`createBlurConfig(radius: number, mode: BlurMode): BlurConfig` |
+| 2 | BlurManager 生命周期管理 Demo | 展示 `BlurManager` 的完整生命周期：构造（传入 radius）、设置/获取 radius、最终释放资源。帮助开发者理解 BlurManager 对象的创建方式、radius 属性的读写机制，以及释放资源的时机。 | 1. 创建 Demo 页面，包含 radius 输入框、"创建 BlurManager"按钮、新 radius 输入框、"更新 radius"按钮、"获取 radius"按钮和"释放"按钮，以及状态日志区域。<br>2. 填写 radius 值（如 15），点击"创建 BlurManager"，调用 `new BlurManager(15)`，在日志区域显示"BlurManager 已创建，初始 radius=15"。<br>3. 修改 radius 值（如 25），点击"更新 radius"，调用 `setRadius(25)`，日志显示"radius 已更新为 25"。<br>4. 点击"获取 radius"，调用 `getRadius()`，日志显示"当前 radius=25"，验证与上一步设置一致。<br>5. 点击"释放"，调用 `release()`，日志显示"BlurManager 已释放"，此后操作按钮禁用。 | 1. `new BlurManager(radius)` 成功创建实例，无异常。<br>2. `setRadius(newValue)` 调用后，再次 `getRadius()` 返回与设置值一致，验证读写一致性。<br>3. `release()` 调用后页面日志提示释放成功，后续调用不再可用（按钮变灰）。<br>4. 整个生命周期无内存泄漏提示，无崩溃。 | `new BlurManager(radius: number)`<br>`setRadius(radius: number): void`<br>`getRadius(): number`<br>`release(): void` |
+| 3 | 同步图像模糊处理 Demo | 展示使用 `blurSync()` 对 PixelMap 进行同步模糊处理的完整流程，帮助开发者理解同步调用方式、传参规范及处理后图像的获取与展示。 | 1. 创建 Demo 页面，包含"选择图片"按钮（调用图库选择器）、原图展示区域、radius 滑动条、"执行同步模糊"按钮和模糊后图片展示区域。<br>2. 点击"选择图片"，从图库选取一张图片，在原图展示区域预览。<br>3. 拖动 radius 滑动条调整模糊半径（范围 1-50）。<br>4. 点击"执行同步模糊"，创建 `BlurManager(radius)`，调用 `blurSync(pixelMap)`，传入原图 PixelMap。<br>5. 将返回的 PixelMap 在模糊后图片展示区域显示，并在图片下方标注"模糊半径: {radius}"。 | 1. 选图后原图在页面正常预览。<br>2. `blurSync()` 同步返回处理后的 PixelMap，页面立即更新展示模糊后图片。<br>3. 模糊后图片的尺寸（宽高像素数）与原图一致，仅视觉效果有模糊。<br>4. 调整不同 radius 值后重复操作，模糊程度随 radius 增大而加深。<br>5. 无异常抛出，UI 线程无卡顿超过 3 秒的提示。 | `new BlurManager(radius: number)`<br>`blurSync(pixelMap: PixelMap): PixelMap` |
+| 4 | 异步图像模糊处理 Demo | 展示使用 `blur()` 对 PixelMap 进行异步模糊处理的完整流程，以及与同步方式的对比体验。帮助开发者理解 Promise 异步调用方式、await 使用规范，以及如何在 ArkTS 中处理异步返回结果。 | 1. 创建 Demo 页面，包含"选择图片"按钮、原图展示区域、radius 输入框、"执行异步模糊"按钮、Loading 指示器和模糊后图片展示区域。<br>2. 选取一张图片，在原图区域预览。<br>3. 输入 radius 值，点击"执行异步模糊"，按钮变为禁用状态，显示 Loading 指示器。<br>4. 调用 `await blurManager.blur(pixelMap)`，等待 Promise resolve。<br>5. Promise 完成后，隐藏 Loading、启用按钮，将返回的 PixelMap 在结果区域显示，下方标注"异步模糊完成，耗时: {ms}ms"。 | 1. 点击"执行异步模糊"后，按钮立即变为禁用，Loading 指示器显示，表明异步任务已开始。<br>2. `blur()` 返回的 Promise 正常 resolve，Loading 消失，模糊后图片显示在结果区域。<br>3. 模糊后图片尺寸与原图一致，视觉上出现模糊效果。<br>4. UI 线程在等待期间不冻结（可滚动页面或切换其他控件）。<br>5. 页面正确展示异步耗时，无 Promise reject 或未捕获异常。 | `new BlurManager(radius: number)`<br>`blur(pixelMap: PixelMap): Promise<PixelMap>` |
+
+## 接口覆盖矩阵
+
+| 序号 | 接口名称 | 所在 Demo | 覆盖状态 |
+|-----|---------|----------|---------|
+| 1 | `isSupported(): boolean` | 环境检测与配置创建 Demo | ✅ 已覆盖 |
+| 2 | `createBlurConfig(radius, mode): BlurConfig` | 环境检测与配置创建 Demo | ✅ 已覆盖 |
+| 3 | `new BlurManager(radius: number)` | BlurManager 生命周期管理 Demo / 同步模糊 Demo / 异步模糊 Demo | ✅ 已覆盖 |
+| 4 | `setRadius(radius: number): void` | BlurManager 生命周期管理 Demo | ✅ 已覆盖 |
+| 5 | `getRadius(): number` | BlurManager 生命周期管理 Demo | ✅ 已覆盖 |
+| 6 | `release(): void` | BlurManager 生命周期管理 Demo | ✅ 已覆盖 |
+| 7 | `blurSync(pixelMap: PixelMap): PixelMap` | 同步图像模糊处理 Demo | ✅ 已覆盖 |
+| 8 | `blur(pixelMap: PixelMap): Promise<PixelMap>` | 异步图像模糊处理 Demo | ✅ 已覆盖 |
+
+---
+
+## 关键生成规则说明
+
+上述示例展示了以下技能规则的应用：
+
+1. **生命周期合并**：`constructor`、`setRadius`、`getRadius`、`release` 四个接口合并到一个 Demo，因为它们共同描述 `BlurManager` 的完整生命周期管理流程。
+
+2. **前置条件合并**：`isSupported()` 与 `createBlurConfig()` 合并到一个 Demo，因为它们都属于"使用前准备"阶段，且 `createBlurConfig` 的结果可作为构造函数的配置依据。
+
+3. **异步/同步分开**：`blur()` 和 `blurSync()` 虽然功能类似，但因调用方式（异步 vs 同步）差异明显，分别在独立 Demo 中展示，便于开发者对比。
+
+4. **以页面为载体**：每个步骤都明确描述了对应的 UI 组件（按钮、展示区、日志区等）和用户操作，使开发者可直接按步骤实现 Demo 页面。

package/vendor/Server/Skills/arkts-library-demo-scenario/references/TEMPLATE.md

@@ -1,185 +1,185 @@
-# 测试 Demo 描述文档模板
-
-本文件提供生成输出文档时使用的标准模板结构，可直接复制并填入真实内容。
-
----
-
-## 输出文档模板
-
-```markdown
-# {库名} 测试 Demo 描述文档
-
-## 概述
-
-本文档基于 `{库名}` 库的接口规格说明文档（`{规格文档文件名}`）自动生成，
-提供各接口的 ArkTS 测试 Demo 描述，供开发者参考实现功能验证 Demo 页面。
-
-> 文档基于接口规格文档真实内容生成，所有接口名称、参数类型与规格文档保持一致。
-
-## Demo 总览
-
-| Demo 数量 | 覆盖接口数量 | 生成日期 |
-|----------|------------|---------|
-| {N} 个    | {M} 个      | {YYYY-MM-DD} |
-
-## 测试 Demo 描述列表
-
-| 序号 | 测试 Demo 名称 | 测试 Demo 描述 | 测试 Demo 步骤 | 测试 Demo 预期结果 | 对应函数接口 |
-|-----|--------------|--------------|--------------|-----------------|------------|
-| 1 | {Demo名称1} | {Demo描述1} | {步骤1} | {预期结果1} | {接口列表1} |
-| 2 | {Demo名称2} | {Demo描述2} | {步骤2} | {预期结果2} | {接口列表2} |
-
-## 接口覆盖矩阵
-
-| 序号 | 接口名称 | 所在 Demo | 覆盖状态 |
-|-----|---------|----------|---------|
-| 1 | `{接口签名}` | {Demo名称} | ✅ 已覆盖 |
-```
-
----
-
-## 各字段填写规范
-
-### 测试 Demo 名称
-
-**格式**：`[功能动词/名词][操作对象][可选场景描述]Demo`
-
-**命名示例：**
-
-| 场景 | 推荐名称 |
-|-----|---------|
-| 单一核心功能 | `图片压缩处理Demo` |
-| 生命周期管理 | `实例创建与销毁Demo` |
-| 配置类接口 | `参数配置与验证Demo` |
-| 异步操作 | `异步数据加载Demo` |
-| 错误处理 | `异常捕获与恢复Demo` |
-| 多接口组合 | `完整处理流程Demo` |
-
-**注意：**
-- 不超过 20 字
-- 避免使用泛化词语（如"基础Demo"、"测试Demo"）
-- 名称应能让开发者直接判断 Demo 的核心目的
-
----
-
-### 测试 Demo 描述
-
-**模板：**
-
-```
-{Demo名称}展示了如何使用 {接口名称} 实现 {功能描述}。
-通过本 Demo，开发者可以了解 {接口的核心用法/参数含义/返回值处理方式}。
-[可选：本 Demo 同时涵盖 {其他关联接口}，展示 {它们之间的调用关系/业务场景}。]
-```
-
-**示例：**
-
-```
-"本 Demo 展示 BlurManager 的完整生命周期管理流程，包括构造（传入 radius 参数）、
-动态更新 radius 属性（setRadius/getRadius 读写）及最终资源释放（release）。
-帮助开发者理解 BlurManager 实例从创建到销毁的正确使用方式，以及 radius 属性的读写一致性。"
-```
-
----
-
-### 测试 Demo 步骤
-
-**步骤结构模板：**
-
-```
-1. 创建 Demo 页面，添加 [UI组件列表：按钮、输入框、展示区、日志区等]。
-2. [用户操作]，触发 `{接口名称}({参数示例})` 调用。
-3. 将接口返回值 / 状态变化展示在 [展示区域名称]。
-4. [下一步操作，如有]，验证 [具体行为]。
-[可选] 5. 对比 / 补充验证步骤。
-```
-
-**步骤描述规范：**
-
-| 维度 | 要求 | 示例 |
-|-----|-----|-----|
-| 页面构建 | 说明需要哪些 UI 组件 | "添加 radius 输入框、'执行'按钮和图片显示区域" |
-| 交互触发 | 明确用户操作和调用时机 | "点击'执行'按钮，调用 `blur(pixelMap)`" |
-| 参数传递 | 说明传入参数来源/示例值 | "传入 radius=15，pixelMap 为图库选取的图片" |
-| 结果展示 | 说明如何在页面显示结果 | "将返回的 PixelMap 显示在结果区域" |
-| 验证方式 | 说明如何判断成功 | "确认图片宽高与原图一致，视觉出现模糊效果" |
-
----
-
-### 测试 Demo 预期结果
-
-**模板：**
-
-```
-1. [页面/UI 状态]：{可观测的界面变化描述}。
-2. [接口返回值]：{返回值类型/内容/范围} 符合预期。
-3. [功能效果]：{功能方面的可验证效果}。
-4. [异常/边界]：{无异常抛出 / 错误码正确返回}。
-[可选] 5. [性能]：{操作耗时在合理范围内}。
-```
-
-**预期结果描述规范：**
-- 必须可观测（能在 Demo 页面上直接看到或测量）
-- 必须具体（避免"正确返回"这样的模糊描述）
-- 推荐包含数值范围（如尺寸不变、耗时 < N秒）
-- 必须包含"无异常/无崩溃"验证项
-
-**示例：**
-
-```
-1. 点击"执行异步模糊"后，按钮立即变为禁用状态，Loading 指示器出现，表明异步任务已启动。
-2. `blur()` 返回的 Promise 正常 resolve，Loading 消失，模糊后图片正确显示在结果区域。
-3. 模糊后图片的宽高像素数与原图完全一致，视觉效果出现模糊。
-4. UI 主线程在等待期间不冻结（可正常操作页面其他控件）。
-5. 无 Promise reject 或未捕获异常；页面日志显示耗时。
-```
-
----
-
-### 对应函数接口
-
-**格式**：每行一个接口，使用代码格式（反引号），包含完整函数签名。
-
-```
-`functionName(paramName: ParamType): ReturnType`
-`ClassName.methodName(param: Type): ReturnType`
-`new ClassName(param: Type)`
-`CONSTANT_NAME: Type`（常量）
-`InterfaceName`（接口类型，仅被其他接口用作参数/返回值时列出）
-```
-
----
-
-## 接口分组决策树
-
-使用以下决策树判断接口是否应合并到同一 Demo：
-
-```
-接口 A 和接口 B 是否应合并？
-│
-├─ A 的返回值是 B 的入参？ ──→ 是 ──→ 合并
-│
-├─ A 和 B 共同完成一个完整业务场景？ ──→ 是 ──→ 合并
-│   （如: init + execute + cleanup）
-│
-├─ A 和 B 都属于同一对象的状态读写？ ──→ 是 ──→ 合并
-│   （如: setter + getter）
-│
-├─ A 不调用 B，B 不调用 A，功能方向不同？ ──→ 是 ──→ 分开
-│
-└─ 默认：分开（每个接口独立 Demo）
-```
-
----
-
-## 常见接口模式与推荐 Demo 封装方式
-
-| 接口模式 | 推荐 Demo 封装 |
-|---------|--------------|
-| `constructor + method + release` | 封装为"完整生命周期 Demo" |
-| `async` 方法（返回 Promise） | 独立 Demo，展示异步等待与结果处理 |
-| `sync` 方法 | 独立 Demo，或与对应 async 方法对比展示 |
-| `getter + setter` 一对 | 合并为"属性读写 Demo" |
-| `init + execute` 依赖链 | 合并为"初始化与执行 Demo" |
-| 多个枚举值影响同一方法行为 | 在同一 Demo 中用选择器切换枚举值展示 |
-| 错误码返回的接口 | 在对应 Demo 中增加"异常输入"验证步骤 |
+# 测试 Demo 描述文档模板
+
+本文件提供生成输出文档时使用的标准模板结构，可直接复制并填入真实内容。
+
+---
+
+## 输出文档模板
+
+```markdown
+# {库名} 测试 Demo 描述文档
+
+## 概述
+
+本文档基于 `{库名}` 库的接口规格说明文档（`{规格文档文件名}`）自动生成，
+提供各接口的 ArkTS 测试 Demo 描述，供开发者参考实现功能验证 Demo 页面。
+
+> 文档基于接口规格文档真实内容生成，所有接口名称、参数类型与规格文档保持一致。
+
+## Demo 总览
+
+| Demo 数量 | 覆盖接口数量 | 生成日期 |
+|----------|------------|---------|
+| {N} 个    | {M} 个      | {YYYY-MM-DD} |
+
+## 测试 Demo 描述列表
+
+| 序号 | 测试 Demo 名称 | 测试 Demo 描述 | 测试 Demo 步骤 | 测试 Demo 预期结果 | 对应函数接口 |
+|-----|--------------|--------------|--------------|-----------------|------------|
+| 1 | {Demo名称1} | {Demo描述1} | {步骤1} | {预期结果1} | {接口列表1} |
+| 2 | {Demo名称2} | {Demo描述2} | {步骤2} | {预期结果2} | {接口列表2} |
+
+## 接口覆盖矩阵
+
+| 序号 | 接口名称 | 所在 Demo | 覆盖状态 |
+|-----|---------|----------|---------|
+| 1 | `{接口签名}` | {Demo名称} | ✅ 已覆盖 |
+```
+
+---
+
+## 各字段填写规范
+
+### 测试 Demo 名称
+
+**格式**：`[功能动词/名词][操作对象][可选场景描述]Demo`
+
+**命名示例：**
+
+| 场景 | 推荐名称 |
+|-----|---------|
+| 单一核心功能 | `图片压缩处理Demo` |
+| 生命周期管理 | `实例创建与销毁Demo` |
+| 配置类接口 | `参数配置与验证Demo` |
+| 异步操作 | `异步数据加载Demo` |
+| 错误处理 | `异常捕获与恢复Demo` |
+| 多接口组合 | `完整处理流程Demo` |
+
+**注意：**
+- 不超过 20 字
+- 避免使用泛化词语（如"基础Demo"、"测试Demo"）
+- 名称应能让开发者直接判断 Demo 的核心目的
+
+---
+
+### 测试 Demo 描述
+
+**模板：**
+
+```
+{Demo名称}展示了如何使用 {接口名称} 实现 {功能描述}。
+通过本 Demo，开发者可以了解 {接口的核心用法/参数含义/返回值处理方式}。
+[可选：本 Demo 同时涵盖 {其他关联接口}，展示 {它们之间的调用关系/业务场景}。]
+```
+
+**示例：**
+
+```
+"本 Demo 展示 BlurManager 的完整生命周期管理流程，包括构造（传入 radius 参数）、
+动态更新 radius 属性（setRadius/getRadius 读写）及最终资源释放（release）。
+帮助开发者理解 BlurManager 实例从创建到销毁的正确使用方式，以及 radius 属性的读写一致性。"
+```
+
+---
+
+### 测试 Demo 步骤
+
+**步骤结构模板：**
+
+```
+1. 创建 Demo 页面，添加 [UI组件列表：按钮、输入框、展示区、日志区等]。
+2. [用户操作]，触发 `{接口名称}({参数示例})` 调用。
+3. 将接口返回值 / 状态变化展示在 [展示区域名称]。
+4. [下一步操作，如有]，验证 [具体行为]。
+[可选] 5. 对比 / 补充验证步骤。
+```
+
+**步骤描述规范：**
+
+| 维度 | 要求 | 示例 |
+|-----|-----|-----|
+| 页面构建 | 说明需要哪些 UI 组件 | "添加 radius 输入框、'执行'按钮和图片显示区域" |
+| 交互触发 | 明确用户操作和调用时机 | "点击'执行'按钮，调用 `blur(pixelMap)`" |
+| 参数传递 | 说明传入参数来源/示例值 | "传入 radius=15，pixelMap 为图库选取的图片" |
+| 结果展示 | 说明如何在页面显示结果 | "将返回的 PixelMap 显示在结果区域" |
+| 验证方式 | 说明如何判断成功 | "确认图片宽高与原图一致，视觉出现模糊效果" |
+
+---
+
+### 测试 Demo 预期结果
+
+**模板：**
+
+```
+1. [页面/UI 状态]：{可观测的界面变化描述}。
+2. [接口返回值]：{返回值类型/内容/范围} 符合预期。
+3. [功能效果]：{功能方面的可验证效果}。
+4. [异常/边界]：{无异常抛出 / 错误码正确返回}。
+[可选] 5. [性能]：{操作耗时在合理范围内}。
+```
+
+**预期结果描述规范：**
+- 必须可观测（能在 Demo 页面上直接看到或测量）
+- 必须具体（避免"正确返回"这样的模糊描述）
+- 推荐包含数值范围（如尺寸不变、耗时 < N秒）
+- 必须包含"无异常/无崩溃"验证项
+
+**示例：**
+
+```
+1. 点击"执行异步模糊"后，按钮立即变为禁用状态，Loading 指示器出现，表明异步任务已启动。
+2. `blur()` 返回的 Promise 正常 resolve，Loading 消失，模糊后图片正确显示在结果区域。
+3. 模糊后图片的宽高像素数与原图完全一致，视觉效果出现模糊。
+4. UI 主线程在等待期间不冻结（可正常操作页面其他控件）。
+5. 无 Promise reject 或未捕获异常；页面日志显示耗时。
+```
+
+---
+
+### 对应函数接口
+
+**格式**：每行一个接口，使用代码格式（反引号），包含完整函数签名。
+
+```
+`functionName(paramName: ParamType): ReturnType`
+`ClassName.methodName(param: Type): ReturnType`
+`new ClassName(param: Type)`
+`CONSTANT_NAME: Type`（常量）
+`InterfaceName`（接口类型，仅被其他接口用作参数/返回值时列出）
+```
+
+---
+
+## 接口分组决策树
+
+使用以下决策树判断接口是否应合并到同一 Demo：
+
+```
+接口 A 和接口 B 是否应合并？
+│
+├─ A 的返回值是 B 的入参？ ──→ 是 ──→ 合并
+│
+├─ A 和 B 共同完成一个完整业务场景？ ──→ 是 ──→ 合并
+│   （如: init + execute + cleanup）
+│
+├─ A 和 B 都属于同一对象的状态读写？ ──→ 是 ──→ 合并
+│   （如: setter + getter）
+│
+├─ A 不调用 B，B 不调用 A，功能方向不同？ ──→ 是 ──→ 分开
+│
+└─ 默认：分开（每个接口独立 Demo）
+```
+
+---
+
+## 常见接口模式与推荐 Demo 封装方式
+
+| 接口模式 | 推荐 Demo 封装 |
+|---------|--------------|
+| `constructor + method + release` | 封装为"完整生命周期 Demo" |
+| `async` 方法（返回 Promise） | 独立 Demo，展示异步等待与结果处理 |
+| `sync` 方法 | 独立 Demo，或与对应 async 方法对比展示 |
+| `getter + setter` 一对 | 合并为"属性读写 Demo" |
+| `init + execute` 依赖链 | 合并为"初始化与执行 Demo" |
+| 多个枚举值影响同一方法行为 | 在同一 Demo 中用选择器切换枚举值展示 |
+| 错误码返回的接口 | 在对应 Demo 中增加"异常输入"验证步骤 |