Manifest 快捷方式（shortcuts）

一句话： shortcuts 是快捷操作链接数组，当用户长按（Android）或右键单击（Windows、macOS）已安装 PWA 图标时，系统上下文菜单会显示这些条目。每个快捷方式直接打开特定的域内 URL，绕过 start_url——非常适合“新建”、“收件箱”、“仪表盘”等高频操作。

语法

{
  "shortcuts": [
    {
      "name": "新建发票",
      "short_name": "新建",
      "description": "创建新发票",
      "url": "/app/invoice/new",
      "icons": [
        {
          "src": "/icons/shortcut-new.png",
          "sizes": "96x96",
          "type": "image/png"
        }
      ]
    },
    {
      "name": "仪表盘",
      "url": "/app/dashboard"
    }
  ]
}

每个快捷方式对象：

属性	是否必填	说明
`name`	是	上下文菜单中显示的标签。
`short_name`	否	空间受限时的简短标签。
`description`	否	辅助技术提示；通常不在菜单中可见。
`url`	是	要打开的域内 URL，必须位于 `scope` 之内。
`icons`	否	图标对象数组（格式与清单 `icons` 相同）。

Scope 约束

shortcuts 中每个 url 都必须位于清单 scope 之内。域外 URL 会被浏览器静默忽略或跳过。请始终对照 scope 验证每个快捷方式 URL。

平台支持与数量限制

平台	显示位置	最多显示数量
Android（Chrome）	长按主屏幕图标	4
Windows（Edge）	右键任务栏/开始菜单	最多 10，浏览器可能有上限
macOS（Chrome/Edge）	右键 Dock 图标	最多 10
iOS（Safari）	不支持	—

浏览器会静默截断超出平台上限的 shortcuts 数组。请将最重要的快捷方式放在前面。

快捷方式图标

快捷方式图标是可选的，但能提升在系统菜单中的辨识度。推荐使用 96 × 96 px PNG。maskable/any 用途规则与清单级图标相同，但平台通常以小尺寸（16–32 px）显示快捷方式图标，因此应保持图标简洁清晰。

设计建议

即使平台支持更多，也将快捷方式限制在 3–4 个——选项过多会削弱其价值。
使用面向动作的名称：“新建发票”、“打开相机”、“今日任务”。
确保每个快捷方式 URL 直接指向功能页面，而非重定向的落地页。
name 应足够简短，在最窄平台上不被截断（约 30 个字符以内）。

实践清单

每个快捷方式的 url 均位于清单 scope 之内。
最重要的快捷方式排在最前面（平台会截断列表）。
快捷方式 name 面向操作且不超过 30 个字符。
若提供了 icons，尺寸至少为 96 × 96 px。
已在 Android（长按）与 Windows/macOS（右键单击）上测试快捷方式菜单。
每个快捷方式 URL 无重定向，直接指向目标功能。