deveco_hmigbot 0.21.5

package/skills/migrate-core/references/topics/system-capabilities/print-management.md

@@ -0,0 +1,213 @@
+# 系统打印管理
+
+> ⚠ 本文样例中 `getContext(this)` 为已废弃写法：组件内一律改 `this.getUIContext().getHostContext()`；Ability 内用 `this.context`。
+
+
+> 使用 `@kit.BasicServicesKit` 的 `print` 模块拉起系统打印服务，替代 Android 的 `WebView.print()` 和 `PrintDocumentAdapter`。
+
+---
+
+## 基本导入
+
+```typescript
+import { print } from '@kit.BasicServicesKit';
+import { common } from '@kit.AbilityKit';
+```
+
+---
+
+## 打印当前 Web 页面
+
+> 对应 Android：`WebView.print()`
+
+### 基础用法
+
+```typescript
+import { print } from '@kit.BasicServicesKit';
+
+function printWebPage(context: common.UIAbilityContext, webController: WebviewController, jobName: string): void {
+  // 创建 Web 打印文档适配器
+  const adapter = webController.createWebPrintDocumentAdapter(jobName);
+
+  // 发起打印
+  print.print(jobName, adapter, null, context)
+    .then(() => {
+      hilog.info(DOMAIN, TAG, `Print job ${jobName} sent successfully`);
+    })
+    .catch((err: Error) => {
+      hilog.error(DOMAIN, TAG, `Print failed: ${err.message}`);
+    });
+}
+```
+
+### 在 BrowserPage 中的调用示例
+
+```typescript
+import { print } from '@kit.BasicServicesKit';
+import { promptAction } from '@kit.ArkUI';
+
+savePdf(): void {
+  const adapter = this.webController.createWebPrintDocumentAdapter('savePdf');
+  print.print('printJob', adapter, null, getContext(this))
+    .then(() => {
+      promptAction.showToast({ message: '已发送至打印服务', duration: 2000 });
+    })
+    .catch((err: Error) => {
+      promptAction.showToast({ message: '打印失败: ' + err.message, duration: 2000 });
+    });
+}
+```
+
+---
+
+## 打印自定义内容（PrintDocumentAdapter）
+
+> 用于打印非 Web 内容，如自定义绘制的页面、生成的 PDF 等
+
+```typescript
+import { print, BusinessError } from '@kit.BasicServicesKit'
+import { common } from '@kit.AbilityKit'
+import { fileIo as fs } from '@kit.CoreFileKit'
+
+// PrintDocumentAdapter 是接口（不是类），只有两个回调：
+//   onStartLayoutWrite —— 系统给出目标 fd，把要打印的内容（PDF）写进去，再回调文件生成状态
+//   onJobStateChanged —— 任务状态变化（PREVIEW_DESTROY / PRINT_TASK_SUCCEED / _FAIL / _CANCEL / _BLOCK）
+class PdfPrintAdapter implements print.PrintDocumentAdapter {
+  private srcPdfPath: string
+  constructor(srcPdfPath: string) { this.srcPdfPath = srcPdfPath }
+
+  onStartLayoutWrite(jobId: string, oldAttrs: print.PrintAttributes, newAttrs: print.PrintAttributes, fd: number,
+    writeResultCallback: (jobId: string, writeResult: print.PrintFileCreationState) => void): void {
+    try {
+      const src = fs.openSync(this.srcPdfPath, fs.OpenMode.READ_ONLY)
+      fs.copyFileSync(src.fd, fd)
+      fs.closeSync(src)
+      writeResultCallback(jobId, print.PrintFileCreationState.PRINT_FILE_CREATED)
+    } catch (e) {
+      writeResultCallback(jobId, print.PrintFileCreationState.PRINT_FILE_CREATION_FAILED)
+    }
+  }
+
+  onJobStateChanged(jobId: string, state: print.PrintDocumentAdapterState): void {
+    if (state === print.PrintDocumentAdapterState.PRINT_TASK_FAIL) { /* 给用户可见提示 */ }
+  }
+}
+
+async function startCustomPrint(context: common.UIAbilityContext, pdfPath: string): Promise<void> {
+  const attrs: print.PrintAttributes = {
+    copyNumber: 1,
+    directionMode: print.PrintDirectionMode.DIRECTION_MODE_PORTRAIT,
+    colorMode: print.PrintColorMode.COLOR_MODE_COLOR,
+    duplexMode: print.PrintDuplexMode.DUPLEX_MODE_NONE,
+  }
+  try {
+    const task: print.PrintTask = await print.print('CustomPrintJob', new PdfPrintAdapter(pdfPath), attrs, context)
+    task.on('succeed', () => { /* 完成 */ })
+    task.on('fail', () => { /* 失败：可见提示 */ })
+  } catch (e) {
+    const err = e as BusinessError   // 201 未声明 ohos.permission.PRINT / 401 参数错
+  }
+}
+```
+
+---
+
+## print.print() 参数说明
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| `jobName` | `string` | 打印任务名称，显示在系统打印管理器中 |
+| `printAdapter` | `PrintDocumentAdapter` | 实现 `onStartLayoutWrite` + `onJobStateChanged` 的对象 |
+| `printAttributes` | `PrintAttributes` | 打印属性（份数/页范围/纸张/方向/色彩/双面），必填对象，字段均可选 |
+| `context` | `Context` | Ability 上下文 |
+| 返回 | `Promise<PrintTask>` | `task.on('succeed' \| 'fail' \| 'cancel' \| 'block', cb)` 监听结果 |
+
+另一种形态 `print.print(files: string[], context)`：直接打印文件路径列表（只支持 PDF 与图片）。
+
+### PrintAttributes 常用配置
+
+```typescript
+const attributes: print.PrintAttributes = {
+  copyNumber: 1,
+  pageRange: { startPage: 0, endPage: 0 },                                   // PrintPageRange
+  pageSize: print.PrintPageType.PAGE_ISO_A4,                                 // 或 PrintPageSize { id, name, width, height }
+  directionMode: print.PrintDirectionMode.DIRECTION_MODE_PORTRAIT,           // AUTO / PORTRAIT / LANDSCAPE
+  colorMode: print.PrintColorMode.COLOR_MODE_COLOR,                          // MONOCHROME / COLOR
+  duplexMode: print.PrintDuplexMode.DUPLEX_MODE_NONE,                        // NONE / LONG_EDGE / SHORT_EDGE
+}
+```
+
+### 状态枚举
+
+| 枚举 | 值 |
+|----|------|
+| `PrintFileCreationState`（onStartLayoutWrite 回调） | `PRINT_FILE_CREATED` / `PRINT_FILE_CREATION_FAILED` / `PRINT_FILE_CREATED_UNRENDERED` |
+| `PrintDocumentAdapterState`（onJobStateChanged） | `PREVIEW_DESTROY` / `PRINT_TASK_SUCCEED` / `PRINT_TASK_FAIL` / `PRINT_TASK_CANCEL` / `PRINT_TASK_BLOCK` |
+
+---
+
+## module.json5 配置
+
+`print.print()` 与适配器回调都标注 `@permission ohos.permission.PRINT`（normal 级、system_grant：声明即自动授权，不用运行时请求）；未声明抛 201。
+
+```json5
+{
+  "requestPermissions": [
+    { "name": "ohos.permission.PRINT" }
+  ]
+}
+```
+
+---
+
+## 常见错误
+
+### 错误 1：Web 打印适配器未创建
+
+```typescript
+// 错误 — webController 可能为 null
+const adapter = this.webController.createWebPrintDocumentAdapter('job');
+
+// 正确 — 确保 webController 已初始化
+if (this.webController) {
+  const adapter = this.webController.createWebPrintDocumentAdapter('job');
+  print.print('job', adapter, null, getContext(this));
+}
+```
+
+### 错误 2：未处理 print.print() 的 Promise  rejection
+
+```typescript
+// 错误 — 可能静默失败
+print.print(jobName, adapter, null, context);
+
+// 正确 — 必须处理错误
+print.print(jobName, adapter, null, context)
+  .catch((err: Error) => {
+    hilog.error(DOMAIN, TAG, `Print failed: ${err.message}`);
+  });
+```
+
+---
+
+## Android 对应关系
+
+| Android | HarmonyOS |
+|---------|-----------|
+| `WebView.print()` | `webController.createWebPrintDocumentAdapter()` + `print.print()` |
+| `PrintDocumentAdapter` | `class CustomPrintDocumentAdapter extends print.PrintDocumentAdapter` |
+| `PrintManager.print()` | `print.print()` |
+| `PrintAttributes` | `print.PrintAttributes` |
+
+---
+
+## 与 documentPicker.save() 的区别
+
+| 维度 | 打印 (`print.print`) | 保存文件 (`DocumentViewPicker.save`) |
+|------|---------------------|-------------------------------------|
+| 用途 | 发送给打印服务 | 保存到文件系统 |
+| 输出 | 纸质打印 / 虚拟 PDF | 文件（.mht / .pdf 等） |
+| 用户操作 | 选择打印机、份数 | 选择保存位置和文件名 |
+| Web 内容 | ✅ `WebPrintDocumentAdapter` | ❌ 不支持 |
+| 自定义内容 | ✅ `PrintDocumentAdapter` | ❌ 不支持 |
+| module.json5 配置 | 通常不需要 | 不需要 |

