name 和 short_name 都必须设置,name 用于完整场景如安装提示和应用列表,建议20字以内;short_name 用于图标标签,建议≤12字符,需简短可读、语义一致。

name 和 short_name 都要设,不能只写一个。浏览器在空间宽裕的地方用 name,在图标下方、主屏幕、任务栏等窄位置优先显示 short_name;如果只提供 name,很多系统会强行截断,出现“我的PWA应…”这类异常显示。
name 用于完整标识,适合安装提示和应用列表
name 是应用的正式全称,应准确反映产品定位,长度建议控制在 20 字以内。它出现在 Chrome 的“添加到主屏幕”弹窗、Windows 的开始菜单、macOS 的 Launchpad 等完整上下文中。
- 避免含特殊符号或版本号,比如“工具v2.1”、“MyApp(Beta)”——这些在系统级界面中容易被过滤或显示异常
- 不要用营销话术,如“超好用!一键搞定!”——系统不会渲染 HTML 或格式,纯文本展示
- 示例合理写法:"RemBG 在线抠图"、"豆瓣图书搜索"
short_name 是图标标签,必须简短、可读、无歧义
short_name 是用户每天在桌面、任务栏、Android Launcher 上看到的名字,长度建议 ≤ 12 个字符(中文约 4–6 字),且需确保在小尺寸图标下仍能清晰识别。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
- 不能只是缩写字母组合,比如“RMBG”或“DBTS”,普通用户看不懂
- 避免和系统已有应用重名,例如直接叫“地图”“天气”可能被误认为系统自带应用
- 推荐用核心功能词+品牌词组合,如:"抠图助手"、"书查"、"PWA 工具箱"
两者需语义一致,不可互相矛盾
name 和 short_name 不是随意起的两个名字,而是同一应用在不同场景下的自然映射。用户从“添加到主屏幕”看到 name,点开图标后看到 short_name,应当产生连贯认知。
- 错误示范:"AI 智能证件照生成平台" + "小剪刀" —— 语义断裂,用户无法建立关联
- 正确示范:"RemBG 在线抠图" → "在线抠图",或 "豆瓣图书搜索" → "书查"
- 英文项目注意本地化:name 可用中文,short_name 若面向国际用户,建议用简洁英文词,如 "Maps" for "Google Maps"
验证是否生效的小技巧
改完 manifest.json 后,别只看代码——真机测试最可靠:
- Chrome on Android:长按网页地址栏右侧“…”,选“添加到主屏幕”,观察弹窗里显示的是哪个名字
- Windows 11:用 Edge 打开页面 → 地址栏右端“应用安装按钮”→ 点击后进“开始菜单”,看磁贴文字
- macOS Safari:分享 → “添加到主屏幕”,查看 Dock 图标下方标签
- 清缓存再测:浏览器有时会缓存旧 manifest,修改后硬刷新(Ctrl+Shift+R)或禁用缓存调试










