// 图像处理 — 前端页面
//
// 接入方式(对照 App.jsx 里"MIC产品上传"菜单项的写法,同一套路):
//
// 1. import { ImageToolPage } from './mic-upload/ImageToolPage';
// (文件放在 mic-upload/ 目录纯粹是为了跟着已有的部署流程走,跟MIC上传
// 功能本身没有关系,互不依赖)
//
// 2. NAV_GROUPS 里"产品"分组,加一行:
// { id: 'image-tool', label: '图像处理', icon: ImageIcon },
// ImageIcon 已经在 App.jsx 顶部 import 过了(Image as ImageIcon,看第7行),
// 不用再加新的图标import。
//
// 3. 渲染switch里加:
// {view === 'image-tool' && }
//
// 纯前端实现,不调用任何服务端接口/AI接口,不消耗token。"导出到文件夹"和
// "覆盖原图"用的是File System Access API(Chrome/Edge支持,Safari/Firefox
// 不支持——不支持的浏览器会自动隐藏这两个选项,只保留"打包下载")。
import React, { useState, useRef, useEffect, useCallback } from 'react';
const LOGO_STORAGE_KEY = 'image-tool-logo-settings-v1';
const SUPPORTS_FS_ACCESS = typeof window !== 'undefined' && 'showDirectoryPicker' in window;
const isJpgName = (n) => /\.jpe?g$/i.test(n || '');
const jpgNameOf = (n) => (n || 'image').replace(/\.[^.]+$/, '') + '.jpg';
function loadLogoSettings() {
try {
const raw = localStorage.getItem(LOGO_STORAGE_KEY);
if (!raw) return null;
return JSON.parse(raw);
} catch (e) {
return null;
}
}
function saveLogoSettings(settings) {
try {
localStorage.setItem(LOGO_STORAGE_KEY, JSON.stringify(settings));
} catch (e) { /* 存不下就算了(比如隐私模式),不影响当次使用 */ }
}
function loadImageFromDataUrl(dataUrl) {
return new Promise((resolve, reject) => {
const img = new Image();
img.onload = () => resolve(img);
img.onerror = reject;
img.src = dataUrl;
});
}
function fileToDataUrl(file) {
return new Promise((resolve, reject) => {
const reader = new FileReader();
reader.onload = () => resolve(reader.result);
reader.onerror = reject;
reader.readAsDataURL(file);
});
}
function loadImageFromFile(file) {
return new Promise((resolve, reject) => {
const url = URL.createObjectURL(file);
const img = new Image();
img.onload = () => resolve(img);
img.onerror = () => reject(new Error('图片加载失败: ' + file.name));
img.src = url;
});
}
// 产品居中 + 白底 + (可选)logo水印,一次画完
function processImage(srcImage, opts, logoImage, logoSettings) {
const size = opts.size;
const marginRatio = opts.margin / 100;
const usable = size * (1 - 2 * marginRatio);
const scale = Math.min(usable / srcImage.width, usable / srcImage.height);
const w = Math.max(1, Math.round(srcImage.width * scale));
const h = Math.max(1, Math.round(srcImage.height * scale));
const canvas = document.createElement('canvas');
canvas.width = size;
canvas.height = size;
const ctx = canvas.getContext('2d');
ctx.fillStyle = '#ffffff';
ctx.fillRect(0, 0, size, size);
ctx.imageSmoothingEnabled = true;
ctx.imageSmoothingQuality = 'high';
ctx.drawImage(srcImage, (size - w) / 2, (size - h) / 2, w, h);
if (logoImage && logoSettings && logoSettings.enabled) {
const logoW = size * (logoSettings.sizePct / 100);
const logoH = logoW * (logoImage.height / logoImage.width);
const marginPx = size * (logoSettings.marginPct / 100);
let lx = marginPx;
let ly = marginPx;
if (logoSettings.position === 'top-right') { lx = size - logoW - marginPx; ly = marginPx; }
else if (logoSettings.position === 'bottom-left') { lx = marginPx; ly = size - logoH - marginPx; }
else if (logoSettings.position === 'bottom-right') { lx = size - logoW - marginPx; ly = size - logoH - marginPx; }
else if (logoSettings.position === 'center') { lx = (size - logoW) / 2; ly = (size - logoH) / 2; }
ctx.save();
ctx.globalAlpha = logoSettings.opacity / 100;
ctx.drawImage(logoImage, lx, ly, logoW, logoH);
ctx.restore();
}
return new Promise((resolve) => {
canvas.toBlob((blob) => resolve(blob), 'image/jpeg', opts.quality / 100);
});
}
function LogoPanel({ logoDataUrl, setLogoDataUrl, logoSettings, setLogoSettings }) {
const fileInputRef = useRef(null);
async function handlePickLogo(e) {
const file = e.target.files && e.target.files[0];
if (!file) return;
const dataUrl = await fileToDataUrl(file);
setLogoDataUrl(dataUrl);
setLogoSettings((prev) => ({ ...prev, enabled: true }));
}
return (
);
}
export function ImageToolPage() {
const [size, setSize] = useState(1000);
const [margin, setMargin] = useState(4);
const [quality, setQuality] = useState(95);
const [exportMode, setExportMode] = useState('download'); // download | folder | overwrite
const [items, setItems] = useState([]); // { name, outName, srcImage, blob, url, handle? }
const [status, setStatus] = useState('');
const [statusErr, setStatusErr] = useState(false);
const [busy, setBusy] = useState(false);
const dropRef = useRef(null);
const fileInputRef = useRef(null);
const [logoDataUrl, setLogoDataUrl] = useState(null);
const [logoImage, setLogoImage] = useState(null);
const [logoSettings, setLogoSettings] = useState({
enabled: false, position: 'bottom-right', sizePct: 18, opacity: 100, marginPct: 4,
});
// 首次挂载时读一下之前存过的logo设置
useEffect(() => {
const saved = loadLogoSettings();
if (saved) {
if (saved.dataUrl) setLogoDataUrl(saved.dataUrl);
if (saved.settings) setLogoSettings(saved.settings);
}
}, []);
// logo图片变了就重新加载成Image对象;设置变了就存进localStorage
useEffect(() => {
if (logoDataUrl) {
loadImageFromDataUrl(logoDataUrl).then(setLogoImage).catch(() => setLogoImage(null));
} else {
setLogoImage(null);
}
}, [logoDataUrl]);
useEffect(() => {
saveLogoSettings({ dataUrl: logoDataUrl, settings: logoSettings });
}, [logoDataUrl, logoSettings]);
function say(msg, err) {
setStatus(msg);
setStatusErr(!!err);
}
const readOpts = useCallback(() => ({
size: Math.max(100, Math.min(4000, Number(size) || 1000)),
margin: Math.max(0, Math.min(40, Number(margin) || 0)),
quality: Math.max(10, Math.min(100, Number(quality) || 95)),
}), [size, margin, quality]);
function outNameFor(originalName, idx) {
const base = (originalName || ('image_' + idx)).replace(/\.[^.]+$/, '');
return base + '.jpg';
}
// ---- 模式1/2:普通读取(下载 / 存到新文件夹),源文件只读就够 ----
async function addFilesReadOnly(fileList) {
const files = Array.from(fileList).filter((f) => f.type.startsWith('image/'));
if (!files.length) return;
setBusy(true);
say(`处理中... 0/${files.length}`);
const opts = readOpts();
const next = [];
for (let i = 0; i < files.length; i++) {
const file = files[i];
try {
const img = await loadImageFromFile(file);
const blob = await processImage(img, opts, logoImage, logoSettings);
const url = URL.createObjectURL(blob);
next.push({ name: file.name, srcImage: img, outName: outNameFor(file.name, items.length + i), blob, url });
} catch (e) {
say(String(e.message || e), true);
}
say(`处理中... ${i + 1}/${files.length}`);
}
setItems((prev) => [...prev, ...next]);
say(`完成,共 ${items.length + next.length} 张`);
setBusy(false);
}
// ---- 模式3:覆盖原图,必须用File System Access拿到可写句柄 ----
async function pickFilesForOverwrite() {
if (!SUPPORTS_FS_ACCESS) { say('这个浏览器不支持"覆盖原图",换Chrome/Edge', true); return; }
let handles;
try {
handles = await window.showOpenFilePicker({
multiple: true,
types: [{ description: 'Images', accept: { 'image/*': ['.png', '.jpg', '.jpeg', '.webp'] } }],
});
} catch (e) {
return; // 用户取消选择,不算错误
}
setBusy(true);
// 把"要不要允许写入"这个确认放在选完文件这一步一次性问完,这样之后点
// "保存全部"就不会再弹出浏览器的权限确认框了。
say(`请求写入权限... 0/${handles.length}`);
const grantedHandles = [];
for (let i = 0; i < handles.length; i++) {
const handle = handles[i];
try {
const perm = await handle.requestPermission({ mode: 'readwrite' });
if (perm === 'granted') grantedHandles.push(handle);
} catch (e) { /* 这个文件没授权成功,处理阶段会因为没handle而只读处理 */ }
say(`请求写入权限... ${i + 1}/${handles.length}`);
}
const grantedSet = new Set(grantedHandles);
say(`处理中... 0/${handles.length}`);
const opts = readOpts();
const next = [];
for (let i = 0; i < handles.length; i++) {
const handle = handles[i];
try {
const file = await handle.getFile();
const img = await loadImageFromFile(file);
const blob = await processImage(img, opts, logoImage, logoSettings);
const url = URL.createObjectURL(blob);
// 没拿到写入权限的文件也照样处理出预览,只是item不带handle——导出时
// 会被跳过并提示,而不是假装能覆盖
// 覆盖后统一是 .jpg:原来就是 .jpg/.jpeg 的原地覆盖;PNG/WEBP 等保存时在原文件夹写成同名 .jpg 并删掉原文件
next.push({ name: file.name, srcImage: img, outName: isJpgName(file.name) ? file.name : jpgNameOf(file.name), blob, url, handle: grantedSet.has(handle) ? handle : null });
} catch (e) {
say(String(e.message || e), true);
}
say(`处理中... ${i + 1}/${handles.length}`);
}
setItems((prev) => [...prev, ...next]);
const deniedCount = handles.length - grantedHandles.length;
say(deniedCount > 0
? `已处理 ${next.length} 张,其中 ${deniedCount} 张没给写入权限,保存时会跳过这几张`
: `已处理 ${next.length} 张,点"保存全部"会直接覆盖原文件(不会再弹权限确认)`);
setBusy(false);
}
async function reprocessAll() {
if (!items.length) return;
setBusy(true);
say('重新处理中...');
const opts = readOpts();
const updated = [];
for (const it of items) {
const blob = await processImage(it.srcImage, opts, logoImage, logoSettings);
URL.revokeObjectURL(it.url);
updated.push({ ...it, blob, url: URL.createObjectURL(blob) });
}
setItems(updated);
say(`已按新设置重新处理 ${updated.length} 张`);
setBusy(false);
}
// 调logo位置/大小/透明度或者画布参数时,已经加进来的图自动重新画一遍预览,
// 不用每次都手动点"重新处理"——加了400ms防抖,不会拖滑块拖到一半就疯狂重算。
useEffect(() => {
if (items.length === 0) return undefined;
const timer = setTimeout(() => { reprocessAll(); }, 400);
return () => clearTimeout(timer);
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [size, margin, quality, logoImage, logoSettings]);
async function handleExport() {
if (!items.length) { say('还没有图片', true); return; }
setBusy(true);
try {
if (exportMode === 'overwrite') {
let written = 0;
let skipped = 0;
let converted = 0;
// 不是 .jpg 的原图(PNG/WEBP 等):要改成 .jpg 就得在它所在的文件夹里新建 .jpg 并删掉原文件,
// 浏览器只能通过"选择文件夹"拿到这个权限——在任何等待之前先弹出(浏览器要求紧跟着点击)
const nonJpg = items.filter((it) => it.handle && !isJpgName(it.name));
let dirHandle = null;
if (nonJpg.length) {
say(`有 ${nonJpg.length} 张不是 .jpg(如 PNG),要转成 .jpg 覆盖,请选择这些图片所在的文件夹`);
try {
dirHandle = await window.showDirectoryPicker({ mode: 'readwrite' });
} catch (e) {
dirHandle = null; // 没选文件夹:这些图跳过,.jpg 的照常覆盖
}
}
for (const it of items) {
if (!it.handle) { skipped++; continue; }
if (!isJpgName(it.name)) {
if (!dirHandle) { skipped++; continue; }
try {
// 确认原图确实在选的文件夹里(同一个文件),避免写到别的地方或误删
const orig = await dirHandle.getFileHandle(it.name);
if (orig.isSameEntry && !(await orig.isSameEntry(it.handle))) { skipped++; continue; }
let target = jpgNameOf(it.name);
// 文件夹里已经有同名 .jpg(不是这次的图)时不去覆盖它,改名为 xxx_1.jpg
for (let n = 1; n < 100; n++) {
try { await dirHandle.getFileHandle(target); target = jpgNameOf(it.name).replace(/\.jpg$/, `_${n}.jpg`); }
catch (e) { break; }
}
const fh = await dirHandle.getFileHandle(target, { create: true });
const w = await fh.createWritable();
await w.write(it.blob);
await w.close();
await dirHandle.removeEntry(it.name);
written++; converted++;
} catch (e) {
skipped++;
}
continue;
}
try {
// 权限已经在"选择要覆盖的图片"那一步问过了,这里正常不会再弹确认框
const writable = await it.handle.createWritable();
await writable.write(it.blob);
await writable.close();
written++;
} catch (e) {
skipped++;
}
}
if (written === 0 && skipped > 0) {
say(`没有成功覆盖任何文件——这些图片可能不是通过"选择要覆盖的图片"这个按钮选的(拖拽/普通选择拿不到可写权限),需要重新用那个按钮选一遍`, true);
} else if (skipped > 0) {
say(`已覆盖 ${written} 张(其中 ${converted} 张由 PNG 等转成了 .jpg),另外 ${skipped} 张被跳过:没有可写权限,或不是 .jpg 但没选对所在文件夹`, true);
} else {
say(converted ? `已覆盖保存 ${written} 张,全部为 .jpg(其中 ${converted} 张由 PNG 等转换,原文件已替换)` : `已覆盖保存 ${written} 张原图(.jpg)`);
}
} else if (exportMode === 'folder') {
let dirHandle;
try {
dirHandle = await window.showDirectoryPicker({ mode: 'readwrite' });
} catch (e) {
setBusy(false);
return; // 取消选择文件夹
}
let written = 0;
let failed = 0;
for (const it of items) {
try {
const fileHandle = await dirHandle.getFileHandle(it.outName, { create: true });
const writable = await fileHandle.createWritable();
await writable.write(it.blob);
await writable.close();
written++;
} catch (e) {
failed++;
}
}
say(failed > 0 ? `保存了 ${written} 张,${failed} 张失败` : `已保存 ${written} 张到所选文件夹`, failed > 0);
} else {
// 兼容所有浏览器的兜底方式:一张张触发普通浏览器下载,不用zip
// (File System Access不支持的浏览器,比如Safari,走这条路)
for (const it of items) {
const a = document.createElement('a');
a.href = it.url;
a.download = it.outName;
document.body.appendChild(a);
a.click();
document.body.removeChild(a);
await new Promise((r) => setTimeout(r, 150)); // 浏览器一次性弹太多下载容易被拦截,错开一点
}
say(`已触发下载 ${items.length} 张(看浏览器下载记录/默认下载文件夹)`);
}
} catch (e) {
say(`导出失败: ${e.message || e}`, true);
} finally {
setBusy(false);
}
}
function clearAll() {
items.forEach((it) => URL.revokeObjectURL(it.url));
setItems([]);
say('');
}
function removeOne(idx) {
setItems((prev) => {
const next = [...prev];
URL.revokeObjectURL(next[idx].url);
next.splice(idx, 1);
return next;
});
}
function handleDrop(e) {
e.preventDefault();
if (exportMode === 'overwrite') {
say('"覆盖原图"模式需要点下面的按钮选文件,不支持拖拽(拖拽拿不到可写权限)', true);
return;
}
if (e.dataTransfer?.files) addFilesReadOnly(e.dataTransfer.files);
}
return (
{items.length === 0 ? (
还没有图片
) : (
{items.map((it, idx) => (
{it.outName}
))}
)}
);
}