package/skills/migrate-core/references/topics/system-capabilities/share-panel.md

@@ -0,0 +1,177 @@
+# 分享面板 ShareKit
+
+> 使用 `@kit.ShareKit` 拉起系统分享面板，替代 Android 的 `Intent.ACTION_SEND`。
+
+---
+
+## 基本导入
+
+```typescript
+import { systemShare } from '@kit.ShareKit'
+import { uniformTypeDescriptor as utd } from '@kit.ArkData'
+import { common } from '@kit.AbilityKit'
+```
+
+---
+
+## 完整调用模板
+
+```typescript
+async function shareMedia(
+  context: common.UIAbilityContext,
+  uri: string,
+  title: string,
+  mimeType: string
+): Promise<void> {
+  // 1. 求该文件自己的 UTD 类型 ID（按后缀推断，不要硬塞 belongsTo）
+  const ext = uri.substring(uri.lastIndexOf('.') + 1).toLowerCase()
+  const utdTypeId = utd.getUniformDataTypeByFilenameExtension('.' + ext)
+
+  // 2. 构建分享数据
+  const shareData: systemShare.SharedData = new systemShare.SharedData({
+    utd: utdTypeId,
+    uri: uri,
+    title: title,
+    description: '分享 ' + title
+  })
+
+  // 3. 创建分享控制器
+  const controller: systemShare.ShareController = new systemShare.ShareController(shareData)
+
+  // 4. 展示分享面板
+  controller.show(context, {
+    selectionMode: systemShare.SelectionMode.SINGLE,
+    previewMode: systemShare.SharePreviewMode.DETAIL
+  }).then(() => {
+    hilog.info(DOMAIN, TAG, 'ShareController show success')
+  }).catch((error: BusinessError) => {
+    hilog.error(DOMAIN, TAG, `ShareController show error: ${error.code}, ${error.message}`)
+    promptAction.showToast({ message: '分享失败' })
+  })
+}
+```
+
+---
+
+## MIME 类型判断
+
+```typescript
+private getMimeType(medium: Medium): string {
+  if ((medium.type & TYPE_VIDEOS) !== 0) {
+    return 'video/*'
+  }
+  if ((medium.type & TYPE_IMAGES) !== 0) {
+    return 'image/*'
+  }
+  return '*/*'
+}
+```
+
+---
+
+## SharePreviewMode 配置
+
+| 模式 | 效果 |
+|------|------|
+| `DETAIL` | 显示详情预览（推荐） |
+| `NONE` | 不显示预览 |
+
+## SelectionMode 配置
+
+`SelectionMode` 只有两个成员（`@kit.ShareKit`，编译校验过）。**没有 `MULTIPLE`**——写 `SelectionMode.MULTIPLE` 会编译失败：`Property 'MULTIPLE' does not exist on type 'typeof SelectionMode'`。
+
+| 模式 | 值 | 效果 |
+|------|----|------|
+| `SINGLE` | 0 | 单选模式：传入多条记录时，用户多选一进行分享（缺省值） |
+| `BATCH` | 1 | 批量模式：分享全部数据记录 |
+
+> 一次分享多条记录、想让目标应用收到全部记录时，用 `selectionMode: systemShare.SelectionMode.BATCH`。
+> ⚠️ BATCH 批量模式只支持文件类型记录（每条 `SharedRecord` 走 `uri` 的 File 类型）；混入纯文本/链接等非文件记录会触发错误码 `1003702001`。
+
+---
+
+## module.json5 配置
+
+### 配置规则
+
+| 分享内容类型 | 是否需要配置 | 说明 |
+|------------|------------|------|
+| 图片/视频/文件 | 通常不需要 | 系统已内置支持 |
+| 纯文本 | 需要配置 | 需声明 `ohos.want.action.send` |
+| 自定义数据 | 需要配置 | 需声明 `ohos.want.action.send` |
+
+### 配置示例（纯文本/自定义数据）
+
+```json5
+{
+  "skills": [{
+    "entities": ["entity.system.home"],
+    "actions": [
+      "ohos.want.action.home",
+      "ohos.want.action.send"    // 发送数据
+    ]
+  }]
+}
+```
+
+> ⚠️ **注意**：虽然图片/视频分享通常不需要额外声明，但某些设备可能需要。如遇分享失败，建议添加 `ohos.want.action.send` 配置。
+
+---
+
+## 常见错误
+
+### 错误 1：不转换 UTD 直接传 MIME
+
+```typescript
+// 错误 — 部分设备不支持
+const shareData = new systemShare.SharedData({
+  mimeType: 'image/*',  // ❌
+  uri: uri,
+  title: title
+})
+
+// 正确 — 使用 UTD（按后缀推断，不传 belongsTo）
+const utdTypeId = utd.getUniformDataTypeByFilenameExtension('.' + ext)
+const shareData = new systemShare.SharedData({
+  utd: utdTypeId,
+  uri: uri,
+  title: title
+})
+```
+
+### 错误 2：show() 后不 await
+
+`controller.show()` 是异步的，但不会阻塞 UI。不需要 await，但错误需要通过 catch 处理。
+
+### 错误 3：给每个文件的 `getUniformDataTypeByFilenameExtension` 硬塞第二参 IMAGE
+
+签名是 `getUniformDataTypeByFilenameExtension(filenameExtension: string, belongsTo?: string): string`——**第二参 `belongsTo` 可选**（归属类型 ID，无默认值）。按后缀推断类型时**只传后缀、不传第二参**；否则给 `.pdf` 也塞 `utd.UniformDataType.IMAGE` 会把它误标成图片。
+
+```typescript
+// 错误 — 所有扩展名都硬塞 IMAGE，.pdf / .txt 被误标
+const t = utd.getUniformDataTypeByFilenameExtension('.' + ext, utd.UniformDataType.IMAGE)  // ❌
+
+// 正确 A — 按后缀推断：只传一个后缀实参
+const t = utd.getUniformDataTypeByFilenameExtension('.' + ext)
+
+// 正确 B — 类型已知时直接用字面 UTD 枚举（更精准，无需查后缀）
+const t = utd.UniformDataType.PNG        // 或 JPEG / PDF / IMAGE / TEXT / PLAIN_TEXT ...
+```
+
+> `SharedRecord` 用 `utd`（string）承载类型、`uri` 承载文件位置、文本/链接用 `content`；**没有 `mimeType` 字段**。`content` 与 `uri` 至少一个非空。
+
+### 多条记录批量分享
+
+一个 `SharedData` 至少含一条记录。多条时：用首条 `new systemShare.SharedData(firstRecord)`，其余用实例方法 `sharedData.addRecord(record)` 逐条追加——**构造器只收单条 `SharedRecord`，不能把数组塞进构造器，也不要为每个文件各建一个 `SharedData`/`ShareController`**。每条记录的 `utd` 按它自己的扩展名求得。
+
+```typescript
+const shareData = new systemShare.SharedData(records[0])
+for (let i = 1; i < records.length; i++) {
+  shareData.addRecord(records[i])
+}
+const controller = new systemShare.ShareController(shareData)
+controller.show(context, {
+  selectionMode: systemShare.SelectionMode.BATCH,   // 全部记录一起分享
+  previewMode: systemShare.SharePreviewMode.DETAIL
+}).then(() => {}).catch((e: BusinessError) => {})
+```

