BeanPlanet 拼豆星球

BeanPlanet（拼豆星球）是一个把照片转换成拼豆图纸的微信小程序项目，同时提供轻量 Web 预览版本。它适合手工爱好者快速生成像素化拼豆图、查看颜色用量，并导出图纸与材料清单。

BeanPlanet is a mini-program and lightweight web tool that turns photos into perler/fuse bead patterns. It helps makers generate pixel-style bead charts, match colors to real bead palettes, and export pattern images and material lists.

项目亮点 / Highlights

• 照片转拼豆图纸：上传图片后自动生成拼豆效果图与网格图纸。
• 常用尺寸预设：支持 29 × 29、52 × 52、58 × 58、87 × 87、116 × 116，也支持自定义尺寸。
• 色号集匹配：内置 Artkal 等拼豆色号数据，输出更接近真实材料的配色方案。
• 材料统计：生成颜色用量清单，方便购买、备料和复盘。
• 小程序 + Web：核心体验可在微信小程序中使用，也可通过 Web 页面快速预览。

在线主页 / Project Homepage

GitHub Pages 入口文件已经放在仓库根目录的 index.html。启用 GitHub Pages 后，项目主页通常会显示在：

https://dcdingcong.github.io/BeanPlanet/

Web 预览工具位于：

https://dcdingcong.github.io/BeanPlanet/web/

如果 GitHub Pages 还未开启，请在 GitHub 仓库中进入 Settings → Pages，选择从 main 分支的根目录部署。

快速开始 / Quick Start

微信小程序 / WeChat Mini Program

1. 打开微信开发者工具。
2. 选择“导入项目”，目录选择本仓库根目录。
3. 根据需要在 project.config.json 中配置自己的 AppID，或使用测试号调试。
4. 运行后从首页进入“照片转图纸”。

Web 预览 / Web Preview

可以直接打开 web/index.html，也可以在本地启动一个静态服务：

python -m http.server 8080

然后访问：

http://localhost:8080/web/

项目结构 / Project Structure

.
├── app.js / app.json / app.wxss        # 微信小程序入口
├── pages/                              # 小程序页面
│   ├── home/                           # 首页
│   └── index/                          # 照片转图纸工具页
├── utils/                              # 图像处理、色号与图纸逻辑
├── web/                                # Web 预览版本
├── index.html                          # GitHub Pages 项目主页
└── README.md                           # 项目说明

适合谁 / Who It Is For

BeanPlanet is designed for bead artists, DIY creators, parents, teachers, and anyone who wants to turn a favorite picture into a handmade bead pattern with less manual color matching.

拼豆星球适合拼豆玩家、手作爱好者、亲子手工、课程活动和礼物定制场景，目标是把“选图、转图、配色、统计材料”这条流程变得更简单。

后续计划 / Roadmap

• 增加更多品牌和规格的色号集。
• 优化低像素图片和复杂背景的转换效果。
• 支持更多导出格式，例如 PDF 图纸和可打印材料表。
• 增加项目保存、历史记录和模板库。

许可证 / License

目前仓库尚未指定开源许可证。如需公开复用、分发或商业使用，请先联系项目维护者确认授权。