fuwari/scripts/clean-unused-images.js

#!/usr/bin/env node

import fs from "fs";
import path from "path";
import { fileURLToPath } from "url";
import { glob } from "glob";

const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);

/**
 * 清理未使用的图片资源脚本
 * 扫描 src/content/posts 下的所有 markdown 文件，
 * 查找 src/content/assets 中未被引用的图片并删除
 */

const CONTENT_DIR = path.join(process.cwd(), "src/content");
const POSTS_DIR = path.join(CONTENT_DIR, "posts");
const ASSETS_DIR = path.join(CONTENT_DIR, "assets/images");

// 支持的图片格式
const IMAGE_EXTENSIONS = [
	".jpg",
	".jpeg",
	".png",
	".gif",
	".webp",
	".svg",
	".avif",
];

/**
 * 获取所有 markdown 文件
 */
async function getAllMarkdownFiles() {
	try {
		const pattern = path.join(POSTS_DIR, "**/*.md").replace(/\\/g, "/");
		return await glob(pattern);
	} catch (error) {
		console.error("获取 markdown 文件失败:", error.message);
		return [];
	}
}

/**
 * 获取所有图片文件
 */
async function getAllImageFiles() {
	try {
		const extensions = IMAGE_EXTENSIONS.join(",");
		const pattern = path
			.join(ASSETS_DIR, `**/*{${extensions}}`)
			.replace(/\\/g, "/");
		return await glob(pattern);
	} catch (error) {
		console.error("获取图片文件失败:", error.message);
		return [];
	}
}

/**
 * 从 markdown 内容中提取图片引用
 */
