🕸️ 网站品牌素材挖掘机（中文微调版）
> 输入一个网址 → 自动把全站的 Logo、图标、字体、配色、图片打包到本地 → 抽出品牌色板 → 生成可复用的静态模板。
这是什么 / 能干嘛
- 全自动扒素材：爬 sitemap + 页面 HTML/CSS，把图片、图标、字体、样式表、脚本、媒体资源全下载到本地，带校验和清单（download_manifest.json）。
- 抽品牌色板：自动提取主色 / 辅助色 / 字体，生成
brand-tokens.css，配色变量直接抄。 - 生成可复用模板：把远程依赖全部改写成本地路径，产出一套可二次修改的静态模板（桌面 + 手机双版本），断网也能看。
- 像素级校验（可选）：用 Playwright 截图对比原站，确保还原度（不装也能跑前 3 步）。
本机一键跑（专属增强）
我加了一个 run_zh.py 便捷入口，不用记一堆参数：
# 进入技能目录
cd <本技能目录>
# 用本机受管 Python 跑（推荐，环境干净）
"C:/Users/Administrator/.workbuddy/binaries/python/versions/3.13.12/python.exe" run_zh.py "https://example.com"
# 想要像素级校验时加 --validate（需先装 Playwright+Chromium）
"C:/Users/Administrator/.workbuddy/binaries/python/versions/3.13.12/python.exe" run_zh.py "https://example.com" --validate
run_zh.py 默认会开启 --use-playwright 抓 JS 渲染资源，并把前 3 步串起来（爬取→下载→生成模板）。
完整流水线（手动分步）
# 1. 资产清单：爬 sitemap+页面
python scripts/site_asset_inventory.py "https://example.com" --use-playwright
# 2. 下载到本地 assets/raw/<域名>/
python scripts/download_assets.py --inventory assets/inventory/<域名>/asset_inventory.json
# 3. 生成模板 bundle 到 assets/templates/<域名>/bundle/
python scripts/build_brand_template.py \
--source-url "https://example.com" \
--inventory assets/inventory/<域名>/asset_inventory.json \
--manifest assets/raw/<域名>/download_manifest.json
# 4. （可选）像素级校验
python scripts/validate_template_fidelity.py \
--source-url "https://example.com" \
--template-dir assets/templates/<域名>/bundle --threshold 2.5
输出路径（交付时必给）：
- assets/inventory/<域名>/asset_inventory.json（资产清单）
- assets/raw/<域名>/download_manifest.json（下载清单）
- assets/templates/<域名>/bundle/（可复用模板，含 index.desktop.html/index.mobile.html 与 brand-tokens.css）
- assets/templates/<域名>/bundle/remote_reference_audit.json（剩余外链审计）
国内站点适配（专属增强）
- 原版脚本用
urllib+canonicalize_url（带 quote/unquote），中文域名、中文路径、含中文参数的 URL 都能正常处理。 - 已把默认 User-Agent 改为中文友好标识；如需爬国内站，建议保留默认、并确认目标站
robots.txt允许。 - 若目标站证书异常（过期/自签），各脚本均支持
--ignore-ssl-errors一次性抓取。
合规边界（重要）
- 仅用于学习参考 / 个人练习 / 设计模仿练习，不要把扒下来的素材直接商用搬运（Logo、字体、图片多受版权保护）。
- 尊重 robots.txt：对方明确禁止爬取的目录/站点不要硬扒。
- 校验/渲染用 Playwright 时会在本地起无头浏览器，不对外发请求；模板渲染时屏蔽外链以保证"本地可复现"。
- 不碰任何需要登录、含个人隐私或敏感内容的后台页面。
依赖
- 核心 3 步（爬取/下载/生成模板）：仅用 Python 标准库，开箱即用。
- 校验步骤：
pip install playwright pillow后playwright install chromium（约几百 MB，可选）。 - 本机受管 Python 路径：
C:/Users/Administrator/.workbuddy/binaries/python/versions/3.13.12/python.exe
文件结构
website-branding-extractor-zh/
├── SKILL.md # 本说明（中文微调版）
├── run_zh.py # 专属一键入口
├── scripts/ # 原版 5 个脚本（MIT，保留署名）
│ ├── site_asset_inventory.py
│ ├── download_assets.py
│ ├── build_brand_template.py
│ ├── validate_template_fidelity.py
│ └── run_branding_pipeline.py
├── references/ # 原版质量门禁/实践文档 + SKILL.original.md（英文原版）
└── assets/ # 运行时输出（模板/清单/校验报告）
> 署名与协议：本技能基于 ahutanu/awesome-agent-skills 的 website-branding-extractor 微调，已本地化（中文化）+ 增强（一键入口 run_zh.py、国内站点适配、合规边界）。原版协议 MIT，署名保留。微调部分同样以 MIT 共享。
