Electron中shell.openExternal()的logUsage参数何时设true/false？

Electron 24给shell.openExternal()新增的logUsage参数，本质是在Windows系统下给ShellExecuteEx传递SEE_MASK_FLAG_LOG_USAGE标志，作用是让系统记录该启动操作，用于统计用户常用程序、优化系统行为分析。

设为logUsage: true的场景 #

这类场景的核心是用户主动、明确发起的外部资源/程序启动请求：

• 用户操作打开自身数据中的URL（比如从应用的用户数据列表里点击打开一个网页链接）
• 用户主动选择打开本地外部文件（比如在应用里选择打开自己电脑上的文档、图片）
• 用户触发的第三方程序启动操作（比如点击应用里的“打开微信”按钮）

设为logUsage: false的场景 #

这类场景是操作属于应用自身功能延伸，非用户主动发起的独立外部请求：

• 你提到的「用户操作打开应用内部帮助文件」：哪怕帮助文件是PDF/HTML这类外部格式，但它属于应用配套的内置资源，是用户使用应用功能的一部分，而非主动去启动外部程序/资源，应该设为false，避免干扰系统对用户真实常用程序的统计。
• 应用后台自动触发的外部操作：比如应用启动时自动打开的服务页面、定时更新时自动弹出的更新说明页
• 应用流程附带的自动操作：比如批量导出文件后自动打开导出目录、表单提交成功后自动打开的反馈页（非用户主动点击）
• 内部功能依赖的外部调用：比如应用内置预览功能调用系统阅读器打开缓存的预览文件、编辑器调用外部工具处理文件
• 测试/调试类自动操作：应用内部测试流程中自动触发的外部URL或程序打开

判断原则 #

简单来说：如果这个操作是用户自己想要打开某个外部内容/程序的主动行为，就设true；如果是为了完成应用自身功能而触发的“附带性”外部调用，就设false。

内容的提问来源于stack exchange，提问作者xmedeko