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

148 行
3.3 KiB
Markdown

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

# 截图调整脚本快速使用
## 🚀 快速开始(3步)
### 方法 1:使用 npm 命令(推荐)
```bash
# 1. 将截图放到 screenshots/ 目录
mkdir -p screenshots
cp your-images/* screenshots/
# 2. 运行 npm 命令处理(商店截图 1280x800)
pnpm run resize screenshot
# 3. 获取结果
ls screenshots/store/
```
### 方法 2:直接运行脚本
```bash
# 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 命令(推荐)
```bash
# 商店截图 (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
```
### 直接运行脚本
```bash
# 商店截图 (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 命令(参数传递)
```bash
# 白色背景
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
```
### 直接运行脚本
```bash
# 白色背景
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/` |
### 高级用法示例
```bash
# 生成白色背景的 Logo
pnpm run resize logo -- --background=white
# 生成顶部对齐的商店截图
pnpm run resize screenshot -- --position=top
```