使用方法
- 在 “名称” 与 “简称” 中输入名称，然后输入应用的 “起始网址” 与 “作用域”。
- 选择 “显示方式”，并以十六进制颜色填写 “背景颜色” 与 “主题颜色”。
- 在 “图标” 下每行写一个图标：地址，然后是尺寸、类型和用途，以竖线分隔。
- 将 manifest.webmanifest 下的文本保存为文件，并修正 “可安装性检查” 中列出的每条警告。
各成员的含义
清单是一个 JSON 文件，其成员在 W3C《网页应用清单》（第1节）中有所描述。只写入您填写的成员，空栏位会使对应成员被省略。显示方式决定浏览器如何显示应用；若浏览器不支持某种方式，它会沿此顺序改用下一种（第6节）：全屏、独立窗口、极简界面、浏览器。
起始网址若与页面不在同一来源，会被忽略，因为规范要求同源。作用域只有在包含起始网址时才会被使用；否则，浏览器会使用由起始网址去掉文件名、查询和片段后得到的作用域。
警告检查什么
MDN 列出了基于 Chromium 的浏览器在提供安装网页应用之前所需的成员：名称或简称，包含192像素与512像素图标的图标，起始网址，以及显示方式。它还说明，网站必须通过 https 提供，或来自 localhost，并且不要求服务工作线程。在桌面端，Firefox 不会根据清单文件安装网页应用。
本工具检查以上成员与作用域规则。它不测试图标文件、HTTPS 地址或页面上的链接，这些需要您自己确认。
默认值
使用页面打开时的默认值，清单包含以下成员。检查没有任何警告，因为名称、起始网址和两种图标尺寸都已具备。
| 成员 | 数值 |
|---|---|
| name, short_name | 笔记, 笔记 |
| start_url, scope | /, / |
| display | standalone |
| background_color, theme_color | #ffffff, #1f6feb |
| icons | 192x192 与512x512 的 PNG 文件；512图标的用途为 any maskable |
常见问题
清单文件应保存在哪里？
保存在网站根目录，或应用所在的文件夹中，并命名为 manifest.webmanifest。然后用 rel 为 manifest 的 link 元素，从应用的每个页面链接它，正如 MDN 所述。
安装应用是否需要服务工作线程？
不需要。MDN 说明，服务工作线程并非 PWA 可安装的必要条件，尽管许多应用用它来支持离线使用。网站仍必须通过 https 提供，或来自 localhost。
需要哪些图标尺寸？
MDN 为基于 Chromium 的浏览器列出192像素与512像素的图标。尺寸写作 宽x高；一个文件含有多个尺寸时，以空格分隔。SVG 文件的尺寸可以写 any。
简称与名称有什么区别？
名称是应用的完整名称。简称用于空间不足之处，例如主屏幕上图标下方的标签。两者至少填写一个；若两者都为空，本工具会发出警告。
为什么工具会就作用域发出警告？
只有当作用域包含起始网址时才会被使用（W3C 第1节）。若起始网址在作用域之外，浏览器会忽略该作用域，改用其默认作用域，因此应用可能会在您所想的范围之外打开。
资料来源
- W3C：网页应用清单（工作草案，2026年11月6日）第1、2、6节（英文）
- MDN：Making PWAs installable（英文）
- MDN：web app manifest 的 display 成员（英文）
- MDN：web app manifest 的 icons 成员（英文）
数据和文字最近核对于2026年11月10日星期二。