# 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 既有决策,无推断项。*