function extractImageReferences(content) {
	const references = new Set();

	// 匹配 YAML frontmatter 中的 image 字段（支持带引号和不带引号的值）
	const yamlImageRegex =
		/^---[\s\S]*?image:\s*(?:['"]([^'"]+)['"]|([^\s\n]+))[\s\S]*?^---/m;
	let match = yamlImageRegex.exec(content);
	if (match) {
		// match[1] 是带引号的值，match[2] 是不带引号的值
		references.add(match[1] || match[2]);
	}

	// 匹配 HTML img 标签: <img src="path">
	const htmlImageRegex = /<img[^>]+src=["']([^"']+)["'][^>]*>/gi;
	while ((match = htmlImageRegex.exec(content)) !== null) {
		references.add(match[1]);
	}

	// 匹配 markdown 图片语法: ![alt](path) - 更新为支持空格
	// 标准 Markdown 图片语法: ![alt](url "title") 或 ![alt](url)
	// 我们主要关心 url 部分，它可能包含空格，但通常会被 <> 包裹或者 URL 编码
	// 但如果是本地文件引用，可能直接就是路径
	
	// 1. 匹配标准 Markdown 图片 ![...](...)
	// 修复：支持 URL 中包含一层括号，例如 image(1).png
	const markdownImageRegex = /!\[.*?\]\(((?:[^()]+|\([^()]*\))+)\)/g;
	while ((match = markdownImageRegex.exec(content)) !== null) {
		let url = match[1].trim();
		// 如果 URL 包含 title 部分 (例如 "path/to/image.png" "Title")，去除 title
		// 简单的做法是看是否有空格后跟引号
		const titleMatch = url.match(/^(\S+)\s+["'].*["']$/);
		if (titleMatch) {
			url = titleMatch[1];
		} else {
            // 处理可能的 URL 编码空格 (%20)
            try {
                url = decodeURIComponent(url);
            } catch (e) {
                // ignore
            }
        }
        
        // 移除可能存在的 <> 包裹 (CommonMark 标准允许 <path>)
        if (url.startsWith('<') && url.endsWith('>')) {
            url = url.slice(1, -1);
        }
        
		references.add(url);
	}

	// 匹配 Astro Image 组件引用
	const astroImageRegex =
		/import\s+.*?\s+from\s+["']([^"']+\.(jpg|jpeg|png|gif|webp|svg|avif))["']/gi;
	while ((match = astroImageRegex.exec(content)) !== null) {
		references.add(match[1]);
	}

	return Array.from(references);
}

/**
 * 规范化路径，处理相对路径和绝对路径
 */
function normalizePath(imagePath, markdownFilePath) {
	// 跳过外部 URL
	if (imagePath.startsWith("http://") || imagePath.startsWith("https://")) {
		return null;
	}

	// 跳过以 / 开头的绝对路径（通常指向 public 目录）
	if (imagePath.startsWith("/")) {
		return null;
	}

	// 处理相对路径
	if (imagePath.startsWith("./") || imagePath.startsWith("../")) {
		const markdownDir = path.dirname(markdownFilePath);
		return path.resolve(markdownDir, imagePath);
	}

	// 处理直接的文件名或相对路径
	const markdownDir = path.dirname(markdownFilePath);
	return path.resolve(markdownDir, imagePath);
}

/**
 * 主函数
 */
async function cleanUnusedImages() {
	console.log("🔍 开始扫描未使用的图片资源...");

	// 检查目录是否存在
	if (!fs.existsSync(POSTS_DIR)) {
		console.error(`❌ Posts 目录不存在: ${POSTS_DIR}`);
		return;
	}

	if (!fs.existsSync(ASSETS_DIR)) {
		console.log(`ℹ️  Assets 目录不存在: ${ASSETS_DIR}`);
		return;
	}

	// 获取所有文件
	const markdownFiles = await getAllMarkdownFiles();
	const imageFiles = await getAllImageFiles();

	console.log(`📄 找到 ${markdownFiles.length} 个 markdown 文件`);
	console.log(`🖼️  找到 ${imageFiles.length} 个图片文件`);

	if (imageFiles.length === 0) {
		console.log("✅ 没有找到图片文件，无需清理");
		return;
	}

	// 收集所有被引用的图片
	const referencedImages = new Set();

	for (const mdFile of markdownFiles) {
		try {
			const content = fs.readFileSync(mdFile, "utf-8");
			const references = extractImageReferences(content);

			for (const ref of references) {
				const normalizedPath = normalizePath(ref, mdFile);
				if (normalizedPath) {
					const resolvedPath = path.resolve(normalizedPath);
					referencedImages.add(resolvedPath);
				}
			}
		} catch (error) {
			console.warn(`⚠️  读取文件失败: ${mdFile} - ${error.message}`);
		}
	}

	console.log(`🔗 找到 ${referencedImages.size} 个被引用的图片`);

	// 找出未被引用的图片
	const unusedImages = [];

	for (const imageFile of imageFiles) {
		const resolvedImagePath = path.resolve(imageFile);
		const isReferenced = referencedImages.has(resolvedImagePath);

		if (!isReferenced) {
			unusedImages.push(imageFile);
		}
	}

	console.log(`🗑️  找到 ${unusedImages.length} 个未使用的图片`);

	if (unusedImages.length === 0) {
		console.log("✅ 所有图片都在使用中，无需清理");
		return;
	}

	// 删除未使用的图片
	let deletedCount = 0;

	for (const unusedImage of unusedImages) {
		try {
			fs.unlinkSync(unusedImage);
			console.log(`🗑️  已删除: ${path.relative(process.cwd(), unusedImage)}`);
			deletedCount++;
		} catch (error) {
			console.error(`❌ 删除失败: ${unusedImage} - ${error.message}`);
		}
	}

	// 清理空目录
	try {
		cleanEmptyDirectories(ASSETS_DIR);
	} catch (error) {
		console.warn(`⚠️  清理空目录时出错: ${error.message}`);
	}

	console.log(`\n✅ 清理完成！删除了 ${deletedCount} 个未使用的图片文件`);
}

/**
 * 递归清理空目录
 */
function cleanEmptyDirectories(dir) {
	if (!fs.existsSync(dir)) return;

	const files = fs.readdirSync(dir);

	if (files.length === 0) {
		fs.rmdirSync(dir);
		console.log(`🗑️  已删除空目录: ${path.relative(process.cwd(), dir)}`);
		return;
	}

	for (const file of files) {
		const filePath = path.join(dir, file);
		if (fs.statSync(filePath).isDirectory()) {
			cleanEmptyDirectories(filePath);
		}
	}

	// 再次检查目录是否为空
	const remainingFiles = fs.readdirSync(dir);
	if (remainingFiles.length === 0) {
		fs.rmdirSync(dir);
		console.log(`🗑️  已删除空目录: ${path.relative(process.cwd(), dir)}`);
	}
}

// 运行脚本
// 检查是否直接运行此脚本
const scriptPath = fileURLToPath(import.meta.url);
const isMainModule =
	process.argv[1] && path.resolve(process.argv[1]) === path.resolve(scriptPath);

if (isMainModule) {
	cleanUnusedImages().catch((error) => {
		console.error("❌ 脚本执行失败:", error.message);
		console.error(error.stack);
		process.exit(1);
	});
}

export { cleanUnusedImages };