# sherwin
**Repository Path**: xiewenqiang123/TypesettingTool
## Basic Information
- **Project Name**: sherwin
- **Description**: 一款小红书内容创作者批量制图、商品图片统一尺寸处理、社交媒体图片标准化、批量生成小红书风格封面的工具
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-28
- **Last Updated**: 2026-02-28
## Categories & Tags
**Categories**: Uncategorized
**Tags**: Python, shell, Batchfile
## README
# 🎨 小红书批量图片排版工具
**一款专为小红书创作者设计的图片批量处理工具**
[](https://www.python.org/downloads/)
[](LICENSE)
[]()
[功能特性](#-功能特性) • [快速开始](#-快速开始) • [使用指南](#-使用指南) • [常见问题](#-常见问题)
---
## ✨ 功能特性
- 🖼️ **批量导入** - 一次性处理多张图片,支持 JPG/PNG/BMP/GIF 格式
- 📐 **智能调整** - 自动调整为小红书推荐尺寸(3:4 / 1:1 / 16:9)
- 🎨 **灵活填充** - 三种填充方式,保持最佳视觉效果
- 🌈 **多彩背景** - 六种背景颜色,满足不同风格需求
- ✨ **封面装饰** - 小红书风格封面模板(简约/时尚/可爱)
- 👁️ **实时预览** - 即时查看处理效果,所见即所得
- 💾 **一键导出** - 批量导出高质量 PNG 图片
---
## 🚀 快速开始
### Windows 用户
1. **下载项目**
```bash
git clone https://github.com/your-username/xiaohongshu-layout-tool.git
cd xiaohongshu-layout-tool
```
2. **一键安装**
- 双击 `scripts/install_simple.bat`
- 或在命令行运行:
```bash
scripts\install_simple.bat
```
3. **启动应用** ⭐ 推荐
- 双击 `scripts/run_safe.bat`
- 或在命令行运行:
```bash
scripts\run_safe.bat
```
### macOS / Linux 用户
1. **下载项目**
```bash
git clone https://github.com/your-username/xiaohongshu-layout-tool.git
cd xiaohongshu-layout-tool
```
2. **一键安装**
```bash
bash scripts/install.sh
```
3. **启动应用**
```bash
bash scripts/run.sh
```
### 📦 系统要求
- **操作系统**:Windows 7+ / macOS 10.12+ / Linux(带图形界面)
- **Python**:3.7 或更高版本
- **内存**:建议 4GB 以上
- **硬盘**:至少 100MB 可用空间
---
## 📖 使用指南
### 第一步:导入图片
1. 点击「📁 选择图片」按钮
2. 在文件选择窗口中选择一张或多张图片
3. 左侧列表会显示已导入的图片数量
### 第二步:设置参数
**尺寸设置**
- **3:4 (1080×1440)** - 小红书最推荐,适合详情和长图
- **1:1 (1080×1080)** - 正方形,适合头像和封面
- **16:9 (1080×608)** - 宽屏,适合横幅和Banner
**填充方式**
- **适应填充** - 保持原图比例,四周留白
- **居中裁剪** - 保持原图比例,智能裁剪
- **拉伸填充** - 强制拉伸到目标尺寸
**背景颜色**
- 白色、黑色、浅灰、浅蓝、浅粉、浅黄
### 第三步:封面设置(可选)
1. 勾选「添加小红书风格封面」
2. 输入封面标题(2-8 字最佳)
3. 选择装饰风格:
- **简约** - 商务正式风格
- **时尚** - 潮流时尚风格
- **可爱** - 萌系清新风格
### 第四步:处理图片
1. 点击「🔄 开始处理」按钮
2. 等待进度条完成
3. 右侧预览区查看效果
### 第五步:导出图片
1. 点击「💾 批量导出」按钮
2. 选择保存目录
3. 所有处理后的图片会自动保存为 PNG 格式
---
## 💡 使用技巧
### 提高处理质量
- ✅ 使用高清原图(分辨率≥1080px)
- ✅ 标题控制在 2-8 字,显示效果最佳
- ✅ 根据内容选择合适的封面风格
### 批量处理建议
- ✅ 可以一次导入上百张图片
- ✅ 使用相同参数处理可保持风格统一
- ✅ 处理后建议检查预览效果
### 风格搭配建议
| 内容类型 | 推荐尺寸 | 推荐背景 | 推荐风格 |
|---------|---------|---------|---------|
| 商品展示 | 3:4 | 白色/浅灰 | 简约 |
| 穿搭美妆 | 3:4 | 浅粉/浅蓝 | 时尚 |
| 美食萌宠 | 3:4 | 浅黄 | 可爱 |
| 知识分享 | 3:4 | 白色 | 简约 |
---
## ❓ 常见问题
### Q: 需要安装 Python 吗?
**A:** 是的。如果你还没有安装 Python,请从官网下载:https://www.python.org/downloads/
**安装时请务必勾选 "Add Python to PATH"**(添加 Python 到系统路径)
### Q: Mac 用户提示 "tkinter 未安装" 怎么办?
**A:** macOS 通常会自动安装 tkinter。如果提示未安装,可以使用 Homebrew 安装:
```bash
brew install python-tk@3.9
```
### Q: 支持哪些图片格式?
**A:** 支持 JPG、JPEG、PNG、BMP、GIF 格式。建议使用 JPG 或 PNG 格式以获得最佳质量。
### Q: 导出的图片是什么格式?
**A:** 统一导出为 PNG 格式,保证图片质量,方便后续编辑。
### Q: 可以撤销处理吗?
**A:** 可以点击「🗑️ 清空列表」按钮,重新导入图片重新处理。
### Q: 程序运行很慢怎么办?
**A:**
- 检查图片文件大小,建议每张图片不超过 10MB
- 减少同时处理的图片数量
- 关闭其他占用内存的程序
### Q: 出现错误怎么办?
**A:**
1. 查看错误提示信息
2. 检查 Python 版本是否正确(≥3.7)
3. 尝试重新安装依赖:运行 `scripts/install.bat` 或 `bash scripts/install.sh`
4. 如问题仍未解决,请在 GitHub 提交 Issue
---
## 📂 项目结构
```
xiaohongshu-layout-tool/
├── xiaohongshu_layout_tool.py # 主程序
├── requirements.txt # 依赖文件
├── scripts/ # 安装和运行脚本
│ ├── install.bat # Windows 安装脚本
│ ├── run.bat # Windows 启动脚本
│ ├── install.sh # Linux/Mac 安装脚本
│ └── run.sh # Linux/Mac 启动脚本
├── docs/ # 文档目录
│ ├── USER_GUIDE.md # 详细使用指南
│ ├── FAQ.md # 常见问题解答
│ └── BUILD.md # 打包说明
├── README.md # 项目说明
├── LICENSE # 开源协议
└── ... # 其他文件
```
---
## 🤝 贡献
欢迎贡献代码、报告 Bug 或提出建议!
1. Fork 本项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request
---
## 📄 开源协议
本项目采用 [MIT License](LICENSE) 开源协议。
---
## 🙏 致谢
感谢所有为本项目做出贡献的开发者和使用者!
---
## 📮 联系方式
- 📧 邮箱:your-email@example.com
- 🐛 问题反馈:[GitHub Issues](https://github.com/your-username/xiaohongshu-layout-tool/issues)
- 💬 讨论区:[GitHub Discussions](https://github.com/your-username/xiaohongshu-layout-tool/discussions)
---
**如果这个工具对你有帮助,请给个 ⭐️ Star 支持一下!**
Made with ❤️ by Xiaohongshu Layout Tool Team