shortcuts字段必须是顶层非空数组，每项须含name和url（相对路径），且url需符合scope范围；Android要求显式配置icons，否则显示空白。

manifest.json 里 shortcuts 字段必须是数组，不是对象

很多人写 shortcuts 时直接套用 icons 的写法，误以为可以写成单个对象或键值对，结果 PWA 安装后快捷方式完全不显示。浏览器只认数组，哪怕只有一个入口也得包在 [] 里。

• shortcuts 必须是顶层字段，且值为非空数组
• 每个数组项必须包含 name 和 url，缺一不可（url 必须是相对于 manifest 文件路径的相对 URL，不能是绝对 URL 或带协议）
• name 是用户看到的快捷方式文字，长度建议 ≤12 字符，过长可能被截断
• Chrome/Edge 目前只支持最多 4 个快捷方式，超出部分会被忽略

url 路径必须可访问且与 scope 兼容

如果 manifest.json 中设置了 scope（比如 "scope": "/app/"），那所有 shortcuts.url 的路径都必须落在该 scope 内，否则点击快捷方式会跳转失败或回退到首页。

• 错误示例："url": "/dashboard"，但 scope 是 "/app/" → 实际等效路径是 /app/dashboard，若该路径无对应页面，就 404
• 正确写法："url": "dashboard"（相对路径）或 "url": "./dashboard"，确保服务端能响应 /app/dashboard
• 推荐统一用不带开头斜杠的相对路径，避免 scope 混淆

icon 字段不是必需的，但没图标会导致 Android 上快捷方式无图

Chrome 桌面版会自动 fallback 到 manifest 根级的 icons，但 Android Chrome（尤其是 Android 12+）要求每个 shortcut 显式提供 icons 数组，否则快捷方式显示为空白方块或默认图标。

Article To Html

文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。

下载

• 每个 shortcut 可配独立 icons，格式同根级 icons：数组，每项含 src、sizes、type
• src 必须是相对于 manifest 文件的路径（如 "icons/icon-dashboard-192.png"），不能是 data URL 或绝对 URL
• Android 推荐至少提供一个 192x192 PNG，type: "image/png"
• 不配 icons 不报错，但用户体验断裂——这点常被忽略

调试快捷方式是否生效：看 chrome://apps 页面和安装日志

manifest 修改后不会自动刷新已安装的 PWA，必须卸载重装；而且 Chrome 不会在控制台报 shortcuts 解析错误，只能靠验证入口是否存在。

立即学习“前端免费学习笔记（深入）”；

• 安装前先用 Web Dev Manifest Checker 验证 JSON 结构和字段合法性
• 安装后打开 chrome://apps（桌面）或长按桌面 PWA 图标（Android），看是否出现子菜单或快捷方式弹出层
• 如果没出现，打开 DevTools → Application → Manifest，检查右侧 “Shortcuts” 区域是否解析出条目；若为空，说明 JSON 格式或路径有硬伤
• 常见静默失败原因：JSON 末尾多逗号、url 路径 404、shortcuts 写成了字符串或对象、service worker 未更新导致旧 manifest 缓存

PWA 快捷方式的坑不在语法多复杂，而在路径相对性、scope 约束和平台差异这些隐性规则上——尤其 Android 对 icons 的强制要求，很容易在桌面测试通过后上线才发现移动端失效。