技能介绍

解决的具体问题

克隆或脚手架生成开源项目后，名字和图标往往还是上游的默认品牌。直接改源码里的字符串和 favicon、logo、manifest 很容易漏掉，编译产物也可能继续嵌入旧品牌。这个技能把 zhenyu 品牌替换 做成可复现的流程：先把源码中的上游产品名改成 zhenyu，再把品牌图标换成随附的 阵雨 (rain shower) 图标，然后在重新构建前确认改动范围。

核心能力

使用确定性的 scripts/rebrand.py，避免每次都手动做一遍 find-and-replace。
从 package.json、manifest.webmanifest、README 标题、pyproject.toml、Cargo.toml 或 go.mod 自动检测上游产品名。
先用 --dry-run 预览名称和图标变更，再执行正式替换。
名称替换 采用大小写不敏感、词边界安全的方式，覆盖源码和文本文件，同时跳过 node_modules、.git、dist、build-output 和依赖目录。
图标替换 面向 favicon*、*logo*、*icon*、apple-touch*、banner*、og-image*、brand*、thumbnail* 等品牌图片，使用 zhenyu-rain.svg 作为矢量主文件，并按目标格式生成对应资源。
覆盖 Electron/Tauri 的 build/ 和 resources/ 图标，但不会改动 LICENSE、NOTICE 或版权头。
可用 --name 覆盖目标名、--old-name 跳过自动检测、--no-name 或 --no-icons 单独执行，也可以 --icon 指定自定义图标源。

工作流程

克隆或脚手架生成目标项目，但先不要构建；先做品牌替换，再让编译输出使用新资产。
运行 scripts/rebrand.py --dry-run，检查它检测到的上游产品名以及计划替换的名称/图标。
执行正式替换，脚本按前述规则替换名称和品牌图片。
打开应用或 index.html，确认标题显示为 zhenyu，favicon/logo 已变成阵雨图标；如果上游使用内联 data: URI favicon，或压缩后的 dist/ 中写死了品牌字符串，需要手工处理。
重新运行项目正常的 build/package，让编译产物嵌入新资产。

适用边界与注意点

脚本面向展示名、品牌字符串和图标资产，不负责重命名普通代码标识符；不确定时先用 --dry-run 看 diff。
对于内联 data: URI favicon、压缩产物中的硬编码品牌字符串，脚本可能不会自动修复，需参考 references/branding-locations.md 手工补齐。
多数宽松许可证（如 MIT、Apache-2.0、BSD）允许品牌替换，但必须保留署名：保留原始 LICENSE 和 NOTICE，补充自己的版权声明，不删除上游声明。
GPL/AGPL 等 copyleft 许可证下，品牌替换不会免除相同方式共享义务，分发前需要自行确认许可要求。
最终验证应在运行中的应用里完成，而不只是在文件树里检查文件名。