将照片智能转换为可打印的黑白线稿涂色页，适合儿童手工、成人减压和创意活动。
说明：
## 核心用法
**coloring-page** 是一款基于 Gemini 3 Pro Image（Nano Banana Pro）模型的图像转换工具，专为对话式场景设计。用户只需上传照片并说出”create a coloring page”，系统即可自动生成高质量的黑白轮廓线稿，输出为 PNG 格式的可打印涂色页。
### 主要功能
– **一键转换**：支持 JPG、PNG、WebP 等常见位图格式输入
– **多分辨率输出**：提供 1K/2K/4K 三档分辨率选项，满足不同打印需求
– **白底黑线输出**：生成专业涂色页格式，直接打印即可使用
### CLI 使用示例
“`bash
# 基础转换
coloring-page –in photo.jpg
# 自定义输出文件名
coloring-page –in photo.jpg –out coloring.png
# 指定高分辨率
coloring-page –in photo.jpg –resolution 2K
“`
## 显著优点
1. **AI 驱动的高质量转换**：依托 Gemini 3 Pro Image 的强大图像理解能力，能够智能识别照片主体，生成清晰流畅、细节丰富的轮廓线条，远超传统边缘检测算法效果
2. **极简交互设计**：对话式触发机制（上传图片+自然语言指令）大幅降低使用门槛，无需专业图像处理知识
3. **输出即用**：白底黑线的标准涂色页格式，兼容所有打印机和纸张类型
4. **分辨率灵活**：从屏幕浏览到海报级打印均可覆盖
## 潜在缺点与局限性
– **依赖外部 API**：需配置 GEMINI_API_KEY，存在服务可用性和成本考量
– **需要 uv 运行时**：依赖 Python 生态工具链，环境配置有一定复杂度
– **仅支持静态图片**：不支持视频或实时摄像头输入
– **无自定义风格**：目前无法调整线稿风格（如卡通化、写实化等参数控制）
– **隐私敏感**：用户照片需上传至 Google Gemini API 进行处理
## 适合人群
– **家长**：为孩子将家庭照片、宠物照转换成个性化涂色页
– **教育工作者**：制作教学主题涂色材料
– **手工爱好者/减压需求者**：将风景、花卉等照片转为成人涂色书风格线稿
– **设计师**：快速获取矢量风格的轮廓参考
## 常规风险
| 风险类型 | 说明 | 缓解建议 |
|———|——|———|
| API 依赖 | Gemini 服务中断或响应延迟 | 本地缓存结果，设置超时重试 |
| 数据隐私 | 图片上传至第三方云端处理 | 避免上传含敏感信息、人脸清晰可识别的照片 |
| 输出质量波动 | 复杂背景或低对比度照片可能生成杂乱线条 | 预处理裁剪主体，选择简洁背景照片 |
| 版权合规 | 转换他人版权照片存在法律风险 | 仅处理自有版权或授权图片 |
## 综合评价
coloring-page 是一款定位精准、体验流畅的 AI 图像工具，成功将专业的图像处理技术封装为大众可用的对话式服务。虽然在风格可控性和隐私保护方面存在改进空间，但对于目标场景（家庭娱乐、教育辅助、轻度创意）已具备成熟的实用价值。
