批量重命名文件脚本：先预览映射、试跑 10 个再全量执行

import fs from 'node:fs';
import path from 'node:path';
import crypto from 'node:crypto';
const [mode, dirArg = './photos-copy'] = process.argv.slice(2);
const root = fs.realpathSync(dirArg);
const manifest = path.join(root, 'rename-plan.json');
const hash = file => crypto.createHash('sha256').update(fs.readFileSync(file)).digest('hex');
const safe = name => typeof name === 'string' && /^[a-zA-Z0-9_.-]+$/.test(name) && !['.', '..'].includes(name);
if (mode === 'plan') {
  if (fs.existsSync(manifest)) throw new Error('已有计划，请先检查，不覆盖');
  const rows = fs.readdirSync(root, { withFileTypes: true })
    .filter(e => e.isFile() && /^img_[a-z0-9_-]+\.jpg$/i.test(e.name))
    .map(e => ({ old: e.name, new: e.name.slice(4).toLowerCase(), sha256: hash(path.join(root, e.name)) }));
  if (!rows.length) throw new Error('没有 img_*.jpg');
  fs.writeFileSync(manifest, JSON.stringify({ root, rows }, null, 2), { flag: 'wx' });
  console.log('仅生成计划，未改名', rows);
} else {
  if (!['apply', 'rollback'].includes(mode)) throw new Error('用法: node rename.mjs plan|apply|rollback 目录');
  const plan = JSON.parse(fs.readFileSync(manifest));
  if (plan.root !== root) throw new Error('计划属于另一个目录');
  const rows = plan.rows.map(r => ({ ...r, from: mode === 'apply' ? r.old : r.new, to: mode === 'apply' ? r.new : r.old }));
  const targets = new Set();
  for (const r of rows) {
    if (!safe(r.from) || !safe(r.to)) throw new Error('名称越界');
    const key = r.to.toLowerCase();
    if (targets.has(key)) throw new Error('多个源指向同一目标，重新设计命名规则');
    targets.add(key);
    const from = path.join(root, r.from), to = path.join(root, r.to);
    if (!fs.lstatSync(from).isFile() || hash(from) !== r.sha256) throw new Error('源文件变更或不是普通文件');
    if (fs.existsSync(to)) throw new Error('目标已存在；本脚本不处理链式/循环改名');
  }
  const journal = path.join(root, 'rename-' + mode + '-' + Date.now() + '.jsonl');
  for (const r of rows) {
    fs.renameSync(path.join(root, r.from), path.join(root, r.to));
    fs.appendFileSync(journal, JSON.stringify(r) + '\n');
  }
  console.log(mode + ' 完成 ' + rows.length + ' 项；核对日志 ' + journal);
}

node rename.mjs plan ./photos-copy
node rename.mjs apply ./photos-copy
node rename.mjs rollback ./photos-copy