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

286 lines
20 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 既有决策,无推断项。*