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 内，否则点击快捷方式会跳转失败或回退到首页。
Article To Html
下载
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
- 错误示例：
"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 数组，否则快捷方式显示为空白方块或默认图标。
- 每个 shortcut 可配独立
icons，格式同根级 icons：数组，每项含src、sizes、type -
src必须是相对于 manifest 文件的路径（如"icons/icon-dashboard-192.png"），不能是 data URL 或绝对 URL - Android 推荐至少提供一个
192x192PNG，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 缓存
icons 的强制要求，很容易在桌面测试通过后上线才发现移动端失效。前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
