276 lines
16 KiB
Markdown
276 lines
16 KiB
Markdown
# PixelBeads.com 导航结构爬取分析报告(pixelbeads-nav-crawl)
|
||
|
||
> **爬取时间**: 2026-08-14
|
||
> **爬取对象**: https://www.pixel-beads.com/ 全导航体系(桌面端 + 移动端 + 页脚 + 语言切换)
|
||
> **方法**: curl 抓取 8 个页面 SSR + Playwright 真实浏览器渲染验证(Radix dropdown / 移动端 Sheet / 语言菜单均为客户端渲染,SSR 不可见,必须浏览器验证)
|
||
> **任务**: T-090 导航结构对齐(为对标自身导航提供准确数据)
|
||
> **配套文档**: `pixelbeads-zh-detail.md`(§1.3 主导航 7 项已记录、§1.4 页脚 4 栏 16 项已记录)—— 本报告修正并补全其导航细节
|
||
|
||
---
|
||
|
||
## 0. 核心结论速览(给 T-090 的直接答案)
|
||
|
||
| # | 问题 | 结论 |
|
||
|---|---|---|
|
||
| 1 | **图纸库真实 URL** | `/zh/perler-bead-pattern`(=「图纸库」独立菜单项,非主题拼豆的别名) |
|
||
| 2 | **主题拼豆 vs 图纸库是否独立** | ✅ **两个独立菜单项**。主题拼豆是**下拉触发器(button,无 href)**,图纸库是**直接链接**,二者相邻并排 |
|
||
| 3 | 桌面端实际菜单项数 | **9 项**(用户提供的 7 项清单缺「客户端」「帮助」2 项) |
|
||
| 4 | 移动端菜单结构 | 桌面 9 项 + 工具 6 项 + 指南 2 项 + 主题 2 项 + 语言选择 = **更复杂的抽屉式分组菜单** |
|
||
| 5 | 新发现 URL | 7 个不在 sitemap 的移动端菜单 URL(均实测 200) |
|
||
| 6 | 语言前缀 | 默认 en **无前缀**;其余 6 语言带前缀:`/en` `/zh` `/zh-tw` `/ja` `/vi` `/ko` `/de` |
|
||
| 7 | dropdown 子项 | i18n 定义 4 主题,**UI 实际只渲染 2 个**(圣诞 + 宝可梦),另 2 个(万圣节/创意)有页面但不在导航渲染 |
|
||
|
||
---
|
||
|
||
## 1. 桌面端主导航结构(完整)
|
||
|
||
### 1.1 技术实现
|
||
|
||
- **组件**: Radix UI `NavigationMenu`(`data-orientation="horizontal"`,`aria-label="Main"`)
|
||
- **布局**: `<header>` 高 64px(`h-16`),`sticky top-0 z-50`,深棕色半透明底 `bg-[#3E2A1E]/95` + `backdrop-blur-md`
|
||
- **隐藏策略**: 桌面导航容器 `hidden lg:flex`(<1024px 隐藏,切换为汉堡按钮)
|
||
- **当前页高亮**: SSR 直接注入 active 类 `text-[#32B8A6] bg-white/5`(其他项为 `text-[#F7F1E1] hover:text-[#32B8A6] hover:bg-white/5 bg-transparent`)
|
||
|
||
### 1.2 导航项清单(zh 站实测,9 项)
|
||
|
||
| # | 菜单项 | 元素类型 | 当前页 URL(zh) | 说明 |
|
||
|---|---|---|---|---|
|
||
| 1 | 首页 | `<a>` | `/zh` | — |
|
||
| 2 | 拼豆图纸生成器 | `<a>` | `/zh/perler-bead-pattern-generator` | 主工具 |
|
||
| 3 | 拼豆创作 | `<a>` | `/zh/perler-bead-art` | 品牌主题页 |
|
||
| 4 | 图片转像素画 | `<a>` | `/zh/image-to-pixel-art` | 独立工具 |
|
||
| 5 | 作品展示 | `<a>` | `/zh/showcase` | 社区作品库 |
|
||
| 6 | **主题拼豆** | `<button>`(dropdown trigger) | 无直接 href → 下拉见 §1.3 | chevron-down 图标 |
|
||
| 7 | **图纸库** | `<a>` | `/zh/perler-bead-pattern` | 独立链接,与 #6 并排 |
|
||
| 8 | **客户端** | `<a>` | `/zh/apps` | ⭐ 用户清单遗漏项 |
|
||
| 9 | **帮助** | `<a>` | `/zh/help` | ⭐ 用户清单遗漏项 |
|
||
|
||
> ⚠️ **与 pixelbeads-zh-detail.md §1.3 的差异**:
|
||
> - 原记录 7 项,**实际 9 项**(多出「客户端」「帮助」)
|
||
> - 原记录「主题拼豆 = /zh/perler-bead-pattern」,**实际主题拼豆是下拉触发器无 href**,`/zh/perler-bead-pattern` 属于「图纸库」
|
||
> - 原记录「主导航无 apps/help」,**实际导航条第 8/9 项即 apps/help**(§1.4 的"导航条 8 项"与本报告 header 实测 9 项再差异:§1.4 未含「主题拼豆」下拉 trigger,且无「帮助」在内的次序差异)
|
||
|
||
### 1.3 「主题拼豆」下拉菜单(Radix NavigationMenu dropdown,浏览器实测渲染)
|
||
|
||
下拉打开后为卡片式 viewport(`origin-top-center`),含:
|
||
|
||
| # | 子项 | 类型 | href |
|
||
|---|---|---|---|
|
||
| 1 | 查看全部主题 | 链接(顶部) | `/zh/showcase` |
|
||
| 2 | 圣诞拼豆 + 描述文案 | 链接卡片 | `/zh/showcase/christmas-perler-bead-patterns` |
|
||
| 3 | 宝可梦拼豆 + 描述文案 | 链接卡片 | `/zh/showcase/pokemon-champions-perler-bead-patterns` |
|
||
|
||
> ⭐ **关键发现**:
|
||
> - Header i18n 字典(RSC payload)定义 4 个主题:`christmas`/`halloween`/`creative`/`pokemon`(各有 title+description)
|
||
> - 但 **UI 实际只渲染 christmas + pokemon 两个**;halloween、creative 未出现在下拉中
|
||
> - 实测:`/zh/showcase/halloween-perler-bead-patterns` 返回 **200**(万圣节页面真实存在);`/zh/showcase/creative-perler-bead-patterns` 返回 **404**
|
||
> - 推断:dropdown 子项为**硬编码选择**(或按页面可用性过滤),并非遍历全部 i18n 字典 —— 对齐时注意 i18n 字典 ≠ 实际渲染项
|
||
|
||
### 1.4 语言切换器(header 右侧)
|
||
|
||
- **组件**: Radix `DropdownMenu`,trigger 为圆角胶囊按钮(globe 图标 + 当前语言名 + chevron)
|
||
- **zh 站标签**: `aria-label="语言"`,显示「简体中文」;en 站 `aria-label="Language"`,显示「English」
|
||
- **菜单项(浏览器实测,7 语言)**:
|
||
|
||
| # | 语言标签 | href(showcase 页示例) |
|
||
|---|---|---|
|
||
| 1 | English EN | `/en/showcase` |
|
||
| 2 | 简体中文 ZH | `/zh/showcase` |
|
||
| 3 | 繁體中文 繁 | `/zh-tw/showcase` |
|
||
| 4 | 日本語 JA | `/ja/showcase` |
|
||
| 5 | Tiếng Việt VI | `/vi/showcase` |
|
||
| 6 | 한국어 KO | `/ko/showcase` |
|
||
| 7 | Deutsch DE | `/de/showcase` |
|
||
|
||
- **URL 规律**: 语言切换保持当前路径,仅替换语言前缀;默认 en 使用 `/en/` 显式前缀(实测 `/en/showcase` 200,首页 `/en` 200)
|
||
|
||
---
|
||
|
||
## 2. 移动端导航结构(<1024px)
|
||
|
||
### 2.1 触发与形态
|
||
|
||
- **触发**: header 右侧汉堡按钮(`lg:hidden`,`aria-label="Toggle menu"`),替代桌面导航
|
||
- **形态**: 右侧抽屉 Sheet(Radix Sheet / `fixed z-50` 面板),带标题「拼豆艺术」+ 副标题「网站导航、拼豆工具、指南和语言选项。」+ Close 按钮
|
||
- **桌面导航容器**(`hidden lg:flex`)与汉堡按钮(`lg:hidden`)为互斥显示
|
||
|
||
### 2.2 移动端菜单完整结构(浏览器实测)
|
||
|
||
```
|
||
[H2] 拼豆艺术(logo/标题)
|
||
[P] 网站导航、拼豆工具、指南和语言选项。
|
||
├─ 首页 /zh
|
||
├─ 拼豆图纸生成器 /zh/perler-bead-pattern-generator
|
||
├─ 拼豆创作 /zh/perler-bead-art
|
||
├─ 图片转像素画 /zh/image-to-pixel-art
|
||
├─ 图纸库 /zh/perler-bead-pattern
|
||
├─ 作品展示 /zh/showcase
|
||
├─ 客户端 /zh/apps
|
||
├─ 帮助 /zh/help
|
||
├─ [H3] 主题拼豆(分组标题 + 描述「按节日、人气和创意灵感快速进入不同主题的拼豆专区。」)
|
||
│ ├─ 圣诞拼豆 /zh/showcase/christmas-perler-bead-patterns(+描述)
|
||
│ └─ 宝可梦拼豆 /zh/showcase/pokemon-champions-perler-bead-patterns(+描述)
|
||
├─ [H3] 工具(分组)
|
||
│ ├─ 拼豆图纸工具 /zh/perler-bead-pattern-generator
|
||
│ ├─ 像素画编辑器 /zh/pixel-art-maker
|
||
│ ├─ 拼豆豆图纸生成工具 /zh/pindou-pattern-generator
|
||
│ ├─ 照片转像素 /zh/image-to-pixel
|
||
│ ├─ 我的世界指南 /zh/minecraft-pixel-art
|
||
│ └─ r/place 工具 /zh/wplace
|
||
├─ [H3] 指南(分组)
|
||
│ ├─ 拼豆完全指南 /zh/fuse-beads
|
||
│ └─ Hama 拼豆 /zh/hama-beads
|
||
└─ [语言] 简体中文(复用语言下拉)
|
||
```
|
||
|
||
### 2.3 ⭐ 新发现 URL(7 个,均不在 sitemap.xml,全部实测 HTTP 200)
|
||
|
||
| 移动端菜单项 | URL | sitemap 收录 |
|
||
|---|---|---|
|
||
| 像素画编辑器 | `/zh/pixel-art-maker` | ❌ |
|
||
| 拼豆豆图纸生成工具 | `/zh/pindou-pattern-generator` | ❌ |
|
||
| 照片转像素 | `/zh/image-to-pixel` | ❌ |
|
||
| 我的世界指南 | `/zh/minecraft-pixel-art` | ❌ |
|
||
| r/place 工具 | `/zh/wplace` | ❌ |
|
||
| 拼豆完全指南 | `/zh/fuse-beads` | ❌ |
|
||
| Hama 拼豆 | `/zh/hama-beads` | ❌ |
|
||
|
||
> 含义:移动端菜单暴露了一批**未入 sitemap 的隐藏页面**(7 个)。桌面导航只露 9 项,移动端通过分组多暴露 10 个链接(7 新 + 3 已录)。这是桌面 vs 移动信息架构的显著差异。
|
||
|
||
---
|
||
|
||
## 3. 页脚导航完整结构
|
||
|
||
### 3.1 结构(showcase-zh.html 实测,与 pixelbeads-zh-detail.md §1.4 一致)
|
||
|
||
页脚为深棕色(`bg-[#3E2A1E] text-[#F7F1E1]`)四栏网格(`sm:grid-cols-4`),`aria-label="Footer navigation"`,共 **16 个内链**:
|
||
|
||
```
|
||
[品牌区] 拼豆艺术 · 图纸工作室(logo,href=/zh)
|
||
├─ 探索
|
||
│ ├─ 首页 /zh
|
||
│ ├─ 作品展示 /zh/showcase
|
||
│ ├─ 图纸库 /zh/perler-bead-pattern
|
||
│ └─ 博客 /zh/blog
|
||
├─ 创作
|
||
│ ├─ 生成器 /zh/perler-bead-pattern-generator
|
||
│ ├─ 拼豆绘图 /zh/perler-bead-art
|
||
│ └─ 图片转像素画 /zh/image-to-pixel-art
|
||
├─ 应用与支持
|
||
│ ├─ 客户端 /zh/apps
|
||
│ ├─ Chrome 扩展 /zh/apps/chrome-extension
|
||
│ ├─ Android 应用 /zh/apps/android
|
||
│ ├─ iOS 应用 /zh/apps/ios
|
||
│ ├─ 帮助 /zh/help
|
||
│ └─ 联系我们 /zh/contact
|
||
└─ 关于与法律
|
||
├─ 关于我们 /zh/about
|
||
├─ 隐私政策 /zh/privacy-policy
|
||
└─ 服务条款 /zh/terms-of-service
|
||
```
|
||
|
||
### 3.2 页脚附属区(外链,7 个)
|
||
|
||
- 底部徽章行「收录与推荐」:`starterbest.com` / `turbo0.com/item/pixel-beads` / `twelve.tools` / `findly.tools/pixel-beads` / `wired.business` / `dang.ai` / `game-nav.com/site/PerlerBeadPatternGenerator`
|
||
- 版权行: `© 2026 PixelBeads · Made for Creative Makers`(zh: `© 2026 · 拼豆艺术`)
|
||
|
||
> 注:本页脚结构从 showcase-zh.html / image-to-pixel-art 页提取(首页另有**第二个**浅色迷你 footer,仅含徽章+版权,两者并存)。
|
||
|
||
---
|
||
|
||
## 4. 导航项 → 目标页面对应关系(URL 映射总表)
|
||
|
||
### 4.1 全站路由(sitemap 157 URL + 本次新发现)
|
||
|
||
| 导航项 | zh URL | en URL | 页面用途 |
|
||
|---|---|---|---|
|
||
| 首页 | `/zh` | `/` | 首页(生成器介绍+教程+FAQ+精选作品) |
|
||
| 拼豆图纸生成器 | `/zh/perler-bead-pattern-generator` | `/perler-bead-pattern-generator` | 主工具 |
|
||
| 拼豆创作 | `/zh/perler-bead-art` | `/perler-bead-art` | 品牌主题页 |
|
||
| 图片转像素画 | `/zh/image-to-pixel-art` | `/image-to-pixel-art` | 独立工具 |
|
||
| 作品展示 | `/zh/showcase` | `/showcase` | 社区作品库 |
|
||
| 主题拼豆→圣诞 | `/zh/showcase/christmas-perler-bead-patterns` | `/showcase/christmas-perler-bead-patterns` | 主题合集 |
|
||
| 主题拼豆→宝可梦 | `/zh/showcase/pokemon-champions-perler-bead-patterns` | `/showcase/pokemon-champions-perler-bead-patterns` | 主题合集 |
|
||
| 图纸库 | `/zh/perler-bead-pattern` | `/perler-bead-pattern` | 图纸列表 |
|
||
| 客户端 | `/zh/apps` | `/apps` | 应用总入口 |
|
||
| 帮助 | `/zh/help` | `/help` | 帮助中心 |
|
||
| 工具→像素画编辑器 | `/zh/pixel-art-maker` ⭐新 | — | 编辑器 |
|
||
| 工具→拼豆豆生成工具 | `/zh/pindou-pattern-generator` ⭐新 | — | 生成器 |
|
||
| 工具→照片转像素 | `/zh/image-to-pixel` ⭐新 | — | 转换工具 |
|
||
| 工具→我的世界指南 | `/zh/minecraft-pixel-art` ⭐新 | — | 指南 |
|
||
| 工具→r/place | `/zh/wplace` ⭐新 | — | r/place 工具 |
|
||
| 指南→拼豆完全指南 | `/zh/fuse-beads` ⭐新 | — | 指南 |
|
||
| 指南→Hama 拼豆 | `/zh/hama-beads` ⭐新 | — | 品牌指南 |
|
||
|
||
### 4.2 语言前缀矩阵(每语言下存在性,sitemap + 实测)
|
||
|
||
| 路由 | 默认(en) | /zh | /zh-tw | /ja | /vi | /ko | /de |
|
||
|---|---|---|---|---|---|---|---|
|
||
| 首页 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||
| 生成器 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||
| 拼豆创作 | ✅ | ✅ | ❌* | ✅ | ✅ | ✅ | ✅ |
|
||
| 像素画 | ✅ | ✅ | ❌* | ✅ | ✅ | ✅ | ✅ |
|
||
| 作品展示 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||
| 主题合集×2 | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ |
|
||
| 图纸库 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||
| apps×4 | ✅ | ✅ | ❌* | ✅ | ✅ | ✅ | ✅ |
|
||
| 帮助 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||
|
||
> \* zh-tw 站仅 16 URL(sitemap),拼豆创作/像素画/apps 等**页面未建**(i18n 覆盖缺口,与 §1.2 一致)
|
||
> ⭐ 新发现 7 个工具/指南页**仅 zh 站确认**,其他语言待验证
|
||
|
||
---
|
||
|
||
## 5. 导航交互特征(浏览器实测)
|
||
|
||
| 特征 | 实测值 |
|
||
|---|---|
|
||
| **吸顶** | `position: sticky; top: 0; z-index: 50`,滚动始终置顶 |
|
||
| **背景** | 深棕 `rgba(62,42,30,0.95)` 半透明 + `backdrop-filter: blur(12px)` 毛玻璃 |
|
||
| **下边框** | 1px `border-[#543A2A]` + `shadow-lg` |
|
||
| **高度** | 64px(`h-16`),内边距 `px-4` |
|
||
| **hover 效果** | 菜单项 `hover:text-[#32B8A6] hover:bg-white/5`(青绿色文字 + 浅白底) |
|
||
| **active 状态** | 当前页 SSR 注入 `text-[#32B8A6] bg-white/5`(青绿 + 高亮底);其余 `bg-transparent`。浏览器确认:showcase 页仅「作品展示」为高亮态 |
|
||
| **dropdown 展开** | Radix NavigationMenu:hover 展开(`data-[state=open]`),trigger 含 chevron-down 图标,展开旋转 180°;viewport `origin-top-center mt-1.5` |
|
||
| **语言菜单** | Radix DropdownMenu,胶囊 trigger,点击展开 |
|
||
| **移动端** | `lg` 断点(1024px):桌面导航 `hidden`,汉堡 `lg:hidden` 出现;Sheet 抽屉从右侧滑入 |
|
||
| **字体风格** | 菜单项 `text-[10px] font-bold uppercase tracking-widest`(超小号大写加宽字距) |
|
||
| **logo** | 32×32 圆角 webp(srcSet 32/64 两档)+ 品牌名「拼豆艺术」 |
|
||
|
||
---
|
||
|
||
## 6. 与既有分析 pixelbeads-zh-detail.md 的差异点汇总
|
||
|
||
| # | 既有记录(zh-detail) | 本次修正/新发现 | 影响 |
|
||
|---|---|---|---|
|
||
| 1 | §1.3 主导航 **7 项**(无客户端/帮助) | 实际 **9 项**(含客户端 `/zh/apps`、帮助 `/zh/help`) | T-090 导航项数对不上 → 以 9 项为准 |
|
||
| 2 | §1.3 「主题拼豆 → /zh/perler-bead-pattern」 | 主题拼豆是 **dropdown trigger 无 href**;`/zh/perler-bead-pattern` 属**图纸库** | URL 映射修正 |
|
||
| 3 | §1.3 第 7 项「图纸库 URL 未确认」 | **已确认 = `/zh/perler-bead-pattern`**,且与主题拼豆为两个独立菜单项 | 核心交付 |
|
||
| 4 | §1.4 导航条「8 项」 | header 实测 **9 项**(§1.4 少了「主题拼豆」trigger 或次序差异) | 以 header 实测为准 |
|
||
| 5 | sitemap 仅 157 URL | **新增 7 个移动端工具/指南页 URL**(不在 sitemap,实测 200) | 站点地图需补 |
|
||
| 6 | (未记录) | **dropdown 子项 i18n 定义 4 个但只渲染 2 个**;万圣节页 200 存在、创意页 404 | 对齐时勿照抄 i18n 字典 |
|
||
| 7 | (未记录) | 语言切换器 7 项完整 URL 结构(`/en` 前缀显式存在) | URL 映射参考 |
|
||
| 8 | (未记录) | 移动端分组菜单结构(主题/工具/指南分组)+ 桌面/移动信息架构差异 | 移动端设计参考 |
|
||
|
||
---
|
||
|
||
## 7. 对 T-090 的对齐建议(导航结构基准)
|
||
|
||
1. **桌面导航建议对齐 9 项**:首页 / 生成器 / 创作 / 像素画 / 展示 / 主题拼豆(dropdown) / 图纸库 / 客户端 / 帮助
|
||
2. **图纸库 = 独立项**,URL `/perler-bead-pattern`;主题拼豆用 dropdown 承载主题合集(圣诞/宝可梦为最低 2 项,万圣节页可加)
|
||
3. **语言切换器**:7 语言含 `/en` 显式前缀,切换保持路径;zh-tw 注意内容缺口
|
||
4. **移动端**:采用分组抽屉(主导航 + 主题 + 工具 + 指南 + 语言),工具/指南分组可复用 7 个新页面 URL
|
||
5. **吸顶交互**:sticky + 半透明毛玻璃 + 当前页高亮(青绿),为视觉基准
|
||
|
||
---
|
||
|
||
## 8. 数据来源与原始文件
|
||
|
||
- **本次 curl 抓取**(temp):`page-en.html`(493KB)、`page-art.html`(231KB)、`page-pattern.html`(449KB)、`page-christmas.html`(659KB)、`page-halloween.html`(261KB)
|
||
- **Playwright 浏览器验证**: 桌面 dropdown 子项、语言菜单 7 项、移动端 Sheet 完整结构、sticky/active 计算样式、断点显示
|
||
- **复用既有 raw**: `home-zh.html`、`pattern-generator-zh.html`、`showcase-zh.html`、`image-to-pixel.html`、`sitemap.xml`(157 URL)、`raw/js/*`
|
||
- **关键证据锚点**: RSC payload `"Header":{...mobileMenuDescription, themeBeads{items{christmas,halloween,creative,pokemon}}}`;语言列表 `"Language":["en","zh-CN","zh-TW","ja","vi","ko","de"]`
|
||
|
||
---
|
||
*报告完。所有 URL 均已实测 HTTP 状态;客户端渲染项均经 Playwright 实测,非推断。*
|