17 KiB
17 KiB
NAV-ALIGNMENT — PERLER LAB 导航结构对齐 pixel-beads 落地决策方案
任务: T-090 导航结构对齐 角色: PM-Agent 日期: 2026-08-14 输入依据:
D:\拼豆\competitor-analysis\pixelbeads-nav-crawl.md(Spider 实测:桌面 9 项 / 移动端分组抽屉 / 语言 7 项)D:\拼豆\competitor-analysis\pixelbeads-zh-detail.md(§1.3 主导航、§1.4 页脚、差距矩阵)- 我方现状:
perler-lab/src/components/Nav.tsx(2 项导航)、src/App.tsx(单页 #workspace + /chibi 路由)、src/i18n/messages/{zh-CN,en}.ts- 看板:
D:\拼豆\taskboard\taskboard.js(T-090 已认领)
0. 结论速览
| 维度 | 结果 |
|---|---|
| 对齐项 | 4 项(首页 / 生成器 / 图片转像素画(合并) / 主题拼豆 dropdown) |
| 暂缓项 | 4 项(拼豆创作 / 作品展示 / 图纸库 / 帮助) |
| 不做项 | 1 项(客户端 apps) |
| 新版桌面导航 | 7 项(首页 · 图片转拼豆 · AI拼豆专区[PRO] · 主题拼豆▾ · 作品展示 · 图纸库 · 帮助)+ 右侧保留 语言切换 / 代理合作 / 状态徽标 |
| 移动端 | 参考竞品分组抽屉:主导航组 + 主题拼豆组 + 工具组 + 语言/代理 |
| P0 任务条数 | 3 条(全部为纯导航改造,零新页面零数据依赖) |
| P1 任务条数 | 3 条(新建 /showcase、/library、/help 页面) |
| P2 任务条数 | 2 条(主题下拉深链 chibi 分类、帮助中心子页) |
核心原则:导航先行、页面跟上。P0 阶段只改
Nav.tsx+ i18n + CSS,不引入任何新路由,把对齐项 4 项 + 暂缓项 3 项的占位入口先立起来(暂缓项指向占位区块,点击提示"建设中"),避免"裸导航点空页面"。P1 阶段补真实页面后撤下占位提示。
1. 对比表:pixel-beads 桌面 9 项 vs 我方现状
pixel-beads 依据
pixelbeads-nav-crawl.md§1.2(zh 站 Playwright 实测 9 项);我方依据Nav.tsx/App.tsx实读。
| # | pixel-beads 桌面项 | 竞品 URL | 我方现状 | 差异标注 |
|---|---|---|---|---|
| 1 | 首页 | /zh |
单页顶部 #top(logo → #top,无独立首页项) |
⚠️ 我方单页,无独立首页路由;logo 承担首页锚点 |
| 2 | 拼豆图纸生成器 | /zh/perler-bead-pattern-generator |
✅ 已覆盖:nav.toPattern「图片转拼豆」→ #workspace 生成器 |
≈ 同名同义项已存在 |
| 3 | 拼豆创作 | /zh/perler-bead-art |
❌ 无(品牌主题页不存在) | 缺失:竞品为品牌故事/教程聚合页 |
| 4 | 图片转像素画 | /zh/image-to-pixel-art |
⚠️ 无独立工具页,但 #workspace 就是"图片→像素→拼豆"一体管线 |
竞品拆独立工具页;我方合并承载 |
| 5 | 作品展示 | /zh/showcase |
❌ 无(无社区作品库) | 缺失:竞品有 8 作品/分类/投稿入口 |
| 6 | 主题拼豆(dropdown) | trigger → 圣诞/宝可梦 2 子项 | ⚠️ 无 dropdown,但有 /chibi AI 专区(5 大分类可复用为主题入口) |
竞品按节日/IP 分组;我方 AI 专区分类天然适配 |
| 7 | 图纸库 | /zh/perler-bead-pattern |
❌ 无(有 share-codec.ts 分享码机制,可作种子数据源) |
缺失:竞品为独立列表页 |
| 8 | 客户端 | /zh/apps(含 3 端下载页) |
❌ 无(纯 Web,无客户端产品) | 竞品有 Chrome/Android/iOS 三端;我方无 |
| 9 | 帮助 | /zh/help(含分工具子页) |
❌ 无(无独立帮助页) | 缺失:竞品有 /help 中心 + 分工具子页 |
补充:竞品移动端另有「工具/指南」分组,暴露 7 个 sitemap 外页面(像素画编辑器、照片转像素、我的世界指南等),见
pixelbeads-nav-crawl.md§2.2——我方暂不参考这些泛化工具页(偏离核心拼豆生成定位)。
2. 逐项落地决策(9 项)
| # | pixel-beads 项 | 决策 | 理由 |
|---|---|---|---|
| 1 | 首页 | 对齐 | 我方是单页应用,#top 即首页。新版导航显式加入「首页」项(锚点 #top),与 logo 行为一致,补齐信息架构完整性。工作量≈0。 |
| 2 | 拼豆图纸生成器 | 对齐 | 我方 nav.toPattern(图片转拼豆)→ #workspace 即主工具,与竞品生成器语义等价。仅需文案对齐命名(保留「图片转拼豆」,同义不改名,避免破坏已有 SEO/习惯)。 |
| 3 | 拼豆创作 | 暂缓(P2 评估) | 竞品为品牌故事/教程聚合页,需要内容资产(教程、品牌叙事、精选图)。我方现有 HERO 区已承载品牌感,暂不建独立页;若后续需要 SEO 内容页再做。 |
| 4 | 图片转像素画 | 对齐(合并承载) | 我方 #workspace 即"图片 → 像素 → 拼豆"一体化管线,功能上等价于竞品「生成器 + 像素画」两个入口。不拆独立页(单页优势:路径更短,一次上传即出图纸);导航上不单列,避免两个入口指向同一工具。 |
| 5 | 作品展示 | 暂缓(P1 新建 /showcase) |
竞品 Showcase 社区(分类/浏览量/投稿)是我们缺失的 P0 级差距(见 zh-detail §6 #25),但依赖作品数据源:我方已有 share-codec.ts 分享码机制 + 用户保存图纸能力可作为种子数据。导航占位先立(P0),页面 P1 建。 |
| 6 | 主题拼豆(dropdown) | 对齐(改造复用) | 竞品 dropdown 承载主题合集(圣诞/宝可梦)。我方 AI 专区 /chibi 已有 5 大分类(风景/人物/宠物/物品/食物)——dropdown 直取 4 个热门分类做子项,深链进 chibi 并预选分类;另加「全部主题 → /chibi」兜底项。零新数据,复用现有分类体系。 |
| 7 | 图纸库 | 暂缓(P1 新建 /library) |
需要"已保存/已分享图纸"列表能力。我方 share-codec 分享码可解码渲染单张图纸,但无列表聚合页。导航占位先立,页面 P1 建(首版可聚合"官方精选图纸"静态数据,后续接用户保存)。 |
| 8 | 客户端 | 不做 | 我方是纯 Web 单页应用,无 Chrome 扩展/Android/iOS 客户端产品,竞品 apps 生态无从对齐。如未来出 PWA/小程序再单独立项,届时补入口。 |
| 9 | 帮助 | 暂缓(P1 新建 /help) |
我方无独立帮助中心。竞品 /help 有分工具子页。我方首版可做单页 FAQ 区块(生成流程/兑换码/权益说明,素材已散见于 HERO 与 PassSection 文案),P1 建页;后续视需扩子页。 |
决策统计:对齐 4 · 暂缓 4 · 不做 1
⚠️ 竞品 i18n 教训(
pixelbeads-nav-crawl.md§1.3):dropdown 子项竞品定义了 4 个主题却只渲染 2 个(万圣节页 200 存在、创意页 404)。我方 dropdown 子项必须全部有真实可用的落地页(chibi 分类路由全部存在),不得出现"字典有、页面无"的悬空链接。
3. 我方新版导航结构设计
3.1 桌面端(≥1024px,7 项)
┌────────────────────────────────────────────────────────────────────────────┐
│ ◆ PERLER LAB │ 首页 图片转拼豆 AI拼豆专区◈ 主题拼豆▾ 作品展示 图纸库 帮助 │ 中文|EN [代理合作] ●状态 │
└────────────────────────────────────────────────────────────────────────────┘
▲ #top ▲ #workspace ▲ /chibi(active) ▲ /showcase# ▲ /library# ▲ /help#
│(hover 展开)
▼
┌ 全部主题 → /chibi
│ 宠物世界 → /chibi?cat=pet
│ 人物肖像 → /chibi?cat=people
│ 风景美图 → /chibi?cat=landscape
│ 美食探店 → /chibi?cat=food
| 位序 | 项 | 目标 | 类型 | 说明 |
|---|---|---|---|---|
| — | logo PERLER LAB | #top |
链接 | 保留现有,承担首页锚点 |
| 1 | 首页 | #top |
链接 | 新增;与 logo 同锚点,active 与 logo 一致 |
| 2 | 图片转拼豆 | #workspace |
链接 | 现有项保留(主工具),active 高亮保留 |
| 3 | AI拼豆专区 | /chibi |
链接 | 现有项保留,PRO 徽标保留 |
| 4 | 主题拼豆 | dropdown | 触发器 | 新增;hover/点击展开 4 分类 + 全部主题 |
| 5 | 作品展示 | /showcase(P1) |
链接 | P0 占位 → P1 真页 |
| 6 | 图纸库 | /library(P1) |
链接 | P0 占位 → P1 真页 |
| 7 | 帮助 | /help(P1) |
链接 | P0 占位 → P1 真页 |
| — | 语言切换 中文|EN | — | 保留 | LangSwitcher 原样保留 |
| — | 代理合作按钮 | 弹窗 | 保留 | onAgencyClick 交互原样保留 |
| — | 状态徽标 | — | 保留 | 现有 status badge 保留 |
- 交互基准对齐竞品
pixelbeads-nav-crawl.md§5:吸顶 sticky + 半透明毛玻璃底 + 当前页高亮(我方沿用现有主题色即可,不强求竞品棕色系)、dropdown 卡片式 viewport + chevron 旋转。 - 路由 active 判断:
/chibi前缀命中(现有App.tsx逻辑path === '/chibi' || startsWith('/chibi/'));#workspace/#top用滚动监听高亮。
3.2 移动端(<1024px,分组抽屉,参考竞品 §2.2 但适配我方实际页面)
[☰] PERLER LAB · 让每一颗颜色都有位置 [中文|EN]
┌─────────── 抽屉(右侧滑入)───────────┐
│ PERLER LAB │
│ 网站导航、AI 生成和语言选项。 │
│ │
│ [H3] 主导航 │
│ ├ 首页 #top │
│ ├ 图片转拼豆 #workspace│
│ └ AI拼豆专区 ◈PRO /chibi │
│ [H3] 主题拼豆(按 AI 分类快速进入) │
│ ├ 宠物世界 /chibi?cat=pet │
│ ├ 人物肖像 /chibi?cat=people │
│ ├ 风景美图 /chibi?cat=landscape│
│ └ 美食探店 /chibi?cat=food │
│ [H3] 工具(P1 起逐步开放) │
│ ├ 作品展示 /showcase │
│ ├ 图纸库 /library │
│ └ 帮助 /help │
│ ─────────────────────────────── │
│ [代理合作 →](复用 AgencyModal) │
└─────────────────────────────────────────┘
- 触发:header 汉堡按钮(
lg:hidden),与桌面导航(hidden lg:flex)互斥,沿用竞品断点策略。 - 底部:保留现有移动端固定 CTA「购买 / 兑换 →」(
App.tsx中mobile-cta),抽屉不吞掉变现入口。 - P1 前「工具」分组整体折叠为单项「更多」或直接隐藏(3 个占位项暂不暴露给移动端,避免劣质占位体验)。
3.3 过渡策略(占位 → 真页)
| 阶段 | 桌面 | 移动端 | 暂缓项处理 |
|---|---|---|---|
| P0(导航先行) | 7 项全显示,其中 /showcase /library /help 为占位链接 | 主导航 + 主题拼豆组;工具组隐藏 | 占位项点击 → toast/弹层"页面建设中,敬请期待" |
| P1(页面跟上) | 7 项全真 | 工具组开放 | 占位提示全部撤下 |
4. 实施拆解
4.1 前置依赖(需新建/改造的页面、路由、组件)
| 依赖 | 类型 | 归属任务 | 说明 |
|---|---|---|---|
Nav.tsx 改造 |
组件改造 | P0-1 | 现有 2 项扩为 7 项 + dropdown + 占位态 |
| 主题 dropdown 组件 | 新组件 | P0-1 | 参考 Radix NavigationMenu 模式(无第三方依赖则自实现 hover/click 展开) |
| 移动端抽屉组件 | 新组件 | P0-3 | 参考竞品 Sheet 模式,自实现右滑抽屉 |
| i18n keys(zh/en) | 语言资源 | P0-2 | nav.home/showcase/library/help/theme/… 双语言;en.ts 以 Messages 类型强制键一致(编译期校验,天然验收) |
| CSS(nav 扩展类) | 样式 | P0-1/3 | dropdown viewport、抽屉、占位态样式 |
/showcase 页面 + 路由 |
新页面 | P1-1 | App.tsx 路由分支扩为三段式(chibi / showcase / library / help) |
/library 页面 + 路由 |
新页面 | P1-2 | 首版静态精选图纸,后续接用户保存 |
/help 页面 + 路由 |
新页面 | P1-3 | 单页 FAQ |
/chibi?cat= 深链 |
路由参数 | P2-1 | ChibiPage 读 URL 参数预选分类 |
| 作品数据源(可选) | 数据 | P1-1(可选) | 先静态;接入 share-codec 聚合为后续增强 |
4.2 任务拆分(标题 + 验收标准)
| ID | 优先级 | 任务标题 | 验收标准 |
|---|---|---|---|
| P0-1 | P0 | Nav.tsx:扩为 7 项 + 「主题拼豆」dropdown(4 分类 + 全部主题)+ 3 个占位项 | ① 桌面 ≥1024px 渲染 7 项,AI拼豆专区保留 PRO 徽标;② 主题拼豆 hover/点击展开 4 个 chibi 分类子项 +「全部主题→/chibi」,每个子项链接可点击直达 chibi 并预选分类;③ 作品展示/图纸库/帮助 3 项为占位态,点击弹出"建设中"提示;④ 语言切换/代理合作/状态徽标交互原样保留;⑤ active 高亮:首页与 logo 同源、chibi 前缀命中;⑥ lsp_diagnostics 无错误 |
| P0-2 | P0 | i18n:新增导航 keys(zh-CN + en 成对) | ① 全部新 key 双语言文案齐全且语义一致;② en.ts 满足 Messages 类型约束(缺 key 编译报错);③ 无硬编码中文残留 |
| P0-3 | P0 | 移动端导航:汉堡按钮 + 分组抽屉(主导航 + 主题拼豆 + 隐藏工具组)+ 代理合作 | ① <1024px 隐藏桌面导航、显示汉堡按钮;② 抽屉含主导航 3 项 + 主题拼豆 4 项 + 代理合作按钮;③ 关闭按钮与点击遮罩可关闭;④ 底部固定 CTA「购买/兑换」保留可见;⑤ 无横向溢出滚动 |
| P1-1 | P1 | 新建 /showcase 作品展示页 + 路由 |
① App.tsx 新增路由分支,/showcase 可达;② 首版展示官方精选图纸卡片(静态数据 ≥6 张,含缩略图/尺寸/品牌);③ 桌面与移动端正常渲染;④ 导航「作品展示」占位提示撤下并真实跳转 |
| P1-2 | P1 | 新建 /library 图纸库页 + 路由 |
① /library 路由可达;② 列表展示精选/可分享图纸(首版静态,可复用 showcase 数据源);③ 导航「图纸库」真实跳转 |
| P1-3 | P1 | 新建 /help 帮助页 + 路由 |
① /help 路由可达;② 单页 FAQ 覆盖:生成流程、兑换码使用、权益说明、下载格式(文案复用 Hero/PassSection 已有表述);③ 导航「帮助」真实跳转 |
| P2-1 | P2 | ChibiPage 支持 ?cat= 深链预选分类 |
① /chibi?cat=pet 打开即预选"宠物"分类与对应细分;② 非法 cat 回退默认;③ dropdown 子项全部指向存在页面(无悬空链接,规避竞品 i18n 字典≠渲染页教训) |
| P2-2 | P2 | 帮助中心子页化 / 主题页独立化(按需) | ① 若 FAQ 超一屏则拆 /help/:tool 子页;② 视数据积累决定是否独立主题合集页 |
4.3 优先级逻辑
- P0(导航先行):纯
Nav.tsx+ i18n + CSS,零新页面零数据依赖,风险低、见效快,直接消除"我方仅 2 项"的导航差距观感。 - P1(页面跟上):3 个新页面依赖各自内容源(showcase 精选数据、帮助 FAQ 文案),属于内容+路由建设,周期较长。
- P2(增强):深链与内容扩展,依赖 P0 dropdown 与 P1 页面先落地。
建议排期:P0-1 → P0-2 → P0-3(可并行 2 条)→ 验收通过后启动 P1-1 → P1-2 → P1-3 → P2 按需。
5. 风险与注意
- 单页锚点 vs 路由共存:
#workspace/#top是锚点,/chibi//showcase是路由,active 高亮判定需分两套(滚动监听 + pathname 前缀),避免误判。 - 占位态不要裸链接:暂缓项在 P0 必须给"建设中"反馈,绝不允许点进空白/404——这正是竞品 i18n 字典与渲染页不一致教训的反面应用。
- PRO 徽标与商业定位:AI 专区是付费能力(按次计费),PRO 徽标与状态文案是现有变现心智的一部分,改导航不得移除。
- 移动端抽屉不吞 CTA:
mobile-cta购买/兑换按钮是变现入口,抽屉展开与底部 CTA 需共存。 - 不动算法/业务:本任务只产出决策文档;源码实施由后续任务承接,P0-1/2/3 验收时不得触碰
lib/管线与付费逻辑。
文档完。全部决策基于 pixelbeads-nav-crawl.md(Spider 实测)与我方源码实读,无推断项。