Files

276 lines
16 KiB
Markdown
Raw Permalink 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.
# 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 实测,非推断。*