20 KiB
MOBILE-ECOSYSTEM — 移动端生态入口设计参考
任务: T-125 移动端生态入口设计参考 角色: UI-Designer-Agent 日期: 2026-08-14 输入依据:
competitor-analysis/pixelbeads-nav-crawl.md(§2.2 移动端分组抽屉实测:主导航 9 项 + 主题 2 项 + 工具 6 项 + 指南 2 项;§1.2 桌面第 8/9 项 = 客户端 /zh/apps + 帮助 /zh/help;§3.1 页脚 apps×3 子页 Chrome/Android/iOS)docs/NAV-ALIGNMENT.md(§3.2 移动端分组抽屉设计、§4 优先级、§5 风险——含「工具/指南分组暂不参考泛化工具页」决策)docs/DESIGN.md(设计令牌:色彩/字体/间距/圆角/触控目标)docs/PWA-PLAN.md(T-105:manifest / SW / 安装提示 deferredPrompt / P0–P3 拆解)- 我方源码实读:
src/components/Nav.tsx(首页导航)、src/components/SubNav.tsx(子页导航)、src/App.tsx(mobile-cta)、src/i18n/messages/{zh-CN,en}.ts(nav.* keys)- 看板:
D:\拼豆\taskboard\taskboard.js(T-125 已认领;T-116 apps 落地页爬取开发中未产出,gap-crawl.md 不存在)
0. 结论速览
| 维度 | 结论 |
|---|---|
| 竞品生态入口 | 竞品有 3 个生态入口:①导航第 8 项「客户端」/zh/apps(Chrome 扩展 + Android + iOS 三端下载页)②帮助中心 /zh/help(分工具子页)③移动端「工具/指南」分组(7 个泛化工具页)。apps 是独立导航项 + 页脚三子页,帮助是导航项 + 单页中心 |
| 我方定位 | 纯 Web 无客户端产品 → apps 页明确暂缓(沿用 NAV-ALIGNMENT「不做」决策);生态入口聚焦 PWA 安装提示 + 帮助中心入口 + 分享入口 |
| 移动端结构建议 | 复用现有 SubNav 8 入口(首页/生成器/chibi/色号表/showcase/图纸库/帮助),不引入竞品「工具/指南」泛化分组;抽屉底部新增「生态区」:PWA 安装横幅 + 分享 + 帮助(可折叠进分组标题下) |
| P0 | 移动端 PWA 安装提示横幅(依赖 PWA-PLAN P3-1 的 deferredPrompt 链路) |
| P1 | 帮助中心入口强化(SubNav 已含 help,补抽屉内 FAQ 直达分类)+ 分享入口(复制链接/分享图纸) |
| P2 | 生成结果页内嵌「安装到主屏」图文引导(iOS 无 prompt API 场景)、离线 banner |
核心原则:竞品 apps 三端是"有产品才有的入口",我方无客户端 → 不空建下载页。我方生态入口 = PWA(把现有 Web 变"可安装应用")+ 帮助中心(服务已有用户)+ 分享(社交传播)。全部复用现有页面与令牌,零新路由、零新页面。
1. 竞品生态入口分析(apps 页 / 帮助页在移动端的呈现)
数据源:
pixelbeads-nav-crawl.md(Spider 实测,Playwright 验证)。T-116(apps 四落地页抓取)开发中,本节基于导航结构层数据;落地页内容细节留待 T-116 产出后补充。
1.1 「客户端」apps 页(/zh/apps)
| 维度 | 实测值 | 移动端呈现 |
|---|---|---|
| 入口层级 | 桌面导航第 8 项「客户端」+ 移动端抽屉主导航项 | 抽屉内为普通列表项(无图标无角标),与首页/生成器平级 |
| 落地页 | /zh/apps 总入口 + 页脚三子页:/apps/chrome-extension、/apps/android、/apps/ios |
页脚「应用与支持」栏 4 链接(apps + 3 子页) |
| 产品形态 | Chrome 扩展 + Android 应用 + iOS 应用(三端原生) | — |
| 与 Web 关系 | 原生能力补充(本地文件、独立窗口、离线),与 Web 生成器同品牌 | — |
移动端呈现要点:
- apps 在抽屉中是普通列表项,与主导航 9 项混排,无"生态/应用"专组——竞品把客户端当作与生成器并列的一级能力入口。
- 移动端抽屉另有「工具」「指南」两组(§2.2),与 apps 分开:工具组 = 泛化工具页(像素画编辑器/Minecraft 指南等 7 个 sitemap 外页面),指南组 = 教程页。
1.2 帮助中心(/zh/help)
| 维度 | 实测值 |
|---|---|
| 入口层级 | 桌面导航第 9 项「帮助」+ 移动端抽屉主导航项 + 页脚「应用与支持」栏 |
| 页面形态 | 帮助中心单页,含分工具子页结构(生成器/像素画等各工具独立 FAQ) |
| 多语言 | 全部 7 语言均建 /help(语言前缀矩阵全 ✅) |
| 移动端 | 抽屉内普通列表项,无折叠、无描述 |
1.3 竞品移动端抽屉完整结构回顾(nav-crawl §2.2)
[H2] 拼豆艺术 + 副标题「网站导航、拼豆工具、指南和语言选项。」
主导航 9 项:首页 / 生成器 / 创作 / 像素画 / 图纸库 / 展示 / 客户端 / 帮助
[H3] 主题拼豆:圣诞 + 宝可梦(带描述)
[H3] 工具:拼豆图纸工具 / 像素画编辑器 / 拼豆豆生成工具 / 照片转像素 / Minecraft 指南 / r/place 工具
[H3] 指南:拼豆完全指南 / Hama 拼豆
[语言] 简体中文(复用语言下拉)
1.4 竞品生态策略提炼(可借鉴 / 不可借鉴)
| 策略 | 借鉴价值 | 判断 |
|---|---|---|
| 客户端作为一级导航项 | 我方无客户端 → 不借鉴(NAV-ALIGNMENT 已定「不做」) | |
| 帮助中心独立导航项 + 页脚常驻 | ✅ 借鉴:帮助是低成本高信任入口,我方 SubNav 已含 help |
|
| 「工具/指南」泛化分组 | ❌ 不借鉴:7 个泛化工具页偏离核心拼豆定位,NAV-ALIGNMENT §1 已明确排除 | |
| 主题分组(按节日/IP) | ✅ 借鉴(已在 NAV-ALIGNMENT §3.2 落地为 chibi 分类深链) | |
| 移动端抽屉分组标题 + 描述 | ✅ 借鉴:分组 H3 + 一行描述提升信息架构可读性 |
2. 我方移动端生态入口现状与差距
2.1 当前移动端结构(源码实读)
| 载体 | 入口 | 说明 |
|---|---|---|
Nav.tsx(首页) |
图片转拼豆 #workspace / AI拼豆专区 /chibi(PRO) / 色号表 /color-chart |
首页顶部导航,语言切换 + 代理合作 + 状态徽标 |
SubNav.tsx(子页) |
首页 / / chibi /chibi / showcase /showcase / library /library / help /help |
showcase/library/help 共用子页导航 |
App.tsx |
mobile-cta 购买/兑换固定底栏 |
移动端变现入口 |
| 路由全集 | / /chibi /color-chart /showcase /library /help |
6 路由 |
任务口径「首页/生成器/chibi/色号表/showcase/图纸库/help」= 桌面 Nav 3 项 + SubNav 5 项的并集(生成器=#workspace,图纸库=/library)。
2.2 差距矩阵(vs 竞品 §1)
| 生态能力 | 竞品 | 我方 | 差距 |
|---|---|---|---|
| 客户端下载 | Chrome/Android/iOS 三端 | 无客户端 | 不补齐(无产品,apps 页暂缓) |
| PWA/安装 | 纯 Web(manifest 仅 4 字段,无安装引导) | PWA-PLAN 已设计完整 manifest+SW+安装提示(T-105 验收通过) | 我方反而领先:竞品无自定义安装引导,我方 PWA-PLAN §5 设计了温和引导 |
| 帮助中心 | 导航项 + 分工具子页 | SubNav 已含 /help(T-106 验收通过,FAQ 8 分类) |
已基本对齐;缺移动端抽屉内直达分类 |
| 分享 | — | share-codec.ts 分享码(可解码渲染单张图纸) |
已有能力无入口:缺移动端分享 UI |
| 泛化工具分组 | 7 页 | 无 | 不补齐(定位偏离) |
3. 我方移动端生态入口设计方案
3.1 总原则
- apps 页暂缓:无客户端产品则不做下载页。未来若出 PWA/小程序(PWA-PLAN 已具备),届时再考虑"安装引导页"形态,不叫 apps。
- 生态入口 = 3 件事:PWA 安装提示(把 Web 变应用)+ 帮助中心入口(服务已有用户)+ 分享入口(社交传播)。
- 零新路由零新页面:全部入口复用现有页面/组件/令牌,只加 UI 层入口与交互。
3.2 移动端抽屉结构设计(升级版,对比 NAV-ALIGNMENT §3.2)
NAV-ALIGNMENT 已定义 P0 抽屉 = 主导航 + 主题拼豆 + 工具组(P1 开放)。本设计在此基础上追加生态区,不推翻既有结构。
[☰] PERLER LAB [中文|EN]
┌──────────────── 抽屉(右侧滑入)──────────────────┐
│ PERLER LAB │
│ 网站导航、AI 生成、工具和安装选项。 │
│ │
│ [H3] 主导航 │
│ ├ 首页 / │
│ ├ 图片转拼豆 /#workspace │
│ └ AI拼豆专区 ◈PRO /chibi │
│ [H3] 主题拼豆(AI 分类快速进入) │
│ ├ 宠物世界 /chibi?cat=pet │
│ ├ 人物肖像 /chibi?cat=people │
│ ├ 风景美图 /chibi?cat=landscape │
│ └ 美食探店 /chibi?cat=food │
│ [H3] 工具 │
│ ├ 色号表 /color-chart │
│ ├ 作品展示 /showcase │
│ ├ 图纸库 /library │
│ └ 帮助 /help │
│ ──────────────────────── │
│ [生态区](分隔线下方,卡片容器) │
│ 📱 安装到主屏 / 添加到主屏幕 ← PWA 安装入口 │
│ ↗ 分享 PERLER LAB ← 分享入口 │
│ ? 帮助中心 /help ← 帮助入口(显式) │
│ ──────────────────────── │
│ [代理合作 →](复用 AgencyModal) │
└───────────────────────────────────────────────────┘
设计说明:
- 主结构不变:主导航 + 主题 + 工具三分组沿用 NAV-ALIGNMENT §3.2 与竞品分组模式(分组 H3 + 描述)。
- 生态区独立成卡:不与导航项混排(吸取竞品 apps 与主导航混排的缺点),用分隔线 + 浅底卡片
--bg-subtle区分——生态入口是"增值项",不应抢占导航主视觉。 - 帮助双入口:工具组「帮助」= 位置入口(与竞品/桌面一致);生态区帮助 = 功能入口(直达 FAQ)。避免歧义时只在生态区放一次,工具组可隐藏——推荐只在工具组保留(SubNav 已有一致入口),生态区帮助作为移动端兜底副本,视觉弱化(icon 行)。
- 安装入口两态(对应 PWA-PLAN §5):
- 未安装可安装(
beforeinstallprompt已捕获)→ 「📱 安装到主屏」(Chrome/Android) - 不可安装(iOS Safari)→ 「? 添加到主屏幕」图文指引行(
navigator.standalone判断) - 已安装(
display-mode: standalone或appinstalled)→ 隐藏该行
- 未安装可安装(
- 分享入口:Web Share API(
navigator.share)优先,fallback 复制链接 + toast「链接已复制」。
3.3 PWA 安装提示入口(重点,替代 apps 页)
我方无客户端,但 PWA-PLAN(T-105 验收通过)已给出完整安装链路。本入口把它落到移动端 UI。
| 形态 | 触发 | 内容 | 依赖 |
|---|---|---|---|
| 抽屉内安装行 | 打开抽屉 | icon + 「安装到主屏」+ 短说明,点击 deferredPrompt.prompt() |
PWA-PLAN P3-1(beforeinstallprompt 捕获) |
| 底部迷你横幅(可选 P1) | 完成一次完整流程(下载/生成图纸后) | 「安装到主屏,离线也能看图纸 [稍后] [安装]」 | 同上 + localStorage dismissed 记录 |
| iOS 图文引导(P2) | iOS 抽屉安装行点击 | 弹层图文:分享按钮 → 添加到主屏幕 | navigator.standalone === false |
设计约束:
- 不拦截首屏、不弹窗打扰(PWA-PLAN §5 原则)——只做抽屉入口 + 低频迷你横幅。
- 已安装态自动隐藏(
matchMedia('(display-mode: standalone)'))。 - 图标用 DESIGN 主题色系,不引入第三方图标库。
3.4 帮助中心入口(移动端)
现状:SubNav 已含 /help(T-106 交付 HelpPage,FAQ 8 分类 zh+en)。
| 增强点 | 优先级 | 说明 |
|---|---|---|
| 抽屉内帮助行(工具组) | 已有 | 与桌面导航一致的位置入口 |
| 帮助页内「换一批」相关推荐 | P2 | FAQ 底部分类导航(手风琴已支持分类折叠) |
| 帮助页页头加入口按钮「查看安装指南」 | P2 | 链接到 PWA 安装引导(当 PWA 落地后) |
3.5 分享入口(移动端)
现状:share-codec.ts 已有分享码机制(可解码渲染单张图纸),但无分享 UI。
| 场景 | 入口位置 | 行为 |
|---|---|---|
| 生成结果页(图纸预览区) | 下载按钮旁「分享」icon | navigator.share({title, text, url}) → fallback 复制链接 + toast |
| 抽屉生态区 | 「分享 PERLER LAB」 | 分享首页链接(品牌传播) |
| Showcase/图纸详情 | 卡片操作栏「分享」 | 分享码 URL(?code=...) |
分享是移动端社交传播的核心生态入口,成本极低(复用 share-codec + Web Share API),建议 P1 优先。
4. 交互与视觉规范(对齐 DESIGN.md 令牌)
4.1 令牌引用(禁止硬编码)
| 视觉属性 | 令牌 | 值 |
|---|---|---|
| 抽屉背景 | --bg-card |
#ffffff |
| 分组标题 H3 | --text-secondary + --text-xs(11px) 大写加宽字距 |
#66645d |
| 生态区卡片底 | --bg-subtle |
#f0ede4 |
| 安装行图标强调 | --accent |
#edb045 |
| 正文/说明 | --text-md(13px) / --text-secondary |
— |
| 分隔线 | --border / --border-dashed |
#e6e3d9 / #e0dccd |
| 触控目标 | --touch-min(40px) / --touch-min-sm(34px) |
生态区行 ≥ 40px |
| 圆角 | --radius-md(10px) 卡片 / --radius-lg(12px) 弹层 |
— |
| 阴影 | --shadow-float(抽屉) / --shadow-modal(安装引导弹层) |
— |
| 字体 | --font-sans(PingFang SC / Microsoft YaHei) |
— |
4.2 组件规格
| 元素 | 规格 |
|---|---|
| 抽屉 | 右侧滑入,max-width 360px,全高,--shadow-float,遮罩 rgba(23,23,19,.4),右上 × 关闭 |
| 分组标题 | 11px uppercase tracking-widest 灰字,下距 --space-2 |
| 导航项行 | 高 ≥ 40px,--text-lg(17px),hover --bg-hover,active --accent 左侧 3px 指示条 |
| 生态区卡片 | 内边距 --space-3,--bg-subtle 底 + --radius-md,项间 --border 细分隔 |
| 安装行 | icon(16px) + 标题(15px) + 说明(12px 灰),点击有按压态(transform scale .98) |
| 分享行 | 同上,复用 --accent 强调 icon |
| 迷你安装横幅 | 底部固定,--shadow-float,--bg-card,两按钮(次级「稍后」+ 主按钮 --accent 底白字) |
4.3 交互规范
| 交互 | 规则 |
|---|---|
| 抽屉开关 | 汉堡按钮(lg:hidden)展开;点击遮罩/×/Escape 关闭;关闭后可记忆上次分组展开态 |
| 安装点击 | deferredPrompt.prompt();用户选择"取消"后 24h 内不再展示(localStorage 记录) |
| iOS 引导 | 弹层 --shadow-modal 居中,图文步骤(分享 → 添加到主屏幕),不可装时只显示此引导 |
| 分享 | navigator.share 存在则调用;否则 navigator.clipboard.writeText + toast「链接已复制」 |
| 无障碍 | 抽屉 role="dialog" aria-modal;安装行 role="menuitem";焦点圈定在抽屉内,关闭归还焦点到汉堡按钮 |
| 已安装态 | display-mode: standalone matchMedia 为真 → 隐藏安装行,生态区仅剩分享/帮助 |
5. 优先级矩阵(P0 / P1 / P2)
依据:我方无客户端产品 → apps 页暂缓(NAV-ALIGNMENT §1 #8「不做」);聚焦 PWA 安装提示 + 帮助中心入口。
| ID | 优先级 | 入口 | 任务 | 验收标准 | 依赖 |
|---|---|---|---|---|---|
| E-1 | P0 | PWA 安装 | 移动端抽屉生态区:安装行(可安装态 prompt / iOS 引导态 / 已安装隐藏) | ① beforeinstallprompt 捕获后抽屉显示安装行,点击可 prompt();② 已安装态自动隐藏;③ iOS 显示图文引导;④ 无图标无动效硬编码,全令牌 |
PWA-PLAN P3-1(pwa-install.ts) |
| E-2 | P1 | 分享 | 生成结果页 + 抽屉生态区分享入口(Web Share API + 剪贴板 fallback) | ① 结果页「分享」icon 分享当前图纸(share-codec URL);② 抽屉「分享 PERLER LAB」分享首页;③ fallback 复制链接 + toast | share-codec.ts(已有) |
| E-3 | P1 | 帮助 | 抽屉生态区帮助行(显式入口)+ 帮助页安装指南链接 | ① 抽屉生态区含帮助入口指向 /help;② HelpPage 顶部含「安装到主屏」说明条目(PWA 落地后) |
T-106(HelpPage 已有) |
| E-4 | P1 | 安装横幅 | 完成一次完整流程后底部迷你安装横幅(可关闭,localStorage 记 dismissed) | ① 首次下载/生成图纸后展示一次;② 「稍后」关闭记 dismissed,24h 不再弹;③ 已安装不再展示 | E-1 + PWA-PLAN §5 |
| E-5 | P2 | 帮助增强 | HelpPage 分类推荐 + 安装指南子条目 | ① FAQ 底部「相关问题」推荐 3 条;② 安装指南条目图文并茂 | E-3 |
| E-6 | P2 | 离线态 | 离线 banner(navigator.onLine 检测)+ 抽屉生态区显示「离线可用」徽标 |
① 离线时顶部细条 banner;② 已安装态抽屉显示「离线可用」小徽标 | PWA-PLAN P2(SW 离线 fallback) |
| — | 不做 | apps 页 | 客户端下载页 /zh/apps(无产品不建) | — | 未来出客户端/小程序再立项 |
优先级逻辑:
- P0 = 安装入口:PWA 是唯一能把"无客户端"转成"可安装应用"的路径(T-105 已评估零依赖、已验证),抽屉安装行是投入产出比最高的生态入口。
- P1 = 分享 + 帮助:分享复用已有 share-codec(成本≈0),帮助入口已存在(T-106 交付)只需强化呈现。
- P2 = 增强:离线徽标与安装横幅体验优化,依赖 P0/P1 与 SW 落地。
- 不做 apps:竞品 apps 是"有产品才有入口",我方无客户端则下载页无内容可放,空建页面损害信任。
6. 风险与注意
- 不空建 apps 页:用户点进无产品的"客户端"页 = 体验事故。生态入口永远指向真实可用的东西(可安装的 PWA、可读的 FAQ、可用的分享)。
- 安装提示克制:不拦截首屏、不频繁弹窗(PWA-PLAN §5 原则);用户拒绝后尊重选择(24h 冷却)。
- iOS 差异:无
beforeinstallprompt,SW 更新激进——iOS 只做图文引导,不做主路径投入(PWA-PLAN §8 #5)。 - 已安装态正确隐藏:
display-mode: standalone必须判定,避免已装用户反复看到"安装"行。 - 分享码 URL 可解码:分享出去的
share-codecURL 必须能被任意访客解码渲染(已有能力,回归测试确认)。 - 不引入泛化工具分组:竞品「工具/指南」7 个泛化页面偏离拼豆核心定位,移动端抽屉不得复刻(NAV-ALIGNMENT §1 已排除)。
- 图标与视觉全令牌:安装/分享 icon 用现有 CSS 绘制或 DESIGN 色系 SVG,不引入第三方图标库,不硬编码色值。
7. 落地依赖与衔接
| 环节 | 承接 |
|---|---|
| PWA manifest/SW/安装提示 | PWA-PLAN T-105 P0–P3 任务(P3-1 即 E-1 依赖) |
| 移动端抽屉组件 | NAV-ALIGNMENT P0-3(汉堡 + 分组抽屉)——生态区是其扩展 |
| 帮助页 | T-106 HelpPage(已交付)——E-3/E-5 在其上增强 |
| 分享码 | share-codec.ts(已有)——E-2 直接复用 |
排期建议:NAV-ALIGNMENT P0-3(抽屉)→ E-1(PWA 安装行)→ E-2/E-3(分享+帮助)→ E-4(横幅)→ E-5/E-6(增强)。
文档完。竞品生态入口数据基于 pixelbeads-nav-crawl.md Spider 实测;T-116(apps 落地页细节)开发中未产出,待其完成后可补充 §1.1 落地页内容。我方设计全部基于源码实读 + PWA-PLAN/NAV-ALIGNMENT 既有决策,无推断项。