package/skills/migrate-core/references/topics/system-capabilities/system-settings.md

@@ -0,0 +1,322 @@
+# 系统设置跳转
+
+> ⚠ 设备相关总标注：文内 com.huawei.settings/MainAbility 等设置页包名与 uri 为特定 ROM 实测值，随品牌/版本可变——使用前按目标设备验证，失败走通用 want 降级。
+
+> ⚠ 本文样例中 `getContext(this)` 为已废弃写法：组件内一律改 `this.getUIContext().getHostContext()`；Ability 内用 `this.context`。
+
+
+> 使用显式 Want + startAbility 跳转到系统设置页面，替代 Android 的 Settings.ACTION_APPLICATION_DETAILS_SETTINGS。
+
+---
+
+## 基本导入
+
+```typescript
+import { common, Want } from '@kit.AbilityKit'
+import { hilog } from '@kit.PerformanceAnalysisKit'
+import { BusinessError } from '@kit.BasicServicesKit'
+```
+
+---
+
+## 跳转到应用权限设置页
+
+> ✅ **验证状态**：已在 PermissionHelper.ets:168-182 中验证
+
+```typescript
+function openAppSettings(context: common.UIAbilityContext): void {
+  try {
+    const params: Record<string, string> = { 'page': 'permission' }
+    const want: Want = {
+      bundleName: 'com.huawei.settings',              // 华为系统设置包名
+      abilityName: 'com.huawei.settings.MainAbility', // 主 Ability
+      action: 'action.settings.app.info',             // 应用信息页
+      parameters: params                               // 传递参数
+    }
+    
+    context.startAbility(want)
+      .then(() => {
+        hilog.info(DOMAIN, TAG, 'Opened app settings')
+      })
+      .catch((err: Error) => {
+        hilog.error(DOMAIN, TAG, `Failed to open settings: ${err.message}`)
+      })
+  } catch (err) {
+    const error = err as BusinessError
+    hilog.error(DOMAIN, TAG, `openAppSettings error: ${error.message}`)
+  }
+}
+```
+
+---
+
+## 封装为工具方法
+
+```typescript
+// common/PermissionHelper.ets
+export class PermissionHelper {
+  private context: common.UIAbilityContext
+
+  constructor(context: common.UIAbilityContext) {
+    this.context = context
+  }
+
+  openAppSettings(): void {
+    try {
+      const params: Record<string, string> = { 'page': 'permission' }
+      const want: Want = {
+        bundleName: 'com.huawei.settings',
+        abilityName: 'com.huawei.settings.MainAbility',
+        action: 'action.settings.app.info',
+        parameters: params
+      }
+      this.context.startAbility(want)
+    } catch (err) {
+      const error = err as BusinessError
+      hilog.error(DOMAIN, TAG, `openAppSettings error: ${error.message}`)
+    }
+  }
+}
+```
+
+---
+
+## 常见系统设置页面
+
+| Action | 用途 | 说明 |
+|--------|------|------|
+| `action.settings.app.info` | 应用信息页 | 权限管理、存储占用等 ✅ 已验证 |
+
+> 其它设置页（WiFi/蓝牙/定位）的入口未核实，不写；需要时查官方文档再加，不猜 action 名。
+
+---
+
+## 显式 vs 隐式 Want
+
+### 显式 Want（系统设置跳转使用）
+```typescript
+const want: Want = {
+  bundleName: 'com.huawei.settings',    // 明确指定目标应用
+  abilityName: 'com.huawei.settings.MainAbility',
+  action: 'action.settings.app.info'
+}
+```
+**特点**：
+- 精确跳转到指定应用
+- 适用于系统应用跳转
+- 不需要在 module.json5 中声明 skills
+
+### 隐式 Want（浏览器/分享使用）
+```typescript
+const want: Want = {
+  action: 'ohos.want.action.viewData',  // 只指定 action
+  uri: 'https://example.com'            // 让系统匹配
+}
+```
+**特点**：
+- 让系统选择合适的应用
+- 适用于第三方应用跳转
+- 可能需要在 module.json5 中声明 skills
+
+---
+
+## 使用场景
+
+### 何时跳转到系统设置？
+
+1. ✅ 用户拒绝了关键权限，需要手动开启
+2. ✅ 需要用户配置系统级设置（WiFi、蓝牙等）
+3. ✅ 应用出现异常，引导用户检查权限
+
+### 最佳实践：权限拒绝后引导
+
+```typescript
+import { promptAction } from '@kit.ArkUI'
+
+async function requestPermissionWithFallback(
+  context: common.UIAbilityContext
+): Promise<void> {
+  const atManager = abilityAccessCtrl.createAtManager()
+  const permissions: Permissions[] = ['ohos.permission.CAMERA']
+  
+  const result = await atManager.requestPermissionsFromUser(context, permissions)
+  
+  // 检查是否有权限被拒绝
+  const denied = result.authResults.some(r => r !== 0)
+  
+  if (denied) {
+    // 用户拒绝了权限，引导到设置页面
+    promptAction.showDialog({
+      title: '需要权限',
+      message: '请在设置中开启相关权限以使用完整功能',
+      buttons: [
+        { text: '取消', color: '#999999' },
+        { text: '去设置', color: '#007DFF' }
+      ]
+    }).then((result: promptAction.ShowDialogSuccessResponse) => {
+      if (result.index === 1) {
+        openAppSettings(context)  // 跳转到设置
+      }
+    })
+  }
+}
+```
+
+### 完整示例：在页面中使用
+
+```typescript
+// pages/Index.ets（V2，API 12+）
+@ComponentV2
+struct Index {
+  private permissionHelper: PermissionHelper | null = null
+  @Local permissionDenied: boolean = false
+
+  aboutToAppear(): void {
+    const context = getContext(this) as common.UIAbilityContext
+    this.permissionHelper = PermissionHelper.getInstance(context)
+  }
+
+  build() {
+    Column() {
+      // 权限错误提示
+      if (this.permissionDenied) {
+        this.buildPermissionErrorUI()
+      }
+    }
+  }
+
+  @Builder
+  buildPermissionErrorUI() {
+    Column() {
+      Text('权限被拒绝')
+        .fontSize(20)
+        .fontWeight(FontWeight.Bold)
+      
+      Text('请在设置中开启相关权限')
+        .fontSize(14)
+        .margin({ top: 16 })
+      
+      Button($r('app.string.permission_open_settings'))
+        .width(200)
+        .margin({ top: 16 })
+        .onClick(() => {
+          this.permissionHelper?.openAppSettings()
+        })
+    }
+    .width('100%')
+    .height('100%')
+    .justifyContent(FlexAlign.Center)
+  }
+}
+```
+
+---
+
+## module.json5 配置
+
+系统设置跳转通常**不需要额外配置**，因为是显式调用已知应用。
+
+但如果需要响应外部查看请求，需要配置：
+```json5
+{
+  "skills": [{
+    "entities": ["entity.system.home"],
+    "actions": [
+      "ohos.want.action.home",
+      "ohos.want.action.view"
+    ]
+  }]
+}
+```
+
+---
+
+## 常见错误
+
+### 错误 1：使用错误的 bundleName
+
+```typescript
+// 错误 — 非华为设备可能失败
+const want: Want = {
+  bundleName: 'com.huawei.settings',
+  abilityName: 'com.huawei.settings.MainAbility'
+}
+
+// 正确 — 根据设备厂商判断（如果需要跨设备）
+import { deviceInfo } from '@kit.BasicServicesKit'
+
+const bundleName = deviceInfo.brand === 'huawei' 
+  ? 'com.huawei.settings' 
+  : 'com.android.settings'  // 其他设备
+```
+
+### 错误 2：忘记错误处理
+
+```typescript
+// 错误 — startAbility 可能失败
+context.startAbility(want)
+
+// 正确 — 处理失败情况
+context.startAbility(want)
+  .then(() => {
+    hilog.info(DOMAIN, TAG, 'Opened settings')
+  })
+  .catch((err: Error) => {
+    hilog.error(DOMAIN, TAG, `Failed to open settings: ${err.message}`)
+    promptAction.showToast({ message: '无法打开设置页面' })
+  })
+```
+
+### 错误 3：参数传递错误
+
+```typescript
+// 错误 — 参数类型错误
+const want: Want = {
+  bundleName: 'com.huawei.settings',
+  parameters: { 'page': 123 }  // ❌ 应该是 string
+}
+
+// 正确 — 参数类型正确
+const want: Want = {
+  bundleName: 'com.huawei.settings',
+  parameters: { 'page': 'permission' }  // ✅ string 类型
+}
+```
+
+---
+
+## 与其他跳转方式的对比
+
+| 跳转类型 | Want 类型 | 是否需要配置 | 适用场景 |
+|---------|----------|------------|---------|
+| 系统设置跳转 | 显式 Want | 不需要 | 跳转到已知系统应用 |
+| 浏览器跳转 | 隐式 Want | 通常不需要 | 打开网页/邮件链接 |
+| 分享面板 | 系统 API | 通常不需要 | 分享内容到其他应用 |
+| 系统相机 | 系统 API | **需要** | 拍照/录像 |
+
+---
+
+## 调用链分析
+
+```
+[UI层] 用户点击"打开设置"按钮
+    ↓
+[事件层] Button.onClick 回调
+    ↓
+[工具层] PermissionHelper.openAppSettings()
+    ↓
+[Want构建] 创建显式 Want 对象
+    ↓
+[系统API] context.startAbility(want)
+    ↓
+[系统应用] 华为系统设置应用
+    ↓
+[页面显示] 应用信息/权限设置页
+```
+
+---
+
+## 参考链接
+
+- [AbilityKit API 文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/js-apis-app-ability-want-V5)
+- [权限管理最佳实践](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/permission-overview-V5)