Files
perler-lab/docs/MOBILE-ECOSYSTEM.md
T

20 KiB
Raw Blame History

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 总原则

  1. apps 页暂缓:无客户端产品则不做下载页。未来若出 PWA/小程序(PWA-PLAN 已具备),届时再考虑"安装引导页"形态,不叫 apps。
  2. 生态入口 = 3 件事:PWA 安装提示(把 Web 变应用)+ 帮助中心入口(服务已有用户)+ 分享入口(社交传播)。
  3. 零新路由零新页面:全部入口复用现有页面/组件/令牌,只加 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. 风险与注意

  1. 不空建 apps 页:用户点进无产品的"客户端"页 = 体验事故。生态入口永远指向真实可用的东西(可安装的 PWA、可读的 FAQ、可用的分享)。
  2. 安装提示克制:不拦截首屏、不频繁弹窗(PWA-PLAN §5 原则);用户拒绝后尊重选择(24h 冷却)。
  3. iOS 差异:无 beforeinstallprompt,SW 更新激进——iOS 只做图文引导,不做主路径投入(PWA-PLAN §8 #5)。
  4. 已安装态正确隐藏:display-mode: standalone 必须判定,避免已装用户反复看到"安装"行。
  5. 分享码 URL 可解码:分享出去的 share-codec URL 必须能被任意访客解码渲染(已有能力,回归测试确认)。
  6. 不引入泛化工具分组:竞品「工具/指南」7 个泛化页面偏离拼豆核心定位,移动端抽屉不得复刻(NAV-ALIGNMENT §1 已排除)。
  7. 图标与视觉全令牌:安装/分享 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 既有决策,无推断项。