@hmos-library-adapter/fast 0.0.17-beta.0 → 0.0.17-beta.2

package/node_modules/@ohos-agent/pc-adapter/skills/pc-knowledge-base/electron/data/api-confirmed-plans.json

@@ -0,0 +1,628 @@
+{
+  "$comment": "人工确认的 API 适配方案知识库（唯一真源）。键 = api-verdicts.json 矩阵键名；值.plan 为 {cause, steps[]}，partial-api 行附 diffNote。语义：进入本文件的方案全部视为已验证（是否验证列渲染 √），render 逐字采用、不允许模型改写或覆盖；矩阵未覆盖本文件的 API 仍走模型展开 seed 的原逻辑。来源：Electron框架差异API分析模板.xlsx 人工确认（2026-09-16，54 条正确 + 21 条错误修正）。修订：2026-09-16 依据 input/update.md 更新日志（v34.6.2–v34.8.5）——6 条判定刷支持后清出（autoUpdater 五事件 + getPrintersAsync），quitAndInstall/setFeedURL 改判有差异后重写；showInactive/isTabletMode 依据 v34.8.5 新增的 setFocusable 与折叠姿态接口升级为直接承接。维护：新增确认方案时按键追加；判定被矩阵修正刷支持时同步清出对应条目；报告格式契约见 SKILL.md 步骤 3 与 references/data-contracts.md。",
+  "plans": {
+    "BrowserWindow.closeFilePreview": {
+      "plan": {
+        "cause": "鸿蒙无 QuickLook 预览浮层，文件预览由系统应用接管，应用侧无程序化关闭接口",
+        "steps": [
+          "closeFilePreview 调用点删除或包 isOHOS 守卫跳过"
+        ]
+      }
+    },
+    "BrowserWindow.isMenuBarAutoHide": {
+      "plan": {
+        "cause": "鸿蒙不支持 set/is 方法对，但支持同名属性读写",
+        "steps": [
+          "isMenuBarAutoHide 查询改为读 win.autoHideMenuBar 属性"
+        ]
+      }
+    },
+    "BrowserWindow.isMenuBarVisible": {
+      "plan": {
+        "cause": "鸿蒙不支持 set/is 方法对，但支持同名属性读写",
+        "steps": [
+          "isMenuBarVisible 查询改为读 win.menuBarVisible 属性"
+        ]
+      }
+    },
+    "BrowserWindow.previewFile": {
+      "plan": {
+        "cause": "鸿蒙无 QuickLook 预览浮层，文件预览交系统应用承接",
+        "steps": [
+          "文件预览改用 shell.openPath(filePath) 交系统文件管理器/预览器打开"
+        ]
+      }
+    },
+    "BrowserWindow.setAutoHideMenuBar": {
+      "plan": {
+        "cause": "鸿蒙不支持 set/is 方法对，但支持同名属性读写",
+        "steps": [
+          "setAutoHideMenuBar 调用改为写 win.autoHideMenuBar 属性"
+        ]
+      }
+    },
+    "BrowserWindow.setBackgroundMaterial": {
+      "plan": {
+        "cause": "鸿蒙无 Mica/亚克力窗口材质，且主窗口不支持透明",
+        "steps": [
+          "setBackgroundMaterial 调用点包 isOHOS 守卫跳过",
+          "如果确实需要透明或半透明窗口，新建窗口的 windowInfo.type 用 floatWindow 或 subWindow，配合 transparent、opacity 或 backgroundColor 的 alpha 通道实现"
+        ]
+      }
+    },
+    "BrowserWindow.setMenuBarVisibility": {
+      "plan": {
+        "cause": "鸿蒙不支持 set/is 方法对，但支持同名属性读写",
+        "steps": [
+          "setMenuBarVisibility 调用改为写 win.menuBarVisible 属性"
+        ]
+      }
+    },
+    "BrowserWindow.setVibrancy": {
+      "plan": {
+        "cause": "鸿蒙无毛玻璃材质效果，且主窗口不支持透明",
+        "steps": [
+          "setVibrancy 调用点包 isOHOS 守卫跳过",
+          "如果确实需要透明或半透明窗口，新建窗口的 windowInfo.type 用 floatWindow 或 subWindow，配合 transparent、opacity 或 backgroundColor 的 alpha 通道实现"
+        ]
+      }
+    },
+    "Tray.closeContextMenu": {
+      "plan": {
+        "cause": "setContextMenu 设置的托盘菜单由系统管理显示与关闭，菜单显隐由用户操作，应用侧无程序化关闭接口",
+        "steps": [
+          "closeContextMenu 调用点删除或包 isOHOS 守卫跳过，托盘菜单交互交给 setContextMenu 常驻菜单",
+          "程序化关闭托盘菜单鸿蒙无对应能力，有需要时向华为提需求"
+        ]
+      }
+    },
+    "WebFrameMain.frame.collectJavaScriptCallStack": {
+      "plan": {
+        "cause": "鸿蒙不支持运行时采集 JS 调用栈，crashReporter 的崩溃堆栈落为 native 栈、JS 帧不可读",
+        "steps": [
+          "collectJavaScriptCallStack 调用点删除或包 isOHOS 守卫跳过",
+          "挂起/卡顿诊断降级为渲染进程内自行采集：performance API 与 Error().stack 埋点上报",
+          "运行时 JS 调用栈采集能力同步向 Electron-OH 提需求"
+        ]
+      }
+    },
+    "app.getApplicationInfoForProtocol": {
+      "plan": {
+        "cause": "鸿蒙的协议默认处理应用查询只返回应用名，图标与安装路径无对应信息",
+        "steps": [
+          "改用 app.getApplicationNameForProtocol(url) 获取协议默认处理方的应用名（支持）",
+          "依赖图标与安装路径的展示降级为仅显示应用名"
+        ]
+      }
+    },
+    "app.hide": {
+      "plan": {
+        "cause": "鸿蒙无应用级隐藏 API，窗口级 hide/show 均支持",
+        "steps": [
+          "app.hide 改为逐窗隐藏：BrowserWindow.getAllWindows().forEach(win => win.hide())",
+          "恢复显示时逐窗调用 win.show()"
+        ]
+      }
+    },
+    "app.importCertificate": {
+      "plan": {
+        "cause": "系统证书库导入无 JS 侧 API，证书能力经桥接层承接",
+        "steps": [
+          "importCertificate 调用点包 isOHOS 守卫跳过",
+          "证书导入改经 systemPreferences.callArkTSAsyncFunction 桥接系统证书管理接口，module.json5 声明 ohos.permission.ACCESS_CERT_MANAGER",
+          "桥接参数达到 4 个及以上时退化为字符串传递，Promise 错误不回传，错误信息改由返回 JSON 的 code/message 字段表达",
+          "证书能力同步向 Electron-OH 提需求"
+        ]
+      }
+    },
+    "app.isHidden": {
+      "plan": {
+        "cause": "鸿蒙无应用级隐藏状态查询，窗口级可见性查询支持",
+        "steps": [
+          "app.isHidden 改为窗口可见性聚合判断：全部窗口 isVisible() 为 false 视为已隐藏"
+        ]
+      }
+    },
+    "app.releaseSingleInstanceLock": {
+      "plan": {
+        "cause": "应用级单实例锁无 JS 侧 API，单实例由 HAP 工程配置承接",
+        "steps": [
+          "releaseSingleInstanceLock 调用删除或包 isOHOS 守卫跳过",
+          "单实例改 HAP 工程配置：module.json5 的 launchType 设为 specified，并去掉 multiAppMode"
+        ]
+      }
+    },
+    "app.removeAsDefaultProtocolClient": {
+      "plan": {
+        "cause": "鸿蒙不支持运行时动态注册/取消协议默认处理器，协议承接随应用包静态配置",
+        "steps": [
+          "removeAsDefaultProtocolClient 调用点包 isOHOS 守卫跳过",
+          "协议承接改应用包静态声明：module.json5 的 skills 配置 actions 与 uris.scheme，或用 electron-builder-ohos 的 ohos.skills 配置项",
+          "取消默认处理器由系统设置管理，应用侧无接口"
+        ]
+      }
+    },
+    "app.setAsDefaultProtocolClient": {
+      "plan": {
+        "cause": "鸿蒙不支持运行时动态注册/取消协议默认处理器，协议承接随应用包静态配置",
+        "steps": [
+          "setAsDefaultProtocolClient 调用点包 isOHOS 守卫跳过",
+          "协议承接改应用包静态声明：module.json5 的 skills 配置 actions 与 uris.scheme，或用 electron-builder-ohos 的 ohos.skills 配置项"
+        ]
+      }
+    },
+    "autoUpdater.getFeedURL": {
+      "plan": {
+        "cause": "Squirrel 更新链路在鸿蒙不存在，更新源配置语义无承接",
+        "steps": [
+          "getFeedURL 调用包 isOHOS 守卫跳过，更新源地址由应用市场托管，应用侧不管理"
+        ]
+      }
+    },
+    "autoUpdater.quitAndInstall": {
+      "plan": {
+        "cause": "quitAndInstall 可用但行为不同：展示系统更新对话框，不关闭窗口也不退出应用",
+        "steps": [
+          "保留 quitAndInstall 调用——鸿蒙上展示系统更新对话框，更新由应用商店管理",
+          "依赖调用后应用退出的后续逻辑改为不依赖退出：应用继续运行，系统在适当时机停止应用完成更新"
+        ]
+      },
+      "diffNote": "展示系统更新对话框，不关窗不退出应用；桌面平台为关闭窗口后安装并重启（需 v34.8.5）"
+    },
+    "autoUpdater.setFeedURL": {
+      "plan": {
+        "cause": "setFeedURL 可调用但不处理更新源——鸿蒙更新由应用市场管控",
+        "steps": [
+          "保留调用可兼容既有代码，更新源配置在鸿蒙上不生效",
+          "更新检测改用 autoUpdater.checkForUpdates 的应用市场检测，安装引导改用 quitAndInstall 的系统更新对话框"
+        ]
+      },
+      "diffNote": "可调用但不处理更新源（无效配置）；更新由应用市场管控（需 v34.8.5）"
+    },
+    "autoUpdater.update-downloaded": {
+      "plan": {
+        "cause": "更新由应用市场分发，应用内无下载环节，事件无派发时机",
+        "steps": [
+          "update-downloaded 监听删除或包 isOHOS 守卫跳过——事件无派发时机"
+        ]
+      }
+    },
+    "clipboard.readRTF": {
+      "plan": {
+        "cause": "鸿蒙剪贴板无 RTF 独立通道",
+        "steps": [
+          "readRTF 改 clipboard.readText() 或 readHTML()，富文本场景选 HTML 通道（均支持，需声明 READ_PASTEBOARD 权限）",
+          "调用点在平台守卫分支内的保持原样，OHOS 不进入"
+        ]
+      }
+    },
+    "nativeImage.createThumbnailFromPath": {
+      "plan": {
+        "cause": "鸿蒙无系统级快速缩略图通道",
+        "steps": [
+          "缩略图改 nativeImage.createFromPath(path) 读图后 resize({width, height}) 缩放到目标尺寸（均支持）",
+          "大图会全量解码，列表场景把生成结果落磁盘缓存复用",
+          "任意格式/大图的快速缩略图能力同步向 Electron-OH 提需求"
+        ]
+      }
+    },
+    "powerMonitor.getCurrentThermalState": {
+      "plan": {
+        "cause": "热状态查询无 JS 侧 API，经桥接层承接",
+        "steps": [
+          "getCurrentThermalState 改经 systemPreferences.callArkTSAsyncFunction 桥接 @ohos.thermal 查询接口",
+          "桥接参数达到 4 个及以上时退化为字符串传递，错误信息改由返回 JSON 的 code/message 字段表达",
+          "热状态原生查询能力同步向 Electron-OH 提需求"
+        ]
+      }
+    },
+    "powerMonitor.thermal-state-change": {
+      "plan": {
+        "cause": "热状态变化事件无 JS 侧 API，经桥接层承接",
+        "steps": [
+          "thermal-state-change 监听改经 systemPreferences.callArkTSAsyncFunction 桥接 @ohos.thermal 订阅接口",
+          "桥接参数达到 4 个及以上时退化为字符串传递，错误信息改由返回 JSON 的 code/message 字段表达",
+          "热状态事件原生能力同步向 Electron-OH 提需求"
+        ]
+      }
+    },
+    "screen.dipToScreenPoint": {
+      "plan": {
+        "cause": "DIP 与物理像素互转的 4 条 API 不支持，该能力框架可实现",
+        "steps": [
+          "dipToScreenPoint 调用点包 isOHOS 守卫跳过",
+          "坐标互转能力同步向 Electron-OH 提需求，由框架补齐该组 API 后恢复使用"
+        ]
+      }
+    },
+    "screen.dipToScreenRect": {
+      "plan": {
+        "cause": "DIP 与物理像素互转的 4 条 API 不支持，该能力框架可实现",
+        "steps": [
+          "dipToScreenRect 调用点包 isOHOS 守卫跳过",
+          "坐标互转能力同步向 Electron-OH 提需求，由框架补齐该组 API 后恢复使用"
+        ]
+      }
+    },
+    "screen.screenToDipPoint": {
+      "plan": {
+        "cause": "DIP 与物理像素互转的 4 条 API 不支持，该能力框架可实现",
+        "steps": [
+          "screenToDipPoint 调用点包 isOHOS 守卫跳过",
+          "坐标互转能力同步向 Electron-OH 提需求，由框架补齐该组 API 后恢复使用"
+        ]
+      }
+    },
+    "screen.screenToDipRect": {
+      "plan": {
+        "cause": "DIP 与物理像素互转的 4 条 API 不支持，该能力框架可实现",
+        "steps": [
+          "screenToDipRect 调用点包 isOHOS 守卫跳过",
+          "坐标互转能力同步向 Electron-OH 提需求，由框架补齐该组 API 后恢复使用"
+        ]
+      }
+    },
+    "shell.beep": {
+      "plan": {
+        "cause": "鸿蒙无系统蜂鸣 API",
+        "steps": [
+          "应用内提示音改用页面内 Web Audio 播放：AudioContext 播放打包内的音频资源，不依赖系统权限",
+          "系统级提醒改 new Notification({title, body}).show()，需申请通知权限"
+        ]
+      }
+    },
+    "shell.trashItem": {
+      "plan": {
+        "cause": "鸿蒙系统具备回收站能力，Electron-OH 兼容层未封装映射该能力",
+        "steps": [
+          "需求落地前的过渡：与产品确认可接受不可恢复删除后，改 fs.rm(path, {recursive: true, force: true}) 直接删除，UI 文案改为「直接删除」并补充二次确认",
+          "trashItem 映射系统回收站的能力同步向 Electron-OH 提需求"
+        ]
+      }
+    },
+    "systemPreferences.accent-color-changed": {
+      "plan": {
+        "cause": "鸿蒙无强调色变化事件，系统外观仅明暗两态",
+        "steps": [
+          "accent-color-changed 监听改为 nativeTheme.on('updated') 监听明暗主题切换",
+          "UI 配色降级为跟随明暗主题的两套固定色值"
+        ]
+      }
+    },
+    "systemPreferences.color-changed": {
+      "plan": {
+        "cause": "鸿蒙无系统颜色变化事件，系统外观仅明暗两态",
+        "steps": [
+          "color-changed 监听改为 nativeTheme.on('updated') 监听明暗主题切换",
+          "UI 配色降级为跟随明暗主题的两套固定色值"
+        ]
+      }
+    },
+    "systemPreferences.effectiveAppearance": {
+      "plan": {
+        "cause": "鸿蒙系统外观仅明暗两态，无高对比等细分",
+        "steps": [
+          "effectiveAppearance 读取改为 nativeTheme.shouldUseDarkColors 判断明暗"
+        ]
+      }
+    },
+    "systemPreferences.getEffectiveAppearance": {
+      "plan": {
+        "cause": "鸿蒙系统外观仅明暗两态，无高对比等细分",
+        "steps": [
+          "getEffectiveAppearance 调用改为 nativeTheme.shouldUseDarkColors 判断明暗"
+        ]
+      }
+    },
+    "systemPreferences.getUserDefault-Type-extends-keyof-UserDefaultTypes": {
+      "plan": {
+        "cause": "系统级键值存储为 macOS 专属能力，鸿蒙无系统级键值 API",
+        "steps": [
+          "调用点在平台守卫分支内的保持原样，OHOS 不进入",
+          "无守卫的读取沿用应用在 Windows 侧的配置实现；没有现成实现的再引入 electron-store 或 conf 纯 JS 库，用 store.get(key) 读配置"
+        ]
+      }
+    },
+    "systemPreferences.registerDefaults": {
+      "plan": {
+        "cause": "系统级键值存储为 macOS 专属能力，鸿蒙无系统级键值 API",
+        "steps": [
+          "调用点在平台守卫分支内的保持原样，OHOS 不进入",
+          "应用在 Windows 侧已有默认值预置实现的沿用该实现；没有现成实现的再引入 electron-store 库，在初始化参数里配置 defaults 对象，读取未设置的键时返回其默认值"
+        ]
+      }
+    },
+    "systemPreferences.removeUserDefault": {
+      "plan": {
+        "cause": "系统级键值存储为 macOS 专属能力，鸿蒙无系统级键值 API",
+        "steps": [
+          "调用点在平台守卫分支内的保持原样，OHOS 不进入",
+          "应用在 Windows 侧已有配置删除实现的沿用该实现；没有现成实现的再引入 electron-store 库，用 store.delete(key) 删配置"
+        ]
+      }
+    },
+    "systemPreferences.setUserDefault-Type-extends-keyof-UserDefaultTypes": {
+      "plan": {
+        "cause": "系统级键值存储为 macOS 专属能力，鸿蒙无系统级键值 API",
+        "steps": [
+          "调用点在平台守卫分支内的保持原样，OHOS 不进入",
+          "应用在 Windows 侧已有配置写入实现的沿用该实现；没有现成实现的再引入 electron-store 库，用 store.set(key, value) 写配置"
+        ]
+      }
+    },
+    "webFrame.findFrameByName": {
+      "plan": {
+        "cause": "webFrame 帧查找 API 不支持，WebFrameMain 模块支持面更全",
+        "steps": [
+          "findFrameByName 改用 WebFrameMain.fromId 按帧路由 id 定位（支持）",
+          "按名称定位的映射在创建 iframe 时自行记录 name 与 id 对应关系"
+        ]
+      }
+    },
+    "webFrame.findFrameByRoutingId": {
+      "plan": {
+        "cause": "webFrame 帧查找 API 不支持，WebFrameMain 模块支持面更全",
+        "steps": [
+          "findFrameByRoutingId 改用 WebFrameMain.fromId 按帧路由 id 定位（支持）"
+        ]
+      }
+    },
+    "webFrame.getFrameForSelector": {
+      "plan": {
+        "cause": "webFrame 帧查找 API 不支持，WebFrameMain 模块支持面更全",
+        "steps": [
+          "getFrameForSelector 改用 WebFrameMain.fromId 按帧路由 id 定位（支持）",
+          "按 CSS 选择器定位帧的映射在页面创建时自行记录选择器与帧 id 对应关系"
+        ]
+      }
+    },
+    "app.relaunch": {
+      "plan": {
+        "cause": "relaunch 可用但行为与 Windows 两段式不同，且要求应用处于前台",
+        "steps": [
+          "保留 relaunch 调用并补前台条件：显示态先 app.focus() 或主窗 win.focus()，隐藏态先 win.show() 再调",
+          "isOHOS 分支省略 relaunch 后续的手动 exit——鸿蒙的 relaunch 已含退出动作，重复退出会干扰重启"
+        ]
+      },
+      "diffNote": "需应用处于前台；鸿蒙调 relaunch 直接退出并重启，Windows 惯例需另调 exit"
+    },
+    "shell.openPath": {
+      "plan": {
+        "cause": "openPath 场景可用，限制在调用进程——仅主进程可用，渲染进程调用失效",
+        "steps": [
+          "渲染进程调用改 IPC 代理：渲染层 ipcRenderer.invoke('shell:open-path')，主进程 ipcMain.handle 内调 shell.openPath",
+          "返回的错误串经 IPC 透传回渲染层，据此判断打开成败",
+          "主进程内调用保持原样"
+        ]
+      },
+      "diffNote": "仅主进程可用，渲染进程调用失效"
+    },
+    "shell.showItemInFolder": {
+      "plan": {
+        "cause": "场景可用，限制在调用进程——仅主进程可用，渲染进程调用失效",
+        "steps": [
+          "渲染进程调用改 IPC 代理：渲染层 ipcRenderer.invoke('shell:show-in-folder')，主进程 handler 内调 shell.showItemInFolder",
+          "主进程内调用保持原样"
+        ]
+      },
+      "diffNote": "仅主进程可用，渲染进程调用失效"
+    },
+    "BrowserWindow.setContentBounds": {
+      "plan": {
+        "cause": "setContentBounds 单屏可用，多屏/扩展显示器场景失效",
+        "steps": [
+          "单屏场景 setContentBounds 保持原样",
+          "多屏场景创建窗口时经 windowInfo 的 displayId 指定目标屏，或改 win.setBounds() 设整窗边界后自行补偿内容区差值",
+          "多屏支持需求已在研，版本到位后多屏场景可直接使用本调用"
+        ]
+      },
+      "diffNote": "不支持扩展显示器，单屏正常"
+    },
+    "Tray.setToolTip": {
+      "plan": {
+        "cause": "setToolTip 可用，需设备 API 版本不低于 22",
+        "steps": [
+          "应用采用 API 22 及以上版本，setToolTip 可直接使用"
+        ]
+      },
+      "diffNote": "需设备 API 版本不低于 22，低版本不生效"
+    },
+    "BrowserWindow.isTabletMode": {
+      "plan": {
+        "cause": "设备形态感知在鸿蒙有真实场景，无平板模式查询 API，折叠姿态接口可直查",
+        "steps": [
+          "isTabletMode 查询改用 app.getFoldStatus() 直查设备折叠姿态（folded/expanded 等，需 v34.8.5），按姿态切换触控与桌面布局",
+          "姿态变化监听改用 app.on('fold-status-changed') 事件驱动布局刷新",
+          "调用点在平台守卫分支内的保持原样，OHOS 不进入"
+        ]
+      }
+    },
+    "Dock.bounce": {
+      "plan": {
+        "cause": "鸿蒙无 Dock 图标弹跳形态，用户注意力提醒有承接通道",
+        "steps": [
+          "Dock.bounce 调用点删除或包 isOHOS 守卫跳过",
+          "注意力提醒改系统 Notification.show()（需通知授权）或应用数字角标 setBadgeCount 承接"
+        ]
+      }
+    },
+    "BrowserWindow.setProgressBar": {
+      "plan": {
+        "cause": "快捷栏进度条自 API 26 起支持接入，Electron 侧未封装",
+        "steps": [
+          "setProgressBar 改经 systemPreferences.callArkTSAsyncFunction 桥接快捷栏进度条（设备 API 26 及以上）",
+          "快捷栏进度条的 Electron 封装同步向 Electron-OH 提需求"
+        ]
+      }
+    },
+    "BrowserWindow.setSkipTaskbar": {
+      "plan": {
+        "cause": "鸿蒙主窗口无法脱离任务栏，子窗口类型不占任务栏",
+        "steps": [
+          "setSkipTaskbar 调用点包 isOHOS 守卫跳过（主窗口场景）",
+          "如果确实需要辅助窗口不占任务栏，new BrowserWindow 时 windowInfo.type 用 subWindow，子窗不出现在任务栏"
+        ]
+      }
+    },
+    "BrowserWindow.showInactive": {
+      "plan": {
+        "cause": "鸿蒙无 showInactive 等价接口，setFocusable 组合可实现不抢焦点显示",
+        "steps": [
+          "showInactive 调用改为组合实现：先 win.setFocusable(false) 再 win.show()，显示完成后按需 win.setFocusable(true) 恢复（需 v34.8.5）",
+          "消息提醒类场景也可改系统 Notification（点击回应用内），按场景选用"
+        ]
+      }
+    },
+    "Tray.getBounds": {
+      "plan": {
+        "cause": "托盘图标屏幕坐标查询鸿蒙不支持，托盘 UI 由系统渲染",
+        "steps": [
+          "getBounds 调用点删除或包 isOHOS 守卫跳过",
+          "按调用点实际用途选替代：托盘点击恢复窗口在 tray.on('click') 回调直接 win.show()，无需图标坐标；其余坐标用途改应用内实现"
+        ]
+      }
+    },
+    "Tray.popUpContextMenu": {
+      "plan": {
+        "cause": "托盘菜单由系统管理弹出，菜单弹出由用户操作，应用侧无程序化弹出接口",
+        "steps": [
+          "popUpContextMenu 调用点删除或包 isOHOS 守卫跳过，菜单交给 setContextMenu 常驻菜单",
+          "程序化弹出托盘菜单鸿蒙无对应能力，有需要时向华为提需求"
+        ]
+      }
+    },
+    "Tray.right-click": {
+      "plan": {
+        "cause": "右键点击托盘图标的事件鸿蒙不支持，右键由系统呼出常驻菜单",
+        "steps": [
+          "right-click 监听删除或包 isOHOS 守卫跳过",
+          "右键事件能力同步向 Electron-OH 提需求"
+        ]
+      }
+    },
+    "app.select-client-certificate": {
+      "plan": {
+        "cause": "鸿蒙证书能力只能静态预配置，TLS 握手中无法动态选择客户端证书",
+        "steps": [
+          "select-client-certificate 监听删除或包 isOHOS 守卫跳过",
+          "客户端证书改静态预配置：连接发起前经 systemPreferences.callArkTSAsyncFunction 一次性设置证书路径与私钥密码，module.json5 声明 ohos.permission.ACCESS_CERT_MANAGER",
+          "握手期动态选证书的能力同步向 Electron-OH 提需求"
+        ]
+      }
+    },
+    "app.setClientCertRequestPasswordHandler": {
+      "plan": {
+        "cause": "鸿蒙证书能力只能静态预配置，握手中无法按需回调私钥密码",
+        "steps": [
+          "setClientCertRequestPasswordHandler 调用点包 isOHOS 守卫跳过",
+          "私钥密码改静态预配置：连接发起前一次性设置，链路与客户端证书的静态配置相同",
+          "握手期动态取密码的能力同步向 Electron-OH 提需求"
+        ]
+      }
+    },
+    "app.startAccessingSecurityScopedResource": {
+      "plan": {
+        "cause": "安全域书签为 macOS MAS 专用机制，鸿蒙无对应沙箱机制",
+        "steps": [
+          "调用点删除或包 isOHOS 守卫跳过，鸿蒙文件访问不经过安全域书签",
+          "用户文件访问改文件选择器选取，返回的 URI 自带临时访问授权（对标 Windows 处理）"
+        ]
+      }
+    },
+    "clipboard.clear": {
+      "plan": {
+        "cause": "鸿蒙无剪贴板清空 API，写入空串是留空记录而非无记录",
+        "steps": [
+          "剪贴板清空能力优先向 Electron-OH 提需求",
+          "clipboard.clear 调用点包 isOHOS 守卫跳过",
+          "过渡按场景评估：能接受剪贴板留一条空文本记录的改 clipboard.writeText('')，不能接受的跳过该功能"
+        ]
+      }
+    },
+    "nativeTheme.shouldUseHighContrastColors": {
+      "plan": {
+        "cause": "鸿蒙无系统级高对比度特性，无对应开关",
+        "steps": [
+          "shouldUseHighContrastColors 调用点包 isOHOS 守卫跳过",
+          "高对比度 UI 改应用自行控制：应用内设置项切换高对比度配色方案"
+        ]
+      }
+    },
+    "powerMonitor.getSystemIdleState": {
+      "plan": {
+        "cause": "系统级空闲状态查询鸿蒙无 API，应用内近似只能覆盖自身前台场景",
+        "steps": [
+          "getSystemIdleState 调用点包 isOHOS 守卫跳过",
+          "判断应用自身活跃的场景，用页面内 visibilitychange 与 blur 事件加计时器近似",
+          "系统空闲状态查询已向 Electron-OH 提需求，跟进落地版本"
+        ]
+      }
+    },
+    "powerMonitor.getSystemIdleTime": {
+      "plan": {
+        "cause": "系统级空闲时长查询鸿蒙无 API，应用内近似只能覆盖自身前台场景",
+        "steps": [
+          "getSystemIdleTime 调用点包 isOHOS 守卫跳过",
+          "判断应用自身活跃的场景，用页面内 visibilitychange 与 blur 事件加计时器近似",
+          "系统空闲时长查询已向 Electron-OH 提需求，跟进落地版本"
+        ]
+      }
+    },
+    "systemPreferences.canPromptTouchID": {
+      "plan": {
+        "cause": "鸿蒙生物识别接口与 TouchID 形态不同，无对标封装",
+        "steps": [
+          "canPromptTouchID 调用点包 isOHOS 守卫跳过",
+          "生物识别查询与认证的对标接口同步向 Electron-OH 提需求"
+        ]
+      }
+    },
+    "systemPreferences.getAccentColor": {
+      "plan": {
+        "cause": "鸿蒙不向应用暴露系统强调色值",
+        "steps": [
+          "getAccentColor 调用点包 isOHOS 守卫跳过",
+          "强调色改应用自定：参考鸿蒙 UX 设计规范的系统配色取值，应用内置色表",
+          "系统色值读取能力有需要时向华为提需求"
+        ]
+      }
+    },
+    "systemPreferences.getColor": {
+      "plan": {
+        "cause": "鸿蒙不向应用暴露系统语义色值",
+        "steps": [
+          "getColor 调用点包 isOHOS 守卫跳过",
+          "语义色改应用自定：参考鸿蒙 UX 设计规范的系统配色取值，应用内置色表",
+          "系统色值读取能力有需要时向华为提需求"
+        ]
+      }
+    },
+    "systemPreferences.promptTouchID": {
+      "plan": {
+        "cause": "鸿蒙生物识别接口与 TouchID 形态不同，无对标封装",
+        "steps": [
+          "promptTouchID 调用点包 isOHOS 守卫跳过",
+          "生物识别查询与认证的对标接口同步向 Electron-OH 提需求"
+        ]
+      }
+    },
+    "webContents.plugin-crashed": {
+      "plan": {
+        "cause": "插件子进程崩溃事件鸿蒙不支持，渲染进程事件不覆盖插件进程",
+        "steps": [
+          "plugin-crashed 监听改为 app.on('child-process-gone') 按 details.type 过滤插件类子进程，崩溃提示与重载逻辑接到新事件"
+        ]
+      }
+    },
+    "Tray.click": {
+      "plan": {
+        "cause": "click 事件鸿蒙可用，回调 bounds 参数定位能力受限",
+        "steps": [
+          "保留 click 监听，回调按应用原有逻辑执行",
+          "回调内不依赖 bounds 参数做窗口定位，按实际用途改应用内定位或直接 win.show()"
+        ]
+      },
+      "diffNote": "事件可用；回调 bounds 参数定位能力受限"
+    }
+  }
+}