cloud-drive-renamer/scripts/README.md
Zain 3d2ad5539c feat(uc): 新增 UC 网盘适配器并迁移包管理器至 pnpm
新增 UC 网盘适配器,包括页面脚本注入、API 调用、错误处理和完整的重命名工作流。同时将包管理器从 npm 迁移至 pnpm,更新
CI/CD 工作流、文档和锁文件,并扩展权限范围以支持 UC 网盘域名。
2026-08-06 11:36:01 +08:00

3.3 KiB

截图调整脚本快速使用

🚀 快速开始(3步)

方法 1:使用 npm 命令(推荐)

# 1. 将截图放到 screenshots/ 目录
mkdir -p screenshots
cp your-images/* screenshots/

# 2. 运行 npm 命令处理(商店截图 1280x800)
pnpm run resize screenshot

# 3. 获取结果
ls screenshots/store/

方法 2:直接运行脚本

# 1. 将截图放到 screenshots/ 目录
mkdir -p screenshots
cp your-images/* screenshots/

# 2. 运行脚本处理
node scripts/resize-screenshots.js screenshot

# 3. 获取结果
ls screenshots/store/

📁 目录结构

处理后会自动生成如下结构:

screenshots/
├── your-image.png          # 原始文件
├── store/                 # 商店截图 (1280x800)
│   └── your-image.png
├── logo/                  # Logo (300x300)
├── promo-small/           # 小促销图 (440x280)
└── promo-large/           # 大促销图 (1400x560)

📖 常用命令

npm 命令(推荐)

# 商店截图 (1280x800)
pnpm run resize screenshot

# 小尺寸截图 (640x400)
pnpm run resize screenshot-small

# Logo (300x300)
pnpm run resize logo

# 小促销图 (440x280)
pnpm run resize small-promo

# 大促销图 (1400x560)
pnpm run resize large-promo

# 一次生成所有尺寸(示例)
for preset in screenshot screenshot-small logo small-promo large-promo; do
  pnpm run resize $preset
done

直接运行脚本

# 商店截图 (1280x800)
node scripts/resize-screenshots.js screenshot

# Logo (300x300)
node scripts/resize-screenshots.js logo

# 小促销图 (440x280)
node scripts/resize-screenshots.js small-promo

# 大促销图 (1400x560)
node scripts/resize-screenshots.js large-promo

# 小尺寸截图 (640x400)
node scripts/resize-screenshots.js screenshot-small

🎨 高级选项

使用 npm 命令(参数传递)

# 白色背景
pnpm run resize logo -- --background=white

# 顶部对齐
pnpm run resize screenshot -- --position=top

# 自定义背景色
pnpm run resize screenshot -- --background=#F5F5F5

# 组合选项
pnpm run resize logo -- --background=white --position=center

直接运行脚本

# 白色背景
node scripts/resize-screenshots.js logo --background=white

# 顶部对齐
node scripts/resize-screenshots.js screenshot --position=top

# 自定义背景色
node scripts/resize-screenshots.js screenshot --background=#F5F5F5

📚 完整文档

查看 docs/RESIZE_SCREENSHOTS_GUIDE.md 获取完整使用指南。

✨ 可用的 npm 命令

项目已配置统一的 pnpm run resize 命令(通过参数选择预设):

命令 说明 输出目录
pnpm run resize screenshot 商店截图 (1280x800) screenshots/store/
pnpm run resize screenshot-small 小尺寸截图 (640x400) screenshots/small/
pnpm run resize logo Logo (300x300) screenshots/logo/
pnpm run resize small-promo 小促销图 (440x280) screenshots/promo-small/
pnpm run resize large-promo 大促销图 (1400x560) screenshots/promo-large/

高级用法示例

# 生成白色背景的 Logo
pnpm run resize logo -- --background=white

# 生成顶部对齐的商店截图
pnpm run resize screenshot -- --position=top