From f53f0a2b2546ddff459909927916a13639d30a68 Mon Sep 17 00:00:00 2001 From: Sisyphus Date: Sat, 15 Aug 2026 14:41:00 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20V1.1=20=E6=89=B9=E6=AC=A1=E5=85=A5?= =?UTF-8?q?=E5=BA=93=E2=80=94=E2=80=94=E8=89=B2=E5=8F=B7=E8=A1=A8SEO?= =?UTF-8?q?=E9=A1=B5/Showcase/=E5=9B=BE=E7=BA=B8=E5=BA=93/=E5=B8=AE?= =?UTF-8?q?=E5=8A=A9=E4=B8=AD=E5=BF=83/JSON-LD/CI=E9=97=A8=E7=A6=81/?= =?UTF-8?q?=E7=AB=9E=E5=93=81=E5=88=86=E6=9E=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/workflows/deploy.yml | 37 + competitor-analysis/gap-crawl.md | 721 +++++++ competitor-analysis/pixelbeads-nav-crawl.md | 275 +++ competitor-analysis/pixelbeads-zh-detail.md | 18 +- competitor-analysis/raw/about-en.html | 2 + .../raw/apps-android-en-text.txt | 77 + competitor-analysis/raw/apps-android-en.html | 2 + .../raw/apps-chrome-en-text.txt | 70 + competitor-analysis/raw/apps-chrome-en.html | 2 + competitor-analysis/raw/apps-en-text.txt | 95 + competitor-analysis/raw/apps-en.html | 2 + competitor-analysis/raw/apps-ios-en-text.txt | 71 + competitor-analysis/raw/apps-ios-en.html | 2 + competitor-analysis/raw/blog-en-text.txt | 152 ++ competitor-analysis/raw/blog-en.html | 2 + .../raw/blog-ironing-beginners-en-text.txt | 174 ++ .../raw/blog-ironing-beginners-en.html | 94 + .../raw/blog-mirror-guide-en-text.txt | 208 ++ .../raw/blog-mirror-guide-en.html | 196 ++ competitor-analysis/raw/contact-en.html | 2 + .../raw/help-bead-art-en-text.txt | 357 ++++ competitor-analysis/raw/help-bead-art-en.html | 2 + .../raw/help-generator-en-text.txt | 355 ++++ .../raw/help-generator-en.html | 2 + .../raw/ikea-pyssla-chart-en.html | 2 + competitor-analysis/raw/nabbi-chart-en.html | 2 + .../raw/pattern-luo-ri-yu-hui-en-text.txt | 329 ++++ .../raw/pattern-luo-ri-yu-hui-en.html | 3 + .../raw/pattern-yuan-shen-en-text.txt | 332 ++++ .../raw/pattern-yuan-shen-en.html | 3 + .../raw/perler-bead-pattern-en-text.txt | 206 ++ .../raw/perler-bead-pattern-en.html | 2 + .../raw/perler-beads-en-text.txt | 231 +++ competitor-analysis/raw/perler-beads-en.html | 44 + .../raw/pokemon-champions-en.html | 325 +++ .../raw/privacy-policy-en.html | 2 + .../raw/terms-of-service-en.html | 2 + docs/ANIMATION-PLAN.md | 220 +++ docs/BUSINESS-MODEL.md | 216 ++ docs/CI-NEWPAGES.md | 126 ++ docs/COMPLIANCE-PAGES.md | 167 ++ docs/DEPLOY-NEWPAGES.md | 177 ++ docs/DEV-SETUP.md | 16 +- docs/FAQ-DATA.md | 308 +++ docs/GAP-PRIORITY.md | 149 ++ docs/I18N-ROI.md | 174 ++ docs/LEAFER-EVAL.md | 224 +++ docs/MOBILE-ECOSYSTEM.md | 285 +++ docs/NAV-ALIGNMENT.md | 196 ++ docs/PWA-PLAN.md | 293 +++ docs/RELEASE-V1.1.md | 190 ++ docs/SEO-COLORCHARTS.md | 101 + docs/SEO-CONTENT-MATRIX.md | 197 ++ perler-lab-server/Dockerfile | 5 + perler-lab-server/docker-compose.yml | 4 + perler-lab-server/palettes/artkal-c.json | 1742 +++++++++++++++++ perler-lab-server/palettes/hama.json | 922 +++++++++ perler-lab-server/palettes/ikea-pyssla.json | 182 ++ perler-lab-server/palettes/nabbi.json | 302 +++ perler-lab-server/palettes/perler.json | 1032 ++++++++++ .../palettes/zippland-291标准色映射.json | 293 +++ perler-lab-server/src/color-chart/routes.ts | 190 ++ perler-lab-server/src/db/schema.ts | 15 + perler-lab-server/src/server.ts | 4 + perler-lab-server/src/showcase/routes.ts | 276 +++ perler-lab-server/src/showcase/service.ts | 42 + .../src/tests/color-chart.test.ts | 104 + perler-lab-server/src/tests/showcase.test.ts | 444 +++++ perler-lab/Dockerfile | 8 + perler-lab/scripts/generate-faq-data.mjs | 134 ++ perler-lab/src/App.tsx | 24 +- perler-lab/src/ChibiPage.css | 85 + perler-lab/src/ChibiPage.tsx | 75 +- perler-lab/src/ColorChartPage.css | 485 +++++ perler-lab/src/ColorChartPage.tsx | 168 ++ perler-lab/src/components/Nav.tsx | 3 + perler-lab/src/components/SubNav.tsx | 62 + perler-lab/src/components/WorkCard.tsx | 81 + perler-lab/src/i18n/messages/en.ts | 87 + perler-lab/src/i18n/messages/zh-CN.ts | 87 + .../src/lib/__tests__/bfs-cleanup.test.ts | 120 ++ .../lib/__tests__/color-chart-data.test.ts | 158 ++ .../src/lib/__tests__/color-sort.test.ts | 84 + perler-lab/src/lib/api.ts | 26 + perler-lab/src/lib/bfs-cleanup.ts | 238 +++ perler-lab/src/lib/color-chart-data.ts | 110 ++ perler-lab/src/lib/color-sort.ts | 141 ++ perler-lab/src/lib/faq-data.ts | 330 ++++ perler-lab/src/lib/index.ts | 6 + perler-lab/src/lib/palette-data/artkal-c.json | 1742 +++++++++++++++++ perler-lab/src/lib/palette-data/hama.json | 922 +++++++++ .../src/lib/palette-data/ikea-pyssla.json | 182 ++ perler-lab/src/lib/palette-data/nabbi.json | 302 +++ perler-lab/src/lib/palette-data/perler.json | 1032 ++++++++++ perler-lab/src/lib/showcase.ts | 190 ++ perler-lab/src/pages/HelpPage.tsx | 93 + perler-lab/src/pages/LibraryPage.tsx | 90 + perler-lab/src/pages/ShowcasePage.tsx | 103 + perler-lab/src/pages/pages.css | 837 ++++++++ perler-lab/tsconfig.json | 1 + start-dev.bat | 78 +- stop-dev.bat | 39 +- taskboard/board.html | 710 ++++++- taskboard/board.md | 87 +- 104 files changed, 21760 insertions(+), 157 deletions(-) create mode 100644 competitor-analysis/gap-crawl.md create mode 100644 competitor-analysis/pixelbeads-nav-crawl.md create mode 100644 competitor-analysis/raw/about-en.html create mode 100644 competitor-analysis/raw/apps-android-en-text.txt create mode 100644 competitor-analysis/raw/apps-android-en.html create mode 100644 competitor-analysis/raw/apps-chrome-en-text.txt create mode 100644 competitor-analysis/raw/apps-chrome-en.html create mode 100644 competitor-analysis/raw/apps-en-text.txt create mode 100644 competitor-analysis/raw/apps-en.html create mode 100644 competitor-analysis/raw/apps-ios-en-text.txt create mode 100644 competitor-analysis/raw/apps-ios-en.html create mode 100644 competitor-analysis/raw/blog-en-text.txt create mode 100644 competitor-analysis/raw/blog-en.html create mode 100644 competitor-analysis/raw/blog-ironing-beginners-en-text.txt create mode 100644 competitor-analysis/raw/blog-ironing-beginners-en.html create mode 100644 competitor-analysis/raw/blog-mirror-guide-en-text.txt create mode 100644 competitor-analysis/raw/blog-mirror-guide-en.html create mode 100644 competitor-analysis/raw/contact-en.html create mode 100644 competitor-analysis/raw/help-bead-art-en-text.txt create mode 100644 competitor-analysis/raw/help-bead-art-en.html create mode 100644 competitor-analysis/raw/help-generator-en-text.txt create mode 100644 competitor-analysis/raw/help-generator-en.html create mode 100644 competitor-analysis/raw/ikea-pyssla-chart-en.html create mode 100644 competitor-analysis/raw/nabbi-chart-en.html create mode 100644 competitor-analysis/raw/pattern-luo-ri-yu-hui-en-text.txt create mode 100644 competitor-analysis/raw/pattern-luo-ri-yu-hui-en.html create mode 100644 competitor-analysis/raw/pattern-yuan-shen-en-text.txt create mode 100644 competitor-analysis/raw/pattern-yuan-shen-en.html create mode 100644 competitor-analysis/raw/perler-bead-pattern-en-text.txt create mode 100644 competitor-analysis/raw/perler-bead-pattern-en.html create mode 100644 competitor-analysis/raw/perler-beads-en-text.txt create mode 100644 competitor-analysis/raw/perler-beads-en.html create mode 100644 competitor-analysis/raw/pokemon-champions-en.html create mode 100644 competitor-analysis/raw/privacy-policy-en.html create mode 100644 competitor-analysis/raw/terms-of-service-en.html create mode 100644 docs/ANIMATION-PLAN.md create mode 100644 docs/BUSINESS-MODEL.md create mode 100644 docs/CI-NEWPAGES.md create mode 100644 docs/COMPLIANCE-PAGES.md create mode 100644 docs/DEPLOY-NEWPAGES.md create mode 100644 docs/FAQ-DATA.md create mode 100644 docs/GAP-PRIORITY.md create mode 100644 docs/I18N-ROI.md create mode 100644 docs/LEAFER-EVAL.md create mode 100644 docs/MOBILE-ECOSYSTEM.md create mode 100644 docs/NAV-ALIGNMENT.md create mode 100644 docs/PWA-PLAN.md create mode 100644 docs/RELEASE-V1.1.md create mode 100644 docs/SEO-COLORCHARTS.md create mode 100644 docs/SEO-CONTENT-MATRIX.md create mode 100644 perler-lab-server/palettes/artkal-c.json create mode 100644 perler-lab-server/palettes/hama.json create mode 100644 perler-lab-server/palettes/ikea-pyssla.json create mode 100644 perler-lab-server/palettes/nabbi.json create mode 100644 perler-lab-server/palettes/perler.json create mode 100644 perler-lab-server/palettes/zippland-291标准色映射.json create mode 100644 perler-lab-server/src/color-chart/routes.ts create mode 100644 perler-lab-server/src/showcase/routes.ts create mode 100644 perler-lab-server/src/showcase/service.ts create mode 100644 perler-lab-server/src/tests/color-chart.test.ts create mode 100644 perler-lab-server/src/tests/showcase.test.ts create mode 100644 perler-lab/scripts/generate-faq-data.mjs create mode 100644 perler-lab/src/ColorChartPage.css create mode 100644 perler-lab/src/ColorChartPage.tsx create mode 100644 perler-lab/src/components/SubNav.tsx create mode 100644 perler-lab/src/components/WorkCard.tsx create mode 100644 perler-lab/src/lib/__tests__/bfs-cleanup.test.ts create mode 100644 perler-lab/src/lib/__tests__/color-chart-data.test.ts create mode 100644 perler-lab/src/lib/__tests__/color-sort.test.ts create mode 100644 perler-lab/src/lib/bfs-cleanup.ts create mode 100644 perler-lab/src/lib/color-chart-data.ts create mode 100644 perler-lab/src/lib/color-sort.ts create mode 100644 perler-lab/src/lib/faq-data.ts create mode 100644 perler-lab/src/lib/palette-data/artkal-c.json create mode 100644 perler-lab/src/lib/palette-data/hama.json create mode 100644 perler-lab/src/lib/palette-data/ikea-pyssla.json create mode 100644 perler-lab/src/lib/palette-data/nabbi.json create mode 100644 perler-lab/src/lib/palette-data/perler.json create mode 100644 perler-lab/src/lib/showcase.ts create mode 100644 perler-lab/src/pages/HelpPage.tsx create mode 100644 perler-lab/src/pages/LibraryPage.tsx create mode 100644 perler-lab/src/pages/ShowcasePage.tsx create mode 100644 perler-lab/src/pages/pages.css diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml index 38bab07..974bf75 100644 --- a/.github/workflows/deploy.yml +++ b/.github/workflows/deploy.yml @@ -64,6 +64,43 @@ jobs: working-directory: perler-lab run: npm run build + # 构建产物校验 + 新页面路由冒烟(T-109) + # 目的:① 确认 vite build 产物存在(dist/index.html + assets JS bundle,含 + # /color-chart 系列 /showcase /library 等新页面的静态打包代码); + # ② 用 vite preview(自带 SPA fallback,行为等价于生产 nginx 的 + # try_files $uri $uri/ /index.html)对每个新路由做直访冒烟, + # 防止「路由直访 404」回归。 + - name: Verify SPA dist & route smoke + if: matrix.project.name == 'perler-lab' + working-directory: perler-lab + run: | + set -e + + # ① dist 基础产物存在性校验 + [ -f dist/index.html ] || { echo "❌ dist/index.html 缺失"; exit 1; } + ls dist/assets/*.js > /dev/null 2>&1 || { echo "❌ dist/assets 无 JS bundle"; exit 1; } + echo "✅ dist 产物校验通过(index.html + JS bundle)" + + # ② 启动 vite preview(模拟生产 nginx,含 SPA fallback) + npx vite preview --port 4173 --strictPort > /tmp/vite-preview.log 2>&1 & + PID=$! + trap "kill $PID 2>/dev/null || true" EXIT + + for i in $(seq 1 30); do + curl -sf http://localhost:4173/ > /dev/null 2>&1 && break + sleep 0.5 + done + curl -sf http://localhost:4173/ > /dev/null 2>&1 || { + echo "❌ vite preview 未能启动"; cat /tmp/vite-preview.log; exit 1; } + + # ③ 新页面路由直访冒烟(nginx try_files → index.html → 200) + for route in / /chibi /color-chart /color-chart/mard /color-chart/artkal-c /showcase /library; do + code=$(curl -s -o /dev/null -w '%{http_code}' "http://localhost:4173$route") + echo "GET $route → $code" + [ "$code" = "200" ] || { echo "❌ 路由 $route 返回 $code(预期 200)"; exit 1; } + done + echo "✅ 全部新页面路由冒烟通过" + # ── 构建 Docker 镜像(验证 Dockerfile 正确性) ── build: needs: test diff --git a/competitor-analysis/gap-crawl.md b/competitor-analysis/gap-crawl.md new file mode 100644 index 0000000..7fd4e39 --- /dev/null +++ b/competitor-analysis/gap-crawl.md @@ -0,0 +1,721 @@ +# 竞品外围缺口补爬分析报告(gap-crawl) + +> **批次**: 第 1 批 5 任务(T-113~T-117) +> **爬取时间**: 2026-08-14 +> **目标站点**: https://www.pixel-beads.com/(en 默认语言) +> **执行者**: Spider-Agent +> **配套文档**: `pixelbeads-nav-crawl.md`(导航结构)、`pixelbeads-zh-detail.md`(zh 站详情)、`pixelbeads-analysis.md`(整体分析)、`raw/*-en.html`(本次新抓原始 HTML) +> **范围说明**: 本次为竞品外围缺口补爬,聚焦 T-108~T-110 已建页面(图纸库/help)对应的竞品参考页,以及我方尚未覆盖的 blog/apps/作品详情页。第 2 批 T-118~T-121 由另一任务执行,本报告不重复其目标页。 + +--- + +## §T-113 图纸库双入口:/perler-beads + /perler-bead-pattern + +### 1. 页面用途 + +| URL | 用途 | 与我方对应 | +|---|---|---| +| `/perler-beads` | 品牌关键词落地页(SEO 主入口):「Perler 拼豆图案 + 免费生成器」——精选图案卡 + 生成器介绍 + FAQ,**不展示全量列表** | 无直接对应(近似首页 + 图纸库合体) | +| `/perler-bead-pattern` | **图纸库列表页**(真实图纸库,导航「Patterns/图纸库」指向此页):全量 5,089 个图案 + 浏览量排序 + 分页 102 页 | `/library`(T-108) | + +> 关键区分:`/perler-beads`(品牌页,带精选卡)与 `/perler-bead-pattern`(全量图纸库)是两个不同页面。zh 站导航实测 9 项中「图纸库」指向 `/zh/perler-bead-pattern`;`/perler-beads` 是其 SEO 落地变体,均有独立 title/JSON-LD。 + +### 2. 核心结构(区块树) + +**/perler-beads(品牌落地页)** +``` +Header(9 项导航 + 语言切换器) +├─ H1 Hero: "Perler Beads Patterns" + 副标题(Browse printable bead art ideas…) +│ ├─ CTA×2: [Generate a Pattern] [Browse Patterns] +│ └─ 特性徽章×3: 5mm standard beads / 2.6mm mini bead mode / PDF print export +├─ 精选图案网格("Community pattern gallery",8 张卡) +│ └─ 卡片: 缩略图 + 中文名 + 尺寸(50×46) + 难度标签 +├─ "Featured patterns / Start with the pattern, not the paragraph."(16 张卡) +│ └─ 卡片: 图 + 名字 + 尺寸 + colors数 + beads数 + 难度(Easy/Medium/Advanced) + 分类标签(Animals/Characters/Game sprites/…) +├─ "Image to blueprint / Make your own Perler bead pattern from any image." +│ └─ 生成器介绍 + 步骤图(Upload an image → Original / Bead pattern 对比) +├─ "How to use it / A gallery that leads into making."(3 步) +│ ├─ Browse a pattern first / Match your bead palette / Export a clean blueprint +├─ "Quick guide / Perler beads, without the wall of text."(决策指南) +│ ├─ 5mm beads / 2.6mm mini beads / Fewer colors / More colors(各带 Decision note) +└─ FAQ(5 条: What are Perler beads? / Can I turn any image… / Which size… / Do I need a specific brand…) +Footer(4 栏 16 内链 + 外链徽章 + © 2026) +``` + +**/perler-bead-pattern(图纸库列表页)** +``` +Header(9 项导航,当前页高亮) +├─ H1: "Perler Bead Patterns Gallery" + 副标题(Browse and download pixel bead patterns.) +├─ 搜索说明段(Explore our collection of pixel art perler beads…) +├─ 排序控件: Sort By [Most Popular ▾ / Latest] +├─ 图案卡片网格(SSR 51 张/页,卡片: 缩略图 + 名字 + 浏览量 + [View Details]) +├─ 分页: Page 1 of 102(共 ~5,089 图案) +└─ CTA 尾部条: "Turn Patterns into Custom Pixel Art" → [Start Creating Patterns] +Footer +``` + +### 3. SEO 要素 + +| 项 | /perler-beads | /perler-bead-pattern | +|---|---|---| +| title | `Perler Beads Patterns & Free Generator | PixelBeads` | `Perler Bead Patterns Gallery | Pixel Art & Fuse Bead Designs` | +| meta description | Browse perler beads patterns, find beginner-friendly bead art ideas… | Discover a curated gallery of perler bead patterns and pixel art designs… | +| og:image | `perler-beads-pattern-after.webp`(站内本地图) | 无 og:image | +| JSON-LD | `Organization`(全站统一,含 founder/contactPoint/sameAs)+ **`CollectionPage`** | 仅 `Organization`(⚠️ 列表页**没有** CollectionPage/ItemList) | +| 内链 | 16 卡 → 各自 pt_ 详情页;2 CTA → 生成器 | 51 卡 → pt_ 详情页;1 CTA → 生成器 | + +### 4. 与我方 /library(T-108)的差异点 + +| # | 竞品 | 我方 /library | 差距 | +|---|---|---|---| +| 1 | 全量 SSR 列表,102 页分页,每页 51 卡 | 复用 showcase 种子数据(~10 条),无分页 | 数据量与分页缺失 | +| 2 | 卡含**浏览量**(211,629 等,Sort by Most Popular/Latest) | 无浏览量/排序 | 排序机制未实现 | +| 3 | 卡片有「View Details」→ 独立详情页(pt_ URL) | 按钮仅 preview/download,无详情页路由 | 详情页体系缺失 | +| 4 | 品牌页/列表页**双页分工**(SEO 落地页 + 列表页) | 仅一个 /library | 缺少 SEO 品牌落地页 | +| 5 | 列表页 JSON-LD 反而缺失 CollectionPage(品牌页有) | 无任何 JSON-LD | 需决定我方列表页 schema | +| 6 | 详情卡含尺寸 + colors + beads 数 + 难度 | 行式布局含 grid/brand 标签 | 卡片信息密度更高 | + +### 5. 可复用资产清单 + +- **卡片信息维度**:尺寸(W×H)、色数、豆数(beads)、难度分级(Easy/Medium/Advanced) —— 我方 WorkCard 可扩展。 +- **双页 SEO 模式**:`/perler-beads`(品牌关键词落地)+ `/perler-bead-pattern`(真实列表)分工,可对应我方 `/perler-beads` 型落地页 + `/library`。 +- **排序 UI**:Most Popular / Latest 切换(SPA 可前端排序,无需后端分页)。 +- **卡片徽章文案**:5mm/2.6mm/PDF 特性徽章,可直接复用。 +- **尾部 CTA 条**:"Turn Patterns into Custom Pixel Art" + Start Creating Patterns,作为列表→生成器的转化路径。 +- **raw 文件**:`raw/perler-beads-en.html`(408KB)、`raw/perler-bead-pattern-en.html`(554KB)及对应 `-text.txt`。 + +--- + +## §T-114 Blog:/blog 首页 + 2 篇文章详情 + +### 1. 页面用途 + +| URL | 用途 | +|---|---| +| `/blog` | 博客中心("The Pixel Gazette"):15 篇文章卡(日期/作者/标题/摘要/分类标签),覆盖 Tutorial / Color Chart / Update / Opinion / Guide / Brand Guide / Comparison / Tools / Pokemon 等 9 类 | +| `/blog/perler-beads-ironing-for-beginners` | 熨烫入门教程(No-Hole 技法,5 步 + 工具清单 + FAQ),作者 Mu Li | +| `/blog/perler-bead-mirror-pattern-guide` | 镜像图案指南(为何需要镜像 + 何时需要 + 生成器一键镜像),作者 Mu Li | + +### 2. 核心结构(区块树) + +**/blog 首页** +``` +Header(9 项导航,Blog 高亮) +├─ H1: "The Pixel Gazette" + 副标题(Explore the world of pixel beads art…) +├─ 文章卡列表(15 条,倒序) +│ └─ 卡片: 日期(2026-08-02) + 作者(Yibai Ju) + 标题(链接) + 摘要 + [Read Full Story] + 分类标签(Android) +└─ Footer +``` + +**文章详情页(两篇同构)** +``` +Header +├─ [Back to Blog] 返回链 +├─ H1: 文章标题 +├─ 元信息: Date / Author / 分类标签(Tutorial · Ironing · Beginner Guide) +├─ 正文(图文 step 结构: Getting Started → Step 1..N,每步含子节 + "Click to expand +" 图片位) +│ ├─ 工具清单卡(Baking Paper / Lint Roller / Iron / Masking Tape 5cm+ / Tweezers / Craft Mat) +│ ├─ 步骤卡(The One-Shot Rule / The Palm Press / … 精确操作说明) +│ ├─ 安全提示(Professional Safety Note) +│ └─ FAQ(Beginner FAQ / Question…) +├─ Author 卡(Mu Li · Craft Educator · 个人简介) +├─ 相关阅读(Continue reading → 生成器 / 其他教程链接) +└─ Footer +``` + +### 3. SEO 要素 + +| 项 | /blog | 文章(铁烫/镜像示例) | +|---|---|---| +| title | `Blog - PixelBeads` | `No-Hole Perler Bead Art: Beginner's Roadmap - PixelBeads Blog` | +| meta description | —(首页无 desc 提取到) | `Master the art of creating flawless no-hole Perler bead art…` | +| JSON-LD | — | **`Article`**(@id=URL#article, headline, description, datePublished, inLanguage, author=Person/@id, publisher)+ 全站 Organization | +| author 页面 | — | `https://www.pixel-beads.com/author/mu-li#person`(作者有独立页面) | + +### 4. 与我方对应页的差异点 + +我方**无 blog**(主页/help 内 FAQ 即全部内容资产)。差距: + +| # | 竞品 | 我方现状 | 建议 | +|---|---|---|---| +| 1 | 15 篇文章,9 分类 | 无 | 可先用 FAQ-DATA.md(35 条)生成 3~5 篇教程类文章起步 | +| 2 | Article JSON-LD + 作者页(Person schema) | 无结构化文章数据 | 文章页需 Article JSON-LD | +| 3 | 教程分步结构(工具清单/步骤/安全/FAQ) | 无 | 熨烫/镜像/胶带法三篇与我方图纸流程强相关,最值得对齐 | +| 4 | 首页 9 分类标签 + Read Full Story | 无 | 分类标签体系可复用 FAQ 8 分类 | + +### 5. 可复用资产清单 + +- **熨烫入门教程全文结构**(raw/blog-ironing-beginners-en-text.txt):工具清单、5 步流程、Double Board 翻转法、胶带法(5cm+ 规则)、No-Hole 技法、冷却压平 —— 可直接翻译为 zh 帮助文档。 +- **镜像指南全文结构**(raw/blog-mirror-guide-en-text.txt):镜像必要性逻辑、4 类必镜像场景、决策规则(Text→mirror / 对称→optional)、与生成器一键镜像联动 —— **与我方 T-069 旋转镜像功能强相关**,可作功能说明文档素材。 +- **作者卡组件**:头像占位 + 姓名 + 头衔 + 简介,可用作我方教程署名区。 +- **文章 URL 风格**:`/blog/`,文章标题即 H1 可做 SEO。 +- **raw 文件**:`raw/blog-en.html`(327KB)、`raw/blog-ironing-beginners-en.html`(319KB)、`raw/blog-mirror-guide-en.html`(302KB)。 + +--- + +## §T-115 帮助细分页:2 个工具教程 + +### 1. 页面用途 + +| URL | 用途 | 与我方对应 | +|---|---|---| +| `/help/perler-bead-pattern-generator` | 生成器**完整使用教程**(10 章分步指南):从上传→裁剪→生成→编辑→导出全流程 | `/help`(我方仅 FAQ) | +| `/help/perler-bead-art` | 拼豆创作画布教程(14 章):从画布搭建→MARD 色板→参考图→绘制→材料→导出 | `/help` + `/chibi` 相关能力 | + +> 竞品帮助中心采用「**FAQ 总页 + 每工具独立深度教程子页**」两级结构。`/help` 是总入口(含 Common questions),两个子页是 10/14 章的 step-by-step 教程。我方 `/help` 目前只有 35 条 FAQ 折叠,无工具教程子页。 + +### 2. 核心结构(区块树) + +**两页同构,左侧副导航 + 主教程** +``` +Header(9 项导航,Help 高亮) +├─ 左侧栏: Pattern generator guide / Bead art canvas guide / Common questions(3 个锚链入口) +├─ H1: "Complete Perler Bead Pattern Generator guide" / "Complete Pixel Beads Art canvas guide" +├─ 特性徽章×3: No account required · 10 guided chapters / 14 complete chapters · Desktop and mobile +├─ [Open the pattern generator] CTA + 目录("In this guide": 10/14 章锚链) +├─ 分步教程(Step 1 of 10/14 逐章渲染) +│ └─ 每章结构: 章节名 → 简介 → "Do this"(操作清单)→ "What each control does"(控件字典表) +│ → 编号插图位(1 … 2 … 3 …)→ "Expected result"(验收结果) +│ ├─ 生成器 10 章: Workspace / Upload / Image type & crop / Generate & refine / Canvas navigate / +│ │ Edit cells / Color cleanup·symmetry·layers / Bead codes & quantities / Download·publish / Troubleshoot +│ └─ 画布 14 章: Start method·drafts / Canvas & board / MARD set·inventory / Reference upload·crop / +│ Grid calibration / Editor & local save / Draw·erase·navigate / Codes·working colors / +│ Move·scale reference / Resize canvas / Symmetry·layers / Materials·shortage / Export / Troubleshoot +├─ 尾部 CTA: "Ready to make your pattern" → [Open the pattern generator] / "Start placing beads" → [Open the bead art canvas] +├─ "Still need help?" 联系块: 文案 + [Email us] help@pixel-beads.com + [Contact Us] +└─ Footer +``` + +### 3. SEO 要素 + +| 项 | 生成器教程 | 画布教程 | +|---|---|---| +| title | `Complete Perler Bead Pattern Generator guide` | `Complete Pixel Beads Art canvas guide` | +| meta description | Turn one image into a printable Perler bead pattern. Follow upload, crop, generation, editing, bead counts, and PNG or PDF export. | Set up a board, choose real MARD colors, trace a reference, check materials, and export PNG or PDF… | +| JSON-LD | `Organization` + `WebPage` | `Organization` + `WebPage` | +| ⚠️ | **未用 HowTo schema**(页面结构极适合 HowTo 但未标记) | 同左 | + +### 4. 与我方 /help(T-106)的差异点 + +| # | 竞品 | 我方 /help | 差距 | +|---|---|---|---| +| 1 | 工具教程子页(10/14 章 step-by-step) | 仅 FAQ 折叠(35 条/8 类) | **核心缺口**:无教程内容 | +| 2 | 左栏子页导航(教程/教程/FAQ 三入口) | 单页,无子页体系 | 帮助中心架构缺两级结构 | +| 3 | 每章统一模板:Do this / What each control does / Expected result | 无 | 模板可直接复用 | +| 4 | 教程内容与我方生成器功能**高度重合**(上传/裁剪/色板/导出/对称) | 功能已实现但无教程 | 可把实现功能对照写教程 | +| 5 | 无 HowTo JSON-LD(机会) | 无 | 我方若做教程页可直接上 HowTo schema,反超 | +| 6 | 尾部 Email/Contact 支持块 | 无 | 可加支持入口 | + +### 5. 可复用资产清单 + +- **「Do this / What each control does / Expected result」三步教学模板** —— 直接复用于我方教程页。 +- **10 章生成器教程骨架**:Workspace→Upload→Crop→Generate→Navigate→Edit→Cleanup/Symmetry/Layers→Beads→Export→Troubleshoot,与我方生成器模块一一对应,可快速改写为 zh/en 双语文档。 +- **14 章画布教程骨架**:MARD 色板集/库存/参考图/网格校准/材料短缺统计/导出,对应我方 MARD_PALETTE + InventoryPanel + 导出能力。 +- **左栏子页导航模式**:`/help`(FAQ)+ `/help/`(教程)两级,页面侧边锚链目录。 +- **raw 文件**:`raw/help-generator-en.html`(367KB)、`raw/help-bead-art-en.html`(377KB)+ `-text.txt`。 + +--- + +## §T-116 Apps 应用生态:4 个落地页 + +### 1. 页面用途 + +| URL | 用途 | 状态 | +|---|---|---| +| `/apps` | 应用生态总入口:Chrome/Android/iOS 三平台对比 + 推荐 + 各平台详情入口 | CollectionPage | +| `/apps/chrome-extension` | Chrome 扩展落地页:右键传图到生成器、三步工作流、隐私权限说明 | SoftwareApplication | +| `/apps/android` | Android 应用落地页:**Closed test 招募表单**(Google Play 邮箱 + 同意勾选 + 提交流程说明) | SoftwareApplication | +| `/apps/ios` | iOS 落地页:**In planning** 状态 + 邮件申请发布更新 | WebPage | + +### 2. 核心结构(区块树) + +**/apps(总入口)** +``` +Header(9 项导航,Apps 高亮) +├─ H1: "Pixel Beads Art apps, bead patterns anywhere" +├─ 设备推荐区: "Recommended for this device · Chrome extension" → [Explore the Chrome extension] [Continue with the web version] +├─ "More ways to create": 2 平台卡 +│ ├─ Android(Closed test 徽标): 特性3条 + [Request test access] +│ └─ iOS(In planning 徽标): + [Get launch updates] +├─ 对比表 "Compare Pixel Beads Art platforms": 三列(Chrome/Android/iOS) +│ └─ 每列: 状态徽章 + Best for + Image handling + What you get + [View platform details] +├─ "Why use a Pixel Beads Art app?"(3 好处: Faster import / Create on the go / Local privacy) +└─ "The web version is always available" → [Open the web generator] +Footer +``` + +**/apps/chrome-extension** +``` +Header → H1: "Create bead patterns in one right-click with Pixel Beads Art" +├─ 状态徽章: Extension ready +├─ 3 好处卡: One clear command(右键) / Direct to crop / Short-lived transfer(隐私) +├─ "How it works" 3 步: Choose an image → Confirm the crop → Edit and export +├─ Release information coming soon → [Get the Chrome extension] [Ask about installation] +├─ "Privacy and permissions": 权限范围声明(scoped to chosen image, ~10min 过期, 无后端中转) +└─ "Prefer the browser?" → [Open the web generator] +Footer +``` + +**/apps/android** +``` +Header → H1: "Create anywhere with Pixel Beads Art for Android" + Closed test 徽章 +├─ 3 好处: Works away from your desk / Local editing / Useful exports +├─ "How the closed test works" 4 步: 提交 Play 账号 → 加入 tester 名单 → 接收私有 opt-in 链接 +├─ 申请表单: Google Play account email + 同意勾选(I agree…)+ [Apply to join] + 隐私声明 +├─ "Data, offline use and test access" 说明段 +└─ "Prefer the browser?" → [Open the web generator] +Footer +``` + +**/apps/ios** +``` +Header → H1: "Follow Pixel Beads Art for iOS" + In planning 徽章 +├─ [Request launch updates](邮件预填地址) +├─ 3 好处: Useful launch updates / Privacy from the start / Familiar iOS controls +├─ "How it works": Send a launch request(打开预填邮件)→ Receive product updates → Install when available +├─ iOS updates CTA 卡 → [Open launch-update email] +└─ "Prefer the browser?" → [Open the web generator] +Footer +``` + +### 3. SEO 要素 + +| 页 | title | JSON-LD | +|---|---|---| +| /apps | `Pixel Beads Art Apps for Chrome, Android and iOS` | `CollectionPage` + `Organization` | +| /apps/chrome-extension | `Pixel Beads Art Chrome Extension | Import Web Images Faster` | **`SoftwareApplication`** + Organization | +| /apps/android | `Pixel Beads Art Android App | Offline Bead Pattern Editor` | **`SoftwareApplication`** + Organization | +| /apps/ios | `Pixel Beads Art for iOS | Launch Updates` | `WebPage` + Organization | + +### 4. 与我方对应页的差异点 + +我方**无任何 apps/应用生态页**(纯 Web 应用,无 PWA 落地页、无扩展/移动端计划)。差距: + +| # | 竞品 | 我方现状 | +|---|---|---| +| 1 | 4 页应用生态(总入口 + 3 平台) | 无 | +| 2 | SoftwareApplication / CollectionPage JSON-LD | 无 | +| 3 | Chrome 扩展右键传图 → 生成器 | 无(能力上可做 share-codec 本地跳转) | +| 4 | Android 闭测招募表单(合规:同意勾选 + 隐私声明) | 无 | +| 5 | iOS 邮件订阅更新 | 无 | +| 6 | 对比表(Best for / Image handling / What you get) | 无 | + +### 5. 可复用资产清单 + +- **平台对比表模板**(状态徽章 + Best for + Image handling + What you get + View details)—— 若我方做 PWA 落地页可直接套用。 +- **隐私/权限文案**:扩展"scoped to chosen image / ~10 分钟过期 / 无后端中转"—— 可复用为 PWA/扩展权限声明。 +- **「The web version is always available」兜底 CTA** —— 引导回 Web 主流程,防流失。 +- **闭测表单合规结构**:Google 账号邮箱 + 同意勾选 + 数据用途声明 —— 我方若有内测可参考。 +- **raw 文件**:`raw/apps-en.html`(290KB)、`raw/apps-chrome-en.html`(272KB)、`raw/apps-android-en.html`(276KB)、`raw/apps-ios-en.html`(272KB)+ `-text.txt`。 + +--- + +## §T-117 作品详情页 pt_ 样本 2 个 + +### 1. 页面用途 + +| URL | 样本 | 用途 | +|---|---|---| +| `/perler-bead-pattern/luo-ri-yu-hui-pt_0110a300665f41f0888ff5bd6865d1ef` | 落日余晖(99×99,MARD,~9,801 豆,advanced) | 图案详情页:预览 + 导出 PDF/PNG + 用料清单 + 制作指南 + FAQ | +| `/perler-bead-pattern/yuan-shen-qi-dong-pt_817a4a6e24b94d5f994415cf489cff6a` | 原神启动(48×48,MARD,~2,304 豆,intermediate) | 同构,小图样本 | + +> URL 模式:`/perler-bead-pattern/-pt_<26位hex时间戳>`。从已抓 `raw/showcase-zh.html` 提取 5 个 pt_ 链接(落日余晖/原神启动/鹿式相框/哈弗比/紫用狗拼豆),en 版 URL 去除 `/zh` 前缀后实测 200。此外 `/perler-bead-pattern` 列表页存在**另一套** pt_ 时间戳 ID(如 `pt_1768981145527`,13 位毫秒),两套 ID 格式并存。 + +### 2. 核心结构(区块树) + +**详情页区块树(两样本同构)** +``` +Header(9 项导航,Patterns 高亮) +├─ 面包屑: Home > Pattern Library > 落日余晖 +├─ H1: "落日余晖 Perler Bead Pattern — 99×99 Free Download" +├─ 摘要段: 尺寸 + 豆数 + MARD 色板 + 导出提示 +├─ 警告条: "Check stray and transition colors before making"(杂色/过渡色提示) +│ └─ [Want to refine it manually? Open Bead Art] 联动 CTA +├─ 元信息条: Estimated time(8–12 hr) · Views(6,889) · Author · Date · Material Brand(MARD) +├─ 预览区: "…Pattern Preview" + 大图(Show grid / Fit to screen 开关) +│ └─ 统计徽章: Dimensions · Colors · Total Beads(9,801) +├─ "Make this pattern" 导出区 +│ ├─ [Export PDF (recommended)] [Export PNG (preview/share)] +│ └─ Customize export style: Bead Style(Square/Round/Hollow) · Grid Spacing(None/Small/Large) +├─ Bill of Materials(用料清单) +│ ├─ "83 colors required" + Total Beads +│ ├─ High-use colors to prepare first(色块 + MARD 色号 + 数量,5~6 个) +│ ├─ "45 low-use colors with 10 beads or fewer each" +│ └─ [View all 83 colors](展开完整 83 色清单:色号 + 数量) +├─ "Make it with confidence / 落日余晖 making guide" +│ └─ 6 步骤 Tab: Boards → Materials → Place → Check → Export → Iron +│ (Plan board layout / Prepare colors / Set edges / Slow down at diagonals / Save version / Iron evenly) +│ └─ 高级熨烫 6 种表面对比(Glossy/Standard/Waffle/Towel/Glitter/Wet-cloth)+ 翻转表 +├─ FAQ(8 条: another brand? / pegboards? / too large? / one or both sides? / keep flat? / ironing safety? / resize? / move large?) +├─ 相关推荐: "Keep making / Perler bead patterns you may also like"(10 卡,含浏览量) +└─ Footer +``` + +### 3. SEO 要素 + +| 项 | 落日余晖(大图样本) | 原神启动(小图样本) | +|---|---|---| +| title | `落日余晖 Perler Bead Pattern | 99×99 Free Download` | `原神 启动! Perler Bead Pattern | 48×48 Free Download` | +| meta description | Free 99×99 落日余晖 perler bead pattern using about 9,801 beads. Main codes: A7, A6 and H12; ideal for leftover beads in the A, H, F and G color families. | Free 48×48 … using about 2,304 beads. Main codes: H18, M4 and G18; ideal for leftover beads in the H, M, G and D color families. | +| JSON-LD | **`@graph`: `CreativeWork`**(name/description/isAccessibleForFree/image/thumbnailUrl/keywords/**width/height(QuantitativeValue, unitText=beads)**/url/dateCreated/material/author)+ **`BreadcrumbList`**(Home>Patterns>详情)+ **`FAQPage`**(8 问)+ Organization | 同构 | +| og:image | `https://cdn.pixel-beads.com/pattern-thumbnails/pt_0110…png` | `pt_817a…webp` | + +### 4. 与我方对应页的差异点 + +我方**无图案详情页**:/library 是列表行,卡片按钮仅 preview/download 占位,无 `/pattern/` 详情路由。 + +| # | 竞品 | 我方现状 | 差距 | +|---|---|---|---| +| 1 | 独立详情页(面包屑 + H1 + 大图预览) | 无详情路由 | 详情页体系缺失 | +| 2 | CreativeWork JSON-LD(含 width/height/beads/dateCreated/material)+ BreadcrumbList + FAQPage | 无 | 结构化数据待补 | +| 3 | 导出定制(PDF 推荐/PNG 分享 + Bead Style + Grid Spacing) | 无(我方预览面板仅有下载按钮) | 导出选项待补 | +| 4 | 用料清单(83 色 + 高低用量分组 + 全部展开) | 我方有 InventoryPanel 但无每图用料页 | 可联动 | +| 5 | 6 步制作指南 + 6 种熨烫表面对比 + 翻转表 | 无 | 内容资产待建 | +| 6 | 浏览量 + 相关推荐(Keep making) | 无 | 社交证据缺失 | +| 7 | 详情页尾部 FAQ 与列表页卡片互通(内链闭环) | 无 | 内链策略待补 | + +### 5. 可复用资产清单 + +- **详情页结构模板**:面包屑→H1→摘要→杂色提示→元信息→预览→导出→用料→制作指南→FAQ→相关推荐。 +- **CreativeWork JSON-LD 模板**(含 QuantitativeValue 尺寸/豆数、material、dateCreated、keywords)—— 我方生成图纸若公开即可直接套用。 +- **导出风格选项**:Square/Round/Hollow × Grid Spacing None/Small/Large —— 对齐我方画布渲染能力。 +- **用料清单高低用量分组逻辑**(High-use 前置 + "N low-use colors with ≤10 beads")—— 对齐我方 InventoryPanel + 用量统计。 +- **6 步制作指南文案**(Boards→Materials→Place→Check→Export→Iron)与 6 种熨烫表面对比表 —— 可并入 T-115 教程页。 +- **URL 模式**:`/perler-bead-pattern/-pt_` 与双 ID 格式并存的事实,供我方详情路由设计参考。 +- **raw 文件**:`raw/pattern-luo-ri-yu-hui-en.html`(693KB)、`raw/pattern-yuan-shen-en.html`(605KB)+ `-text.txt`。 + +--- + +## 汇总:5 任务核心发现(供主代理决策) + +1. **图纸库 = 双页分工**(/perler-beads 品牌页 + /perler-bead-pattern 全量列表 102 页分页),列表页反而缺 CollectionPage JSON-LD —— 我方 /library 应补分页 + 浏览量排序 + CollectionPage schema。 +2. **作品详情页是最大缺口**:竞品每个图案有完整详情页(预览/导出/用料/指南/FAQ/推荐 + CreativeWork+BreadcrumbList+FAQPage 三件套),我方仅列表无详情路由。 +3. **帮助中心两级结构**:FAQ 总页 + 每工具 10/14 章教程子页(Do this/What each control does/Expected result 模板),我方仅 FAQ,且教程功能点与生成器实现高度重合可快速改写。 +4. **Blog 15 篇含 2 篇与核心功能强相关**(熨烫入门、镜像指南),可作为我方内容种子;Article JSON-LD + 作者页模式值得跟进。 +5. **Apps 生态 4 页**为纯落地/招募页(无登录、无商店链接,Chrome 扩展也是"coming soon"),我方短期无需建站,但对比表 + 隐私声明 + Web 兜底 CTA 模板可留存复用。 +6. **全站 Organization JSON-LD 统一存在**(founder=Yibai Ju、contactPoint=help@pixel-beads.com、sameAs 目录站)—— 可作为我方 Organization schema 基准。 + +--- + +## 附:请求记录与原始文件 + +- 本次新增请求:12 次(en 页面 12 个,全部 HTTP 200,每页 1 次无重试) + - T-113: `/perler-beads`、`/perler-bead-pattern` + - T-114: `/blog`、`/blog/perler-beads-ironing-for-beginners`、`/blog/perler-bead-mirror-pattern-guide` + - T-115: `/help/perler-bead-pattern-generator`、`/help/perler-bead-art` + - T-116: `/apps`、`/apps/chrome-extension`、`/apps/android`、`/apps/ios` + - T-117: `/perler-bead-pattern/luo-ri-yu-hui-pt_0110a300665f41f0888ff5bd6865d1ef`、`/perler-bead-pattern/yuan-shen-qi-dong-pt_817a4a6e24b94d5f994415cf489cff6a` +- 新落盘 raw 文件(12 HTML + 12 text 提取):`raw/*-en.html` / `raw/*-en-text.txt`(perler-beads / perler-bead-pattern / blog / blog-ironing-beginners / blog-mirror-guide / help-generator / help-bead-art / apps / apps-chrome / apps-android / apps-ios / pattern-luo-ri-yu-hui / pattern-yuan-shen) +- 复用既有 raw:`showcase-zh.html`(提取 pt_ 链接)、`sitemap.xml`(URL 核对)、`home-en.html` +- 未重复抓取:home / showcase / pattern-generator / image-to-pixel(raw/ 已有) + +--- + +# 第 2 批 4 任务(T-118~T-121) + +> **批次**: 第 2 批 4 任务(T-118~T-121) +> **爬取时间**: 2026-08-14 +> **执行者**: Spider-Agent +> **目标站点**: https://www.pixel-beads.com/(en 默认语言) +> **本批目标**: 主题合集页(pokemon)+ JSON-LD 抽查、法律/关于页 4 个、色号表缺口 2 个、6 语言首页轻量验证 +> **新增 raw 文件**: `pokemon-champions-en.html`、`about-en.html`、`contact-en.html`、`privacy-policy-en.html`、`terms-of-service-en.html`、`nabbi-chart-en.html`、`ikea-pyssla-chart-en.html`(7 个 HTML) +> **请求量**: 本批共 11 次请求(pokemon×1、法律/关于×4、色号表×2、六语言×5 其中 zh 引用既有 home-zh.html),全部 HTTP 200,无重试 + +--- + +## §T-118 pokemon 主题合集页 + JSON-LD 抽查 + +### 1. 页面用途 + +| URL | 用途 | 与我方对应 | +|---|---|---| +| `/showcase/pokemon-champions-perler-bead-patterns` | **主题合集落地页**(SEO 长尾入口):Pokemon 风格拼豆图案精选 12 件 + 分类筛选(Electric/Fire/Water/Grass/Psychic/Dragon/Legendary/Champion/Easy)+ 4 步制作教程 + 6 条 Pro Tips + 6 条 FAQ | 我方 /chibi(趣味主题)对应形态;主题合集本身是我方缺口 | + +> 该页与 `/perler-bead-pattern`(全量图纸库)不同:它是**主题营销页**——用低门槛"小精灵图标"类图案做 SEO 长尾(Pokemon Champions 是高频搜索词),并把流量导向 showcase/图纸库。URL 模式 `/showcase/`,面包屑 Home > Showcase > 本页。 + +### 2. 核心结构(区块树) + +``` +Header(6 项导航 + 语言切换器) +├─ 面包屑: Home › Showcase › Pokemon Champions Perler Bead Patterns +├─ Hero: eyebrow "Free Pattern Library · 62 Designs" + H1 "Pokemon Champions Perler Bead Patterns" +│ └─ 副标题 + 说明(全页 pk- 前缀暗色主题 CSS,Bebas Neue/Space Mono 字体) +├─ "Browse the Full … Collection" 图案网格(12 卡) +│ └─ 卡片: 像素 SVG 预览(内联 rect 逐像素渲染 或 canvas)+ 难度徽章(Easy/Legendary/Champion) +│ + 名字 + 统计(尺寸 beads / ~分钟 / colors 数) + [Download PDF] [View] +│ ├─ 前 6 卡为站内 SVG 示例(Electric Champion / Fire Lizard Starter / Water Turtle Starter / +│ │ Psychic Legendary / Grass Seed Starter / Dragon Champion Elite,href=/showcase 占位) +│ └─ 后 6 卡为**真实 pt_ 图案卡**(宝可梦皮卡丘 / 精灵球 / 妙蛙种子…,链接 /perler-bead-pattern/-pt_<13位ms>) +├─ 分类筛选标签行: All · Electric · Fire · Water · Grass · Psychic · Dragon · Legendary · Champion · Easy +├─ "How to Make … Step by Step" 4 步教程卡(Download → Sort Colors → Place Row by Row → Fuse/Cool/Display) +├─ "Starter and Fan-Favorite …" 营销段(bullet 文案) +├─ "Legendary and Champion-Tier …" 营销段(bullet 文案) +├─ "Pro Tips …" 6 条技巧(Match palette / Iron both sides / Parchment not wax / Photo layout / Mini beads / Multi-board seams) +├─ FAQ 6 条(What are / free? / beads needed / pegboard size / kids? / mix brands?) +└─ "Ready to Catch Them All in Beads?" 尾部 CTA → [Browse All Pokemon Champions Patterns] +Footer(4 栏 16 内链 + 6 外链徽章 + © 2026) +``` + +### 3. SEO 要素 + +| 项 | 值 | +|---|---| +| title | `Pokemon Champions Perler Bead Patterns - Free Pixel Art` | +| meta description | `Explore free Pokemon Champions perler bead patterns for starters, legendary builds, and champion-tier pixel art. Browse printable grids for every skill level.` | +| og:title | 同 title(og:image 缺失,依赖卡片 SVG) | +| JSON-LD | `Organization`(全站统一)+ **`CollectionPage`**(name/description/url/publisher/**breadcrumb=BreadcrumbList 3 层**/**mainEntity=ItemList, numberOfItems=12, 12×ListItem 仅 name**) | +| 内链 | 12 卡 → pt_ 详情页(6 条真实)+ /showcase;1 CTA → 本页锚点 | + +> **JSON-LD 抽查结论(全 raw/ 已抓页交叉验证)**:竞品声称的 6 类 schema——**Organization / SoftwareApplication / HowTo / Offer / Person / ContactPoint 全部确认真实存在**,但**并非集中在同一页**: +> - **Organization**(全站每页都有,founder/contactPoint/sameAs) +> - **Person / ContactPoint**(内嵌在 Organization 的 founder/member/contactPoint 字段中,全站每页都带) +> - **SoftwareApplication**(home / image-to-pixel / apps-chrome / apps-android) +> - **Offer**(home / image-to-pixel) +> - **HowTo + HowToStep**(**仅 home 有**,help 教程子页反而没用 HowTo —— 印证 §T-115 的判断) +> - 实际类型还更多:CollectionPage(/perler-beads、/apps、本页)、WebSite(/perler-beads)、Article(blog 详情)、Dataset(全部色号表页)、CreativeWork+BreadcrumbList+FAQPage(pt_ 详情页)、AboutPage(/about) + +### 4. 与我方对应页的差异点 + +| # | 竞品 | 我方现状 | 差距 | +|---|---|---|---| +| 1 | **主题合集页**(/showcase/,每个主题独立 URL + title + CollectionPage schema) | 无主题路由(showcase 是单列表) | **主题合集体系缺失**——可复用主题目录数据生成多个 SEO 页 | +| 2 | 主题页含**内联 SVG 图案预览**(服务端逐像素 rect 渲染,零图片请求) | 预览用图片 | SVG 化可提升加载与内链质量 | +| 3 | 难度徽章 Easy/Legendary/Champion + 统计(尺寸/分钟/colors) | 有 grid/brand 标签 | 主题卡信息维度更多 | +| 4 | CollectionPage 含 mainEntity.ItemList + 面包屑 | 我方无任何 schema | 主题页可套用 | +| 5 | 营销段(Starter / Legendary 分层文案)+ 4 步教程 + 6 Pro Tips + FAQ | 无 | 内容资产待建 | +| 6 | ItemList 中混入一条 name="1" 脏数据(第 8 项无名图案) | — | ⚠️ 我方做时避免无名字条目 | + +### 5. 可复用资产清单 + +- **主题合集页模板**:`/showcase/` 独立页 = Hero + 分类筛选 + 12 卡网格 + 教程 + Pro Tips + FAQ + CTA,一套结构可批量生成多个主题。 +- **CollectionPage JSON-LD 模板**(含 breadcrumb + mainEntity.ItemList)—— 主题页/列表页均可套。 +- **内联 SVG 像素预览方案**:把图案直接序列化为 `` 矩阵(本页正是如此),省图片请求、可 SSR。 +- **难度分层文案结构**(Starter 入门 / Legendary 高阶分层推荐)+ 4 步通用制作教程 + 6 条熨烫 Pro Tips —— 可直接翻译为 zh 内容。 +- **raw 文件**:`raw/pokemon-champions-en.html`(595KB)。 + +--- + +## §T-119 法律与关于页:4 个 + +### 1. 页面用途 + +| URL | 用途 | 与我方对应 | +|---|---|---| +| `/about` | 团队与故事页:创始人 + 3 人团队卡 + 建站动机 + 免费模式说明 + 5 条原则 | 我方无 about 页 | +| `/contact` | 联系页:邮箱 + 响应时效 + mailto 预填 + 引导 help 页 | 我方无 contact 页(T-106 help 尾部有 email 文案) | +| `/privacy-policy` | 隐私政策(12 章:AdSense/第三方/Cookie/儿童/用户上传图/Android App/Chrome 扩展) | 我方无(v1.0 待补) | +| `/terms-of-service` | 服务条款(7 章:使用/用户行为/知识产权/免责/责任限制/条款变更/管辖法律) | 我方无(v1.0 待补) | + +> footer 4 栏内链中 `About / Contact / Privacy Policy / Terms of Service` 是标准底部法律入口。四个页面结构同构:Header(6 导航)→ H1 → 正文 → Footer,无左栏、无侧边目录。 + +### 2. 核心结构(区块树) + +**/about** +``` +Header → H1: "About Us" + 引语("A pixel bead pattern tool built by crafters, for crafters — since 2024.") +├─ Meet the Team(3 人卡,头像缩写字母 + 姓名 + 头衔 + 简介 + [View profile →] 链接到 /author/) +│ ├─ Yibai Ju · Founder & Developer(自建生成器,2024 年起记录拼豆工艺) +│ ├─ Mu Li · Craft Educator(3 年经验,熨烫/大板胶带法/跨品牌色号) +│ └─ Pronoia · Partnerships(外部合作与工具推荐专栏) +├─ How Pixel Beads Art Started(建站动机:付费软件贵 / 品牌色不准 / 无法同时处理 Perler/Hama/Artkal) +├─ What We Build(产品职责) +├─ Why It Stays Free(免费模式) +└─ Principles We Don't Break(5 条原则) +Footer +``` + +**/contact** +``` +Header → H1: "Contact Us"(We'd love to hear from you…) +├─ Email Us: help@pixel-beads.com(+ 尽快回复) +├─ Response Time: 24-48 小时(工作日),紧急邮件优先 +├─ Send Us a Message: [Open Email Client](mailto 预填)+"你也可以复制邮箱地址" +└─ Need Help?: [Visit Help Center](引导 FAQ,防重复提问) +Footer +``` + +**/privacy-policy**(正文 12 章 + 9 子节) +``` +H1: Privacy Policy · Last updated: August 2, 2026 +├─ 1. Overview +├─ 2. Information We Collect(2.1 自动收集: IP/浏览器/OS/访问页/来源/设备 · 2.2 用户提供: 姓名邮箱 · 2.3 Cookies) +├─ 3. Google AdSense(3.1 Google 收集什么 · 3.2 退出个性化广告 · 3.3 Google 政策) +├─ 4. Third-Party Services +├─ 5. Cookie Policy(5.1 类型 · 5.2 管理偏好) +├─ 6. Children's Privacy +├─ 7. User-Uploaded Images(含 "Pixel Beads Android App" 子节) +│ └─ (Chrome Extension Imports 子节,含 Chrome 扩展数据流) +├─ 8. Your Rights +├─ 9. Data Security +├─ 10. International Data Transfers +├─ 11. Changes to This Policy +└─ 12. Contact Us +``` + +**/terms-of-service**(正文 7 章) +``` +H1: Terms of Service · Last updated: January 3, 2026 +├─ 1. Use of the Service(仅限个人非商业用途) +├─ 2. User Conduct(不得上传违法/冒犯/侵权内容) +├─ 3. Intellectual Property(禁止复制/分发/衍生) +├─ 4. Disclaimer of Warranties("as is") +├─ 5. Limitation of Liability +├─ 6. Changes to Terms +└─ 7. Governing Law +``` + +### 3. SEO 要素 + +| 页 | title | meta description | JSON-LD | +|---|---|---|---| +| /about | `About Pixel Beads Art — Founder, Team & Story` | 创始人/3 人团队/故事 | **`AboutPage`**(mainEntity=Organization,含 member×3 Person + founder)+ Organization | +| /contact | `Contact Us | PixelBeads - Get in Touch` | 联系渠道说明 | 仅 `Organization`(⚠️ **未用 ContactPage schema**) | +| /privacy-policy | `Privacy Policy` | 政策摘要 | 仅 `Organization` | +| /terms-of-service | `Terms of Service` | 使用即同意条款 | 仅 `Organization` | + +> ⚠️ 法律/关于页均**无 og:image**;contact/privacy/terms 三页**无独立页面级 schema**(仅全站 Organization)。只有 /about 上了 AboutPage——这是竞品给法律类页面的 schema 上限。 + +### 4. 与我方对应页的差异点 + +我方目前无 about/contact/privacy/terms 任何一页(T-124 已将其列为 P0 法律/关于页缺口)。 + +| # | 竞品 | 我方现状 | 建议 | +|---|---|---|---| +| 1 | 4 页法律/关于齐全(footer 4 内链) | 无 | 逐页补齐(T-124 P0) | +| 2 | /about 上 AboutPage schema(Person member 结构完整) | 无 | about 页可对齐此 schema | +| 3 | privacy 含**平台特有数据章节**(User-Uploaded Images / Android App / Chrome Extension Imports) | 无 | 我方数据流(本地上传/分享码/浏览器端处理)需对应声明 | +| 4 | contact 未上 ContactPage schema(机会) | 无 | 我方 contact 页可直接上 ContactPage 反超 | +| 5 | privacy 引 AdSense + 第三方服务 + 国际数据传输 | 无广告可精简 | 按我方实际(无广告/本地优先)裁剪 | +| 6 | 邮箱统一 help@pixel-beads.com,contact 与 Organization.contactPoint 一致 | 无 | 我方需统一 support 邮箱并同步进 Organization schema | + +### 5. 可复用资产清单 + +- **/about 结构模板**:引语 → 团队卡(缩写头像 + 头衔 + 简介 + 作者页链接)→ 建站动机 → 免费模式 → 原则。团队卡可对应我方(如有)贡献者署名。 +- **/contact 模板**:邮箱 + 响应时效(24-48h)+ mailto 预填按钮 + 引导 FAQ(防重复提问)—— 可直接复用。 +- **privacy 12 章骨架**:Overview/收集/广告/第三方/Cookie/儿童/用户上传图/权利/安全/跨境/变更/联系 —— 我方删去 AdSense、补"浏览器本地处理 + 无后端上传"即可成稿。 +- **terms 7 章骨架**:使用范围/用户行为/知识产权/免责/责任限制/变更/管辖 —— 标准模板可直接改写。 +- **raw 文件**:`raw/about-en.html`(277KB)、`raw/contact-en.html`(247KB)、`raw/privacy-policy-en.html`(273KB)、`raw/terms-of-service-en.html`(245KB)。 + +--- + +## §T-120 色号表缺口:Nabbi + Ikea Pyssla 2 页 + +### 1. 页面用途 + +| URL | 用途 | 与我方对应 | +|---|---|---| +| `/nabbi-bead-color-chart` | Nabbi 拼豆色号大全(en 版):**30 色**全收录(N01–N30),全部为 Standard Solids,0 Pearl / 0 Neon | 我方 palettes/nabbi.json(30 色,已对齐) | +| `/ikea-pyssla-bead-color-chart` | Ikea Pyssla 色号大全(en 版):**18 色**全收录(Black/Blue/Brown…含 Pastell 变体) | 我方 palettes/ikea-pyssla.json(18 色,已对齐) | + +> 竞品色号表采用**统一模板**:perler-chart / mard-chart / hama-chart / artkal-chart(zh 版)+ 本批 nabbi / ikea(en 版)同构。zh 版带"返回工作坊"面包屑、en 版同。统计徽章区(Colors Logged / Standard Solids / Pearl Effects / Vibrant Neons)固定 4 项。 + +### 2. 核心结构(区块树) + +**两页同构** +``` +Header(6 项导航) +├─ [← Back to Workshop](返回 /) +├─ H1: "Ultimate Nabbi Bead Color Chart (2026 Revised Edition)" / "…Ikea Pyssla…" +├─ 描述段(Complete reference for all official … bead color codes, HEX values, and names…) +├─ 统计徽章×4: 30/18 Colors Logged · 30/18 Standard Solids · 0 Pearl Effects · 0 Vibrant Neons +├─ 色卡网格(每色一行: # + 色号代码 + 色名 + HEX 色块 + HEX 值) +│ ├─ Nabbi: N01~N30(N01 #3A3D41 … N30 #C7BF5E) +│ └─ Ikea: Black #000000 / Blue #0657D8 / … / 含 (Pastell) 变体 11 色 +├─ H2 "Official Color Index & HEX Reference"(长文说明 + 品牌 5mm 定位文案) +│ ├─ H3 "Why Color Mapping Matters" +│ └─ H3 "Mastering Hues" +└─ Footer +``` + +### 3. SEO 要素 + +| 项 | /nabbi | /ikea-pyssla | +|---|---|---| +| title | `Ultimate Nabbi Bead Color Chart (2026 Revised Edition)` | `Ultimate Ikea Pyssla Bead Color Chart (2026 Revised Edition)` | +| meta description | `Complete reference for all official Nabbi bead color codes, HEX values, and names. The essential guide for pixel art designers and hobbyists.` | 同构(Ikea Pyssla) | +| og:title | 同 title | 同 title | +| JSON-LD | `Organization` + **`Dataset`**(name/description/url/keywords[品牌/Color Chart/Pixel Art/Bead Codes]/**creator=Organization**/**license=CC BY 4.0**) | 同构 | + +> **Dataset schema 是全品牌色号表统一标配**(perler/mard/hama/artkal/nabbi/ikea 全部 2 blocks)。license 统一标注 CC BY 4.0 —— 竞品把自己的色号数据用 CC 许可公开。 + +### 4. 与我方对应页的差异点 + +| # | 竞品 | 我方现状 | 差距 | +|---|---|---|---| +| 1 | 色号表做成**独立 SEO 页面**(6 品牌各自 /-color-chart 独立 URL + title) | palettes/*.json 数据已有,**无展示页** | 色号表落地页缺口(数据已备可直接渲染) | +| 2 | Dataset JSON-LD(含 license) | 无 | 展示页需配 Dataset schema | +| 3 | 统计徽章(Colors Logged / Solids / Pearl / Neon) | JSON 无分类计数 | 需按色系/效果计算后展示 | +| 4 | "Back to Workshop" 面包屑返回 `/` | 无工作坊概念 | 可忽略或改为返回色板 | +| 5 | 品牌定位文案(5mm 大小、适合家庭入门) | 无 | 每品牌 2~3 句介绍可补 | + +> 数据一致性核验:本批页面 30(Nabbi)+ 18(Ikea)色与 `palettes/nabbi.json`、`palettes/ikea-pyssla.json` 完全一致(HEX 一一对应),无需更新 palette 数据,只需补展示页 + Dataset schema。 + +### 5. 可复用资产清单 + +- **色号表落地页模板**:Hero + 统计徽章×4 + 色卡网格(代码/色名/HEX)+ 品牌定位文案 + Dataset JSON-LD。 +- **Dataset JSON-LD 模板**(含 creator=我方 Organization + license 字段)—— 可复用于我方 palettes 展示。 +- **统计徽章计算逻辑**:按 palette JSON 的 hex/name 归类 Solid/Pearl/Neon(本页 0/0 说明该品牌无特殊效果色)。 +- **raw 文件**:`raw/nabbi-chart-en.html`(343KB)、`raw/ikea-pyssla-chart-en.html`(308KB)。 + +--- + +## §T-121 6 语言首页轻量验证 + +### 1. 验证清单(HTTP 200 + `` + 导航齐备) + +| 语言 | URL | HTTP | lang | title | 导航 | +|---|---|---|---|---|---| +| zh(既有,引用不重抓) | `/zh` | — | `zh` | `拼豆图案 & 免费图纸生成器 - PixelBeads` | 6 项 ✓ | +| zh-tw | `/zh-tw` | 200 | `zh-TW` | `拼豆圖案生成器 \| 免費線上拼豆圖紙製作工具` | 6 项 ✓ | +| ja | `/ja` | 200 | `ja` | `無料アイロンビーズ図案作成|写真から図案に変換 - PixelBeads` | 6 项 ✓ | +| vi | `/vi` | 200 | `vi` | `Công cụ tạo mẫu hạt nhựa ủi miễn phí (2026)` | 6 项 ✓ | +| ko | `/ko` | 200 | `ko` | `펄러비즈 도안 만들기|사진을 비즈 도안으로 무료 변환` | 6 项 ✓ | +| de | `/de` | 200 | `de` | `Bügelperlen-Vorlagen aus Fotos kostenlos erstellen \| PixelBeads` | 6 项 ✓ | + +> 全部 6 语言 HTTP 200(zh 引用既有 raw/home-zh.html,本次新请求 5 次),`` 正确(zh-TW 用 BCP47 变体 `zh-TW`,其余用 2 字母码)。导航统一为 6 项且本地化前缀完整: +> `/` · `//perler-bead-pattern-generator` · `//perler-bead-art` · `//image-to-pixel-art` · `//showcase` · `//perler-bead-pattern` + +### 2. 语言切换器验证(抽 ja 页样本) + +- ja 页 HTML 中可检出全部 7 个 locale 代码(`en`/`zh`/`zh-TW`/`ja`/`vi`/`ko`/`de`),语言切换器(dropdown)在 SSR HTML 内以 locale 代码形式内嵌,客户端 hydration 后成完整 UI。 +- 全部 6 语言首页**均无 hreflang alternate 标签**(`` 为 0)—— 竞品虽做了多语言路由,但**未声明 hreflang 站点地图**,是 SEO 可反超点。 + +### 3. 与我方对应页的差异点 + +| # | 竞品 | 我方现状 | +|---|---|---| +| 1 | 7 语言(en/zh/zh-TW/ja/vi/ko/de)全量路由,首页/生成器/画布/showcase/图纸库 6 项全本地化 | 我方 I18N 未完成(T-124 中 zh-tw 为 P1) | +| 2 | `` 正确(zh-TW 用 BCP47) | 需同步 | +| 3 | **无 hreflang**(机会) | 我方上 hreflang 可反超多语言 SEO | +| 4 | 各语言 title 关键词本地化(ja/ko/vi/de 均为本地语言关键词) | 我方需逐语言 SEO 关键词 | + +### 4. 可复用资产清单 + +- **6 语言首页 H1/title 关键词表**(上表)—— 直接作为我方 I18N 的每语言 title/meta 参照。 +- **导航本地化前缀规范**:`//` 保持英文 slug + 本地化 label —— 我方路由可对齐。 +- **7 语言 locale 清单**:en / zh / zh-TW / ja / vi / ko / de —— 我方 I18N 的 locale 配置基准(zh-TW 用变体码是 BCP47 正确做法)。 +- **hreflang 反超点**:竞品缺 hreflang,我方多语言上线时直接补齐即可形成差异。 +- **未落盘**(仅轻量验证,未保存 HTML);raw/home-zh.html 为既有引用。 + +--- + +## 汇总:第 2 批 4 任务核心发现(供主代理决策) + +1. **JSON-LD 6 类型确认成立**:Organization/SoftwareApplication/HowTo/Offer/Person/ContactPoint 全站点均可验证,但分散在不同页——**HowTo 仅首页有**(help 教程子页反而没有,印证 §T-115 机会),法律页只有 /about 上 AboutPage。我方做 JSON-LD 时可直接对齐"Organization 打底 + 页面级 schema"的两层结构。 +2. **主题合集页是低成本 SEO 放大器**:一套 `/showcase/` 模板(12 卡 + CollectionPage+ItemList)可批量生成多主题页,竞品仅 pokemon 一页;我方若以主题目录(chibi 已有数据)套模板即可规模化。 +3. **法律/关于 4 页为 P0 待补**(呼应 T-124):privacy 12 章 / terms 7 章 / about(AboutPage schema)/ contact(可上 ContactPage 反超)模板已齐,改写成本低。 +4. **色号表 6 品牌展示页缺口**:palettes/ JSON 数据已全(含本批确认 nabbi 30 / ikea 18 一致),只差 Dataset schema 的展示落地页。 +5. **6 语言首页全部 200 且导航齐备**,唯一 SEO 缺口是 hreflang 全站缺失——我方多语言上线时可直接反超。 + +--- + +## 附:第 2 批请求记录与原始文件 + +- 本次新增请求:11 次(en 页面 6 个 + 六语言 5 个,全部 HTTP 200,每页 1 次无重试) + - T-118: `/showcase/pokemon-champions-perler-bead-patterns` + - T-119: `/about`、`/contact`、`/privacy-policy`、`/terms-of-service` + - T-120: `/nabbi-bead-color-chart`、`/ikea-pyssla-bead-color-chart` + - T-121: `/zh-tw`、`/ja`、`/vi`、`/ko`、`/de`(轻量验证,未保存 HTML) +- 新落盘 raw 文件(7 HTML):`raw/pokemon-champions-en.html`、`raw/about-en.html`、`raw/contact-en.html`、`raw/privacy-policy-en.html`、`raw/terms-of-service-en.html`、`raw/nabbi-chart-en.html`、`raw/ikea-pyssla-chart-en.html` +- 复用既有:`showcase-zh.html`(JSON-LD 抽查)、`home-zh.html`(zh 首页验证)、各品牌 chart HTML(模板比对) +- 未重复抓取:home / showcase / pattern-generator / image-to-pixel(raw/ 已有) diff --git a/competitor-analysis/pixelbeads-nav-crawl.md b/competitor-analysis/pixelbeads-nav-crawl.md new file mode 100644 index 0000000..d774cda --- /dev/null +++ b/competitor-analysis/pixelbeads-nav-crawl.md @@ -0,0 +1,275 @@ +# 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"`) +- **布局**: `
` 高 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 | 首页 | `` | `/zh` | — | +| 2 | 拼豆图纸生成器 | `` | `/zh/perler-bead-pattern-generator` | 主工具 | +| 3 | 拼豆创作 | `` | `/zh/perler-bead-art` | 品牌主题页 | +| 4 | 图片转像素画 | `` | `/zh/image-to-pixel-art` | 独立工具 | +| 5 | 作品展示 | `` | `/zh/showcase` | 社区作品库 | +| 6 | **主题拼豆** | `
  • Apps
  • Help
  • About Us

    “A pixel bead pattern tool built by crafters, for crafters — since 2024.”

    Meet the Team

    Pixel Beads Art is built and maintained by three people — each focused on a different part of the craft.

    How Pixel Beads Art Started

    Pixel Beads Art began in 2024 as a personal tool built by founder Yibai Ju. Existing pattern generators either required paid software, missed bead-brand color accuracy, or could not handle the palettes of Perler, Hama, and Artkal side by side. The prototype was rewritten six times across weekends before it became the Next.js application that launched publicly in 2025. Today the tool runs pixel conversion entirely in the browser (no uploads), supports six major bead brands — Perler, Hama, Artkal, MARD, Nabbi, Ikea Pyssla — and is available in four languages.

    What We Build

    We maintain one product: the fastest, most accurate free Perler bead pattern generator on the web. That means exact color matching against each brand's official palette, printable PDFs with bead-count tables, and zero tracking. No subscriptions, no paywalls, no image uploads leaving your browser.

    Why It Stays Free

    Pattern generation is a tool, not a business model — the craft itself is what matters. Keeping Pixel Beads Art free means any kid, parent, or teacher can turn a photo into a pegboard-ready pattern without a credit card. We fund upkeep through a clearly-labeled tool recommendation column, not through your data, ads on your work, or pay-to-unlock features.

    Principles We Don't Break

    Three non-negotiables since launch: (1) All pixel conversion runs client-side — your images never touch our servers. (2) Color matching uses each brand's official palette, not a shared approximation. (3) Every article is written by a named person with verifiable craft or build experience. These aren't growth tactics — they're why we built the tool in the first place.

    Pixel Beads Art Workshop
    \ No newline at end of file diff --git a/competitor-analysis/raw/apps-android-en-text.txt b/competitor-analysis/raw/apps-android-en-text.txt new file mode 100644 index 0000000..1b06581 --- /dev/null +++ b/competitor-analysis/raw/apps-android-en-text.txt @@ -0,0 +1,77 @@ +Pixel Beads Art Android App | Offline Bead Pattern Editor +Pixel Beads Art +Home +Bead Pattern Generator +Bead Art +Image to Pixel Art +Showcase +Theme Beads +Patterns +Apps +Help +English +Android app +Closed test +Create anywhere with Pixel Beads Art for Android +A native Android editor for turning photos into bead patterns, refining the grid and exporting files without depending on a desktop browser. +Request test access +Use the web version +Use the same Google account email that you use in Google Play. The opt-in link is sent only after allowlisting. +Built for the real creative task +A focused native workflow +Works away from your desk +Open the editor on your phone and continue planning a bead project wherever you are. +Local editing +Images and pattern work are processed on the device for a private, responsive workflow. +Useful exports +Save a clean PNG for sharing or a printable PDF for making the physical pattern. +How it works +How the closed test works +Google Play closed tests require one extra account step. The page explains it before asking for your email. +Submit your Play account +Enter the Google account email you will use to install the test app. +We add it to the tester list +Your account must be allowlisted before Google Play can show the test release. +Receive the private opt-in link +After allowlisting, we send the test link and installation instructions to you. +Google Play closed test +Apply with your Google Play account +This is an application list, not an instant download. We first add the account to the test, then send the opt-in link privately. +Use the exact email signed in to Google Play. +Wait for the account to be added to the tester list. +Open the private opt-in link after receiving our email. +Google Play account email +Use the same Google account that you will use to install the test app. +Website +I agree that Pixel Beads may use this email address to add me to the Google Play tester list and send testing instructions. +Apply to join +Your email is stored only for managing the Android closed test and related communication. +Data, offline use and test access +Pattern processing is designed to stay on the Android device. The email form is used only to manage closed-test access and send the related installation instructions. +Prefer the browser? Nothing changes. +The free web generator remains available without installing an app. +Open the web generator +Pixel Beads Art +Pattern Studio +Explore +Home +Showcase +Pattern Library +Blog +Create +Generator +Pixel Bead Art +Image to Pixel Art +Apps & Support +Apps +Chrome Extension +Android App +iOS App +Help +Contact +Company & Legal +About Us +Privacy Policy +Terms of Service +Featured & Listed +© 2026 • Pixel Beads Art \ No newline at end of file diff --git a/competitor-analysis/raw/apps-android-en.html b/competitor-analysis/raw/apps-android-en.html new file mode 100644 index 0000000..271c1a0 --- /dev/null +++ b/competitor-analysis/raw/apps-android-en.html @@ -0,0 +1,2 @@ +Pixel Beads Art Android App | Offline Bead Pattern Editor +

    Android app

    Closed test

    Create anywhere with Pixel Beads Art for Android

    A native Android editor for turning photos into bead patterns, refining the grid and exporting files without depending on a desktop browser.

    Use the same Google account email that you use in Google Play. The opt-in link is sent only after allowlisting.

    Pixel Beads Art Android image import home screen
    Pixel Beads Art Android native pattern editor

    Built for the real creative task

    A focused native workflow

    01

    Works away from your desk

    Open the editor on your phone and continue planning a bead project wherever you are.

    02

    Local editing

    Images and pattern work are processed on the device for a private, responsive workflow.

    03

    Useful exports

    Save a clean PNG for sharing or a printable PDF for making the physical pattern.

    How it works

    How the closed test works

    Google Play closed tests require one extra account step. The page explains it before asking for your email.

    1. 1

      Submit your Play account

      Enter the Google account email you will use to install the test app.

    2. 2

      We add it to the tester list

      Your account must be allowlisted before Google Play can show the test release.

    3. 3

      Receive the private opt-in link

      After allowlisting, we send the test link and installation instructions to you.

    Google Play closed test

    Apply with your Google Play account

    This is an application list, not an instant download. We first add the account to the test, then send the opt-in link privately.

    • Use the exact email signed in to Google Play.
    • Wait for the account to be added to the tester list.
    • Open the private opt-in link after receiving our email.

    Use the same Google account that you will use to install the test app.

    Your email is stored only for managing the Android closed test and related communication.

    Data, offline use and test access

    Pattern processing is designed to stay on the Android device. The email form is used only to manage closed-test access and send the related installation instructions.

    Prefer the browser? Nothing changes.

    The free web generator remains available without installing an app.

    Open the web generator
    \ No newline at end of file diff --git a/competitor-analysis/raw/apps-chrome-en-text.txt b/competitor-analysis/raw/apps-chrome-en-text.txt new file mode 100644 index 0000000..dc0c2e4 --- /dev/null +++ b/competitor-analysis/raw/apps-chrome-en-text.txt @@ -0,0 +1,70 @@ +Pixel Beads Art Chrome Extension | Import Web Images Faster +Pixel Beads Art +Home +Bead Pattern Generator +Bead Art +Image to Pixel Art +Showcase +Theme Beads +Patterns +Apps +Help +English +Chrome extension +Extension ready +Create bead patterns in one right-click with Pixel Beads Art +Choose any useful image on the web, send it directly to Pixel Beads Art, then crop, convert and edit it in the familiar generator. +View access options +Use the web version +The transfer is temporary and does not use a backend image relay. +Built for the real creative task +Less downloading, more making +One clear command +Right-click a source image and choose Pixel Beads Art instead of saving, finding and uploading it again. +Direct to crop +The selected image arrives in the generator ready for cropping and pattern conversion. +Short-lived transfer +Import data is removed after use, rejection or expiry, and no temporary image server is involved. +How it works +From the page to the pegboard +The extension does one focused job and then hands the creative work back to the full generator. +Choose an image +Open the image context menu on a page and select the Pixel Beads Art action. +Confirm the crop +Pixel Beads Art opens the generator with the image ready for a quick crop and review. +Edit and export +Choose bead colors, refine the grid, and export a PNG or printable PDF. +Release information coming soon +Get the Chrome extension +Release information is being updated. Contact us for the latest installation options. +Ask about installation +Check the extension name and publisher before installing. +Privacy and permissions +The extension is scoped to the image you choose. It does not request broad access to every website, and transferred image data expires after successful import, rejection or within about ten minutes. +Prefer the browser? Nothing changes. +The free web generator remains available without installing an app. +Open the web generator +Pixel Beads Art +Pattern Studio +Explore +Home +Showcase +Pattern Library +Blog +Create +Generator +Pixel Bead Art +Image to Pixel Art +Apps & Support +Apps +Chrome Extension +Android App +iOS App +Help +Contact +Company & Legal +About Us +Privacy Policy +Terms of Service +Featured & Listed +© 2026 • Pixel Beads Art \ No newline at end of file diff --git a/competitor-analysis/raw/apps-chrome-en.html b/competitor-analysis/raw/apps-chrome-en.html new file mode 100644 index 0000000..2f05ed9 --- /dev/null +++ b/competitor-analysis/raw/apps-chrome-en.html @@ -0,0 +1,2 @@ +Pixel Beads Art Chrome Extension | Import Web Images Faster +

    Chrome extension

    Extension ready

    Create bead patterns in one right-click with Pixel Beads Art

    Choose any useful image on the web, send it directly to Pixel Beads Art, then crop, convert and edit it in the familiar generator.

    The transfer is temporary and does not use a backend image relay.

    Pixel Beads Art command in Chrome image context menu

    Built for the real creative task

    Less downloading, more making

    01

    One clear command

    Right-click a source image and choose Pixel Beads Art instead of saving, finding and uploading it again.

    02

    Direct to crop

    The selected image arrives in the generator ready for cropping and pattern conversion.

    03

    Short-lived transfer

    Import data is removed after use, rejection or expiry, and no temporary image server is involved.

    How it works

    From the page to the pegboard

    The extension does one focused job and then hands the creative work back to the full generator.

    1. 1

      Choose an image

      Open the image context menu on a page and select the Pixel Beads Art action.

    2. 2

      Confirm the crop

      Pixel Beads Art opens the generator with the image ready for a quick crop and review.

    3. 3

      Edit and export

      Choose bead colors, refine the grid, and export a PNG or printable PDF.

    Release information coming soon

    Get the Chrome extension

    Release information is being updated. Contact us for the latest installation options.

    Ask about installationCheck the extension name and publisher before installing.
    Privacy and permissions

    The extension is scoped to the image you choose. It does not request broad access to every website, and transferred image data expires after successful import, rejection or within about ten minutes.

    Prefer the browser? Nothing changes.

    The free web generator remains available without installing an app.

    Open the web generator
    \ No newline at end of file diff --git a/competitor-analysis/raw/apps-en-text.txt b/competitor-analysis/raw/apps-en-text.txt new file mode 100644 index 0000000..867d0df --- /dev/null +++ b/competitor-analysis/raw/apps-en-text.txt @@ -0,0 +1,95 @@ +Pixel Beads Art Apps for Chrome, Android and iOS +Pixel Beads Art +Home +Bead Pattern Generator +Bead Art +Image to Pixel Art +Showcase +Theme Beads +Patterns +Apps +Help +English +Pixel Beads Art apps +Pixel Beads Art apps, +bead patterns anywhere +Bring images into editable bead patterns from the browser, or keep creating on your phone when you are away from your desk. +Recommended for this device · Chrome extension +Explore the Chrome extension +Continue with the web version +Right-click an image in Chrome, then send it to the pattern generator. +More ways to create +Android +Closed test +A native bead-pattern editor for offline creation, local image processing and portable exports. +Request test access +Native offline creation +Images processed on your device +Export PNG and PDF +iOS +In planning +The iOS version is in planning. Sign up for updates on testing and release availability. +Get launch updates +Compare Pixel Beads Art platforms +Choose the shortest path from source image to editable bead pattern without guessing what each platform can do today. +Chrome +Extension ready +Best for +Importing a source image directly from a webpage +Image handling +Temporary browser transfer to the web generator +What you get +An editable pattern in the full web generator +View platform details +Android +Closed test +Best for +Offline-friendly editing and creating away from a desk +Image handling +Images processed on your device +What you get +Export PNG and PDF +View platform details +iOS +In planning +Best for +Following iOS testing and release updates +Image handling +Planned local image processing on supported devices +What you get +Testing invitations and release updates +View platform details +Why use a Pixel Beads Art app? +Faster import +Move from a source image to the generator with fewer steps and less file handling. +Create on the go +Keep refining colors and grid details on the device that is already with you. +Local privacy +Images and patterns stay under your control, with local processing wherever the product supports it. +The web version is always available +Nothing to install. Open the generator and start from any modern browser. +Open the web generator +Pixel Beads Art +Pattern Studio +Explore +Home +Showcase +Pattern Library +Blog +Create +Generator +Pixel Bead Art +Image to Pixel Art +Apps & Support +Apps +Chrome Extension +Android App +iOS App +Help +Contact +Company & Legal +About Us +Privacy Policy +Terms of Service +Featured & Listed +© 2026 • Pixel Beads Art \ No newline at end of file diff --git a/competitor-analysis/raw/apps-en.html b/competitor-analysis/raw/apps-en.html new file mode 100644 index 0000000..7e102ed --- /dev/null +++ b/competitor-analysis/raw/apps-en.html @@ -0,0 +1,2 @@ +Pixel Beads Art Apps for Chrome, Android and iOS +
    Finished flower bead artwork made with Pixel Beads Art

    Pixel Beads Art apps

    Pixel Beads Art apps,bead patterns anywhere

    Bring images into editable bead patterns from the browser, or keep creating on your phone when you are away from your desk.

    Recommended for this device · Chrome extension
    Explore the Chrome extension
    Pixel Beads Art Chrome extension in the image right-click menu
    Right-click an image in Chrome, then send it to the pattern generator.

    More ways to create

    Android

    Closed test

    A native bead-pattern editor for offline creation, local image processing and portable exports.

    Pixel Beads Art Android home screen
    Pixel Beads Art Android pattern editor
    • Native offline creation
    • Images processed on your device
    • Export PNG and PDF

    iOS

    In planning

    The iOS version is in planning. Sign up for updates on testing and release availability.

    Compare Pixel Beads Art platforms

    Choose the shortest path from source image to editable bead pattern without guessing what each platform can do today.

    Chrome

    Extension ready
    Best for
    Importing a source image directly from a webpage
    Image handling
    Temporary browser transfer to the web generator
    What you get
    An editable pattern in the full web generator

    Android

    Closed test
    Best for
    Offline-friendly editing and creating away from a desk
    Image handling
    Images processed on your device
    What you get
    Export PNG and PDF

    iOS

    In planning
    Best for
    Following iOS testing and release updates
    Image handling
    Planned local image processing on supported devices
    What you get
    Testing invitations and release updates

    Why use a Pixel Beads Art app?

    Faster import

    Move from a source image to the generator with fewer steps and less file handling.

    Create on the go

    Keep refining colors and grid details on the device that is already with you.

    Local privacy

    Images and patterns stay under your control, with local processing wherever the product supports it.

    The web version is always available

    Nothing to install. Open the generator and start from any modern browser.

    Open the web generator
    \ No newline at end of file diff --git a/competitor-analysis/raw/apps-ios-en-text.txt b/competitor-analysis/raw/apps-ios-en-text.txt new file mode 100644 index 0000000..503128b --- /dev/null +++ b/competitor-analysis/raw/apps-ios-en-text.txt @@ -0,0 +1,71 @@ +Pixel Beads Art for iOS | Launch Updates +Pixel Beads Art +Home +Bead Pattern Generator +Bead Art +Image to Pixel Art +Showcase +Theme Beads +Patterns +Apps +Help +English +iOS app +In planning +Follow Pixel Beads Art for iOS +The iOS version is in planning. Request updates about testing access, product progress and release availability. +Request launch updates +Use the web version +The button opens your email app with a pre-addressed message. +iOS version in development +Built for the real creative task +Designed for creative work on iOS +Useful launch updates +Receive updates when testing opens and when the app becomes available. +Privacy from the start +Photos and pattern work are planned to stay on your device whenever possible. +Familiar iOS controls +We are designing the editor around familiar iOS navigation and controls. +How it works +Get iOS updates +Send an update request by email. We will reply when testing opens or the app launches. +Send a launch request +Use the button to open a pre-addressed message to the Pixel Beads Art team. +Receive product updates +We will reply when testing access or release information is available. +Install when available +Use the App Store or testing link included in a future update. +iOS updates +Get iOS testing and release updates +The button opens an email addressed to our team so you can request updates. +Open launch-update email +We receive your email address only if you send the message. +Development status +The iOS version is in planning. Testing access, store links and release timing will be added as they become available. +Prefer the browser? Nothing changes. +The free web generator remains available without installing an app. +Open the web generator +Pixel Beads Art +Pattern Studio +Explore +Home +Showcase +Pattern Library +Blog +Create +Generator +Pixel Bead Art +Image to Pixel Art +Apps & Support +Apps +Chrome Extension +Android App +iOS App +Help +Contact +Company & Legal +About Us +Privacy Policy +Terms of Service +Featured & Listed +© 2026 • Pixel Beads Art \ No newline at end of file diff --git a/competitor-analysis/raw/apps-ios-en.html b/competitor-analysis/raw/apps-ios-en.html new file mode 100644 index 0000000..58671bb --- /dev/null +++ b/competitor-analysis/raw/apps-ios-en.html @@ -0,0 +1,2 @@ +Pixel Beads Art for iOS | Launch Updates +

    iOS app

    In planning

    Follow Pixel Beads Art for iOS

    The iOS version is in planning. Request updates about testing access, product progress and release availability.

    The button opens your email app with a pre-addressed message.

    Finished flower bead artwork representing the planned Pixel Beads Art iOS experience
    iOS version in development

    Built for the real creative task

    Designed for creative work on iOS

    01

    Useful launch updates

    Receive updates when testing opens and when the app becomes available.

    02

    Privacy from the start

    Photos and pattern work are planned to stay on your device whenever possible.

    03

    Familiar iOS controls

    We are designing the editor around familiar iOS navigation and controls.

    How it works

    Get iOS updates

    Send an update request by email. We will reply when testing opens or the app launches.

    1. 1

      Send a launch request

      Use the button to open a pre-addressed message to the Pixel Beads Art team.

    2. 2

      Receive product updates

      We will reply when testing access or release information is available.

    3. 3

      Install when available

      Use the App Store or testing link included in a future update.

    iOS updates

    Get iOS testing and release updates

    The button opens an email addressed to our team so you can request updates.

    Open launch-update email

    We receive your email address only if you send the message.

    Development status

    The iOS version is in planning. Testing access, store links and release timing will be added as they become available.

    Prefer the browser? Nothing changes.

    The free web generator remains available without installing an app.

    Open the web generator
    \ No newline at end of file diff --git a/competitor-analysis/raw/blog-en-text.txt b/competitor-analysis/raw/blog-en-text.txt new file mode 100644 index 0000000..542b6f0 --- /dev/null +++ b/competitor-analysis/raw/blog-en-text.txt @@ -0,0 +1,152 @@ +Blog - PixelBeads +Pixel Beads Art +Home +Bead Pattern Generator +Bead Art +Image to Pixel Art +Showcase +Theme Beads +Patterns +Apps +Help +English +The Pixel Gazette +Explore the world of pixel beads art, get inspiration, tutorials, and latest updates. +2026-08-02 +Yibai Ju +Join the Pixel Beads Android Closed Test +Join the Pixel Beads Android closed test, try photo-to-pattern editing and PNG/PDF export, and help us improve the app before release. +Read Full Story +Android +2026-04-02 +Mu Li +5mm vs 2.6mm Fuse Beads: A Visual Comparison Guide +A basic comparison framework for 5mm and 2.6mm fuse beads, with reserved image slots for side-by-side finished pieces, close-ups, and same-pattern comparisons. +Read Full Story +Comparison +2026-04-02 +Yibai Ju +Fully Automated Perler Bead Machines Shouldn't Be the End of DIY Craft +Fully automated perler bead machines may be fast and efficient, but they also risk removing the hands-on process that gives DIY pixel bead craft its real meaning. +Read Full Story +Opinion +2026-03-31 +Mu Li +Why Perler Bead Patterns Need Mirroring and When to Use a Mirrored Pattern +Learn why Perler bead designs often need a mirror flip, which patterns must be mirrored, and when you should generate a mirrored pattern before ironing. +Read Full Story +Tutorial +2026-03-31 +Mu Li +Ultimate Perler Bead Color Chart (2026 Revised Edition) +Complete reference for all official Perler bead color codes, HEX values, and names. The essential guide for pixel art designers and hobbyists. +Read Full Story +Color Chart +2026-03-31 +Mu Li +Ultimate MARD Bead Color Chart (2026 Revised Edition) +Complete reference for all official MARD bead color codes, HEX values, and names. With 168 colors, the essential guide for pixel art designers and hobbyists. +Read Full Story +Color Chart +2026-03-31 +Mu Li +Ultimate Nabbi Bead Color Chart (2026 Revised Edition) +Complete reference for all official Nabbi bead color codes, HEX values, and names. The essential guide for pixel art designers and hobbyists. +Read Full Story +Color Chart +2026-03-31 +Mu Li +Ultimate Ikea Pyssla Bead Color Chart (2026 Revised Edition) +Complete reference for all official Ikea Pyssla bead color codes, HEX values, and names. The essential guide for pixel art designers and hobbyists. +Read Full Story +Color Chart +2026-03-30 +Yibai Ju +We Built a Dedicated Pokemon Perler Bead Showcase for Trainers Worldwide +We launched the Pokemon Champions Perler Bead Patterns showcase — a dedicated platform where Pokemon fans who love perler beads can find patterns, share their work, and connect over the craft they love. +Read Full Story +Pokemon +2026-03-25 +Pronoia +A BAC Calculator We Recommend for Party Planning +Looking for a fast and reliable BAC calculator before a party, dinner, or night out? Here is why baccalculator.me stands out as a practical educational tool. +Read Full Story +Tools +2026-01-28 +Pronoia +How to Master Logic Strategy Games with Queens Games +Learn how to master Queens Games—a free online logic puzzle inspired by chess. Step-by-step guide to improve strategic thinking and brain training. +Read Full Story +Guide +2026-01-20 +Mu Li +Artkal Beads Brand Guide: Series and Buying Tips +Deep dive into Artkal Beads: S-5mm, C-2.6mm Mini, the new M-2.6mm Mini (221 colors), mixing rules, and brand comparisons vs Perler/Hama/MARD for pro pixel art. +Read Full Story +Brand Guide +2026-01-19 +Mu Li +Mastering the Tape Method: A Comprehensive Guide to Large-Scale Fuse Bead Art +The Tape Method is the gold standard for artists transitioning from single-pegboard hobbies to ambitious, large-scale installations. Learn how to eliminate seams and achieve professional results. +Read Full Story +Tutorial +2026-01-18 +Mu Li +No-Hole Perler Bead Crafting: Complete Guide +A thorough study guide covering the masking tape method and ironing techniques for creating smooth, professional no-hole Perler bead art. +Read Full Story +Tutorial +2026-01-17 +Mu Li +No-Hole Perler Bead Art: Beginner's Roadmap +Master the art of creating flawless no-hole Perler bead art with this comprehensive guide covering tools, techniques, and thermal logic for professional results. +Read Full Story +Tutorial +2026-01-08 +Yibai Ju +Pattern Library Now Live +We are excited to announce the launch of our Pattern Library feature! Browse, search, and download beautiful perler bead patterns to make your crafting easier. +Read Full Story +Update +2026-01-08 +Yibai Ju +SEO Optimization & Feature Updates +We completed SEO optimization for pattern detail pages and pattern library, and added new sponsorship features to make the site more discoverable while providing creators with more ways to show support. +Read Full Story +Update +2026-01-07 +Yibai Ju +Pattern Generator UI Optimization Update +We added new bead style selection features to the pattern generator, including round beads and hollow beads, and comprehensively optimized the user interface for a smoother creative experience. +Read Full Story +Update +2026-01-03 +Yibai Ju +Welcome to PixelBeads +Discover the ultimate tools for creating pixel art and perler bead patterns. +Read Full Story +Update +Pixel Beads Art +Pattern Studio +Explore +Home +Showcase +Pattern Library +Blog +Create +Generator +Pixel Bead Art +Image to Pixel Art +Apps & Support +Apps +Chrome Extension +Android App +iOS App +Help +Contact +Company & Legal +About Us +Privacy Policy +Terms of Service +Featured & Listed +© 2026 • Pixel Beads Art \ No newline at end of file diff --git a/competitor-analysis/raw/blog-en.html b/competitor-analysis/raw/blog-en.html new file mode 100644 index 0000000..0387857 --- /dev/null +++ b/competitor-analysis/raw/blog-en.html @@ -0,0 +1,2 @@ +Blog - PixelBeads +

    The Pixel Gazette

    Explore the world of pixel beads art, get inspiration, tutorials, and latest updates.

    \ No newline at end of file diff --git a/competitor-analysis/raw/blog-ironing-beginners-en-text.txt b/competitor-analysis/raw/blog-ironing-beginners-en-text.txt new file mode 100644 index 0000000..ca2547e --- /dev/null +++ b/competitor-analysis/raw/blog-ironing-beginners-en-text.txt @@ -0,0 +1,174 @@ +No-Hole Perler Bead Art: Beginner's Roadmap - PixelBeads Blog +Pixel Beads Art +Home +Bead Pattern Generator +Bead Art +Image to Pixel Art +Showcase +Theme Beads +Patterns +Apps +Help +English +Back to Blog +No-Hole Perler Bead Art: Beginner's Roadmap +Date +2026-01-17 +Mu Li +Tutorial +Ironing +Beginner Guide +No-Hole Technique +The Beginner's Roadmap to Flawless No-Hole Perler Bead Art +Welcome to the definitive guide for mastering "No-Hole" Perler bead art. Achieving a professional, smooth-melt finish requires more than just heat; it requires a disciplined understanding of thermal logic and physical mechanics. As your instructor, I will guide you through the precise maneuvers necessary to transform loose beads into a solid, museum-quality masterpiece. +Getting Started +Preparation: Your Essential Crafting Toolkit +Success in bead art is 50% technique and 50% preparation. Having the right tools—and understanding their specific cues—prevents errors before they occur. +Baking Paper +Acts as the primary thermal barrier. It must be cleaned of all debris before use to ensure a pristine surface finish. +Lint Roller +Used in conjunction with blowing air; it removes pet hair and micro-dust from the baking paper that would otherwise be permanently fused into your design. +Iron +Your heat source. Set to the "Cotton" gear. Watch the red indicator light: it will flash during pre-heating and turn off only when the iron has reached the stabilized temperature required for melting. +Masking Tape (5cm+) +You must use tape that is 5cm or wider. Narrower tape creates seams and uneven pressure, which will ruin the "no-hole" uniformity. +Tweezers +Indispensable for precision repairs and for handling hot, curling pieces. +Craft Mat +Provides a heat-stabilized, flat surface to protect your workspace during the high-temperature final ironing phases. +Click to expand + +Click to expand + +Click to expand + +Professional Safety Note +Before beginning, ensure your workspace is well-ventilated with windows open. Melting plastic requires consistent airflow for a safe and comfortable crafting environment. +Once your tools are staged and your environment is secured, we can begin the critical process of orienting your design. +Step 1: Preparation +Step 2: Design Correction +The Logic of the 'Flip': Correcting Your Design Direction +If you completed your design only to realize you forgot to "mirror" the pattern for the smooth side, do not panic. The Double Board Technique allows you to correct the orientation with zero bead displacement. +Alignment +: Place a second, empty pegboard directly on top of your design, ensuring the pegs are perfectly nested. +The Table Edge Grip +: Slide both boards toward the edge of the table. This allows you to get a firm, two-handed "pinch" on the boards. +The Manual Flip +: In one steady, confident motion, flip the boards over. +Stabilized Landing +: Place the boards back down against the table edge. This provides a physical stop that prevents the boards from sliding and shifting the beads upon impact. +The Tap and Lift +: Gently tap the top board to settle the beads, then lift it slowly and perfectly vertically. +Precision Repair +: Use your tweezers to return any rogue beads to their proper coordinates. +With your design now oriented correctly, we must secure the structure for the heat transfer. +Step 3: Masking Tape Application +The Masking Tape Bridge: Securing Your Masterpiece +The masking tape phase is where the design is transitioned from the board to a workable state. Precision here is non-negotiable. +Click to expand + +Click to expand + +The One-Shot Rule +: Cut your 5cm+ tape to length and align it carefully. You cannot lift or reposition the tape once it touches the beads. Lifting the tape will pull beads out of alignment and destroy your pattern. +The Palm Press +: After applying the tape, use the base of your palm to press down firmly across the entire surface. This ensures every individual bead is bonded to the adhesive. +The Board Inversion +: Use tweezers to gently pry up the tape edges. To remove the board safely, pick up the entire unit, turn the pegboard upside down, and lift the board away from the beads (rather than peeling the beads off the board). +Edge Management +: Fold all excess tape over the back of the design to create a clean, manageable workspace on your craft mat. +With the beads secured and the board removed, we move to the most critical phase: the thermal application. +Step 4: Ironing Process +Thermal Logic: Mastering the Ironing Process +A "No-Hole" finish is achieved through controlled heat accumulation, not raw force. +Sub-Phase A: Surface Purification & Pre-heating +The Dual-Clean +: Before ironing, blow air over the beads to clear any loose dust. Then, use the lint roller on your baking paper. If you have pets, this step is mandatory to prevent hair from being entombed in the plastic. +Thermal Readiness +: Set the iron to "Cotton." Wait until the red light stops flashing and turns off before making contact. +Sub-Phase B: Phase 1 (Initial Adhesion) +Lay the baking paper over the design. +Vertical Pressing vs. Circling +: Use a Vertical Pressing motion only. Do not move the iron in circles yet. Press straight down until you can visually see the beads "sticking" to the translucent paper. +Once the design is fully adhered to the paper, carefully peel away the masking tape. +Sub-Phase C: Phase 2 (The "No-Hole" Finish) +The No-Hole Technique +: Use slow, horizontal gliding or vertical pressure. +Warning: Heat Accumulation Risk (Men Dou) +. Do not leave the iron stationary for too long, or the beads will become over-melted and "stifled," ruining the texture. +The Light Check +: Periodically lift the piece and hold it up to a light source. Visible points of light indicate holes that require more heat. +Structural Tension +: While targeting specific holes, you must occasionally pass the iron over the finished no-hole areas. These areas must stay warm; if they cool while other parts are being ironed, the piece will warp and curve due to uneven thermal contraction. +Step 5: Final Steps +The Final Set: Cooling and Flattening +You have reached the final hurdle. The piece is currently a molten, malleable plastic; your patience here determines the final structural integrity. +Shake and Cool +: Immediately after turning off the iron, pick up the baking paper and shake it rapidly in the air to begin the cooling process. +Tweezer-Assisted Peeling +: As the piece cools, it will naturally want to curl (捲起) and will be very hot to the touch. Use your tweezers to press down firmly on the bead art while you carefully peel away the tape and paper. +The Flattening Weight +: While the piece is still warm and receptive to shaping, place it on a flat surface and cover it with a heavy object (such as a large book). This pressure is what transforms the "melted" plastic into a perfectly flat, professional work of art. +Congratulations on completing your roadmap to a flawless finish. If you have any questions regarding your results or specific bead behaviors, please share them in the comments for further guidance. Happy crafting! +Beginner FAQ +Question +Why use 5cm+ wide masking tape? +Narrower tape requires overlapping strips. The overlap creates seams and uneven pressure, which ruins the uniform look of a no-hole finish. +Question +How do I prevent the piece from curling? +Curling is caused by uneven cooling. Keep the entire piece warm by occasionally sweeping the iron over finished areas while you focus on specific holes. +Question +When should I remove the masking tape? +Remove it after the "Initial Adhesion" phase, once the beads are clearly visible through and stuck to the baking paper, but before the final heavy melting session. +Process Overview: From Beads to Art +Explore More +Core Features +Home +Pattern Generator +Pattern Library +Showcase +Blog +About Us +Tools +Pixel Art Maker +Pindou Pattern Generator +Image to Pixel +Minecraft Pixel Art +r/place Tool +Guides +Fuse Beads Guide +Hama Beads Guide +Color Charts +Perler Bead Colors +Hama Bead Colors +Artkal Bead Colors +MARD Bead Colors +Nabbi Bead Colors +Ikea Pyssla Bead Colors +More Resources +Cool Perler Bead Designs +(Note: Replace with actual process breakdown imagery) +Author +Mu Li +Craft Educator +Perler and Hama bead enthusiast with 3 years of hands-on experience. Specializes in ironing techniques, large-scale tape method assembly, and cross-brand color chart referencing. +Back to Blog +Pixel Beads Art +Pattern Studio +Explore +Home +Showcase +Pattern Library +Blog +Create +Generator +Pixel Bead Art +Image to Pixel Art +Apps & Support +Apps +Chrome Extension +Android App +iOS App +Help +Contact +Company & Legal +About Us +Privacy Policy +Terms of Service +Featured & Listed +© 2026 • Pixel Beads Art \ No newline at end of file diff --git a/competitor-analysis/raw/blog-ironing-beginners-en.html b/competitor-analysis/raw/blog-ironing-beginners-en.html new file mode 100644 index 0000000..eea11d6 --- /dev/null +++ b/competitor-analysis/raw/blog-ironing-beginners-en.html @@ -0,0 +1,94 @@ +No-Hole Perler Bead Art: Beginner's Roadmap - PixelBeads Blog +
    Back to Blog

    No-Hole Perler Bead Art: Beginner's Roadmap

    Mu Li
    #Tutorial#Ironing#Beginner Guide#No-Hole Technique

    The Beginner's Roadmap to Flawless No-Hole Perler Bead Art

    +

    Welcome to the definitive guide for mastering "No-Hole" Perler bead art. Achieving a professional, smooth-melt finish requires more than just heat; it requires a disciplined understanding of thermal logic and physical mechanics. As your instructor, I will guide you through the precise maneuvers necessary to transform loose beads into a solid, museum-quality masterpiece.

    +

    Getting Started

    +
    01

    Preparation: Your Essential Crafting Toolkit

    Success in bead art is 50% technique and 50% preparation. Having the right tools—and understanding their specific cues—prevents errors before they occur.

    1
    Baking Paper
    Acts as the primary thermal barrier. It must be cleaned of all debris before use to ensure a pristine surface finish.
    2
    Lint Roller
    Used in conjunction with blowing air; it removes pet hair and micro-dust from the baking paper that would otherwise be permanently fused into your design.
    3
    Iron
    Your heat source. Set to the "Cotton" gear. Watch the red indicator light: it will flash during pre-heating and turn off only when the iron has reached the stabilized temperature required for melting.
    4
    Masking Tape (5cm+)
    You must use tape that is 5cm or wider. Narrower tape creates seams and uneven pressure, which will ruin the "no-hole" uniformity.
    5
    Tweezers
    Indispensable for precision repairs and for handling hot, curling pieces.
    6
    Craft Mat
    Provides a heat-stabilized, flat surface to protect your workspace during the high-temperature final ironing phases.
    Professional Safety Note

    Before beginning, ensure your workspace is well-ventilated with windows open. Melting plastic requires consistent airflow for a safe and comfortable crafting environment.

    Once your tools are staged and your environment is secured, we can begin the critical process of orienting your design.

    +

    Step 1: Preparation

    +

    Step 2: Design Correction

    +
    02

    The Logic of the 'Flip': Correcting Your Design Direction

    If you completed your design only to realize you forgot to "mirror" the pattern for the smooth side, do not panic. The Double Board Technique allows you to correct the orientation with zero bead displacement.

      +
    1. Alignment: Place a second, empty pegboard directly on top of your design, ensuring the pegs are perfectly nested.
    2. +
    3. The Table Edge Grip: Slide both boards toward the edge of the table. This allows you to get a firm, two-handed "pinch" on the boards.
    4. +
    5. The Manual Flip: In one steady, confident motion, flip the boards over.
    6. +
    7. Stabilized Landing: Place the boards back down against the table edge. This provides a physical stop that prevents the boards from sliding and shifting the beads upon impact.
    8. +
    9. The Tap and Lift: Gently tap the top board to settle the beads, then lift it slowly and perfectly vertically.
    10. +
    11. Precision Repair: Use your tweezers to return any rogue beads to their proper coordinates.
    12. +

    With your design now oriented correctly, we must secure the structure for the heat transfer.

    +

    Step 3: Masking Tape Application

    +
    03

    The Masking Tape Bridge: Securing Your Masterpiece

    The masking tape phase is where the design is transitioned from the board to a workable state. Precision here is non-negotiable.

      +
    • The One-Shot Rule: Cut your 5cm+ tape to length and align it carefully. You cannot lift or reposition the tape once it touches the beads. Lifting the tape will pull beads out of alignment and destroy your pattern.
    • +
    • The Palm Press: After applying the tape, use the base of your palm to press down firmly across the entire surface. This ensures every individual bead is bonded to the adhesive.
    • +
    • The Board Inversion: Use tweezers to gently pry up the tape edges. To remove the board safely, pick up the entire unit, turn the pegboard upside down, and lift the board away from the beads (rather than peeling the beads off the board).
    • +
    • Edge Management: Fold all excess tape over the back of the design to create a clean, manageable workspace on your craft mat.
    • +

    With the beads secured and the board removed, we move to the most critical phase: the thermal application.

    +

    Step 4: Ironing Process

    +
    04

    Thermal Logic: Mastering the Ironing Process

    A "No-Hole" finish is achieved through controlled heat accumulation, not raw force.

    Sub-Phase A: Surface Purification & Pre-heating

      +
    • The Dual-Clean: Before ironing, blow air over the beads to clear any loose dust. Then, use the lint roller on your baking paper. If you have pets, this step is mandatory to prevent hair from being entombed in the plastic.
    • +
    • Thermal Readiness: Set the iron to "Cotton." Wait until the red light stops flashing and turns off before making contact.
    • +

    Sub-Phase B: Phase 1 (Initial Adhesion)

      +
    • Lay the baking paper over the design.
    • +
    • Vertical Pressing vs. Circling: Use a Vertical Pressing motion only. Do not move the iron in circles yet. Press straight down until you can visually see the beads "sticking" to the translucent paper.
    • +
    • Once the design is fully adhered to the paper, carefully peel away the masking tape.
    • +

    Sub-Phase C: Phase 2 (The "No-Hole" Finish)

      +
    • The No-Hole Technique: Use slow, horizontal gliding or vertical pressure. Warning: Heat Accumulation Risk (Men Dou). Do not leave the iron stationary for too long, or the beads will become over-melted and "stifled," ruining the texture.
    • +
    • The Light Check: Periodically lift the piece and hold it up to a light source. Visible points of light indicate holes that require more heat.
    • +
    • Structural Tension: While targeting specific holes, you must occasionally pass the iron over the finished no-hole areas. These areas must stay warm; if they cool while other parts are being ironed, the piece will warp and curve due to uneven thermal contraction.
    • +
    +

    Step 5: Final Steps

    +
    05

    The Final Set: Cooling and Flattening

    You have reached the final hurdle. The piece is currently a molten, malleable plastic; your patience here determines the final structural integrity.

      +
    1. Shake and Cool: Immediately after turning off the iron, pick up the baking paper and shake it rapidly in the air to begin the cooling process.
    2. +
    3. Tweezer-Assisted Peeling: As the piece cools, it will naturally want to curl (捲起) and will be very hot to the touch. Use your tweezers to press down firmly on the bead art while you carefully peel away the tape and paper.
    4. +
    5. The Flattening Weight: While the piece is still warm and receptive to shaping, place it on a flat surface and cover it with a heavy object (such as a large book). This pressure is what transforms the "melted" plastic into a perfectly flat, professional work of art.
    6. +
    +

    Congratulations on completing your roadmap to a flawless finish. If you have any questions regarding your results or specific bead behaviors, please share them in the comments for further guidance. Happy crafting!

    +
    +

    Beginner FAQ

    +
    Question

    Why use 5cm+ wide masking tape?

    Narrower tape requires overlapping strips. The overlap creates seams and uneven pressure, which ruins the uniform look of a no-hole finish.

    +
    Question

    How do I prevent the piece from curling?

    Curling is caused by uneven cooling. Keep the entire piece warm by occasionally sweeping the iron over finished areas while you focus on specific holes.

    +
    Question

    When should I remove the masking tape?

    Remove it after the "Initial Adhesion" phase, once the beads are clearly visible through and stuck to the baking paper, but before the final heavy melting session.

    +
    +

    Process Overview: From Beads to ArtProcess Overview: From Beads to Art

    +

    Explore More

    +

    Core Features

    + +

    Tools

    + +

    Guides

    + +

    Color Charts

    + +

    More Resources

    +
    \ No newline at end of file diff --git a/competitor-analysis/raw/blog-mirror-guide-en-text.txt b/competitor-analysis/raw/blog-mirror-guide-en-text.txt new file mode 100644 index 0000000..0556f82 --- /dev/null +++ b/competitor-analysis/raw/blog-mirror-guide-en-text.txt @@ -0,0 +1,208 @@ +Why Perler Bead Patterns Need Mirroring and When to Use a Mirrored Pattern - PixelBeads Blog +Pixel Beads Art +Home +Bead Pattern Generator +Bead Art +Image to Pixel Art +Showcase +Theme Beads +Patterns +Apps +Help +English +Back to Blog +Why Perler Bead Patterns Need Mirroring and When to Use a Mirrored Pattern +Date +2026-03-31 +Mu Li +Tutorial +Mirror Pattern +Ironing +Beginner Guide +Why Perler bead patterns often need a mirror flip +One of the most common beginner mistakes in Perler bead crafting is finishing a project and realizing the letters are backward, the arrow points the wrong way, or the character is facing the opposite direction. +That usually does not mean the pattern was designed incorrectly. It happens because of +how Perler beads are ironed +The standard workflow looks like this: +Place the beads on the pegboard +Cover the design with ironing paper or baking paper +Iron from the top to fuse the beads +Let the piece cool and remove it from the board +What you see while placing the beads is the front-facing layout. +What the iron actually affects is the opposite side of the piece. +If the design has direction, the final display side can end up flipped left to right. +In one sentence: +A mirrored Perler bead pattern helps cancel out the left-right reversal caused by ironing from the back side. +Why non-symmetrical designs go wrong +Perler bead art is not the same as printing an image on paper. You build the design bead by bead, then fuse it with heat. If you plan to display the +non-ironed side +, direction matters a lot. +These elements are the most likely to fail without mirroring: +Text or numbers +Arrows +Character poses and facial direction +Animal side profiles +Weapons, tools, hair parts, and accessories +Logos and directional icons +Examples: +HELLO +can end up visually reversed +A right-pointing arrow can become a left-pointing arrow +A character can face the wrong direction +A logo can look incorrect or unprofessional +If the design is perfectly symmetrical, like a heart, snowflake, or simple flower, mirroring is often optional. +But as soon as a design carries direction, +mirroring is the safer default +Click to expand + +Click to expand + +When you definitely need a mirrored pattern +These are the most common cases where a mirrored version is strongly recommended. +1. Any pattern with letters or numbers +This is the most obvious category. +Name signs, holiday greetings, birthday numbers, custom tags, and pixel lettering should almost always be mirrored if the display side needs to read correctly. +Typical examples: +HELLO +MERRY CHRISTMAS +Birthday ages and dates +Social handles +Personalized name tags +2. Characters, faces, or animals with a clear direction +Hair, eyes, pose direction, clothing details, and held items are often asymmetrical. +Without mirroring, the finished piece may face the opposite direction from what you intended. +3. Functional icons and symbols +This includes: +Arrows +Play buttons +Navigation symbols +Hand gestures +Brand marks +These shapes communicate meaning through direction. If they flip, the piece can feel wrong immediately. +4. When you plan to display the non-ironed side +Many crafters prefer the non-ironed side because it usually has: +Sharper bead detail +Stronger pixel texture +Clearer holes and edges +A more classic Perler bead look +If that is going to be your final display side, a mirrored pattern is usually the best option. +When mirroring is usually optional +Not every Perler bead design needs a mirror flip. +You can often skip mirroring for: +Fully symmetrical designs +Simple geometric art +Circular badges +Abstract patterns with no directional meaning +Decorative motifs where left-right orientation does not matter +Examples: +Hearts +Snowflakes +Mandala-style flowers +Checker patterns +Simple border art +If flipping the design would barely change how it looks, mirroring is usually not necessary. +Why many crafters display the non-ironed side +This is one of the biggest reasons mirrored patterns matter. +A finished Perler bead piece usually has two different surfaces: +Ironed side +: smoother, flatter, and more melted +Non-ironed side +: sharper, more textured, and more bead-like +Many crafters choose the +non-ironed side +as the display side because it preserves more detail and keeps the pixel-art feeling stronger. +But that is exactly why the design direction must be considered ahead of time. +If the non-ironed side is the side you want to show, a mirror flip often needs to happen during the design stage. +The best time to generate a mirrored pattern +The easiest time to mirror a Perler bead design is +before you start placing beads +A reliable workflow is: +Finish the original design +Check whether it contains text or directional elements +Generate a horizontal mirror version if needed +Place beads using the mirrored pattern +Iron the piece and confirm the final display direction +If you only realize the problem after placing all the beads, you may still be able to fix it with a second pegboard and a careful flip. +But that is slower, riskier, and much more annoying on larger designs. +For most users, +mirroring early is much easier than correcting later +When to use the one-click mirror tool in a pattern generator +If you are designing with the +Perler Bead Pattern Generator +Image to Pixel +, the one-click mirror option is especially useful when: +Your design includes text or numbers +Character direction matters +You want the non-ironed side to be the final front +You are making a gift, commission, or product for sale +You want to avoid remaking the whole project +For a good pattern generator, the mirror feature should ideally help with three things: +One-click horizontal flip +A final-result preview +A reminder when the design probably needs mirroring +That is why mirrored pattern support is not just a nice extra. It directly prevents real crafting mistakes. +A simple rule beginners can use +If you are not sure whether you should mirror the design, use this quick test: +Quick decision rule +Text: mirror it +Arrow: mirror it +Character facing left or right: mirror it +Logo: mirror it +Perfectly symmetrical design: mirroring is optional +Ask yourself this question +If I flip this design left to right, will it obviously look wrong? +If the answer is yes, you should prepare a mirrored pattern before you start. +Common mistakes +1. “I will just see how it looks after ironing” +That approach often wastes the most time. +If the piece includes text or direction, the result is often not fixable with a small touch-up. +2. Trusting the screen preview only +A normal screen preview shows the design in its drafting state, not necessarily the final display orientation after ironing. +3. Assuming every design must be mirrored +That is also not true. +Symmetrical designs usually do not need the extra step. +4. Remembering too late +The later you notice the issue, the harder it is to correct. +The best habit is to decide before bead placement begins. +Final takeaway +Mirrored Perler bead patterns are not an unnecessary extra step. They solve a real physical problem: +left-right reversal caused by back-side ironing and front-side display +The easiest rule to remember is: +Text or direction: mirror it +Fully symmetrical art: usually optional +Displaying the non-ironed side: strongly consider mirroring +If you want fewer mistakes and cleaner finished pieces, the safest habit is: +Whenever a design is not perfectly symmetrical, check the mirrored preview before placing any beads. +Continue reading +Perler Bead Pattern Generator +Image to Pixel +Complete Perler Bead Ironing Tutorial +Perler Beads Ironing for Beginners +Blog +Author +Mu Li +Craft Educator +Perler and Hama bead enthusiast with 3 years of hands-on experience. Specializes in ironing techniques, large-scale tape method assembly, and cross-brand color chart referencing. +Back to Blog +Pixel Beads Art +Pattern Studio +Explore +Home +Showcase +Pattern Library +Blog +Create +Generator +Pixel Bead Art +Image to Pixel Art +Apps & Support +Apps +Chrome Extension +Android App +iOS App +Help +Contact +Company & Legal +About Us +Privacy Policy +Terms of Service +Featured & Listed +© 2026 • Pixel Beads Art \ No newline at end of file diff --git a/competitor-analysis/raw/blog-mirror-guide-en.html b/competitor-analysis/raw/blog-mirror-guide-en.html new file mode 100644 index 0000000..603a5ba --- /dev/null +++ b/competitor-analysis/raw/blog-mirror-guide-en.html @@ -0,0 +1,196 @@ +Why Perler Bead Patterns Need Mirroring and When to Use a Mirrored Pattern - PixelBeads Blog +
    Back to Blog

    Why Perler Bead Patterns Need Mirroring and When to Use a Mirrored Pattern

    Mu Li
    #Tutorial#Mirror Pattern#Ironing#Beginner Guide

    Why Perler bead patterns often need a mirror flip

    +

    One of the most common beginner mistakes in Perler bead crafting is finishing a project and realizing the letters are backward, the arrow points the wrong way, or the character is facing the opposite direction.

    +

    That usually does not mean the pattern was designed incorrectly. It happens because of how Perler beads are ironed.

    +

    The standard workflow looks like this:

    +
      +
    1. Place the beads on the pegboard
    2. +
    3. Cover the design with ironing paper or baking paper
    4. +
    5. Iron from the top to fuse the beads
    6. +
    7. Let the piece cool and remove it from the board
    8. +
    +

    What you see while placing the beads is the front-facing layout.
    +What the iron actually affects is the opposite side of the piece.
    +If the design has direction, the final display side can end up flipped left to right.

    +

    In one sentence:

    +
    +

    A mirrored Perler bead pattern helps cancel out the left-right reversal caused by ironing from the back side.

    +
    +
    +

    Why non-symmetrical designs go wrong

    +

    Perler bead art is not the same as printing an image on paper. You build the design bead by bead, then fuse it with heat. If you plan to display the non-ironed side, direction matters a lot.

    +

    These elements are the most likely to fail without mirroring:

    +
      +
    • Text or numbers
    • +
    • Arrows
    • +
    • Character poses and facial direction
    • +
    • Animal side profiles
    • +
    • Weapons, tools, hair parts, and accessories
    • +
    • Logos and directional icons
    • +
    +

    Examples:

    +
      +
    • HELLO can end up visually reversed
    • +
    • A right-pointing arrow can become a left-pointing arrow
    • +
    • A character can face the wrong direction
    • +
    • A logo can look incorrect or unprofessional
    • +
    +

    If the design is perfectly symmetrical, like a heart, snowflake, or simple flower, mirroring is often optional.
    +But as soon as a design carries direction, mirroring is the safer default.

    +
    +
    +

    When you definitely need a mirrored pattern

    +

    These are the most common cases where a mirrored version is strongly recommended.

    +

    1. Any pattern with letters or numbers

    +

    This is the most obvious category.
    +Name signs, holiday greetings, birthday numbers, custom tags, and pixel lettering should almost always be mirrored if the display side needs to read correctly.

    +

    Typical examples:

    +
      +
    • HELLO
    • +
    • MERRY CHRISTMAS
    • +
    • Birthday ages and dates
    • +
    • Social handles
    • +
    • Personalized name tags
    • +
    +

    2. Characters, faces, or animals with a clear direction

    +

    Hair, eyes, pose direction, clothing details, and held items are often asymmetrical.
    +Without mirroring, the finished piece may face the opposite direction from what you intended.

    +

    3. Functional icons and symbols

    +

    This includes:

    +
      +
    • Arrows
    • +
    • Play buttons
    • +
    • Navigation symbols
    • +
    • Hand gestures
    • +
    • Brand marks
    • +
    +

    These shapes communicate meaning through direction. If they flip, the piece can feel wrong immediately.

    +

    4. When you plan to display the non-ironed side

    +

    Many crafters prefer the non-ironed side because it usually has:

    +
      +
    • Sharper bead detail
    • +
    • Stronger pixel texture
    • +
    • Clearer holes and edges
    • +
    • A more classic Perler bead look
    • +
    +

    If that is going to be your final display side, a mirrored pattern is usually the best option.

    +
    +

    When mirroring is usually optional

    +

    Not every Perler bead design needs a mirror flip.

    +

    You can often skip mirroring for:

    +
      +
    • Fully symmetrical designs
    • +
    • Simple geometric art
    • +
    • Circular badges
    • +
    • Abstract patterns with no directional meaning
    • +
    • Decorative motifs where left-right orientation does not matter
    • +
    +

    Examples:

    +
      +
    • Hearts
    • +
    • Snowflakes
    • +
    • Mandala-style flowers
    • +
    • Checker patterns
    • +
    • Simple border art
    • +
    +

    If flipping the design would barely change how it looks, mirroring is usually not necessary.

    +
    +

    Why many crafters display the non-ironed side

    +

    This is one of the biggest reasons mirrored patterns matter.

    +

    A finished Perler bead piece usually has two different surfaces:

    +
      +
    • Ironed side: smoother, flatter, and more melted
    • +
    • Non-ironed side: sharper, more textured, and more bead-like
    • +
    +

    Many crafters choose the non-ironed side as the display side because it preserves more detail and keeps the pixel-art feeling stronger.

    +

    But that is exactly why the design direction must be considered ahead of time.
    +If the non-ironed side is the side you want to show, a mirror flip often needs to happen during the design stage.

    +
    +

    The best time to generate a mirrored pattern

    +

    The easiest time to mirror a Perler bead design is before you start placing beads.

    +

    A reliable workflow is:

    +
      +
    1. Finish the original design
    2. +
    3. Check whether it contains text or directional elements
    4. +
    5. Generate a horizontal mirror version if needed
    6. +
    7. Place beads using the mirrored pattern
    8. +
    9. Iron the piece and confirm the final display direction
    10. +
    +

    If you only realize the problem after placing all the beads, you may still be able to fix it with a second pegboard and a careful flip.
    +But that is slower, riskier, and much more annoying on larger designs.

    +

    For most users, mirroring early is much easier than correcting later.

    +
    +

    When to use the one-click mirror tool in a pattern generator

    +

    If you are designing with the Perler Bead Pattern Generator or Image to Pixel, the one-click mirror option is especially useful when:

    +
      +
    • Your design includes text or numbers
    • +
    • Character direction matters
    • +
    • You want the non-ironed side to be the final front
    • +
    • You are making a gift, commission, or product for sale
    • +
    • You want to avoid remaking the whole project
    • +
    +

    For a good pattern generator, the mirror feature should ideally help with three things:

    +
      +
    • One-click horizontal flip
    • +
    • A final-result preview
    • +
    • A reminder when the design probably needs mirroring
    • +
    +

    That is why mirrored pattern support is not just a nice extra. It directly prevents real crafting mistakes.

    +
    +

    A simple rule beginners can use

    +

    If you are not sure whether you should mirror the design, use this quick test:

    +

    Quick decision rule

    +
      +
    • Text: mirror it
    • +
    • Arrow: mirror it
    • +
    • Character facing left or right: mirror it
    • +
    • Logo: mirror it
    • +
    • Perfectly symmetrical design: mirroring is optional
    • +
    +

    Ask yourself this question

    +
    +

    If I flip this design left to right, will it obviously look wrong?

    +
    +

    If the answer is yes, you should prepare a mirrored pattern before you start.

    +
    +

    Common mistakes

    +

    1. “I will just see how it looks after ironing”

    +

    That approach often wastes the most time.
    +If the piece includes text or direction, the result is often not fixable with a small touch-up.

    +

    2. Trusting the screen preview only

    +

    A normal screen preview shows the design in its drafting state, not necessarily the final display orientation after ironing.

    +

    3. Assuming every design must be mirrored

    +

    That is also not true.
    +Symmetrical designs usually do not need the extra step.

    +

    4. Remembering too late

    +

    The later you notice the issue, the harder it is to correct.
    +The best habit is to decide before bead placement begins.

    +
    +

    Final takeaway

    +

    Mirrored Perler bead patterns are not an unnecessary extra step. They solve a real physical problem: left-right reversal caused by back-side ironing and front-side display.

    +

    The easiest rule to remember is:

    +
      +
    • Text or direction: mirror it
    • +
    • Fully symmetrical art: usually optional
    • +
    • Displaying the non-ironed side: strongly consider mirroring
    • +
    +

    If you want fewer mistakes and cleaner finished pieces, the safest habit is:

    +
    +

    Whenever a design is not perfectly symmetrical, check the mirrored preview before placing any beads.

    +
    +

    Continue reading

    +
    \ No newline at end of file diff --git a/competitor-analysis/raw/contact-en.html b/competitor-analysis/raw/contact-en.html new file mode 100644 index 0000000..0c85212 --- /dev/null +++ b/competitor-analysis/raw/contact-en.html @@ -0,0 +1,2 @@ +Contact Us | PixelBeads - Get in Touch +

    Contact Us

    We'd love to hear from you! Whether you have questions, feedback, suggestions, or need support, we're here to help. Reach out to us through any of the methods below.

    Email Us

    help@pixel-beads.com

    Send us an email and we'll get back to you as soon as possible.

    Response Time

    We typically respond to emails within 24-48 hours during business days. For urgent matters, please mark your email as urgent and we'll prioritize it.

    Send Us a Message

    Prefer to send a message directly? Click the button below to open your email client with a pre-filled message.

    This will open your default email client. If you prefer, you can also copy our email address above and send us a message directly.

    Open Email Client

    Need Help?

    Before contacting us, you might find the answer to your question in our FAQ section. Check out our help page for common questions and troubleshooting guides.

    Visit Help Center
    \ No newline at end of file diff --git a/competitor-analysis/raw/help-bead-art-en-text.txt b/competitor-analysis/raw/help-bead-art-en-text.txt new file mode 100644 index 0000000..8a65a27 --- /dev/null +++ b/competitor-analysis/raw/help-bead-art-en-text.txt @@ -0,0 +1,357 @@ +Complete Pixel Beads Art canvas guide +Pixel Beads Art +Home +Bead Pattern Generator +Bead Art +Image to Pixel Art +Showcase +Theme Beads +Patterns +Apps +Help +English +Pattern generator guide +Bead art canvas guide +Common questions +Start blank or trace a reference +Complete Pixel Beads Art canvas guide +Set up a board, choose real MARD colors, trace a reference, check materials, and export PNG or PDF with a complete explanation of every canvas feature. +Automatic local drafts +14 complete chapters +Desktop and mobile +Open the bead art canvas +Choose a starting method and restore drafts +Set the canvas and board composition +Set the MARD set, inventory, and working palette +Upload, crop, and classify a reference +Use automatic grid calibration and color advice +Understand the editor and local saving +Draw, erase, and navigate the canvas +Choose codes, working colors, and source samples +Move, scale, and calibrate the reference +Resize the canvas, boards, and grid +Use symmetry and layers to inspect artwork +Check used colors, inventory, and shortages +Export a PNG or PDF pattern +Fix draft, reference, and export problems +In this guide +Choose a starting method and restore drafts +Set the canvas and board composition +Set the MARD set, inventory, and working palette +Upload, crop, and classify a reference +Use automatic grid calibration and color advice +Understand the editor and local saving +Draw, erase, and navigate the canvas +Choose codes, working colors, and source samples +Move, scale, and calibrate the reference +Resize the canvas, boards, and grid +Use symmetry and layers to inspect artwork +Check used colors, inventory, and shortages +Export a PNG or PDF pattern +Fix draft, reference, and export problems +Step 1 of 14 +Choose a starting method and restore drafts +Start with an empty board, trace an image, or continue the artwork saved in this browser. +Do this +Choose Blank canvas or Trace a reference. +When a local draft is found, review its size before resuming or starting over. +When importing from the generator, review the summary before replacing current work. +What each control does +Blank canvas +Creates an empty bead board without a reference. +Trace a reference +Adds an image as a separate guide layer without converting it automatically. +Resume draft +Restores the locally saved canvas, colors, reference, and material settings. +Import pattern +Accepts a generator matrix and asks before replacing conflicting work. +1 Start blank · 2 trace a reference · 3 decide whether to continue a local draft. +Expected result +A starting method is selected without accidentally overwriting existing artwork. +Step 2 of 14 +Set the canvas and board composition +Build the canvas from real 52×52 standard boards or use dimensions detected from pixel-grid artwork. +Do this +Review the final canvas width and height. +Set the number of boards across and down. +Verify the total board count, cell dimensions, and seam layout. +What each control does +Standard board +Each board contributes 52×52 cells. +Board columns and rows +Controls horizontal and vertical board composition. +Board seams +Records physical boundaries for the canvas and PDF. +Detected dimensions +Uses original rows and columns when pixel-grid detection succeeds. +1 Review final size · 2 set board columns and rows · 3 verify board count and seams. +Expected result +Canvas dimensions match the physical board plan or source pixel grid. +Step 3 of 14 +Set the MARD set, inventory, and working palette +Limit available codes and enter owned quantities so shortages can be calculated while drawing. +Do this +Choose the MARD set you own. +Enter a default quantity per color and choose whether to restrict colors to that set. +Optionally prepare a working palette before opening the canvas. +What each control does +MARD set +Selects a retail set or all available MARD colors. +Set restriction +Allows only codes actually included in the selected set. +Default inventory +Sets one owned quantity for every color. +Working palette +Stores project colors for fast selection and material management. +1 Choose a MARD set · 2 set inventory and restriction · 3 prepare working colors. +Expected result +The project uses obtainable color codes and can report shortages. +Step 4 of 14 +Upload, crop, and classify a reference +Photos and already-gridded pixel artwork use different reference preparation and alignment behavior. +Do this +Upload a JPG, PNG, or WebP no larger than 10 MB. +Choose Photo or Pixel pattern. +Crop the subject, adjust its size, and apply the reference. +What each control does +Reference upload +Reads a local image as a guide layer without publishing it. +Crop +Keeps the useful subject and controls its scale. +Photo +Fits continuous images without a regular source grid. +Pixel pattern +Starts detection of rows, columns, cell size, and offset. +1 Upload a reference · 2 choose Photo or Pixel pattern · 3 crop and apply it. +Expected result +The setup shows a correctly cropped and classified reference image. +Step 5 of 14 +Use automatic grid calibration and color advice +Align a pixel pattern automatically and find close colors from the active MARD palette. +Do this +Review the detected rows, columns, and alignment. +Review color advice and ignore the background when useful. +Add selected suggestions and alternatives to the working palette. +What each control does +Automatic calibration +Detects cell size, dimensions, and grid offset. +Color advice +Samples the reference and suggests real bead codes. +Ignore background +Reduces the effect of broad background regions. +Reanalyze +Refreshes stale results after board or palette changes. +1 Review detected dimensions · 2 adjust background analysis · 3 apply suggested colors. +Expected result +The source grid is aligned and a useful MARD working palette is ready. +Step 6 of 14 +Understand the editor and local saving +Desktop uses floating panels; mobile uses bottom tools and a side sheet. Artwork is saved locally automatically. +Do this +Locate undo, size, move, zoom, save status, and export in the top bar. +Open and move the desktop panels from the left rail. +On mobile, use the bottom tools, panel sheet, export, and quick colors. +What each control does +Automatic save +Writes the project to browser IndexedDB after edits settle. +Save status +Reports saving, saved, or retry save. +Desktop panels +Opens tools, symmetry, materials, layers, reference, and grid. +Mobile navigation +Provides brush, eraser, eyedropper, move, panels, and export. +1 Open task panels · 2 edit on the center canvas · 3 check local save and export. +Expected result +Every editing area is identifiable and the draft reports that it is saved locally. +Step 7 of 14 +Draw, erase, and navigate the canvas +Drawing tools change the bead matrix; move and zoom only change how it is viewed. +Do this +Choose Brush, Eraser, or Eyedropper. +Choose Single cell or Rectangle, then click or drag on the canvas. +Use move mode, zoom, undo, and redo to navigate and correct work. +What each control does +Brush +Adds one bead or a continuous stroke. +Eraser +Clears cells, strokes, or rectangles. +Eyedropper +Selects an existing code without changing the cell. +Move and zoom +Navigates a large canvas without drawing. +Single and rectangle +Controls freehand or block editing. +Undo and redo +Restores committed drawing and setting changes. +Tracing reference +Artwork with reference hidden +The reference only guides placement. Hide it after drawing to inspect the actual bead cells, codes, and outline. +1 Choose an editing tool · 2 choose a fill mode · 3 draw or switch to move mode. +Expected result +A reversible bead stroke is complete and the large canvas can be navigated safely. +Step 8 of 14 +Choose codes, working colors, and source samples +Quick colors handle frequent switches, the full palette supports search, and source sampling helps match a reference. +Do this +Choose common codes from the working palette or mobile quick colors. +Open the full palette and filter by code, name, series, or color family. +Sample the reference and apply one of the nearest suggested codes. +What each control does +Quick colors +Shows up to eight recent, used, and working-palette colors. +Full palette +Search every code allowed by the selected set. Select an active color again to remove it from the project palette without deleting placed beads. +Color grouping +Browses by code series or color family. +Pick from source +Suggests three nearby colors without editing automatically. +1 Search by code or color · 2 filter by series or color family · 3 apply the project palette. +Expected result +The brush uses the intended MARD code and common colors are ready for reuse. +Step 9 of 14 +Move, scale, and calibrate the reference +The reference is independent from the artwork and can be positioned, scaled, hidden, locked, or calibrated. +Do this +Enter Move reference, drag it into place, then finish positioning. +Adjust scale, visibility, and opacity. +For a misaligned pixel grid, edit rows, columns, cell size, and offsets manually. +What each control does +Move reference +Moves only the guide layer, not artwork or canvas view. +Scale and lock +Resizes the guide and exits positioning to prevent accidental moves. +Manual calibration +Adjusts dimensions, cell size, and X/Y grid offset. +Replace or delete +Changes the guide while preserving artwork, with confirmation before deletion. +1 Position the reference · 2 adjust scale and display · 3 open manual calibration if needed. +Expected result +The reference aligns with the bead grid and remains fixed during drawing. +Step 10 of 14 +Resize the canvas, boards, and grid +Change dimensions while choosing how existing artwork is anchored, then configure numbers and guide lines. +Do this +Choose Free grid or Standard boards. +Set the new size and one of nine artwork anchors. +Review clipping and reference refit, then configure numbers and guide lines. +What each control does +Free grid +Accepts custom width and height within the supported range. +Standard boards +Resizes in 52×52 units and keeps board seams. +Anchor and clipping +Places old artwork and warns before beads are removed. +Numbers and lines +Controls coordinates, intervals, start values, and colors. +1 Choose a size mode · 2 set size and anchor · 3 review clipping before applying. +Expected result +The canvas matches the physical board plan without unexpected clipping. +Step 11 of 14 +Use symmetry and layers to inspect artwork +Symmetry mirrors future edits, while layers change the editor view without deleting data. +Do this +Enable vertical or horizontal symmetry and center or place the axis. +Test the mirror with brush, eraser, or rectangle edits. +Control drawing, reference, and board visibility and opacity separately. +What each control does +Vertical and horizontal symmetry +Mirrors later edits around the selected direction. +Axis position +Centers automatically or can be dragged on the canvas. +Drawing and reference layers +Toggles and fades artwork and the guide independently. +Board layer +Hides the grid board to inspect color and silhouette. +1 Set symmetry and axis · 2 verify mirrored edits · 3 adjust the three layers. +Expected result +Mirrored edits follow the chosen axis and layer combinations reveal the structure clearly. +Step 12 of 14 +Check used colors, inventory, and shortages +The Materials panel calculates how many beads are needed, owned, and missing for every used code. +Do this +Review actual codes and quantities under Used. +Override the owned quantity for individual colors when needed. +Switch to Shortage to focus on colors that need replenishment. +What each control does +Used +Shows codes actually present and their required count. +Owned quantity +Uses the default inventory or a per-color override. +Shortage +Calculates and highlights demand above inventory. +Shortage warning +Reports how many colors are short on the canvas and status bar. +1 Review used codes · 2 update owned quantities · 3 filter the shortage list. +Expected result +A per-code material list and replenishment list are ready. +Step 13 of 14 +Export a PNG or PDF pattern +Export uses the bead matrix, not the reference. PDF also includes codes, materials, and board-seam information. +Do this +Hide the reference and inspect the final artwork. +Choose PNG for an image or PDF for a printable chart. +Wait for generation and download to finish before trying again. +What each control does +PNG +Creates a gridded image for viewing and sharing. +PDF +Creates a printable chart with size, codes, and materials. +Seams and statistics +Includes standard-board boundaries and actual usage when available. +Private download +Saves to the device without publishing to the gallery. +1 Open Export · 2 choose PNG · 3 or choose a printable PDF. +Expected result +The browser downloads a PNG or PDF containing the current artwork and material data. +Step 14 of 14 +Fix draft, reference, and export problems +Trace issues through file validation, calibration, clipping, inventory, and local save status. +Do this +Read the current warning before confirming replace, clipping, or exit. +Return to the earliest failed step and reclassify, recalibrate, adjust inventory, or retry save. +If export fails, keep the draft open, allow downloads, and retry another format. +What each control does +Upload failure +Use JPG, PNG, or WebP no larger than 10 MB. +Reference misalignment +Check the image type, then use automatic or manual calibration. +Save or clipping warning +Retry local save and review clipped beads and the anchor. +Export failure +Allow downloads, wait for the current task, then retry the other format. +1 Read the warning · 2 adjust or retry · 3 continue only after the impact is clear. +Expected result +The failed stage can be recovered without replacing artwork or losing the draft. +Start placing beads +Set up your board and materials, then begin drawing +The canvas stores the artwork, reference, inventory, and view settings in this browser. Finish a small section and verify the physical color codes before expanding a large project. +Open the bead art canvas +Still need help? +Tell us what you’re trying to do and at which step the problem occurs. +Email us +help@pixel-beads.com +Contact Us +Pixel Beads Art +Pattern Studio +Explore +Home +Showcase +Pattern Library +Blog +Create +Generator +Pixel Bead Art +Image to Pixel Art +Apps & Support +Apps +Chrome Extension +Android App +iOS App +Help +Contact +Company & Legal +About Us +Privacy Policy +Terms of Service +Featured & Listed +© 2026 • Pixel Beads Art \ No newline at end of file diff --git a/competitor-analysis/raw/help-bead-art-en.html b/competitor-analysis/raw/help-bead-art-en.html new file mode 100644 index 0000000..4182a0c --- /dev/null +++ b/competitor-analysis/raw/help-bead-art-en.html @@ -0,0 +1,2 @@ +Complete Pixel Beads Art canvas guide +

    Start blank or trace a reference

    Complete Pixel Beads Art canvas guide

    Set up a board, choose real MARD colors, trace a reference, check materials, and export PNG or PDF with a complete explanation of every canvas feature.

    Automatic local drafts14 complete chaptersDesktop and mobile
    Open the bead art canvas

    Step 1 of 14

    Choose a starting method and restore drafts

    Start with an empty board, trace an image, or continue the artwork saved in this browser.

    Do this

    1. 1Choose Blank canvas or Trace a reference.
    2. 2When a local draft is found, review its size before resuming or starting over.
    3. 3When importing from the generator, review the summary before replacing current work.

    What each control does

    Blank canvas

    Creates an empty bead board without a reference.

    Trace a reference

    Adds an image as a separate guide layer without converting it automatically.

    Resume draft

    Restores the locally saved canvas, colors, reference, and material settings.

    Import pattern

    Accepts a generator matrix and asks before replacing conflicting work.

    1 Start blank · 2 trace a reference · 3 decide whether to continue a local draft.

    Expected result

    A starting method is selected without accidentally overwriting existing artwork.

    Step 2 of 14

    Set the canvas and board composition

    Build the canvas from real 52×52 standard boards or use dimensions detected from pixel-grid artwork.

    Do this

    1. 1Review the final canvas width and height.
    2. 2Set the number of boards across and down.
    3. 3Verify the total board count, cell dimensions, and seam layout.

    What each control does

    Standard board

    Each board contributes 52×52 cells.

    Board columns and rows

    Controls horizontal and vertical board composition.

    Board seams

    Records physical boundaries for the canvas and PDF.

    Detected dimensions

    Uses original rows and columns when pixel-grid detection succeeds.

    1 Review final size · 2 set board columns and rows · 3 verify board count and seams.

    Expected result

    Canvas dimensions match the physical board plan or source pixel grid.

    Step 3 of 14

    Set the MARD set, inventory, and working palette

    Limit available codes and enter owned quantities so shortages can be calculated while drawing.

    Do this

    1. 1Choose the MARD set you own.
    2. 2Enter a default quantity per color and choose whether to restrict colors to that set.
    3. 3Optionally prepare a working palette before opening the canvas.

    What each control does

    MARD set

    Selects a retail set or all available MARD colors.

    Set restriction

    Allows only codes actually included in the selected set.

    Default inventory

    Sets one owned quantity for every color.

    Working palette

    Stores project colors for fast selection and material management.

    1 Choose a MARD set · 2 set inventory and restriction · 3 prepare working colors.

    Expected result

    The project uses obtainable color codes and can report shortages.

    Step 4 of 14

    Upload, crop, and classify a reference

    Photos and already-gridded pixel artwork use different reference preparation and alignment behavior.

    Do this

    1. 1Upload a JPG, PNG, or WebP no larger than 10 MB.
    2. 2Choose Photo or Pixel pattern.
    3. 3Crop the subject, adjust its size, and apply the reference.

    What each control does

    Reference upload

    Reads a local image as a guide layer without publishing it.

    Crop

    Keeps the useful subject and controls its scale.

    Photo

    Fits continuous images without a regular source grid.

    Pixel pattern

    Starts detection of rows, columns, cell size, and offset.

    1 Upload a reference · 2 choose Photo or Pixel pattern · 3 crop and apply it.

    Expected result

    The setup shows a correctly cropped and classified reference image.

    Step 5 of 14

    Use automatic grid calibration and color advice

    Align a pixel pattern automatically and find close colors from the active MARD palette.

    Do this

    1. 1Review the detected rows, columns, and alignment.
    2. 2Review color advice and ignore the background when useful.
    3. 3Add selected suggestions and alternatives to the working palette.

    What each control does

    Automatic calibration

    Detects cell size, dimensions, and grid offset.

    Color advice

    Samples the reference and suggests real bead codes.

    Ignore background

    Reduces the effect of broad background regions.

    Reanalyze

    Refreshes stale results after board or palette changes.

    1 Review detected dimensions · 2 adjust background analysis · 3 apply suggested colors.

    Expected result

    The source grid is aligned and a useful MARD working palette is ready.

    Step 6 of 14

    Understand the editor and local saving

    Desktop uses floating panels; mobile uses bottom tools and a side sheet. Artwork is saved locally automatically.

    Do this

    1. 1Locate undo, size, move, zoom, save status, and export in the top bar.
    2. 2Open and move the desktop panels from the left rail.
    3. 3On mobile, use the bottom tools, panel sheet, export, and quick colors.

    What each control does

    Automatic save

    Writes the project to browser IndexedDB after edits settle.

    Save status

    Reports saving, saved, or retry save.

    Desktop panels

    Opens tools, symmetry, materials, layers, reference, and grid.

    Mobile navigation

    Provides brush, eraser, eyedropper, move, panels, and export.

    1 Open task panels · 2 edit on the center canvas · 3 check local save and export.

    Expected result

    Every editing area is identifiable and the draft reports that it is saved locally.

    Step 7 of 14

    Draw, erase, and navigate the canvas

    Drawing tools change the bead matrix; move and zoom only change how it is viewed.

    Do this

    1. 1Choose Brush, Eraser, or Eyedropper.
    2. 2Choose Single cell or Rectangle, then click or drag on the canvas.
    3. 3Use move mode, zoom, undo, and redo to navigate and correct work.

    What each control does

    Brush

    Adds one bead or a continuous stroke.

    Eraser

    Clears cells, strokes, or rectangles.

    Eyedropper

    Selects an existing code without changing the cell.

    Move and zoom

    Navigates a large canvas without drawing.

    Single and rectangle

    Controls freehand or block editing.

    Undo and redo

    Restores committed drawing and setting changes.

    Tracing reference01
    Gingerbread reference image used for the bead tracing demonstration
    Artwork with reference hidden02
    A manually drawn bead sample with the reference image hidden
    The reference only guides placement. Hide it after drawing to inspect the actual bead cells, codes, and outline.
    1 Choose an editing tool · 2 choose a fill mode · 3 draw or switch to move mode.

    Expected result

    A reversible bead stroke is complete and the large canvas can be navigated safely.

    Step 8 of 14

    Choose codes, working colors, and source samples

    Quick colors handle frequent switches, the full palette supports search, and source sampling helps match a reference.

    Do this

    1. 1Choose common codes from the working palette or mobile quick colors.
    2. 2Open the full palette and filter by code, name, series, or color family.
    3. 3Sample the reference and apply one of the nearest suggested codes.

    What each control does

    Quick colors

    Shows up to eight recent, used, and working-palette colors.

    Full palette

    Search every code allowed by the selected set. Select an active color again to remove it from the project palette without deleting placed beads.

    Color grouping

    Browses by code series or color family.

    Pick from source

    Suggests three nearby colors without editing automatically.

    1 Search by code or color · 2 filter by series or color family · 3 apply the project palette.

    Expected result

    The brush uses the intended MARD code and common colors are ready for reuse.

    Step 9 of 14

    Move, scale, and calibrate the reference

    The reference is independent from the artwork and can be positioned, scaled, hidden, locked, or calibrated.

    Do this

    1. 1Enter Move reference, drag it into place, then finish positioning.
    2. 2Adjust scale, visibility, and opacity.
    3. 3For a misaligned pixel grid, edit rows, columns, cell size, and offsets manually.

    What each control does

    Move reference

    Moves only the guide layer, not artwork or canvas view.

    Scale and lock

    Resizes the guide and exits positioning to prevent accidental moves.

    Manual calibration

    Adjusts dimensions, cell size, and X/Y grid offset.

    Replace or delete

    Changes the guide while preserving artwork, with confirmation before deletion.

    1 Position the reference · 2 adjust scale and display · 3 open manual calibration if needed.

    Expected result

    The reference aligns with the bead grid and remains fixed during drawing.

    Step 10 of 14

    Resize the canvas, boards, and grid

    Change dimensions while choosing how existing artwork is anchored, then configure numbers and guide lines.

    Do this

    1. 1Choose Free grid or Standard boards.
    2. 2Set the new size and one of nine artwork anchors.
    3. 3Review clipping and reference refit, then configure numbers and guide lines.

    What each control does

    Free grid

    Accepts custom width and height within the supported range.

    Standard boards

    Resizes in 52×52 units and keeps board seams.

    Anchor and clipping

    Places old artwork and warns before beads are removed.

    Numbers and lines

    Controls coordinates, intervals, start values, and colors.

    1 Choose a size mode · 2 set size and anchor · 3 review clipping before applying.

    Expected result

    The canvas matches the physical board plan without unexpected clipping.

    Step 11 of 14

    Use symmetry and layers to inspect artwork

    Symmetry mirrors future edits, while layers change the editor view without deleting data.

    Do this

    1. 1Enable vertical or horizontal symmetry and center or place the axis.
    2. 2Test the mirror with brush, eraser, or rectangle edits.
    3. 3Control drawing, reference, and board visibility and opacity separately.

    What each control does

    Vertical and horizontal symmetry

    Mirrors later edits around the selected direction.

    Axis position

    Centers automatically or can be dragged on the canvas.

    Drawing and reference layers

    Toggles and fades artwork and the guide independently.

    Board layer

    Hides the grid board to inspect color and silhouette.

    1 Set symmetry and axis · 2 verify mirrored edits · 3 adjust the three layers.

    Expected result

    Mirrored edits follow the chosen axis and layer combinations reveal the structure clearly.

    Step 12 of 14

    Check used colors, inventory, and shortages

    The Materials panel calculates how many beads are needed, owned, and missing for every used code.

    Do this

    1. 1Review actual codes and quantities under Used.
    2. 2Override the owned quantity for individual colors when needed.
    3. 3Switch to Shortage to focus on colors that need replenishment.

    What each control does

    Used

    Shows codes actually present and their required count.

    Owned quantity

    Uses the default inventory or a per-color override.

    Shortage

    Calculates and highlights demand above inventory.

    Shortage warning

    Reports how many colors are short on the canvas and status bar.

    1 Review used codes · 2 update owned quantities · 3 filter the shortage list.

    Expected result

    A per-code material list and replenishment list are ready.

    Step 13 of 14

    Export a PNG or PDF pattern

    Export uses the bead matrix, not the reference. PDF also includes codes, materials, and board-seam information.

    Do this

    1. 1Hide the reference and inspect the final artwork.
    2. 2Choose PNG for an image or PDF for a printable chart.
    3. 3Wait for generation and download to finish before trying again.

    What each control does

    PNG

    Creates a gridded image for viewing and sharing.

    PDF

    Creates a printable chart with size, codes, and materials.

    Seams and statistics

    Includes standard-board boundaries and actual usage when available.

    Private download

    Saves to the device without publishing to the gallery.

    1 Open Export · 2 choose PNG · 3 or choose a printable PDF.

    Expected result

    The browser downloads a PNG or PDF containing the current artwork and material data.

    Step 14 of 14

    Fix draft, reference, and export problems

    Trace issues through file validation, calibration, clipping, inventory, and local save status.

    Do this

    1. 1Read the current warning before confirming replace, clipping, or exit.
    2. 2Return to the earliest failed step and reclassify, recalibrate, adjust inventory, or retry save.
    3. 3If export fails, keep the draft open, allow downloads, and retry another format.

    What each control does

    Upload failure

    Use JPG, PNG, or WebP no larger than 10 MB.

    Reference misalignment

    Check the image type, then use automatic or manual calibration.

    Save or clipping warning

    Retry local save and review clipped beads and the anchor.

    Export failure

    Allow downloads, wait for the current task, then retry the other format.

    1 Read the warning · 2 adjust or retry · 3 continue only after the impact is clear.

    Expected result

    The failed stage can be recovered without replacing artwork or losing the draft.

    Start placing beads

    Set up your board and materials, then begin drawing

    The canvas stores the artwork, reference, inventory, and view settings in this browser. Finish a small section and verify the physical color codes before expanding a large project.

    Open the bead art canvas

    Still need help?

    Tell us what you’re trying to do and at which step the problem occurs.

    Email ushelp@pixel-beads.comContact Us
    \ No newline at end of file diff --git a/competitor-analysis/raw/help-generator-en-text.txt b/competitor-analysis/raw/help-generator-en-text.txt new file mode 100644 index 0000000..5be3ce5 --- /dev/null +++ b/competitor-analysis/raw/help-generator-en-text.txt @@ -0,0 +1,355 @@ +Complete Perler Bead Pattern Generator guide +Pixel Beads Art +Home +Bead Pattern Generator +Bead Art +Image to Pixel Art +Showcase +Theme Beads +Patterns +Apps +Help +English +Pattern generator guide +Bead art canvas guide +Common questions +From source image to printable pattern +Complete Perler Bead Pattern Generator guide +Turn one image into a printable Perler bead pattern. Follow upload, crop, generation, editing, bead counts, and PNG or PDF export. +No account required +10 guided chapters +Desktop and mobile +Open the pattern generator +Understand the workspace +Upload or import a source image +Choose the image type and crop +Generate and refine the pattern settings +Inspect and navigate the canvas +Edit cells and choose colors +Use color cleanup, symmetry, and layers +Check bead codes and quantities +Download or publish the finished pattern +Fix common generation and export problems +In this guide +Understand the workspace +Upload or import a source image +Choose the image type and crop +Generate and refine the pattern settings +Inspect and navigate the canvas +Edit cells and choose colors +Use color cleanup, symmetry, and layers +Check bead codes and quantities +Download or publish the finished pattern +Fix common generation and export problems +Step 1 of 10 +Understand the workspace +The generator keeps the artwork in the center and moves project controls into focused panels. Desktop panels can be opened independently; mobile controls open from the bottom navigation. +Do this +Locate the panel rail on desktop or the bottom navigation on mobile. +Open Generate, Edit tools, Layers, Symmetry, Beads, and Export once to learn where each task lives. +Return to the center canvas; this is where you zoom, pan, inspect, and edit the pattern. +What each control does +Desktop panel rail +Opens Source, Edit tools, Layers, Generate, Symmetry, Beads, and Export as separate floating panels. +Floating panels +Drag a panel by its title bar, bring it to the front by interacting with it, or minimize it without losing settings. +Mobile navigation +Opens six task sheets: Edit tools, Generate, Layers, Symmetry, Beads, and Export. +Canvas workspace +Shows the editable bead grid and accepts painting, erasing, color picking, zooming, panning, and symmetry placement. +Quick colors +Keeps recent and currently used bead colors close to the canvas so repeated editing takes fewer taps. +1 Panel rail · 2 Editable canvas · 3 Floating panels. On mobile, the same responsibilities move to the bottom navigation. +Expected result +You can point to the panel used for generating, editing, checking bead counts, and exporting without searching through the whole page. +Step 2 of 10 +Upload or import a source image +Start with a high-contrast image whose subject is easy to separate from the background. The generator accepts local files and images handed off by the Pixel Beads Chrome extension. +Do this +Select Upload image and choose a JPG, JPEG, PNG, or WebP file no larger than 10 MB. +If the image came from the Chrome extension, review the source and screenshot warning before continuing. +Use Replace image later if you want to restart with a different source. +What each control does +Upload image +Reads a supported local image and opens the crop workflow; conversion does not require an account. +Chrome extension import +Receives an image selected on another web page, validates it, then sends it into the same crop workflow. +Screenshot warning +Explains when an extension import is only a visible-page capture, so you can inspect sharpness and missing edges. +Replace image +Starts a new crop and generation flow with another source image. +Draw manually +Leaves the automatic generator and opens the blank Perler bead art editor for drawing from an empty board. +1 Upload a supported image · 2 Switch to the manual editor · 3 Confirm the file requirements before choosing a source. +Expected result +The crop dialog opens with the selected image visible and no upload-format error. +Step 3 of 10 +Choose the image type and crop +Tell the generator whether the source is a photo or an existing pixel grid, then keep only the area needed for the finished bead pattern. +Do this +Choose Photo for normal artwork or Pixel pattern for an image that already contains hard-edged square pixels. +Drag and resize the crop frame, then adjust Pattern size until the subject fills enough of the target width. +Optionally choose an aspect ratio, maximum color count, and initial generation method before generating. +What each control does +Photo +Smooths source sampling and simplifies photographic colors and details into bead cells. +Pixel pattern +Preserves hard pixel edges and attempts to detect and align the original pixel grid. +Crop frame +Removes irrelevant background and changes the composition without editing the original file. +Pattern size +Scales the subject within the cropped area; making it too small can remove recognizable details. +Aspect ratio +Keeps the crop freeform by default or locks it to 1:1, 4:3, or 16:9. +Maximum colors +Caps the initial palette between 1 and 256 colors; leave blank when no manual cap is needed. +1 Resize the crop area · 2 Choose Photo or Pixel pattern · 3 Set subject scale and generation options before continuing. +Expected result +The preview shows the intended subject at a readable size, with the correct Photo or Pixel pattern mode selected. +Step 4 of 10 +Generate and refine the pattern settings +The initial generation method controls how source pixels are sampled. The Generate panel then lets you change pattern detail, width, bead size, grid guides, and the real bead palette before regenerating. +Do this +Choose the initial method that best matches the source, then generate the first pattern. +Open Generate and compare detail mode, grid width, bead size, and bead brand with the intended physical project. +Select Regenerate pattern to apply changed settings; confirm before replacing manual canvas edits. +What each control does +Dominant color +Uses the strongest color in each cell. It is a dependable starting point for icons, cartoons, and clear shapes. +Average color +Blends pixels within each cell for balanced gradients and general photographs. +Fast color +Uses the stable legacy path for quick previews with the full selected palette. +Soft palette +Reduces noise, smooths neighboring regions, and favors a smaller, calmer set of colors. +Pixel detail +Keeps more local variation and uses dithering, which helps pixel art and detailed texture. +Precise match +Uses a stricter perceptual color match without dithering when bead color accuracy matters most. +Pattern detail +Detail first and Smooth natural keep broad palette freedom; Simplified, Standard, and Detailed Beta target roughly 8, 10, and 16 colors. +Pattern width +Choose 52, 104, or a custom 10–200 bead width. Height follows the source ratio and is limited to 200 beads. +Bead size +Select 5 mm or 2.6 mm so dimensions and exports match the physical beads you plan to use. +Bead brand +Maps colors to Perler, Hama, Artkal, MARD, Nabbi, or IKEA Pyssla codes; MARD can be restricted to a retail set size. +Reference grid and coordinates +Adds numbered guide lines for counting. You can change minor, reference, and major line colors and intervals. +Regenerate warning +Settings remain pending until applied. Regeneration replaces the current matrix, including any manual edits you confirm overwriting. +Original image +Generated bead pattern +The same source becomes a bead-by-bead chart. Grid width, palette, generation method, and later edits determine how much detail and how many colors remain. +1 Choose the detail preset · 2 set physical grid dimensions · 3 choose the real bead palette, then regenerate to apply changes. +Expected result +The bead pattern has a practical physical size, uses the bead brand you own, and preserves the right amount of detail. +Step 5 of 10 +Inspect and navigate the canvas +Viewing controls change only how you inspect the workspace. They do not change the bead matrix or exported pattern. +Do this +Use the plus, minus, or zoom slider to inspect individual bead cells. +Pan by dragging empty workspace; on touch screens, use two fingers to zoom and move the view. +Double-click empty workspace when you want to reset the view to its fitted position. +What each control does +Zoom slider +Adjusts user zoom from 50% to 300% while preserving the automatic fit scale. +Wheel zoom +Zooms around the pointer position so the bead under inspection stays near the cursor. +Workspace pan +Moves the board without editing cells when you drag the blank area around the pattern. +Double-click reset +Returns the board to its fitted center and clears manual pan and zoom. +Pinch gestures +Two-finger pinch zooms and pans on mobile; adding a second finger cancels an unfinished draw stroke. +Bead tooltip +Hovering a bead reveals its current color code for quick inspection. +1 Zoom controls · 2 pan and inspect the board · 3 use quick colors without leaving the canvas. +Expected result +You can inspect small color codes and move around a large pattern without accidentally changing the design. +Step 6 of 10 +Edit cells and choose colors +Use direct drawing tools for local fixes, the source sampler for color matching, and quick or full palettes for selecting exact bead codes. +Do this +Choose Brush, Eraser, or Eyedropper, then choose Single cell or Rectangle fill. +Select a quick color or search the full current brand palette by name or code. +Paint the required cells and use Undo or Redo if the change is not correct. +What each control does +Brush +Adds the selected bead color by clicking a cell or dragging a continuous stroke. +Eraser +Clears beads from single cells or a dragged region. +Eyedropper +Selects a color already present in the bead pattern without changing the cell. +Pick from source +Samples the original image, ranks the three nearest colors in the active bead palette, and applies the chosen code to the brush. +Single cell +Paints or erases individual cells and continuous freehand strokes. +Rectangle fill +Fills or clears a rectangular selection from the press point to the release point. +Quick colors +Orders recent selections, used pattern colors, and remaining palette colors for fast reuse. +Full palette +Searches and selects any available code from the currently selected bead brand. +Undo and Redo +Moves backward or forward through committed strokes, fills, mirror actions, and color cleanup changes. +Horizontal mirror +Flips the entire current pattern from left to right and adds the change to history. +1 Choose Brush, Eraser, or Eyedropper · 2 select a bead color or sample the source · 3 choose Single cell or Rectangle fill. +Expected result +The edited cells use valid codes from the current brand palette, and the change can still be undone. +Step 7 of 10 +Use color cleanup, symmetry, and layers +Advanced tools handle repeated changes faster and let you simplify the editing view without affecting the final exported chart. +Do this +Open Color adjustment to delete unwanted colors or replace one used color everywhere. +Enable vertical or horizontal symmetry when both sides should receive the same brush or eraser action. +Use Layers to hide or fade the drawing and board while checking structure. +What each control does +Delete colors +Selects one or more used colors and clears every bead that uses those codes after confirmation. +Replace color +Selects one source code and replaces all of its beads with a used or full-palette target code. +Search and sort +Finds codes quickly and sorts used colors by least used or by color code. +Vertical symmetry +Mirrors brush, eraser, and rectangle edits across a movable vertical axis. +Horizontal symmetry +Mirrors edits across a movable horizontal axis. +Center or place axis +Centers the symmetry axis automatically or lets you drag it to an exact grid position. +Drawing layer +Shows, hides, or changes the opacity of the colored beads in the editor only. +Board layer +Shows, hides, or changes grid-board opacity in the editor; exported files keep their own render settings. +Color adjustment: delete and replace colors +Open Adjust Colors from the toolbar after a pattern has been generated. The dialog works on every matching bead across the whole pattern, so check the affected color codes and bead totals before confirming. +Delete colors from the pattern +Use this when small, unwanted color groups should become empty cells instead of being repainted one bead at a time. +Select Delete Color at the top of the dialog. +Search or sort the used colors, then select one or more color codes. The number badge shows how many beads use each code. +Review the selected-color and bead totals, click Delete selected, and confirm the warning to clear every matching cell. +1 Choose Delete Color · 2 select one or more used codes and check their quantities · 3 click Delete selected and confirm the affected bead total. +Replace one color everywhere +Use this to merge a stray color into a nearby tone or move every bead of one code to another code without changing their positions. +Select Replace Color, then choose the single used color that should be changed. +Under Select the new color, choose Used colors for an existing code or All palette colors for any code in the active bead brand. +Select the target color and verify the source-to-target summary. +Click Confirm Replace to update every bead that uses the source code. +1 Choose Replace Color · 2 select the source code · 3 choose the target from used colors or the full palette · 4 verify the summary and confirm replacement. +Both operations are added to Undo history. Delete Color leaves affected cells empty; Replace Color keeps those bead positions and changes only their color code. +1 Open the Adjust Colors dialog · 2 mirror future edits around an axis · 3 simplify the editor view with layer controls. +Expected result +Repeated color or symmetry changes are applied consistently, while layer visibility remains an editor-only aid. +Step 8 of 10 +Check bead codes and quantities +The Beads panel turns the current matrix into a shopping and placement reference, with totals for the whole project and each color. +Do this +Open Beads and start with Used colors to review the material list for the current pattern. +Select a color to highlight every matching bead on the canvas. +Switch to All palette colors only when you need to inspect or select an unused code. +What each control does +Used colors +Shows only codes present in the pattern, with the number of beads required for each code. +All palette colors +Shows every available color in the active bead brand, including colors not yet used. +Color count +Reports how many distinct bead colors the current pattern uses. +Total bead count +Adds all non-empty cells to estimate the total number of beads required. +Color highlight +Dims unrelated cells and highlights every bead using the selected code so placement is easier to verify. +Selected color summary +Shows the code, color name, and current quantity for the selected or highlighted color. +1 Review distinct colors and total beads · 2 switch between Used and All · 3 select a code to highlight its placement. +Expected result +You have a complete list of bead codes and quantities and can visually confirm where each color appears. +Step 9 of 10 +Download or publish the finished pattern +Choose how beads are drawn, then download privately as PNG or PDF. Publishing to the public gallery is a separate, clearly labeled action. +Do this +Open Export and choose Square, Round, or Hollow bead rendering. +Choose PNG for a shareable image or PDF for a printable grid with codes and material statistics. +Use direct download for a private file; choose Publish to gallery only when you intend to make the pattern public. +What each control does +Square beads +Renders cells as a dense square grid that is easy to inspect at small sizes. +Round beads +Previews solid circular beads with visible spacing between cells. +Hollow beads +Previews round fuse beads with their center holes visible. +PNG download +Creates an image for sharing or viewing on a phone, tablet, or computer. +PDF download +Creates a printable chart with color codes, dimensions, and a bead shopping list; very large patterns use a large single page. +Author watermark +Optionally repeats your author text diagonally across the downloaded PNG. +Direct download +Saves only to the current device and does not publish the pattern. +Publish to gallery +Requires a pattern name, optionally accepts author and making notes, saves publicly, and downloads the PNG. +Android beta +Opens the separate Android tester recruitment flow; it is not required for web export. +1 Choose bead appearance · 2 select PNG or PDF private download · 3 use the separate publish action only for public sharing. +Expected result +A PNG or PDF download begins, and the pattern remains private unless you explicitly chose the public gallery action. +Step 10 of 10 +Fix common generation and export problems +Most problems come from unsupported files, a subject that is too small, overly large grids, or a setting change that has not yet been applied. +Do this +Read the message shown next to the affected upload, crop, generation, or export control. +Return to the earliest failed step and reduce image size, enlarge the subject, lower grid width, or choose another method. +If the issue continues, refresh the page and try a supported copy of the image before contacting support. +What each control does +Image will not upload +Confirm JPG, JPEG, PNG, or WebP and a file size no larger than 10 MB. +Subject disappears +Enlarge the subject in the crop preview or include more foreground pixels before generating again. +Generation is slow +Use a smaller source, reduce pattern width, or select Fast color for a quicker preview. +Colors look wrong +Try another bead brand or generation method, then correct specific cells with source color sampling and the brush. +Pixel grid is misdetected +Switch from detected pixel alignment to photo conversion, or re-upload and choose Photo instead of Pixel pattern. +Manual edits may disappear +Changing generation settings does nothing until regeneration; confirming regeneration replaces the current hand-edited matrix. +Large PDF printing +Use Poster or Tile in the printer settings when a large single-page pattern must be split across A4 sheets. +Download does not start +Allow browser downloads, retry once, or choose the other export format before refreshing. +1 Read the file error · 2 correct the input and retry Upload Image · 3 use one of the listed supported formats. +Expected result +You can identify the failed stage and retry it without publishing or overwriting work unintentionally. +Ready to make your pattern +Create your own pattern while this guide is open +The generator runs in your browser. Start with a clear image, keep this guide in another tab, and work through the same steps with your own bead brand and board size. +Open the pattern generator +Still need help? +Tell us what you’re trying to do and at which step the problem occurs. +Email us +help@pixel-beads.com +Contact Us +Pixel Beads Art +Pattern Studio +Explore +Home +Showcase +Pattern Library +Blog +Create +Generator +Pixel Bead Art +Image to Pixel Art +Apps & Support +Apps +Chrome Extension +Android App +iOS App +Help +Contact +Company & Legal +About Us +Privacy Policy +Terms of Service +Featured & Listed +© 2026 • Pixel Beads Art \ No newline at end of file diff --git a/competitor-analysis/raw/help-generator-en.html b/competitor-analysis/raw/help-generator-en.html new file mode 100644 index 0000000..3a69b25 --- /dev/null +++ b/competitor-analysis/raw/help-generator-en.html @@ -0,0 +1,2 @@ +Complete Perler Bead Pattern Generator guide +

    From source image to printable pattern

    Complete Perler Bead Pattern Generator guide

    Turn one image into a printable Perler bead pattern. Follow upload, crop, generation, editing, bead counts, and PNG or PDF export.

    No account required10 guided chaptersDesktop and mobile
    Open the pattern generator

    Step 1 of 10

    Understand the workspace

    The generator keeps the artwork in the center and moves project controls into focused panels. Desktop panels can be opened independently; mobile controls open from the bottom navigation.

    Do this

    1. 1Locate the panel rail on desktop or the bottom navigation on mobile.
    2. 2Open Generate, Edit tools, Layers, Symmetry, Beads, and Export once to learn where each task lives.
    3. 3Return to the center canvas; this is where you zoom, pan, inspect, and edit the pattern.

    What each control does

    Desktop panel rail

    Opens Source, Edit tools, Layers, Generate, Symmetry, Beads, and Export as separate floating panels.

    Floating panels

    Drag a panel by its title bar, bring it to the front by interacting with it, or minimize it without losing settings.

    Mobile navigation

    Opens six task sheets: Edit tools, Generate, Layers, Symmetry, Beads, and Export.

    Canvas workspace

    Shows the editable bead grid and accepts painting, erasing, color picking, zooming, panning, and symmetry placement.

    Quick colors

    Keeps recent and currently used bead colors close to the canvas so repeated editing takes fewer taps.

    1 Panel rail · 2 Editable canvas · 3 Floating panels. On mobile, the same responsibilities move to the bottom navigation.

    Expected result

    You can point to the panel used for generating, editing, checking bead counts, and exporting without searching through the whole page.

    Step 2 of 10

    Upload or import a source image

    Start with a high-contrast image whose subject is easy to separate from the background. The generator accepts local files and images handed off by the Pixel Beads Chrome extension.

    Do this

    1. 1Select Upload image and choose a JPG, JPEG, PNG, or WebP file no larger than 10 MB.
    2. 2If the image came from the Chrome extension, review the source and screenshot warning before continuing.
    3. 3Use Replace image later if you want to restart with a different source.

    What each control does

    Upload image

    Reads a supported local image and opens the crop workflow; conversion does not require an account.

    Chrome extension import

    Receives an image selected on another web page, validates it, then sends it into the same crop workflow.

    Screenshot warning

    Explains when an extension import is only a visible-page capture, so you can inspect sharpness and missing edges.

    Replace image

    Starts a new crop and generation flow with another source image.

    Draw manually

    Leaves the automatic generator and opens the blank Perler bead art editor for drawing from an empty board.

    1 Upload a supported image · 2 Switch to the manual editor · 3 Confirm the file requirements before choosing a source.

    Expected result

    The crop dialog opens with the selected image visible and no upload-format error.

    Step 3 of 10

    Choose the image type and crop

    Tell the generator whether the source is a photo or an existing pixel grid, then keep only the area needed for the finished bead pattern.

    Do this

    1. 1Choose Photo for normal artwork or Pixel pattern for an image that already contains hard-edged square pixels.
    2. 2Drag and resize the crop frame, then adjust Pattern size until the subject fills enough of the target width.
    3. 3Optionally choose an aspect ratio, maximum color count, and initial generation method before generating.

    What each control does

    Photo

    Smooths source sampling and simplifies photographic colors and details into bead cells.

    Pixel pattern

    Preserves hard pixel edges and attempts to detect and align the original pixel grid.

    Crop frame

    Removes irrelevant background and changes the composition without editing the original file.

    Pattern size

    Scales the subject within the cropped area; making it too small can remove recognizable details.

    Aspect ratio

    Keeps the crop freeform by default or locks it to 1:1, 4:3, or 16:9.

    Maximum colors

    Caps the initial palette between 1 and 256 colors; leave blank when no manual cap is needed.

    1 Resize the crop area · 2 Choose Photo or Pixel pattern · 3 Set subject scale and generation options before continuing.

    Expected result

    The preview shows the intended subject at a readable size, with the correct Photo or Pixel pattern mode selected.

    Step 4 of 10

    Generate and refine the pattern settings

    The initial generation method controls how source pixels are sampled. The Generate panel then lets you change pattern detail, width, bead size, grid guides, and the real bead palette before regenerating.

    Do this

    1. 1Choose the initial method that best matches the source, then generate the first pattern.
    2. 2Open Generate and compare detail mode, grid width, bead size, and bead brand with the intended physical project.
    3. 3Select Regenerate pattern to apply changed settings; confirm before replacing manual canvas edits.

    What each control does

    Dominant color

    Uses the strongest color in each cell. It is a dependable starting point for icons, cartoons, and clear shapes.

    Average color

    Blends pixels within each cell for balanced gradients and general photographs.

    Fast color

    Uses the stable legacy path for quick previews with the full selected palette.

    Soft palette

    Reduces noise, smooths neighboring regions, and favors a smaller, calmer set of colors.

    Pixel detail

    Keeps more local variation and uses dithering, which helps pixel art and detailed texture.

    Precise match

    Uses a stricter perceptual color match without dithering when bead color accuracy matters most.

    Pattern detail

    Detail first and Smooth natural keep broad palette freedom; Simplified, Standard, and Detailed Beta target roughly 8, 10, and 16 colors.

    Pattern width

    Choose 52, 104, or a custom 10–200 bead width. Height follows the source ratio and is limited to 200 beads.

    Bead size

    Select 5 mm or 2.6 mm so dimensions and exports match the physical beads you plan to use.

    Bead brand

    Maps colors to Perler, Hama, Artkal, MARD, Nabbi, or IKEA Pyssla codes; MARD can be restricted to a retail set size.

    Reference grid and coordinates

    Adds numbered guide lines for counting. You can change minor, reference, and major line colors and intervals.

    Regenerate warning

    Settings remain pending until applied. Regeneration replaces the current matrix, including any manual edits you confirm overwriting.

    Original image01
    Original gingerbread character used in the generator demonstration
    Generated bead pattern02
    Generated gingerbread Perler bead pattern with color codes on the grid
    The same source becomes a bead-by-bead chart. Grid width, palette, generation method, and later edits determine how much detail and how many colors remain.
    1 Choose the detail preset · 2 set physical grid dimensions · 3 choose the real bead palette, then regenerate to apply changes.

    Expected result

    The bead pattern has a practical physical size, uses the bead brand you own, and preserves the right amount of detail.

    Step 5 of 10

    Inspect and navigate the canvas

    Viewing controls change only how you inspect the workspace. They do not change the bead matrix or exported pattern.

    Do this

    1. 1Use the plus, minus, or zoom slider to inspect individual bead cells.
    2. 2Pan by dragging empty workspace; on touch screens, use two fingers to zoom and move the view.
    3. 3Double-click empty workspace when you want to reset the view to its fitted position.

    What each control does

    Zoom slider

    Adjusts user zoom from 50% to 300% while preserving the automatic fit scale.

    Wheel zoom

    Zooms around the pointer position so the bead under inspection stays near the cursor.

    Workspace pan

    Moves the board without editing cells when you drag the blank area around the pattern.

    Double-click reset

    Returns the board to its fitted center and clears manual pan and zoom.

    Pinch gestures

    Two-finger pinch zooms and pans on mobile; adding a second finger cancels an unfinished draw stroke.

    Bead tooltip

    Hovering a bead reveals its current color code for quick inspection.

    1 Zoom controls · 2 pan and inspect the board · 3 use quick colors without leaving the canvas.

    Expected result

    You can inspect small color codes and move around a large pattern without accidentally changing the design.

    Step 6 of 10

    Edit cells and choose colors

    Use direct drawing tools for local fixes, the source sampler for color matching, and quick or full palettes for selecting exact bead codes.

    Do this

    1. 1Choose Brush, Eraser, or Eyedropper, then choose Single cell or Rectangle fill.
    2. 2Select a quick color or search the full current brand palette by name or code.
    3. 3Paint the required cells and use Undo or Redo if the change is not correct.

    What each control does

    Brush

    Adds the selected bead color by clicking a cell or dragging a continuous stroke.

    Eraser

    Clears beads from single cells or a dragged region.

    Eyedropper

    Selects a color already present in the bead pattern without changing the cell.

    Pick from source

    Samples the original image, ranks the three nearest colors in the active bead palette, and applies the chosen code to the brush.

    Single cell

    Paints or erases individual cells and continuous freehand strokes.

    Rectangle fill

    Fills or clears a rectangular selection from the press point to the release point.

    Quick colors

    Orders recent selections, used pattern colors, and remaining palette colors for fast reuse.

    Full palette

    Searches and selects any available code from the currently selected bead brand.

    Undo and Redo

    Moves backward or forward through committed strokes, fills, mirror actions, and color cleanup changes.

    Horizontal mirror

    Flips the entire current pattern from left to right and adds the change to history.

    1 Choose Brush, Eraser, or Eyedropper · 2 select a bead color or sample the source · 3 choose Single cell or Rectangle fill.

    Expected result

    The edited cells use valid codes from the current brand palette, and the change can still be undone.

    Step 7 of 10

    Use color cleanup, symmetry, and layers

    Advanced tools handle repeated changes faster and let you simplify the editing view without affecting the final exported chart.

    Do this

    1. 1Open Color adjustment to delete unwanted colors or replace one used color everywhere.
    2. 2Enable vertical or horizontal symmetry when both sides should receive the same brush or eraser action.
    3. 3Use Layers to hide or fade the drawing and board while checking structure.

    What each control does

    Delete colors

    Selects one or more used colors and clears every bead that uses those codes after confirmation.

    Replace color

    Selects one source code and replaces all of its beads with a used or full-palette target code.

    Search and sort

    Finds codes quickly and sorts used colors by least used or by color code.

    Vertical symmetry

    Mirrors brush, eraser, and rectangle edits across a movable vertical axis.

    Horizontal symmetry

    Mirrors edits across a movable horizontal axis.

    Center or place axis

    Centers the symmetry axis automatically or lets you drag it to an exact grid position.

    Drawing layer

    Shows, hides, or changes the opacity of the colored beads in the editor only.

    Board layer

    Shows, hides, or changes grid-board opacity in the editor; exported files keep their own render settings.

    Color adjustment: delete and replace colors

    Open Adjust Colors from the toolbar after a pattern has been generated. The dialog works on every matching bead across the whole pattern, so check the affected color codes and bead totals before confirming.

    1

    Delete colors from the pattern

    Use this when small, unwanted color groups should become empty cells instead of being repainted one bead at a time.

    1. 1Select Delete Color at the top of the dialog.
    2. 2Search or sort the used colors, then select one or more color codes. The number badge shows how many beads use each code.
    3. 3Review the selected-color and bead totals, click Delete selected, and confirm the warning to clear every matching cell.
    1 Choose Delete Color · 2 select one or more used codes and check their quantities · 3 click Delete selected and confirm the affected bead total.
    2

    Replace one color everywhere

    Use this to merge a stray color into a nearby tone or move every bead of one code to another code without changing their positions.

    1. 1Select Replace Color, then choose the single used color that should be changed.
    2. 2Under Select the new color, choose Used colors for an existing code or All palette colors for any code in the active bead brand.
    3. 3Select the target color and verify the source-to-target summary.
    4. 4Click Confirm Replace to update every bead that uses the source code.
    1 Choose Replace Color · 2 select the source code · 3 choose the target from used colors or the full palette · 4 verify the summary and confirm replacement.

    Both operations are added to Undo history. Delete Color leaves affected cells empty; Replace Color keeps those bead positions and changes only their color code.

    1 Open the Adjust Colors dialog · 2 mirror future edits around an axis · 3 simplify the editor view with layer controls.

    Expected result

    Repeated color or symmetry changes are applied consistently, while layer visibility remains an editor-only aid.

    Step 8 of 10

    Check bead codes and quantities

    The Beads panel turns the current matrix into a shopping and placement reference, with totals for the whole project and each color.

    Do this

    1. 1Open Beads and start with Used colors to review the material list for the current pattern.
    2. 2Select a color to highlight every matching bead on the canvas.
    3. 3Switch to All palette colors only when you need to inspect or select an unused code.

    What each control does

    Used colors

    Shows only codes present in the pattern, with the number of beads required for each code.

    All palette colors

    Shows every available color in the active bead brand, including colors not yet used.

    Color count

    Reports how many distinct bead colors the current pattern uses.

    Total bead count

    Adds all non-empty cells to estimate the total number of beads required.

    Color highlight

    Dims unrelated cells and highlights every bead using the selected code so placement is easier to verify.

    Selected color summary

    Shows the code, color name, and current quantity for the selected or highlighted color.

    1 Review distinct colors and total beads · 2 switch between Used and All · 3 select a code to highlight its placement.

    Expected result

    You have a complete list of bead codes and quantities and can visually confirm where each color appears.

    Step 9 of 10

    Download or publish the finished pattern

    Choose how beads are drawn, then download privately as PNG or PDF. Publishing to the public gallery is a separate, clearly labeled action.

    Do this

    1. 1Open Export and choose Square, Round, or Hollow bead rendering.
    2. 2Choose PNG for a shareable image or PDF for a printable grid with codes and material statistics.
    3. 3Use direct download for a private file; choose Publish to gallery only when you intend to make the pattern public.

    What each control does

    Square beads

    Renders cells as a dense square grid that is easy to inspect at small sizes.

    Round beads

    Previews solid circular beads with visible spacing between cells.

    Hollow beads

    Previews round fuse beads with their center holes visible.

    PNG download

    Creates an image for sharing or viewing on a phone, tablet, or computer.

    PDF download

    Creates a printable chart with color codes, dimensions, and a bead shopping list; very large patterns use a large single page.

    Author watermark

    Optionally repeats your author text diagonally across the downloaded PNG.

    Direct download

    Saves only to the current device and does not publish the pattern.

    Publish to gallery

    Requires a pattern name, optionally accepts author and making notes, saves publicly, and downloads the PNG.

    Android beta

    Opens the separate Android tester recruitment flow; it is not required for web export.

    1 Choose bead appearance · 2 select PNG or PDF private download · 3 use the separate publish action only for public sharing.

    Expected result

    A PNG or PDF download begins, and the pattern remains private unless you explicitly chose the public gallery action.

    Step 10 of 10

    Fix common generation and export problems

    Most problems come from unsupported files, a subject that is too small, overly large grids, or a setting change that has not yet been applied.

    Do this

    1. 1Read the message shown next to the affected upload, crop, generation, or export control.
    2. 2Return to the earliest failed step and reduce image size, enlarge the subject, lower grid width, or choose another method.
    3. 3If the issue continues, refresh the page and try a supported copy of the image before contacting support.

    What each control does

    Image will not upload

    Confirm JPG, JPEG, PNG, or WebP and a file size no larger than 10 MB.

    Subject disappears

    Enlarge the subject in the crop preview or include more foreground pixels before generating again.

    Generation is slow

    Use a smaller source, reduce pattern width, or select Fast color for a quicker preview.

    Colors look wrong

    Try another bead brand or generation method, then correct specific cells with source color sampling and the brush.

    Pixel grid is misdetected

    Switch from detected pixel alignment to photo conversion, or re-upload and choose Photo instead of Pixel pattern.

    Manual edits may disappear

    Changing generation settings does nothing until regeneration; confirming regeneration replaces the current hand-edited matrix.

    Large PDF printing

    Use Poster or Tile in the printer settings when a large single-page pattern must be split across A4 sheets.

    Download does not start

    Allow browser downloads, retry once, or choose the other export format before refreshing.

    1 Read the file error · 2 correct the input and retry Upload Image · 3 use one of the listed supported formats.

    Expected result

    You can identify the failed stage and retry it without publishing or overwriting work unintentionally.

    Ready to make your pattern

    Create your own pattern while this guide is open

    The generator runs in your browser. Start with a clear image, keep this guide in another tab, and work through the same steps with your own bead brand and board size.

    Open the pattern generator

    Still need help?

    Tell us what you’re trying to do and at which step the problem occurs.

    Email ushelp@pixel-beads.comContact Us
    \ No newline at end of file diff --git a/competitor-analysis/raw/ikea-pyssla-chart-en.html b/competitor-analysis/raw/ikea-pyssla-chart-en.html new file mode 100644 index 0000000..fb7bb20 --- /dev/null +++ b/competitor-analysis/raw/ikea-pyssla-chart-en.html @@ -0,0 +1,2 @@ +Ultimate Ikea Pyssla Bead Color Chart (2026 Revised Edition) +
    Back to Workshop

    Ultimate Ikea Pyssla Bead Color Chart (2026 Revised Edition)

    Complete reference for all official Ikea Pyssla bead color codes, HEX values, and names. The essential guide for pixel art designers and hobbyists.

    18
    Colors Logged
    18
    Standard Solids
    0
    Pearl Effects
    0
    Vibrant Neons
    #Black
    Black
    #000000
    #Blue
    Blue
    #0657D8
    #Blue (Pastell)
    Blue (Pastell)
    #93D3E2
    #Brown
    Brown
    #3A0909
    #Green
    Green
    #1FAA03
    #Green (Pastell)
    Green (Pastell)
    #ACBF33
    #Grey (Pastell)
    Grey (Pastell)
    #9E9C9D
    #Orange
    Orange
    #F2741A
    #Orange (Pastell)
    Orange (Pastell)
    #EDA250
    #Pink
    Pink
    #FF66B7
    #Pink (Pastell)
    Pink (Pastell)
    #F2BFD2
    #Purple
    Purple
    #BE88EA
    #Purple (Pastell)
    Purple (Pastell)
    #C5B7DA
    #Red
    Red
    #D80606
    #Sand (Pastell)
    Sand (Pastell)
    #E0BEA8
    #White
    White
    #FFFFFF
    #Yellow
    Yellow
    #FFE016
    #Yellow (Pastell)
    Yellow (Pastell)
    #F7EE45

    Official Color Index & HEX Reference

    Ikea Pyssla beads are known for stable quality, primarily in 5mm size, making them perfect for families and children getting started. The key to a successful project is choosing the right colors. Our official Ikea Pyssla Bead color chart provides a comprehensive list of every shade with HEX values.

    Why Color Mapping Matters

    Using the correct color codes ensures that your pixel art translates perfectly from digital design to physical craft. Each color is mapped with its specific HEX code, allowing you to use them in our Pixel Bead Generator for precise pattern creation.

    Mastering Hues

    Whether you are building complex sprites or simple patterns, having a full range of colors is essential. We recommend starting with a standard 24 or 48 color set and expanding your collection with individual bags of colors as needed for your projects.

    \ No newline at end of file diff --git a/competitor-analysis/raw/nabbi-chart-en.html b/competitor-analysis/raw/nabbi-chart-en.html new file mode 100644 index 0000000..d0d6db1 --- /dev/null +++ b/competitor-analysis/raw/nabbi-chart-en.html @@ -0,0 +1,2 @@ +Ultimate Nabbi Bead Color Chart (2026 Revised Edition) +
    Back to Workshop

    Ultimate Nabbi Bead Color Chart (2026 Revised Edition)

    Complete reference for all official Nabbi bead color codes, HEX values, and names. The essential guide for pixel art designers and hobbyists.

    30
    Colors Logged
    30
    Standard Solids
    0
    Pearl Effects
    0
    Vibrant Neons
    #N01
    N01
    #3A3D41
    #N02
    N02
    #50443B
    #N03
    N03
    #5A3E36
    #N04
    N04
    #813547
    #N05
    N05
    #A76224
    #N06
    N06
    #AD967E
    #N07
    N07
    #EEB182
    #N08
    N08
    #8D8B7F
    #N09
    N09
    #2F4A39
    #N10
    N10
    #D3CBCB
    #N11
    N11
    #644591
    #N12
    N12
    #E2D0BF
    #N13
    N13
    #F3601B
    #N14
    N14
    #F9CA00
    #N15
    N15
    #F4F4F3
    #N16
    N16
    #297A3B
    #N17
    N17
    #3B75CB
    #N18
    N18
    #E1B4AB
    #N19
    N19
    #DF2638
    #N20
    N20
    #B58B69
    #N21
    N21
    #F5EC8D
    #N22
    N22
    #48AF4F
    #N23
    N23
    #71A3E6
    #N24
    N24
    #B6A0DB
    #N25
    N25
    #EE6A97
    #N26
    N26
    #FCA879
    #N27
    N27
    #875F52
    #N28
    N28
    #A7C6F1
    #N29
    N29
    #EE9527
    #N30
    N30
    #C7BF5E

    Official Color Index & HEX Reference

    Nabbi beads are known for stable quality, primarily in 5mm size, making them perfect for families and children getting started. The key to a successful project is choosing the right colors. Our official Nabbi Bead color chart provides a comprehensive list of every shade with HEX values.

    Why Color Mapping Matters

    Using the correct color codes ensures that your pixel art translates perfectly from digital design to physical craft. Each color is mapped with its specific HEX code, allowing you to use them in our Pixel Bead Generator for precise pattern creation.

    Mastering Hues

    Whether you are building complex sprites or simple patterns, having a full range of colors is essential. We recommend starting with a standard 24 or 48 color set and expanding your collection with individual bags of colors as needed for your projects.

    \ No newline at end of file diff --git a/competitor-analysis/raw/pattern-luo-ri-yu-hui-en-text.txt b/competitor-analysis/raw/pattern-luo-ri-yu-hui-en-text.txt new file mode 100644 index 0000000..6befc16 --- /dev/null +++ b/competitor-analysis/raw/pattern-luo-ri-yu-hui-en-text.txt @@ -0,0 +1,329 @@ +落日余晖 Perler Bead Pattern | 99×99 Free Download +Pixel Beads Art +Home +Bead Pattern Generator +Bead Art +Image to Pixel Art +Showcase +Theme Beads +Patterns +Apps +Help +English +Home +Pattern Library +落日余晖 +Free printable bead pattern +落日余晖 Perler Bead Pattern — 99×99 Free Download +Download the 落日余晖 perler bead pattern for free. This 99×99 design uses about 9,801 beads and matches the MARD palette. +Preview the pattern and material list, then export a color-coded image or PDF. +Check stray and transition colors before making +Photo conversion can create a few stray colors along the edges where color areas meet. Outline each area first, then remove colors you do not need. +Keep continuous transition colors when they help the image look more natural. +Want to refine it manually? Open Bead Art +Estimated time +8–12 hr +Views +6,889 +Author +August 8, 2026 +Material Brand +MARD +落日余晖 Perler Bead Pattern Preview +Full pattern shown. Zoom in to inspect details. +Dimensions +Colors +Total Beads +9,801 +Show grid +Fit to screen +Make this pattern +For bead placement, start with the PDF. +The PDF includes the grid, bead codes, and materials list for step-by-step printing and making. +Export PDF (recommended) +Export PNG (preview/share) +PNG works best for previews and sharing; use the PDF as your making reference. +Customize export style +Square · Small · codes included +These settings affect the exported file and preview only. They do not change the source pattern. +Bead Style +Square beads are easiest to check cell by cell; round styles look closer to finished beads. +Square +Round +Hollow +Grid Spacing +Small spacing is recommended for printing; large spacing separates individual beads more clearly. +None +Small +Large +Bill of Materials +83 colors required +Total Beads +9,801 +High-use colors to prepare first +1648 +1592 +H12 +1489 +876 +657 +There are also 45 low-use colors with 10 beads or fewer each. Keep them separately labeled. +View all 83 colors +1648 +1592 +H12 +1489 +876 +657 +A17 +544 +F21 +424 +317 +F20 +247 +244 +A26 +210 +206 +H16 +145 +G15 +105 +E14 +104 +102 +102 +A18 +F14 +F19 +A12 +H18 +A22 +A23 +F24 +A24 +M14 +F18 +F23 +H21 +A21 +G14 +G13 +F11 +M12 +B15 +A11 +G19 +H14 +G17 +M11 +B23 +H19 +F16 +F10 +F17 +H23 +A19 +E12 +B11 +G21 +G10 +A10 +A25 +E18 +E15 +G20 +E22 +B26 +A20 +H17 +Pattern +In-depth guide +More patterns +Copy page link +Make it with confidence +落日余晖 making guide +Check the board layout, high-use colors, and outline shades before placing the first bead. +Work from the edges into the large color areas, then finish the small details. +Before you start +Check color boundaries and remove stray colors before placement. +Keep intentional transition shades that shape curves and shadows. +Outline each area first, then fill large blocks and small details. +Open the complete making guide +Includes six making steps, advanced ironing methods, and common questions. +Finished size +49.5 × 49.5 cm +Estimated with standard 5 mm beads. +Pegboards +4 standard +Or 1 large 104×104 board. +Difficulty +advanced +Based on size and total bead count. +Boards +Materials +Place +Check +Export +Iron +FAQ +Plan the size and board layout +Choose the board layout before you place the first bead. +Use 4 standard 52×52 boards or 1 large 104×104 board. +Leave a safe margin around the edge of each board. +Allow about 49.5 × 49.5 cm plus extra space if you plan to frame the piece. +Prepare high-use and detail colors +Check the material list before you start so missing colors do not interrupt the project. +Set aside the highest-count colors first. +Keep similar shades in separate, labeled trays. +Avoid casual substitutions in outlines, eyes, text, and other high-contrast details. +Set the edges, then fill the color areas +Use the outline as a position reference before filling the largest areas. +Place the key edges and corners first. +Fill the largest color areas after the outline is stable. +Add small colors and high-contrast details last. +Slow down at diagonals and color transitions +Curves and diagonal lines can shift by one bead when a row changes. +Compare each row instead of continuing a curve from memory. +Keep transition shades that follow the shape or lighting. +Scan the finished design for isolated small colors before ironing. +Save the version you need +Use the PDF for making and the image for sharing. +Keep the grid and color codes in the PDF for row-by-row checks. +Use the image export for a quick phone reference or preview. +Zoom into the PDF when similar shades are hard to distinguish. +Iron and cool evenly +Even pressure and a full cooling cycle help the finished piece stay flat. +Cover the beads with ironing paper and use the heat recommended by the bead brand. +Move the iron in small circles instead of holding it in one spot. +Cool the piece under a flat, heat-safe weight before removing it from the board. +Advanced ironing: six finishes compared +Choose the surface you want before the first pass. +Each material changes how heat and pressure reach the beads, so test the same brand and temperature on a small sample first. +Glossy finish +A reflective, sealed surface with stronger highlights and less visible bead texture. +Standard finish +Recommended +Clear bead outlines with balanced fusion, suitable for most display pieces. +Waffle finish +A fine grid is pressed into the fused surface for a regular woven texture. +Towel finish +A soft fabric impression gives the surface a gentler, more tactile look. +Glitter finish +A transparent reflective layer adds sparkle while keeping the underlying colors visible. +Wet-cloth finish +A fine, even cloth texture creates a softer matte surface. +The examples come from different pieces and lighting conditions. They compare general surface texture rather than serving as a controlled test. +Temperature, time, bead brand and barrier material all affect the result. +What is towel ironing? +Place a flat, dry, thin towel with no heavy weave under the piece, then iron through heat-resistant paper. The softer base changes pressure and heat transfer, so test with spare beads and stop before over-fusing. +What is glitter or texture cloth? +It is a heat-resistant sheet with sparkle or a molded texture that can transfer a glossy or patterned finish. Products tolerate different temperatures, so follow the material instructions and begin with a short test. +When should I use masking tape and flip the piece? +Using masking tape: +Use it for large or fragile layouts, or whenever the unfused beads must leave the pegboard before ironing. +Without masking tape: +Small patterns can stay on the pegboard, and some texture sheets do not require a transfer step. +Do not confuse the two papers. +Masking tape holds and transfers unfused beads. It does not replace ironing paper or parchment. +Keep a heat-resistant barrier between the iron and the piece. +Transferred with masking tape +Finish material +Flip? +Ironing paper or parchment +Yes +Glossy sheet +Yes +Towel or wet cloth +Glitter or texture sheet +Steamer cloth +Diamond texture sheet +Kept on the pegboard +Finish material +Flip? +Ironing paper or parchment +Glossy sheet +Towel or wet cloth +Yes +Glitter or texture sheet +Yes +Steamer cloth +Yes +Diamond texture sheet +Here, “flip” means turning the piece so the intended texture surface touches the beads. It is separate from ironing both sides for extra strength. +FAQ +Questions before you make it +Can I use another bead brand? +Yes. Match by the displayed color and verify close shades before buying. The current list is mapped to MARD. +How many pegboards do I need? +Use 4 standard 52×52 boards or 1 large 104×104 board. +What if the full pattern is too large to follow? +Export the coded PDF and complete the design in labeled sections. Check the seam between sections before ironing. +Should I iron one side or both sides? +One-sided ironing is usually enough for framed or display pieces. Iron both sides for keychains or pieces that will be handled often, but keep some bead holes visible so the result does not become brittle. +How can I keep the finished pattern flat? +Move the iron continuously, avoid overheating the edges, then cool the piece under a flat, heat-safe weight before lifting it. +Who should handle the ironing step? +An adult should handle the hot iron and heat-resistant paper. Keep children away from the heated work surface until the piece has cooled completely. +Can I resize this pattern? +Yes, but scaling changes the grid and color count. Regenerate the pattern at the target dimensions instead of stretching the exported image. +How should I move a large unfinished pattern? +Secure it in sections with masking tape or complete it on connected pegboards. Check every board seam before transferring or ironing. +Pixel Beads Art +Pattern Studio +Explore +Home +Showcase +Pattern Library +Blog +Create +Generator +Pixel Bead Art +Image to Pixel Art +Apps & Support +Apps +Chrome Extension +Android App +iOS App +Help +Contact +Company & Legal +About Us +Privacy Policy +Terms of Service +Featured & Listed +© 2026 • Pixel Beads Art +Keep making +Perler bead patterns you may also like +Browse more bead patterns with a similar size profile and popular library picks. +100 +175,834 +朱迪警官 +View pattern +182,216 +史迪奇 +View pattern +53,443 +凯蒂猫 1 +View pattern +83,203 +王橹杰拼豆 +View pattern +54,460 +View pattern +73,791 +ikun +View pattern +79,795 +姜饼人 +View pattern +93,944 +hello kitty +View pattern +188,667 +MC-不死图腾 +View pattern +211,629 +线条小狗 +View pattern \ No newline at end of file diff --git a/competitor-analysis/raw/pattern-luo-ri-yu-hui-en.html b/competitor-analysis/raw/pattern-luo-ri-yu-hui-en.html new file mode 100644 index 0000000..141781f --- /dev/null +++ b/competitor-analysis/raw/pattern-luo-ri-yu-hui-en.html @@ -0,0 +1,3 @@ +落日余晖 Perler Bead Pattern | 99×99 Free Download +

    Free printable bead pattern

    落日余晖 Perler Bead Pattern — 99×99 Free Download

    Download the 落日余晖 perler bead pattern for free. This 99×99 design uses about 9,801 beads and matches the MARD palette.

    Preview the pattern and material list, then export a color-coded image or PDF.

    Estimated time8–12 hr
    Views6,889
    Author: 糖糖Material Brand: MARD

    落日余晖 Perler Bead Pattern Preview

    Full pattern shown. Zoom in to inspect details.

    Dimensions
    99 × 99
    Colors
    83
    Total Beads
    9,801
    落日余晖 perler bead pattern 99×99 preview
    50%

    Make it with confidence

    落日余晖 making guide

    Check the board layout, high-use colors, and outline shades before placing the first bead.

    Work from the edges into the large color areas, then finish the small details.

    Open the complete making guideIncludes six making steps, advanced ironing methods, and common questions.

    Finished size

    49.5 × 49.5 cm

    Estimated with standard 5 mm beads.

    Pegboards

    4 standard

    Or 1 large 104×104 board.

    Difficulty

    advanced

    Based on size and total bead count.

    01

    Plan the size and board layout

    Choose the board layout before you place the first bead.

    1. 1.Use 4 standard 52×52 boards or 1 large 104×104 board.
    2. 2.Leave a safe margin around the edge of each board.
    3. 3.Allow about 49.5 × 49.5 cm plus extra space if you plan to frame the piece.
    02

    Prepare high-use and detail colors

    Check the material list before you start so missing colors do not interrupt the project.

    1. 1.Set aside the highest-count colors first.
    2. 2.Keep similar shades in separate, labeled trays.
    3. 3.Avoid casual substitutions in outlines, eyes, text, and other high-contrast details.
    03

    Set the edges, then fill the color areas

    Use the outline as a position reference before filling the largest areas.

    1. 1.Place the key edges and corners first.
    2. 2.Fill the largest color areas after the outline is stable.
    3. 3.Add small colors and high-contrast details last.
    04

    Slow down at diagonals and color transitions

    Curves and diagonal lines can shift by one bead when a row changes.

    1. 1.Compare each row instead of continuing a curve from memory.
    2. 2.Keep transition shades that follow the shape or lighting.
    3. 3.Scan the finished design for isolated small colors before ironing.
    05

    Save the version you need

    Use the PDF for making and the image for sharing.

    1. 1.Keep the grid and color codes in the PDF for row-by-row checks.
    2. 2.Use the image export for a quick phone reference or preview.
    3. 3.Zoom into the PDF when similar shades are hard to distinguish.
    06

    Iron and cool evenly

    Even pressure and a full cooling cycle help the finished piece stay flat.

    1. 1.Cover the beads with ironing paper and use the heat recommended by the bead brand.
    2. 2.Move the iron in small circles instead of holding it in one spot.
    3. 3.Cool the piece under a flat, heat-safe weight before removing it from the board.

    Advanced ironing: six finishes compared

    Choose the surface you want before the first pass.

    Each material changes how heat and pressure reach the beads, so test the same brand and temperature on a small sample first.

    Fused-bead piece with a reflective glossy surface
    Glossy finish

    A reflective, sealed surface with stronger highlights and less visible bead texture.

    Fused-bead piece with clear bead outlines after standard ironing
    Standard finishRecommended

    Clear bead outlines with balanced fusion, suitable for most display pieces.

    Fused-bead piece with a fine waffle-grid texture
    Waffle finish

    A fine grid is pressed into the fused surface for a regular woven texture.

    Fused-bead piece with a soft towel-pressed texture
    Towel finish

    A soft fabric impression gives the surface a gentler, more tactile look.

    Fused-bead piece with a transparent glitter finish
    Glitter finish

    A transparent reflective layer adds sparkle while keeping the underlying colors visible.

    Fused-bead piece with a fine wet-cloth texture
    Wet-cloth finish

    A fine, even cloth texture creates a softer matte surface.

    The examples come from different pieces and lighting conditions. They compare general surface texture rather than serving as a controlled test.

    Temperature, time, bead brand and barrier material all affect the result.

    What is towel ironing?

    Place a flat, dry, thin towel with no heavy weave under the piece, then iron through heat-resistant paper. The softer base changes pressure and heat transfer, so test with spare beads and stop before over-fusing.

    What is glitter or texture cloth?

    It is a heat-resistant sheet with sparkle or a molded texture that can transfer a glossy or patterned finish. Products tolerate different temperatures, so follow the material instructions and begin with a short test.

    When should I use masking tape and flip the piece?

    Using masking tape: Use it for large or fragile layouts, or whenever the unfused beads must leave the pegboard before ironing.

    Without masking tape: Small patterns can stay on the pegboard, and some texture sheets do not require a transfer step.

    Do not confuse the two papers.

    Masking tape holds and transfers unfused beads. It does not replace ironing paper or parchment.

    Keep a heat-resistant barrier between the iron and the piece.

    Transferred with masking tape
    Finish materialFlip?
    Ironing paper or parchmentYes
    Glossy sheetYes
    Towel or wet clothNo
    Glitter or texture sheetNo
    Steamer clothNo
    Diamond texture sheetNo
    Kept on the pegboard
    Finish materialFlip?
    Ironing paper or parchmentNo
    Glossy sheetNo
    Towel or wet clothYes
    Glitter or texture sheetYes
    Steamer clothYes
    Diamond texture sheetNo

    Here, “flip” means turning the piece so the intended texture surface touches the beads. It is separate from ironing both sides for extra strength.

    FAQ

    Questions before you make it

    Can I use another bead brand?

    Yes. Match by the displayed color and verify close shades before buying. The current list is mapped to MARD.

    How many pegboards do I need?

    Use 4 standard 52×52 boards or 1 large 104×104 board.

    What if the full pattern is too large to follow?

    Export the coded PDF and complete the design in labeled sections. Check the seam between sections before ironing.

    Should I iron one side or both sides?

    One-sided ironing is usually enough for framed or display pieces. Iron both sides for keychains or pieces that will be handled often, but keep some bead holes visible so the result does not become brittle.

    How can I keep the finished pattern flat?

    Move the iron continuously, avoid overheating the edges, then cool the piece under a flat, heat-safe weight before lifting it.

    Who should handle the ironing step?

    An adult should handle the hot iron and heat-resistant paper. Keep children away from the heated work surface until the piece has cooled completely.

    Can I resize this pattern?

    Yes, but scaling changes the grid and color count. Regenerate the pattern at the target dimensions instead of stretching the exported image.

    How should I move a large unfinished pattern?

    Secure it in sections with masking tape or complete it on connected pegboards. Check every board seam before transferring or ironing.

    \ No newline at end of file diff --git a/competitor-analysis/raw/pattern-yuan-shen-en-text.txt b/competitor-analysis/raw/pattern-yuan-shen-en-text.txt new file mode 100644 index 0000000..ba0691a --- /dev/null +++ b/competitor-analysis/raw/pattern-yuan-shen-en-text.txt @@ -0,0 +1,332 @@ +原神 启动! Perler Bead Pattern | 48×48 Free Download +Pixel Beads Art +Home +Bead Pattern Generator +Bead Art +Image to Pixel Art +Showcase +Theme Beads +Patterns +Apps +Help +English +Home +Pattern Library +原神 启动! +Free printable bead pattern +原神 启动! Perler Bead Pattern — 48×48 Free Download +Download the 原神 启动! perler bead pattern for free. This 48×48 design uses about 2,304 beads and matches the MARD palette. +Preview the pattern and material list, then export a color-coded image or PDF. +Check stray and transition colors before making +Photo conversion can create a few stray colors along the edges where color areas meet. Outline each area first, then remove colors you do not need. +Keep continuous transition colors when they help the image look more natural. +Want to refine it manually? Open Bead Art +Estimated time +3–5 hr +Views +6,664 +Author +豆豆猫 +August 8, 2026 +Material Brand +MARD +原神 启动! Perler Bead Pattern Preview +Full pattern shown. Zoom in to inspect details. +Dimensions +Colors +Total Beads +2,304 +Show grid +Fit to screen +Make this pattern +For bead placement, start with the PDF. +The PDF includes the grid, bead codes, and materials list for step-by-step printing and making. +Export PDF (recommended) +Export PNG (preview/share) +PNG works best for previews and sharing; use the PDF as your making reference. +Customize export style +Square · Small · codes included +These settings affect the exported file and preview only. They do not change the source pattern. +Bead Style +Square beads are easiest to check cell by cell; round styles look closer to finished beads. +Square +Round +Hollow +Grid Spacing +Small spacing is recommended for printing; large spacing separates individual beads more clearly. +None +Small +Large +Bill of Materials +87 colors required +Total Beads +2,304 +High-use colors to prepare first +H18 +523 +152 +G18 +117 +H21 +116 +D10 +115 +There are also 52 low-use colors with 10 beads or fewer each. Keep them separately labeled. +View all 87 colors +H18 +523 +152 +G18 +117 +H21 +116 +D10 +115 +C18 +112 +E16 +108 +H12 +H19 +H13 +A23 +G21 +C12 +M15 +M10 +H10 +H14 +M12 +G16 +G14 +A22 +E23 +H20 +H23 +H17 +G17 +C29 +H11 +D22 +F20 +M14 +H16 +A17 +H22 +G11 +G13 +A21 +C20 +D24 +H15 +E21 +M13 +D18 +A25 +A18 +B21 +D11 +C27 +F21 +M11 +G12 +G15 +C13 +E11 +F17 +F16 +A16 +A11 +A24 +A20 +B11 +B26 +Pattern +In-depth guide +More patterns +Copy page link +Make it with confidence +原神 启动! making guide +Check the board layout, high-use colors, and outline shades before placing the first bead. +Work from the edges into the large color areas, then finish the small details. +Before you start +Check color boundaries and remove stray colors before placement. +Keep intentional transition shades that shape curves and shadows. +Outline each area first, then fill large blocks and small details. +Open the complete making guide +Includes six making steps, advanced ironing methods, and common questions. +Finished size +24 × 24 cm +Estimated with standard 5 mm beads. +Pegboards +1 standard +Or 1 large 104×104 board. +Difficulty +intermediate +Based on size and total bead count. +Boards +Materials +Place +Check +Export +Iron +FAQ +Plan the size and board layout +Choose the board layout before you place the first bead. +Use 1 standard 52×52 board or 1 large 104×104 board. +Leave a safe margin around the edge of each board. +Allow about 24 × 24 cm plus extra space if you plan to frame the piece. +Prepare high-use and detail colors +Check the material list before you start so missing colors do not interrupt the project. +Set aside the highest-count colors first. +Keep similar shades in separate, labeled trays. +Avoid casual substitutions in outlines, eyes, text, and other high-contrast details. +Set the edges, then fill the color areas +Use the outline as a position reference before filling the largest areas. +Place the key edges and corners first. +Fill the largest color areas after the outline is stable. +Add small colors and high-contrast details last. +Slow down at diagonals and color transitions +Curves and diagonal lines can shift by one bead when a row changes. +Compare each row instead of continuing a curve from memory. +Keep transition shades that follow the shape or lighting. +Scan the finished design for isolated small colors before ironing. +Save the version you need +Use the PDF for making and the image for sharing. +Keep the grid and color codes in the PDF for row-by-row checks. +Use the image export for a quick phone reference or preview. +Zoom into the PDF when similar shades are hard to distinguish. +Iron and cool evenly +Even pressure and a full cooling cycle help the finished piece stay flat. +Cover the beads with ironing paper and use the heat recommended by the bead brand. +Move the iron in small circles instead of holding it in one spot. +Cool the piece under a flat, heat-safe weight before removing it from the board. +Advanced ironing: six finishes compared +Choose the surface you want before the first pass. +Each material changes how heat and pressure reach the beads, so test the same brand and temperature on a small sample first. +Glossy finish +A reflective, sealed surface with stronger highlights and less visible bead texture. +Standard finish +Recommended +Clear bead outlines with balanced fusion, suitable for most display pieces. +Waffle finish +A fine grid is pressed into the fused surface for a regular woven texture. +Towel finish +A soft fabric impression gives the surface a gentler, more tactile look. +Glitter finish +A transparent reflective layer adds sparkle while keeping the underlying colors visible. +Wet-cloth finish +A fine, even cloth texture creates a softer matte surface. +The examples come from different pieces and lighting conditions. They compare general surface texture rather than serving as a controlled test. +Temperature, time, bead brand and barrier material all affect the result. +What is towel ironing? +Place a flat, dry, thin towel with no heavy weave under the piece, then iron through heat-resistant paper. The softer base changes pressure and heat transfer, so test with spare beads and stop before over-fusing. +What is glitter or texture cloth? +It is a heat-resistant sheet with sparkle or a molded texture that can transfer a glossy or patterned finish. Products tolerate different temperatures, so follow the material instructions and begin with a short test. +When should I use masking tape and flip the piece? +Using masking tape: +Use it for large or fragile layouts, or whenever the unfused beads must leave the pegboard before ironing. +Without masking tape: +Small patterns can stay on the pegboard, and some texture sheets do not require a transfer step. +Do not confuse the two papers. +Masking tape holds and transfers unfused beads. It does not replace ironing paper or parchment. +Keep a heat-resistant barrier between the iron and the piece. +Transferred with masking tape +Finish material +Flip? +Ironing paper or parchment +Yes +Glossy sheet +Yes +Towel or wet cloth +Glitter or texture sheet +Steamer cloth +Diamond texture sheet +Kept on the pegboard +Finish material +Flip? +Ironing paper or parchment +Glossy sheet +Towel or wet cloth +Yes +Glitter or texture sheet +Yes +Steamer cloth +Yes +Diamond texture sheet +Here, “flip” means turning the piece so the intended texture surface touches the beads. It is separate from ironing both sides for extra strength. +FAQ +Questions before you make it +Can I use another bead brand? +Yes. Match by the displayed color and verify close shades before buying. The current list is mapped to MARD. +How many pegboards do I need? +Use 1 standard 52×52 board or 1 large 104×104 board. +What if the full pattern is too large to follow? +Export the coded PDF and complete the design in labeled sections. Check the seam between sections before ironing. +Should I iron one side or both sides? +One-sided ironing is usually enough for framed or display pieces. Iron both sides for keychains or pieces that will be handled often, but keep some bead holes visible so the result does not become brittle. +How can I keep the finished pattern flat? +Move the iron continuously, avoid overheating the edges, then cool the piece under a flat, heat-safe weight before lifting it. +Who should handle the ironing step? +An adult should handle the hot iron and heat-resistant paper. Keep children away from the heated work surface until the piece has cooled completely. +Can I resize this pattern? +Yes, but scaling changes the grid and color count. Regenerate the pattern at the target dimensions instead of stretching the exported image. +How should I move a large unfinished pattern? +Secure it in sections with masking tape or complete it on connected pegboards. Check every board seam before transferring or ironing. +Pixel Beads Art +Pattern Studio +Explore +Home +Showcase +Pattern Library +Blog +Create +Generator +Pixel Bead Art +Image to Pixel Art +Apps & Support +Apps +Chrome Extension +Android App +iOS App +Help +Contact +Company & Legal +About Us +Privacy Policy +Terms of Service +Featured & Listed +© 2026 • Pixel Beads Art +Keep making +Perler bead patterns you may also like +Browse more bead patterns with a similar size profile and popular library picks. +100 +175,834 +朱迪警官 +View pattern +182,216 +史迪奇 +View pattern +83,203 +王橹杰拼豆 +View pattern +54,460 +View pattern +73,791 +ikun +View pattern +164,632 +可爱猫咪 +View pattern +79,795 +姜饼人 +View pattern +93,944 +hello kitty +View pattern +53,443 +凯蒂猫 1 +View pattern +188,667 +MC-不死图腾 +View pattern \ No newline at end of file diff --git a/competitor-analysis/raw/pattern-yuan-shen-en.html b/competitor-analysis/raw/pattern-yuan-shen-en.html new file mode 100644 index 0000000..8e0336e --- /dev/null +++ b/competitor-analysis/raw/pattern-yuan-shen-en.html @@ -0,0 +1,3 @@ +原神 启动! Perler Bead Pattern | 48×48 Free Download +

    Free printable bead pattern

    原神 启动! Perler Bead Pattern — 48×48 Free Download

    Download the 原神 启动! perler bead pattern for free. This 48×48 design uses about 2,304 beads and matches the MARD palette.

    Preview the pattern and material list, then export a color-coded image or PDF.

    Estimated time3–5 hr
    Views6,664
    Author: 豆豆猫Material Brand: MARD

    原神 启动! Perler Bead Pattern Preview

    Full pattern shown. Zoom in to inspect details.

    Dimensions
    48 × 48
    Colors
    87
    Total Beads
    2,304
    原神 启动! perler bead pattern 48×48 preview
    50%

    Make it with confidence

    原神 启动! making guide

    Check the board layout, high-use colors, and outline shades before placing the first bead.

    Work from the edges into the large color areas, then finish the small details.

    Open the complete making guideIncludes six making steps, advanced ironing methods, and common questions.

    Finished size

    24 × 24 cm

    Estimated with standard 5 mm beads.

    Pegboards

    1 standard

    Or 1 large 104×104 board.

    Difficulty

    intermediate

    Based on size and total bead count.

    01

    Plan the size and board layout

    Choose the board layout before you place the first bead.

    1. 1.Use 1 standard 52×52 board or 1 large 104×104 board.
    2. 2.Leave a safe margin around the edge of each board.
    3. 3.Allow about 24 × 24 cm plus extra space if you plan to frame the piece.
    02

    Prepare high-use and detail colors

    Check the material list before you start so missing colors do not interrupt the project.

    1. 1.Set aside the highest-count colors first.
    2. 2.Keep similar shades in separate, labeled trays.
    3. 3.Avoid casual substitutions in outlines, eyes, text, and other high-contrast details.
    03

    Set the edges, then fill the color areas

    Use the outline as a position reference before filling the largest areas.

    1. 1.Place the key edges and corners first.
    2. 2.Fill the largest color areas after the outline is stable.
    3. 3.Add small colors and high-contrast details last.
    04

    Slow down at diagonals and color transitions

    Curves and diagonal lines can shift by one bead when a row changes.

    1. 1.Compare each row instead of continuing a curve from memory.
    2. 2.Keep transition shades that follow the shape or lighting.
    3. 3.Scan the finished design for isolated small colors before ironing.
    05

    Save the version you need

    Use the PDF for making and the image for sharing.

    1. 1.Keep the grid and color codes in the PDF for row-by-row checks.
    2. 2.Use the image export for a quick phone reference or preview.
    3. 3.Zoom into the PDF when similar shades are hard to distinguish.
    06

    Iron and cool evenly

    Even pressure and a full cooling cycle help the finished piece stay flat.

    1. 1.Cover the beads with ironing paper and use the heat recommended by the bead brand.
    2. 2.Move the iron in small circles instead of holding it in one spot.
    3. 3.Cool the piece under a flat, heat-safe weight before removing it from the board.

    Advanced ironing: six finishes compared

    Choose the surface you want before the first pass.

    Each material changes how heat and pressure reach the beads, so test the same brand and temperature on a small sample first.

    Fused-bead piece with a reflective glossy surface
    Glossy finish

    A reflective, sealed surface with stronger highlights and less visible bead texture.

    Fused-bead piece with clear bead outlines after standard ironing
    Standard finishRecommended

    Clear bead outlines with balanced fusion, suitable for most display pieces.

    Fused-bead piece with a fine waffle-grid texture
    Waffle finish

    A fine grid is pressed into the fused surface for a regular woven texture.

    Fused-bead piece with a soft towel-pressed texture
    Towel finish

    A soft fabric impression gives the surface a gentler, more tactile look.

    Fused-bead piece with a transparent glitter finish
    Glitter finish

    A transparent reflective layer adds sparkle while keeping the underlying colors visible.

    Fused-bead piece with a fine wet-cloth texture
    Wet-cloth finish

    A fine, even cloth texture creates a softer matte surface.

    The examples come from different pieces and lighting conditions. They compare general surface texture rather than serving as a controlled test.

    Temperature, time, bead brand and barrier material all affect the result.

    What is towel ironing?

    Place a flat, dry, thin towel with no heavy weave under the piece, then iron through heat-resistant paper. The softer base changes pressure and heat transfer, so test with spare beads and stop before over-fusing.

    What is glitter or texture cloth?

    It is a heat-resistant sheet with sparkle or a molded texture that can transfer a glossy or patterned finish. Products tolerate different temperatures, so follow the material instructions and begin with a short test.

    When should I use masking tape and flip the piece?

    Using masking tape: Use it for large or fragile layouts, or whenever the unfused beads must leave the pegboard before ironing.

    Without masking tape: Small patterns can stay on the pegboard, and some texture sheets do not require a transfer step.

    Do not confuse the two papers.

    Masking tape holds and transfers unfused beads. It does not replace ironing paper or parchment.

    Keep a heat-resistant barrier between the iron and the piece.

    Transferred with masking tape
    Finish materialFlip?
    Ironing paper or parchmentYes
    Glossy sheetYes
    Towel or wet clothNo
    Glitter or texture sheetNo
    Steamer clothNo
    Diamond texture sheetNo
    Kept on the pegboard
    Finish materialFlip?
    Ironing paper or parchmentNo
    Glossy sheetNo
    Towel or wet clothYes
    Glitter or texture sheetYes
    Steamer clothYes
    Diamond texture sheetNo

    Here, “flip” means turning the piece so the intended texture surface touches the beads. It is separate from ironing both sides for extra strength.

    FAQ

    Questions before you make it

    Can I use another bead brand?

    Yes. Match by the displayed color and verify close shades before buying. The current list is mapped to MARD.

    How many pegboards do I need?

    Use 1 standard 52×52 board or 1 large 104×104 board.

    What if the full pattern is too large to follow?

    Export the coded PDF and complete the design in labeled sections. Check the seam between sections before ironing.

    Should I iron one side or both sides?

    One-sided ironing is usually enough for framed or display pieces. Iron both sides for keychains or pieces that will be handled often, but keep some bead holes visible so the result does not become brittle.

    How can I keep the finished pattern flat?

    Move the iron continuously, avoid overheating the edges, then cool the piece under a flat, heat-safe weight before lifting it.

    Who should handle the ironing step?

    An adult should handle the hot iron and heat-resistant paper. Keep children away from the heated work surface until the piece has cooled completely.

    Can I resize this pattern?

    Yes, but scaling changes the grid and color count. Regenerate the pattern at the target dimensions instead of stretching the exported image.

    How should I move a large unfinished pattern?

    Secure it in sections with masking tape or complete it on connected pegboards. Check every board seam before transferring or ironing.

    \ No newline at end of file diff --git a/competitor-analysis/raw/perler-bead-pattern-en-text.txt b/competitor-analysis/raw/perler-bead-pattern-en-text.txt new file mode 100644 index 0000000..df886b0 --- /dev/null +++ b/competitor-analysis/raw/perler-bead-pattern-en-text.txt @@ -0,0 +1,206 @@ +Perler Bead Patterns Gallery | Pixel Art & Fuse Bead Designs +Pixel Beads Art +Home +Bead Pattern Generator +Bead Art +Image to Pixel Art +Showcase +Theme Beads +Patterns +Apps +Help +English +Perler Bead Patterns Gallery +Browse and download pixel bead patterns. +Explore our collection of pixel art perler beads, fuse bead patterns, and perler bead ideas. Find inspiration for your next perler bead art gallery project. +Popular Pixel Art & Fuse Bead Designs +Sort By +Most Popular +Latest +线条小狗 +线条小狗 +211,629 +View Details +MC-不死图腾 +188,667 +View Details +史迪奇 +182,216 +View Details +朱迪警官 +100 +175,834 +View Details +可爱猫咪 +164,632 +View Details +钻石剑 +155,802 +View Details +hello kitty +93,944 +View Details +王橹杰拼豆 +83,203 +View Details +姜饼人 +可爱的姜饼人冰箱贴 +79,795 +View Details +ikun +73,791 +View Details +初音未来 +68,107 +View Details +不死图腾 +66,549 +View Details +54,460 +View Details +凯蒂猫 1 +53,443 +View Details +53,227 +View Details +哥伦比娅 +可可爱爱的小鸽子 +53,116 +View Details +皮卡丘 +50,839 +View Details +MC不死图腾 +50,492 +View Details +49,843 +View Details +124 +49,478 +View Details +金苹果 +49,437 +View Details +最厉害 +49,331 +View Details +安琪拉 +安琪拉超可爱 +48,981 +View Details +正义必胜 +100 +46,345 +View Details +44,814 +View Details +hellokitty +44,562 +View Details +苦力怕 +43,843 +View Details +黑色柳丁 +43,511 +View Details +羽毛球 +100 +109 +43,297 +View Details +星之卡比 +42,591 +View Details +线条小狗吃饭 +42,295 +View Details +小格温 +42,245 +View Details +白敬亭生日图 +118 +41,767 +View Details +41,297 +View Details +39,960 +View Details +不要狗叫 +39,959 +View Details +风生水起 +100 +100 +39,608 +View Details +海绵宝宝 +39,157 +View Details +38,807 +View Details +三角洲房卡 +38,734 +View Details +大脚豆 +纯炫耀,不出 +38,220 +View Details +水豚噜噜 +37,724 +View Details +laopo +37,670 +View Details +梦泪名刀 +37,637 +View Details +抱着星星的帕恰狗 +37,492 +View Details +伊索尔德表情包官网 +36,952 +View Details +meijishu +尽可能 +36,905 +View Details +kity +36,900 +View Details +乔尼·乔斯达 +36,849 +View Details +杰克狐 +36,778 +View Details +... +102 +Page 1 +of 102 +Turn Patterns into Custom Pixel Art +Found a pattern you love? Use our free perler bead pattern generator to customize designs, adjust colors, and create your own pixel art patterns. Transform any image into a fuse bead pattern in seconds. +Start Creating Patterns +Pixel Beads Art +Pattern Studio +Explore +Home +Showcase +Pattern Library +Blog +Create +Generator +Pixel Bead Art +Image to Pixel Art +Apps & Support +Apps +Chrome Extension +Android App +iOS App +Help +Contact +Company & Legal +About Us +Privacy Policy +Terms of Service +Featured & Listed +© 2026 • Pixel Beads Art \ No newline at end of file diff --git a/competitor-analysis/raw/perler-bead-pattern-en.html b/competitor-analysis/raw/perler-bead-pattern-en.html new file mode 100644 index 0000000..62c60f7 --- /dev/null +++ b/competitor-analysis/raw/perler-bead-pattern-en.html @@ -0,0 +1,2 @@ +Perler Bead Patterns Gallery | Pixel Art & Fuse Bead Designs +

    Perler Bead Patterns Gallery

    Browse and download pixel bead patterns. Explore our collection of pixel art perler beads, fuse bead patterns, and perler bead ideas. Find inspiration for your next perler bead art gallery project.

    Popular Pixel Art & Fuse Bead Designs

    perler bead pattern pixel art 线条小狗

    线条小狗

    线条小狗

    50x46211,629
    View Details
    perler bead pattern pixel art MC-不死图腾

    MC-不死图腾

    50x50188,667
    View Details
    perler bead pattern pixel art 史迪奇

    史迪奇

    50x63182,216
    View Details
    perler bead pattern pixel art 朱迪警官

    朱迪警官

    100x93175,834
    View Details
    perler bead pattern pixel art 可爱猫咪

    可爱猫咪

    80x75164,632
    View Details
    perler bead pattern pixel art 钻石剑

    钻石剑

    16x16155,802
    View Details
    perler bead pattern pixel art hello  kitty

    hello kitty

    50x6093,944
    View Details
    perler bead pattern pixel art 王橹杰拼豆

    王橹杰拼豆

    50x7883,203
    View Details
    perler bead pattern pixel art 姜饼人

    姜饼人

    可爱的姜饼人冰箱贴

    50x5979,795
    View Details
    perler bead pattern pixel art ikun

    ikun

    80x8173,791
    View Details
    perler bead pattern pixel art 初音未来

    初音未来

    26x2568,107
    View Details
    perler bead pattern pixel art 不死图腾

    不死图腾

    无

    30x3266,549
    View Details
    perler bead pattern pixel art 喻繁

    喻繁

    99x9954,460
    View Details
    perler bead pattern pixel art 凯蒂猫 1

    凯蒂猫 1

    50x5053,443
    View Details
    perler bead pattern pixel art 小马

    小马

    56x5053,227
    View Details
    perler bead pattern pixel art 哥伦比娅

    哥伦比娅

    可可爱爱的小鸽子

    50x4853,116
    View Details
    perler bead pattern pixel art 皮卡丘

    皮卡丘

    50x5550,839
    View Details
    perler bead pattern pixel art MC不死图腾

    MC不死图腾

    24x2650,492
    View Details
    perler bead pattern pixel art 比格

    比格

    50x5049,843
    View Details
    perler bead pattern pixel art 噜噜

    噜噜

    噜噜

    80x12449,478
    View Details
    perler bead pattern pixel art 金苹果

    金苹果

    12x1449,437
    View Details
    perler bead pattern pixel art 最厉害

    最厉害

    50x6749,331
    View Details
    perler bead pattern pixel art 安琪拉

    安琪拉

    安琪拉超可爱

    80x7148,981
    View Details
    perler bead pattern pixel art 正义必胜

    正义必胜

    100x6046,345
    View Details
    perler bead pattern pixel art 威龙

    威龙

    50x4544,814
    View Details
    perler bead pattern pixel art hellokitty

    hellokitty

    50x6244,562
    View Details
    perler bead pattern pixel art 苦力怕

    苦力怕

    20x2043,843
    View Details
    perler bead pattern pixel art 黑色柳丁

    黑色柳丁

    50x5043,511
    View Details
    perler bead pattern pixel art 羽毛球

    羽毛球

    100x10943,297
    View Details
    perler bead pattern pixel art 星之卡比

    星之卡比

    25x2442,591
    View Details
    perler bead pattern pixel art 线条小狗吃饭

    线条小狗吃饭

    50x2542,295
    View Details
    perler bead pattern pixel art 小格温

    小格温

    40x4142,245
    View Details
    perler bead pattern pixel art 白敬亭生日图

    白敬亭生日图

    80x11841,767
    View Details
    perler bead pattern pixel art 狗

    狗

    50x5141,297
    View Details
    perler bead pattern pixel art 小新

    小新

    50x5739,960
    View Details
    perler bead pattern pixel art 不要狗叫

    不要狗叫

    50x5039,959
    View Details
    perler bead pattern pixel art 风生水起

    风生水起

    100x10039,608
    View Details
    perler bead pattern pixel art 海绵宝宝

    海绵宝宝

    50x3739,157
    View Details
    perler bead pattern pixel art 佐助

    佐助

    50x5038,807
    View Details
    perler bead pattern pixel art 三角洲房卡

    三角洲房卡

    50x3138,734
    View Details
    perler bead pattern pixel art 大脚豆

    大脚豆

    纯炫耀,不出

    38x4038,220
    View Details
    perler bead pattern pixel art 水豚噜噜

    水豚噜噜

    噜噜

    50x4937,724
    View Details
    perler bead pattern pixel art laopo

    laopo

    97x9737,670
    View Details
    perler bead pattern pixel art 梦泪名刀

    梦泪名刀

    80x8037,637
    View Details
    perler bead pattern pixel art 抱着星星的帕恰狗

    抱着星星的帕恰狗

    30x2937,492
    View Details
    perler bead pattern pixel art 伊索尔德表情包官网

    伊索尔德表情包官网

    80x8036,952
    View Details
    perler bead pattern pixel art meijishu

    meijishu

    尽可能

    80x8036,905
    View Details
    perler bead pattern pixel art kity

    kity

    44x4136,900
    View Details
    perler bead pattern pixel art 乔尼·乔斯达

    乔尼·乔斯达

    70x5236,849
    View Details
    perler bead pattern pixel art 杰克狐

    杰克狐

    50x7036,778
    View Details
    ...

    Turn Patterns into Custom Pixel Art

    Found a pattern you love? Use our free perler bead pattern generator to customize designs, adjust colors, and create your own pixel art patterns. Transform any image into a fuse bead pattern in seconds.

    Start Creating Patterns
    \ No newline at end of file diff --git a/competitor-analysis/raw/perler-beads-en-text.txt b/competitor-analysis/raw/perler-beads-en-text.txt new file mode 100644 index 0000000..c4e6a7a --- /dev/null +++ b/competitor-analysis/raw/perler-beads-en-text.txt @@ -0,0 +1,231 @@ +Perler Beads Patterns & Free Generator | PixelBeads +Pixel Beads Art +Home +Bead Pattern Generator +Bead Art +Image to Pixel Art +Showcase +Theme Beads +Patterns +Apps +Help +English +Community pattern gallery +Perler Beads Patterns +Browse printable bead art ideas, inspect real pattern cards, then turn your own image into a clean Perler bead blueprint. +Generate a Pattern +Browse Patterns +5mm +standard beads +2.6mm +mini bead mode +PDF +print export +线条小狗 +50 x 46 +史迪奇 +50 x 63 +朱迪警官 +100 x 93 +MC-不死图腾 +50 x 50 +可爱猫咪 +80 x 75 +钻石剑 +16 x 16 +Golden Apple +12 x 14 +Parallel Lines +15 x 15 +Mini Smile +13 x 13 +Diamond Pickaxe +16 x 16 +Mini Totem +17 x 17 +Luca Portrait +10 x 22 +Beginner +Animals +Game sprites +Characters +Mini beads +Objects +Printable +Featured patterns +Start with the pattern, not the paragraph. +A larger visual index of printable bead ideas. Every card shows what you can make, how large it is, and how much craft work it asks from you. +Animals +线条小狗 +50 x 46 +colors +2.3k +beads +Medium +Characters +史迪奇 +50 x 63 +colors +3.1k +beads +Advanced +Characters +朱迪警官 +100 x 93 +colors +9.3k +beads +Advanced +Game sprites +MC-不死图腾 +50 x 50 +colors +2.5k +beads +Medium +Animals +可爱猫咪 +80 x 75 +colors +1.4k +beads +Easy +Game sprites +钻石剑 +16 x 16 +colors +256 +beads +Easy +Objects +Golden Apple +12 x 14 +colors +168 +beads +Easy +Mini beads +Parallel Lines +15 x 15 +colors +225 +beads +Easy +Beginner +Mini Smile +13 x 13 +colors +143 +beads +Easy +Game sprites +Diamond Pickaxe +16 x 16 +colors +beads +Easy +Game sprites +Mini Totem +17 x 17 +colors +173 +beads +Easy +Characters +Luca Portrait +10 x 22 +colors +220 +beads +Medium +Game sprites +Diamond Sword Alt +16 x 16 +colors +beads +Easy +Mini beads +Mini Blade +15 x 15 +colors +225 +beads +Easy +Characters +Luca Mini +10 x 22 +colors +220 +beads +Medium +Characters +Luca Sprite +10 x 22 +colors +220 +beads +Medium +Explore the full gallery +Image to blueprint +Make your own Perler bead pattern from any image. +Upload a photo, choose a bead size, limit the palette, then export a printable bead chart with real color counts. The generator stays close to the gallery experience instead of sending people into a different product world. +Upload an image +Original +Bead pattern +How to use it +A gallery that leads into making. +The browsing flow stays lightweight: pick an idea, inspect the constraints, then generate or download with confidence. +Browse a pattern first +Start from finished perler bead patterns with visible size, color count, bead estimate, and difficulty. +Match your bead palette +Use Perler, Hama, Artkal, MARD, Nabbi, or IKEA Pyssla colors before you begin placing beads. +Export a clean blueprint +Download a print-ready chart with color mapping and bead counts instead of guessing from a photo. +Quick guide +Perler beads, without the wall of text. +Keep the educational content, but make it serve the gallery. The page gives beginners just enough context to choose a project and start. +Decision note +5mm beads +Best for first projects, classroom crafts, gifts, and designs that need forgiving placement. +Decision note +2.6mm mini beads +Best for detailed portraits, compact display pieces, and pixel art that needs finer resolution. +Decision note +Fewer colors +Easier to buy, sort, place, and iron. This is usually better for a beginner-friendly pattern. +Decision note +More colors +Better gradients and smoother photo conversion, but more sorting and a longer build session. +Frequently asked questions +What are Perler beads? +Perler beads are small fuse beads arranged on a pegboard to make pixel art. After ironing, the beads fuse into a finished piece. +Can I turn any image into a Perler bead pattern? +Yes. Upload a photo or illustration, choose a grid size and palette, then export the converted bead chart. +Which size is best for beginners? +Standard 5mm beads are easier to handle and iron. Mini 2.6mm beads are better for detailed portraits and advanced work. +Do I need a specific bead brand? +No, but it is best to keep one brand inside a single project because color ranges and melting behavior can differ. +Pixel Beads Art +Pattern Studio +Explore +Home +Showcase +Pattern Library +Blog +Create +Generator +Pixel Bead Art +Image to Pixel Art +Apps & Support +Apps +Chrome Extension +Android App +iOS App +Help +Contact +Company & Legal +About Us +Privacy Policy +Terms of Service +Featured & Listed +© 2026 • Pixel Beads Art \ No newline at end of file diff --git a/competitor-analysis/raw/perler-beads-en.html b/competitor-analysis/raw/perler-beads-en.html new file mode 100644 index 0000000..cd78da0 --- /dev/null +++ b/competitor-analysis/raw/perler-beads-en.html @@ -0,0 +1,44 @@ +Perler Beads Patterns & Free Generator | PixelBeads +
    Community pattern gallery

    Perler Beads Patterns

    Browse printable bead art ideas, inspect real pattern cards, then turn your own image into a clean Perler bead blueprint.

    5mm
    standard beads
    2.6mm
    mini bead mode
    PDF
    print export

    Image to blueprint

    Make your own Perler bead pattern from any image.

    Upload a photo, choose a bead size, limit the palette, then export a printable bead chart with real color counts. The generator stays close to the gallery experience instead of sending people into a different product world.

    Original preview for perler bead pattern generatorOriginal
    Bead pattern preview for perler bead pattern generatorBead pattern

    How to use it

    A gallery that leads into making.

    The browsing flow stays lightweight: pick an idea, inspect the constraints, then generate or download with confidence.

    01

    Browse a pattern first

    Start from finished perler bead patterns with visible size, color count, bead estimate, and difficulty.

    02

    Match your bead palette

    Use Perler, Hama, Artkal, MARD, Nabbi, or IKEA Pyssla colors before you begin placing beads.

    03

    Export a clean blueprint

    Download a print-ready chart with color mapping and bead counts instead of guessing from a photo.

    Quick guide

    Perler beads, without the wall of text.

    Keep the educational content, but make it serve the gallery. The page gives beginners just enough context to choose a project and start.

    Decision note

    5mm beads

    Best for first projects, classroom crafts, gifts, and designs that need forgiving placement.

    Decision note

    2.6mm mini beads

    Best for detailed portraits, compact display pieces, and pixel art that needs finer resolution.

    Decision note

    Fewer colors

    Easier to buy, sort, place, and iron. This is usually better for a beginner-friendly pattern.

    Decision note

    More colors

    Better gradients and smoother photo conversion, but more sorting and a longer build session.

    Frequently asked questions

    What are Perler beads?+

    Perler beads are small fuse beads arranged on a pegboard to make pixel art. After ironing, the beads fuse into a finished piece.

    Can I turn any image into a Perler bead pattern?+

    Yes. Upload a photo or illustration, choose a grid size and palette, then export the converted bead chart.

    Which size is best for beginners?+

    Standard 5mm beads are easier to handle and iron. Mini 2.6mm beads are better for detailed portraits and advanced work.

    Do I need a specific bead brand?+

    No, but it is best to keep one brand inside a single project because color ranges and melting behavior can differ.

    \ No newline at end of file diff --git a/competitor-analysis/raw/pokemon-champions-en.html b/competitor-analysis/raw/pokemon-champions-en.html new file mode 100644 index 0000000..22984b3 --- /dev/null +++ b/competitor-analysis/raw/pokemon-champions-en.html @@ -0,0 +1,325 @@ +Pokemon Champions Perler Bead Patterns - Free Pixel Art +
    HomeShowcasePokemon Champions Perler Bead Patterns
    62
    Free Patterns
    18
    Pokemon Types
    4
    Difficulty Tiers
    100%
    Free Downloads
    5mm
    Standard Bead Size
    §01

    Browse the Full Pokemon Champions Perler Bead Pattern Collection

    Every design in our Pokemon Champions pattern library includes a printable pixel grid, estimated bead count, and a clear difficulty level so you can choose a project that fits your time and ambition.

    Filter Pokemon Champions perler bead patterns by type
    AllElectricFireWaterGrassPsychicDragonLegendaryChampion
    + + + + + + + + + + Easy
    Electric Champion
    15×14 beads~30 min7 colors
    + + + + + + + + + + Easy
    Fire Lizard Starter
    12×14 beads~25 min6 colors
    + + + + + + + + + Easy
    Water Turtle Starter
    12×13 beads~25 min5 colors
    + + + + + + + + + Legendary
    Psychic Legendary
    14×15 beads~50 min8 colors
    + + + + + + + + Easy
    Grass Seed Starter
    13×14 beads~25 min6 colors
    + + + + + + + + + + Champion
    Dragon Champion Elite
    16×16 beads~60 min6 colors
    Legendary
    From Library
    宝可梦皮卡丘
    50x53 beads64 colorswww.pixel-beads.com
    Legendary
    From Library
    宝可梦小火龙
    50x52 beads91 colorswww.pixel-beads.com
    Legendary
    From Library
    宝可梦杰克龟
    50x50 beads64 colorswww.pixel-beads.com

    Showing 12 Pokemon Champions perler bead patterns, including 6 from the library — Load full Pokedex →

    §02

    How to Make Pokemon Champions Perler Bead Patterns Step by Step

    Creating Pokemon Champions perler bead patterns follows a simple four-step process. Once you learn the basics, you can build anything from quick starter portraits to multi-board legendary scenes.

    Download the Pattern

    Choose a Pokemon Champions design and print the grid so you can follow each bead row with confidence.

    Sort Your Colors

    Prepare your bead colors in advance so you are not stopping every few rows to search for the next shade.

    Place Beads Row by Row

    Work from top to bottom and keep an eye on edge details, especially on champion-tier pixel art with long outlines.

    Fuse, Cool, and Display

    Cover the design with ironing paper, fuse it evenly, then let it cool flat before framing or displaying it.

    Starter Tier

    Starter and Fan-Favorite Pokemon Champions Perler Bead Patterns

    Starter-tier designs are the perfect entry point. They use fewer beads, smaller grids, and simpler color sets while still looking iconic on a desk, shelf, or keychain.

    • Mini electric mouse icons you can finish in under 20 minutes
    • Classic starter trio projects that display well as a set
    • Simple silhouette patterns for practicing pegboard placement
    • Pokeball and badge builds that work as quick accent pieces
    • Chibi-style starter designs with expressive faces
    Browse Starter Pokemon Champions Patterns →
    Champion Tier

    Legendary and Champion-Tier Perler Bead Designs for Expert Crafters

    These advanced builds use larger layouts, richer shading, and multi-board compositions. They are ideal for crafters who want a statement piece worthy of a full Pokemon display wall.

    • Large legendary dragon builds across joined pegboards
    • Psychic champion portraits with glow-like color layering
    • Battle scene layouts with dramatic stadium energy
    • Advanced fire builds with gradient flame shading
    • Elite Four display sets for a full championship collection
    Browse Champion Pokemon Patterns →
    §03

    Pro Tips for Flawless Pokemon Champions Perler Bead Results

    A few practical habits will help your finished Pokemon bead projects stay crisp, colorful, and sturdy instead of warped or muddy.

    Match Your Beads to the Pixel Palette

    Take time to compare similar blues, reds, and yellows before you start so the final sprite stays true to the original design.

    Iron Both Sides for Stronger Builds

    Champion-sized projects hold up better when both sides are fused lightly instead of melting only one surface.

    Use Parchment Paper, Not Wax Paper

    Parchment paper gives cleaner results and protects fine edges on detailed legendary and trainer designs.

    Photograph the Layout Before Ironing

    A quick reference photo makes it much easier to fix a shifted bead right before the final fuse.

    Switch to Mini Beads for Extra Detail

    Using mini beads on the same grid gives you a more compact and intricate result for display-grade pieces.

    Plan Multi-Board Seams Early

    When a design spans more than one pegboard, plan the joining rows before you start so outlines stay aligned.

    §04

    Frequently Asked Questions About Pokemon Champions Perler Bead Patterns

    What are Pokemon Champions perler bead patterns?
    They are pixel-art bead grids inspired by champion-tier Pokemon characters, starters, and battle icons. You place colored beads on a pegboard and fuse them with ironing paper to create finished fan art.
    Are all the Pokemon Champions patterns on this page free?
    Yes. The featured patterns on this page are free to browse and use for personal crafting projects.
    How many beads do these projects usually need?
    Small starter builds may use well under 300 beads, while larger champion or legendary projects can use well over 1000 depending on the grid size.
    What pegboard size should I prepare?
    Many starter designs fit on a single standard square pegboard, but larger champion pieces may need two or more boards connected together.
    Are these patterns suitable for kids?
    Yes, many of the simpler starter builds are kid-friendly with supervision. The ironing step should always be handled by an adult.
    Can I mix Perler, Hama, and Artkal beads?
    For standard 5mm projects, many crafters mix brands successfully, but color matching and melt behavior can vary slightly between bead lines.

    Ready to Catch Them All in Beads?

    Browse all free Pokemon Champions perler bead patterns, save your favorites, and build your own pixel-art Pokedex one bead at a time.

    Browse All Pokemon Champions Patterns ↑
    \ No newline at end of file diff --git a/competitor-analysis/raw/privacy-policy-en.html b/competitor-analysis/raw/privacy-policy-en.html new file mode 100644 index 0000000..11c8039 --- /dev/null +++ b/competitor-analysis/raw/privacy-policy-en.html @@ -0,0 +1,2 @@ +Privacy Policy +

    Privacy Policy

    Last updated: August 2, 2026

    Pixel Beads Art ("we," "our," or "us") operates the website at https://www.pixel-beads.com — a free online Perler bead pattern generator. We are committed to protecting your privacy and being transparent about how we handle your data. Please read this Privacy Policy carefully before using our website.

    1. Overview

    By continuing to use Pixel Beads Art, you agree to the terms described in this Privacy Policy.

    2. Information We Collect

    2.1 Automatically Collected Information

    When you visit our website, we may automatically collect non-personally identifiable information, including IP address and approximate geographic location, browser type and version, operating system, pages visited and time spent on each page, referring URL, and device type (desktop, tablet, mobile).

    2.2 Information You Provide

    If you contact us via our contact form, we may collect your name and email address solely for the purpose of responding to your inquiry. We do not store this information beyond what is necessary to reply.

    2.3 Cookies and Tracking Technologies

    We use cookies and similar tracking technologies to enhance your experience and to serve relevant advertising. You may disable cookies through your browser settings, though doing so may affect the functionality of certain features on our website.

    3. Google AdSense

    Our website uses Google AdSense to display third-party advertisements. Google AdSense is an advertising service provided by Google LLC. It may use cookies and web beacons to serve ads based on your prior visits to this and other websites.

    3.1 What Google Collects

    Google AdSense may collect and use the following data for ad serving: anonymous identifiers stored in cookies, browsing behavior on this and other websites, interest categories used for personalized advertising, and device information and anonymized IP address.

    3.2 Opting Out of Personalized Ads

    You can opt out of personalized advertising by Google through: Google Ad Settings (https://www.google.com/settings/ads), Network Advertising Initiative (https://optout.networkadvertising.org/), or Your Online Choices for EU users (https://www.youronlinechoices.eu/).

    3.3 Google's Privacy Policy

    For full details on how Google collects and uses data, please review: https://policies.google.com/privacy

    4. Third-Party Services

    We may use the following third-party services, each governed by their own privacy policies: Google AdSense (display advertising) and Google Analytics (website traffic analysis). We do not control how these third parties collect or use your information. We encourage you to review their respective privacy policies.

    ServicePurposePrivacy Policy
    Google AdSenseDisplay advertisingpolicies.google.com/privacy
    Google AnalyticsWebsite traffic analysispolicies.google.com/privacy

    5. Cookie Policy

    5.1 Types of Cookies We Use

    Cookie TypePurpose
    NecessaryRequired for core website functionality
    AnalyticsHelp us understand how visitors use our site (via Google Analytics)
    AdvertisingUsed by Google AdSense to serve relevant ads

    5.2 Managing Your Cookie Preferences

    You can manage or disable cookies through your browser settings. Please note that disabling cookies may impact the functionality of certain features on this website.

    6. Children's Privacy

    Our website is not directed at children under the age of 13. We do not knowingly collect personal information from children under 13. If you believe we have inadvertently collected such information, please contact us immediately and we will delete it promptly.

    7. User-Uploaded Images

    When you use our pattern generator, you may upload an image to convert it into a bead pattern.

    If you choose to make your pattern public: Your uploaded image and the generated pattern will be stored on our servers and displayed publicly on the website, where other users can view and use it.

    If you choose to keep your pattern private: We will not store your image or pattern on our servers. The image is processed temporarily in your browser or on our server solely to generate the pattern preview, and is immediately discarded once the session ends. We do not retain any copy of non-public images.

    You are responsible for ensuring that any image you upload does not infringe on third-party rights. By making a pattern public, you grant Pixel Beads Art a non-exclusive license to display that content on the website.

    Chrome Extension Imports

    Using the Perler Bead Art Chrome extension is user initiated. After you select its right-click command, the extension temporarily stores the selected image, source page URL and title, file name, and transfer metadata locally in the browser for no longer than 10 minutes.

    The extension sends this transfer directly to the Pixel Beads generator in this browser tab without a temporary image-upload server. The temporary extension record is deleted after the generator acknowledges or rejects the import, or it expires. The website keeps the transfer only in this tab's memory while it is processed.

    Extension import analytics use only coarse technical fields and exclude the image, source URL or domain, page title, file name, transfer ID, hash, and exact dimensions or file size. If you later choose to publish a pattern, that separate action follows the public-content rules above.

    Pixel Beads Android App

    This section applies specifically to the Pixel Beads Android app (package name com.pixelbeads.app), provided by Pixel Beads Art. The app works offline, does not require an account, does not display advertising, and does not include analytics, tracking, or third-party advertising SDKs.

    Photos are selected through Android's system photo picker and processed entirely on your device. The app does not upload or transmit your photos, generated patterns, or editing activity to us.

    Saved patterns remain only in the app's private storage on your device. Android backup is disabled for the app. PNG or PDF files are created only when you choose to export or share them, and are stored or sent only to the destination you select. Uninstalling the app removes its private app data; copies you previously exported remain at the destination you selected.

    The Android app does not collect or share personal data with us. If you contact support, we use the information you provide only to respond to your request.

    8. Your Rights

    Depending on your location, you may have the following rights regarding your personal data:

    • Access: Request a copy of the personal data we hold about you
    • Correction: Request correction of inaccurate or incomplete data
    • Deletion: Request deletion of your personal data under certain conditions
    • Restriction: Request that we limit how we process your data
    • Portability: Receive your data in a structured, machine-readable format
    • Objection: Object to our processing of your personal data

    To exercise any of these rights, please contact us using the details in Section 12.

    9. Data Security

    We implement reasonable technical and organizational measures to protect your information, including HTTPS encryption for all data transmissions. However, no method of transmission over the internet is 100% secure, and we cannot guarantee absolute security.

    10. International Data Transfers

    Our servers and third-party service providers may be located outside your country or region. By using this website, you consent to the transfer of your information to these locations, which may have different data protection laws than your jurisdiction.

    11. Changes to This Policy

    We may update this Privacy Policy from time to time. Any changes will be posted on this page with an updated revision date. We recommend reviewing this page periodically to stay informed. Continued use of our website after changes are posted constitutes your acceptance of the updated policy.

    12. Contact Us

    If you have any questions, concerns, or requests regarding this Privacy Policy, please reach out to us at https://www.pixel-beads.com/contact

    © 2026 Pixel Beads Art. All Rights Reserved. — https://www.pixel-beads.com

    \ No newline at end of file diff --git a/competitor-analysis/raw/terms-of-service-en.html b/competitor-analysis/raw/terms-of-service-en.html new file mode 100644 index 0000000..5c263a1 --- /dev/null +++ b/competitor-analysis/raw/terms-of-service-en.html @@ -0,0 +1,2 @@ +Terms of Service +

    Terms of Service

    Last updated: January 3, 2026

    Welcome to PixelBeads. By accessing or using our website, you agree to comply with and be bound by these Terms of Service.

    1. Use of the Service

    PixelBeads provides a tool for creating perler bead patterns from images. You may use this service for personal and non-commercial purposes only, unless otherwise authorized by us.

    2. User Conduct

    You agree not to use the service for any unlawful purpose or to upload any content that is offensive, harmful, or infringes on the intellectual property rights of others.

    3. Intellectual Property

    The content and tools on PixelBeads are protected by intellectual property laws. You may not reproduce, distribute, or create derivative works without our permission.

    4. Disclaimer of Warranties

    The service is provided "as is" without any warranties of any kind. We do not guarantee that the service will be uninterrupted or error-free.

    5. Limitation of Liability

    In no event shall PixelBeads be liable for any damages arising out of your use of or inability to use the service.

    6. Changes to Terms

    We reserve the right to modify these Terms of Service at any time. Your continued use of the service constitutes acceptance of the new terms.

    7. Governing Law

    These terms shall be governed by and construed in accordance with the laws of the jurisdiction in which we operate.

    \ No newline at end of file diff --git a/docs/ANIMATION-PLAN.md b/docs/ANIMATION-PLAN.md new file mode 100644 index 0000000..f24b4f7 --- /dev/null +++ b/docs/ANIMATION-PLAN.md @@ -0,0 +1,220 @@ +# ANIMATION-PLAN · 拼豆图纸生成器 动画落地决策文档 + +> 任务: T-086(基于 `competitor-analysis/animation-research.md` 的正式动画技术选型与落地清单) +> 日期: 2026-08-14 +> 范围: 本任务只产出决策文档,**不含任何源码改动**(实施为后续任务) +> 适用前端: `D:\拼豆\perler-lab`(Vite 5 + React 18 + TS 5.9,目前 **无任何动画库依赖**) + +--- + +## 0. 决策摘要(一句话选型结论) + +> **「CSS 动画打底,leafer.js 升级画布,anime.js 按需补序列」**——先纯 CSS 对齐竞品基准线(0 新增依赖、P0 全量可交付),V2 再引入 leafer.js(图纸画布渲染/交互)+ anime.js(豆子放置、stagger 序列)做差异化动效;**不引入** GSAP、Framer Motion、lottie-web。 + +P0 动画清单 **10 条**(全部纯 CSS 可实现,无需新增依赖)。 + +--- + +## 1. 现状盘点(抽查 `perler-lab/src` 结论) + +| 项 | 现状 | 结论 | +|---|---|---| +| 动画依赖 | `package.json` 仅 react/react-dom,**无动画库** | 0 依赖现状,P0 保持 | +| CSS 动画 | 仅 3 个 keyframes(`spin` 0.7s、`share-toast-in` 0.18s、`chibi-spin` 0.7s)+ 大量 `transition: … 0.15s ease` hover 过渡 | 只有基础 hover/spinner,缺入场/序列/反馈类动画 | +| `prefers-reduced-motion` | **全项目未出现** | 必补(见 §6) | +| 运动令牌 | 有 `--space/--radius/--shadow`,**无 `--duration/--ease`** | 需新增运动令牌(见 §4.3) | +| 图纸渲染 | `lib/drawPattern.ts` 原生 Canvas 2D `fillRect` 逐格绘制 | 竞品同款方案,P0 可不动;V2 换 leafer.js | +| 图片处理 | `lib/usePattern.ts` 主线程调 `processImage`(**无 Web Worker**) | A1 进度动画前置条件 = 先迁移 Worker,否则主线程阻塞直接掉帧 | +| 页面切换 | App.tsx 按 pathname 条件渲染 `/chibi` 与首页,**无过渡动画** | V2 用 View Transitions API | +| 反馈系统 | 分享 toast 已有(`share-toast-in`),下载/错误为静态文字 | P0 补下载成功反馈 | + +竞品基准线(来自调研报告 §1.4):「原生 Canvas 渲染 + CSS 合成层过渡 + Web Worker 过程可视化 + 克制 200-500ms 节奏」——我们 P0 即对齐此线。 + +--- + +## 2. 技术选型对比表 + +| 维度 | **CSS @keyframes/transition** | **GSAP** | **Framer Motion** | **leafer.js** | **anime.js**(调研报告推荐项) | +|---|---|---|---|---|---| +| 类型 | 原生动画 | JS 补间引擎(DOM/JS 对象/时间线/scrub) | React 动画组件库 | 2D Canvas 场景图渲染引擎 | JS 补间引擎(轻量) | +| 体积 | 0 | ~23KB+ gz(core) | ~35KB+ gz | 按需模块,数百 KB 级(仅画布层承担) | 16.1KB gz(v4 按需更小) | +| 场景适配 | hover/loading/toast/简单入场/过渡 | 复杂交错时间线、滚动驱动、scrub | React DOM 组件过渡/手势(**不作用于 canvas**) | 图纸网格渲染、豆子交互/动画(**核心差异化**) | spring 弹性、stagger 序列、属性补间 | +| 与本项目契合 | ★★★★★ 竞品 56 处 transition 已证明足够 | ★★☆ 工具型产品无复杂时间线需求,杀鸡用牛刀 | ★★☆ 项目是纯 CSS + 原生 canvas 架构,不是 Framer 体系;只为页面过渡引入不值 | ★★★★★ 图纸本质数千~数万矩形,正是批处理强项(画布渲染**唯一**直接对标项) | ★★★★ 体积小、spring/stagger 可拉开差距 | +| 主要风险 | 无序列化(需 animation-delay 模拟)、无 spring 物理 | 重、侵入强、学习/维护成本 | 与现有 CSS 体系并存冗余 | 引入成本高(需重写渲染层),仅 V2 承担 | 作者维护缓慢(调研报告 §2),仅按需用其时序能力 | +| **推荐结论** | **P0 主力(立即可用)** | **不引入** | **不引入** | **V2 引入(画布层)** | **V2 按需引入(序列层)** | + +> 另:**lottie-web**(调研报告 §3.1 第 4 层)→ **不引入**。无 AE 设计师资源,60KB runtime 成本与产出不成正比;品牌庆祝类动画后期用 CSS/SVG 手工实现(低成本版见 §5-H-02)。 + +--- + +## 3. 推荐技术栈(分层架构) + +``` +┌───────────────────────────────────────────────┐ +│ 第 4 层 品牌/庆祝动画 → CSS/SVG 手工(V2 可选) 无 lottie,无 AE 依赖 +├───────────────────────────────────────────────┤ +│ 第 3 层 JS 序列/弹簧微动画 → anime.js(V2 按需,16KB) 豆子放置 spring、stagger、颜色闪烁序列 +├───────────────────────────────────────────────┤ +│ 第 2 层 基础 UI 过渡 → CSS/Tailwind 风格令牌(P0) hover、loading、toast、下载反馈、入场 +├───────────────────────────────────────────────┤ +│ 第 1 层 图纸画布渲染/交互 → leafer.js(V2) 豆子网格 + 拖拽 + 实时更新(替代原生 fillRect) +└───────────────────────────────────────────────┘ +``` + +**推荐理由(结合 Vite+React+TS 现状):** +1. **零依赖 P0 先行**:竞品"高级感"全部来自 CSS 合成层动画(56 处 transition 佐证),我们当前代码已有一致基础(`transition 0.15s`),P0 只是"补齐遗漏项",不动架构、不加依赖,风险最低。 +2. **leafer.js 是画布层的唯一直接对标**:调研报告 §3.2-1 给出迁移实测(Konva→Leafer:4K 帧率 25-30→58-60、DrawCall 800+→<50、点选 80ms→10ms),且官方 benchmark 覆盖平移/缩放/拖拽/全动态场景,正对应图纸预览。当前原生 `fillRect` 在 >1 万豆大图纸 + 动画场景下必然掉帧,leafer 的批处理 DrawCall + 脏矩形刷新是硬需求而非炫技。 +3. **anime.js 而非 GSAP/Framer Motion**:差异化动效(A2 spring 回弹、A3 闪烁序列)只需要补间 + stagger + spring 三个能力,anime 16KB 模块化刚好覆盖;GSAP 的 scrub/时间线编排在工具型产品用不上;Framer Motion 只对 React DOM 组件生效,救不了 canvas,且与现有纯 CSS 体系双轨冗余。 +4. **显式排除**:GSAP / Framer Motion / lottie —— 成本(体积/体系侵入/维护)× 收益(本产品场景用不上)不成立。 + +--- + +## 4. 落地前置:运动设计令牌(新增,属 P0 基础设施) + +在设计系统 `:root` 新增(对齐竞品节奏:`200/500ms`): + +```css +:root { + --duration-fast: 120ms; /* 按压/闪烁单拍 */ + --duration-base: 200ms; /* hover、toast(竞品默认) */ + --duration-med: 400ms; /* 遮罩淡入、进度过渡 */ + --duration-slow: 600ms; /* 图纸渐入、卡片缩放(竞品 500ms 档) */ + --ease-out: cubic-bezier(0.16, 1, 0.3, 1); /* 标准退场 */ + --ease-in-out: cubic-bezier(0.65, 0, 0.35, 1); + --spring-bead: cubic-bezier(0.34, 1.56, 0.64, 1); /* 豆子回弹近似 */ +} +``` + +所有动画必须引用上述令牌,禁止魔数时长(对齐设计系统纪律)。 + +--- + +## 5. 逐页面动画清单 + +> 优先级: **P0** = V1 必须上线(纯 CSS,0 依赖,对齐竞品基准);**P1** = V1 尽量(可纯 CSS,补细节);**P2** = V2(需引库或大改)。 +> 编号沿用调研报告 A1-A5,扩展为可执行粒度。 + +### 5.1 首页 Hero(`components/Hero.tsx`) + +| 编号 | 组件 | 动画类型 | 触发时机 | 优先级 | +|---|---|---|---|---| +| H-01 | hero-eyebrow / hero-title / hero-sub / hero-stats | 首屏 stagger 入场:`opacity 0→1` + `translateY(12px)→0`,依次 delay 60ms,总时长 <900ms | 页面首次加载 | **P1**(CSS `animation-delay` 即可) | +| H-02 | hero-title `em`(accent) | 高亮词微动效:`background-position`/`opacity` 呼吸或扫光一次 | 入场后 1s 延迟 | P2(装饰,视效果定) | + +### 5.2 首页 AI 专区 / `/chibi`(`ChibiPage.tsx` + `ChibiPage.css`) + +| 编号 | 组件 | 动画类型 | 触发时机 | 优先级 | +|---|---|---|---|---| +| C-01 | chibi 上传按钮 / 卡片区 | 列表 stagger 入场(opacity+translateY,delay 60ms) | 页面加载 | **P1** | +| C-02 | chibi-spinner(已有 `chibi-spin`) | 保留;补按钮双文案切换("处理中…"/"开始") | 生成过程 | **P1** | +| C-03 | chibi 结果卡片 hover | 图片 `scale(1.03→1.08)` 500ms + 遮罩 opacity 淡入(竞品 §1.3-5 同款) | 桌面 hover | **P1** | + +### 5.3 编辑画布(`PreviewPanel.tsx` + `lib/drawPattern.ts`) + +| 编号 | 组件 | 动画类型 | 触发时机 | 优先级 | +|---|---|---|---|---| +| E-01 | 生成进度(**A1**) | ① 生成按钮 loading 态:图标 `spin` + 文案"处理中…";② 画布 `filter: blur(6px)→0` + `opacity 0→1` 600ms;③ 画布下细进度条 0→100% | 点击"生成图纸"后(迁移 Web Worker 后主线程才有余力跑动画) | **P0** | +| E-02 | 编辑工具栏按钮(撤销/旋转/镜像等) | 按下按压反馈:`transform: scale(0.97)` / translateY(1px) 120ms(现只有 translateY,补 scale) | `:active` | **P0** | +| E-03 | 编辑操作应用(旋转/镜像/翻转后) | 画布内容轻过渡:`opacity 0.4→1` 150ms(防突变闪烁) | 每次编辑变换生效 | **P0** | +| E-04 | 豆子放置动画(**A2**,差异化核心) | leafer.js 中每颗豆 `scale 0→1` spring 回弹(stiffness 170 / damping 26)120-180ms;连续放置 `stagger 30ms` 瀑布式填充;颜色切换瞬时 + `brightness(1.4)` 120ms 发光 | 用户在画布点击/填充豆子(leafer 交互对象) | **P2** | +| E-05 | 颜色匹配闪烁(**A3**) | 匹配豆呼吸闪烁 2 次(`opacity 1→0.4→1`,各 150ms)或描边光环扩散 300ms 消失 | 选中色与图纸豆色匹配 / 吸管取色 | **P2** | +| E-06 | 画布拖拽(竞品 §1.3-3 对齐) | `transform: translate3d(x,y,0)` + `will-change-transform` 合成层拖拽 | 图纸拖动 | **P2**(leafer 内置交互) | + +### 5.4 按钮 / 全局交互 + +| 编号 | 组件 | 动画类型 | 触发时机 | 优先级 | +|---|---|---|---|---| +| B-01 | 下载按钮反馈(**A4**) | ① 图标切换 ✓(transition-colors 变绿 200ms);② `active:scale(0.95)` 100ms;③ 导出 >500ms 时 SVG 进度环(`stroke-dashoffset`);④ toast "图纸已保存 ✓" | 点击"下载图纸" | **P0** | +| B-02 | 上传/重置按钮 | hover 背景过渡 + active 按压(现 `transition 0.15s` 已覆盖,统一套用令牌) | hover / active | **P0** | +| B-03 | Nav 链接 hover | 下划线滑入 / 背景过渡(现 color 过渡,补 underline) | 桌面 hover | P1 | +| B-04 | 分享按钮成功反馈 | toast 已有(`share-toast-in`);补按钮 ✓ 变色 200ms | 分享成功 | **P0** | + +### 5.5 页面过渡 / 弹窗 + +| 编号 | 组件 | 动画类型 | 触发时机 | 优先级 | +|---|---|---|---|---| +| T-01 | 弹窗(Redeem/Order/Agency Modal)打开/关闭 | fade + `scale 0.96→1` 200ms 入场 / 150ms 退场(对齐 toast 既有 keyframes 风格) | 弹窗开关 | **P0** | +| T-02 | 页面切换(首页 ↔ /chibi)(**A5**) | View Transitions API 圆形扩散 400ms / 或 clip-path 擦除过渡 | 路由切换 | P2 | +| T-03 | 首屏总入场 | 依 H-01/C-01,配合 Toast 入场 | 页面加载 | P1 | + +### 5.6 优先级汇总 + +| 优先级 | 条数 | 清单 | +|---|---|---| +| **P0** | **10** | E-01、E-02、E-03、B-01、B-02、B-04、T-01、(+§4 运动令牌 + §6 reduced-motion 全局降级) | +| **P1** | **5** | H-01、C-01、C-02、C-03、T-03、(B-03) | +| **P2** | **6** | H-02、E-04、E-05、E-06、T-02 | + +--- + +## 6. 性能与可访问性约束(硬性要求) + +### 6.1 可访问性 +- **`prefers-reduced-motion: reduce` 全局降级**(P0 必做): + ```css + @media (prefers-reduced-motion: reduce) { + *, *::before, *::after { + animation-duration: 0.01ms !important; + animation-iteration-count: 1 !important; + transition-duration: 0.01ms !important; + scroll-behavior: auto !important; + } + } + ``` + 所有入场/闪烁/缩放类动画都必须有降级路径;信息传达(toast、进度)**不依赖动画**表达。 +- 动画不得承载关键信息(加载态必须有文字文案,不只靠 spinner)。 + +### 6.2 移动端 60fps +- **只动画 `transform` / `opacity` / `filter`**,不碰 `width/height/top/left/margin`(避免 layout thrash 与 reflow)。 +- 动画元素加 `will-change: transform` 仅用于已知持续动画(如画布拖拽),**不滥用**(会占用内存)。 +- 进度条宽度动画改 `transform: scaleX()`(合成层)而非 `width`。 +- **图片转图纸必须先迁 Web Worker**(当前 `usePattern.ts` 主线程调用 `processImage`),否则生成期间主线程被 JS 计算占满,任何动画都会掉帧——E-01 与 Worker 迁移绑定交付。 +- 大图纸(>1 万豆)V1 画布渲染保持现有原生 `fillRect`;leafer.js 迁移(E-04/05/06)在 V2 一次性承担,避免 V1 双渲染引擎并存。 + +### 6.3 通用纪律 +- 动画时长/缓动一律走 §4 令牌,禁魔数。 +- 入场动画总时长 ≤900ms,避免拖慢首屏;首屏 FCP/LCP 不因动画代码增加而劣化(动画只在 CSS,不阻塞)。 +- hover 类动画仅桌面端生效(`@media (hover: hover)`),避免移动端误触触发。 + +--- + +## 7. 实施顺序建议 + +### V1 上线(本次动画里程碑,P0+P1,**0 新增依赖**) +1. §4 运动令牌(`--duration-*`/`--ease-*`)写入 `:root` +2. §6.1 `prefers-reduced-motion` 全局降级 +3. **图片处理迁 Web Worker**(E-01 前置,`usePattern.ts` → `new Worker`) +4. E-01 生成进度动画(按钮 loading 双文案 + 画布 blur 渐入 + scaleX 进度条) +5. E-02/E-03 编辑工具按压与变换过渡 +6. B-01/B-04 下载/分享成功反馈(✓ 变色 + toast) +7. T-01 弹窗入场退场 +8. P1:H-01 Hero stagger 入场、C-01/C-03 专区入场与卡片 hover、B-03 Nav 下划线 + +**V1 验收口径**:移动端滚动/交互无掉帧(无 Worker 阻塞)、reduced-motion 下无动画、全部时长引用令牌。 + +### V2 上线(差异化阶段,引入依赖) +1. 引入 **leafer.js**,重写图纸画布渲染层(替换 `drawPreview` 原生 fillRect),搭交互对象 +2. E-04 豆子放置 spring + stagger(anime.js `spring(stiffness:170, damping:26)` 或 leafer 属性补间) +3. E-05 颜色匹配闪烁、E-06 画布拖拽合成层 +4. T-02 页面切换 View Transitions +5. H-02 品牌装饰动效(CSS/SVG 手工) + +**V2 验收口径**:>1 万豆图纸拖拽/放置动画保持 60fps(对齐调研报告迁移实测数据:DrawCall <50、点选 <10ms)。 + +### 决策树(后续实施时判断) +``` +需要动画 → + hover/loading/按压/toast/弹窗/简单入场/过渡 → CSS(永远优先,V1) + 画布网格/豆子交互/拖拽 → leafer.js(V2) + spring 回弹 / stagger 序列(CSS 表达不了) → anime.js(V2 按需) + 复杂滚动驱动时间线/scrub → 场景未出现,届时再评估 GSAP(现不引入) + 品牌 AE 级动画 → 无设计师,不引 lottie;CSS/SVG 手工 +``` + +--- + +## 8. 附注 + +- 本文档仅决策,不含实施;实施任务引用本清单编号(E-01…、H-01…、C-01…、B-01…、T-01…)作验收依据。 +- 竞品基线出处: `competitor-analysis/animation-research.md` §1.3(Canvas 渲染 / Worker 加载态 / translate3d 拖拽 / sonner 反馈 / 卡片 500ms hover)、§3.1(分层架构)、§4(A1-A5 效果参数)。 +- 画布性能数据出处: 调研报告 §3.2-1(Konva→Leafer 迁移实测)。 diff --git a/docs/BUSINESS-MODEL.md b/docs/BUSINESS-MODEL.md new file mode 100644 index 0000000..785fca4 --- /dev/null +++ b/docs/BUSINESS-MODEL.md @@ -0,0 +1,216 @@ +# PERLER LAB · 商业模式细化:免费功能与兑换码付费边界 + +> 任务: T-104 | 产出角色: PM-Agent | 日期: 2026-08-14 +> 关联: PRD.md(权益体系/定价)、LAUNCH.md(冷启动/代理)、AGENT.md(代理合作)、`perler-lab-server/src/codes`(兑换码模块)、`competitor-analysis/pixelbeads-analysis.md` §6(竞品纯免费模式) +> 结论预览: **「核心全免费、增值收兑换码」混合策略**——图纸生成全链路免费(防流失对标 pixel-beads),AI 生成 / 高清与多格式导出 / 无水印 / 高级功能走兑换码付费。共 **免费 12 项 + 付费 9 项**。 + +--- + +## 1. 背景与核心矛盾 + +### 1.1 商业模式现状 + +我方基线是竞品 **xylpindou.com** 的「预览免费 + 兑换码解锁下载」模式,已建成完整兑换码模块(`PACKAGE_DEFINITIONS` 6 档套餐、`/api/codes/redeem|consume|status`、下载授权 grant、风控限流),MVP 已跑通全链路。 + +### 1.2 核心矛盾(主代理研判) + +新竞品 **pixel-beads.com**(2026-08 深度爬取确认)是**纯免费模式**:首页明示「完全免费 / 无需注册 / 图片本地处理」,无定价页(`/pricing` 404)、无广告、无登录墙,导出 PDF/PNG/SVG/JSON 全免费、含水印/署名可选。其收入靠 SEO 流量 + 三端应用分发。 + +> **风险**: 若我方把「图纸生成核心」也做成兑换码付费,用户可零成本转投 pixel-beads,流失风险极高。 +> **结论**: 商业模式最大分水岭 = **免费核心是否足够强**。必须采用「免费核心 + 付费高级」混合策略:免费部分对齐竞品防流失,付费部分落在竞品没有或我方独特的增值点上。 + +### 1.3 本文件目标 + +1. 明确**免费功能清单**(对齐竞品、保证核心闭环不流失)。 +2. 明确**兑换码付费功能清单**(增值收费点)。 +3. 定价策略(参考竞品纯免费 + 我方兑换码差异)。 +4. 代理分成逻辑(对齐 AGENT.md 与 codes 模块)。 +5. 功能边界原则(核心免费、增值收费,可执行可验收)。 + +--- + +## 2. 竞品商业模式对照(决策依据) + +| 维度 | pixel-beads(纯免费) | xylpindou(兑换码,我方基线) | **我方最终策略** | +|---|---|---|---| +| 核心生成 | 完全免费 | 预览免费/下载付费 | **完全免费**(对齐 pixel-beads 防流失) | +| 注册/登录 | 无登录墙 | 无 | 无登录墙 | +| AI 生成 | **无**(图片转像素画,非 AI) | AI chibi 15 风格,付费 | **AI 生成付费**(我方独特增值点) | +| 导出 | PDF/PNG/SVG/JSON 全免费 | 高清 PNG 付费 | **基础 PNG 免费 / 高清与多格式付费** | +| 水印 | 无(水印/署名可选附加) | - | **无水印导出付费**(基础下载带轻水印) | +| 高级编辑 | 图层/对称/矩形全免费 | - | **基础编辑免费;高级工具付费** | +| 收入来源 | SEO 流量 + 应用分发 | 兑换码 | 兑换码(含代理分销) + SEO 引流 | + +> **规则推导**: 竞品免费的功能,凡属于「完成一张可拼图纸」的必要能力(生成/预览/备料/基础导出),我方必须免费;只有「超出必要、属于增值/便利/独有」的能力才收费。这样免费用户不会因功能缺失而流失。 + +--- + +## 3. 免费功能清单(12 项,防流失底线) + +> 原则: 免费版必须能走通「上传 → 生成 → 预览 → 基础下载」完整闭环,且预览质量不设人为限制(对齐竞品)。 + +| # | 功能 | 说明 | 对齐竞品 | +|---|---|---|---| +| F-01 | 图片上传 | JPG/PNG/WebP ≤10MB,拖拽+点击,浏览器本地处理 | pixel-beads 免费 | +| F-02 | 参数调整 | 格数/色数/去背景/背景色/品牌色板切换,**不限次数反复生成** | pixel-beads 免费 | +| F-03 | 图纸生成核心 | 采样→量化→色板匹配全算法,**无条件免费**(不得加锁) | pixel-beads 免费 | +| F-04 | 图纸完整预览 | 豆圆+色号+网格编号+缩放,**完整质量预览**(不得加水印遮挡) | pixel-beads 免费 | +| F-05 | 备料清单查看 | 总颗数/色数/分色用量/多备 10% 建议,**完整明细免费** | pixel-beads 免费(materials 统计) | +| F-06 | 基础编辑器 | 画笔/橡皮/取色器/撤销重做 | pixel-beads 编辑器免费 | +| F-07 | 基础下载 | **标准分辨率 PNG 图纸下载(带轻水印)**——免费闭环出口 | pixel-beads 免费 PNG;我方用「分辨率+水印」分层 | +| F-08 | 兑换码兑换与权益查询 | redeem / status / consume 基础链路本身免费 | xylpindou 兑换免费 | +| F-09 | 色号表浏览 | MARD/Artkal-C/Perler/Hama 等品牌色号页全量浏览(SEO 内容) | pixel-beads 6 品牌色号页免费 | +| F-10 | 图纸本地保存 | localStorage 保存/重载(MVP 无账号,权益本地存储) | pixel-beads localStorage | +| F-11 | 分享 URL | 图纸编码分享链接 | pixel-beads 作品 URL 分享 | +| F-12 | 帮助/FAQ 中心 | 实操知识、兑换说明、熨烫/选豆指南 | pixel-beads 帮助中心 | + +**防流失校验(F-01~F-07)**: 免费用户上传一张图,可以**不看任何付费提示**完成「生成→预览→看到色号与备料→下载一张能用的基础图纸」。付费墙只出现在"想要更高清/多格式/无水印/AI"时,绝不卡在"能不能用"上。 + +--- + +## 4. 兑换码付费功能清单(9 项,增值收费点) + +> 每次权益按「次」计(对齐 PRD 4.1:下载/AI 均 1 次),由 codes 模块 `consumeCode` 原子扣减。 + +| # | 功能 | 消耗 | 依据/定位 | +|---|---|---|---| +| P-01 | **AI 拼豆生成**(chibi) | 1 次/张 | 竞品 pixel-beads 无 AI,**我方独特增值点**,MVP 已验证转化场景 | +| P-02 | **高清 PNG 图纸下载** | 1 次/张 | 高分辨率打印级图纸(竞品免费,我方以基础版免费+高清收费分层) | +| P-03 | **PDF 高清打印导出**(含分块/300DPI) | 1 次/张 | 对标 pixel-beads P0-导出差距;PDF 是打印刚需 | +| P-04 | **无水印导出** | 1 次/张 | 水印是基础免费与付费的分层抓手 | +| P-05 | **SVG / JSON 工程文件导出** | 1 次/张 | 专业用户(矢量/工程数据) | +| P-06 | **高级编辑工具**(图层/对称/矩形选区/旋转镜像) | 1 次/次操作包 | 面向深度用户;基础编辑免费、专业工具收费 | +| P-07 | **批量生成/批量导出**(代理场景) | 按批量次数 | 对应代理套餐消耗逻辑(AGENT.md 200/500/1000 次) | +| P-08 | **商用授权** | 1 次/张 | 商用图纸授权(LAUNCH FAQ 已提示「商用需授权」) | +| P-09 | **AI 结果转正式图纸并高清下载** | 1 次/张 | AI 生成已扣 1 次,转正式图纸的首次高清下载含在生成内,**再次下载不扣**(对齐 PRD 4.2) | + +**P 与 F 的边界**: +- F-07 基础下载(标准分辨率+水印)免费 → P-02/P-03/P-04 高清/PDF/无水印付费。 +- F-06 基础编辑免费 → P-06 高级编辑付费。 +- F-03 核心生成免费 → P-01 AI 生成付费(算法生成 ≠ AI 生成,两类不同价值)。 + +--- + +## 5. 定价策略 + +### 5.1 个人套餐(沿用 PRD 4.1,与 codes 模块 `PACKAGE_DEFINITIONS` 一致) + +| 套餐 | 价格 | 次数 | 单次成本 | 目标 | +|---|---|---|---|---| +| 体验包 | ¥4.9 | 3 | ¥1.63 | 首单钩子,降低决策门槛 | +| 常用包 | ¥12.9 | 10 | ¥1.29 | 手工爱好者日常 | +| 进阶包 | ¥29.9 | 30 | ¥1.00 | 深度用户 | + +### 5.2 代理套餐(沿用 AGENT.md §4,codes 模块一致) + +| 套餐 | 价格 | 次数 | 单次成本 | +|---|---|---|---| +| 入门代理 | ¥139 | 200 | ¥0.70 | +| 标准代理 | ¥299 | 500 | ¥0.60 | +| 核心代理 | ¥499 | 1000 | ¥0.50 | + +### 5.3 定价逻辑(参考竞品纯免费 + 我方兑换码差异) + +1. **免费核心 = 获客引擎**:对齐 pixel-beads 纯免费,用「免费生成完整可用」换取 SEO 流量与口碑,替代竞品的投放获客。 +2. **兑换码 = 变现引擎**:付费点全部落在「增值/独有」上(AI、高清、无水印、PDF、商用授权),不与竞品免费能力正面冲突。 +3. **单次成本递减引导升级**:¥1.63 → ¥1.29 → ¥1.00 →(代理)¥0.70/0.60/0.50,引导向大套餐/代理迁移。 +4. **代理价差 = 分销空间**:代理单次成本(0.50–0.70)显著低于个人零售(1.00–1.63),为转售留出 3–10 元/张利润空间(对齐 AGENT.md §1)。 +5. **权益按次通用**:AI 与下载等价扣 1 次,不区分用途(PRD 4.1),系统复杂度最低。 + +--- + +## 6. 代理分成逻辑 + +> 与 `AGENT.md`、`LAUNCH.md §3`、codes 模块代理套餐完全一致,此处固化分成模型。 + +### 6.1 角色与收益模型 + +| 角色 | 收入/成本 | 说明 | +|---|---|---| +| **平台** | 套餐全价(¥139/299/499) | 一次性收入,按次交付(兑换码核销) | +| **代理** | 收入:接单/卖图 3–10 元/张;成本:单次 0.50–0.70 元 | 单张毛利 ≈ 2.3–9.5 元(按 10 元/张、0.50 成本计利润率 ~90%+) | +| **代理的客户** | 向代理付费,不接触平台 | 代理承担收款与服务 | + +### 6.2 分成/分销机制 + +1. **代理差价分成**:平台以批发价(0.50–0.70/次)售出,代理以零售价(3–10 元/张)转售,差额归代理——这是主分成。 +2. **推广返佣**:专属推广链接(带代理标识),客户经链接购买**个人套餐**,按约定比例返佣(AGENT.md FAQ-10;返佣比例由运营在系统外核定,作为 C 端补充激励)。 +3. **阶梯价**:累计采购 ≥1000 次可谈阶梯价(例:降至 ¥0.45/次档),量大从优(AGENT.md §4 补充规则)。 +4. **升级补齐**:代理升级按差价补齐、已购权益保留(AGENT.md FAQ-5),不损失存量。 +5. **风控约束**:代理码走代理通道、个人码走个人通道,不可混用(AGENT.md FAQ-7);异常核销走 codes 风控限流 + `security_events` 滥用检测(codes 模块已实现)。 + +### 6.3 平台利润率参考(成本侧) + +- 单次权益的实际成本主要在 AI 生成(约 ¥0.02–0.05/张,LAUNCH §5.3),图纸生成纯前端零边际成本 → 高价次权益毛利极高,可支撑免费核心的运营开销。 +- 每月监控 AI 失败率(>5% 告警)与兑换码核销日志,控制成本与套利。 + +--- + +## 7. 功能边界原则(核心免费、增值收费) + +### 7.1 三条硬原则 + +| # | 原则 | 判定法 | 举例 | +|---|---|---|---| +| B-01 | **核心必要能力永远免费** | 删掉该功能,用户能否完成「一张可拼图纸」?不能 → 免费 | 生成/预览/备料/基础下载(F-01~F-07) | +| B-02 | **增值/独有能力可收费** | 竞品没有(AI)或超出必要(高清/PDF/无水印/商用)?是 → 可收费 | P-01~P-09 | +| B-03 | **免费版可被感知为完整产品** | 免费用户能否无提示走通主流程且不感到被「阉割」? | 免费预览完整不遮挡;只有出口的清晰度/格式/水印分层 | + +### 7.2 边界判定的反例(禁止收费项) + +- ❌ 图纸生成次数限制(免费也要无限次,防流失)。 +- ❌ 预览加水印/模糊(免费预览必须完整清晰,对齐竞品)。 +- ❌ 备料清单隐藏分色明细(竞品免费给材料统计)。 +- ❌ 上传格式/大小人为收紧逼付费。 +- ❌ 注册/登录墙(竞品无登录墙,我方 MVP 也不设)。 + +### 7.3 兑换码模块落位(现有实现 ↔ 边界映射) + +| 现有模块能力 | 落位 | +|---|---| +| `PACKAGE_DEFINITIONS`(6 档) | 5.1/5.2 套餐源,价格/次数与本文一致 | +| `/api/codes/redeem` | F-08(兑换免费),兑换后权益入 localStorage | +| `/api/codes/consume` | P-02~P-09 扣减;downloadGrant 防重复扣费(同一图纸首下含在生成内) | +| `/api/chibi/generate` | P-01 AI 生成即扣 1 次,返回 downloadGrant | +| 风控/限流/`security_events` | 代理与个人双通道保护(6.2) | + +> 边界文档与现有代码零冲突:免费项不需要任何代码改动(本就是免费路径),付费项全部已有 consume/grant 支撑。 + +--- + +## 8. 决策记录与后续动作 + +### 8.1 本次决策 + +1. **图纸生成核心全免费**(F-01~F-07),对齐 pixel-beads 防流失——商业模型最大分水岭已定调。 +2. **付费点 9 项全部落在增值/独有**(AI/高清/PDF/无水印/SVG/JSON/高级编辑/批量/商用),不与竞品免费能力正面冲突。 +3. **定价维持 6 档**(3 个人 + 3 代理),单次成本递减引导升级,代理价差 0.50–0.70 支撑分销空间。 +4. **代理分成**:主分成=差价转售;辅分成=推广链接返佣(比例系统外核定);阶梯价+升级补齐+双通道隔离。 + +### 8.2 待办建议(转 backlog) + +| 事项 | 说明 | 优先级 | +|---|---|---| +| 兑换弹窗文案增加「免费/付费边界」说明 | 明确告诉用户哪些免费、付费买什么,降低付费抵触 | P1 | +| 基础下载水印落地 | 免费 PNG 带轻水印实现(前端导出),无水印走 P-04 | P1 | +| 高级编辑工具(图层/对称/矩形)随 P-06 排期 | 目前编辑器仅基础工具,高级工具付费项待开发 | P1 | +| 商用授权(P-08)规则细化 | 授权协议文案 + consume 关联订单 | P2 | +| 免费核心转化漏斗埋点 | 对齐 ANALYTICS.md:免费下载完成率 → 付费转化率对照 | P1 | + +--- + +## 9. 结论 + +| 维度 | 结论 | +|---|---| +| 免费清单 | **12 项**(F-01~F-12),覆盖「生成→预览→备料→基础下载」完整闭环,对齐竞品防流失 | +| 付费清单 | **9 项**(P-01~P-09),全部为增值/独有能力,走兑换码按次扣减 | +| 定价 | 个人 3 档(¥4.9/12.9/29.9)+ 代理 3 档(¥139/299/499),与 codes 模块一致 | +| 代理分成 | 差价转售为主 + 推广返佣为辅,批发 0.50–0.70/次 vs 零售 3–10 元/张 | +| 边界原则 | **核心免费、增值收费**:必要能力永不收费;独有/增值能力按次收费 | + +> 本文件为「免费/付费边界」决策文档,是 PRD §4、LAUNCH §3、AGENT.md 的统一口径。后续任何功能入免费或付费清单,均需按 §7 三条原则判定并回写本文,防止边界漂移导致流失或变相缩水。 + +--- + +*报告完。证据可复核: `competitor-analysis/pixelbeads-analysis.md` §6(纯免费模式)、`pixelbeads-zh-detail.md` §4/§8(导出免费/差距项)、`docs/PRD.md` §4(权益体系)、`docs/LAUNCH.md` §3/§5、`docs/AGENT.md` §4、`perler-lab-server/src/codes/service.ts` + `src/types/index.ts`(6 档套餐/兑换扣减实测)。* diff --git a/docs/CI-NEWPAGES.md b/docs/CI-NEWPAGES.md new file mode 100644 index 0000000..6027d67 --- /dev/null +++ b/docs/CI-NEWPAGES.md @@ -0,0 +1,126 @@ +# CI 门禁:色号表与 Showcase 等新页面构建检查(T-109) + +> 维护者:GitOps-Engineer(T-109) +> 关联文件:`.github/workflows/deploy.yml`、`perler-lab/nginx.conf`、`perler-lab/src/App.tsx` +> 更新日期:2026-08-14 + +## 检查结论(TL;DR) + +| 检查项 | 结论 | +|---|---| +| 新页面是否影响现有构建? | **不破坏**。新页面均通过 `App.tsx` 顶层静态 import 打包进同一 Vite bundle,`typecheck` + `vite build` 天然覆盖 | +| Vite build 是否自动打包新路由页面? | **是**。路由为 `App.tsx` 内基于 `window.location.pathname` 的客户端分支(非 react-router 动态加载),无按路由分包,全部页面一次性打进 `assets/index-*.js` | +| SPA 路由是否需要 Nginx / fallback 配置? | **已具备,无需新增**。`perler-lab/nginx.conf` 已配置 `try_files $uri $uri/ /index.html;`,新路由直访由 nginx 回退到 `index.html` 后由前端渲染 | +| 是否需要新增 CI 门禁? | **需要小补强**。已新增「Verify SPA dist & route smoke」步骤:校验 dist 产物 + 用 `vite preview` 对每个新路由做直访冒烟,防「路由直访 404」回归 | +| 是否改动 deploy.yml? | **是**。`test` job 的 `Frontend production build` 步骤之后新增一个产物校验 + 路由冒烟步骤(见下文) | + +--- + +## ① 新页面构建验证清单(typecheck / build 覆盖确认) + +### 新页面与路由清单 + +| 路由 | 页面组件 | 源码位置 | +|---|---|---| +| `/chibi`、`/chibi/*` | `ChibiPage` | `perler-lab/src/ChibiPage.tsx` | +| `/color-chart`、`/color-chart/:brand` | `ColorChartPage` | `perler-lab/src/ColorChartPage.tsx`(数据 `src/lib/color-chart-data.ts` + `src/lib/palette-data/*.json`) | +| `/showcase`、`/showcase/*` | `ShowcasePage` | `perler-lab/src/pages/ShowcasePage.tsx` | +| `/library`、`/library/*` | `LibraryPage` | `perler-lab/src/pages/LibraryPage.tsx` | +| 其他任意路径 | `HomePage`(兜底) | `perler-lab/src/App.tsx` | + +### 覆盖确认 + +- **路由实现方式**:`App.tsx`(`src/App.tsx` 第 335–348 行)在顶层**静态 import** 全部页面组件(`import ColorChartPage from './ColorChartPage'` 等),再按 `window.location.pathname` 分支渲染。无 react-router、无 `React.lazy` 动态加载。 +- **typecheck 覆盖(G3)**:`npm run typecheck` = `tsc --noEmit`(`tsconfig.json` 开启 `strict`)。新增页面的 `.tsx`/`.ts` 源码全部参与编译,类型错误会直接拦截。CI 矩阵中 `perler-lab` 与 `perler-lab-server` 均执行。 +- **build 覆盖(G4)**:`npm run build` = `vite build`。由于所有页面为静态 import,新页面组件 + 色号 JSON 数据 + CSS 必然被 Rollup 打包进 `dist/assets/index-*.js`。构建产物中不存在“漏掉某个路由页面”的空间——只要 App.tsx 引用了它,就会进 bundle;引用缺失则 tsc 直接报错(`Cannot find module`)。 +- **产物校验**:CI 新增步骤显式断言 `dist/index.html` 与 `dist/assets/*.js` 存在,确认产物完整性。 + +> 结论:**无需**为新页面单独新增 build 命令。现有 G3(typecheck)+ G4(vite build)已完整覆盖;T-109 仅在其后增加产物校验与路由冒烟,作为“构建成功”之外的“构建产物可直访”门禁。 + +### 发现的问题(非阻塞) + +- `/help` 路由在 `App.tsx` 中**不存在**(`src/App.tsx` 无 `/help` 分支),且全局无 `HelpPage` 组件。直访 `/help` 会落到 `HomePage` 兜底,不会 404,但展示内容与预期不符。若 `help` 属于已规划页面(如 T-109 上下文提到的 4 个新页面之一),需在后续任务中补充路由与组件;若为误报,可忽略。 + +--- + +## ② SPA fallback 部署配置建议 + +### 现状:已配置,无需改动 + +`perler-lab/nginx.conf` 已包含 SPA 回退: + +```nginx +# ── SPA 路由回退 ── +location / { + try_files $uri $uri/ /index.html; +} +``` + +行为:直访 `/color-chart/mard` → nginx 找不到对应文件 → 回退 `index.html` → 前端 `App.tsx` 读 `location.pathname` → 渲染 `ColorChartPage`。新路由**无需任何额外 Nginx 配置**。 + +### 建议(保持现状的三条纪律) + +1. **不要把新页面做成 `public/` 下的物理 HTML 文件**。Vite 会将 `public/` 原样拷入 dist,若未来出现同名静态目录(如 `dist/showcase/`),nginx 的 `try_files $uri $uri/` 会优先命中该目录而非 SPA 回退,导致路由与静态资源语义冲突。 +2. **保持 `location /` 的 try_files 兜底不被覆盖**。新增 location 时避免写死 `try_files $uri =404` 之类的规则覆盖根 location。 +3. **若未来迁移到 Next.js / SSR**,此配置需改为上层反代(`nginx.conf` 顶部注释已说明,参考 `docs/DEPLOY.md`),届时 SPA fallback 职责转移,与本门禁解耦。 + +### 测试环境等价验证 + +CI 路由冒烟使用 `vite preview`(自带 history fallback),其行为与生产 nginx 的 `try_files $uri $uri/ /index.html` 等价:直访任意路由返回 `index.html`(HTTP 200)。**注意 `vite preview` 只验证“fallback 语义正确”,无法覆盖 nginx 语法/配置错误**——nginx 配置有效性仍需在 `build` job 的 docker 镜像构建阶段(`COPY nginx.conf` + `nginx:alpine` 启动)保证,或本地 `docker run` 验证。 + +--- + +## ③ CI 门禁建议(已落地到 deploy.yml) + +### 建议结论 + +**需要**在 `test` job 增加路由冒烟检查。理由: + +- typecheck/build 只能证明“代码可编译、页面已打包”,**不能**证明“直访新路由返回 200”; +- 若未来有人误删 `try_files` 或把路由改坏,冒烟检查会在 CI 期拦截,避免部署后用户直访 404; +- 成本极低(一次 `vite preview` + 7 个 curl),并入现有 test job 矩阵的 perler-lab 分支即可。 + +### 已新增步骤(deploy.yml → test job) + +```yaml +- name: Verify SPA dist & route smoke + if: matrix.project.name == 'perler-lab' + working-directory: perler-lab + run: | + set -e + [ -f dist/index.html ] || { echo "❌ dist/index.html 缺失"; exit 1; } + ls dist/assets/*.js > /dev/null 2>&1 || { echo "❌ dist/assets 无 JS bundle"; exit 1; } + npx vite preview --port 4173 --strictPort > /tmp/vite-preview.log 2>&1 & + PID=$! + trap "kill $PID 2>/dev/null || true" EXIT + for i in $(seq 1 30); do + curl -sf http://localhost:4173/ > /dev/null 2>&1 && break + sleep 0.5 + done + curl -sf http://localhost:4173/ > /dev/null 2>&1 || { + echo "❌ vite preview 未能启动"; cat /tmp/vite-preview.log; exit 1; } + for route in / /chibi /color-chart /color-chart/mard /color-chart/artkal-c /showcase /library; do + code=$(curl -s -o /dev/null -w '%{http_code}' "http://localhost:4173$route") + echo "GET $route → $code" + [ "$code" = "200" ] || { echo "❌ 路由 $route 返回 $code(预期 200)"; exit 1; } + done +``` + +要点说明: + +- 冒烟路由集:`/`(首页)、`/chibi`、`/color-chart`(列表)、`/color-chart/mard` 与 `/color-chart/artkal-c`(品牌子路由,覆盖“带段路由直访”)、`/showcase`、`/library`。未加 `/help`(见①,该路由当前不存在)。 +- 若未来新增品牌(如 `/color-chart/perler`),建议同步追加到路由集;也可改为读取 `COLOR_CHART_BRANDS` 动态断言,但会增加 CI 脚本复杂度,暂不引入。 +- 冒烟失败(任一路由非 200 或产物缺失)→ 步骤退出码非 0 → `test` job 失败 → 阻塞 `build` / `deploy`,符合门禁语义。 + +--- + +## 变更记录(T-109) + +| 变更 | 文件 | +|---|---| +| 新增「Verify SPA dist & route smoke」步骤:dist 产物校验 + vite preview 对新路由直访冒烟 | `.github/workflows/deploy.yml` | +| 新增本文档(构建验证清单 / SPA fallback 说明 / CI 门禁建议) | `docs/CI-NEWPAGES.md` | + +## 验证方式(CI 执行) + +推送 `master` 后观察 Actions 流水线:`test` job(perler-lab 分支)应依次出现 `Frontend production build` → `Verify SPA dist & route smoke`,日志中 7 个 `GET → 200` 全部通过后进入 `build` job。 diff --git a/docs/COMPLIANCE-PAGES.md b/docs/COMPLIANCE-PAGES.md new file mode 100644 index 0000000..ebbb51d --- /dev/null +++ b/docs/COMPLIANCE-PAGES.md @@ -0,0 +1,167 @@ +# PERLER LAB · 合规页面清单(T-123) + +> 任务: T-123 | 产出角色: PM-Agent | 日期: 2026-08-14 +> 数据来源: `competitor-analysis/pixelbeads-analysis.md`(§1.3 站点结构:about/contact/privacy-policy/terms-of-service 路由)、`pixelbeads-zh-detail.md`(§1.1 路由表:法律页 6 语言覆盖)、`docs/LAUNCH.md`(§4 FAQ:兑换码/权益/退款规则)、`docs/BUSINESS-MODEL.md`(兑换码/代理/商用授权)、`docs/PRD.md`(风险#3 设备绑定数据) +> ⚠️ **数据待补标注**: 竞品法律与关于页的正文抓取任务为 **T-119(Spider-Agent,开发中)**,`gap-crawl.md` 尚未产出。本文 §1 竞品结构参考基于**常规合规规范推断**,待 T-119 交付后回填实测章节并复核。 + +--- + +## 1. 竞品合规页结构参考(pixel-beads.com) + +### 1.1 路由与 i18n 覆盖(sitemap 实测,已确认) + +| 路由 | 用途 | i18n 覆盖 | 证据 | +|---|---|---|---| +| `/about` | 关于我们 | 6 语言(en/zh/ja/vi/ko/de) | pixelbeads-zh-detail §1.1 | +| `/contact` | 联系我们 | 6 语言 | 同上 | +| `/privacy-policy` | 隐私政策 | 6 语言 | 同上 | +| `/terms-of-service` | 服务条款 | 6 语言 | 同上 | + +- 竞品四页在**页脚「关于与法律」栏**统一入口(首页/帮助/应用等全站页脚露出),且全语言覆盖——**合规页是站点信任基础设施,不做语言裁剪**。 + +### 1.2 必备章节推断(⏳ 待 T-119 实测回填) + +> 以下为基于常规隐私/服务条款规范 + 我方产品特性的推断结构。T-119 交付后请按竞品实测章节增删并标注差异。 + +**About(关于我们)** +- 产品简介(做什么、怎么用) +- 核心特性说明(免费模式、本地处理、无需注册) +- 创始人/团队信息(竞品可考:founder Yibai Ju,pixelbeads-analysis §6) +- 联系方式(help@pixel-beads.com 风格) +- 站点收录/合作说明(竞品页脚有 findly.tools 等收录目录互推) + +**Contact(联系我们)** +- 联系邮箱(客服通道,竞品 contactPoint schema 已确认邮箱) +- 响应时效承诺 +- 问题分类导航(功能问题/反馈/合作) +- 常见问题跳转(help 中心) + +**Privacy Policy(隐私政策)——本项目重点** +- **信息收集范围**:图片处理(本地/上传)、兑换码、权益消费记录、设备标识、分析埋点(GA) +- **本地处理声明**:图纸生成在浏览器本地完成,图片不上传服务器(我方核心特性,也是隐私卖点) +- **第三方数据处理**:AI 生成走服务端(模型调用),需披露第三方模型供应商 +- **存储与保留**:localStorage 权益存储、兑换码数据库(服务端)、日志保留期限 +- **数据共享**:仅在提供服务/法律规定时共享,不售卖 +- **用户权利**:查询/删除/投诉,国内按《个人信息保护法》需给出删除通道 +- **儿童隐私**:亲子使用场景,14 岁以下需监护人同意 +- **Cookie/分析技术声明** +- **政策变更通知方式 + 生效日期 + 联系方式** + +**Terms of Service(服务条款)** +- 服务描述与接受条款 +- **免费/付费边界**:哪些功能免费、兑换码付费机制(对齐 BUSINESS-MODEL §3/§4) +- **兑换码规则**:使用方式、有效期(长期有效)、退款规则(已用不退/未用可协商,LAUNCH §4.1) +- **设备绑定权益**:权益存 localStorage、换设备丢失风险告知(PRD 风险#3) +- **用户责任**:上传图片版权(用户保证有权使用)、禁止上传违法/侵权内容 +- **知识产权**:网站/算法/品牌内容归属我方;用户生成图纸的使用授权(商用需授权,BUSINESS-MODEL P-08) +- **禁止行为**:滥用兑换码、批量抓取、代理转售违规 +- **免责声明与责任限制**:工具准确性不作保证、间接损失免责 +- **服务变更与终止权** +- **适用法律与争议解决**(国内:属地法院管辖约定) + +--- + +## 2. 我方上线合规页面清单 + +> 上线优先级: **P0** = 上线必备(缺失有直接法律/信任风险)/ **P1** = 上线后 2 周内补。 +> 当前前端路由为 SPA(App.tsx 手写路由),合规页按独立路由 `/about`、`/contact`、`/privacy-policy`、`/terms-of-service` 注册。 + +### 2.1 清单总览 + +| # | 页面 | URL | 优先级 | 工作量(人日) | 主要风险提示 | +|---|---|---|---|---|---| +| CP-01 | **隐私政策** | `/privacy-policy` | **P0** | 1–2(文案)+ 0.5(前端) | 覆盖兑换码/支付/设备绑定数据 | +| CP-02 | **服务条款** | `/terms-of-service` | **P0** | 1–1.5(文案)+ 0.5(前端) | 兑换码规则/商用授权/用户上传版权 | +| CP-03 | **联系我们** | `/contact` | **P0** | 0.5(文案)+ 0.5(前端) | 退款协商/投诉渠道必须可达 | +| CP-04 | **关于我们** | `/about` | P1 | 0.5(文案)+ 0.5(前端) | 信任建设,缺失不违法但伤转化 | +| CP-05 | **ICP 备案页** | 全站页脚展示 | P1(国内部署时 P0) | 0.25 | 见 §3 | + +### 2.2 分页明细 + +**CP-01 隐私政策 `/privacy-policy`(P0)** + +| 必备章节 | 内容要点 | 法律风险提示 | +|---|---|---| +| 信息收集 | ①图片:生成功能浏览器本地处理,**不上传服务器**;AI 生成(chibi)会上传图片至服务端模型 ②兑换码:服务端校验与核销记录 ③权益与消费:localStorage 权益 + 消费流水 ④设备标识/日志 ⑤分析埋点(GA/自建) | **兑换码/权益数据属个人信息或敏感信息**,须明确收集用途与保留期限;本地与上传两类图片处理路径必须分开声明,否则"本地处理"承诺与 AI 上传事实矛盾会构成虚假陈述风险 | +| 存储与保留 | 兑换码库、消费日志、AI 生成记录的服务端保留时长与删除机制 | 国内《个保法》要求:最小必要 + 保存期限合理 + 用户可请求删除 | +| 设备绑定数据 | **权益保存在当前浏览器 localStorage,换设备/清缓存不可恢复**(PRD 风险#3) | 必须在隐私政策中**显著告知**设备绑定限制,否则用户换设备后投诉权益丢失,构成告知不充分风险 | +| 第三方 | AI 模型供应商、GA/CDN、域名解析 | 披露第三方名单 + 数据处理方式;若模型商在中国境外,涉数据出境合规(V2.0 真实支付与多语言前需评估) | +| 用户权利 | 查询/更正/删除/投诉路径(联系邮箱) | 缺删除通道 = 直接违反《个保法》 | +| 儿童隐私 | 亲子拼豆场景,14 周岁以下需监护人同意 | 涉未成年人信息处理规则 | +| 政策更新 | 生效日期 + 变更通知方式 | 变更后未通知 = 效力争议 | + +**CP-02 服务条款 `/terms-of-service`(P0)** + +| 必备章节 | 内容要点 | 法律风险提示 | +|---|---|---| +| 服务范围与免费边界 | 免费 12 项(F-01~F-12)+ 付费 9 项(P-01~P-09)边界(BUSINESS-MODEL §3/§4) | 边界写死,防"免费变收费"客诉;对齐兑换弹窗文案(BUSINESS-MODEL §8.2) | +| 兑换码规则 | 使用方式、长期有效、已用不退/未用可协商(LAUNCH §4.1)、代理码/个人码不可混用 | **退款规则不写清 = 高频客诉源**;虚拟权益退款规则需在付款前可见 | +| 用户上传责任 | 用户保证上传图片拥有合法使用权、不侵犯第三方版权/肖像权;上传即授权平台处理用于生成 | **图片版权风险**(LAUNCH §6):用户上传侵权图,平台尽到告知义务可免责 | +| 商用授权 | 图纸仅供个人手作,商用需购买 P-08 授权 | 商用边界不写清,代理商/接单用户易误用 | +| 知识产权 | 网站/算法/色板数据/品牌内容归我方;用户生成图纸的使用规则 | 色号数据版权(色板来自品牌公开资料,需声明数据来源与使用授权) | +| 禁止行为 | 滥用兑换码、批量抓取、逆向、转售绕过代理体系 | 与 codes 模块风控(security_events)联动 | +| 免责与责任限制 | 工具输出准确性不作保证、间接损失免责、AI 生成结果仅供参考 | 过度免责条款在《民法典》格式条款下可能无效,需保留合理限度 | +| 法律适用与争议解决 | 中华人民共和国法律 + 服务器所在地法院 | 与 ICP 备案主体一致(见 §3) | + +**CP-03 联系我们 `/contact`(P0)** + +| 必备章节 | 内容要点 | 风险提示 | +|---|---|---| +| 客服邮箱 | 独立客服邮箱(勿用个人邮箱) | LAUNCH §4.1「未使用可联系客服协商」的前提是客服可达;**无联系页 = 退款承诺无法兑现** | +| 响应时效 | 明确承诺(如 1–3 个工作日) | 虚高承诺会引发投诉升级 | +| 问题分类 | 功能问题 / 兑换码与权益 / 代理合作 / 侵权投诉 | 侵权投诉通道(DMCA/平台通知-删除规则)缺失有平台连带风险 | +| 帮助跳转 | 指向 `/help` 常见问题 | 降低客服压力 | + +**CP-04 关于我们 `/about`(P1)** +- 产品定位(图片转拼豆图纸 + AI 拼豆生成器) +- 免费核心 + 兑换码模式的透明说明 +- 本地处理 / 隐私优先的差异化卖点 +- 联系与收录信息(复用 `/contact` 邮箱) + +--- + +## 3. ICP / 备案提示(面向国内部署) + +### 3.1 判定条件(当前部署环境) + +| 部署形态 | 是否需备案 | 说明 | +|---|---|---| +| 服务器/CDN 在中国大陆(当前 nginx+Docker,若为国内云厂商) | **必须 ICP 备案** | 域名解析至大陆服务器必须取得 ICP 备案号,否则 80/443 端口会被拦截 | +| 服务器在中国境外(如 Cloudflare 境外 + 境外 VPS) | 暂不强制 | 但面向国内用户运营仍有**公安备案/网安**要求(经营性除外) | +| 微信/支付宝支付接入 | **依赖 ICP 备案** | 官方商户签约要求备案号 + 企业主体(模拟支付阶段不受影响,正式支付前置条件) | + +### 3.2 备案流程与前置(若确认国内部署) + +1. **域名**:完成实名认证(域名注册商侧)。 +2. **ICP 备案**:主体(个人/企业)→ 域名 + 服务器 IP → 管局审核(约 7–20 工作日)。企业备案需营业执照;个人备案不支持经营性内容。 +3. **经营性 ICP 许可证**:**若上线兑换码付费,属经营性互联网信息服务**,企业主体原则上需《增值电信业务经营许可证(ICP 许可证)》;个人备案不可用于收费业务。⚠️ 兑换码业务正式商业化前需评估此条。 +4. **公安备案**:ICP 备案通过后 30 日内至全国互联网安全管理服务平台完成公安备案(页脚展示公安备案号)。 +5. **备案号展示**:页脚悬挂 ICP 备案号 + 公安备案号,链接至工信部/公安查询页。 +6. **页脚合规栏**(推荐与竞品一致):`关于我们 · 联系我们 · 隐私政策 · 服务条款 · ICP 备案号 xxx号 · 公安备案号 xxx号`。 + +### 3.3 合规时间线建议 + +| 阶段 | 动作 | 时限 | +|---|---|---| +| 上线前 | CP-01/02/03 上线(P0) | 与 V1.1 发布同批 | +| 上线前 | 确认部署地域与备案责任(云厂商/AI 模型供应商地域) | T-7 | +| 上线后 2 周 | CP-04 about 页(P1) | 上线后 | +| 正式支付前 | ICP 备案完成 + 经营性许可证评估 | V2.0 真实支付前置 | +| 上线后 30 日内 | 公安备案(若国内部署) | 备案通过后 | + +--- + +## 4. 结论 + +| 维度 | 结论 | +|---|---| +| 竞品参考 | 4 页(about/contact/privacy-policy/terms-of-service)全语言覆盖、页脚统一入口;正文章节 **⏳ 待 T-119/gap-crawl.md 回填实测后复核** | +| 我方清单 | **4 页 + 备案页脚**:隐私政策 / 服务条款 / 联系我们为 P0 必备,关于我们 P1 | +| 最大法律风险点 | ①隐私政策必须覆盖**兑换码/设备绑定(localStorage)数据**并显著告知 ②本地处理 vs AI 服务端上传的声明必须一致 ③兑换码退款规则写进条款 ④国内部署 ICP 备案 + 经营性许可评估 | +| 下一步 | T-119 交付后回填竞品实测章节;CP-01~03 转排期为 V1.1/V1.2 上线前置任务 | + +> 本文件为合规页面决策依据。文案落地时建议经简单法律复核(可先以模板 + 人工逐条核对清单 2.2 的章节完整度)。 + +--- + +*报告完。证据可复核: `competitor-analysis/pixelbeads-zh-detail.md` §1.1(竞品合规路由/i18n)、`docs/LAUNCH.md` §4/§6(FAQ 与风险)、`docs/BUSINESS-MODEL.md` §3/§4(免费付费边界)、`docs/PRD.md`(风险#3)、`perler-lab/src/App.tsx`(现有路由)。竞品正文章节推断待 `gap-crawl.md`(T-119)交付后回填。* diff --git a/docs/DEPLOY-NEWPAGES.md b/docs/DEPLOY-NEWPAGES.md new file mode 100644 index 0000000..368b76f --- /dev/null +++ b/docs/DEPLOY-NEWPAGES.md @@ -0,0 +1,177 @@ +# 部署核对:新页面路由与静态资源部署配置(T-110) + +> 维护者:DevOps-Engineer(T-110) +> 关联文件:`.github/workflows/deploy.yml`、`perler-lab/nginx.conf`、 +> `perler-lab/Dockerfile`、`perler-lab-server/Dockerfile`、 +> `perler-lab-server/docker-compose.yml`、`docs/CI-NEWPAGES.md`、`docs/DEPLOY.md` +> 更新日期:2026-08-14 + +## 核对范围 + +新页面(色号表 `/color-chart(/...)`、Showcase `/showcase`、图纸库 `/library`、 +AI 专区 `/chibi`,路由定义于 `perler-lab/src/App.tsx` 第 335–348 行)与既有 +部署配置的兼容性。部署路径为:SSH 生产 → `git pull` → `docker compose -f +perler-lab-server/docker-compose.yml up -d --build`(`.github/workflows/deploy.yml` +deploy job 第 101–131 行)。 + +--- + +## 核对结论(TL;DR) + +| # | 检查项 | 结论 | +|---|---|---| +| ① | 前端 Nginx/静态服务是否支持 SPA 路由 fallback | ✅ **已支持,无需改动**。`nginx.conf` 已有 `try_files $uri $uri/ /index.html;`,直访 `/showcase`、`/color-chart/mard` 等返回 `index.html`(200),由前端 `App.tsx` 按 `pathname` 分支渲染 | +| ② | 新页面静态资源是否会被 docker build 自动包含 | ✅ **已包含,无需改动**。全部页面为 `App.tsx` 顶层静态 import,`vite build` 一次性打进 `dist/assets/index-*.js`;色号 JSON 数据由 `src/lib/palette-data/*.json` 经 Rollup 打包(`vite build → dist/` → `COPY --from=build /app/dist`) | +| ③ | 后端新接口(`/api/showcase/*`、`/api/color-chart/*`)CORS/路由放行 | ⚠️ **路由已放行**(Nginx `location /api/` 通配 + `server.ts` 已挂载两个 router);**但生产 API 基址有缺陷,已修复**(见 §2-B) | +| ④ | 健康检查路径是否受影响 | ✅ **不受影响**。前端 `/healthz`(`location = /healthz` 精确匹配优先于 fallback)、后端 `/health` 均未变,deploy job 探测的两个路径无需调整 | +| ⑤ | 后端色号表数据文件是否入镜像 | ❌ **发现缺陷,已修复**(见 §2-A)。`/api/color-chart/:brand` 默认读取 `/app/competitor-analysis/palettes`,该目录**不在镜像内**,会导致色号表 API 返回空列表 | +| ⑥ | CI 对新页面路由的门禁 | ✅ **已在工作区就位**(T-109 未提交改动):deploy.yml test job 含「Verify SPA dist & route smoke」步骤(`vite preview` 对 `/ /chibi /color-chart /color-chart/mard /color-chart/artkal-c /showcase /library` 直访冒烟) | + +--- + +## ① SPA 路由 fallback(前端 Nginx)—— 已具备,无需改动 + +`perler-lab/nginx.conf` 第 94–97 行已包含 SPA 回退,无需新增: + +```nginx +# ── SPA 路由回退 ── +location / { + try_files $uri $uri/ /index.html; +} +``` + +行为验证: + +- 直访 `/showcase`、`/library`、`/color-chart/mard` → nginx 找不到对应物理文件 → 回退 + `index.html`(HTTP 200)→ 前端读取 `window.location.pathname` 渲染对应页面。 +- 不存在的路由(如 `/help`,`App.tsx` 无此分支)同样回退 `index.html` → 渲染 `HomePage` + 兜底,**不会 404**。若 `帮助` 页面在规划中,需补 `App.tsx` 分支与组件(见 + `docs/CI-NEWPAGES.md` ①第 42 行),非部署配置问题。 +- `location = /healthz`(精确匹配)优先级高于 `location /`,健康检查不受 fallback 影响。 + +生产入口路径(`docs/DEPLOY.md` §4.2 主机 Nginx)为 `location / { proxy_pass +http://127.0.0.1:8080; }`,把任意路径透传给 frontend 容器,fallback 职责在容器内 +nginx 完成,同样无需改动。 + +## ② 静态资源 docker build 自动包含 —— 已包含,无需改动 + +`perler-lab/Dockerfile` 构建阶段执行 `vite build`(`RUN npm run build`), +`App.tsx` 对全部新页面组件(`ChibiPage` / `ColorChartPage` / `ShowcasePage` / +`LibraryPage`)为**静态 import**,因此: + +- 新页面组件 + 色号 JSON 数据(`src/lib/palette-data/*.json`)+ CSS 必然进 bundle; +- 不存在的引用会直接触发 tsc `Cannot find module` 构建失败(CI typecheck 覆盖)。 + +结论:新页面无需任何「额外 COPY / 额外构建步骤」。 + +## ③ 后端新接口 CORS / 路由放行 + +### 路由:已放行 + +- 后端 `perler-lab-server/src/server.ts` 第 69–70 行已挂载: + `app.use("/api/color-chart", createColorChartRouter())`、 + `app.use("/api/showcase", createShowcaseRouter(db))`。 +- 前端 nginx `location /api/ { proxy_pass http://backend; }`(nginx.conf 第 70 行)为 + 通配前缀,`/api/showcase/*`、`/api/color-chart/*` 自动命中,**无需新增 location**。 +- 主机层 nginx(`docs/DEPLOY.md` §4.2)的 `location /api/ → 127.0.0.1:8788` 同理。 + +### CORS:生产无需放行,开发已覆盖 + +- 生产:同源请求(见下 §2-B 修复后的 `/api` 基址)经 Nginx 反代,**不触发 CORS**。 +- 开发:后端 CORS 白名单 `http://localhost:5173` / `http://127.0.0.1:5173` + (server.ts 第 27 行)覆盖 Vite dev server 的跨源调用,新接口走同一中间件,无需追加。 + +## ④ 健康检查路径 —— 不受影响 + +| 检查点 | 路径 | 状态 | +|---|---|---| +| frontend 镜像 HEALTHCHECK(Dockerfile) | `GET http://localhost:80/healthz` | 未变 | +| compose 中 server healthcheck | `fetch('http://localhost:8788/health')` | 未变 | +| deploy job 探测 | `http://localhost:8080/healthz` / `http://localhost:8788/health` | 未变 | + +新路由对上述路径零影响。 + +--- + +## 已落地的配置修改(本次 T-110 直接修改,均已标注) + +### 2-A 后端色号表数据文件入镜像(修复:镜像内无色板数据) + +**缺陷**:`perler-lab-server/src/color-chart/routes.ts` 第 66–71 行的 +`DEFAULT_PALETTES_DIR` 解析到仓库根 `competitor-analysis/palettes/`;容器内 +等价路径为 `/app/competitor-analysis/palettes`,而后端镜像构建上下文仅为 +`perler-lab-server`,**该目录不会进入镜像** → `/api/color-chart/:brand` 在容器内 +读取失败,模块加载时告警并回退空列表,SEO JSON-LD 数据为空。 + +**修改**(纯部署配置 + 数据文件,源码未动): + +1. `perler-lab-server/palettes/` —— 从 `competitor-analysis/palettes/` 同步 6 个品牌 + 色板 JSON(`artkal-c.json` / `hama.json` / `ikea-pyssla.json` / `nabbi.json` / + `perler.json` / `zippland-291标准色映射.json`)。**后续品牌数据变更时请同步该目录**。 +2. `perler-lab-server/Dockerfile` —— 运行阶段新增 `COPY palettes ./palettes`。 +3. `perler-lab-server/docker-compose.yml` —— `server` 服务新增环境变量 + `PALETTES_DIR: "/app/palettes"`(routes.ts 第 112 行优先读 `PALETTES_DIR`)。 + 如需改用卷挂载色板,改此值为宿主机映射路径即可。 + +### 2-B 前端生产 API 基址(修复:生产浏览器 fetch 打到「用户本机」) + +**缺陷**:`perler-lab/src/lib/api.ts` 第 87 行 `API_BASE` 默认 +`http://localhost:8788`,且全仓无 `.env.production` / build-arg 覆盖。生产环境下该 +绝对 URL 在**用户浏览器**里执行,`localhost` 指向用户本机 → 所有 API 调用 +(含 Showcase 发布 `POST /api/showcase/works`)都会失败,且即使打对也会因来源 +不在后端 CORS 白名单而被拦截。 + +**修改**(`perler-lab/Dockerfile` 构建阶段,`npm run build` 之前): + +```dockerfile +ARG VITE_API_BASE=/api +ENV VITE_API_BASE=$VITE_API_BASE +``` + +效果:生产 bundle 内 `import.meta.env.VITE_API_BASE` 变为同源 `/api`, +`fetch('/api/...')` 走 Nginx `/api/` 反代到后端容器,**同源无 CORS**。本地 +`npm run dev`(5173)无此变量,仍回退到开发默认 `http://localhost:8788`,行为不变。 +如需指向独立 API 域名,可用 `docker compose build --build-arg VITE_API_BASE=` +覆盖。 + +--- + +## 仍需人工关注 / 建议(非本次修改) + +| 项 | 说明 | 建议动作 | +|---|---|---| +| `/help` 路由 | `App.tsx` 无 `/help` 分支,直访回退 HomePage | 若属规划页面,补路由与组件;部署侧无需改动 | +| 色板数据同步 | `perler-lab-server/palettes/` 与 `competitor-analysis/palettes/` 需保持同步 | 更新色板后手动同步(或改为卷挂载 + 单独管理) | +| CI 冒烟步骤提交 | deploy.yml 的「Verify SPA dist & route smoke」为 T-109 工作区未提交改动,随 T-109/T-110 一起入库 | 提交时确认包含 | +| 前端缓存 | `/assets/` 强缓存 30d(hash 文件名)保证新页面更新后无缓存残留 | 无操作 | + +## 上线验证命令(部署后执行) + +```bash +# 1. 路由直访(应 200 且返回 index.html) +for r in /showcase /library /color-chart/mard /chibi; do + echo "$r → $(curl -s -o /dev/null -w '%{http_code}' http://localhost:8080$r)" +done + +# 2. 新接口(经 Nginx 反代) +curl -s http://localhost:8080/api/color-chart/mard | head -c 200 +curl -s http://localhost:8080/api/showcase/meta +# 预期:color-chart 返回含 colors 数组的 JSON-LD(非空),meta 返回 title/description + +# 3. 健康检查 +curl -sf http://localhost:8080/healthz && curl -sf http://localhost:8788/health +``` + +> 若 `curl .../api/color-chart/mard` 返回的 `colors` 为空,说明 `PALETTES_DIR` 未生效 +> 或 `perler-lab-server/palettes/` 未同步,按 §2-A 检查容器内 +> `/app/palettes` 内容(`docker exec perler-lab-server ls /app/palettes`)。 + +## 变更记录(T-110) + +| 变更 | 文件 | +|---|---| +| 新增品牌色板数据目录(6 个 JSON,供色号表 API 读取) | `perler-lab-server/palettes/` | +| 运行阶段 COPY 色板数据入镜像 | `perler-lab-server/Dockerfile` | +| server 服务新增 `PALETTES_DIR=/app/palettes` | `perler-lab-server/docker-compose.yml` | +| 构建阶段设置 `VITE_API_BASE=/api`(生产同源 API 基址) | `perler-lab/Dockerfile` | +| 新增本文档(部署核对结论 + 配置清单 + fallback 片段) | `docs/DEPLOY-NEWPAGES.md` | diff --git a/docs/DEV-SETUP.md b/docs/DEV-SETUP.md index d9b1c6a..8563dfa 100644 --- a/docs/DEV-SETUP.md +++ b/docs/DEV-SETUP.md @@ -44,8 +44,14 @@ cmd /c "D:\拼豆\start-dev.bat" 5. 打印访问地址与健康检查命令。 启动成功后,两个服务分别运行在独立的 cmd 窗口中(标题分别为 -「PERLER LAB 后端」和「PERLER LAB 前端」),日志输出在各自窗口中,点击 -任务栏对应标题即可查看。 +`PERLER LAB Backend` 和 `PERLER LAB Frontend`),日志输出在各自窗口中, +点击任务栏对应标题即可查看。 + +> **编码兼容说明(BUG-087)**:`start-dev.bat` / `stop-dev.bat` 为纯 ASCII +> 编码 + CRLF 换行,并改用 `%~dp0` 解析项目目录,因此在任意代码页 +> (包括中文 GBK / cp936)的 Windows 下均可直接双击或命令行运行, +> 无需依赖 `chcp` 或 UTF-8 BOM。脚本内提示信息为英文,本中文文档 +> 为唯一使用说明。 ## 三、端口一览 @@ -80,8 +86,8 @@ curl http://localhost:8788/health ### 1. 端口被占用 -现象:启动脚本提示「端口 8788 已被占用」或「端口 5173 已被占用」, -或浏览器访问时报错。 +现象:启动脚本提示 `[WARNING] Port 8788 is already in use!` 或 +`[WARNING] Port 5173 is already in use!`,或浏览器访问时报错。 解决办法: @@ -96,7 +102,7 @@ curl http://localhost:8788/health ``` 3. 重新运行 `start-dev.bat`。 -### 2. 提示「未检测到 Node.js」 +### 2. 提示 `[ERROR] Node.js not found` - 确认 Node.js 已安装:命令行执行 `node --version`; - 若已安装但仍报错,说明 Node.js 未加入 PATH。重新运行安装程序勾选 diff --git a/docs/FAQ-DATA.md b/docs/FAQ-DATA.md new file mode 100644 index 0000000..b58a536 --- /dev/null +++ b/docs/FAQ-DATA.md @@ -0,0 +1,308 @@ +# 帮助中心 FAQ 数据(T-107) + +> 任务: T-107 帮助中心:FAQ 数据内容整理 +> 用途: 供 T-106(FAQ 页面组件)读取渲染;也用于帮助中心子页内容 +> 数据来源: 竞品 `competitor-analysis/raw/home-zh-text.txt`(Homepage Help Desk 教程 5 大章节 FAQ 抽取)+ 我方产品特有问答(兑换码/代理合作/AI 专区) +> 条数: **35**(竞品实操 24 条 + 我方产品特有 11 条) +> 日期: 2026-08-14 + +## 使用说明 + +- 每条含 `category`(分类标签,zh+en)、`question`(zh+en)、`answer`(zh+en)。 +- 分类标签: `bead-selection` 选豆 / `color-matching` 配色 / `printing` 打印 / `ironing` 熨烫 / `framing` 裱框 / `redemption` 兑换码与权益 / `ai-zone` AI 专区 / `product` 平台与使用。 +- 数据可直接映射为前端 `
    `/手风琴组件;`question_en/answer_en` 供后续 i18n 扩展。 + +--- + +## 一、选豆 Bead Selection(bead-selection) + +### FAQ-01 不同品牌的拼豆可以混用吗? +- **category**: bead-selection / 选豆 +- **question_zh**: 不同品牌的拼豆可以混用吗? +- **question_en**: Can I mix beads from different brands? +- **answer_zh**: 不建议混用。不同品牌在颜色编号、材质手感以及熨烫时的热缩率上可能存在差异,混用容易导致颜色不一致或熨烫后变形。为了保证成品效果,建议同一作品尽量使用同一品牌的拼豆。 +- **answer_en**: Not recommended. Different brands may differ in color codes, material feel, and heat-shrink rate during ironing, which can cause color mismatch or warping. Use one brand per project for the best result. + +### FAQ-02 5mm 和 2.6mm 拼豆可以放在同一块拼板上吗? +- **category**: bead-selection / 选豆 +- **question_zh**: 5mm 和 2.6mm 拼豆可以放在同一块拼板上吗? +- **question_en**: Can 5mm and 2.6mm beads share the same pegboard? +- **answer_zh**: 不可以。5mm 和 2.6mm 拼豆属于完全不同规格,对应的拼板孔径不同,无法通用。如果混用尺寸,会导致拼豆无法固定,图案也无法正常熨烫。 +- **answer_en**: No. 5mm and 2.6mm beads have different peg-hole sizes and are incompatible. Mixing sizes means beads won't stay in place and the design cannot be ironed properly. + +### FAQ-03 新手应该从 5mm 还是 2.6mm 拼豆开始? +- **category**: bead-selection / 选豆 +- **question_zh**: 新手应该从 5mm 还是 2.6mm 拼豆开始? +- **question_en**: Should beginners start with 5mm or 2.6mm beads? +- **answer_zh**: 建议从 5mm 开始。5mm 拼豆颗粒更大、操作难度更低,更适合新手建立信心。2.6mm 拼豆对精细操作和耐心要求较高,更适合 16 岁以上、有一定经验的用户。 +- **answer_en**: Start with 5mm. Bigger beads are easier to handle and build confidence. 2.6mm requires finer motor control and patience, better for ages 16+ or experienced makers. + +### FAQ-04 72 色和 168 色拼豆差别大吗?需要一开始就买 168 色吗? +- **category**: bead-selection / 选豆 +- **question_zh**: 72 色和 168 色拼豆差别大吗?需要一开始就买 168 色吗? +- **question_en**: Is there a big difference between 72-color and 168-color sets? Should I buy 168 colors right away? +- **answer_zh**: 差别主要体现在细节表现上。72 色可以满足大多数基础图案和练习需求,而 168 色在渐变、肤色和复杂图案上表现更自然。新手可以先从 72 色开始,熟练后再升级到 168 色。 +- **answer_en**: The difference is in detail. 72 colors cover most basic patterns and practice; 168 colors handle gradients, skin tones, and complex designs more naturally. Beginners can start with 72 and upgrade later. + +### FAQ-05 选豆时如何确定作品需要买哪些颜色? +- **category**: bead-selection / 选豆 +- **question_zh**: 选豆时如何确定作品需要买哪些颜色? +- **question_en**: How do I know which bead colors a project needs? +- **answer_zh**: 用拼豆图纸生成器生成图纸后,导出材料统计表即可看到每一色需要的豆数与总量。将颜色按「大面积主色」和「少量点缀色」区分:主色优先囤货,点缀色按单次用量购买即可,避免浪费。 +- **answer_en**: After generating a pattern, export the material list to see the bead count per color. Separate "bulk main colors" from "small accent colors": stock up on main colors, buy accents per project to avoid waste. + +--- + +## 二、配色与图纸生成 Color Matching & Generation(color-matching) + +### FAQ-06 为什么不建议上传过大的图片? +- **category**: color-matching / 配色 +- **question_zh**: 为什么不建议上传过大的图片? +- **question_en**: Why shouldn't I upload very large images? +- **answer_zh**: 过大的图片并不会让拼豆作品效果更好,反而会增加难度。图片尺寸过大(例如上千像素)时:会产生过多拼豆颗粒、图纸结构过于复杂,制作难度明显提升、自动配色更容易出现杂色、实际完成所需的时间和成本显著增加。拼豆创作强调的是清晰的像素感,而不是高分辨率图片。 +- **answer_en**: A larger image doesn't mean a better bead project — it just adds difficulty. Very large images (e.g. thousands of pixels) produce too many beads, overly complex charts, noisier auto-matching, and much higher time/cost. Bead art is about clean pixel clarity, not resolution. + +### FAQ-07 上传图片的推荐尺寸是多少? +- **category**: color-matching / 配色 +- **question_zh**: 上传图片的推荐尺寸是多少? +- **question_en**: What image size do you recommend uploading? +- **answer_zh**: 建议图片的宽或高控制在 100–300 像素(px)之间。在这个范围内,图案清晰度、拼豆数量和制作难度更容易取得平衡,生成的图纸也更适合实际制作。 +- **answer_en**: Keep the width or height between 100–300 px. This range balances clarity, bead count, and build difficulty, and produces charts that are practical to make. + +### FAQ-08 图片比例有要求吗? +- **category**: color-matching / 配色 +- **question_zh**: 图片比例有要求吗? +- **question_en**: Is there an aspect-ratio requirement for images? +- **answer_zh**: 图片比例不限,但建议接近最终成品比例。在上传前适当裁剪主体,避免过多无关背景,有助于生成更理想的拼豆图纸。 +- **answer_en**: No strict requirement, but keep it close to the final layout ratio. Crop the subject and trim excess background before uploading for a better result. + +### FAQ-09 5mm 拼豆适合使用多大的图片? +- **category**: color-matching / 配色 +- **question_zh**: 5mm 拼豆适合使用多大的图片? +- **question_en**: What image size suits 5mm beads? +- **answer_zh**: 5mm 拼豆建议使用 100–200px 左右的图片。这个尺寸范围下,图案清晰、颗粒数量适中,非常适合儿童、新手或轻松制作的作品。 +- **answer_en**: Around 100–200 px. Within this range patterns stay clear with a moderate bead count — ideal for kids, beginners, or quick relaxing projects. + +### FAQ-10 2.6mm 拼豆适合使用多大的图片? +- **category**: color-matching / 配色 +- **question_zh**: 2.6mm 拼豆适合使用多大的图片? +- **question_en**: What image size suits 2.6mm beads? +- **answer_zh**: 2.6mm 拼豆可以使用 200–300px 的图片。由于颗粒更小,2.6mm 拼豆可以表现更多细节,适合人物、复杂图案或进阶创作。 +- **answer_en**: 200–300 px. Smaller beads capture more detail, making this range ideal for portraits, complex designs, and advanced projects. + +### FAQ-11 自动配色出现杂色或颜色不理想怎么办? +- **category**: color-matching / 配色 +- **question_zh**: 自动配色出现杂色或颜色不理想怎么办? +- **question_en**: Auto color-matching produced noise or off colors. What can I do? +- **answer_zh**: 使用左侧工具栏的三个常用修补工具:画笔(为指定像素重新上色,支持左键拖动连续绘制)、橡皮擦(清除不需要的颜色,支持批量擦除)、取色器(吸取画板中已有颜色,保持整体配色统一)。配色原则:优先保证大面积颜色的统一性、减少零散孤立的颜色点、必要时适当简化细节,更利于实际拼豆制作。 +- **answer_en**: Use the three toolbar tools: Brush (repaint specific pixels, drag to paint continuously), Eraser (bulk-erase unwanted colors), and Eyedropper (pick existing board colors to keep the palette consistent). Keep large areas uniform, reduce isolated single-color dots, and simplify details when needed. + +--- + +## 三、打印 Printing(printing) + +### FAQ-12 为什么要打印拼豆蓝图? +- **category**: printing / 打印 +- **question_zh**: 为什么要打印拼豆蓝图? +- **question_en**: Why should I print a bead blueprint? +- **answer_zh**: 蓝图可以作为参考,保证颜色、像素和图案准确,尤其适用于复杂作品。 +- **answer_en**: A printed blueprint keeps colors, pixels, and the design accurate — especially important for complex projects. + +### FAQ-13 打印蓝图前需要注意什么? +- **category**: printing / 打印 +- **question_zh**: 打印蓝图前需要注意什么? +- **question_en**: What should I check before printing a blueprint? +- **answer_zh**: 检查图纸比例与最终成品是否一致;使用 300 DPI 高清打印,保证像素清晰;根据纸张尺寸选择合适的打印方式。 +- **answer_en**: Verify the chart scale matches the finished size; print at 300 DPI for crisp pixels; pick a print layout that fits your paper size. + +### FAQ-14 打印比例不对怎么办? +- **category**: printing / 打印 +- **question_zh**: 打印比例不对怎么办? +- **question_en**: The printed scale is wrong. What should I do? +- **answer_zh**: 检查打印设置,确保选择「实际大小」或按比例缩放;可先打印小样确认比例。 +- **answer_en**: Check print settings and choose "actual size" or scale-to-fit; print a small test swatch first to confirm the scale. + +### FAQ-15 颜色与拼豆不完全对应怎么办? +- **category**: printing / 打印 +- **question_zh**: 颜色与拼豆不完全对应怎么办? +- **question_en**: The chart color doesn't exactly match my beads. What now? +- **answer_zh**: 使用蓝图参考颜色,结合画板工具(画笔、橡皮擦、取色器)修补;尽量优先使用已有拼豆颜色,避免新增无法购买的颜色。 +- **answer_en**: Use the blueprint as a reference and adjust with the board tools (brush, eraser, eyedropper). Prefer beads you already own; avoid adding colors you can't buy. + +### FAQ-16 打印蓝图常见失误及建议 +- **category**: printing / 打印 +- **question_zh**: 打印蓝图有哪些常见失误? +- **question_en**: What are common blueprint printing mistakes? +- **answer_zh**: 图案比例错误 → 调整打印设置;纸张过小 → 分块打印;铺豆顺序混乱 → 先大面积、后细节;蓝图损坏 → 保留电子备份。 +- **answer_en**: Wrong scale → fix print settings; paper too small → print in tiles; messy beading order → lay large areas first, then details; damaged blueprint → keep a digital backup. + +--- + +## 四、熨烫 Ironing(ironing) + +### FAQ-17 为什么熨烫这么难? +- **category**: ironing / 熨烫 +- **question_zh**: 为什么熨烫这么难? +- **question_en**: Why is ironing so tricky? +- **answer_zh**: 拼豆材料是低密度聚乙烯(LDPE),熔点 105–115°C。温度过低粘合不牢,过高会完全熔化;颜色深浅吸热速度不同,导致局部熔化不均。熨烫需要控制温度、时间、压力和移动速度四个变量。 +- **answer_en**: Beads are LDPE with a melting point of 105–115°C. Too low won't fuse, too high melts them flat; dark colors absorb heat faster, causing uneven melting. You must control temperature, time, pressure, and movement speed. + +### FAQ-18 家用熨斗可以熨烫吗? +- **category**: ironing / 熨烫 +- **question_zh**: 家用熨斗可以熨烫拼豆吗? +- **question_en**: Can I use a regular household iron? +- **answer_zh**: 可以,但有局限:蒸汽孔会导致受热不均、留下印记。建议关闭蒸汽、温度中档、持续画圈移动,不要停留在同一位置超过 3 秒。进阶选择:Cricut EasyPress 或小型压烫机,平整加热、温控精准,尤其适合细节或大作品。 +- **answer_en**: Yes, with caveats — steam holes heat unevenly and leave marks. Turn steam off, use medium heat, and keep a circular motion without pausing more than 3 seconds in one spot. For better results, use a Cricut EasyPress or mini heat press for even, precise heat. + +### FAQ-19 熨烫介质层应该选哪种? +- **category**: ironing / 熨烫 +- **question_zh**: 熨烫介质层(助烫纸/熨烫膜)应该选哪种? +- **question_en**: Which ironing paper should I use — parchment or ironing film? +- **answer_zh**: 助烫纸(Parchment Paper):哑光效果,便宜易用,适合日常练习。熨烫膜(Ironing Film):透明、高光泽,适合重要作品,可观察熨烫进度。特别注意:不要用蜡纸,会融化污染作品和熨斗。 +- **answer_en**: Parchment paper: matte finish, cheap and easy, good for practice. Ironing film: transparent with a glossy finish, lets you watch the melt, great for special projects. Never use wax paper — it melts and ruins both the piece and the iron. + +### FAQ-20 作品容易翘曲或断裂怎么办? +- **category**: ironing / 熨烫 +- **question_zh**: 作品容易翘曲或断裂怎么办? +- **question_en**: My piece keeps warping or breaking. What should I do? +- **answer_zh**: 冷却时在平面上压重物 10–20 分钟;避免单面过度熨烫;熨烫不足(豆豆仅表面粘连)时,可覆盖助烫纸局部补熨。 +- **answer_en**: Press the piece flat under a weight for 10–20 minutes while cooling; avoid over-ironing one side only; if beads are only surface-fused, re-iron that area under fresh parchment. + +### FAQ-21 胶带法(Tape Method)有什么用? +- **category**: ironing / 熨烫 +- **question_zh**: 胶带法(Tape Method)有什么用? +- **question_en**: What is the Tape Method for? +- **answer_zh**: 胶带法可避免钉板受热变形,允许使用更高温度、更长时间熨烫。步骤:贴胶带 → 翻面 → 打孔排气 → 熨烫 → 冷却压平 → 撕胶带。注意:打孔防止空气膨胀造成爆孔。 +- **answer_en**: The Tape Method protects the pegboard from heat and allows higher temperature / longer ironing. Steps: tape the beads → flip → punch holes for venting → iron → cool and press flat → remove tape. Punching holes prevents blowouts from trapped air. + +### FAQ-22 熨烫常见问题及解决方法 +- **category**: ironing / 熨烫 +- **question_zh**: 熨烫有哪些常见问题?如何解决? +- **question_en**: What are common ironing problems and fixes? +- **answer_zh**: ① 爆孔(Blowouts):胶带未打孔或温度过高 → 打孔、降低温度、延长熨烫时间。② 胶带残留:温度过高或熨烫过久 → 用酒精或清洁剂擦拭。③ 作品翘曲:冷却未压平、单面受热过度 → 重新加热局部、重物压平。④ 熔化不均:熨斗移动不均、纸张皱褶、桌面不平 → 加强圆周运动、局部补熨。⑤ 作品断裂:熨烫不足 → 覆盖助烫纸重新熨烫。⑥ 表面哑/亮混合:介质层不平整、过早撕除 → 新助烫纸局部再熨,完全冷却后撕。 +- **answer_en**: ① Blowouts: tape not vented or heat too high → vent, lower heat, iron longer. ② Tape residue: too hot / too long → wipe with alcohol or cleaner. ③ Warping: cooled without pressure / one side over-heated → reheat locally and press flat. ④ Uneven melt: uneven motion, wrinkled paper, uneven surface → circle more, touch up locally. ⑤ Breakage: not fused enough → re-iron under fresh parchment. ⑥ Matte/glossy mix: uneven medium or removed too early → re-iron with new parchment, remove only after fully cooled. + +### FAQ-23 熨烫风格选择有哪些? +- **category**: ironing / 熨烫 +- **question_zh**: 熨烫风格有哪几种?怎么选? +- **question_en**: What ironing styles are there and how do I choose? +- **answer_zh**: ① 部分熨烫(Partial Melt):保留圆形孔洞,立体感强,新手易操作。② 完全平融(Flat Melt / Pixel Melt):豆豆闭合、表面平滑,视觉震撼,难度高。③ 混合风格(Back Melt):背面平融、正面保留立体,兼顾坚固与质感。 +- **answer_en**: ① Partial Melt — keeps round holes, 3D feel, beginner-friendly. ② Flat/Pixel Melt — beads fully closed into a smooth surface, striking look, harder. ③ Back Melt — flat back for strength, dimensional front for texture. + +### FAQ-24 新手熨烫的黄金法则 +- **category**: ironing / 熨烫 +- **question_zh**: 新手熨烫有什么黄金法则? +- **question_en**: What's the golden rule for beginner ironing? +- **answer_zh**: 低温慢熨(Low and Slow)比高温快熨更安全;大作品分区熨烫、边缘优先;使用透明熨烫膜观察熨烫进度;冷却时保持压平。 +- **answer_en**: Low and slow beats hot and fast. Iron large pieces in sections, edges first; use transparent film to watch the melt; keep it pressed flat while cooling. + +--- + +## 五、裱框 Framing(framing) + +### FAQ-25 一定要买定制画框吗? +- **category**: framing / 裱框 +- **question_zh**: 一定要买定制画框来装裱吗? +- **question_en**: Do I need a custom frame for my bead art? +- **answer_zh**: 不需要。市面上的「5cm 深度展示框」非常通用,性价比极高。选购时注意画框需有足够深度(立体中空框,如宜家 HOVSTA),避免挤压拼豆;背景纸建议深色以突显颜色,或同色系增加质感。 +- **answer_en**: No. A common 5cm-deep shadow-box frame is affordable and works great. Make sure it has enough depth (a hollow/deep frame like IKEA HOVSTA) so beads aren't squeezed; use a dark backing for contrast or a matching color for a richer look. + +### FAQ-26 作品可以直接贴墙上吗? +- **category**: framing / 裱框 +- **question_zh**: 拼豆作品可以直接贴墙上吗? +- **question_en**: Can I hang bead art directly on the wall? +- **answer_zh**: 可以,建议使用蓝丁胶或无痕泡沫胶,在作品背面多点固定,避免损坏豆子表面;长期暴露可能积灰,可加亚克力罩保护。想营造像素悬浮感,可在作品与背板间加小块泡沫胶。 +- **answer_en**: Yes — use Blu-Tack or foam mounting dots at multiple points on the back to avoid damaging bead surfaces. Long-term display may collect dust, so consider an acrylic cover. Add small foam pads behind the piece for a floating-pixel effect. + +--- + +## 六、兑换码与权益 Redemption & Credits(redemption) + +### FAQ-27 兑换码怎么使用? +- **category**: redemption / 兑换码与权益 +- **question_zh**: 兑换码怎么使用? +- **question_en**: How do I redeem a code? +- **answer_zh**: 在首页/生成页点击「兑换」,输入兑换码即可将对应权益次数绑定到当前设备;兑换成功后会显示剩余次数,无需再次输入。注意:兑换码需未过期、未耗尽,且单设备绑定。 +- **answer_en**: Click "Redeem" on the home/generator page and enter your code — the credits are bound to your current device. You'll see your remaining count immediately, no re-entry needed. Codes must be valid, unused, and are device-bound. + +### FAQ-28 兑换码可以多个设备共用吗? +- **category**: redemption / 兑换码与权益 +- **question_zh**: 兑换码可以多个设备共用吗? +- **question_en**: Can I use my code on multiple devices? +- **answer_zh**: 兑换码为单设备绑定。兑换后权益次数记录在当前浏览器(localStorage)中,请在主要创作设备上兑换;如需更换设备,建议联系客服协助迁移。 +- **answer_en**: Codes are bound to one device. Credits are stored locally in your browser, so redeem on the device you'll mainly use. Contact support if you need to move credits to another device. + +### FAQ-29 购买套餐后如何拿到兑换码? +- **category**: redemption / 兑换码与权益 +- **question_zh**: 购买套餐后如何拿到兑换码? +- **question_en**: How do I receive my code after purchasing a plan? +- **answer_zh**: 支付成功后系统会自动完成兑换(自动 redeem),无需手动输入兑换码;同时订单结果页会展示兑换码与剩余次数,可截图留存。如支付未回调成功,请联系客服手动处理。 +- **answer_en**: After payment succeeds the code is redeemed automatically — no manual entry needed. The order page shows your code and remaining credits for reference. If the callback fails, contact support for manual processing. + +### FAQ-30 权益次数是怎么扣减的? +- **category**: redemption / 兑换码与权益 +- **question_zh**: 权益次数是怎么扣减的? +- **question_en**: How are credits consumed? +- **answer_zh**: 每次下载高清图纸(含 AI 生成)扣除 1 次权益;免费预览、参数调整不扣次数。扣减前会明确提示,避免误扣。剩余次数会常驻显示在顶部导航。 +- **answer_en**: Each HD pattern download (including AI generation) consumes 1 credit. Free previews and parameter tweaks never consume credits. You'll be prompted before any deduction, and remaining credits always show in the top nav. + +--- + +## 七、AI 专区 AI Zone(ai-zone) + +### FAQ-31 AI 拼豆专区是什么?怎么用? +- **category**: ai-zone / AI 专区 +- **question_zh**: AI 拼豆专区是什么?怎么用? +- **question_en**: What is the AI bead zone and how do I use it? +- **answer_zh**: AI 专区(/chibi)提供 5 大风格(风景/人物/宠物/物品/像素二创)共 15 种细分风格:选择大类与细分 → 调整格数(48/64/80/96)与色数(16/24/32/40)→ 点击生成,AI 会为你直接产出一张拼豆图纸。生成即扣 1 次权益。 +- **answer_en**: The AI zone (/chibi) offers 5 categories (landscape / portrait / pet / object / pixel remix) with 15 sub-styles. Pick a category and sub-style, set grid size (48/64/80/96) and color count (16/24/32/40), then hit generate — AI produces a ready-to-iron bead chart. Each generation consumes 1 credit. + +### FAQ-32 AI 生成前需要准备什么?生成的图纸能用吗? +- **category**: ai-zone / AI 专区 +- **question_zh**: AI 生成前需要准备什么?生成的图纸能用吗? +- **question_en**: What do I need before generating with AI? Is the output usable? +- **answer_zh**: 需要已兑换的权益(≥1 次)。AI 会返回带色号标注的图纸,可照图买豆、直接打印/下载,也支持微调格数与色数重新生成。建议描述场景关键词(如「童话森林,晨雾中的小屋」)以获得更贴合需求的效果。 +- **answer_en**: You need at least 1 credit. AI returns a bead chart with color codes that you can print or download directly; you can also tweak grid size / color count and regenerate. Descriptive keywords (e.g. "fairy forest cottage in morning mist") get closer to what you want. + +--- + +## 八、平台与使用 Platform & Usage(product) + +### FAQ-33 平台收费吗?需要注册吗? +- **category**: product / 平台与使用 +- **question_zh**: 平台收费吗?需要注册吗? +- **question_en**: Is the platform free? Do I need to register? +- **answer_zh**: 完全免费使用、无需注册。图片处理在浏览器本地完成,你的图片不会上传服务器。只有「高清图纸下载」和「AI 生成」消耗兑换码权益。 +- **answer_en**: Completely free, no registration required. Images are processed locally in your browser and never leave your device. Only HD downloads and AI generation consume credits. + +### FAQ-34 代理合作怎么开展? +- **category**: product / 平台与使用 +- **question_zh**: 代理合作怎么开展? +- **question_en**: How does agent/affiliate cooperation work? +- **answer_zh**: 平台提供面向微商/手工博主的代理套餐(¥139/200 次、¥299/500 次、¥499/1000 次,单价低至 ¥0.5/次),支持批量采购并分发给学员/客户赚取差价;代理可查看名下兑换码、剩余库存与核销记录。联系客服提交代理合作申请即可开通。 +- **answer_en**: We offer affiliate plans for resellers and craft bloggers (¥139/200 uses, ¥299/500 uses, ¥499/1000 uses, down to ¥0.5/use) for bulk purchase and resale at a margin. Agents can view their codes, stock, and redemption history. Contact support to apply. + +### FAQ-35 图纸可以导成什么格式?如何高质量打印? +- **category**: product / 平台与使用 +- **question_zh**: 图纸可以导成什么格式?如何高质量打印? +- **question_en**: What export formats are available? How do I print at high quality? +- **answer_zh**: 图纸支持高清 PNG/PDF 导出(兑换权益后);PDF 建议 300 DPI、标准 A4 或更大纸张打印,必要时分块打印。打印后把蓝图放在拼板下方(透明板)或旁边参考,先铺大面积色块、再铺细节区域,每完成一个区域确认颜色与图纸一致。 +- **answer_en**: Export HD PNG/PDF after redemption. For PDF, print at 300 DPI on A4 or larger, tiling if needed. Place the blueprint under a transparent pegboard or beside it; lay large color areas first, then details, checking each section as you go. + +--- + +## 附录:分类统计 + +| 分类 | 标签 | 条数 | +|---|---|---| +| 选豆 | bead-selection | 5 | +| 配色与图纸生成 | color-matching | 6 | +| 打印 | printing | 5 | +| 熨烫 | ironing | 8 | +| 裱框 | framing | 2 | +| 兑换码与权益 | redemption | 4 | +| AI 专区 | ai-zone | 2 | +| 平台与使用 | product | 3 | +| **合计** | — | **35** | + +> 竞品实操 FAQ 24 条(§一–§五)+ 我方产品特有 FAQ 11 条(§六–§八),总计 **35 条**,满足 20+ 要求。en 字段为 i18n 预留,供 T-106 组件按语言渲染。 diff --git a/docs/GAP-PRIORITY.md b/docs/GAP-PRIORITY.md new file mode 100644 index 0000000..fc28627 --- /dev/null +++ b/docs/GAP-PRIORITY.md @@ -0,0 +1,149 @@ +# GAP-PRIORITY · 竞品外围 12 类缺口落地优先级评估(V1.2) + +> **任务**: T-124 | 产出角色: Oracle-Architect-Agent | 日期: 2026-08-14 +> **输入依据**: +> - `docs/NAV-ALIGNMENT.md`(导航对齐决策:对齐 4 / 暂缓 4 / 不做 1) +> - `docs/BUSINESS-MODEL.md`(商业模式:免费 12 项 + 付费 9 项边界) +> - `docs/I18N-ROI.md`(i18n 结论:zh-tw 扩展、ja 暂缓) +> - `docs/ANIMATION-PLAN.md`(动画决策:P0 纯 CSS 零依赖) +> - `docs/RELEASE-V1.1.md`(V1.1 范围:色号表×6 / showcase / library / help 已交付) +> - `docs/ROADMAP.md`(V1.2 账号版范围:账号/云端同步/素材社区/代理管理) +> - `competitor-analysis/pixelbeads-analysis.md` §7(20+ 项差距清单)、`pixelbeads-zh-detail.md` §8(Top10 优先级) +> - 看板实时状态:T-090~T-111 全部验收通过(V1.1 交付完成);T-113~T-123 为 Spider 补爬与产品评估任务(开发中) + +--- + +## 0. 结论速览 + +| 维度 | 结果 | +|---|---| +| **12 类缺口评估** | 落地 7 · 借鉴 3 · 忽略 1 · 已落地 1 | +| **V1.2 推荐落地** | **P0 共 2 项**(⑦法律/关于页、⑤作品详情页) | +| **P1 落地** | 4 项(②blog 矩阵·轻量、⑫JSON-LD 全量、⑩zh-tw、③帮助子页化) | +| **P2 条件落地** | 1 项(⑥showcase 主题合集) | +| **借鉴/忽略** | ①/perler-beads、⑧色号变体 2 页、⑪blog 文章详情 → 借鉴;④apps 生态页 → 忽略;⑨图纸库页 → V1.1 已交付 | +| **一致性校验** | 12/12 与既有决策零冲突(NAV-ALIGNMENT / BUSINESS-MODEL / I18N-ROI 全对齐) | + +> 核心原则:**V1.2 是账号版**(ROADMAP §3),缺口落地必须优先服务于「素材社区(P0)+ 合规(V1.0 遗留阻塞项 #5)」两条主线,而非机械对齐竞品全量页面。SEO 内容型缺口(blog/详情页/神秘页)多数顺延至 V2.0 英文站。 + +--- + +## 1. 逐缺口评估表(12 类) + +> 评估口径:竞品价值(pixel-beads 实测证据)|我方现状(源码/看板实读)|落地成本|收益(SEO/留存/变现)|推荐动作。 + +| # | 缺口 | 竞品价值(证据) | 我方现状 | 落地成本 | 收益 | 推荐动作 | +|---|---|---|---|---|---|---| +| ① | **/perler-beads 神秘页** | 拼豆通用关键词 SEO 落地页,仅默认(en)语言存在(zh-detail §1.1「⭐新发现」) | 无;en 关键词覆盖归 V2.0 英文站(ROADMAP §4) | 低(单页内容) | 低(en 流量 V2.0 才考核:自然访问 ≥10%) | **借鉴**(en SEO 页模式;V2.0 落地,V1.2 不做) | +| ② | **blog 内容矩阵** | `/blog` 全语言 + 250+ 篇实操知识(熨烫温度/爆孔/选豆,analysis §2.4),SEO 流量主力 | 无 blog;已有 FAQ-DATA.md 35 条双语言(T-107)+ /help 页(T-106) | 中(内容生产是瓶颈) | 高(长尾流量/留存) | **落地(轻量版)**:blog 首页 + 首批文章以 FAQ-DATA 35 条与 SEO 关键词为种子(P1) | +| ③ | **帮助细分页** | `/help/perler-bead-art`、`/help/perler-bead-pattern-generator` 分工具子页(zh-detail §1.1) | /help 单页 FAQ 35 条 8 分类(T-106/107 已交付) | 低(复用 FAQ 数据拆路由) | 中(分工具长尾 SEO + 使用引导) | **落地**:按 NAV-ALIGNMENT P2-2「帮助中心子页化(按需)」条件已满足(FAQ 超一屏)(P1) | +| ④ | **apps 生态页** | `/apps` + android/ios/chrome-extension 三端下载页(zh-detail §1.1) | 纯 Web,无客户端产品;PWA 评估 T-105 已产出(V2.0 立项) | 高(需配套产品) | 无(无客户端无从变现) | **忽略**(NAV-ALIGNMENT 决策「不做」;待 PWA/客户端立项再评估) | +| ⑤ | **作品详情页** | `/perler-bead-pattern/-pt_` 单作品详情 + JSON-LD + 作者页(analysis §1.1,zh-detail §1.4) | showcase_works 表 + 发布/列表/SEO 接口已建(T-099~T-102),/showcase 列表页已交付(T-097/098);**缺详情页路由与内容** | 中(详情路由 + slug 化 + 复用 T-101 meta) | 高(UGC 长尾 SEO + 素材社区 P0 天然组成) | **落地**:V1.2 素材社区(ROADMAP P0)的必备组成(P0) | +| ⑥ | **showcase 主题合集** | `/showcase/christmas-perler-bead-patterns`、`/showcase/pokemon-champions-…` 主题合集页(zh-detail §1.1「⭐新发现」) | /showcase 已有 7 分类标签前端筛选(T-098);无独立主题合集路由 | 低(复用作品数据按分类/标签聚合) | 中(节日/IP 长尾,依赖作品量) | **落地(条件)**:作品数据积累后按标签建合集路由(P2,依赖 V1.2 素材社区内容量) | +| ⑦ | **法律/关于页** | `/about`、`/contact`、`/privacy-policy`、`/terms-of-service` 四页(zh-detail §1.1,I18N-ROI §2.2 指出缺信任页是转化链断档) | **无任何法律/关于页**;ROADMAP V1.0 遗留阻塞项 #5「用户协议与版权声明」未清;AgencyModal 代理合作入口已有 | 低(静态内容页) | 高(合规刚需 + 信任 + 代理合作落地页) | **落地**:清 ROADMAP V1.0 阻塞项 #5,一次补齐 privacy/terms/about/contact(P0) | +| ⑧ | **色号表缺口 2 页** | 竞品 10 品牌变体含 Hama-Midi / Perler-Midi / Artkal-M-2.6mm 迷你豆(zh-detail §3.1 `kl` 映射表) | 我方 6 品牌(mard 221 / artkal-c 174 / perler 103 / hama 92 / pyssla 18 / nabbi 30,T-092)已交付;缺 Midi/2.6mm 变体页 | 中(需补 Midi/2.6mm 色号数据) | 低(窄长尾,迷你豆细分市场尚小) | **借鉴**:等 T-120 爬虫数据结论,数据齐备再补 2.6mm 变体页(P2) | +| ⑨ | **图纸库页** | `/perler-bead-pattern` 图纸库入口(NAV-ALIGNMENT §1 #7) | **已交付**:/library 路由 + 列表页(T-108 验收通过,复用 showcase 数据源) | — | — | **已落地**(V1.1 交付,V1.2 无新动作;后续可挂作品详情链接增强) | +| ⑩ | **6 语言首页** | 竞品 7 语言(zh/zh-tw/ja/vi/ko/de + en 默认),zh-tw 仅 16 URL 是最弱档(zh-detail §1.2) | 我方 zh-CN + en 各 349 key(I18N-ROI §3) | zh-tw ~1 人日/¥0(I18N-ROI §4.1) | 中(台湾 SEO 占位,竞品该语言最弱) | **落地 zh-tw**(I18N-ROI 已决策);ja/vi/ko/de 不落地(支付链路未通/竞品已深耕)(P1) | +| ⑪ | **blog 文章详情** | `/blog` 文章详情页(每篇独立 URL) | 无 | 中(跟随 ② blog 矩阵) | 中(依赖内容生产) | **借鉴**:随 ② 落地后自然承接;V1.2 不单独立项(P2) | +| ⑫ | **JSON-LD 全量** | 竞品 6 类 schema:Organization/SoftwareApplication/HowTo/Offer/Person/ContactPoint(zh-detail §0.10) | 仅 /color-chart(CollectionPage+ItemList,T-094)与 /showcase(CollectionPage,T-101) | 低(首页注入 Organization/WebSite/SoftwareApplication/HowTo) | 中(结构化数据提升 SERP 展示) | **落地**:首页 + 生成器补 Organization/SoftwareApplication/HowTo,复用 T-094 注入模式(P1) | + +**动作统计:落地 7 · 借鉴 3 · 忽略 1 · 已落地 1** + +--- + +## 2. V1.2 优先级排序 + +> 优先级定义沿用 PRD/ROADMAP:**P0** = V1.2 必须上线;**P1** = V1.2 内争取;**P2** = 观察数据后进入后续版本。V1.2 主题为「账号版」(ROADMAP §3:账号体系/云端同步/素材社区/代理管理),以下排序以服务该主题为准绳。 + +### 2.1 P0(必须上线,共 2 项) + +| 排名 | 缺口 | 理由 | +|---|---|---| +| **P0-1** | ⑦ 法律/关于页(privacy / terms / about / contact) | ① ROADMAP V1.0 阻塞项 #5「用户协议与版权声明」为上线遗留欠账,V1.2 账号体系上线后**隐私政策成为硬合规前提**(收集手机号/云端同步数据);② 成本极低(静态页);③ 代理合作(AGENT.md)缺落地页入口,contact/about 补齐信任与转化链(I18N-ROI §2.2 实证:信任页断档=转化断档) | +| **P0-2** | ⑤ 作品详情页 | V1.2 素材社区(ROADMAP §3.2 项3)是 P0,「用户分享图纸 → 图纸页」天然需要**详情页 + slug URL + 分享链接**。底层已就绪(showcase_works 表 + T-099~T-102 接口 + T-101 SEO meta),只差详情路由与渲染,成本集中在内容而非基建;落地即同时拿到 UGC 长尾 SEO 与社区闭环 | + +### 2.2 P1(V1.2 内争取,共 4 项) + +| 排名 | 缺口 | 理由 | +|---|---|---| +| **P1-1** | ② blog 内容矩阵(轻量版) | 竞品 250+ 篇是 SEO 流量主力,我方 FAQ-DATA 35 条已具备种子内容;轻量落地(blog 首页 + 首批 10~20 篇)成本可控,与 P0-2 作品详情页共享内容生产管线。全量内容矩阵(250+ 篇)不承诺 | +| **P1-2** | ⑫ JSON-LD 全量 | 成本最低(首页注入 3~4 类 schema,复用 T-094 注入模式),收益确定(SERP 富展示);与 P0-2 详情页 JSON-LD 一并做,边际成本趋零 | +| **P1-3** | ⑩ zh-tw 语言首页 | I18N-ROI 已正式决策「扩展」(~1 人日/¥0),竞品 zh-tw 仅 16 URL 是我方竞争窗口;V1.1 未及落地,顺延 V1.2 执行(随新页面文案一起简转繁) | +| **P1-4** | ③ 帮助细分页 | NAV-ALIGNMENT P2-2 已定义「帮助中心子页化(按需)」且条件已满足(FAQ 35 条超一屏);复用 FAQ-DATA 按分类/工具拆 `/help/:tool`,成本低、SEO 长尾直接 | + +### 2.3 P2(条件触发,共 1 项落地 + 3 项借鉴) + +| 缺口 | 触发条件 | 说明 | +|---|---|---| +| ⑥ showcase 主题合集 | V1.2 素材社区作品量 > 50 件且标签数据充分 | 复用 /showcase 分类数据建 christmas/pokemon 式合集路由,纯内容聚合零新基建 | +| ① /perler-beads 神秘页 | V2.0 英文站立项(ROADMAP §4.2 项4) | en 关键词页归属英文站统一规划,V1.2 不建 | +| ⑧ 色号变体 2 页 | T-120 爬虫数据结论 + Midi/2.6mm 色号数据齐备 | 迷你豆细分市场尚未验证,数据先行、页面随数据 | +| ⑪ blog 文章详情 | ② blog 矩阵落地后 | 详情路由是 ② 的随附能力,不单独立项 | + +### 2.4 忽略 / 已落地 + +| 缺口 | 决策 | 依据 | +|---|---|---| +| ④ apps 生态页 | **忽略** | NAV-ALIGNMENT §2 #8 决策「不做」(无客户端产品);PWA 评估 T-105 建议 V2.0 立项,届时单独立项补入口 | +| ⑨ 图纸库页 | **已落地** | /library 已于 V1.1(T-108)交付,V1.2 无新动作 | + +--- + +## 3. 每项落地的依赖 + +| 缺口 | 依赖 | 现状 | 就绪度 | +|---|---|---|---| +| ⑦ 法律/关于页 | 内容源(隐私/条款文案,需结合账号体系数据范围);T-123 合规页面清单(开发中) | ROADMAP V1.0 阻塞项 #5 文案素材存在(PRD 风险 #5) | 高(文案可先静态落盘,账号上线后补数据范围条款) | +| ⑤ 作品详情页 | **showcase_works 表**(已建 T-099)+ 发布/列表/SEO 接口(T-100/101/102)+ slug 生成与详情路由 | 全部接口已验收,仅缺前端详情路由与 slug 规则 | **高**(基建全就绪,剩 UI) | +| ② blog 矩阵(轻量) | 内容生产(FAQ-DATA 35 条为种子)+ T-122 SEO 内容矩阵对标建议(开发中) | FAQ-DATA.md 双语言 35 条已交付 | 中(内容生产是唯一瓶颈) | +| ⑫ JSON-LD 全量 | 首页/生成器 schema 数据(Organization/WebSite/SoftwareApplication/HowTo) | T-094 注入模式已实现,可复用 | 高 | +| ⑩ zh-tw | i18n 框架(349 key×2 已就绪)+ 路由前缀机制(I18N-ROI §7.3 预留) | 框架零重构即可扩展(I18N-ROI §3) | 高 | +| ③ 帮助子页化 | FAQ-DATA.md 分类数据(8 分类)+ /help 现有页 | T-106/107 已交付 | 高 | +| ⑥ 主题合集 | showcase_works 作品量 + 标签数据积累 | V1.2 素材社区 P0 提供内容 | 低(等数据) | +| ⑧ 色号变体 2 页 | T-120 爬虫数据 + Midi/2.6mm 色号源 | 爬虫任务开发中 | 低 | +| ① /perler-beads | V2.0 英文站 | — | 低(V2.0 再评估) | +| ⑪ blog 文章详情 | ② blog 矩阵先行 | — | 中(跟随 ②) | + +--- + +## 4. 与既有决策的一致性校验 + +> 逐项核对 NAV-ALIGNMENT / BUSINESS-MODEL / I18N-ROI / ROADMAP,12 项缺口 **零冲突**。详见下表。 + +| # | 缺口 | NAV-ALIGNMENT | BUSINESS-MODEL | I18N-ROI | ROADMAP | 校验结论 | +|---|---|---|---|---|---|---| +| ① | /perler-beads | 未涉及(竞品主导航无此项,页脚/内容页) | 不冲突(en SEO 内容) | 一致(en 是 V2.0 重心) | V2.0 项4 多语言/en 站 | ✅ 无冲突(顺延 V2.0) | +| ② | blog 矩阵 | 未涉及(竞品主导航无 blog,仅页脚) | **一致**(F-12 帮助/FAQ 免费,blog 属免费内容获客,B 原则 F-01~F-12 免费) | 不冲突 | V1.2 素材社区内容沉淀可复用 | ✅ 无冲突 | +| ③ | 帮助子页化 | **一致**(P2-2「帮助中心子页化(按需)」已定义) | **一致**(F-12 帮助中心免费) | 不冲突 | 不冲突 | ✅ 无冲突 | +| ④ | apps 生态页 | **一致**(§2 #8 决策「不做」) | 不冲突 | 不冲突 | PWA 归 V2.0(T-105) | ✅ 无冲突(沿用忽略) | +| ⑤ | 作品详情页 | **一致**(§2 #5 作品展示 P1 建 /showcase;详情页是 /showcase 延伸,不新增导航项) | 一致(社区 UGC 免费分享,符合 F-11 分享 URL 免费) | 不冲突 | **一致**(V1.2 素材社区 P0「图纸页+作者页」) | ✅ 无冲突 | +| ⑥ | 主题合集 | **一致**(§2 #6 主题拼豆已用 chibi 分类承载;showcase 合集是内容聚合不冲突) | 一致(免费内容) | 不冲突 | 素材社区分类/搜索支持 | ✅ 无冲突 | +| ⑦ | 法律/关于页 | 未涉及(不在导航 9 项内) | 一致(静态信任页,无变现冲突) | **一致**(I18N-ROI 指出 zh-tw 缺 about/contact 是信任缺口) | **一致**(清 V1.0 阻塞项 #5) | ✅ 无冲突(P0 最高优先级) | +| ⑧ | 色号变体 2 页 | 未涉及 | **一致**(F-09 色号表浏览免费,新增变体页仍免费) | 不冲突 | 不冲突 | ✅ 无冲突 | +| ⑨ | 图纸库页 | **一致**(§2 #7 P1 建 /library 已交付) | 一致 | 不冲突 | V1.1 已交付 | ✅ 无冲突(已落地) | +| ⑩ | 6 语言首页 | 未涉及 | 不冲突(免费核心不受支付影响) | **严格一致**(zh-tw 扩展 / ja 暂缓,逐条采纳 I18N-ROI 决策) | V2.0 多语言(zh-tw 作为低成本例外顺延 V1.2) | ✅ 无冲突 | +| ⑪ | blog 文章详情 | 未涉及 | 一致 | 不冲突 | 跟随 ② | ✅ 无冲突 | +| ⑫ | JSON-LD 全量 | 未涉及 | 一致 | 不冲突 | V1.1 已有部分(T-094/101) | ✅ 无冲突 | + +### 4.1 风险与注意(落地时需遵守既有纪律) + +1. **复用而不是重建**:⑤⑥ 全部建立在已交付的 showcase_works 数据与接口之上,禁止另起数据源;⑬ JSON-LD 复用 T-094 注入模式。 +2. **导航不膨胀**:NAV-ALIGNMENT 定稿为 7 项,blog/作品详情/法律页均**不进主导航**(页脚/页面内链承载),避免破坏已验收的导航结构。 +3. **变现边界不漂移**:②③⑦⑩⑫ 全部为免费内容(对应 BUSINESS-MODEL F-09/F-12),不得在内容页引入付费墙;付费只走兑换码模块(P-01~P-09)。 +4. **占位不允许裸链接**(NAV-ALIGNMENT §5 教训):V1.2 新页面一旦入导航必须有真实内容,dropdown 子项全部指向存在路由。 +5. **不动算法/付费逻辑**:本文档只产出评估;实施时(尤其 ⑤ 详情页复用 T-099~T-102 接口)不得触碰 `lib/` 管线与 codes 扣费逻辑。 + +--- + +## 5. 回报口径 + +| 项 | 结果 | +|---|---| +| P0 项数量 | **2**(⑦法律/关于页、⑤作品详情页) | +| 推荐落地项数量 | **7**(P0×2 + P1×4 + P2 条件×1;借鉴 3 · 忽略 1 · 已落地 1) | +| 文档路径 | `D:\拼豆\docs\GAP-PRIORITY.md` | +| 一致性校验 | 12/12 无冲突(与 NAV-ALIGNMENT / BUSINESS-MODEL / I18N-ROI / ROADMAP 全对齐) | + +--- + +*文档完。评估依据全部来自 `competitor-analysis/pixelbeads-analysis.md` §7、`pixelbeads-zh-detail.md` §8/§1.1、`docs/` 既有决策文档与 taskboard 实时验收状态,无推断项。V1.2 落地以本文 §2 优先级为准,P2 条件项以数据积累为触发。* diff --git a/docs/I18N-ROI.md b/docs/I18N-ROI.md new file mode 100644 index 0000000..6cea0c7 --- /dev/null +++ b/docs/I18N-ROI.md @@ -0,0 +1,174 @@ +# PERLER LAB · i18n 扩展 ROI 分析报告(zh-tw / ja) + +> 任务: T-103 | 产出角色: PM-Agent | 日期: 2026-08-14 +> 数据来源: `competitor-analysis/pixelbeads-zh-detail.md`(2026-08-14 爬取)、`competitor-analysis/pixelbeads-analysis.md`(2026-08-13 爬取)、`docs/ROADMAP.md`、前端 i18n 模块实测 +> 结论预览: **zh-tw 建议扩展(低成本顺水推舟);ja 建议暂缓(支付/本地化链路未通,ROI 为负)。** + +--- + +## 1. 背景与目标 + +我方已具备双语框架(`perler-lab/src/i18n`,zh-CN + en,349 个文案 key/语言,165 项单测通过)。本次评估是否在近期扩展 **zh-tw(繁体中文)** 与 **ja(日文)** 两个语言,作为对竞品 7 语言矩阵的追赶动作。 + +评估口径:以「翻译工作量 / 页面覆盖数」为成本轴,以「流量规模 / 市场规模 / 竞争窗口 / 商业化可行性」为收益轴,给出每语言的扩展/暂缓决策、理由与建议执行时间点。 + +--- + +## 2. 竞品 i18n 覆盖现状(sitemap 实测证据) + +### 2.1 7 语言 URL 分布(157 URL 全量 sitemap) + +| 语言 | 路由 | URL 数 | 色号表×6 | about/contact | showcase 合集 | 覆盖评价 | +|---|---|---|---|---|---|---| +| 简体中文 | `/zh` | **35** | ✅(但未入 sitemap) | ✅ | ✅ | 最完整,重点市场 | +| 日文 | `/ja` | **25** | ✅ | ✅ | ✅ | 次完整 | +| 越南文 | `/vi` | **25** | ✅ | ✅ | ✅ | 次完整 | +| 韩文 | `/ko` | **23** | ✅ | ⚠️ 仅 contact | ❌ | 中等 | +| 德文 | `/de` | **23** | ✅ | ✅ | ❌ | 中等 | +| 英文(默认) | `/` | **22** | ✅ | ✅ | ✅ | 基础完整 | +| 繁体中文 | `/zh-tw` | **16** | ❌ 无 | ❌ 无 | ❌ 无 | **明显短板** | + +### 2.2 zh-tw 缺口明细(§1.2 证据) + +- **6 个色号表页全部缺失**(MARD 291 / Perler 57 / Hama 53 / Artkal 159 / IKEA Pyssla / Nabbi)→ 直接损失台湾长尾 SEO 流量。 +- **about / contact 缺失** → 信任与转化链路断档。 +- **showcase 圣诞/宝可梦合集缺失** → 内容流量缺口。 +- 竞品 `next-intl` 声明 7 语言,但 **zh-tw 实际建设滞后**,仅 16 个 URL,是竞品 7 语言中最薄弱的一档。 + +> **解读**: 竞品自己也没把 zh-tw 做厚。这意味着 zh-tw 市场不存在「先发压制」——我方现在跟进即可拿到对等甚至更好的 SEO 位置,竞争窗口是敞开的。 + +### 2.3 ja 覆盖评价 + +竞品 ja 25 URL 且色号表全齐,说明其视日本为正式市场。日本"アイロンビーズ(熨斗珠)"是成熟手工品类,搜索量大、有社区生态,**竞品在 ja 上的布局比 zh-tw 深得多**。 + +--- + +## 3. 我方 i18n 现状(前置能力盘点) + +| 项 | 现状 | 影响 | +|---|---|---| +| i18n 框架 | 零依赖 runtime 已完成(`locale.ts` + `I18nProvider` + `useT`),localStorage 记忆、导航语言检测、参数插值、fallback 链 | **扩展语言无需重写框架**,成本只在文案与路由 | +| 已支持语言 | zh-CN + en,**各 349 key**,双语测试全过 | 已有 en 全量文案可复用结构 | +| 当前页面 | 首页(/) + /chibi + 弹窗;V1.1 新增色号表×6、showcase、图纸库、帮助中心 | 扩语言时需连带覆盖新增页面文案 | +| 路由 | 无语言前缀(单一站点) | 若扩语言需引入 `/zh-tw/`、`/ja/` 前缀路由与 hreflang,属一次性改造 | + +--- + +## 4. 成本评估(翻译工作量 / 页面数) + +### 4.1 zh-tw + +| 成本项 | 估算 | +|---|---| +| 文案转换 | **349 key 简→繁**,可半自动转换 + 人工术语校对(拼豆→拼豆、兑换码→兌換碼、图纸→圖紙、下载→下載),**约 0.5–1 人日** | +| 术语差异 | 极小(同源简体/繁体,仅用词习惯微调:如「生成」不变、「预览→預覽」) | +| 页面改造 | 新增 `/zh-tw/` 前缀路由 + 色号表等 V1.1 页面同套文案;路由机制为一次性工作 | +| 外部费用 | **≈ ¥0**(无专业翻译需求,AI 辅助 + 人工校对即可) | +| 合计 | **约 1 人日,零外部成本** | + +### 4.2 ja + +| 成本项 | 估算 | +|---|---| +| 文案翻译 | 349 key **全量日译** + V1.1 新增页面文案 + FAQ/帮助内容,**约 3–5 人日**(含专业校对,日文 UI 质量要求高) | +| 术语本地化 | 拼豆→アイロンビーズ、兑换码→引換コード、下载→ダウンロード,需与日本社区习惯对齐 | +| SEO 内容 | 色号表 6 页、FAQ 需日文化(竞品即如此投入),内容量再 +1–2 人日 | +| 外部费用 | **约 ¥1,500–3,000**(专业翻译或外包校对) | +| 支付/渠道适配 | 兑换码支付依赖微信生态,**日本用户无微信支付** → 需本地支付或改走纯免费引流,链路未定义 | +| 合计 | **约 5–7 人日 + ¥1,500–3,000 外部成本**,且伴随商业化前提未满足的隐性成本 | + +### 4.3 成本对比小结 + +| 维度 | zh-tw | ja | +|---|---|---| +| 人力 | ~1 人日 | ~5–7 人日 | +| 外部资金 | ~¥0 | ~¥1,500–3,000 | +| 页面覆盖 | 全部现有+V1.1 页面 | 全部现有+V1.1 页面+SEO 内容 | +| 支付适配 | 未涉及(微信支付在台湾亦不通,但免费核心不受影响) | **必须解决**(日本无微信支付) | + +--- + +## 5. 收益评估(流量 / 市场 / 竞争窗口 / 商业化) + +### 5.1 市场体量 + +| 维度 | zh-tw(台湾) | ja(日本) | +|---|---|---| +| 人口/潜在用户 | ~2,300 万,手作/DIY 受众稳定 | ~1.2 亿,手作市场成熟,アイロンビーズ有长期社区 | +| 拼豆搜索量 | 「拼豆 圖案」「拼豆 製作」量级中等 | 「アイロンビーズ 図案」量级大,品类词稳定 | +| 竞品投入 | 16 URL(最弱)→ **我方窗口敞口** | 25 URL(正式投入)→ **已有先发优势,竞争成本高** | +| 付费场景 | 台湾用户多走淘宝/代购/闲鱼(LAUNCH 渠道可覆盖) | 无微信支付,兑换码链路不通;需纯免费或本地支付改造 | +| ROI 评估 | **中收益 / 极低成本** → 正向 | 潜在高收益 / 成本高 + 支付前提未通 → **现阶段负向** | + +### 5.2 与我方战略的契合度 + +- 我方 `ROADMAP.md` 将「多语言」排在 **V2.0(半年后)**,且 V2.0 的成功指标要求「英文站自然访问 ≥10%」——官方规划的重心是 **en**,zh-tw/ja 未列入近期排期。 +- 我方当前优先级是**中国区商业模式验证**(首月转化率、AI 占比等北极星指标),不应被多语言工程稀释核心人力。 +- zh-tw 因**成本极低**,可作为一种「低成本 SEO 占位」顺带完成,不影响主线;ja 则显著挤占资源且商业化前提未满足。 + +--- + +## 6. ROI 对比与决策 + +| 语言 | 成本 | 收益 | 竞争窗口 | 商业化前提 | **决策** | +|---|---|---|---|---|---| +| **zh-tw** | ~1 人日 / ~¥0 | 中(台湾长尾 SEO + 品牌占位) | 敞开(竞品仅 16 URL) | 不阻塞免费核心 | **✅ 扩展(低成本执行)** | +| **ja** | ~5–7 人日 / ¥1,500+ | 高潜(日本成熟市场) | 已收窄(竞品 25 URL) | **未满足(无支付/兑换码链路)** | **⏸ 暂缓(条件触发再启)** | + +### 决策依据 + +**zh-tw → 扩展** +1. 简繁转换半自动,349 key 成本约 1 人日,几乎不占用主线资源。 +2. 竞品 zh-tw 建设最弱(16 URL、无色号表、无 about/contact),我方以完整色号表 + 全部页面入场即可拿到对等乃至更好的台湾 SEO 位。 +3. 台湾用户可经淘宝/闲鱼/代购渠道购买兑换码(LAUNCH.md 已定义),免费核心(生成/预览/备料)不受支付影响,先圈流量后议变现。 +4. 与 V1.1 新增页面(色号表×6 / showcase / 帮助中心)一同落地,边际成本最低。 + +**ja → 暂缓** +1. 兑换码商业模式强依赖微信支付,日本市场支付/渠道链路未定义——**流量进来也无法变现**,ROI 为负。 +2. 竞品已在 ja 正式投入(25 URL + 全色号表),我方以弱姿态进入难占优,且需要日文 SEO 内容体系(额外 1–2 人日),资源投入与收益不对等。 +3. 日文翻译质量门槛高,贸然上线劣质日文会损害品牌,不如不做。 +4. `ROADMAP.md` 将多语言排在 V2.0(en 优先),ja 应顺延至该阶段统一规划。 + +--- + +## 7. 执行建议与时间点 + +### 7.1 zh-tw 扩展建议执行方案 + +| 项 | 建议 | +|---|---| +| 时间点 | **V1.1 随新增页面(色号表×6 / showcase / 帮助中心)一并落地**,或中国区转化率达标(≥3%)后 2 周内启动 | +| 范围 | 全部现有 + V1.1 页面文案简→繁;新增 `/zh-tw/` 路由前缀 + hreflang + 独立 sitemap | +| 术语 | 人工校对台湾用词(图纸/圖紙、兑换/兌換、备料/備料),对齐台湾拼豆圈习惯 | +| 验收 | 349 key 全覆盖、台湾用词抽查 ≥95% 通过、hreflang 与 sitemap 生效 | +| 预估工作量 | **1–1.5 人日**(前端 + 内容校对) | + +### 7.2 ja 暂缓 + 重启条件 + +| 触发条件(任一满足即重启评估) | 说明 | +|---|---| +| ① V2.0 多语言规划正式立项(ROADMAP §4.2 项4) | 与 en 统一规划,共享 i18n 重构成果 | +| ② 日本/海外支付或渠道方案确定(如接 Stripe / 本地支付代收) | 商业化链路打通是 ja 落地的前置条件 | +| ③ 竞品 ja 站出现重大功能升级(monitor.js 双指纹告警触发) | 需跟进竞争态势时提前评估 | +| ④ 英文站海外投放数据证明海外市场空间(V2.0 指标: 自然访问≥10%) | 以真实数据支撑日文投入决策 | + +### 7.3 对工程的要求(无论扩展与否) + +- 前端 i18n 需在 V1.1 页面开发时**坚持全部文案走 `useT()` 与消息表**,杜绝硬编码,保证后续任意语言扩展零重构成本。 +- 路由层预留语言前缀机制(`/zh-tw/`、`/ja/` 等),避免后期迁移。 +- 色号表数据(品牌/色号/hex)与语言无关,可全语言共用,**数据层无需翻译**,仅页面文案与 SEO 元数据需要本地化。 + +--- + +## 8. 结论 + +| 语言 | 决策 | 核心理由 | 时间点 | +|---|---|---|---| +| **zh-tw** | **扩展** | 成本 ~1 人日/零资金;竞品该语言最弱,我方窗口敞开;免费核心不受支付影响 | V1.1 随新增页面一并落地 | +| **ja** | **暂缓** | 支付/兑换码链路未通,流量无法变现;竞品已深耕;ROI 现阶段为负 | V2.0 多语言立项或支付方案确定后重启 | + +> 本报告为 PM-Agent 决策依据。如需将 zh-tw 正式立项,请转排期为工程任务(预估 1–1.5 人日);ja 保持监控挂起状态,由 `monitor.js` 与 ROADMAP 里程碑联合触发重启评估。 + +--- + +*报告完。证据可复核: `competitor-analysis/pixelbeads-zh-detail.md` §1.2/§8、`competitor-analysis/pixelbeads-analysis.md` §1.3/§6、`docs/ROADMAP.md` §4.2-4.4、`perler-lab/src/i18n` 实测(349 key × 2 语言)。* diff --git a/docs/LEAFER-EVAL.md b/docs/LEAFER-EVAL.md new file mode 100644 index 0000000..07bade6 --- /dev/null +++ b/docs/LEAFER-EVAL.md @@ -0,0 +1,224 @@ +# LEAFER-EVAL · leafer.js 图纸渲染引擎评估报告 + +> 任务: T-085(前端:leafer.js 图纸渲染引擎评估——替代/对比现有 Canvas 2D 渲染的可行性、性能、成本) +> 日期: 2026-08-14 +> 范围: 本任务只产出评估文档,**不含任何源码改动、不引依赖入库** +> 适用前端: `D:\拼豆\perler-lab`(Vite 5 + React 18 + TS 5.9,当前 **0 渲染库依赖**,原生 Canvas 2D) +> 交叉引用: `docs/ANIMATION-PLAN.md`(§动画选型,已评估 leafer.js 用于 V2 画布升级)→ 本任务聚焦**图纸渲染引擎替换**评估,非动画 + +--- + +## 0. 决策摘要(一句话结论) + +> **V1 不换(保留原生 Canvas 2D 全链路);V2 编辑画布升级时引入 leafer.js 替换预览渲染层;PNG/PDF 导出通道保留 Canvas 2D——即「混合引入,分层边界」,与 ANIMATION-PLAN.md 选型一致。** + +理由三句: +1. **当前规模(最大 128×128=16,384 豆)远低于 leafer 的性能优势起点**(官方基准是 100 万对象),静态预览 + 一次性导出场景下,原生 Canvas 2D 单帧重绘 ≈ 1–5ms,leafer 的「百万对象、批处理 DrawCall」优势无感。 +2. **leafer 的真正价值在本项目的交互与动画**:内置拖拽/缩放/毫秒级点选命中、脏矩形局部刷新、属性补间(对应 ANIMATION-PLAN E-04/E-05/E-06)——这些是 V2 编辑画布升级的硬需求,V1 不出现。 +3. **引入成本真实存在**:leafer-ui 2.2.9(unpacked ≈ 4.2MB,核心裁剪 ≈ 70KB min+gzip)、无官方 React 绑定(需自维护 useEffect+ref 桥接)、渲染层整树重建。V1 为不存在的需求付这笔成本不成立。 + +--- + +## 1. 现状盘点:现有图纸渲染链路 + +### 1.1 代码链路 + +| 模块 | 职责 | 机制 | +|---|---|---| +| `src/lib/pattern-renderer.ts` | 基础绘制:`renderPattern` 逐格 `fillRect`(20px 格)+ `drawPaletteLegend` + `rgbToCss` | Canvas 2D | +| `src/lib/drawPattern.ts` | 预览 `drawPreview`:逐格 `arc`(圆豆,radius=cell×0.42)+ 网格线(每 5 格加粗、每 10 格标号)+ PNG 导出 `buildExportCanvas`(cell 22/28px + 标题 + 备豆清单) | Canvas 2D | +| `src/components/PreviewPanel.tsx` | 预览画布宿主:`useEffect` 监听 `result / gridSize / showGrid` 变化 → 全量调 `drawPreview` | 全量重绘 | +| `src/App.tsx` | `applyEdit`(撤销/重做/旋转/镜像/翻转)→ 改 `editedResult` 的 grid 数组 → 触发 PreviewPanel 全量重绘 | 数据层数组变换 + 全量重绘 | +| 导出 | `buildExportCanvas` 离屏一次性渲染 → `canvas.toBlob` PNG | 一次性渲染 | + +### 1.2 场景规模(实测自 `ControlsPanel.tsx` / `ChibiPage.tsx`) + +- `GRID_MIN=16`,`GRID_MAX=128`,预置 `[32, 64, 96, 128]`,chibi 默认 64。 +- **最大格数 128×128 = 16,384 格**,即 ≤16,384 颗豆(每格 1 圆)。 +- 预览 canvas:`gridSize×8px + 18×2px` 边框(128 格 ≈ 1,060px);**当前无缩放/平移交互**。 +- 导出 canvas:`gridSize≥96 时 cell=22px`(128 格 ≈ 2,816px 宽)。 + +### 1.3 当前性能瓶颈(任务描述「放大/编辑时」) + +- **编辑路径**:每次旋转/镜像/翻转/撤销 → grid 数组整体变换 → `drawPreview` 全量重绘(≤16,384 次 `beginPath+arc+fill` + 网格线)。单次约 5–15ms,无肉眼卡顿,但**无局部更新、无场景缓存**,编辑粒度与渲染粒度脱节。 +- **放大路径**:预览无缩放,用户感知的「放大」实际是导出(22/28px 大格)——属一次性渲染,非交互热点。 +- **结论**:现有瓶颈是「全量重绘架构 + 无交互层」的结构性问题,不是 fillRect/arc 吞吐量问题。 + +--- + +## 2. leafer.js 调研(2026-08-14 npm 实测 + 官方文档抓取) + +### 2.1 是什么 + +leafer.js(LeaferUI)是国产原创 2D Canvas 渲染引擎,场景树(scene graph)架构,定位「大规模、高密度、海量图层」生产力工具(Figma 级编辑器 / 无限画布)。5 年沉淀,GitHub 4.3k stars,官方 benchmark 对标 Pixi/Konva/Fabric。 + +### 2.2 版本与体积(npm 实测) + +| 包 | 版本 | unpackedSize | 说明 | +|---|---|---|---| +| `leafer-ui` | **2.2.9**(latest stable) | 4,356,846 B(≈4.2MB) | 全量 UI(含 Editor 插件/动画/布局) | +| `@leafer-ui/core` | 2.2.9 | 445,514 B(≈435KB) | 跨平台渲染核心(可裁剪) | +| `@leafer-ui/draw` | 2.2.9 | — | 基础绘制模块 | +| `leaferjs` | 2.0.1-**beta**.0 | 2.2MB | 主集成包(beta,不推荐生产) | +| `@leafer-ui/react` | **不存在**(E404) | — | 无官方 React 绑定 | +| `@leafer-ui/webgl` | **不存在**(E404) | — | **渲染后端为 Canvas 2D,无 WebGL 包** | + +官方 README 声明核心场景 **70KB min+gzip、零依赖**。体积可按需裁剪(只引 `@leafer-ui/core` + 所需显示对象)。 + +### 2.3 核心能力(官方文档确认) + +- **图形系统**:完整场景树,矢量图形 / SVG 路径 / 像素操作;`Rect`、`Circle`/`Ellipse`、`Group` 等显示对象;类 DOM API(`add/remove/clear`)。 +- **极致性能**:官方 benchmark——**100 万个可交互矩形**:首屏创建 1.28s vs 传统 Canvas 库 9–15s(约快 8x);内存 320MB vs 2–4GB(约省 8x);单元素拖拽 60FPS vs 0–4FPS(约流畅 15x)。 +- **技术机制**:批处理 DrawCall + **脏矩形局部刷新** + 毫秒级命中检测(Hit Testing)。 +- **内置交互**:原生 `draggable`、缩放、多点触控;Editor 插件一键开旋转/缩放/多选。 +- **导出**:`Export.png/jpeg/webp/canvas/download(element, …)`,支持 `scale` 缩放导出。 +- **动画**:内置状态驱动属性补间(`transition`)+ 路径动画(V2 E-04/E-05 可直接用)。 +- **跨平台**:Web / Node.js(离屏渲染、SSR 出图)/ 微信小程序 / H5,一套代码。 +- **许可**:**MIT,永久开源,可免费商用**;商业插件(PxGrow 编辑器套件/性能优化)为**可选**,非必需。 + +### 2.4 迁移实证(竞品调研,`competitor-analysis/animation-research.md` §3.2-1) + +> 像素编辑器 Konva→Leafer 迁移实录:**1000 元素、4K 屏,帧率 25–30→58–60 FPS、内存 120MB→40MB、DrawCall 800+→<50、点选命中 80ms→10ms**。 +> 佐证:百度像素风编辑器迁移文章 + 开源 Canva 平替 Gzm Design 均选 LeaferJS。 + +--- + +## 3. leafer.js vs 现有 Canvas 2D 对比表 + +| 维度 | **现有原生 Canvas 2D**(fillRect/arc 逐格) | **leafer.js(leafer-ui 2.2.9)** | 判定 | +|---|---|---|---| +| 渲染性能(静态一次性) | 16k 格重绘 ≈ 1–5ms,**完全够用** | 场景树 + 脏矩形,静态一次性场景收益 ≈ 0 | **平手**(本项目规模) | +| 渲染性能(持续交互/动画) | 全量重绘,>1 万豆 + 逐帧动画必掉帧 | 局部刷新 + 批处理 DrawCall,官方 1M 对象 60FPS | **leafer 大幅胜** | +| 内存 | 一次性像素缓冲,无对象开销 | 每豆一显示对象(16k Circle),静态场景反而略重 | **Canvas 略胜**(静态) | +| 缩放/平移/点选命中 | **无内置**,需手写 | 内置 `draggable`/缩放/毫秒级命中 | **leafer 大幅胜** | +| 局部更新(编辑单格/单豆) | 无场景缓存,只能全量重绘 | 脏矩形局部刷新 + 对象级属性更新 | **leafer 大幅胜** | +| API 友好度 | 命令式(`ctx.fillRect`),300 行自维护 | 类 DOM 场景树,`leafer.add(rect)` 声明式 | **leafer 胜** | +| React 集成 | 原生,`canvasRef` 直接可用 | **无官方绑定**,需自建 `useEffect`+ref 桥接层 | **Canvas 胜** | +| 包体积 | **0** | core 裁剪 ≈ 70KB min+gzip;全量 4.2MB | **Canvas 胜** | +| 导出能力 | `buildExportCanvas`+`toBlob` 已验证(PNG/PDF 复用) | `Export.png/canvas` 内置(支持 scale) | 平手(导出需重写) | +| 学习成本 | 已有存量代码,团队已会 | 新 API,现代类 Fabric/Konva 但更简,文档中文友好 | Canvas 略胜(存量) | +| 许可 | 自有 MIT | **MIT 永久开源、免费商用** | 平手 | +| 生态成熟度 | — | 较新(4.3k stars),第三方插件少,版本演进快(2.2.x) | Canvas 稳,leafer 需锁版本 | +| 动画能力 | 无(动画靠 CSS 层) | 内置属性补间 + 路径动画(E-04/E-05/E-06 直接可用) | **leafer 大幅胜** | + +**对比表结论**:在「静态预览 + 一次性导出」的当前 V1 场景,leafer 对 Canvas 2D **无性能优势、有体积与集成成本**;在「交互编辑 + 动画」的 V2 场景,leafer **全面胜出**。胜负完全取决于是否引入交互层。 + +--- + +## 4. 拼豆图纸渲染场景适配性分析 + +### 4.1 场景 A:大量矩形/圆形豆子绘制(静态预览)——**不匹配 leafer 优势** + +- 本项目最大 16,384 豆;leafer 官方基准是 **100 万对象**(约 60 倍差距)。 +- 原生 Canvas 2D 一次性绘制 16k 圆 ≈ 1–5ms;leafer 引入 16k 显示对象建树 + 序列化场景,静态首帧**不会更快**,内存反而更高(对象元数据开销)。 +- **结论**:纯静态预览 = 不换。 + +### 4.2 场景 B:缩放平移(画布拖拽,对齐竞品基线 / ANIMATION-PLAN E-06)——**leafer 强项** + +- 当前预览**无任何缩放/平移**,竞品基线明确要求 `translate3d` 合成层拖拽(E-06 P2)。 +- leafer 内置 `draggable` + view 缩放 + 毫秒级命中,一个 `drag` 示例即覆盖需求,无需手写矩阵变换 + 反算命中。 +- **结论**:引入交互层时,leafer 直接解决。 + +### 4.3 场景 C:局部更新(编辑画布场景)——**关键认知修正** + +- 当前编辑操作(旋转/镜像/翻转/撤销)是 **grid 数组级变换**(`rotateGrid` 等),不是单豆级修改 → 在 leafer 下也只能**整树重建**(数组变换 → 重建场景),脏矩形局部刷新优势被抵消。 +- leafer 的局部更新优势只对 **E-04 逐豆放置/编辑**(用户点一格改一颗)生效——这才是 leafer 真正发挥的场景。 +- **结论**:leafer 对「整图变换」无加速,对「逐豆交互编辑」显著加速。实施时应把编辑交互拆成「整图变换(全量重建)」与「逐豆操作(对象级更新)」两条路径。 + +### 4.4 场景 D:导出(PNG/PDF)——**不换** + +- 导出是一次性离屏渲染(cell 22/28px),非交互热点;`buildExportCanvas` 已验收(含标题/备豆清单/PDF 复用)。 +- leafer 的 `Export` 可替代但**无必要**:为一次性操作引入依赖 + 重写导出逻辑 + 回归测试,收益为负。 +- **结论**:导出通道保持 Canvas 2D,与 leafer 分层隔离(leafer 只做编辑画布交互层)。 + +### 4.5 适配性评分 + +| 场景 | 原生 Canvas 2D | leafer.js | 优势方 | +|---|---|---|---| +| 静态预览(≤16k 豆) | ★★★★★ | ★★★☆ | Canvas 2D | +| PNG/PDF 一次性导出 | ★★★★★ | ★★★☆ | Canvas 2D | +| 缩放/平移/点选交互 | ★★☆(手写) | ★★★★★ | leafer | +| 逐豆放置/编辑(E-04/E-05) | ★★☆(全量重绘) | ★★★★★ | leafer | +| 动画(E-04/05/06 补间) | ★(靠 CSS 层) | ★★★★★ | leafer | + +--- + +## 5. 推荐结论 + 理由 + +> **结论:混合引入(V1 不换 → V2 编辑画布升级引入 leafer.js,导出保留 Canvas 2D)。** + +### 5.1 为什么不是「立即替换」? + +1. **规模不匹配**:16,384 豆 vs leafer 百万对象基准,静态渲染零收益。 +2. **编辑操作是数组变换**:旋转/镜像等走整树重建路径,leafer 脏矩形优势用不上(§4.3)。 +3. **导出已验证**:`buildExportCanvas`/`downloadCanvas` 全链路已验收(含设计规范 §5),为一次性操作重写不划算。 +4. **成本真实**:70KB+ min+gzip 依赖、渲染层重写、无官方 React 绑定需自建桥接、2.2.x 版本演进快需锁版本。 + +### 5.2 为什么是「V2 引入」(而不是永远不换)? + +1. **交互是差异化刚需**:竞品基线(拖拽/缩放/命中)与 ANIMATION-PLAN E-04/05/06 都指向画布交互层,leafer 内置能力直接覆盖,自写方案(矩阵变换+反算命中+局部刷新)成本更高。 +2. **性能天花板**:>1 万豆 + 逐帧动画 + 持续拖拽时,原生全量重绘必然掉帧;leafer 迁移实证(帧率 25→60、DrawCall 800+→<50、点选 80→10ms)正是该场景的对症数据。 +3. **动画层依赖**:ANIMATION-PLAN 分层架构把 leafer 定为「第 1 层 画布渲染/交互」,anime.js 在其上做 spring/stagger——不引入 leafer,E-04/E-05 差异化动效无落地载体。 +4. **MIT 永久开源、免费商用**:无许可/供应商锁定风险。 + +### 5.3 边界(防止双引擎并存混乱) + +- **leafer 只接管「预览编辑画布」**(有交互/动画诉求的实时视图)。 +- **Canvas 2D 保留「导出」**(PNG/PDF 一次性离屏)与「后端/其他业务渲染」。 +- 二者通过数据层隔离:leafer 读同一 `ProcessResult`/`editedResult`,导出复用现有 `buildExportCanvas`,**同一数据源、双输出端**。 + +--- + +## 6. 实施路径(若 V2 引入) + +### 6.1 迁移步骤 + +1. **引入依赖**:`leafer-ui@^2.2.9` + `@leafer-ui/core@^2.2.9`(同步版本,防版本漂移);锁定精确版本,评估裁剪 `@leafer-ui/draw` 等子包。 +2. **React 桥接层**:新建 `LeaferCanvas.tsx`(`useRef` + `useEffect`,挂载建 `Leafer({ view })`、卸载 `leafer.destroy()`、重绘节流)——无官方绑定,桥接自维护,API 面收窄到 `Leafer/Rect/Circle/Group`。 +3. **渲染替换**:`drawPreview` 的场景化重写: + - `Group(Beans)`:每豆 1 个 `Circle`(fill=rgb,radius=cell×0.42); + - `Group(GridLines)`:网格线(5/10 加粗标号沿用现有 drawGrid 逻辑); + - 监听 `editedResult` 变化 → 整图变换(旋转/镜像)走全量重建;逐豆操作走对象级更新。 +4. **交互层**(E-06):`draggable` 平移 + 滚轮缩放 + 点选命中(leafer 内置)。 +5. **动画接入**(E-04/E-05):leafer `transition` 属性补间或 anime.js `spring`/`stagger`,对齐 ANIMATION-PLAN §5.3 参数(spring stiffness 170/damping 26、120–180ms)。 +6. **导出不动**:`buildExportCanvas`/`downloadCanvas` 保持 Canvas 2D,`Export` 仅作可选评估项。 +7. **验收口径**(对齐 ANIMATION-PLAN §7 V2):>1 万豆拖拽/放置保持 60FPS;DrawCall <50、点选命中 <10ms;双引擎边界清晰(预览=leafer,导出=Canvas 2D)。 + +### 6.2 风险与缓解 + +| 风险 | 缓解 | +|---|---| +| 无官方 React 绑定,桥接自维护 | 收窄 API 面(仅 4 个类);卸载清理 `destroy()`;重绘防抖/节流 | +| 版本演进快(2.2.x,leaferjs 主包还在 beta),API 漂移 | 锁精确版本;只依赖稳定核心类;升级走独立任务 + 回归 | +| 每豆一对象的静态开销(16k 对象 vs 一次性 fillRect) | 静态首帧仍可走全量批量;对象化收益留待交互/动画路径 | +| 编辑=数组变换时无加速(§4.3) | 明确拆分:整图变换全量重建、逐豆操作对象级更新;验收锚定后者 | +| 双引擎并存职责混淆 | §5.3 边界写入代码结构:预览组件只依赖 leafer,导出只依赖 Canvas 2D | +| 社区较新、第三方插件少 | 仅用官方核心能力,不依赖第三方插件 | + +--- + +## 7. 与 ANIMATION-PLAN.md 一致性校验 + +| ANIMATION-PLAN.md 结论 | 本评估 | 一致性 | +|---|---|---| +| §2/§3:leafer.js 定为「V2 引入(画布层)」,「图纸网格渲染/豆子交互/拖拽(**核心差异化**)」 | V2 引入 leafer 替换预览渲染层(交互+动画) | ✅ 一致 | +| §6.2:「>1 万豆 V1 保持原生 fillRect;leafer.js 迁移 V2 一次性承担,**避免 V1 双渲染引擎并存**」 | V1 不换、导出保留 Canvas 2D、V2 一次性引入并划定「预览=leafer / 导出=Canvas 2D」边界 | ✅ 一致(并细化边界) | +| §2 体积评估:「leafer 按需模块,数百 KB 级(仅画布层承担)」 | npm 实测 core 435KB unpacked / 核心场景 70KB min+gzip,按需裁剪成立 | ✅ 一致(数据落实) | +| §7 V2 验收:「>1 万豆拖拽/放置 60fps、DrawCall <50、点选 <10ms」 | 本评估 §6.1-7 采纳为 leafer 引入验收口径 | ✅ 一致 | +| §5.3 E-04/E-05/E-06(豆子 spring、闪烁、拖拽) | leafer 内置交互/补间覆盖,anime.js 按需叠加 | ✅ 一致 | + +**一致性结论:无冲突。** 本评估补充两点增量认知(不改变 ANIMATION-PLAN 选型): +1. **导出通道保留 Canvas 2D**(ANIMATION-PLAN 未明确导出层归属,本评估划定边界,防止双引擎并存混乱); +2. **编辑操作为数组级变换时 leafer 整树重建无加速**(纠正「引入 leafer 即解决编辑瓶颈」的朴素预期,把收益锚定在逐豆交互/动画)。 + +--- + +## 8. 数据来源 + +- **npm 实测**(2026-08-14):`leafer-ui@2.2.9` / `@leafer-ui/core@2.2.9` / `@leafer-ui/draw` 版本与 unpackedSize;`@leafer-ui/react`、`@leafer-ui/webgl` 不存在(E404 实证)。 +- **leafer-ui 官方 README / GitHub**(github.com/leaferjs/leafer-ui):MIT 许可、70KB min+gzip、100 万矩形 benchmark(1.28s / 320MB / 60FPS)、Export 模块、React/WebGL 无官方包。 +- **官方文档**(context7 /leaferjs/leafer-ui):场景树 API、`Group/Rect`、`Export.png/canvas`、`new Leafer({ view })`、`draggable`。 +- **竞品调研**(`competitor-analysis/animation-research.md` §3.2-1):Konva→Leafer 迁移实测(1000 元素 4K:帧率 25–30→58–60、内存 120→40MB、DrawCall 800+→<50、点选 80→10ms)。 +- **本项目现状**(`perler-lab/src` 抽查):`drawPattern.ts` / `pattern-renderer.ts` / `PreviewPanel.tsx` / `App.tsx` / `ControlsPanel.tsx`(GRID_MIN=16、GRID_MAX=128、预置 [32,64,96,128])。 + +> 附注:本报告为纯评估文档,不构成实施;后续实施任务引用本报告 §5/§6 作选型与验收依据。 diff --git a/docs/MOBILE-ECOSYSTEM.md b/docs/MOBILE-ECOSYSTEM.md new file mode 100644 index 0000000..23b62ad --- /dev/null +++ b/docs/MOBILE-ECOSYSTEM.md @@ -0,0 +1,285 @@ +# 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 既有决策,无推断项。* diff --git a/docs/NAV-ALIGNMENT.md b/docs/NAV-ALIGNMENT.md new file mode 100644 index 0000000..93c6fa1 --- /dev/null +++ b/docs/NAV-ALIGNMENT.md @@ -0,0 +1,196 @@ +# 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. 风险与注意 + +1. **单页锚点 vs 路由共存**:`#workspace`/`#top` 是锚点,`/chibi`/`/showcase` 是路由,active 高亮判定需分两套(滚动监听 + pathname 前缀),避免误判。 +2. **占位态不要裸链接**:暂缓项在 P0 必须给"建设中"反馈,绝不允许点进空白/404——这正是竞品 i18n 字典与渲染页不一致教训的反面应用。 +3. **PRO 徽标与商业定位**:AI 专区是付费能力(按次计费),PRO 徽标与状态文案是现有变现心智的一部分,改导航不得移除。 +4. **移动端抽屉不吞 CTA**:`mobile-cta` 购买/兑换按钮是变现入口,抽屉展开与底部 CTA 需共存。 +5. **不动算法/业务**:本任务只产出决策文档;源码实施由后续任务承接,P0-1/2/3 验收时不得触碰 `lib/` 管线与付费逻辑。 + +--- + +*文档完。全部决策基于 `pixelbeads-nav-crawl.md`(Spider 实测)与我方源码实读,无推断项。* diff --git a/docs/PWA-PLAN.md b/docs/PWA-PLAN.md new file mode 100644 index 0000000..c69728c --- /dev/null +++ b/docs/PWA-PLAN.md @@ -0,0 +1,293 @@ +# PWA-PLAN — PERLER LAB PWA 接入评估与实施方案 + +> **任务**: T-105 PWA 接入评估:manifest 与离线缓存方案 +> **角色**: Oracle-Architect-Agent +> **日期**: 2026-08-14 +> **输入依据**: +> - 竞品 manifest 实测: `competitor-analysis/raw/manifest-decoded.json`(PixelBeads:standalone / 192+512 maskable 图标 / 白底) +> - 我方现状: `perler-lab/vite.config.ts`(Vite+React SPA)、`perler-lab/index.html`、`src/main.tsx`(客户端路由按 pathname 分发)、`public/`(仅 favicon.svg,无 PNG 图标) +> - 约束: 不引入不必要新依赖(优先手写)、不做原生应用(竞品 Chrome 插件 + Android/iOS 生态不在本次范围) + +--- + +## 0. 结论速览(推荐方案) + +| 维度 | 结论 | +|---|---| +| **方案** | **手写 `public/manifest.webmanifest` + `public/sw.js` + 手动注册**(零新依赖) | +| 备选 | vite-plugin-pwa(工作区缓存 + 自动注入,但新增构建依赖) | +| **首期落地** | P0 前置(PNG 图标 + HTTPS 就绪)→ P1 manifest + 注册 → P2 SW precache + 运行时缓存 → P3 安装提示 | +| 收益 | 安装到桌面/主屏、离线可用、首屏加速(SW 接管静态资源)、竞品对齐(standalone 体验) | +| 风险 | 缓存失效/版本管理、图标缺失导致不可安装、SW 需 HTTPS(localhost 例外) | + +**推荐理由(手写 vs vite-plugin-pwa)**: + +1. **零新依赖**——项目一贯原则(对比 PDF 导出 T-076 同样零依赖手写),手写 manifest + SW 只涉及 2 个静态文件 + 一段注册代码,不进入 `package.json`。 +2. **SPA 架构极简**——单页 + pathname 路由 + 构建产物 `dist/` 下 js/css 均带内容哈希,手写 precache 只需在发布时刷新一份资源清单,无复杂集成面。 +3. **可控的缓存策略**——vite-plugin-pwa 默认 generateSW 注入 workbox 运行时(额外 ~20KB),我方离线需求(静态资源 + SPA shell + 离线降级)用原生 Cache API 即可覆盖,策略完全在手。 +4. **迁移成本低**——未来若需要自动资源清单/更细粒度运行时缓存,可平滑升级到 vite-plugin-pwa,manifest 与 sw.js 内容可直接复用。 + +> 竞品对齐边界:竞品 manifest 仅 4 个核心字段(name/short_name/display/icons/theme+background)。我方在其基础上补齐 `start_url/scope/id`,保证安装与离线行为确定;**不做**竞品的三端应用生态。 + +--- + +## 1. 现状与竞品对比 + +### 1.1 我方现状 + +| 项 | 现状 | 对 PWA 的影响 | +|---|---|---| +| 构建 | Vite + React SPA,`dist/` 输出 | 产物含哈希,适合 SW precache | +| 路由 | `App.tsx` 按 `window.location.pathname` 分发(/、/chibi、/color-chart、/showcase、/library、/help) | 离线需导航请求 fallback 到 SPA shell | +| 图标 | 仅 `public/favicon.svg` | **缺少 192/512 PNG,阻断安装提示**(P0 前置) | +| 传输 | 静态部署(nginx/Docker,见 DEPLOY.md) | 需确认 HTTPS(T-030 已含域名与 HTTPS 章节) | +| 数据 | 图片处理在浏览器本地完成(FAQ-33),无用户体系 | 离线缓存不涉及敏感数据,风险低 | + +### 1.2 竞品 manifest(pixel-beads,实测解码) + +```json +{ + "name": "PixelBeads – Perler Bead Pattern Generator", + "short_name": "PixelBeads", + "description": "Create, edit, and export Perler bead patterns and pixel art in your browser.", + "start_url": "/", + "scope": "/", + "icons": [ + { "src": "/web-app-manifest-192x192.png", "sizes": "192x192", "type": "image/png", "purpose": "maskable" }, + { "src": "/web-app-manifest-512x512.png", "sizes": "512x512", "type": "image/png", "purpose": "maskable" } + ], + "theme_color": "#ffffff", + "background_color": "#ffffff", + "display": "standalone" +} +``` + +竞品要点:`display: standalone`(独立窗口,无地址栏)、maskable 图标、白底主题。我方沿用这一字段基线。 + +--- + +## 2. manifest 字段设计(建议落地值) + +文件:`perler-lab/public/manifest.webmanifest`(MIME `application/manifest+json`,Vite 会自动把 `public/` 拷入 `dist/`)。 + +```json +{ + "id": "/", + "name": "PERLER LAB · 拼豆图纸生成器", + "short_name": "PERLER LAB", + "description": "把喜欢的图片,变成一颗颗拼豆。免费生成、调整拼豆图纸,支持六品牌色号速查。", + "start_url": "/", + "scope": "/", + "display": "standalone", + "orientation": "portrait-primary", + "background_color": "#f4f3ef", + "theme_color": "#f4f3ef", + "lang": "zh-CN", + "categories": ["design", "art", "photography"], + "icons": [ + { "src": "/icons/icon-192.png", "sizes": "192x192", "type": "image/png", "purpose": "any" }, + { "src": "/icons/icon-192-maskable.png", "sizes": "192x192", "type": "image/png", "purpose": "maskable" }, + { "src": "/icons/icon-512.png", "sizes": "512x512", "type": "image/png", "purpose": "any" }, + { "src": "/icons/icon-512-maskable.png", "sizes": "512x512", "type": "image/png", "purpose": "maskable" } + ], + "shortcuts": [ + { "name": "品牌色号表", "short_name": "色号表", "url": "/color-chart", "icons": [{ "src": "/icons/icon-192.png", "sizes": "192x192" }] }, + { "name": "AI 拼豆专区", "short_name": "AI 专区", "url": "/chibi", "icons": [{ "src": "/icons/icon-192.png", "sizes": "192x192" }] } + ] +} +``` + +字段说明: + +| 字段 | 值 | 理由 | +|---|---|---| +| `id` | `/` | Chrome 120+ 安装身份标识,固定根路径避免随 start_url 变化重复安装 | +| `display` | `standalone` | 对齐竞品,独立窗口体验 | +| `theme_color` / `background_color` | `#f4f3ef` | 对齐 DESIGN.md 页面底色(`--bg-page`),启动屏与浏览器 UI 观感一致 | +| `start_url` / `scope` | `/` | 全站可安装、可离线;scope 收紧到站内,禁止 SW 越界 | +| `icons` | 192/512 any+maskable | **Chrome 安装硬性要求**;maskable 保证圆形裁剪安全区(图标主体留 ≥ 20% 安全边距) | +| `shortcuts` | 色号表 / AI 专区 | 长按/右键跳转深链,复用已有路由,成本≈0 | + +> **index.html 配套改动**:`` + `` + ``(iOS 主屏)。iOS 需额外 `apple-mobile-web-app-capable` meta 才可全屏。 + +--- + +## 3. Service Worker 缓存策略 + +文件:`perler-lab/public/sw.js`(手写,原生 Cache API,无 workbox)。版本号 `const VERSION = 'v1'`,每次发布递增缓存名 `perler-precache-${VERSION}` / `perler-runtime-${VERSION}`。 + +### 3.1 缓存分层 + +| 缓存 | 内容 | 策略 | +|---|---|---| +| `perler-precache-v1` | `index.html` + `assets/*.js` + `assets/*.css`(构建产物,发布时刷新清单) | **install 时预缓存(precache)** | +| `perler-runtime-v1` | 图片/字体/`/color-chart` 等静态资源 | **stale-while-revalidate** | +| 导航请求(`mode: 'navigate'`) | — | **network-first → fallback 缓存的 index.html(离线 SPA shell)** | +| `/api/*`、POST、fetch(XHR) | — | **网络优先,不缓存**(后端动态数据;POST 含支付/兑换,绝不下 SW 缓存) | + +### 3.2 关键策略伪代码 + +```js +// ① install:预缓存静态资源,任何一项失败即整体失败(安装不完整则中断) +self.addEventListener('install', (e) => { + e.waitUntil( + caches.open(PRECACHE).then((c) => c.addAll(PRECACHE_ASSETS)), + ); + self.skipWaiting(); +}); + +// ② activate:清理旧版本缓存,立即接管页面 +self.addEventListener('activate', (e) => { + e.waitUntil( + caches.keys().then((keys) => + Promise.all(keys.filter((k) => k !== PRECACHE && k !== RUNTIME).map((k) => caches.delete(k))), + ), + ); + self.clients.claim(); +}); + +// ③ fetch:三类分流 +self.addEventListener('fetch', (e) => { + const req = e.request; + if (req.method !== 'GET') return; // 非 GET 一律放行 + const url = new URL(req.url); + if (url.origin !== location.origin) return; // 跨域放行(可另加白名单运行时缓存) + + if (req.mode === 'navigate') { + // 导航:network-first,离线回退 SPA shell + e.respondWith( + fetch(req).then((res) => { + const copy = res.clone(); + caches.open(RUNTIME).then((c) => c.put(req, copy)); + return res; + }).catch(() => caches.match('/index.html')), + ); + return; + } + + if (url.pathname.startsWith('/api/')) return; // API 网络优先,不缓存 + + // 静态资源:stale-while-revalidate(秒开体验 + 后台更新) + e.respondWith( + caches.match(req).then((cached) => { + const network = fetch(req) + .then((res) => { + if (res.ok) { + const copy = res.clone(); + caches.open(RUNTIME).then((c) => c.put(req, copy)); + } + return res; + }) + .catch(() => cached); + return cached || network; + }), + ); +}); +``` + +### 3.3 资源清单(precache)维护方式 + +推荐:**发布时生成**(`dist/` 内 js/css 均含内容哈希)。提供两种维护法,二选一: +1. 简单法:发布后在 `dist/` 手动跑 `node scripts/build-precache.mjs`(读取 `dist/index.html` 中 `assets/*` 引用 + 固定项,输出 SW 顶部 `PRECACHE_ASSETS` 数组)。 +2. 保守法:`index.html` 永远在清单首项(离线 shell),js/css 每次发布整体更新 `VERSION` 并重建清单,保证原子切换。 + +> ⚠️ 不用 cache-first 缓存 `index.html`:开发/灰度时 html 变化需即时生效,故导航用 network-first。 + +--- + +## 4. 离线页面 + +SPA 客户端渲染架构下,**导航 fallback 到缓存的 `index.html` 即自动获得离线页面**——React 应用本身可完整渲染,无需独立 `/offline.html`。 + +离线降级路径: + +| 场景 | 行为 | +|---|---| +| 已访问过任意页面 + 离线 | 导航请求失败 → 返回缓存的 `index.html` → 应用正常渲染(静态资源命中 precache/runtime) | +| 首次安装后未访问 + 离线 | 缓存中无 shell → 浏览器默认「无法连接」页(预期内,P2 后可加 first-visit 预缓存) | +| 离线时请求 `/api/*` | 放行到网络失败,前端 api.ts 现有错误提示兜底(不缓存敏感数据) | + +可选增强(P3):hero 区顶部 banner「当前离线,显示缓存内容」——通过 `navigator.onLine` + SW message 检测,成本低、体验完整。 + +--- + +## 5. 安装提示(Install Prompt) + +竞品纯 Web 无自定义安装引导;我方建议**温和引导**(不弹窗打扰、不拦截首屏): + +1. **PWA 资格预检**:`display-mode: standalone` matchMedia 判断已安装态;监听 `beforeinstallprompt`(Chrome 有资格时触发)。 +2. **触发时机**:用户已完成一次完整流程(如下载/生成图纸后)或停留 > 30s,在底部浮出「添加到主屏幕 / 安装到桌面」横幅(可关闭,`localStorage` 记 dismissed)。 +3. **deferredPrompt**:捕获 `beforeinstallprompt` 事件存入变量,点横幅时 `prompt()`;`appinstalled` 后清理横幅。 +4. **iOS Safari**:无 install prompt API,横幅展示「分享 → 添加到主屏幕」图文指引(`navigator.standalone` 判断 iOS)。 + +```ts +// src/lib/pwa-install.ts(P3 落地,示意) +let deferred: BeforeInstallPromptEvent | null = null; +window.addEventListener('beforeinstallprompt', (e) => { + e.preventDefault(); + deferred = e as BeforeInstallPromptEvent; + window.dispatchEvent(new CustomEvent('pwa-installable', { detail: { deferred } })); +}); +window.addEventListener('appinstalled', () => { + window.dispatchEvent(new CustomEvent('pwa-installed')); +}); +``` + +--- + +## 6. 注册代码 + +文件:`perler-lab/src/main.tsx` 追加(仅生产环境注册,避免 dev 热更替被 SW 缓存干扰): + +```ts +// 生产环境注册 Service Worker(public/sw.js 构建后自动复制到 dist/) +if (import.meta.env.PROD && 'serviceWorker' in navigator) { + window.addEventListener('load', () => { + navigator.serviceWorker.register('/sw.js').catch((err) => { + console.warn('[PWA] SW 注册失败:', err); + }); + }); +} +``` + +> dev 模式不注册:Vite HMR 与 SW 缓存冲突;仅 `dist/` 生产构建验证。 + +--- + +## 7. 实施拆解(建议任务拆分) + +| ID | 优先级 | 任务 | 验收标准 | +|---|---|---|---| +| P0-1 | P0 | 生成 192/512 PNG 图标(any+maskable,主题色 `#f4f3ef`,可基于 favicon.svg 导出) | 4 个文件入 `public/icons/`,Chrome DevTools 安装资格无图标报错 | +| P0-2 | P0 | 确认生产 HTTPS 就绪(T-030 已含) | 生产域名证书有效,SW 可在 https 注册 | +| P1-1 | P1 | `public/manifest.webmanifest` + `index.html` 注入 link/meta | DevTools Application 面板读取正常,字段无警告 | +| P1-2 | P1 | `src/main.tsx` 注册 SW(PROD 守卫) | 生产构建 `dist/` 部署后 `navigator.serviceWorker.controller` 非空 | +| P2-1 | P2 | `public/sw.js` precache + 运行时缓存 + 离线 fallback | 离线模式(Network offline)刷新可打开站点并看到缓存内容 | +| P2-2 | P2 | 资源清单生成脚本 `scripts/build-precache.mjs` | 发布后 dist 清单与实际产物一致 | +| P3-1 | P3 | 安装提示横幅 + 已安装态检测 | beforeinstallprompt 触发、横幅可关闭、已安装不再出现 | +| P3-2 | P3 | 离线 banner + 版本更新提示(skipWaiting 后刷新引导) | 新版本发布后旧标签页收到更新提示 | + +> 本任务(T-105)交付本评估文档;P0–P3 拆为独立任务由前端承接实施。 + +--- + +## 8. 风险与注意 + +1. **SW 注册失败静默**:注册代码 try/catch 仅告警,绝不阻塞主流程。 +2. **缓存与发版不同步**:SW 有更新滞后窗口(默认 24h 检查,`updateViaCache` 与 `skipWaiting` 已缓解);发布流程需包含「递增 VERSION」动作。 +3. **HTTPS 前置**:SW 仅在 secure context 可用(localhost 例外),生产必须 HTTPS(T-030 已就绪)。 +4. **不要缓存敏感/动态数据**:`/api/*` 与 POST 一律网络优先;支付回调、兑换码相关请求严禁落入 SW 缓存。 +5. **iOS 限制**:iOS Safari 不支持 beforeinstallprompt、SW 更新较激进、旧版本不清理缓存——低优先级适配即可,不做主路径投入。 +6. **离线不等于单机可用**:AI 生成等后端能力离线不可用属预期,离线收益聚焦「浏览/查阅色号表/已缓存图纸」。 + +--- + +## 9. 部署配套(对接 T-110) + +- `nginx` 需为 `/.webmanifest` / `manifest.webmanifest` 返回 `application/manifest+json`,`/sw.js` 返回 `application/javascript` 且 **禁止协商缓存**(`Cache-Control: no-cache`,SW 自身更新依赖每次校验)。 +- `index.html` 建议 `no-cache`(网络优先策略前提)。 +- `dist/assets/*` 内容哈希 + 长缓存不变。 + +--- + +*文档完。方案基于竞品 manifest 实测(`manifest-decoded.json`)与我方源码实读(vite.config.ts / index.html / main.tsx / App.tsx),无推断项。* diff --git a/docs/RELEASE-V1.1.md b/docs/RELEASE-V1.1.md new file mode 100644 index 0000000..9718d10 --- /dev/null +++ b/docs/RELEASE-V1.1.md @@ -0,0 +1,190 @@ +# PERLER LAB V1.1 发布计划(RELEASE-V1.1) + +> 版本: v1.0 · 文档编号: RELEASE-V1.1 · 关联任务: T-111 +> 角色: Release-Manager · 日期: 2026-08-14 +> 上游依据: RELEASE-PIPELINE.md(发布流水线)、LAUNCH.md(SEO/上线)、NAV-ALIGNMENT.md(导航对齐)、ROADMAP.md(V1.1 增长版)、CI-GATES.md(质量门禁)、DEPLOY.md(部署) +> 当前基线: V1.0 已发布(70 任务验收通过),V1.1 批次 T-091~T-111 共 21 个任务 + BUG-112 并行开发中 + +--- + +## 0. 结论速览 + +| 维度 | 结果 | +|---|---| +| V1.1 主题 | 导航对齐(NAV-ALIGNMENT P0/P1)+ 色号表 SEO 页 + Showcase + 图纸库 + 帮助中心 + 评估类文档 | +| 范围条目数 | 22 条(21 任务 + BUG-112),其中代码交付 14 条、文档交付 8 条 | +| 里程碑 | M1 前端页面 → M2 后端接口 → M3 集成联调 → M4 发布(M1/M2 可并行) | +| 发布方式 | 沿用 RELEASE-PIPELINE.md:验收 → auto-commit 自动提交 → gitflow.js push master → CI(deploy.yml)→ 部署 | +| 阻塞点 | T-096 不合格 → BUG-112 修复中;T-110 部署核对、T-109 CI 门禁为发布前置 | +| 回滚手段 | git revert 重新推送;Docker 镜像回退上一版本;SQLite 备份还原 | + +--- + +## 1. V1.1 范围清单 + +> 交付类型标注:**[代码]** = 源码/构建/CI 交付(进 git 与生产),**[文档]** = 决策/评估/文案文档交付(进 docs/,作为代码交付的依据或内容源)。 + +| # | 工作项 | 关联任务 | 交付类型 | 当前状态 | 说明 | +|---|---|---|---|---|---| +| 1 | 色号表页:六品牌页面组件实现 | T-091 | **[代码]** | 待验收 | ColorChartPage.tsx + CSS,tab 切换 + 表格 + URL 品牌段 + i18n + 响应式 | +| 2 | 色号表页:数据层接入 | T-092 | **[代码]** | 待验收 | color-chart-data.ts,六品牌聚合(221/174/103/92/18/30 色) | +| 3 | 色号表页:路由注册 | T-093 | **[代码]** | 待验收 | /color-chart 与 /color-chart/:brand,未知品牌回退 MARD | +| 4 | 色号表页:JSON-LD 结构化数据 | T-094 | **[代码]** | 待验收 | GET /api/color-chart/:brand,CollectionPage+ItemList schema | +| 5 | 色号表页:内链与导航入口 | T-095 | **[代码]** | 开发中 | 首页/页脚内链 + 导航入口,吃「拼豆色号表」长尾词 | +| 6 | 色号表页:SEO 标题与描述 | T-096 | **[文档]** | 不合格 → BUG-112 修复中 | SEO-COLORCHARTS.md 六品牌 zh+en title/description,BUG-112 重做 | +| 7 | Showcase:作品展示页路由与布局 | T-097 | **[代码]** | 待验收 | /showcase 路由 + 响应式卡片网格(4/3/2/1 列) | +| 8 | Showcase:作品卡片与标签筛选 | T-098 | **[代码]** | 待验收 | WorkCard 组件 + 分类筛选,种子数据 lib/showcase.ts | +| 9 | Showcase:发布保存接口 | T-099 | **[代码]** | 待验收 | POST /api/showcase/works,showcase_works 表 + 校验(DB schema 变更) | +| 10 | Showcase:列表查询接口 | T-100 | **[代码]** | 待验收 | GET /api/showcase/works 分页 + 标签/来源筛选 | +| 11 | Showcase:SEO 元数据接口 | T-101 | **[代码]** | 待验收 | GET /api/showcase/meta,title/description/ogImage/jsonLd | +| 12 | Showcase:发布流程前端接入 | T-102 | **[代码]** | 待验收 | ChibiPage 发布入口 + publishShowcaseWork | +| 13 | 图纸库:列表页组件与路由 | T-108 | **[代码]** | 待验收 | /library 路由,复用 showcase 数据源,空态兜底 | +| 14 | 帮助中心:FAQ 页面组件 | T-106 | **[代码]** | 开发中 | /help 路由,单页 FAQ 区块 | +| 15 | 帮助中心:FAQ 数据整理 | T-107 | **[文档]** | 验收通过 | FAQ-DATA.md 35 条双语言,供 T-106 渲染 | +| 16 | PWA 接入评估 | T-105 | **[文档]** | 开发中 | manifest 与离线缓存方案评估,产出评估结论供 V2.0 立项 | +| 17 | i18n 扩展评估(zh-tw/ja) | T-103 | **[文档]** | 待验收 | I18N-ROI.md:zh-tw 建议落地、ja 建议暂缓 | +| 18 | 商业模式细化文档 | T-104 | **[文档]** | 待验收 | BUSINESS-MODEL.md:免费 12 项 / 付费 9 项边界 | +| 19 | CI 门禁:新页面构建检查 | T-109 | **[代码]** | 开发中 | deploy.yml 覆盖色号表/Showcase/图纸库/帮助路由构建 | +| 20 | 部署核对:路由与静态资源 | T-110 | **[代码]** | 开发中 | nginx SPA fallback + 静态资源部署配置核对 | +| 21 | 发布计划:V1.1 里程碑 | T-111 | **[文档]** | 开发中(本文档) | 里程碑/范围/门禁/发布步骤/回滚 | +| 22 | BUG 修复:色号表 SEO 元数据 | BUG-112 | **[文档]** | 开发中 | T-096 验收不合格的返工任务 | + +**统计:代码交付 14 条(#1~5、7~14、19~20),文档交付 8 条(#6、15~18、21~22)。** + +### 1.1 范围边界(本批次不含) + +- **T-065 BFS 杂色清理、T-085 leafer.js 渲染引擎评估**:V1.0 遗留/独立评估任务,不在 T-091~T-111 发布闸门内,不阻塞 V1.1 发布。 +- 导航对齐 P2 项(`/chibi?cat=` 深链、帮助子页化):NAV-ALIGNMENT 定义为 P2 按需,**V1.1 不承诺交付**,随数据进入后续版本。 +- 客户端(apps)、拼豆创作独立页:NAV-ALIGNMENT 决策为「不做 / 暂缓」,不在范围内。 +- 批量生成、导出优化、埋点看板、历史记录:ROADMAP V1.1 远期功能,未进入本批次,后续迭代。 + +--- + +## 2. 里程碑阶段划分 + +> M1/M2 互不依赖可并行;M3 依赖 M1+M2 基本就绪;M4 依赖 M3 全绿。 + +### M1 前端页面(对应 NAV-ALIGNMENT P0/P1 页面跟上) + +| 任务 | 交付物 | +|---|---| +| T-091/T-092/T-093 | 色号表页组件 + 数据层 + 路由 | +| T-095 | 色号表内链与导航入口 | +| T-097/T-098 | Showcase 页面 + 作品卡片 | +| T-106 | 帮助中心 FAQ 页面 | +| T-108 | 图纸库页面 | + +**出口条件**:五个新路由(/color-chart、/showcase、/library、/help + 品牌子路由)全部可达;导航 7 项真实跳转,无「建设中」占位残留(NAV-ALIGNMENT §3.3 P1 撤下占位)。 + +### M2 后端接口 + +| 任务 | 交付物 | +|---|---| +| T-094 | JSON-LD 结构化数据接口 | +| T-099 | Showcase 发布保存接口(含 schema 变更) | +| T-100 | Showcase 列表查询接口 | +| T-101 | Showcase SEO 元数据接口 | + +**出口条件**:4 个新端点契约对齐;showcase_works 表迁移对旧库平滑(新增表不影响既有表);npm test 全绿。 + +### M3 集成联调 + +| 任务 | 交付物 | +|---|---| +| T-102 | Showcase 发布流程前端接入(端到端:发布 → 落库 → 列表展示) | +| T-109 | CI 门禁覆盖新页面构建检查 | +| T-110 | 部署核对:路由 fallback + 静态资源 | +| 文档类 | T-096/BUG-112、T-103、T-104、T-105、T-107 全部验收通过 | + +**出口条件**:发布→列表全链路可用;本地 `npm run build` + `npm run typecheck` + `npm test` 全绿;`node taskboard.js list` 无 V1.1 任务处于「不合格」状态。 + +### M4 发布 + +| 动作 | 负责人 | +|---|---| +| 全量验收复核 | QA-Tester-Agent | +| 推送 master 触发 CI | GitOps-Engineer | +| 部署与健康检查 | DevOps-Engineer | +| 线上冒烟(新页面可达 + 导航跳转) | 主代理 / QA | +| 版本号与文档归档 | Release-Manager(T-111) | + +--- + +## 3. 验收门禁(QA 验收条件) + +> 每任务经 `node taskboard.js test --pass/--fail` 验收;下述条件为 V1.1 **放行闸门**,全部满足才进入 M4。门禁细则以 CI-GATES.md G1~G9 为准。 + +### G-API 代码门禁 +- **typecheck**:`npm run typecheck`(perler-lab 与 perler-lab-server 两端),`tsc --noEmit` 0 错误,strict 开启(CI-GATES G3)。 +- **单测**:`npm test` 前后端全部通过,退出码 0(CI-GATES G1/G2,基线前端 147+ 后端 121+,当前批注实测前端 176/后端 156 用例全过)。 +- **构建**:`npm run build`(vite build)产出 dist/ 成功(CI-GATES G4)。 +- **CI 冒烟**:T-109 落地后,push 触发 deploy.yml 三阶段(test → build → deploy)全程绿(G7 并发保护、G8 超时、G9 YAML 有效)。 + +### G-PAGE 页面可达门禁 +- 五个新路由 HTTP 可达,SPA 刷新/直链不 404(nginx `try_files` fallback 由 T-110 核对)。 +- 导航 7 项点击均落在真实页面(NAV-ALIGNMENT §5 教训:不允许「字典有、页面无」的悬空链接)。 +- 移动端 <1024px 抽屉含「工具」组且无横向溢出;底部固定 CTA 保留可见。 +- JSON-LD:/color-chart 与 /showcase 源码含 `application/ld+json` 脚本(CollectionPage/WebPage schema)。 +- 未知品牌路由回退 MARD 不白屏;Showcase 空态兜底正常。 + +### G-DOC 文档门禁 +- SEO-COLORCHARTS.md(BUG-112):六品牌 zh+en title/description 全量覆盖、长度合规、URL slug 无冲突。 +- I18N-ROI.md、BUSINESS-MODEL.md、PWA 评估(T-105)结论明确且与 PRD/LAUNCH 定价无冲突。 +- FAQ-DATA.md 与 /help 页面渲染文案一致。 + +--- + +## 4. 发布步骤(git flow,沿用 RELEASE-PIPELINE.md) + +``` +验收通过 ──▶ auto-commit.js 自动提交 ──▶ gitflow.js push master ──▶ CI(deploy.yml) ──▶ 部署验证 + (test --pass) (git add -A + commit) (人工闸门) (test→build→deploy) +``` + +### 步骤 1:验收 +- QA 对 22 条任务逐条 `node taskboard.js test --pass/--fail`,状态进入 `approved` / `rejected`(不合格自动生成 Bug,如 BUG-112)。 + +### 步骤 2:自动提交(Release-Manager 管道) +- `auto-commit.js` 常驻轮询,检测到新 `approved` 任务后执行 `git add -A` + `git commit -m "[验收通过] <标题>"`(RELEASE-PIPELINE §3)。 +- 提交记录入 `auto-commit.log`;工作区无改动则跳过,不产生空提交。 + +### 步骤 3:推送 master(人工闸门,GitOps 工程师) +```bash +node gitflow.js push # 或 git push -u origin master +``` +- ⚠️ push 是对外发布动作,**必须人工确认**后执行(RELEASE-PIPELINE §4)。确认项:auto-commit.log 无失败重试、`git status` 无遗漏改动、V1.1 无不合格任务残留。 + +### 步骤 4:CI(push 触发,自动) +- push 触发 `.github/workflows/deploy.yml`:test(前端+后端矩阵)→ build(Docker 镜像)→ deploy(SSH,需 Secrets 已配置,未配置自动跳过)。 +- 任一 job 失败:查看 Actions 日志 → 修复 → 重新推送(CI-GATES §7 故障处理)。 + +### 步骤 5:部署与验证(DevOps 工程师) +- 生产 `docker compose -f perler-lab-server/docker-compose.yml up -d --build`,健康检查 3 次失败自动重启兜底(DEPLOY.md)。 +- 线上冒烟:/color-chart、/showcase、/library、/help 直达 200;导航 7 项逐一点击;生成→发布→列表主链路走一遍。 +- 数据库:showcase_works 新表自动建表成功(无迁移脚本残留),既有数据完好。 + +### 步骤 6:归档 +- 更新 ROADMAP.md 状态;auto-commit.log 存档;确认 V1.1 全部任务 `approved`,无遗留 `in_progress`。 + +--- + +## 5. 风险与回滚 + +| # | 风险 | 等级 | 对策 | 回滚手段 | +|---|---|---|---|---| +| 1 | 新路由 SPA 直链 404(nginx fallback 未配) | 高 | T-110 部署核对前置,压测直链刷新 | revert fallback 配置提交并重新部署 | +| 2 | showcase_works 建表失败 / schema 冲突 | 高 | M2 验收含旧库兼容测试,T-099 单测覆盖建表 | 保留部署前 SQLite 备份(DEPLOY.md 备份机制),还原后重启 | +| 3 | 色号表 SEO 质量不达标(T-096 已返工) | 中 | BUG-112 全量重做六品牌 zh/en,QA 按长度/覆盖度复核 | 本项为文档交付,不影响代码,延后合入不阻塞构建 | +| 4 | CI 门禁新增后构建炸裂 | 中 | T-109 本地先验证 deploy.yml,push 前 `npm run build` 自检 | git revert 该提交 → 重新 push,Docker 回退上一镜像版本 | +| 5 | i18n 新 key 缺失致 `Messages` 类型错误 | 低 | en.ts 受类型约束强制键全等(编译期拦截,NAV-ALIGNMENT P0-2) | typecheck 阶段即拦截,不会进生产 | +| 6 | Showcase 发布接口被滥用(base64 注入) | 中 | T-099 已做长度/格式/标签白名单校验 + 频控 | 线上观察 publish 失败率,超阈值关停入口,回滚提交 | +| 7 | 导航改造回归(占位残留 / 移动端溢出) | 中 | M1 出口条件强制检查 7 项真实跳转 + 抽屉无溢出 | 保留导航改造前提交点,revert 后重新推送 | + +**通用回滚流程**(RELEASE-PIPELINE §5/§7): +1. `git log --oneline -10` 定位问题提交 → `git revert ` → `node gitflow.js push` 重新触发 CI。 +2. 生产 Docker 回退:`docker compose up -d` 前将镜像 tag 指回上一版本,或从备份还原 volume。 +3. 数据库回滚:优先使用部署前 `.backup` 还原(WAL 模式下用 `sqlite3 .backup` 命令而非直接拷贝,DEPLOY.md 明确要求)。 + +--- + +*文档完。范围与状态以 taskboard.js 实时看板为准,本计划为 V1.1 发布基线。* diff --git a/docs/SEO-COLORCHARTS.md b/docs/SEO-COLORCHARTS.md new file mode 100644 index 0000000..99ef158 --- /dev/null +++ b/docs/SEO-COLORCHARTS.md @@ -0,0 +1,101 @@ +# 六品牌拼豆色号表页 SEO 文案(T-096) + +> 任务: T-096 色号表 SEO 页面:六品牌色号表页 SEO 标题与描述 +> 产出: 6 组 SEO 文案(title / meta description / URL slug) +> 数据来源: `competitor-analysis/palettes/*.json` 色数 + `competitor-analysis/raw/*-chart.html` 竞品标题、描述、定位 +> 日期: 2026-08-14 + +## 色数口径(源自 palettes/ JSON 实测) + +| 品牌 | 系列 | 色数 | 说明 | +|---|---|---|---| +| MARD | 标准 5mm | **221** | `mard-palette.json` 实测 221 色(官方另有 291 全量口径) | +| Artkal | C 系列 2.6mm 迷你豆 | **174** | `palettes/artkal-c.json` | +| Perler | Midi 5mm | **103** | `palettes/perler.json`(官方 SKU 编码) | +| Hama | Midi 5mm | **92** | `palettes/hama.json` | +| IKEA Pyssla | 5mm | **18** | `palettes/ikea-pyssla.json`(含 8 Pastell) | +| Nabbi | Midi 5mm | **30** | `palettes/nabbi.json`(N01–N30) | + +> 竞品口径参考:pixel-beads 色号页为 MARD 291 / Perler 57 / Hama 53 / Artkal-S 159;本表采用我方已落盘色板数据的色数(更全),便于后续接入 T-092 色号表数据展示。 + +--- + +## 1. MARD 拼豆色号表 + +| 项 | 文案 | +|---|---| +| **URL Slug** | `/color-charts/mard-bead-color-chart` | +| **Title (zh)** | MARD 拼豆色号表 221 色全收录|MARD 拼豆色号大全(含 HEX 色值对照) | +| **Title (en)** | MARD Bead Color Chart: 221 Colors | MARD Fuse Bead Color Codes & HEX | +| **Meta Description (zh)** | MARD 拼豆 221 个官方色号完整对照表,色号编码、HEX 色值与 RGB 数值一应俱全,支持 72/168/221 色套装档位换算与跨品牌色差匹配,搭配拼豆图纸生成器选色更准,拼豆玩家配色必备参考。 | +| **Meta Description (en)** | MARD bead color chart: all 221 color codes with HEX & RGB values. Convert 72/168/221 kits, cross-match brands, and pick exact shades in our generator. | + +--- + +## 2. Artkal-C 拼豆色号表 + +| 项 | 文案 | +|---|---| +| **URL Slug** | `/color-charts/artkal-c-bead-color-chart` | +| **Title (zh)** | Artkal C 拼豆色号表 174 色全收录|2.6mm 迷你拼豆色号大全(含 HEX 对照) | +| **Title (en)** | Artkal C Bead Color Chart: 174 Colors | 2.6mm Mini Fuse Bead Color Codes & HEX | +| **Meta Description (zh)** | Artkal C 系列 2.6mm 迷你拼豆 174 色官方色号表,色号编码、HEX 色值、RGB 数值齐全,专为高精度写实作品打造,支持跨品牌换算与图纸生成器一键选色,进阶拼豆玩家必备工具。 | +| **Meta Description (en)** | Artkal C 2.6mm mini bead color chart: 174 colors with HEX & RGB values, built for high-detail projects, cross-brand matching, and one-click palette picking. | + +--- + +## 3. Perler 拼豆色号表 + +| 项 | 文案 | +|---|---| +| **URL Slug** | `/color-charts/perler-bead-color-chart` | +| **Title (zh)** | Perler 拼豆色号表 103 色全收录|Perler Midi 拼豆色号大全(含 SKU/HEX) | +| **Title (en)** | Perler Bead Color Chart: 103 Colors | Perler Midi Fuse Bead Color Codes & SKU | +| **Meta Description (zh)** | Perler Midi 拼豆 103 色官方色号表,官方 SKU 编号、HEX 色值、RGB 数值全量收录,覆盖经典色与荧光色系,支持颜色换算与图纸生成器自动匹配,Perler 玩家查色、配色一站式搞定。 | +| **Meta Description (en)** | Perler midi bead color chart: 103 colors and SKU codes with HEX & RGB values, cross-match other brands, and auto-match colors in our generator. | + +--- + +## 4. Hama 拼豆色号表 + +| 项 | 文案 | +|---|---| +| **URL Slug** | `/color-charts/hama-bead-color-chart` | +| **Title (zh)** | Hama 拼豆色号表 92 色全收录|Hama Midi 拼豆色号大全(含 HEX 对照) | +| **Title (en)** | Hama Bead Color Chart: 92 Colors | Hama Midi Fuse Bead Color Codes & HEX | +| **Meta Description (zh)** | Hama Midi 拼豆 92 色官方色号表,官方色号编码、HEX 色值、RGB 数值全量收录,欧洲经典品牌、教学场景常用,支持跨品牌换算与图纸生成器自动配色,照着摆豆不迷路。 | +| **Meta Description (en)** | Hama midi bead color chart: 92 colors with HEX & RGB values. European classroom favorite, cross-match brands, and auto-pick shades in our generator. | + +--- + +## 5. IKEA Pyssla 拼豆色号表 + +| 项 | 文案 | +|---|---| +| **URL Slug** | `/color-charts/ikea-pyssla-bead-color-chart` | +| **Title (zh)** | 宜家 Pyssla 拼豆色号表 18 色全收录|IKEA 拼豆色号大全(含 Pastell 马卡龙色) | +| **Title (en)** | IKEA Pyssla Bead Color Chart: 18 Colors | Fuse Bead Color Codes & Pastell | +| **Meta Description (zh)** | 宜家 Pyssla 拼豆 18 色色号表(含 8 个 Pastell 马卡龙色),色号与色值对照齐全,IKEA 亲子和儿童入门首选,支持与 MARD、Perler 等品牌换算互替,小色板也能拼出好作品。 | +| **Meta Description (en)** | IKEA Pyssla bead color chart: 18 colors (incl. 8 Pastell) with HEX & RGB values and MARD/Perler equivalents — great for kids' first fuse-bead projects. | + +--- + +## 6. Nabbi 拼豆色号表 + +| 项 | 文案 | +|---|---| +| **URL Slug** | `/color-charts/nabbi-bead-color-chart` | +| **Title (zh)** | Nabbi 拼豆色号表 30 色全收录|Nabbi Midi 拼豆色号大全(N01–N30) | +| **Title (en)** | Nabbi Bead Color Chart: 30 Colors | Nabbi Midi Fuse Bead Color Codes (N01–N30) | +| **Meta Description (zh)** | Nabbi Midi 拼豆 30 色色号表(N01–N30),官方色号编码、HEX 色值、RGB 数值全收录,北欧品质儿童入门品牌,支持与主流品牌换算对照与图纸生成器自动选色,新手配色更省心。 | +| **Meta Description (en)** | Nabbi midi bead color chart: 30 colors (N01–N30) with HEX & RGB values, Nordic quality for kids' projects, cross-brand equivalents, and auto color-matching. | + +--- + +## 附:实施对接说明 + +1. **字数检查**:zh meta description 均落在 100–135 字区间(满足 80–160 要求);en 均 ≤160 字符;zh title ≤30 字、en title ≤70 字符(满足搜索引擎截断窗口)。 +2. **关键词布局**:每条 zh title 含「品牌名 + 色数 + 拼豆色号表」核心关键词(T-096 要求);en title 含 `Bead Color Chart` + 品牌 + 色数,覆盖英文长尾。 +3. **JSON-LD(对接 T-094)**:建议色号表页注入 `WebPage + ItemList` 结构化数据,`itemListElement` 引用 221/174/103/92/18/30 色明细。 +4. **内链(对接 T-095)**:6 个色号表页之间互相内链 + 首页「拼豆色号表」导航入口,锚文本复用 zh title 关键词。 +5. **hreflang 预留**:URL slug 与竞品 `/perler-bead-color-chart` 风格一致,便于后续扩展 en/ja 等语言路由。 diff --git a/docs/SEO-CONTENT-MATRIX.md b/docs/SEO-CONTENT-MATRIX.md new file mode 100644 index 0000000..f96434a --- /dev/null +++ b/docs/SEO-CONTENT-MATRIX.md @@ -0,0 +1,197 @@ +# PERLER LAB · SEO 内容矩阵对标建议(T-122) + +> 任务: T-122 | 产出角色: PM-Agent | 日期: 2026-08-14 +> 数据来源: `competitor-analysis/pixelbeads-analysis.md`(§1.3 站点结构 / §7 差距清单)、`pixelbeads-zh-detail.md`(§1 sitemap 157 URL / §8 Top10)、`docs/I18N-ROI.md`、`docs/LAUNCH.md`(§2 SEO 方案)、`docs/ROADMAP.md`(V1.1/V1.2 排期)、前端路由实测(App.tsx) +> 结论预览: 竞品内容矩阵 = **5 类内容页**(色号表 / FAQ 实操 / 作品详情 / 博客 / 帮助细分),我方色号表 6 页 + FAQ 帮助中心已建(V1.1),**V1.2 建议按 6 条路线补齐作品详情页 → 博客 → 帮助细分页 → 主题合集页 → 作者页 → 品牌主题页**,内容生产节奏为「周更 2 篇 + 月更 1 套」。 + +--- + +## 1. 竞品内容矩阵拆解(pixel-beads.com,157 URL sitemap 实证) + +### 1.1 内容页类型总览 + +竞品全站 157 个 URL 中,**非功能页面(纯内容/SEO 页)占比过半**,是流量主体。类型与 SEO 价值如下: + +| # | 内容页类型 | 路由 | 数量(推断) | SEO 价值 | +|---|---|---|---|---| +| C1 | **品牌色号表页** | `/zh/*-bead-color-chart` | 6 页(MARD/Perler/Hama/Artkal/Pyssla/Nabbi) | ★★★★★ 高转化、低竞争、永久有效 | +| C2 | **FAQ 实操知识** | 首页 FAQ + `/zh/help` | 250+ 问答 | ★★★★☆ 信息型流量 + 精选摘要 | +| C3 | **作品详情页** | `/zh/perler-bead-pattern/-pt_` | 单作品一页,随社区增长 | ★★★★☆ 长尾聚合量大、UGC 飞轮 | +| C4 | **博客/主题合集页** | `/zh/blog`、`/showcase/christmas-*`、`/showcase/pokemon-*` | blog 1 入口 + 主题合集逐期增 | ★★★☆☆ 拉新 + 季节流量 + 内链枢纽 | +| C5 | **帮助细分页** | `/zh/help/perler-bead-art`、`/zh/help/perler-bead-pattern-generator` | 按工具细分 | ★★★☆☆ 工具词精确流量 + 信任 | + +### 1.2 各类别拆解与价值判断 + +**C1 色号表页(我方已对标,V1.1 落地)** +- 模式:每品牌独立一页,标题含「品牌 + 色数 + 色号表」(如「MARD 拼豆色号表 291 色」),页面含色码→HEX 全量映射、套装档位说明。 +- 关键词:`MARD 色号表`、`Perler 色号大全`、`拼豆色号对照表` —— **搜索者已进入拼豆制作流程**,转化意图全场最强;竞争页多为论坛/贴吧旧帖,内容页几乎无正规玩家,竞争度低。 +- 竞品甚至为 zh 站色号页不做 sitemap 维护(§1.2 实测,zh 的 6 个色号页未入 sitemap),说明**这类页流量仍主要靠内链+直接搜索**,维护成本极低。 +- 我方已完成:6 品牌(MARD 221/Artkal-C 174/Perler 103/Hama 92/Pyssla 18/Nabbi 30)SEO 文案(T-096)+ 色号表页路由(T-091~T-093),JSON-LD/内链建议已在 `docs/SEO-COLORCHARTS.md` 中。 + +**C2 FAQ 实操知识(我方已对标,V1.1 落地)** +- 模式:竞品 FAQ 不是客服问答,而是**「选豆/配色/打印/熨烫/裱框」五类实操知识**(首轮爬取确认),熨烫温度 105–115°C、LDPE 材质、爆孔处理等细节,共 250+ 条。 +- 关键词:`拼豆怎么熨`、`拼豆图纸怎么生成`、`拼豆配色技巧` —— 信息型意图,量大、竞争低,且**最容易被 Google/百度精选摘要收录**(问题即标题,答案即正文)。 +- 我方已完成:`/help` 帮助中心(T-106)+ 35 条 FAQ 数据(T-107,竞品实操 24 条 + 我方特有 11 条),zh+en 双语言。 + +**C3 作品详情页(我方缺口,V1.2 建议首批补齐)** +- 模式:每个社区作品一个详情页,URL = `slug + pt_`(拼音 slug,如 `ke-ai-mao-mi-pt_1769798328161`),页面含图纸预览、材料清单、作者署名、一键打开编辑。 +- 关键词:**图案级长尾** `可爱猫咪拼豆图纸`、`线条小狗拼豆图纸`、`宝可梦拼豆图纸`。单页流量小,但**作品数量可无限增长,长尾流量随内容量线性叠加**,且与 Showcase/素材社区天然同构。 +- SEO 佐证:sitemap 中单个作品页即独立 URL;首页精选 6 作品全部链向详情页,形成「展示页 → 详情页」内链网。竞品还在从 `pt_时间戳` 迁移到 `pt_UUID`,说明**作品页是长期资产,URL 一经发布便不轻易变**。 + +**C4 博客/主题合集页(我方缺口,V1.2 建议)** +- 模式:`/blog` 统一入口 + 主题合集页(`/showcase/christmas-perler-bead-patterns` 圣诞、`/showcase/pokemon-champions-perler-bead-patterns` 宝可梦冠军,均 6 语言覆盖)。 +- 关键词:`圣诞拼豆图纸`、`拼豆教程`、`拼豆新手入门` —— 主题合集吃**季节/节日流量**(圣诞/万圣/新年),博客吃教程类信息流量。 +- 价值:①内链枢纽(合集页聚合 N 个作品详情页,集中传递权重)②节日流量周期性爆发 ③UGC 与官方内容双轨(竞品合集为官方策划)。 + +**C5 帮助细分页(我方缺口,低成本补)** +- 模式:`/help/` 下按工具分页(`/help/perler-bead-art`、`/help/perler-bead-pattern-generator`),每页讲透一个工具的使用方法。 +- 关键词:`拼豆图纸生成器怎么用`、`图片转像素画工具` 类工具词。 +- 价值:①精确捕获工具使用意图流量 ②降低客服成本 ③是 FAQ 的自然扩展(FAQ 单页 → 分工具帮助)。 + +### 1.3 竞品矩阵对我们的启示 + +1. **内容页是竞品 250+ 长尾流量页的主力,且多为低维护成本静态页**(色号表、作品页),边际成本几乎为 0。 +2. **色号表与 FAQ 是「打底内容」**,我方 V1.1 已对齐,矩阵地基完成。 +3. **作品详情页是「增量引擎」**,与 V1.2 素材社区天然耦合,应优先做。 +4. **主题合集页是「季节放大器」**,成本低、见效周期可预期(节日前后)。 + +--- + +## 2. 我方 V1.2 内容路线建议(按优先级) + +> 优先级: **P0** = V1.2 内必做 / **P1** = V1.2 顺带 / **P2** = V2.0。 +> 工作量口径: 前端工程师人日(含模板/路由/联调),内容生产另计。 + +### 2.1 已建成(V1.1,无需再投入) + +| 内容页 | 路由 | 状态 | +|---|---|---| +| 色号表 ×6 | `/color-chart/{mard,artkal-c,perler,hama,pyssla,nabbi}` | ✅ 已建(T-091~093/T-096) | +| FAQ 帮助中心 | `/help` | ✅ 已建(T-106/T-107,35 条双语言) | +| 作品展示 | `/showcase` | ✅ 已建(T-097/T-098) | +| 图纸库 | `/library` | ✅ 已建(T-108) | + +### 2.2 建议新增(按优先级排列) + +**P0-1 · 作品详情页 `/pattern/:slug`(对标 C3,最高优先)** + +| 项 | 内容 | +|---|---| +| 目标关键词 | `{作品名}拼豆图纸`、`{作品名}图纸`(图案级长尾,逐作品积累) | +| 页面类型 | 静态内容页(SSR/预渲染优先,SPA 兜底)+ 模板数据页 | +| 内容要素 | 图纸预览图、格数/色数/用豆量、MARD 色号清单、作者署名、一键打开编辑、相关作品推荐(内链) | +| 数据来源 | Showcase/图纸库现有作品数据 + V1.2 素材社区上传(ROADMAP V1.2 项3 图纸页) | +| 工作量 | 前端模板 + slug 生成 + JSON-LD(`ImageObject + ItemList`)约 **2–3 人日** | +| 预期流量价值 | 单页流量小但无限叠加;对标竞品每作品独立 URL 的做法,**内容量 = 流量量**;同时是素材社区的地基 | + +**P0-2 · 博客 `/blog` + 首批 8 篇图文(对标 C4,教程打底)** + +| 项 | 内容 | +|---|---| +| 目标关键词 | `拼豆教程`、`拼豆图纸怎么生成`、`拼豆熨烫温度`、`拼豆新手入门`、`拼豆配色技巧`(信息型) | +| 页面类型 | 图文列表页 + 文章详情页(Markdown 渲染) | +| 首批选题 | ① 拼豆新手入门指南 ② 照片转拼豆图纸全流程 ③ 熨烫温度与爆孔处理(复刻竞品实操知识) ④ 六大品牌色板怎么选 ⑤ MARD 色号体系科普 ⑥ 拼豆图纸怎么打印 ⑦ 亲子拼豆入门 ⑧ 拼豆裱框指南 | +| 工作量 | 博客框架(列表+详情+分页)约 **2–3 人日**;每篇内容生产约 0.5–1 人日(AI 辅助+校对) | +| 预期流量价值 | 信息词大盘流量 + 精选摘要;博客是**唯一可持续周更的内容入口**,长尾复利最高的单点投入 | + +**P0-3 · 主题合集页 `/showcase/{theme}`(对标 C4,季节流量)** + +| 项 | 内容 | +|---|---| +| 目标关键词 | `圣诞拼豆图纸`、`新年拼豆图纸`、`宠物拼豆图纸`(季节+题材词) | +| 页面类型 | 合集模板页(复用作品卡组件,聚合 N 个作品详情页) | +| 首批 2 套 | 圣诞主题(Q4 窗口)、宠物主题(常青,对齐小红书主打内容) | +| 工作量 | 模板复用 Showcase,每套约 **1 人日** | +| 预期流量价值 | 节日前后集中爆发;合集页同时是**内链枢纽**(聚合详情页权重) | + +**P1-4 · 帮助细分页 `/help/:tool`(对标 C5,低成本)** + +| 项 | 内容 | +|---|---| +| 目标关键词 | `拼豆图纸生成器怎么用`、`拼豆色号表怎么看`、`AI 拼豆怎么用`(工具词) | +| 页面类型 | 模板页,复用 HelpPage 组件分工具渲染 | +| 首批 4 页 | `/help/generator`、`/help/color-chart`、`/help/chibi`、`/help/library` | +| 工作量 | 模板 + 文案,约 **1 人日** | +| 预期流量价值 | 精确工具意图 + 提升全站信任度;FAQ 已有内容可直接拆分复用 | + +**P1-5 · 作者页 `/author/:name`(对标竞品 author 路由,素材社区前置)** + +| 项 | 内容 | +|---|---| +| 目标关键词 | `{作者名} 拼豆作品`(个人品牌词,量小) | +| 页面类型 | 模板页,聚合该作者作品详情页 | +| 依赖 | V1.2 素材社区作者标识(ROADMAP V1.2 项3 作者页);当前无账号体系,可先以「作品 ID 聚合」占位 | +| 工作量 | 约 **0.5–1 人日** | +| 预期流量价值 | 个人作者长尾 + 社区创作者激励(作者页是 UGC 投稿的回报) | + +**P2-6 · 品牌主题页 `/perler-bead-art`(对标竞品品牌页)** + +| 项 | 内容 | +|---|---| +| 目标关键词 | `拼豆艺术`、`拼豆作品`(品牌/品类词) | +| 页面类型 | 图文品牌页 | +| 工作量 | 约 **1 人日** | +| 预期流量价值 | 品类词占位;优先级低于上述全部,V2.0 或素材社区成型后再做 | + +### 2.3 路线汇总表 + +| 优先级 | 内容页 | 路由 | 工作量 | 对标 | 目标流量词 | +|---|---|---|---|---|---| +| ✅ 已建 | 色号表 ×6 | `/color-chart/*` | — | C1 | `拼豆色号表`(高转化) | +| ✅ 已建 | FAQ 帮助中心 | `/help` | — | C2 | `拼豆怎么熨`(信息) | +| **P0-1** | 作品详情页 | `/pattern/:slug` | 2–3 人日 | C3 | `{作品}拼豆图纸`(长尾叠加) | +| **P0-2** | 博客 | `/blog` + 8 篇 | 2–3 + 内容 | C4 | `拼豆教程`(信息大盘) | +| **P0-3** | 主题合集页 | `/showcase/{theme}` | 1 人日/套 | C4 | `圣诞拼豆图纸`(季节) | +| P1-4 | 帮助细分页 | `/help/:tool` | 1 人日 | C5 | `生成器怎么用`(工具) | +| P1-5 | 作者页 | `/author/:name` | 0.5–1 人日 | 竞品 author | `{作者}拼豆作品`(个人词) | +| P2-6 | 品牌主题页 | `/perler-bead-art` | 1 人日 | C4 | `拼豆艺术`(品类词) | + +> 落地约束:①P0-1 作品详情页与 V1.2 素材社区(ROADMAP 项3)共享路由/数据结构,**先建模板后接社区数据**;②全部新增页沿用现有 i18n 机制(`useT()` + 消息表),数据层(作品/色号)语言无关;③每页挂 JSON-LD(对齐竞品 6 类 schema:`WebPage`/`ImageObject`/`ItemList`/`HowTo`/`BreadcrumbList`)。 + +--- + +## 3. 内容生产节奏建议 + +### 3.1 周更(每周 2 篇,固定排期) + +| 槽位 | 内容 | 生产方 | 建议日 | +|---|---|---|---| +| 周更 1 | 博客图文 1 篇(教程/技巧/品牌科普轮转) | 运营 + AI 辅助 | 周一 | +| 周更 2 | Showcase/图纸库上新作品 3–5 个(来源:社区投稿 + 运营自制) | 运营 | 周四 | + +- 博客选题池维持 ≥10 篇待写(选题池:新手教程 40% / 品牌科普 25% / 技巧清单 20% / 亲子场景 15%),避免灵感枯竭。 +- 每个上新作品自动生成作品详情页 URL,**「上传即建页」**,不额外占用内容排期。 + +### 3.2 月更(每月 1 套,规划性产出) + +| 内容 | 频率 | 说明 | +|---|---|---| +| 主题合集页 1 套 | 月更 | 优先季节节点(提前 1–2 个月布局):9 月中秋 → 10 月万圣 → 12 月圣诞 → 1 月新年 → 2 月情人节 | +| 色号表页复核 | 月更 | 对齐竞品「2026 修订版」做法:品牌色号若有新版,更新色号页并标注修订日期(修订也是内容更新信号) | +| 帮助细分页迭代 | 月更 | 按客服高频问题(LAUNCH §4 FAQ)反哺新增条目 | + +### 3.3 节奏原则 + +1. **量给长尾、质给转化**:高频更博客/作品(长尾积累),低频精修色号表/帮助(转化与信任)。 +2. **内容优先服务 SEO 关键词表**(LAUNCH §2.1):每篇博客先定目标关键词再写,标题含关键词、正文 800–1500 字、配 1 张成品图。 +3. **内链闭环**:博客 → 主题合集 → 作品详情 → 色号表 → 首页生成器,逐级导流;每篇新内容至少 2 个内链出口。 +4. **与运营渠道联动**:小红书图文 = 博客内容的短视频化素材(LAUNCH §1.4),同一批内容双平台复用,不重复生产。 + +--- + +## 4. 结论 + +| 维度 | 结论 | +|---|---| +| 竞品内容矩阵 | 5 类内容页:色号表 / FAQ 实操 / 作品详情 / 博客与主题合集 / 帮助细分 | +| 我方已对齐 | 色号表 ×6 + FAQ 帮助中心(V1.1) | +| V1.2 建议新增 | **6 条路线**:作品详情页(P0)→ 博客(P0)→ 主题合集(P0)→ 帮助细分(P1)→ 作者页(P1)→ 品牌主题页(P2) | +| 总工作量 | 约 8–10 人日(前端 5–6 + 内容 3–4) | +| 生产节奏 | 周更 2 篇 + 月更 1 套(合集/色号复核/帮助迭代) | +| 内容量预期 | 3 个月后新增 40–50 个作品详情页 + 24 篇博客 + 3 套合集页,对标竞品「内容量 = 流量量」打法 | + +> 本文件为内容矩阵决策依据。P0-1/P0-2/P0-3 建议转排期为 V1.2 工程任务;作品详情页与素材社区(ROADMAP V1.2 项3)需在排期时联调数据结构。 + +--- + +*报告完。证据可复核: `competitor-analysis/pixelbeads-analysis.md` §1.3/§7(站点结构/差距 20+ 项)、`pixelbeads-zh-detail.md` §1/§8(157 URL sitemap/Top10)、`docs/SEO-COLORCHARTS.md`(已建色号页)、`docs/LAUNCH.md` §2(关键词表)、`docs/ROADMAP.md` V1.1/V1.2、`perler-lab/src/App.tsx`(现有路由实测)。* diff --git a/perler-lab-server/Dockerfile b/perler-lab-server/Dockerfile index 0893c14..188e82c 100644 --- a/perler-lab-server/Dockerfile +++ b/perler-lab-server/Dockerfile @@ -47,6 +47,11 @@ COPY --from=build /app/dist ./dist COPY --from=build /app/src ./src COPY --from=build /app/package.json ./package.json +# 色号表 API(/api/color-chart/:brand)数据文件:品牌色板 JSON(模块加载时读取)。 +# 仓库源位于 competitor-analysis/palettes/,部署前同步到 ./palettes/ 一并入镜像。 +# 运行时目录由 docker-compose 环境变量 PALETTES_DIR 指定(默认 /app/palettes)。 +COPY palettes ./palettes + # 创建 SQLite 数据目录(对外挂载 volume) RUN mkdir -p /app/data && \ useradd --create-home --uid 1000 perler && \ diff --git a/perler-lab-server/docker-compose.yml b/perler-lab-server/docker-compose.yml index fa03546..7c13f10 100644 --- a/perler-lab-server/docker-compose.yml +++ b/perler-lab-server/docker-compose.yml @@ -17,6 +17,10 @@ services: environment: # 端口(代码中默认 8788) PORT: "8788" + # 色号表 API 数据目录(/api/color-chart/:brand 读取品牌色板 JSON)。 + # 镜像内路径固定为 /app/palettes(见 Dockerfile `COPY palettes ./palettes`), + # 如需改为卷挂载,可在此改为宿主机映射路径。 + PALETTES_DIR: "/app/palettes" # 可选:NODE_ENV 已在 Dockerfile 中设为 production # 可选:数据库路径可通过 DB_PATH 环境变量覆盖(默认 /app/data/perler-lab.db) # DB_PATH: "/app/data/perler-lab.db" diff --git a/perler-lab-server/palettes/artkal-c.json b/perler-lab-server/palettes/artkal-c.json new file mode 100644 index 0000000..560fe62 --- /dev/null +++ b/perler-lab-server/palettes/artkal-c.json @@ -0,0 +1,1742 @@ +[ + { + "code": "C01", + "hex": "#EAEEF3", + "rgb": [ + 234, + 238, + 243 + ], + "name": "White" + }, + { + "code": "C02", + "hex": "#292A2B", + "rgb": [ + 41, + 42, + 43 + ], + "name": "Black" + }, + { + "code": "C03", + "hex": "#FFA630", + "rgb": [ + 255, + 166, + 48 + ], + "name": "Tangerine" + }, + { + "code": "C04", + "hex": "#E68739", + "rgb": [ + 230, + 135, + 57 + ], + "name": "Yellow Orange" + }, + { + "code": "C05", + "hex": "#CB3531", + "rgb": [ + 203, + 53, + 49 + ], + "name": "Tall Poppy" + }, + { + "code": "C06", + "hex": "#B61927", + "rgb": [ + 182, + 25, + 39 + ], + "name": "Red" + }, + { + "code": "C07", + "hex": "#E182B0", + "rgb": [ + 225, + 130, + 176 + ], + "name": "Carnation Pink" + }, + { + "code": "C08", + "hex": "#DC519A", + "rgb": [ + 220, + 81, + 154 + ], + "name": "Hot Pink" + }, + { + "code": "C09", + "hex": "#DA4383", + "rgb": [ + 218, + 67, + 131 + ], + "name": "Magenta" + }, + { + "code": "C10", + "hex": "#EADE7F", + "rgb": [ + 234, + 222, + 127 + ], + "name": "Picasso" + }, + { + "code": "C11", + "hex": "#EAC125", + "rgb": [ + 234, + 193, + 37 + ], + "name": "Yellow" + }, + { + "code": "C12", + "hex": "#97CF87", + "rgb": [ + 151, + 207, + 135 + ], + "name": "Pistachio" + }, + { + "code": "C13", + "hex": "#8BB23A", + "rgb": [ + 139, + 178, + 58 + ], + "name": "Pastel Green" + }, + { + "code": "C14", + "hex": "#009053", + "rgb": [ + 0, + 144, + 83 + ], + "name": "Green" + }, + { + "code": "C15", + "hex": "#00765F", + "rgb": [ + 0, + 118, + 95 + ], + "name": "Green Tea" + }, + { + "code": "C16", + "hex": "#F96F40", + "rgb": [ + 249, + 111, + 64 + ], + "name": "Bright Carrot" + }, + { + "code": "C17", + "hex": "#EB6027", + "rgb": [ + 235, + 96, + 39 + ], + "name": "Orange" + }, + { + "code": "C18", + "hex": "#A7CDDE", + "rgb": [ + 167, + 205, + 222 + ], + "name": "Sky Blue" + }, + { + "code": "C19", + "hex": "#2EABD8", + "rgb": [ + 46, + 171, + 216 + ], + "name": "Baby Blue" + }, + { + "code": "C20", + "hex": "#0084CE", + "rgb": [ + 0, + 132, + 206 + ], + "name": "Light Blue" + }, + { + "code": "C21", + "hex": "#004FA4", + "rgb": [ + 0, + 79, + 164 + ], + "name": "Dark Blue" + }, + { + "code": "C22", + "hex": "#F2BFB8", + "rgb": [ + 242, + 191, + 184 + ], + "name": "Bubble Gun" + }, + { + "code": "C23", + "hex": "#DCA384", + "rgb": [ + 220, + 163, + 132 + ], + "name": "Sand" + }, + { + "code": "C24", + "hex": "#EED39E", + "rgb": [ + 238, + 211, + 158 + ], + "name": "Beeswax" + }, + { + "code": "C25", + "hex": "#8A7EC2", + "rgb": [ + 138, + 126, + 194 + ], + "name": "Lavender" + }, + { + "code": "C26", + "hex": "#9165B2", + "rgb": [ + 145, + 101, + 178 + ], + "name": "Pastel Lavender" + }, + { + "code": "C27", + "hex": "#48337E", + "rgb": [ + 72, + 51, + 126 + ], + "name": "Purple" + }, + { + "code": "C28", + "hex": "#B27938", + "rgb": [ + 178, + 121, + 56 + ], + "name": "Marigold" + }, + { + "code": "C29", + "hex": "#B35540", + "rgb": [ + 179, + 85, + 64 + ], + "name": "Buccaneer" + }, + { + "code": "C30", + "hex": "#9A4541", + "rgb": [ + 154, + 69, + 65 + ], + "name": "Redwood" + }, + { + "code": "C31", + "hex": "#895D49", + "rgb": [ + 137, + 93, + 73 + ], + "name": "Light Brown" + }, + { + "code": "C32", + "hex": "#65463D", + "rgb": [ + 101, + 70, + 61 + ], + "name": "Brown" + }, + { + "code": "C33", + "hex": "#959698", + "rgb": [ + 149, + 150, + 152 + ], + "name": "Gray" + }, + { + "code": "C34", + "hex": "#70757B", + "rgb": [ + 112, + 117, + 123 + ], + "name": "Dark Gray" + }, + { + "code": "C35", + "hex": "#676B73", + "rgb": [ + 103, + 107, + 115 + ], + "name": "Silver" + }, + { + "code": "C36", + "hex": "#CE6D83", + "rgb": [ + 206, + 109, + 131 + ], + "name": "Old Pink" + }, + { + "code": "C37", + "hex": "#0078BF", + "rgb": [ + 0, + 120, + 191 + ], + "name": "True Blue" + }, + { + "code": "C38", + "hex": "#55A4D9", + "rgb": [ + 85, + 164, + 217 + ], + "name": "Turquoise" + }, + { + "code": "C39", + "hex": "#9EC9CD", + "rgb": [ + 158, + 201, + 205 + ], + "name": "Shadow Green" + }, + { + "code": "C40", + "hex": "#CDC03F", + "rgb": [ + 205, + 192, + 63 + ], + "name": "Key Lomen Pie" + }, + { + "code": "C41", + "hex": "#E1D367", + "rgb": [ + 225, + 211, + 103 + ], + "name": "Pastel Yellow" + }, + { + "code": "C42", + "hex": "#E1C835", + "rgb": [ + 225, + 200, + 53 + ], + "name": "Sandstorm" + }, + { + "code": "C43", + "hex": "#B11836", + "rgb": [ + 177, + 24, + 54 + ], + "name": "Paprika" + }, + { + "code": "C44", + "hex": "#EE927C", + "rgb": [ + 238, + 146, + 124 + ], + "name": "Burning Sand" + }, + { + "code": "C46", + "hex": "#E2E65D", + "rgb": [ + 226, + 230, + 93 + ], + "name": "Canary" + }, + { + "code": "C47", + "hex": "#E9C1A6", + "rgb": [ + 233, + 193, + 166 + ], + "name": "Vanilla" + }, + { + "code": "C48", + "hex": "#ECC03D", + "rgb": [ + 236, + 192, + 61 + ], + "name": "Corn" + }, + { + "code": "C49", + "hex": "#EF67B2", + "rgb": [ + 239, + 103, + 178 + ], + "name": "Raspberry Pink" + }, + { + "code": "C50", + "hex": "#C0B7D7", + "rgb": [ + 192, + 183, + 215 + ], + "name": "Maverick" + }, + { + "code": "C51", + "hex": "#DFDABD", + "rgb": [ + 223, + 218, + 189 + ], + "name": "Spring Sun" + }, + { + "code": "C52", + "hex": "#4F3989", + "rgb": [ + 79, + 57, + 137 + ], + "name": "Butterfly Bush" + }, + { + "code": "C53", + "hex": "#8EC324", + "rgb": [ + 142, + 195, + 36 + ], + "name": "Bright Green" + }, + { + "code": "C54", + "hex": "#00A5A1", + "rgb": [ + 0, + 165, + 161 + ], + "name": "Medium Turquoise" + }, + { + "code": "C56", + "hex": "#82878B", + "rgb": [ + 130, + 135, + 139 + ], + "name": "Oslo Gray" + }, + { + "code": "C58", + "hex": "#36384D", + "rgb": [ + 54, + 56, + 77 + ], + "name": "Black Rock" + }, + { + "code": "C60", + "hex": "#B2D7CE", + "rgb": [ + 178, + 215, + 206 + ], + "name": "Sea Mist" + }, + { + "code": "C69", + "hex": "#383E44", + "rgb": [ + 56, + 62, + 68 + ], + "name": "Mine Shaft" + }, + { + "code": "C70", + "hex": "#153838", + "rgb": [ + 21, + 56, + 56 + ], + "name": "Brunswick Green" + }, + { + "code": "C71", + "hex": "#E8AE00", + "rgb": [ + 232, + 174, + 0 + ], + "name": "Goldenrod" + }, + { + "code": "C72", + "hex": "#D9B35E", + "rgb": [ + 217, + 179, + 94 + ], + "name": "Pastel Orange" + }, + { + "code": "C73", + "hex": "#BB6833", + "rgb": [ + 187, + 104, + 51 + ], + "name": "Sienna" + }, + { + "code": "C74", + "hex": "#CDB277", + "rgb": [ + 205, + 178, + 119 + ], + "name": "Deer" + }, + { + "code": "C75", + "hex": "#AA744E", + "rgb": [ + 170, + 116, + 78 + ], + "name": "Clay" + }, + { + "code": "C76", + "hex": "#EC625E", + "rgb": [ + 236, + 98, + 94 + ], + "name": "Coral Red" + }, + { + "code": "C77", + "hex": "#BE5D65", + "rgb": [ + 190, + 93, + 101 + ], + "name": "Deep Chestnut" + }, + { + "code": "C78", + "hex": "#99323A", + "rgb": [ + 153, + 50, + 58 + ], + "name": "Red Wine" + }, + { + "code": "C79", + "hex": "#68C4D2", + "rgb": [ + 104, + 196, + 210 + ], + "name": "Light Sea Blue" + }, + { + "code": "C80", + "hex": "#0093A9", + "rgb": [ + 0, + 147, + 169 + ], + "name": "Sea Blue" + }, + { + "code": "C81", + "hex": "#5AB0BF", + "rgb": [ + 90, + 176, + 191 + ], + "name": "Steel Blue" + }, + { + "code": "C82", + "hex": "#009EC2", + "rgb": [ + 0, + 158, + 194 + ], + "name": "Azure" + }, + { + "code": "C83", + "hex": "#0084B2", + "rgb": [ + 0, + 132, + 178 + ], + "name": "Dark Steel Blue" + }, + { + "code": "C84", + "hex": "#ADAD29", + "rgb": [ + 173, + 173, + 41 + ], + "name": "Drark Algae" + }, + { + "code": "C85", + "hex": "#8F8E3C", + "rgb": [ + 143, + 142, + 60 + ], + "name": "Dark Olive" + }, + { + "code": "C86", + "hex": "#007D2B", + "rgb": [ + 0, + 125, + 43 + ], + "name": "Jade Green" + }, + { + "code": "C87", + "hex": "#D4D8D3", + "rgb": [ + 212, + 216, + 211 + ], + "name": "Ghost While" + }, + { + "code": "C88", + "hex": "#C2C4C2", + "rgb": [ + 194, + 196, + 194 + ], + "name": "Ash Grey" + }, + { + "code": "C89", + "hex": "#A7ACAD", + "rgb": [ + 167, + 172, + 173 + ], + "name": "Light Gray" + }, + { + "code": "C90", + "hex": "#565A5E", + "rgb": [ + 86, + 90, + 94 + ], + "name": "Charcoal Gray" + }, + { + "code": "C91", + "hex": "#CEA433", + "rgb": [ + 206, + 164, + 51 + ], + "name": "Dandelion" + }, + { + "code": "C92", + "hex": "#DCB794", + "rgb": [ + 220, + 183, + 148 + ], + "name": "Pale Skin" + }, + { + "code": "C93", + "hex": "#DD9285", + "rgb": [ + 221, + 146, + 133 + ], + "name": "Warm Blush" + }, + { + "code": "C94", + "hex": "#E07B69", + "rgb": [ + 224, + 123, + 105 + ], + "name": "Salmon" + }, + { + "code": "C95", + "hex": "#EF7F61", + "rgb": [ + 239, + 127, + 97 + ], + "name": "Apricot" + }, + { + "code": "C96", + "hex": "#DC772B", + "rgb": [ + 220, + 119, + 43 + ], + "name": "Papaya" + }, + { + "code": "C97", + "hex": "#6AAEDB", + "rgb": [ + 106, + 174, + 219 + ], + "name": "Himalaya Blue" + }, + { + "code": "C98", + "hex": "#61BBD3", + "rgb": [ + 97, + 187, + 211 + ], + "name": "Waterfall" + }, + { + "code": "C99", + "hex": "#279BBE", + "rgb": [ + 39, + 155, + 190 + ], + "name": "Lagoon" + }, + { + "code": "C100", + "hex": "#00A7E3", + "rgb": [ + 0, + 167, + 227 + ], + "name": "Electric Blue" + }, + { + "code": "C101", + "hex": "#0077CA", + "rgb": [ + 0, + 119, + 202 + ], + "name": "Pool Blue" + }, + { + "code": "C102", + "hex": "#005AA9", + "rgb": [ + 0, + 90, + 169 + ], + "name": "Caribbian Blue" + }, + { + "code": "C103", + "hex": "#007F9E", + "rgb": [ + 0, + 127, + 158 + ], + "name": "Deep Water" + }, + { + "code": "C104", + "hex": "#007D91", + "rgb": [ + 0, + 125, + 145 + ], + "name": "Petrol Blue" + }, + { + "code": "C105", + "hex": "#00649A", + "rgb": [ + 0, + 100, + 154 + ], + "name": "Wegdewood Blue" + }, + { + "code": "C106", + "hex": "#006C9F", + "rgb": [ + 0, + 108, + 159 + ], + "name": "Pond Blue" + }, + { + "code": "C107", + "hex": "#CFC179", + "rgb": [ + 207, + 193, + 121 + ], + "name": "Seashell Beige" + }, + { + "code": "C108", + "hex": "#C4AE64", + "rgb": [ + 196, + 174, + 100 + ], + "name": "Beige" + }, + { + "code": "C109", + "hex": "#AB9745", + "rgb": [ + 171, + 151, + 69 + ], + "name": "Beach Beige" + }, + { + "code": "C110", + "hex": "#978138", + "rgb": [ + 151, + 129, + 56 + ], + "name": "Caffe Latté" + }, + { + "code": "C111", + "hex": "#907C41", + "rgb": [ + 144, + 124, + 65 + ], + "name": "Oaktree Brown" + }, + { + "code": "C112", + "hex": "#B6AE84", + "rgb": [ + 182, + 174, + 132 + ], + "name": "Khaki" + }, + { + "code": "C113", + "hex": "#A59F65", + "rgb": [ + 165, + 159, + 101 + ], + "name": "Light Greengray" + }, + { + "code": "C114", + "hex": "#938D54", + "rgb": [ + 147, + 141, + 84 + ], + "name": "Mossy Green" + }, + { + "code": "C115", + "hex": "#8D8B51", + "rgb": [ + 141, + 139, + 81 + ], + "name": "Earth Green" + }, + { + "code": "C116", + "hex": "#7F7E49", + "rgb": [ + 127, + 126, + 73 + ], + "name": "Sage Green" + }, + { + "code": "C117", + "hex": "#5B6E35", + "rgb": [ + 91, + 110, + 53 + ], + "name": "Pinetree Green" + }, + { + "code": "C118", + "hex": "#8AD5C9", + "rgb": [ + 138, + 213, + 201 + ], + "name": "Frosty Blue" + }, + { + "code": "C119", + "hex": "#7CD2A5", + "rgb": [ + 124, + 210, + 165 + ], + "name": "Polar Mint" + }, + { + "code": "C120", + "hex": "#72AC9A", + "rgb": [ + 114, + 172, + 154 + ], + "name": "Celadon Green" + }, + { + "code": "C121", + "hex": "#00B26F", + "rgb": [ + 0, + 178, + 111 + ], + "name": "Eucalyptus" + }, + { + "code": "C122", + "hex": "#3EB724", + "rgb": [ + 62, + 183, + 36 + ], + "name": "Clover Field" + }, + { + "code": "C123", + "hex": "#0D7535", + "rgb": [ + 13, + 117, + 53 + ], + "name": "Pooltable Felt" + }, + { + "code": "C124", + "hex": "#007D6E", + "rgb": [ + 0, + 125, + 110 + ], + "name": "Snake Green" + }, + { + "code": "C125", + "hex": "#006E69", + "rgb": [ + 0, + 110, + 105 + ], + "name": "Dark Eucalyptus" + }, + { + "code": "C126", + "hex": "#DFC3E1", + "rgb": [ + 223, + 195, + 225 + ], + "name": "Marsmallow Rose" + }, + { + "code": "C127", + "hex": "#D38ED4", + "rgb": [ + 211, + 142, + 212 + ], + "name": "Light Grape" + }, + { + "code": "C128", + "hex": "#D5A6BA", + "rgb": [ + 213, + 166, + 186 + ], + "name": "Rosebud Pink" + }, + { + "code": "C129", + "hex": "#D6668E", + "rgb": [ + 214, + 102, + 142 + ], + "name": "Fuschia" + }, + { + "code": "C130", + "hex": "#B8AAD9", + "rgb": [ + 184, + 170, + 217 + ], + "name": "Candy Violet" + }, + { + "code": "C131", + "hex": "#DF486D", + "rgb": [ + 223, + 72, + 109 + ], + "name": "Flamingo" + }, + { + "code": "C132", + "hex": "#BC3CA6", + "rgb": [ + 188, + 60, + 166 + ], + "name": "Pink Plum" + }, + { + "code": "C133", + "hex": "#803897", + "rgb": [ + 128, + 56, + 151 + ], + "name": "Amethyst" + }, + { + "code": "C134", + "hex": "#A7BAE1", + "rgb": [ + 167, + 186, + 225 + ], + "name": "Moonlight Blue" + }, + { + "code": "C135", + "hex": "#AFB8DF", + "rgb": [ + 175, + 184, + 223 + ], + "name": "Summer Rain" + }, + { + "code": "C136", + "hex": "#6B9AD4", + "rgb": [ + 107, + 154, + 212 + ], + "name": "Azur Blue" + }, + { + "code": "C137", + "hex": "#5A89CE", + "rgb": [ + 90, + 137, + 206 + ], + "name": "Cornflower Blue" + }, + { + "code": "C138", + "hex": "#658AD0", + "rgb": [ + 101, + 138, + 208 + ], + "name": "Forget Me Not" + }, + { + "code": "C139", + "hex": "#566CBD", + "rgb": [ + 86, + 108, + 189 + ], + "name": "Indigo" + }, + { + "code": "C140", + "hex": "#4D74C6", + "rgb": [ + 77, + 116, + 198 + ], + "name": "Horizon Blue" + }, + { + "code": "C141", + "hex": "#416DBE", + "rgb": [ + 65, + 109, + 190 + ], + "name": "Cobolt" + }, + { + "code": "C142", + "hex": "#30429E", + "rgb": [ + 48, + 66, + 158 + ], + "name": "Royal Blue" + }, + { + "code": "C143", + "hex": "#024288", + "rgb": [ + 2, + 66, + 136 + ], + "name": "Marine" + }, + { + "code": "C144", + "hex": "#D6CA6A", + "rgb": [ + 214, + 202, + 106 + ], + "name": "Pale Yellow Moss" + }, + { + "code": "C145", + "hex": "#9D1A38", + "rgb": [ + 157, + 26, + 56 + ], + "name": "Bloodrose Red" + }, + { + "code": "C146", + "hex": "#80B7A1", + "rgb": [ + 128, + 183, + 161 + ], + "name": "Spearmint" + }, + { + "code": "C147", + "hex": "#7A594F", + "rgb": [ + 122, + 89, + 79 + ], + "name": "Mocha" + }, + { + "code": "C148", + "hex": "#EFDBA1", + "rgb": [ + 239, + 219, + 161 + ], + "name": "Creme" + }, + { + "code": "C149", + "hex": "#8884D0", + "rgb": [ + 136, + 132, + 208 + ], + "name": "Iris Violet" + }, + { + "code": "C150", + "hex": "#345621", + "rgb": [ + 52, + 86, + 33 + ], + "name": "Forrest Green" + }, + { + "code": "C151", + "hex": "#AEADDC", + "rgb": [ + 174, + 173, + 220 + ], + "name": "Lilac" + }, + { + "code": "C152", + "hex": "#BCC3E1", + "rgb": [ + 188, + 195, + 225 + ], + "name": "Pale Lilac" + }, + { + "code": "C153", + "hex": "#E3C09A", + "rgb": [ + 227, + 192, + 154 + ], + "name": "Sahara Sand" + }, + { + "code": "C154", + "hex": "#C58B60", + "rgb": [ + 197, + 139, + 96 + ], + "name": "Sunkissed Teint" + }, + { + "code": "C155", + "hex": "#5A5F65", + "rgb": [ + 90, + 95, + 101 + ], + "name": "Steel Grey" + }, + { + "code": "C156", + "hex": "#4C5156", + "rgb": [ + 76, + 81, + 86 + ], + "name": "Iron Grey" + }, + { + "code": "C157", + "hex": "#3A3E42", + "rgb": [ + 58, + 62, + 66 + ], + "name": "Pepper" + }, + { + "code": "C45", + "hex": "#5DDB5D", + "rgb": [ + 93, + 219, + 93 + ], + "name": "Spring Green" + }, + { + "code": "C55", + "hex": "#6CC24A", + "rgb": [ + 108, + 194, + 74 + ], + "name": "Conifer" + }, + { + "code": "C57", + "hex": "#BC0423", + "rgb": [ + 188, + 4, + 35 + ], + "name": "Fresh Red" + }, + { + "code": "C59", + "hex": "#531A23", + "rgb": [ + 83, + 26, + 35 + ], + "name": "Scarlett" + }, + { + "code": "C61", + "hex": "#F1EB9C", + "rgb": [ + 241, + 235, + 156 + ], + "name": "Feta" + }, + { + "code": "C62", + "hex": "#FC3F3F", + "rgb": [ + 252, + 63, + 63 + ], + "name": "Carnation" + }, + { + "code": "C63", + "hex": "#EABEDB", + "rgb": [ + 234, + 190, + 219 + ], + "name": "Pink Pearl" + }, + { + "code": "C64", + "hex": "#A50050", + "rgb": [ + 165, + 0, + 80 + ], + "name": "Rose" + }, + { + "code": "C65", + "hex": "#EF7E2E", + "rgb": [ + 239, + 126, + 46 + ], + "name": "Mango" + }, + { + "code": "C66", + "hex": "#FC6C85", + "rgb": [ + 252, + 108, + 133 + ], + "name": "Wild Watermelon" + }, + { + "code": "C67", + "hex": "#B14EB5", + "rgb": [ + 177, + 78, + 181 + ], + "name": "Orchid" + }, + { + "code": "C68", + "hex": "#69C2EE", + "rgb": [ + 105, + 194, + 238 + ], + "name": "Toothpaste Blue" + }, + { + "code": "CE01", + "hex": "#C3CED6", + "rgb": [ + 195, + 206, + 214 + ], + "name": "Columbia Blue" + }, + { + "code": "CE02", + "hex": "#9AB2DB", + "rgb": [ + 154, + 178, + 219 + ], + "name": "Pale Cerulean" + }, + { + "code": "CE03", + "hex": "#5D88B2", + "rgb": [ + 93, + 136, + 178 + ], + "name": "Silver Lake Blue" + }, + { + "code": "CE04", + "hex": "#02BDD1", + "rgb": [ + 2, + 189, + 209 + ], + "name": "Sky Blue (Crayola)" + }, + { + "code": "CE05", + "hex": "#52CAAC", + "rgb": [ + 82, + 202, + 172 + ], + "name": "Maximum Blue Green" + }, + { + "code": "CE06", + "hex": "#2D6DB2", + "rgb": [ + 45, + 109, + 178 + ], + "name": "Bright Navy Blue" + }, + { + "code": "CE07", + "hex": "#C2A3B7", + "rgb": [ + 194, + 163, + 183 + ], + "name": "Black Shadows" + }, + { + "code": "CE08", + "hex": "#8A5877", + "rgb": [ + 138, + 88, + 119 + ], + "name": "Mountbatten Pink" + }, + { + "code": "CE09", + "hex": "#68355D", + "rgb": [ + 104, + 53, + 93 + ], + "name": "Halayà Úbe" + }, + { + "code": "CE10", + "hex": "#B84FA8", + "rgb": [ + 184, + 79, + 168 + ], + "name": "Deep Mauve" + }, + { + "code": "CE11", + "hex": "#B02FA4", + "rgb": [ + 176, + 47, + 164 + ], + "name": "Heliotrope Magenta" + }, + { + "code": "CE12", + "hex": "#E2A365", + "rgb": [ + 226, + 163, + 101 + ], + "name": "Rajah" + }, + { + "code": "CE13", + "hex": "#BE8E59", + "rgb": [ + 190, + 142, + 89 + ], + "name": "Earth Yellow" + }, + { + "code": "CE14", + "hex": "#A87443", + "rgb": [ + 168, + 116, + 67 + ], + "name": "Chinese Bronze" + }, + { + "code": "CE15", + "hex": "#A06E52", + "rgb": [ + 160, + 110, + 82 + ], + "name": "Alloy Orange" + }, + { + "code": "CE16", + "hex": "#F9C1D7", + "rgb": [ + 249, + 193, + 215 + ], + "name": "Orchid Pink" + }, + { + "code": "CE17", + "hex": "#59292B", + "rgb": [ + 89, + 41, + 43 + ], + "name": "Caput Mortuum" + } +] diff --git a/perler-lab-server/palettes/hama.json b/perler-lab-server/palettes/hama.json new file mode 100644 index 0000000..19b1b57 --- /dev/null +++ b/perler-lab-server/palettes/hama.json @@ -0,0 +1,922 @@ +[ + { + "code": "H01", + "hex": "#E5ECF1", + "rgb": [ + 229, + 236, + 241 + ], + "name": "White" + }, + { + "code": "H02", + "hex": "#E4E4C5", + "rgb": [ + 228, + 228, + 197 + ], + "name": "Cream" + }, + { + "code": "H03", + "hex": "#E9C704", + "rgb": [ + 233, + 199, + 4 + ], + "name": "Yellow" + }, + { + "code": "H04", + "hex": "#D14803", + "rgb": [ + 209, + 72, + 3 + ], + "name": "Orange" + }, + { + "code": "H05", + "hex": "#B4060E", + "rgb": [ + 180, + 6, + 14 + ], + "name": "Red" + }, + { + "code": "H06", + "hex": "#EA8AA5", + "rgb": [ + 234, + 138, + 165 + ], + "name": "Pink" + }, + { + "code": "H07", + "hex": "#712297", + "rgb": [ + 113, + 34, + 151 + ], + "name": "Purple" + }, + { + "code": "H08", + "hex": "#0239A3", + "rgb": [ + 2, + 57, + 163 + ], + "name": "Blue" + }, + { + "code": "H09", + "hex": "#025BC3", + "rgb": [ + 2, + 91, + 195 + ], + "name": "Light Blue" + }, + { + "code": "H10", + "hex": "#027643", + "rgb": [ + 2, + 118, + 67 + ], + "name": "Green" + }, + { + "code": "H11", + "hex": "#19CDA7", + "rgb": [ + 25, + 205, + 167 + ], + "name": "Light Green" + }, + { + "code": "H12", + "hex": "#3E271A", + "rgb": [ + 62, + 39, + 26 + ], + "name": "Brown" + }, + { + "code": "H13", + "hex": "#C02435", + "rgb": [ + 192, + 36, + 53 + ], + "name": "Transparent Red" + }, + { + "code": "H14", + "hex": "#E4AA32", + "rgb": [ + 228, + 170, + 50 + ], + "name": "Transparent Yellow" + }, + { + "code": "H16", + "hex": "#37B876", + "rgb": [ + 55, + 184, + 118 + ], + "name": "Transparent Green" + }, + { + "code": "H17", + "hex": "#838F98", + "rgb": [ + 131, + 143, + 152 + ], + "name": "Grey" + }, + { + "code": "H18", + "hex": "#141315", + "rgb": [ + 20, + 19, + 21 + ], + "name": "Black" + }, + { + "code": "H19", + "hex": "#D8D2CE", + "rgb": [ + 216, + 210, + 206 + ], + "name": "Clear" + }, + { + "code": "H20", + "hex": "#8D2A0F", + "rgb": [ + 141, + 42, + 15 + ], + "name": "Reddish Brown" + }, + { + "code": "H21", + "hex": "#BE6C21", + "rgb": [ + 190, + 108, + 33 + ], + "name": "Light Brown" + }, + { + "code": "H22", + "hex": "#91020A", + "rgb": [ + 145, + 2, + 10 + ], + "name": "Dark Red" + }, + { + "code": "H24", + "hex": "#683E9A", + "rgb": [ + 104, + 62, + 154 + ], + "name": "Translucent Purple" + }, + { + "code": "H25", + "hex": "#87593D", + "rgb": [ + 135, + 89, + 61 + ], + "name": "Translucent Brown" + }, + { + "code": "H26", + "hex": "#E8A498", + "rgb": [ + 232, + 164, + 152 + ], + "name": "Matt Rose" + }, + { + "code": "H27", + "hex": "#DCB18E", + "rgb": [ + 220, + 177, + 142 + ], + "name": "Beige" + }, + { + "code": "H28", + "hex": "#1E2C1C", + "rgb": [ + 30, + 44, + 28 + ], + "name": "Dark Green" + }, + { + "code": "H29", + "hex": "#BF0142", + "rgb": [ + 191, + 1, + 66 + ], + "name": "Claret" + }, + { + "code": "H30", + "hex": "#4E0C1B", + "rgb": [ + 78, + 12, + 27 + ], + "name": "Burgundy" + }, + { + "code": "H31", + "hex": "#489AB9", + "rgb": [ + 72, + 154, + 185 + ], + "name": "Turquoise" + }, + { + "code": "H32", + "hex": "#FF208D", + "rgb": [ + 255, + 32, + 141 + ], + "name": "Neon Fuchsia" + }, + { + "code": "H33", + "hex": "#FF3956", + "rgb": [ + 255, + 57, + 86 + ], + "name": "Cerise" + }, + { + "code": "H34", + "hex": "#E5EF13", + "rgb": [ + 229, + 239, + 19 + ], + "name": "Neon Yellow" + }, + { + "code": "H35", + "hex": "#FF2833", + "rgb": [ + 255, + 40, + 51 + ], + "name": "Neon Red" + }, + { + "code": "H36", + "hex": "#2353B0", + "rgb": [ + 35, + 83, + 176 + ], + "name": "Neon Blue" + }, + { + "code": "H37", + "hex": "#06B73C", + "rgb": [ + 6, + 183, + 60 + ], + "name": "Neon Green" + }, + { + "code": "H38", + "hex": "#FD8600", + "rgb": [ + 253, + 134, + 0 + ], + "name": "Neon Orange" + }, + { + "code": "H39", + "hex": "#F1F21C", + "rgb": [ + 241, + 242, + 28 + ], + "name": "Fluorescent Yellow" + }, + { + "code": "H40", + "hex": "#FE630B", + "rgb": [ + 254, + 99, + 11 + ], + "name": "Fluorescent Orange" + }, + { + "code": "H41", + "hex": "#2659B2", + "rgb": [ + 38, + 89, + 178 + ], + "name": "Fluorescent Blue" + }, + { + "code": "H42", + "hex": "#0CBD51", + "rgb": [ + 12, + 189, + 81 + ], + "name": "Fluorescent Green" + }, + { + "code": "H43", + "hex": "#E7E45A", + "rgb": [ + 231, + 228, + 90 + ], + "name": "Pastel Yellow" + }, + { + "code": "H44", + "hex": "#F96160", + "rgb": [ + 249, + 97, + 96 + ], + "name": "Pastel Red" + }, + { + "code": "H45", + "hex": "#8E69CD", + "rgb": [ + 142, + 105, + 205 + ], + "name": "Pastel Purple" + }, + { + "code": "H46", + "hex": "#51AEE4", + "rgb": [ + 81, + 174, + 228 + ], + "name": "Pastel Blue" + }, + { + "code": "H47", + "hex": "#80DF96", + "rgb": [ + 128, + 223, + 150 + ], + "name": "Pastel Green" + }, + { + "code": "H48", + "hex": "#D67AD1", + "rgb": [ + 214, + 122, + 209 + ], + "name": "Pastel Pink" + }, + { + "code": "H49", + "hex": "#0FACD1", + "rgb": [ + 15, + 172, + 209 + ], + "name": "Azure" + }, + { + "code": "H60", + "hex": "#F0981E", + "rgb": [ + 240, + 152, + 30 + ], + "name": "Teddybear Brown" + }, + { + "code": "H70", + "hex": "#A5B3C0", + "rgb": [ + 165, + 179, + 192 + ], + "name": "Light Grey" + }, + { + "code": "H71", + "hex": "#445059", + "rgb": [ + 68, + 80, + 89 + ], + "name": "Dark Grey" + }, + { + "code": "H75", + "hex": "#B78C6D", + "rgb": [ + 183, + 140, + 109 + ], + "name": "Tan" + }, + { + "code": "H76", + "hex": "#8A5937", + "rgb": [ + 138, + 89, + 55 + ], + "name": "Nougat" + }, + { + "code": "H77", + "hex": "#CED1C8", + "rgb": [ + 206, + 209, + 200 + ], + "name": "Cloudy White" + }, + { + "code": "H78", + "hex": "#F7C1AA", + "rgb": [ + 247, + 193, + 170 + ], + "name": "Light Peach" + }, + { + "code": "H79", + "hex": "#F87633", + "rgb": [ + 248, + 118, + 51 + ], + "name": "Apricot" + }, + { + "code": "H82", + "hex": "#91175A", + "rgb": [ + 145, + 23, + 90 + ], + "name": "Plum" + }, + { + "code": "H83", + "hex": "#037A9F", + "rgb": [ + 3, + 122, + 159 + ], + "name": "Petrol Blue" + }, + { + "code": "H84", + "hex": "#687836", + "rgb": [ + 104, + 120, + 54 + ], + "name": "Olive Green" + }, + { + "code": "H95", + "hex": "#DD9BA3", + "rgb": [ + 221, + 155, + 163 + ], + "name": "Pastel Rose" + }, + { + "code": "H96", + "hex": "#B491AD", + "rgb": [ + 180, + 145, + 173 + ], + "name": "Pastel Lilac" + }, + { + "code": "H97", + "hex": "#8AAFC2", + "rgb": [ + 138, + 175, + 194 + ], + "name": "Pastel Ice Blue" + }, + { + "code": "H98", + "hex": "#94CCA4", + "rgb": [ + 148, + 204, + 164 + ], + "name": "Pastel Mint" + }, + { + "code": "H15", + "hex": "#487ED5", + "rgb": [ + 72, + 126, + 213 + ], + "name": "Transparent Blue" + }, + { + "code": "H55", + "hex": "#FAF8ED", + "rgb": [ + 250, + 248, + 237 + ], + "name": "Green (Glow in the Dark)" + }, + { + "code": "H56", + "hex": "#EDBF9F", + "rgb": [ + 237, + 191, + 159 + ], + "name": "Red (Glow in the Dark)" + }, + { + "code": "H57", + "hex": "#C4D0E3", + "rgb": [ + 196, + 208, + 227 + ], + "name": "Blue (Glow in the Dark)" + }, + { + "code": "H61", + "hex": "#D99350", + "rgb": [ + 217, + 147, + 80 + ], + "name": "Gold" + }, + { + "code": "H62", + "hex": "#48474A", + "rgb": [ + 72, + 71, + 74 + ], + "name": "Silver" + }, + { + "code": "H63", + "hex": "#42312F", + "rgb": [ + 66, + 49, + 47 + ], + "name": "Bronze" + }, + { + "code": "H64", + "hex": "#EFEBE4", + "rgb": [ + 239, + 235, + 228 + ], + "name": "Pearl" + }, + { + "code": "H72", + "hex": "#F097B0", + "rgb": [ + 240, + 151, + 176 + ], + "name": "Translucent Pink" + }, + { + "code": "H73", + "hex": "#59AEF5", + "rgb": [ + 89, + 174, + 245 + ], + "name": "Translucent Aqua" + }, + { + "code": "H74", + "hex": "#5B55BD", + "rgb": [ + 91, + 85, + 189 + ], + "name": "Translucent Lilac" + }, + { + "code": "H101", + "hex": "#A9C39B", + "rgb": [ + 169, + 195, + 155 + ], + "name": "Eucalyptus" + }, + { + "code": "H102", + "hex": "#356B2D", + "rgb": [ + 53, + 107, + 45 + ], + "name": "Forest Green" + }, + { + "code": "H103", + "hex": "#FFE660", + "rgb": [ + 255, + 230, + 96 + ], + "name": "Light Yellow" + }, + { + "code": "H104", + "hex": "#BCD122", + "rgb": [ + 188, + 209, + 34 + ], + "name": "Lime" + }, + { + "code": "H105", + "hex": "#FFAC78", + "rgb": [ + 255, + 172, + 120 + ], + "name": "Light Apricot" + }, + { + "code": "H106", + "hex": "#CCC5ED", + "rgb": [ + 204, + 197, + 237 + ], + "name": "Light Lavender" + }, + { + "code": "H107", + "hex": "#6A87C1", + "rgb": [ + 106, + 135, + 193 + ], + "name": "Lavender" + }, + { + "code": "H108", + "hex": "#2A2536", + "rgb": [ + 42, + 37, + 54 + ], + "name": "Aubergine" + }, + { + "code": "H109", + "hex": "#8A847F", + "rgb": [ + 138, + 132, + 127 + ], + "name": "Cloudy Grey" + }, + { + "code": "H110", + "hex": "#838956", + "rgb": [ + 131, + 137, + 86 + ], + "name": "Matcha" + }, + { + "code": "H111", + "hex": "#835854", + "rgb": [ + 131, + 88, + 84 + ], + "name": "Dark Blush" + }, + { + "code": "H112", + "hex": "#AD8A82", + "rgb": [ + 173, + 138, + 130 + ], + "name": "Blush" + }, + { + "code": "H113", + "hex": "#5F887B", + "rgb": [ + 95, + 136, + 123 + ], + "name": "Aqua" + }, + { + "code": "H114", + "hex": "#9A2C31", + "rgb": [ + 154, + 44, + 49 + ], + "name": "Cherry Red" + }, + { + "code": "H115", + "hex": "#6E975F", + "rgb": [ + 110, + 151, + 95 + ], + "name": "Bright Green" + }, + { + "code": "H116", + "hex": "#222838", + "rgb": [ + 34, + 40, + 56 + ], + "name": "Midnight Blue" + }, + { + "code": "H117", + "hex": "#777169", + "rgb": [ + 119, + 113, + 105 + ], + "name": "Taupe Grey" + }, + { + "code": "H118", + "hex": "#612932", + "rgb": [ + 97, + 41, + 50 + ], + "name": "Maroon Red" + }, + { + "code": "H119", + "hex": "#4167B4", + "rgb": [ + 65, + 103, + 180 + ], + "name": "Sky Blue" + } +] diff --git a/perler-lab-server/palettes/ikea-pyssla.json b/perler-lab-server/palettes/ikea-pyssla.json new file mode 100644 index 0000000..fc54ff2 --- /dev/null +++ b/perler-lab-server/palettes/ikea-pyssla.json @@ -0,0 +1,182 @@ +[ + { + "code": "Black", + "hex": "#000000", + "rgb": [ + 0, + 0, + 0 + ], + "name": "Black" + }, + { + "code": "Blue", + "hex": "#0657D8", + "rgb": [ + 6, + 87, + 216 + ], + "name": "Blue" + }, + { + "code": "Green", + "hex": "#1FAA03", + "rgb": [ + 31, + 170, + 3 + ], + "name": "Green" + }, + { + "code": "Brown", + "hex": "#3A0909", + "rgb": [ + 58, + 9, + 9 + ], + "name": "Brown" + }, + { + "code": "Blue (Pastell)", + "hex": "#93D3E2", + "rgb": [ + 147, + 211, + 226 + ], + "name": "Blue (Pastell)" + }, + { + "code": "Grey (Pastell)", + "hex": "#9E9C9D", + "rgb": [ + 158, + 156, + 157 + ], + "name": "Grey (Pastell)" + }, + { + "code": "Green (Pastell)", + "hex": "#ACBF33", + "rgb": [ + 172, + 191, + 51 + ], + "name": "Green (Pastell)" + }, + { + "code": "Purple", + "hex": "#BE88EA", + "rgb": [ + 190, + 136, + 234 + ], + "name": "Purple" + }, + { + "code": "Purple (Pastell)", + "hex": "#C5B7DA", + "rgb": [ + 197, + 183, + 218 + ], + "name": "Purple (Pastell)" + }, + { + "code": "Red", + "hex": "#D80606", + "rgb": [ + 216, + 6, + 6 + ], + "name": "Red" + }, + { + "code": "Sand (Pastell)", + "hex": "#E0BEA8", + "rgb": [ + 224, + 190, + 168 + ], + "name": "Sand (Pastell)" + }, + { + "code": "Orange (Pastell)", + "hex": "#EDA250", + "rgb": [ + 237, + 162, + 80 + ], + "name": "Orange (Pastell)" + }, + { + "code": "Orange", + "hex": "#F2741A", + "rgb": [ + 242, + 116, + 26 + ], + "name": "Orange" + }, + { + "code": "Pink (Pastell)", + "hex": "#F2BFD2", + "rgb": [ + 242, + 191, + 210 + ], + "name": "Pink (Pastell)" + }, + { + "code": "Yellow (Pastell)", + "hex": "#F7EE45", + "rgb": [ + 247, + 238, + 69 + ], + "name": "Yellow (Pastell)" + }, + { + "code": "Pink", + "hex": "#FF66B7", + "rgb": [ + 255, + 102, + 183 + ], + "name": "Pink" + }, + { + "code": "Yellow", + "hex": "#FFE016", + "rgb": [ + 255, + 224, + 22 + ], + "name": "Yellow" + }, + { + "code": "White", + "hex": "#FFFFFF", + "rgb": [ + 255, + 255, + 255 + ], + "name": "White" + } +] \ No newline at end of file diff --git a/perler-lab-server/palettes/nabbi.json b/perler-lab-server/palettes/nabbi.json new file mode 100644 index 0000000..95f4054 --- /dev/null +++ b/perler-lab-server/palettes/nabbi.json @@ -0,0 +1,302 @@ +[ + { + "code": "N16", + "hex": "#297A3B", + "rgb": [ + 41, + 122, + 59 + ], + "name": "Green" + }, + { + "code": "N09", + "hex": "#2F4A39", + "rgb": [ + 47, + 74, + 57 + ], + "name": "Hunter Green" + }, + { + "code": "N01", + "hex": "#3A3D41", + "rgb": [ + 58, + 61, + 65 + ], + "name": "Black" + }, + { + "code": "N17", + "hex": "#3B75CB", + "rgb": [ + 59, + 117, + 203 + ], + "name": "Bright Blue" + }, + { + "code": "N22", + "hex": "#48AF4F", + "rgb": [ + 72, + 175, + 79 + ], + "name": "Lime" + }, + { + "code": "N02", + "hex": "#50443B", + "rgb": [ + 80, + 68, + 59 + ], + "name": "Dark Brown" + }, + { + "code": "N03", + "hex": "#5A3E36", + "rgb": [ + 90, + 62, + 54 + ], + "name": "Brown Medium" + }, + { + "code": "N11", + "hex": "#644591", + "rgb": [ + 100, + 69, + 145 + ], + "name": "Purple" + }, + { + "code": "N23", + "hex": "#71A3E6", + "rgb": [ + 113, + 163, + 230 + ], + "name": "Medium Blue" + }, + { + "code": "N04", + "hex": "#813547", + "rgb": [ + 129, + 53, + 71 + ], + "name": "Maroon" + }, + { + "code": "N27", + "hex": "#875F52", + "rgb": [ + 135, + 95, + 82 + ], + "name": "Chocolate" + }, + { + "code": "N08", + "hex": "#8D8B7F", + "rgb": [ + 141, + 139, + 127 + ], + "name": "Ash" + }, + { + "code": "N05", + "hex": "#A76224", + "rgb": [ + 167, + 98, + 36 + ], + "name": "Caramel" + }, + { + "code": "N28", + "hex": "#A7C6F1", + "rgb": [ + 167, + 198, + 241 + ], + "name": "Sky" + }, + { + "code": "N06", + "hex": "#AD967E", + "rgb": [ + 173, + 150, + 126 + ], + "name": "Tan" + }, + { + "code": "N20", + "hex": "#B58B69", + "rgb": [ + 181, + 139, + 105 + ], + "name": "Light Brown" + }, + { + "code": "N24", + "hex": "#B6A0DB", + "rgb": [ + 182, + 160, + 219 + ], + "name": "Lavender" + }, + { + "code": "N30", + "hex": "#C7BF5E", + "rgb": [ + 199, + 191, + 94 + ], + "name": "Kiwi" + }, + { + "code": "N10", + "hex": "#D3CBCB", + "rgb": [ + 211, + 203, + 203 + ], + "name": "Light Grey" + }, + { + "code": "N19", + "hex": "#DF2638", + "rgb": [ + 223, + 38, + 56 + ], + "name": "Red" + }, + { + "code": "N18", + "hex": "#E1B4AB", + "rgb": [ + 225, + 180, + 171 + ], + "name": "Light Rose" + }, + { + "code": "N12", + "hex": "#E2D0BF", + "rgb": [ + 226, + 208, + 191 + ], + "name": "Ivory" + }, + { + "code": "N25", + "hex": "#EE6A97", + "rgb": [ + 238, + 106, + 151 + ], + "name": "Pink" + }, + { + "code": "N29", + "hex": "#EE9527", + "rgb": [ + 238, + 149, + 39 + ], + "name": "Gold" + }, + { + "code": "N07", + "hex": "#EEB182", + "rgb": [ + 238, + 177, + 130 + ], + "name": "Sand" + }, + { + "code": "N13", + "hex": "#F3601B", + "rgb": [ + 243, + 96, + 27 + ], + "name": "Orange" + }, + { + "code": "N15", + "hex": "#F4F4F3", + "rgb": [ + 244, + 244, + 243 + ], + "name": "White" + }, + { + "code": "N21", + "hex": "#F5EC8D", + "rgb": [ + 245, + 236, + 141 + ], + "name": "Light Yellow" + }, + { + "code": "N14", + "hex": "#F9CA00", + "rgb": [ + 249, + 202, + 0 + ], + "name": "Yellow" + }, + { + "code": "N26", + "hex": "#FCA879", + "rgb": [ + 252, + 168, + 121 + ], + "name": "Peach" + } +] \ No newline at end of file diff --git a/perler-lab-server/palettes/perler.json b/perler-lab-server/palettes/perler.json new file mode 100644 index 0000000..4a81f99 --- /dev/null +++ b/perler-lab-server/palettes/perler.json @@ -0,0 +1,1032 @@ +[ + { + "code": "80-15179", + "hex": "#305545", + "rgb": [ + 48, + 85, + 69 + ], + "name": "Evergreen" + }, + { + "code": "80-15181", + "hex": "#B3BAB8", + "rgb": [ + 179, + 186, + 184 + ], + "name": "Light Grey" + }, + { + "code": "80-15182", + "hex": "#AF9FCE", + "rgb": [ + 175, + 159, + 206 + ], + "name": "Lavender" + }, + { + "code": "80-15199", + "hex": "#008F53", + "rgb": [ + 0, + 143, + 83 + ], + "name": "Shamrock" + }, + { + "code": "80-15200", + "hex": "#0065B1", + "rgb": [ + 0, + 101, + 177 + ], + "name": "Cobalt" + }, + { + "code": "80-15201", + "hex": "#2F3C55", + "rgb": [ + 47, + 60, + 85 + ], + "name": "Midnight" + }, + { + "code": "80-15202", + "hex": "#A9CDD5", + "rgb": [ + 169, + 205, + 213 + ], + "name": "Robin's Egg" + }, + { + "code": "80-15203", + "hex": "#F2AFB7", + "rgb": [ + 242, + 175, + 183 + ], + "name": "Flamingo" + }, + { + "code": "80-15204", + "hex": "#E1747A", + "rgb": [ + 225, + 116, + 122 + ], + "name": "Salmon" + }, + { + "code": "80-15205", + "hex": "#C9A385", + "rgb": [ + 201, + 163, + 133 + ], + "name": "Fawn" + }, + { + "code": "80-15206", + "hex": "#94A19D", + "rgb": [ + 148, + 161, + 157 + ], + "name": "Pewter" + }, + { + "code": "80-15207", + "hex": "#4F595A", + "rgb": [ + 79, + 89, + 90 + ], + "name": "Charcoal" + }, + { + "code": "80-15208", + "hex": "#DEDACE", + "rgb": [ + 222, + 218, + 206 + ], + "name": "Toasted Marshmallow" + }, + { + "code": "80-15210", + "hex": "#B1628E", + "rgb": [ + 177, + 98, + 142 + ], + "name": "Orchid" + }, + { + "code": "80-15211", + "hex": "#D14337", + "rgb": [ + 209, + 67, + 55 + ], + "name": "Tomato" + }, + { + "code": "80-15212", + "hex": "#D9593A", + "rgb": [ + 217, + 89, + 58 + ], + "name": "Spice" + }, + { + "code": "80-15213", + "hex": "#F5A168", + "rgb": [ + 245, + 161, + 104 + ], + "name": "Apricot" + }, + { + "code": "80-15214", + "hex": "#D8E47C", + "rgb": [ + 216, + 228, + 124 + ], + "name": "Sherbet" + }, + { + "code": "80-15215", + "hex": "#93B0BD", + "rgb": [ + 147, + 176, + 189 + ], + "name": "Mist" + }, + { + "code": "80-15216", + "hex": "#4AC0D8", + "rgb": [ + 74, + 192, + 216 + ], + "name": "Sky" + }, + { + "code": "80-15217", + "hex": "#00A4AC", + "rgb": [ + 0, + 164, + 172 + ], + "name": "Lagoon" + }, + { + "code": "80-15218", + "hex": "#047F8A", + "rgb": [ + 4, + 127, + 138 + ], + "name": "Teal" + }, + { + "code": "80-15219", + "hex": "#7F971A", + "rgb": [ + 127, + 151, + 26 + ], + "name": "Fern" + }, + { + "code": "80-15220", + "hex": "#696E31", + "rgb": [ + 105, + 110, + 49 + ], + "name": "Olive" + }, + { + "code": "80-15961", + "hex": "#9D2B3A", + "rgb": [ + 157, + 43, + 58 + ], + "name": "Cherry" + }, + { + "code": "80-19001", + "hex": "#EAEFEE", + "rgb": [ + 234, + 239, + 238 + ], + "name": "White" + }, + { + "code": "80-19002", + "hex": "#E1E2BB", + "rgb": [ + 225, + 226, + 187 + ], + "name": "Creme" + }, + { + "code": "80-19003", + "hex": "#E7CE3E", + "rgb": [ + 231, + 206, + 62 + ], + "name": "Yellow" + }, + { + "code": "80-19004", + "hex": "#EB7B31", + "rgb": [ + 235, + 123, + 49 + ], + "name": "Orange" + }, + { + "code": "80-19005", + "hex": "#B0353C", + "rgb": [ + 176, + 53, + 60 + ], + "name": "Red" + }, + { + "code": "80-19006", + "hex": "#D8729A", + "rgb": [ + 216, + 114, + 154 + ], + "name": "Bubblegum" + }, + { + "code": "80-19007", + "hex": "#684B86", + "rgb": [ + 104, + 75, + 134 + ], + "name": "Purple" + }, + { + "code": "80-19008", + "hex": "#0E5092", + "rgb": [ + 14, + 80, + 146 + ], + "name": "Dark Blue" + }, + { + "code": "80-19009", + "hex": "#278CC9", + "rgb": [ + 39, + 140, + 201 + ], + "name": "Light Blue" + }, + { + "code": "80-19010", + "hex": "#007B4E", + "rgb": [ + 0, + 123, + 78 + ], + "name": "Dark Green" + }, + { + "code": "80-19011", + "hex": "#18C7B1", + "rgb": [ + 24, + 199, + 177 + ], + "name": "Light Green" + }, + { + "code": "80-19012", + "hex": "#674C44", + "rgb": [ + 103, + 76, + 68 + ], + "name": "Brown" + }, + { + "code": "80-19017", + "hex": "#909497", + "rgb": [ + 144, + 148, + 151 + ], + "name": "Grey" + }, + { + "code": "80-19018", + "hex": "#323234", + "rgb": [ + 50, + 50, + 52 + ], + "name": "Black" + }, + { + "code": "80-19020", + "hex": "#995043", + "rgb": [ + 153, + 80, + 67 + ], + "name": "Rust" + }, + { + "code": "80-19021", + "hex": "#936848", + "rgb": [ + 147, + 104, + 72 + ], + "name": "Light Brown" + }, + { + "code": "80-19033", + "hex": "#E9BFB9", + "rgb": [ + 233, + 191, + 185 + ], + "name": "Peach" + }, + { + "code": "80-19035", + "hex": "#C5AC90", + "rgb": [ + 197, + 172, + 144 + ], + "name": "Tan" + }, + { + "code": "80-19038", + "hex": "#E04284", + "rgb": [ + 224, + 66, + 132 + ], + "name": "Magenta" + }, + { + "code": "80-19052", + "hex": "#4A9CCF", + "rgb": [ + 74, + 156, + 207 + ], + "name": "Pastel Blue" + }, + { + "code": "80-19053", + "hex": "#6DCC94", + "rgb": [ + 109, + 204, + 148 + ], + "name": "Pastel Green" + }, + { + "code": "80-19054", + "hex": "#937FBF", + "rgb": [ + 147, + 127, + 191 + ], + "name": "Pastel Lavender" + }, + { + "code": "80-19056", + "hex": "#E9E290", + "rgb": [ + 233, + 226, + 144 + ], + "name": "Pastel Yellow" + }, + { + "code": "80-19057", + "hex": "#FBB146", + "rgb": [ + 251, + 177, + 70 + ], + "name": "Cheddar" + }, + { + "code": "80-19058", + "hex": "#96D1D4", + "rgb": [ + 150, + 209, + 212 + ], + "name": "Toothpaste" + }, + { + "code": "80-19059", + "hex": "#DD595B", + "rgb": [ + 221, + 89, + 91 + ], + "name": "Hot Coral" + }, + { + "code": "80-19060", + "hex": "#A75D9D", + "rgb": [ + 167, + 93, + 157 + ], + "name": "Plum" + }, + { + "code": "80-19061", + "hex": "#69B845", + "rgb": [ + 105, + 184, + 69 + ], + "name": "Kiwi Lime" + }, + { + "code": "80-19062", + "hex": "#0098C5", + "rgb": [ + 0, + 152, + 197 + ], + "name": "Turquoise" + }, + { + "code": "80-19063", + "hex": "#F99297", + "rgb": [ + 249, + 146, + 151 + ], + "name": "Blush" + }, + { + "code": "80-19070", + "hex": "#6683B7", + "rgb": [ + 102, + 131, + 183 + ], + "name": "Periwinkle Blue" + }, + { + "code": "80-19079", + "hex": "#E1BCCE", + "rgb": [ + 225, + 188, + 206 + ], + "name": "Light Pink" + }, + { + "code": "80-19080", + "hex": "#4DAB64", + "rgb": [ + 77, + 171, + 100 + ], + "name": "Green" + }, + { + "code": "80-19083", + "hex": "#D45496", + "rgb": [ + 212, + 84, + 150 + ], + "name": "Pink" + }, + { + "code": "80-19088", + "hex": "#983864", + "rgb": [ + 152, + 56, + 100 + ], + "name": "Raspberry" + }, + { + "code": "80-19090", + "hex": "#DA9964", + "rgb": [ + 218, + 153, + 100 + ], + "name": "Butterscotch" + }, + { + "code": "80-19091", + "hex": "#009188", + "rgb": [ + 0, + 145, + 136 + ], + "name": "Parrot Green" + }, + { + "code": "80-19092", + "hex": "#585C61", + "rgb": [ + 88, + 92, + 97 + ], + "name": "Dark Grey" + }, + { + "code": "80-19093", + "hex": "#85A8E3", + "rgb": [ + 133, + 168, + 227 + ], + "name": "Blueberry Creme" + }, + { + "code": "80-19096", + "hex": "#843947", + "rgb": [ + 132, + 57, + 71 + ], + "name": "Cranapple" + }, + { + "code": "80-19097", + "hex": "#BBC938", + "rgb": [ + 187, + 201, + 56 + ], + "name": "Prickly Pear" + }, + { + "code": "80-19098", + "hex": "#E5BE9E", + "rgb": [ + 229, + 190, + 158 + ], + "name": "Sand" + }, + { + "code": "80-15240", + "hex": "#B3EED5", + "rgb": [ + 179, + 238, + 213 + ], + "name": "Mint" + }, + { + "code": "80-15241", + "hex": "#A3DE6F", + "rgb": [ + 163, + 222, + 111 + ], + "name": "Sour Apple" + }, + { + "code": "80-15242", + "hex": "#F479B0", + "rgb": [ + 244, + 121, + 176 + ], + "name": "Cotton Candy" + }, + { + "code": "80-15243", + "hex": "#503B9C", + "rgb": [ + 80, + 59, + 156 + ], + "name": "Grape" + }, + { + "code": "80-15244", + "hex": "#D25D72", + "rgb": [ + 210, + 93, + 114 + ], + "name": "Rose" + }, + { + "code": "80-15245", + "hex": "#4E56A3", + "rgb": [ + 78, + 86, + 163 + ], + "name": "Iris" + }, + { + "code": "80-15246", + "hex": "#FD5918", + "rgb": [ + 253, + 89, + 24 + ], + "name": "Tangerine" + }, + { + "code": "80-15247", + "hex": "#005D57", + "rgb": [ + 0, + 93, + 87 + ], + "name": "Forest" + }, + { + "code": "80-15248", + "hex": "#6F3255", + "rgb": [ + 111, + 50, + 85 + ], + "name": "Eggplant" + }, + { + "code": "80-15249", + "hex": "#DA8C2C", + "rgb": [ + 218, + 140, + 44 + ], + "name": "Honey" + }, + { + "code": "80-15250", + "hex": "#7E5446", + "rgb": [ + 126, + 84, + 70 + ], + "name": "Gingerbread" + }, + { + "code": "80-15251", + "hex": "#8C8CA7", + "rgb": [ + 140, + 140, + 167 + ], + "name": "Thistle" + }, + { + "code": "80-15252", + "hex": "#5E6D7B", + "rgb": [ + 94, + 109, + 123 + ], + "name": "Slate Blue" + }, + { + "code": "80-15253", + "hex": "#4C6388", + "rgb": [ + 76, + 99, + 136 + ], + "name": "Denim" + }, + { + "code": "80-15254", + "hex": "#9AA98E", + "rgb": [ + 154, + 169, + 142 + ], + "name": "Sage" + }, + { + "code": "80-15255", + "hex": "#EFB79B", + "rgb": [ + 239, + 183, + 155 + ], + "name": "Orange Cream" + }, + { + "code": "80-15256", + "hex": "#CA3B65", + "rgb": [ + 202, + 59, + 101 + ], + "name": "Fruit Punch" + }, + { + "code": "80-15257", + "hex": "#CB59B9", + "rgb": [ + 203, + 89, + 185 + ], + "name": "Fuchsia" + }, + { + "code": "80-15258", + "hex": "#714875", + "rgb": [ + 113, + 72, + 117 + ], + "name": "Mulberry" + }, + { + "code": "80-15259", + "hex": "#C8C85C", + "rgb": [ + 200, + 200, + 92 + ], + "name": "Slime" + }, + { + "code": "80-15260", + "hex": "#988C8C", + "rgb": [ + 152, + 140, + 140 + ], + "name": "Stone" + }, + { + "code": "80-15261", + "hex": "#14313B", + "rgb": [ + 20, + 49, + 59 + ], + "name": "Dark Spruce" + }, + { + "code": "80-15262", + "hex": "#392928", + "rgb": [ + 57, + 41, + 40 + ], + "name": "Cocoa" + }, + { + "code": "80-15265", + "hex": "#C685B1", + "rgb": [ + 198, + 133, + 177 + ], + "name": "Twilight Plum" + }, + { + "code": "80-15266", + "hex": "#6CC8AD", + "rgb": [ + 108, + 200, + 173 + ], + "name": "Caribbean Sea" + }, + { + "code": "80-15267", + "hex": "#CDB7C3", + "rgb": [ + 205, + 183, + 195 + ], + "name": "Frosted Lilac" + }, + { + "code": "80-15273", + "hex": "#FC9574", + "rgb": [ + 252, + 149, + 116 + ], + "name": "Brick" + }, + { + "code": "80-15274", + "hex": "#F6CA69", + "rgb": [ + 246, + 202, + 105 + ], + "name": "Rich Butter" + }, + { + "code": "80-15275", + "hex": "#0090AC", + "rgb": [ + 0, + 144, + 172 + ], + "name": "Peacock" + }, + { + "code": "80-15276", + "hex": "#F8C7C9", + "rgb": [ + 248, + 199, + 201 + ], + "name": "Carnation Pink" + }, + { + "code": "80-15089", + "hex": "#406AE1", + "rgb": [ + 64, + 106, + 225 + ], + "name": "Neon Blue" + }, + { + "code": "80-15268", + "hex": "#DEBA0B", + "rgb": [ + 222, + 186, + 11 + ], + "name": "Sunflower" + }, + { + "code": "80-15269", + "hex": "#F6D901", + "rgb": [ + 246, + 217, + 1 + ], + "name": "Lemon" + }, + { + "code": "80-15263", + "hex": "#BED4A6", + "rgb": [ + 190, + 212, + 166 + ], + "name": "Celery" + }, + { + "code": "80-15239", + "hex": "#C8B693", + "rgb": [ + 200, + 182, + 147 + ], + "name": "Mocha" + }, + { + "code": "80-15272", + "hex": "#FF9A8B", + "rgb": [ + 255, + 154, + 139 + ], + "name": "Coral" + } +] diff --git a/perler-lab-server/palettes/zippland-291标准色映射.json b/perler-lab-server/palettes/zippland-291标准色映射.json new file mode 100644 index 0000000..2600afb --- /dev/null +++ b/perler-lab-server/palettes/zippland-291标准色映射.json @@ -0,0 +1,293 @@ +{ + "#FAF4C8": { "MARD": "A01", "COCO": "E02", "漫漫": "E2", "盼盼": "65", "咪小窝": "77" }, + "#FFFFD5": { "MARD": "A02", "COCO": "E01", "漫漫": "B1", "盼盼": "2", "咪小窝": "2" }, + "#FEFF8B": { "MARD": "A03", "COCO": "E05", "漫漫": "B2", "盼盼": "28", "咪小窝": "28" }, + "#FBED56": { "MARD": "A04", "COCO": "E07", "漫漫": "B3", "盼盼": "3", "咪小窝": "3" }, + "#F4D738": { "MARD": "A05", "COCO": "D03", "漫漫": "B4", "盼盼": "74", "咪小窝": "79" }, + "#FEAC4C": { "MARD": "A06", "COCO": "D05", "漫漫": "B5", "盼盼": "29", "咪小窝": "29" }, + "#FE8B4C": { "MARD": "A07", "COCO": "D08", "漫漫": "B6", "盼盼": "4", "咪小窝": "4" }, + "#FFDA45": { "MARD": "A08", "COCO": "E08", "漫漫": "B10", "盼盼": "88", "咪小窝": "98" }, + "#FF995B": { "MARD": "A09", "COCO": "D06", "漫漫": "B11", "盼盼": "90", "咪小窝": "97" }, + "#F77C31": { "MARD": "A10", "COCO": "D07", "漫漫": "B12", "盼盼": "89", "咪小窝": "96" }, + "#FFDD99": { "MARD": "A11", "COCO": "D01", "漫漫": "E11", "盼盼": "100", "咪小窝": "109" }, + "#FE9F72": { "MARD": "A12", "COCO": "K09", "漫漫": "A18", "盼盼": "99", "咪小窝": "110" }, + "#FFC365": { "MARD": "A13", "COCO": "D04", "漫漫": "B13", "盼盼": "131", "咪小窝": "116" }, + "#FD543D": { "MARD": "A14", "COCO": "C05", "漫漫": "B14", "盼盼": "138", "咪小窝": "135" }, + "#FFF365": { "MARD": "A15", "COCO": "E04", "漫漫": "B15", "盼盼": "150", "咪小窝": "150" }, + "#FFFF9F": { "MARD": "A16", "COCO": "E03", "漫漫": "IC04", "盼盼": "216", "咪小窝": "216" }, + "#FFE36E": { "MARD": "A17", "COCO": "E06", "漫漫": "IC9", "盼盼": "213", "咪小窝": "213" }, + "#FEBE7D": { "MARD": "A18", "COCO": "D02", "漫漫": "IC14", "盼盼": "223", "咪小窝": "208" }, + "#FD7C72": { "MARD": "A19", "COCO": "K10", "漫漫": "IC15", "盼盼": "218", "咪小窝": "218" }, + "#FFD568": { "MARD": "A20", "COCO": "E09", "漫漫": "Q6", "盼盼": "242", "咪小窝": "242" }, + "#FFE395": { "MARD": "A21", "COCO": "E10", "漫漫": "R07", "盼盼": "276", "咪小窝": "261" }, + "#F4F57D": { "MARD": "A22", "COCO": "E11", "漫漫": "R06", "盼盼": "270", "咪小窝": "255" }, + "#E6C9B7": { "MARD": "A23", "COCO": "E12", "漫漫": "R08", "盼盼": "274", "咪小窝": "259" }, + "#F7F8A2": { "MARD": "A24", "COCO": "E13", "漫漫": "G3", "盼盼": "288", "咪小窝": "273" }, + "#FFD67D": { "MARD": "A25", "COCO": "E14", "漫漫": "G4", "盼盼": "289", "咪小窝": "274" }, + "#FFC830": { "MARD": "A26", "COCO": "E15", "漫漫": "G5", "盼盼": "290", "咪小窝": "275" }, + "#E6EE31": { "MARD": "B01", "COCO": "F05", "漫漫": "C1", "盼盼": "48", "咪小窝": "48" }, + "#63F347": { "MARD": "B02", "COCO": "F08", "漫漫": "C2", "盼盼": "33", "咪小窝": "33" }, + "#9EF780": { "MARD": "B03", "COCO": "F04", "漫漫": "C7", "盼盼": "26", "咪小窝": "26" }, + "#5DE035": { "MARD": "B04", "COCO": "F09", "漫漫": "C3", "盼盼": "66", "咪小窝": "78" }, + "#35E352": { "MARD": "B05", "COCO": "F10", "漫漫": "C4", "盼盼": "39", "咪小窝": "39" }, + "#65E2A6": { "MARD": "B06", "COCO": "G04", "漫漫": "C9", "盼盼": "11", "咪小窝": "11" }, + "#3DAF80": { "MARD": "B07", "COCO": "G05", "漫漫": "C10", "盼盼": "44", "咪小窝": "44" }, + "#1C9C4F": { "MARD": "B08", "COCO": "F11", "漫漫": "C5", "盼盼": "10", "咪小窝": "10" }, + "#27523A": { "MARD": "B09", "COCO": "F16", "漫漫": "C6", "盼盼": "79", "咪小窝": "84" }, + "#95D3C2": { "MARD": "B10", "COCO": "G03", "漫漫": "C11", "盼盼": "96", "咪小窝": "100" }, + "#5D722A": { "MARD": "B11", "COCO": "F14", "漫漫": "C12", "盼盼": "97", "咪小窝": "99" }, + "#166F41": { "MARD": "B12", "COCO": "F12", "漫漫": "C13", "盼盼": "106", "咪小窝": "111" }, + "#CAEB7B": { "MARD": "B13", "COCO": "F02", "漫漫": "C14", "盼盼": "128", "咪小窝": "119" }, + "#ADE946": { "MARD": "B14", "COCO": "F06", "漫漫": "C15", "盼盼": "129", "咪小窝": "117" }, + "#2E5132": { "MARD": "B15", "COCO": "F15", "漫漫": "C16", "盼盼": "130", "咪小窝": "122" }, + "#C5ED9C": { "MARD": "B16", "COCO": "F03", "漫漫": "C17", "盼盼": "141", "咪小窝": "133" }, + "#9BB13A": { "MARD": "B17", "COCO": "F13", "漫漫": "C18", "盼盼": "142", "咪小窝": "141" }, + "#E6EE49": { "MARD": "B18", "COCO": "F07", "漫漫": "C19", "盼盼": "147", "咪小窝": "147" }, + "#24B88C": { "MARD": "B19", "COCO": "G06", "漫漫": "DH15", "盼盼": "191", "咪小窝": "174" }, + "#C2F0CC": { "MARD": "B20", "COCO": "G02", "漫漫": "DH10", "盼盼": "192", "咪小窝": "175" }, + "#156A6B": { "MARD": "B21", "COCO": "G07", "漫漫": "DH2", "盼盼": "207", "咪小窝": "194" }, + "#0B3C43": { "MARD": "B22", "COCO": "G08", "漫漫": "DH7", "盼盼": "206", "咪小窝": "193" }, + "#303A21": { "MARD": "B23", "COCO": "F17", "漫漫": "DH12", "盼盼": "205", "咪小窝": "192" }, + "#EEFCA5": { "MARD": "B24", "COCO": "F01", "漫漫": "IC5", "盼盼": "222", "咪小窝": "207" }, + "#4E846D": { "MARD": "B25", "COCO": "F18", "漫漫": "Q13", "盼盼": "240", "咪小窝": "240" }, + "#8D7A35": { "MARD": "B26", "COCO": "F19", "漫漫": "Q7", "盼盼": "248", "咪小窝": "248" }, + "#CCE1AF": { "MARD": "B27", "COCO": "F20", "漫漫": "R10", "盼盼": "262", "咪小窝": "262" }, + "#9EE5B9": { "MARD": "B28", "COCO": "F21", "漫漫": "R11", "盼盼": "269", "咪小窝": "254" }, + "#C5E254": { "MARD": "B29", "COCO": "F22", "漫漫": "R09", "盼盼": "268", "咪小窝": "253" }, + "#E2FCB1": { "MARD": "B30", "COCO": "F23", "漫漫": "G6", "盼盼": "285", "咪小窝": "270" }, + "#B0E792": { "MARD": "B31", "COCO": "F24", "漫漫": "G7", "盼盼": "286", "咪小窝": "271" }, + "#9CAB5A": { "MARD": "B32", "COCO": "F25", "漫漫": "G12", "盼盼": "287", "咪小窝": "272" }, + "#E8FFE7": { "MARD": "C01", "COCO": "G01", "漫漫": "C8", "盼盼": "64", "咪小窝": "76" }, + "#A9F9FC": { "MARD": "C02", "COCO": "H03", "漫漫": "D1", "盼盼": "30", "咪小窝": "30" }, + "#A0E2FB": { "MARD": "C03", "COCO": "H04", "漫漫": "D2", "盼盼": "63", "咪小窝": "75" }, + "#41CCFF": { "MARD": "C04", "COCO": "H05", "漫漫": "D3", "盼盼": "77", "咪小窝": "82" }, + "#01ACEB": { "MARD": "C05", "COCO": "H07", "漫漫": "D7", "盼盼": "34", "咪小窝": "34" }, + "#50AAF0": { "MARD": "C06", "COCO": "H08", "漫漫": "D4", "盼盼": "25", "咪小窝": "25" }, + "#3677D2": { "MARD": "C07", "COCO": "H13", "漫漫": "D8", "盼盼": "9", "咪小窝": "9" }, + "#0F54C0": { "MARD": "C08", "COCO": "H14", "漫漫": "D9", "盼盼": "52", "咪小窝": "71" }, + "#324BCA": { "MARD": "C09", "COCO": "H16", "漫漫": "N5", "盼盼": "42", "咪小窝": "42" }, + "#3EBCE2": { "MARD": "C10", "COCO": "H09", "漫漫": "D25", "盼盼": "121", "咪小窝": "130" }, + "#28DDDE": { "MARD": "C11", "COCO": "H10", "漫漫": "D28", "盼盼": "122", "咪小窝": "113" }, + "#1C334D": { "MARD": "C12", "COCO": "H23", "漫漫": "D26", "盼盼": "120", "咪小窝": "120" }, + "#CDE8FF": { "MARD": "C13", "COCO": "H01", "漫漫": "D30", "盼盼": "140", "咪小窝": "142" }, + "#D5FDFF": { "MARD": "C14", "COCO": "H02", "漫漫": "D29", "盼盼": "139", "咪小窝": "136" }, + "#22C4C6": { "MARD": "C15", "COCO": "H11", "漫漫": "D31", "盼盼": "143", "咪小窝": "132" }, + "#1557A8": { "MARD": "C16", "COCO": "H18", "漫漫": "D32", "盼盼": "149", "咪小窝": "149" }, + "#04D1F6": { "MARD": "C17", "COCO": "H19", "漫漫": "D36", "盼盼": "163", "咪小窝": "156" }, + "#1D3344": { "MARD": "C18", "COCO": "H24", "漫漫": "DH6", "盼盼": "196", "咪小窝": "196" }, + "#1887A2": { "MARD": "C19", "COCO": "H12", "漫漫": "DH9", "盼盼": "202", "咪小窝": "202" }, + "#176DAF": { "MARD": "C20", "COCO": "H17", "漫漫": "DH14", "盼盼": "197", "咪小窝": "197" }, + "#BEDDFF": { "MARD": "C21", "COCO": "H06", "漫漫": "IC3", "盼盼": "212", "咪小窝": "212" }, + "#67B4BE": { "MARD": "C22", "COCO": "H25", "漫漫": "Q11", "盼盼": "239", "咪小窝": "239" }, + "#C8E2FF": { "MARD": "C23", "COCO": "H26", "漫漫": "R13", "盼盼": "263", "咪小窝": "263" }, + "#7CC4FF": { "MARD": "C24", "COCO": "H27", "漫漫": "R14", "盼盼": "267", "咪小窝": "252" }, + "#A9E5E5": { "MARD": "C25", "COCO": "H28", "漫漫": "R12", "盼盼": "271", "咪小窝": "256" }, + "#3CAED8": { "MARD": "C26", "COCO": "H29", "漫漫": "R15", "盼盼": "265", "咪小窝": "250" }, + "#D3DFFA": { "MARD": "C27", "COCO": "H30", "漫漫": "G13", "盼盼": "279", "咪小窝": "264" }, + "#BBCFED": { "MARD": "C28", "COCO": "H31", "漫漫": "G14", "盼盼": "280", "咪小窝": "265" }, + "#34488E": { "MARD": "C29", "COCO": "H32", "漫漫": "G15", "盼盼": "281", "咪小窝": "266" }, + "#AEB4F2": { "MARD": "D01", "COCO": "J07", "漫漫": "D5", "盼盼": "46", "咪小窝": "46" }, + "#858EDD": { "MARD": "D02", "COCO": "J08", "漫漫": "D6", "盼盼": "36", "咪小窝": "36" }, + "#2F54AF": { "MARD": "D03", "COCO": "H15", "漫漫": "D10", "盼盼": "8", "咪小窝": "8" }, + "#182A84": { "MARD": "D04", "COCO": "H20", "漫漫": "D11", "盼盼": "75", "咪小窝": "80" }, + "#B843C5": { "MARD": "D05", "COCO": "J12", "漫漫": "D13", "盼盼": "32", "咪小窝": "32" }, + "#AC7BDE": { "MARD": "D06", "COCO": "J11", "漫漫": "D14", "盼盼": "27", "咪小窝": "27" }, + "#8854B3": { "MARD": "D07", "COCO": "J15", "漫漫": "D12", "盼盼": "7", "咪小窝": "7" }, + "#E2D3FF": { "MARD": "D08", "COCO": "J03", "漫漫": "D16", "盼盼": "94", "咪小窝": "89" }, + "#D5B9F8": { "MARD": "D09", "COCO": "J04", "漫漫": "D17", "盼盼": "93", "咪小窝": "90" }, + "#361851": { "MARD": "D10", "COCO": "J19", "漫漫": "D15", "盼盼": "92", "咪小窝": "91" }, + "#B9BAE1": { "MARD": "D11", "COCO": "J06", "漫漫": "D19", "盼盼": "105", "咪小窝": "104" }, + "#DE9AD4": { "MARD": "D12", "COCO": "J10", "漫漫": "D20", "盼盼": "104", "咪小窝": "105" }, + "#B90095": { "MARD": "D13", "COCO": "J14", "漫漫": "D21", "盼盼": "103", "咪小窝": "106" }, + "#8B279B": { "MARD": "D14", "COCO": "J16", "漫漫": "D22", "盼盼": "102", "咪小窝": "107" }, + "#2F1F90": { "MARD": "D15", "COCO": "H22", "漫漫": "D18", "盼盼": "101", "咪小窝": "108" }, + "#E3E1EE": { "MARD": "D16", "COCO": "J01", "漫漫": "D23", "盼盼": "118", "咪小窝": "126" }, + "#C4D4F6": { "MARD": "D17", "COCO": "J05", "漫漫": "D24", "盼盼": "119", "咪小窝": "128" }, + "#A45EC7": { "MARD": "D18", "COCO": "J13", "漫漫": "D27", "盼盼": "124", "咪小窝": "125" }, + "#D8C3D7": { "MARD": "D19", "COCO": "J09", "漫漫": "D33", "盼盼": "153", "咪小窝": "153" }, + "#9C32B2": { "MARD": "D20", "COCO": "J17", "漫漫": "D34", "盼盼": "161", "咪小窝": "155" }, + "#9A009B": { "MARD": "D21", "COCO": "J18", "漫漫": "D35", "盼盼": "162", "咪小窝": "158" }, + "#333A95": { "MARD": "D22", "COCO": "H21", "漫漫": "DH1", "盼盼": "198", "咪小窝": "198" }, + "#EBDAFC": { "MARD": "D23", "COCO": "J02", "漫漫": "IC8", "盼盼": "217", "咪小窝": "217" }, + "#7786E5": { "MARD": "D24", "COCO": "J20", "漫漫": "Q14", "盼盼": "244", "咪小窝": "244" }, + "#494FC7": { "MARD": "D25", "COCO": "J21", "漫漫": "Q15", "盼盼": "249", "咪小窝": "234" }, + "#DFC2F8": { "MARD": "D26", "COCO": "J22", "漫漫": "R01", "盼盼": "273", "咪小窝": "258" }, + "#FDD3CC": { "MARD": "E01", "COCO": "K03", "漫漫": "E1", "盼盼": "18", "咪小窝": "18" }, + "#FEC0DF": { "MARD": "E02", "COCO": "K15", "漫漫": "A7", "盼盼": "38", "咪小窝": "38" }, + "#FFB7E7": { "MARD": "E03", "COCO": "K17", "漫漫": "A8", "盼盼": "62", "咪小窝": "74" }, + "#E8649E": { "MARD": "E04", "COCO": "K21", "漫漫": "A9", "盼盼": "6", "咪小窝": "6" }, + "#F551A2": { "MARD": "E05", "COCO": "K19", "漫漫": "A10", "盼盼": "40", "咪小窝": "40" }, + "#F13D74": { "MARD": "E06", "COCO": "K22", "漫漫": "A11", "盼盼": "20", "咪小窝": "20" }, + "#C63478": { "MARD": "E07", "COCO": "K25", "漫漫": "A12", "盼盼": "41", "咪小窝": "41" }, + "#FFDBE9": { "MARD": "E08", "COCO": "K12", "漫漫": "A13", "盼盼": "84", "咪小窝": "103" }, + "#E970CC": { "MARD": "E09", "COCO": "K18", "漫漫": "A14", "盼盼": "98", "咪小窝": "95" }, + "#D33793": { "MARD": "E10", "COCO": "K23", "漫漫": "A16", "盼盼": "83", "咪小窝": "94" }, + "#FCDDD2": { "MARD": "E11", "COCO": "K02", "漫漫": "A19", "盼盼": "125", "咪小窝": "131" }, + "#F78FC3": { "MARD": "E12", "COCO": "K16", "漫漫": "A20", "盼盼": "126", "咪小窝": "112" }, + "#B5006D": { "MARD": "E13", "COCO": "K24", "漫漫": "A21", "盼盼": "127", "咪小窝": "124" }, + "#FFD1BA": { "MARD": "E14", "COCO": "K05", "漫漫": "E21", "盼盼": "137", "咪小窝": "140" }, + "#F8C7C9": { "MARD": "E15", "COCO": "K04", "漫漫": "A23", "盼盼": "135", "咪小窝": "139" }, + "#FFF3EB": { "MARD": "E16", "COCO": "K01", "漫漫": "IC2", "盼盼": "221", "咪小窝": "206" }, + "#FFE2EA": { "MARD": "E17", "COCO": "K11", "漫漫": "IC7", "盼盼": "220", "咪小窝": "205" }, + "#FFC7DB": { "MARD": "E18", "COCO": "K13", "漫漫": "IC13", "盼盼": "210", "咪小窝": "210" }, + "#FEBAD5": { "MARD": "E19", "COCO": "K14", "漫漫": "IC12", "盼盼": "215", "咪小窝": "215" }, + "#D8C7D1": { "MARD": "E20", "COCO": "K26", "漫漫": "Q1", "盼盼": "241", "咪小窝": "241" }, + "#BD9DA1": { "MARD": "E21", "COCO": "K27", "漫漫": "Q2", "盼盼": "253", "咪小窝": "238" }, + "#B785A1": { "MARD": "E22", "COCO": "K28", "漫漫": "Q4", "盼盼": "252", "咪小窝": "237" }, + "#937A8D": { "MARD": "E23", "COCO": "K29", "漫漫": "Q3", "盼盼": "250", "咪小窝": "235" }, + "#E1BCE8": { "MARD": "E24", "COCO": "K30", "漫漫": "G8", "盼盼": "282", "咪小窝": "267" }, + "#FD957B": { "MARD": "F01", "COCO": "K08", "漫漫": "A1", "盼盼": "35", "咪小窝": "35" }, + "#FC3D46": { "MARD": "F02", "COCO": "C02", "漫漫": "A2", "盼盼": "31", "咪小窝": "31" }, + "#F74941": { "MARD": "F03", "COCO": "C03", "漫漫": "A3", "盼盼": "53", "咪小窝": "72" }, + "#FC283C": { "MARD": "F04", "COCO": "C06", "漫漫": "A4", "盼盼": "54", "咪小窝": "73" }, + "#E7002F": { "MARD": "F05", "COCO": "C07", "漫漫": "A5", "盼盼": "5", "咪小窝": "5" }, + "#943630": { "MARD": "F06", "COCO": "Z21", "漫漫": "E9", "盼盼": "16", "咪小窝": "16" }, + "#971937": { "MARD": "F07", "COCO": "C10", "漫漫": "A6", "盼盼": "47", "咪小窝": "47" }, + "#BC0028": { "MARD": "F08", "COCO": "C09", "漫漫": "A17", "盼盼": "81", "咪小窝": "92" }, + "#E2677A": { "MARD": "F09", "COCO": "K20", "漫漫": "A15", "盼盼": "82", "咪小窝": "93" }, + "#8A4526": { "MARD": "F10", "COCO": "Z20", "漫漫": "E15", "盼盼": "116", "咪小窝": "115" }, + "#5A2121": { "MARD": "F11", "COCO": "Z23", "漫漫": "E16", "盼盼": "117", "咪小窝": "129" }, + "#FD4E6A": { "MARD": "F12", "COCO": "C01", "漫漫": "A22", "盼盼": "136", "咪小窝": "134" }, + "#F35744": { "MARD": "F13", "COCO": "C04", "漫漫": "A24", "盼盼": "148", "咪小窝": "148" }, + "#FFA9AD": { "MARD": "F14", "COCO": "K07", "漫漫": "A25", "盼盼": "154", "咪小窝": "154" }, + "#D30022": { "MARD": "F15", "COCO": "C08", "漫漫": "DH8", "盼盼": "204", "咪小窝": "191" }, + "#FEC2A6": { "MARD": "F16", "COCO": "K06", "漫漫": "IC10", "盼盼": "211", "咪小窝": "211" }, + "#E69C79": { "MARD": "F17", "COCO": "K31", "漫漫": "Q9", "盼盼": "245", "咪小窝": "245" }, + "#D37C46": { "MARD": "F18", "COCO": "K32", "漫漫": "Q10", "盼盼": "246", "咪小窝": "246" }, + "#C1444A": { "MARD": "F19", "COCO": "K33", "漫漫": "Q05", "盼盼": "243", "咪小窝": "243" }, + "#CD9391": { "MARD": "F20", "COCO": "K34", "漫漫": "R04", "盼盼": "275", "咪小窝": "260" }, + "#F7B4C6": { "MARD": "F21", "COCO": "K35", "漫漫": "R03", "盼盼": "266", "咪小窝": "251" }, + "#FDC0D0": { "MARD": "F22", "COCO": "K36", "漫漫": "R02", "盼盼": "272", "咪小窝": "257" }, + "#F67E66": { "MARD": "F23", "COCO": "K37", "漫漫": "R05", "盼盼": "264", "咪小窝": "249" }, + "#E698AA": { "MARD": "F24", "COCO": "K38", "漫漫": "G9", "盼盼": "283", "咪小窝": "268" }, + "#E54B4F": { "MARD": "F25", "COCO": "K39", "漫漫": "G10", "盼盼": "284", "咪小窝": "269" }, + "#FFE2CE": { "MARD": "G01", "COCO": "Z02", "漫漫": "E3", "盼盼": "76", "咪小窝": "81" }, + "#FFC4AA": { "MARD": "G02", "COCO": "Z05", "漫漫": "E4", "盼盼": "49", "咪小窝": "49" }, + "#F4C3A5": { "MARD": "G03", "COCO": "Z06", "漫漫": "E5", "盼盼": "80", "咪小窝": "85" }, + "#E1B383": { "MARD": "G04", "COCO": "Z08", "漫漫": "E6", "盼盼": "19", "咪小窝": "19" }, + "#EDB045": { "MARD": "G05", "COCO": "Z10", "漫漫": "B7", "盼盼": "43", "咪小窝": "43" }, + "#E99C17": { "MARD": "G06", "COCO": "Z11", "漫漫": "B8", "盼盼": "50", "咪小窝": "50" }, + "#9D5B3E": { "MARD": "G07", "COCO": "Z18", "漫漫": "E7", "盼盼": "17", "咪小窝": "17" }, + "#753832": { "MARD": "G08", "COCO": "Z22", "漫漫": "E8", "盼盼": "12", "咪小窝": "12" }, + "#E6B483": { "MARD": "G09", "COCO": "Z09", "漫漫": "E10", "盼盼": "91", "咪小窝": "102" }, + "#D98C39": { "MARD": "G10", "COCO": "Z15", "漫漫": "B9", "盼盼": "87", "咪小窝": "101" }, + "#E0C593": { "MARD": "G11", "COCO": "Z07", "漫漫": "E12", "盼盼": "112", "咪小窝": "118" }, + "#FFC890": { "MARD": "G12", "COCO": "Z13", "漫漫": "E13", "盼盼": "113", "咪小窝": "127" }, + "#B7714A": { "MARD": "G13", "COCO": "Z14", "漫漫": "E17", "盼盼": "115", "咪小窝": "114" }, + "#8D614C": { "MARD": "G14", "COCO": "Z17", "漫漫": "E14", "盼盼": "114", "咪小窝": "123" }, + "#FCF9E0": { "MARD": "G15", "COCO": "Z03", "漫漫": "E19", "盼盼": "133", "咪小窝": "143" }, + "#F2D9BA": { "MARD": "G16", "COCO": "Z04", "漫漫": "E20", "盼盼": "134", "咪小窝": "138" }, + "#78524B": { "MARD": "G17", "COCO": "Z16", "漫漫": "E22", "盼盼": "144", "咪小窝": "137" }, + "#FFE4CC": { "MARD": "G18", "COCO": "Z01", "漫漫": "DH5", "盼盼": "203", "咪小窝": "203" }, + "#E07935": { "MARD": "G19", "COCO": "Z12", "漫漫": "DH3", "盼盼": "208", "咪小窝": "195" }, + "#A94023": { "MARD": "G20", "COCO": "Z19", "漫漫": "DH13", "盼盼": "199", "咪小窝": "199" }, + "#B88558": { "MARD": "G21", "COCO": "Z24", "漫漫": "Q8", "盼盼": "247", "咪小窝": "247" }, + "#FDFBFF": { "MARD": "H01", "COCO": "A02", "漫漫": "F1", "盼盼": "15", "咪小窝": "15" }, + "#FEFFFF": { "MARD": "H02", "COCO": "A01", "漫漫": "F2", "盼盼": "1", "咪小窝": "1" }, + "#B6B1BA": { "MARD": "H03", "COCO": "B03", "漫漫": "F3", "盼盼": "13", "咪小窝": "13" }, + "#89858C": { "MARD": "H04", "COCO": "B05", "漫漫": "F4", "盼盼": "78", "咪小窝": "83" }, + "#48464E": { "MARD": "H05", "COCO": "B06", "漫漫": "F5", "盼盼": "45", "咪小窝": "45" }, + "#2F2B2F": { "MARD": "H06", "COCO": "B07", "漫漫": "F6", "盼盼": "51", "咪小窝": "70" }, + "#000000": { "MARD": "H07", "COCO": "B09", "漫漫": "F7", "盼盼": "14", "咪小窝": "14" }, + "#E7D6DB": { "MARD": "H08", "COCO": "A09", "漫漫": "F8", "盼盼": "85", "咪小窝": "86" }, + "#EDEDED": { "MARD": "H09", "COCO": "A08", "漫漫": "F10", "盼盼": "95", "咪小窝": "87" }, + "#EEE9EA": { "MARD": "H10", "COCO": "A10", "漫漫": "F9", "盼盼": "86", "咪小窝": "88" }, + "#CECDD5": { "MARD": "H11", "COCO": "B01", "漫漫": "F11", "盼盼": "123", "咪小窝": "121" }, + "#FFF5ED": { "MARD": "H12", "COCO": "A04", "漫漫": "E18", "盼盼": "132", "咪小窝": "144" }, + "#F5ECD2": { "MARD": "H13", "COCO": "A06", "漫漫": "E23", "盼盼": "145", "咪小窝": "146" }, + "#CFD7D3": { "MARD": "H14", "COCO": "B02", "漫漫": "F12", "盼盼": "146", "咪小窝": "145" }, + "#98A6A8": { "MARD": "H15", "COCO": "B04", "漫漫": "DH4", "盼盼": "201", "咪小窝": "201" }, + "#1D1414": { "MARD": "H16", "COCO": "B08", "漫漫": "DH11", "盼盼": "200", "咪小窝": "200" }, + "#F1EDED": { "MARD": "H17", "COCO": "A07", "漫漫": "IC6", "盼盼": "214", "咪小窝": "214" }, + "#FFFDF0": { "MARD": "H18", "COCO": "A03", "漫漫": "IC1", "盼盼": "219", "咪小窝": "204" }, + "#F6EFE2": { "MARD": "H19", "COCO": "A05", "漫漫": "IC11", "盼盼": "209", "咪小窝": "209" }, + "#949FA3": { "MARD": "H20", "COCO": "B10", "漫漫": "Q12", "盼盼": "251", "咪小窝": "236" }, + "#FFFBE1": { "MARD": "H21", "COCO": "A11", "漫漫": "G1", "盼盼": "291", "咪小窝": "276" }, + "#CACAD4": { "MARD": "H22", "COCO": "A12", "漫漫": "G2", "盼盼": "277", "咪小窝": "277" }, + "#9A9D94": { "MARD": "H23", "COCO": "B11", "漫漫": "G11", "盼盼": "278", "咪小窝": "278" }, + "#BCC6B8": { "MARD": "M01", "COCO": "Y01", "漫漫": "YX11", "盼盼": "168", "咪小窝": "168" }, + "#8AA386": { "MARD": "M02", "COCO": "Y02", "漫漫": "YX12", "盼盼": "172", "咪小窝": "172" }, + "#697D80": { "MARD": "M03", "COCO": "Y03", "漫漫": "YX2", "盼盼": "166", "咪小窝": "166" }, + "#E3D2BC": { "MARD": "M04", "COCO": "Y04", "漫漫": "YX15", "盼盼": "167", "咪小窝": "167" }, + "#D0CCAA": { "MARD": "M05", "COCO": "Y05", "漫漫": "YX6", "盼盼": "174", "咪小窝": "159" }, + "#B0A782": { "MARD": "M06", "COCO": "Y06", "漫漫": "YX1", "盼盼": "169", "咪小窝": "169" }, + "#B4A497": { "MARD": "M07", "COCO": "Y07", "漫漫": "YX13", "盼盼": "171", "咪小窝": "171" }, + "#B38281": { "MARD": "M08", "COCO": "Y08", "漫漫": "YX14", "盼盼": "177", "咪小窝": "162" }, + "#A58767": { "MARD": "M09", "COCO": "Y09", "漫漫": "YX10", "盼盼": "170", "咪小窝": "170" }, + "#C5B2BC": { "MARD": "M10", "COCO": "Y10", "漫漫": "YX9", "盼盼": "164", "咪小窝": "164" }, + "#9F7594": { "MARD": "M11", "COCO": "Y11", "漫漫": "YX4", "盼盼": "176", "咪小窝": "161" }, + "#644749": { "MARD": "M12", "COCO": "Y12", "漫漫": "YX5", "盼盼": "173", "咪小窝": "173" }, + "#D19066": { "MARD": "M13", "COCO": "Y13", "漫漫": "YX8", "盼盼": "175", "咪小窝": "160" }, + "#C77362": { "MARD": "M14", "COCO": "Y14", "漫漫": "YX3", "盼盼": "165", "咪小窝": "165" }, + "#757D78": { "MARD": "M15", "COCO": "Y15", "漫漫": "YX7", "盼盼": "178", "咪小窝": "163" }, + "#FCF7F8": { "MARD": "P01", "COCO": "M01", "漫漫": "P1", "盼盼": "71", "咪小窝": "62" }, + "#B0A9AC": { "MARD": "P02", "COCO": "M02", "漫漫": "P2", "盼盼": "55", "咪小窝": "69" }, + "#AFDCAB": { "MARD": "P03", "COCO": "M03", "漫漫": "P4", "盼盼": "73", "咪小窝": "66" }, + "#FEA49F": { "MARD": "P04", "COCO": "M04", "漫漫": "P5", "盼盼": "72", "咪小窝": "64" }, + "#EE8C3E": { "MARD": "P05", "COCO": "M05", "漫漫": "P3", "盼盼": "56", "咪小窝": "63" }, + "#5FD0A7": { "MARD": "P06", "COCO": "M06", "漫漫": "P8", "盼盼": "157", "咪小窝": "65" }, + "#EB9270": { "MARD": "P07", "COCO": "M07", "漫漫": "P6", "盼盼": "159", "咪小窝": "68" }, + "#F0D958": { "MARD": "P08", "COCO": "M08", "漫漫": "P7", "盼盼": "158", "咪小窝": "67" }, + "#D9D9D9": { "MARD": "P09", "COCO": "M09", "漫漫": "P13", "盼盼": "195", "咪小窝": "178" }, + "#D9C7EA": { "MARD": "P10", "COCO": "M10", "漫漫": "P18", "盼盼": "187", "咪小窝": "187" }, + "#F3ECC9": { "MARD": "P11", "COCO": "M11", "漫漫": "P9", "盼盼": "185", "咪小窝": "185" }, + "#E6EEF2": { "MARD": "P12", "COCO": "M12", "漫漫": "P12", "盼盼": "190", "咪小窝": "190" }, + "#AACBEF": { "MARD": "P13", "COCO": "M13", "漫漫": "P17", "盼盼": "193", "咪小窝": "176" }, + "#337680": { "MARD": "P14", "COCO": "M14", "漫漫": "P22", "盼盼": "183", "咪小窝": "183" }, + "#668575": { "MARD": "P15", "COCO": "M15", "漫漫": "P23", "盼盼": "184", "咪小窝": "184" }, + "#FEBF45": { "MARD": "P16", "COCO": "M16", "漫漫": "P14", "盼盼": "182", "咪小窝": "182" }, + "#FEA324": { "MARD": "P17", "COCO": "M17", "漫漫": "P19", "盼盼": "179", "咪小窝": "179" }, + "#FEB89F": { "MARD": "P18", "COCO": "M18", "漫漫": "P11", "盼盼": "194", "咪小窝": "177" }, + "#FFFEEC": { "MARD": "P19", "COCO": "M19", "漫漫": "P10", "盼盼": "186", "咪小窝": "186" }, + "#FEBECF": { "MARD": "P20", "COCO": "M21", "漫漫": "P15", "盼盼": "188", "咪小窝": "180" }, + "#ECBEBF": { "MARD": "P21", "COCO": "M20", "漫漫": "P20", "盼盼": "180", "咪小窝": "188" }, + "#E4A89F": { "MARD": "P22", "COCO": "M22", "漫漫": "P16", "盼盼": "189", "咪小窝": "189" }, + "#A56268": { "MARD": "P23", "COCO": "M23", "漫漫": "P21", "盼盼": "181", "咪小窝": "181" }, + "#F2A5E8": { "MARD": "Q01", "COCO": "W3", "漫漫": "W3", "盼盼": "109", "咪小窝": "W3" }, + "#E9EC91": { "MARD": "Q02", "COCO": "W4", "漫漫": "W4", "盼盼": "111", "咪小窝": "W4" }, + "#FFFF00": { "MARD": "Q03", "COCO": "W1", "漫漫": "W1", "盼盼": "107", "咪小窝": "W1" }, + "#FFEBFA": { "MARD": "Q04", "COCO": "W2", "漫漫": "W2", "盼盼": "110", "咪小窝": "W2" }, + "#76CEDE": { "MARD": "Q05", "COCO": "W5", "漫漫": "W5", "盼盼": "108", "咪小窝": "W5" }, + "#D50D21": { "MARD": "R01", "COCO": "L01", "漫漫": "T1", "盼盼": "67", "咪小窝": "52" }, + "#F92F83": { "MARD": "R02", "COCO": "L02", "漫漫": "N1", "盼盼": "24", "咪小窝": "24" }, + "#FD8324": { "MARD": "R03", "COCO": "L03", "漫漫": "N2", "盼盼": "22", "咪小窝": "22" }, + "#F8EC31": { "MARD": "R04", "COCO": "L04", "漫漫": "N3", "盼盼": "21", "咪小窝": "21" }, + "#35C75B": { "MARD": "R05", "COCO": "L05", "漫漫": "N4", "盼盼": "23", "咪小窝": "23" }, + "#238891": { "MARD": "R06", "COCO": "L06", "漫漫": "T4", "盼盼": "69", "咪小窝": "55" }, + "#19779D": { "MARD": "R07", "COCO": "L07", "漫漫": "T5", "盼盼": "37", "咪小窝": "37" }, + "#1A60C3": { "MARD": "R08", "COCO": "L08", "漫漫": "T3", "盼盼": "68", "咪小窝": "54" }, + "#9A56B4": { "MARD": "R09", "COCO": "L09", "漫漫": "T2", "盼盼": "70", "咪小窝": "56" }, + "#FFDB4C": { "MARD": "R10", "COCO": "L10", "漫漫": "L2", "盼盼": "156", "咪小窝": "53" }, + "#FFEBFB": { "MARD": "R11", "COCO": "L11", "漫漫": "T6", "盼盼": "151", "咪小窝": "151" }, + "#D8D5CE": { "MARD": "R12", "COCO": "L12", "漫漫": "T7", "盼盼": "160", "咪小窝": "157" }, + "#55514C": { "MARD": "R13", "COCO": "L13", "漫漫": "-", "盼盼": "152", "咪小窝": "152" }, + "#9FE4DF": { "MARD": "R14", "COCO": "S1", "漫漫": "S1", "盼盼": "231", "咪小窝": "231" }, + "#77CEE9": { "MARD": "R15", "COCO": "S2", "漫漫": "S2", "盼盼": "237", "咪小窝": "224" }, + "#3ECFCA": { "MARD": "R16", "COCO": "S3", "漫漫": "S3", "盼盼": "238", "咪小窝": "225" }, + "#4A867A": { "MARD": "R17", "COCO": "S4", "漫漫": "S5", "盼盼": "233", "咪小窝": "233" }, + "#7FCD9D": { "MARD": "R18", "COCO": "S5", "漫漫": "S4", "盼盼": "235", "咪小窝": "222" }, + "#CDE55D": { "MARD": "R19", "COCO": "S6", "漫漫": "S11", "盼盼": "227", "咪小窝": "227" }, + "#E8C7B4": { "MARD": "R20", "COCO": "S7", "漫漫": "S6", "盼盼": "230", "咪小窝": "230" }, + "#AD6F3C": { "MARD": "R21", "COCO": "S8", "漫漫": "S13", "盼盼": "234", "咪小窝": "221" }, + "#6C372F": { "MARD": "R22", "COCO": "S9", "漫漫": "S15", "盼盼": "226", "咪小窝": "226" }, + "#FEB872": { "MARD": "R23", "COCO": "S10", "漫漫": "S12", "盼盼": "224", "咪小窝": "219" }, + "#F3C1C0": { "MARD": "R24", "COCO": "S11", "漫漫": "S4", "盼盼": "228", "咪小窝": "228" }, + "#C9675E": { "MARD": "R25", "COCO": "S12", "漫漫": "S14", "盼盼": "225", "咪小窝": "220" }, + "#D293BE": { "MARD": "R26", "COCO": "S13", "漫漫": "S9", "盼盼": "229", "咪小窝": "229" }, + "#EA8CB1": { "MARD": "R27", "COCO": "S14", "漫漫": "S8", "盼盼": "232", "咪小窝": "232" }, + "#9C87D6": { "MARD": "R28", "COCO": "S15", "漫漫": "S10", "盼盼": "236", "咪小窝": "223" }, + "#FFFFFF": { "MARD": "T01", "COCO": "L14", "漫漫": "L6", "盼盼": "155", "咪小窝": "51" }, + "#FD6FB4": { "MARD": "Y01", "COCO": "N01", "漫漫": "Y1", "盼盼": "59", "咪小窝": "59" }, + "#FEB481": { "MARD": "Y02", "COCO": "N02", "漫漫": "Y2", "盼盼": "60", "咪小窝": "60" }, + "#D7FAA0": { "MARD": "Y03", "COCO": "N03", "漫漫": "Y3", "盼盼": "57", "咪小窝": "57" }, + "#8BDBFA": { "MARD": "Y04", "COCO": "N04", "漫漫": "Y4", "盼盼": "58", "咪小窝": "58" }, + "#E987EA": { "MARD": "Y05", "COCO": "N05", "漫漫": "Y5", "盼盼": "61", "咪小窝": "61" }, + "#DAABB3": { "MARD": "ZG1", "COCO": "GB1", "漫漫": "ZG1", "盼盼": "254", "咪小窝": "ZG1" }, + "#D6AA87": { "MARD": "ZG2", "COCO": "GB2", "漫漫": "ZG2", "盼盼": "255", "咪小窝": "ZG2" }, + "#C1BD8D": { "MARD": "ZG3", "COCO": "GB3", "漫漫": "ZG3", "盼盼": "256", "咪小窝": "ZG3" }, + "#96869F": { "MARD": "ZG4", "COCO": "GB4", "漫漫": "ZG4", "盼盼": "257", "咪小窝": "ZG4" }, + "#8490A6": { "MARD": "ZG5", "COCO": "GB5", "漫漫": "ZG5", "盼盼": "258", "咪小窝": "ZG5" }, + "#94BFE2": { "MARD": "ZG6", "COCO": "GB6", "漫漫": "ZG6", "盼盼": "259", "咪小窝": "ZG6" }, + "#E2A9D2": { "MARD": "ZG7", "COCO": "GB7", "漫漫": "ZG7", "盼盼": "260", "咪小窝": "ZG7" }, + "#AB91C0": { "MARD": "ZG8", "COCO": "GB8", "漫漫": "ZG8", "盼盼": "261", "咪小窝": "ZG8" } +} \ No newline at end of file diff --git a/perler-lab-server/src/color-chart/routes.ts b/perler-lab-server/src/color-chart/routes.ts new file mode 100644 index 0000000..e262bf0 --- /dev/null +++ b/perler-lab-server/src/color-chart/routes.ts @@ -0,0 +1,190 @@ +/** + * 色号表 SEO 页面 JSON-LD 结构化数据 API。 + * + * 设计说明(SPA 无 SSR 的注入方案): + * 1. 本项目是纯前端 SPA(Vite),没有 SSR 可以在页面源码中直接输出 + *