葵花码算法说明
← 返回生成器

葵花码使用说明

1. 功能

将网页链接生成放射状葵花码，支持调整射线数量、纠错等级和图片尺寸，添加中心头像，以及下载 PNG、SVG 或复制图片。

链接和头像均在浏览器本地处理，无需登录。刷新页面后恢复示例链接并清除头像，不保存输入历史。

2. 快速使用

  1. 在输入框粘贴完整网址，例如 https://example.com。
  2. 点击“生成”，下方显示葵花码。
  3. 如需头像，点击“＋ 头像”，选择图片；点击“移除”恢复默认图案。
  4. 点击“下载 PNG”“下载 SVG”或“复制图片”，保存或分享结果。

修改网址、射线或纠错后，需要重新点击“生成”。旧预览会变淡，导出按钮暂时禁用。更换头像或调整尺寸会自动更新已经生成的图片。

3. 设置

点击“设置”展开选项。初次使用保留默认值即可。

选项可选值作用
射线自动、36 条、54 条、72 条射线越多，可容纳的数据通常越多。
纠错自动、L、M、Q、H从 L 到 H，纠错数据总体增加，可容纳的链接数据减少。
尺寸512、1024、2048导出图片的宽和高，单位为像素，默认 1024。

自动模式先尝试较少的射线，再在该版本内选择能容纳链接的较高纠错等级。链接过长时，可尝试 72 条射线、较低纠错等级，或使用更短的网址。

容量按编码后的数据计算，不是固定字符数；中文、Emoji 和转义字符可能占用更多空间。工具不会自动生成短链接或删除链接参数。

4. 头像

支持 PNG、JPG/JPEG、WebP，单张最大 10 MB。图片自动居中裁剪为正方形，再以圆形显示；建议选择主体居中的图片。

头像会缩放为 512 × 512，并嵌入导出的图片。当前不提供手动拖拽裁剪。

5. 下载与复制

操作适用场景
下载 PNG聊天分享、文档插图、普通图片使用，白色背景。
下载 SVG设计排版和放大使用；线条为矢量，头像仍是位图。
复制图片将 PNG 写入剪贴板，可粘贴到支持图片的应用。

下载文件保存在浏览器设置的下载目录，文件名为 sunflower-时间戳.png 或 .svg。保存时保留完整图案和四周留白。

复制图片需要浏览器支持并允许剪贴板权限，建议通过 localhost 或 HTTPS 访问；无法复制时使用下载功能。

6. 打开方式

直接打开

解压文件后，用浏览器打开 index.html，即可生成与下载图片。

本地服务

安装 Python 3 后，在 sunflower-code 文件夹中打开终端，运行：


python3 -m http.server 5173 --bind 127.0.0.1

Windows 可使用：


py -m http.server 5173 --bind 127.0.0.1

然后访问 http://127.0.0.1:5173。在终端按 Ctrl+C 可停止服务。端口被占用时，将命令和网址中的 5173 改为其他端口。

需要发布为网站时，将页面和完整 assets/ 文件夹放到静态网站服务中即可，无需构建或配置后端；推荐使用 HTTPS。

7. 常见问题

问题处理方法
链接格式不正确使用完整的 https:// 或 http:// 地址，检查域名并去除空格、换行。路径中的空格使用 %20。
链接超出容量选择自动，或使用 72 条射线和较低纠错；仍不够时缩短网址。
下载按钮为灰色检查输入和错误提示，重新点击“生成”。
无法添加头像确认文件未损坏、格式受支持，且大小不超过 10 MB。
无法复制图片允许剪贴板权限，通过 localhost/HTTPS 打开，或直接下载 PNG。
刷新后头像消失工具不保存输入历史，需要重新选择头像。
扫码后网页打不开检查目标网址是否有效、能否访问及是否需要登录。生成器不检查目标网页，也不提供跳转托管。

8. 识别范围

葵花码不是标准 QR 码。生成时的内部校验用于确认编码数据可回读，不代表微信、手机相机等客户端已经识别成功。用于分享或打印前，请用实际目标客户端确认能否识别及打开正确地址。

工具提供生成和导出功能，不提供相机扫码、照片识别或受损图片修复。

9. 算法说明

查看详细算法说明，了解数据编码、容量选择、Reed–Solomon 纠错、掩码选择、图案绘制及回读校验。离线文本见同目录的 算法说明.md。