7.1 与操作系统深度集成：托盘、全局快捷键与后台服务

7.1 与操作系统深度集成：托盘、全局快捷键与后台服务

本节摘要：深度系统集成让应用嵌进操作系统的日常动线：开机自启与单实例、文件关联让双击文件直达应用、自定义协议让网页唤起桌面端、通知权限与电源事件补全桌面感。本节讲这几项集成的实现模式、注册表与权限的平台差异、注销与清理的纪律，并用一个"网页唤起客户端并直达详情页"的案例把集成串成动线。

集成的本质：注册与被找到

3.3 与 3.4 节已经装上了托盘与全局快捷键，本节补齐剩下的拼图。系统集成的共同本质是在操作系统那里登记信息，让系统在特定时刻找到你：开机自启是向系统的启动项登记；文件关联是向系统的文件类型表登记"这类文件归我"；自定义协议是向系统登记"这种地址头唤起我"。登记就有对应的注销，集成项的生命周期管理（装的时候注册、卸载的时候清理）是工程纪律所在。

开机自启。Electron 提供 API 直接操作系统启动项，用户在设置页勾选即可生效，实现要点是状态记忆与平台差异抹平：

// 主进程：开机自启的读写
const { app } = require('electron');

function setAutoLaunch(enable) {
  app.setLoginItemSettings({
    openAtLogin: enable,
    // Windows 下带启动参数，配合单实例锁处理"自启时静默启动"
    args: ['--hidden']
  });
}

function isAutoLaunchEnabled() {
  return app.getLoginItemSettings().openAtLogin;
}

// 启动时检查参数：开机自启的这次启动不要弹窗抢焦点
const startHidden = process.argv.includes('--hidden');
​

--hidden 参数的配合设计很实用：用户要的是"开机后台待命、托盘可见"，而不是"每次开机弹个大窗口"。与 3.3 节的单实例锁、托盘驻守组合，就是常驻类应用的完整形态。

文件关联。让系统把某类扩展名的双击事件交给应用：打包配置里声明文件类型（扩展名、描述、图标），应用侧在启动时读入待打开的文件路径。两个平台差异点要心里有数：Windows 的关联在安装时写入、卸载时清除（交给安装器框架办）；macOS 的关联声明在应用包信息里，系统按声明路由。启动参数里拿到路径后交给业务层：

// 主进程：处理"双击文件打开应用"（Windows/Linux 走启动参数）
const { app } = require('electron');

app.on('open-file', (event, filePath) => {   // macOS 的文件打开事件
  event.preventDefault();
  pendingFile = filePath;                    // 窗口未就绪先存，就绪后再打开
});

app.whenReady().then(() => {
  const win = createMainWindow();
  const argvFile = findFileFromArgv(process.argv); // Windows/Linux 从参数取
  const target = pendingFile ?? argvFile;
  if (target) openDocument(win, target);
});
​

自定义协议。给应用注册一个专属地址头，网页里的"打开客户端"按钮、运营物料里的链接，都能唤起桌面端：

// 主进程：注册自定义协议的要点示意
const { app } = require('electron');

app.whenReady().then(() => {
  // 应用唯一前缀（如 myapp://order/detail/12345）
  // 唤起时以"第二个实例事件"送达（配合单实例锁，见 3.3 节）
  // 参数一律严格校验：外部可以构造任意协议链接进来
  app.on('second-instance', (_e, argv) => {
    const link = argv.find(a => a.startsWith('myapp://'));
    if (link) handleProtocolLink(link);   // handleProtocolLink 内做格式白名单校验
  });
});
​

第三个要点是安全重点：协议入口是公开的攻击面——任何人都能构造协议链接唤起你的应用并夹带参数。第四章的原则在这里同样适用：入口参数严格校验（只认白名单格式），敏感动作要求二次确认，绝不把协议参数直接当代码或路径执行。

图：系统集成动线全景

案例：网页唤起客户端直达详情页

背景：一个企业采购系统的网页版与桌面版并存，产品要求：网页里的"在客户端打开此单据"按钮，点了以后唤起桌面客户端并直接跳到对应单据页，且已登录则免二次登录。

操作：动线分三段。协议注册段：客户端安装时注册专属协议，链接形如应用名加单据类型加单据号。唤起段：网页按钮生成协议链接，系统唤起客户端；已运行的客户端经单实例锁的 second-instance 事件收到参数（3.3 节的模式），未运行则作为启动参数进入。处理段：入口层统一校验参数（单据类型枚举、单据号格式），合法则经 IPC 通知界面层路由到目标页，并复用本地登录态。

结果：用户从"点按钮到看见单据"平均两秒多，免去了复制单据号、切换应用、粘贴搜索的旧路径。上线后桌面版的日启动量里，协议唤起来源占比迅速过半。

解读：这个动线的价值在于用系统集成把跨端跳转的摩擦力压到一次点击。安全细节也别漏：单据号校验失败时静默打开首页并提示格式错误，而不是带着原始参数往业务层闯——入口层的敌料假设（第四章）在集成入口同样生效。变式：如果要支持"唤起后执行敏感动作"（比如直接审批），在客户端内加二次确认，协议链接只携带"意图"，不携带"授权"。

本节要点回顾

• 集成本质：向系统登记信息、在特定时刻被找到，登记必配注销；
• 自启设计：hidden 参数静默启动，与单实例锁、托盘组成常驻形态；
• 文件关联：Windows 走安装器注册、macOS 走包声明，启动参数与 open-file 事件双通道收文件；
• 自定义协议：跨端唤起的正道，但入口是公开攻击面，参数按敌料校验；
• 动线思维：集成的价值在把多步操作压成一次点击，安全边界不因便利而放松。

下一节处理"断网时依然有用"：离线能力与本地数据库的工程方案。