+
+
+
+
+
+
+
+ ${isActive ? `⚡ ${formatSpeed(speed)}` : ''}
+ ${isError ? `下载异常 (错误码: ${t.errorCode || 'ERR'})` : `${formatBytes(completed)} / ${total > 0 ? formatBytes(total) : '未知大小'} (${percent}%)`}
+ 剩余: ${etaText}
+
+
${threadDisplay} 线程
+
+
+ `;
+ }
+
+ // ---------- 4. 任务交互动作 ----------
+ async function togglePauseTask(task) {
+ try {
+ if (task.status === 'paused' || task.uiStatus === 'paused') {
+ await aria2.unpause(task.gid);
+ } else {
+ // 先尝试优雅暂停，失败则强制暂停
+ try {
+ await aria2.pause(task.gid);
+ } catch (err) {
+ await aria2.forcePause(task.gid);
+ }
+ }
+ setTimeout(fetchTaskData, 200);
+ } catch (e) {
+ console.error('切换暂停/恢复失败:', e);
+ }
+ }
+
+ async function retryTask(task) {
+ try {
+ // 提取原始 URIs
+ let uris = [];
+ if (task.files && task.files.length > 0) {
+ uris = task.files.flatMap(f => (f.uris || []).map(u => u.uri)).filter(Boolean);
+ }
+
+ const saveDir = task.dir || settings.saveDir;
+ const threads = parseInt(settings.maxThreads || 16, 10);
+ const options = {
+ dir: saveDir,
+ 'max-connection-per-server': String(threads),
+ split: String(threads),
+ 'file-allocation': 'none',
+ 'async-dns': 'false',
+ 'enable-async-dns6': 'false',
+ 'check-certificate': 'false',
+ 'user-agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36',
+ header: [
+ 'Accept: */*',
+ 'Accept-Language: zh-CN,zh;q=0.9,en;q=0.8'
+ ],
+ 'allow-overwrite': 'true',
+ 'auto-file-renaming': 'true',
+ 'continue': 'true'
+ };
+
+ if (task.files && task.files[0] && task.files[0].path) {
+ const parts = task.files[0].path.split(/[/\\]/);
+ const baseName = parts[parts.length - 1];
+ if (baseName && !baseName.startsWith('[METADATA]')) {
+ options.out = baseName;
+ }
+ }
+
+ // 1. 清除当前失败记录
+ try {
+ await aria2.removeDownloadResult(task.gid);
+ } catch (err) {}
+
+ // 2. 重新提交任务
+ if (uris.length > 0) {
+ await aria2.addUri(uris, options);
+ } else {
+ try {
+ await aria2.unpause(task.gid);
+ } catch (err) {}
+ }
+
+ services.showNotification('重新发起下载', `已重试任务“${getFileName(task)}”`);
+ setTimeout(fetchTaskData, 200);
+ } catch (e) {
+ await showAlert('重试失败', e.message || String(e));
+ }
+ }
+
+ function openTaskFolder(task) {
+ const p = getFilePath(task);
+ const saveDir = (task && task.dir) ? task.dir : settings.saveDir;
+ services.openInExplorer(p, saveDir);
+ }
+
+ function copyTaskLink(task) {
+ const url = getTaskUrl(task);
+ if (url) {
+ const cleanUrl = url.trim().replace(/^['"]+|['"]+$/g, '');
+ navigator.clipboard.writeText(cleanUrl);
+ services.showNotification('已复制链接', cleanUrl);
+ }
+ }
+
+ // ---------- 模态框与弹窗辅助函数 ----------
+ function showConfirm(title, message, options = {}) {
+ return new Promise((resolve) => {
+ const confirmModal = document.getElementById('confirmModal');
+ const confirmTitle = document.getElementById('confirmTitle');
+ const confirmMessage = document.getElementById('confirmMessage');
+ const confirmOptionContainer = document.getElementById('confirmOptionContainer');
+ const chkDeleteFile = document.getElementById('chkDeleteFile');
+ const chkDeleteFileLabel = document.getElementById('chkDeleteFileLabel');
+ const btnConfirmCancel = document.getElementById('btnConfirmCancel');
+ const btnConfirmOk = document.getElementById('btnConfirmOk');
+
+ if (!confirmModal) {
+ const isOk = window.confirm(`${title}\n\n${message}`);
+ resolve(isOk);
+ return;
+ }
+
+ confirmTitle.innerText = title || '确认操作';
+ confirmMessage.innerText = message || '';
+
+ if (options.showCheckbox) {
+ confirmOptionContainer.style.display = 'block';
+ chkDeleteFile.checked = false;
+ chkDeleteFileLabel.innerText = options.checkboxLabel || '同时删除本地已下载的文件';
+ } else {
+ confirmOptionContainer.style.display = 'none';
+ }
+
+ btnConfirmOk.innerText = options.okText || '确定';
+ if (options.danger) {
+ btnConfirmOk.classList.add('btn-danger-glow');
+ } else {
+ btnConfirmOk.classList.remove('btn-danger-glow');
+ }
+
+ confirmModal.classList.add('active');
+
+ const cleanup = () => {
+ confirmModal.classList.remove('active');
+ btnConfirmOk.removeEventListener('click', onOk);
+ btnConfirmCancel.removeEventListener('click', onCancel);
+ const closeBtn = confirmModal.querySelector('.closeConfirmModal');
+ if (closeBtn) closeBtn.removeEventListener('click', onCancel);
+ };
+
+ const onOk = () => {
+ cleanup();
+ if (options.showCheckbox) {
+ resolve({ ok: true, deleteFile: chkDeleteFile.checked });
+ } else {
+ resolve(true);
+ }
+ };
+
+ const onCancel = () => {
+ cleanup();
+ if (options.showCheckbox) {
+ resolve({ ok: false, deleteFile: false });
+ } else {
+ resolve(false);
+ }
+ };
+
+ btnConfirmOk.addEventListener('click', onOk);
+ btnConfirmCancel.addEventListener('click', onCancel);
+ const closeBtn = confirmModal.querySelector('.closeConfirmModal');
+ if (closeBtn) closeBtn.addEventListener('click', onCancel);
+ });
+ }
+
+ function showAlert(title, message) {
+ return showConfirm(title, message, { okText: '我知道了', showCheckbox: false });
+ }
+
+ async function deleteTask(task) {
+ const fileName = getFileName(task);
+ const filePath = getFilePath(task);
+
+ const res = await showConfirm(
+ '🗑️ 删除下载任务',
+ `确定要删除任务“${fileName}”吗？`,
+ {
+ danger: true,
+ okText: '确定删除',
+ showCheckbox: true,
+ checkboxLabel: '同时删除本地已下载的文件'
+ }
+ );
+
+ let ok = false;
+ let shouldDeleteFile = false;
+ if (typeof res === 'object' && res !== null) {
+ ok = res.ok;
+ shouldDeleteFile = res.deleteFile;
+ } else {
+ ok = !!res;
+ }
+
+ if (!ok) return;
+
+ // 1. 记录删除 ID，立即从前端视图列表中移除并刷新 DOM，给予用户零延迟的即时反馈
+ const gidStr = String(task.gid);
+ deletedGids.add(gidStr);
+ try {
+ services.dbSet('aria2_deleted_gids', JSON.stringify(Array.from(deletedGids)));
+ } catch (e) {}
+ allTasks = allTasks.filter(t => String(t.gid) !== gidStr);
+ try {
+ services.dbSet('aria2_task_cache', JSON.stringify(allTasks));
+ } catch (e) {}
+ renderTaskList();
+
+ // 2. 向 Aria2 引擎发送删除与清理指令
+ try {
+ if (task.status === 'active' || task.status === 'waiting' || task.status === 'paused') {
+ try { await aria2.forceRemove(task.gid); } catch (err) {}
+ try { await aria2.remove(task.gid); } catch (err) {}
+ }
+ } catch (e) {}
+
+ // 稍做延时确保 Aria2 状态平滑流转到 stopped，然后仅清理当前 GID 的历史结果与保存 Session
+ setTimeout(async () => {
+ try {
+ try { await aria2.removeDownloadResult(task.gid); } catch (err) {}
+ try { await aria2.saveSession(); } catch (err) {}
+ } catch (e) {}
+ }, 150);
+
+ // 3. 删除本地已下载文件（若用户勾选）
+ if (shouldDeleteFile && filePath) {
+ try {
+ services.removeLocalFile(filePath);
+ services.removeLocalFile(filePath + '.aria2');
+ services.showNotification('删除成功', `已同步删除本地文件“${fileName}”`);
+ } catch (e) {}
+ } else {
+ services.showNotification('删除成功', `已移除下载任务“${fileName}”`);
+ }
+
+ setTimeout(fetchTaskData, 400);
+ }
+
+ // 暴露全局 Window 方法，双重兜底确保内联 onclick 直接生效
+ window.deleteTaskByGid = function(gid) {
+ const task = allTasks.find(item => String(item.gid).trim() === String(gid).trim());
+ if (task) deleteTask(task);
+ };
+ window.toggleTaskByGid = function(gid) {
+ const task = allTasks.find(item => String(item.gid).trim() === String(gid).trim());
+ if (task) togglePauseTask(task);
+ };
+ window.retryTaskByGid = function(gid) {
+ const task = allTasks.find(item => String(item.gid).trim() === String(gid).trim());
+ if (task) retryTask(task);
+ };
+ window.openTaskFolderByGid = function(gid) {
+ const task = allTasks.find(item => String(item.gid).trim() === String(gid).trim());
+ if (task) openTaskFolder(task);
+ };
+ window.copyTaskLinkByGid = function(gid) {
+ const task = allTasks.find(item => String(item.gid).trim() === String(gid).trim());
+ if (task) copyTaskLink(task);
+ };
+
+ // ---------- 5. 模态框与新建任务 ----------
+ const btnNewTask = document.getElementById('btnNewTask');
+ const btnOpenSettings = document.getElementById('btnOpenSettings');
+ const btnSubmitNewTask = document.getElementById('btnSubmitNewTask');
+ const btnSaveSettings = document.getElementById('btnSaveSettings');
+ const inputUrl = document.getElementById('inputUrl');
+ const inputSaveDir = document.getElementById('inputSaveDir');
+ const inputOutName = document.getElementById('inputOutName');
+ const inputThreads = document.getElementById('inputThreads');
+ const btnBrowseDir = document.getElementById('btnBrowseDir');
+
+ if (btnNewTask) {
+ btnNewTask.addEventListener('click', () => {
+ // 自动侦测剪贴板
+ const clipText = services.getClipboardText() || '';
+ if (clipText && (clipText.startsWith('http://') || clipText.startsWith('https://') || clipText.startsWith('ftp://') || clipText.startsWith('magnet:?'))) {
+ if (inputUrl) inputUrl.value = clipText;
+ } else if (inputUrl && !inputUrl.value) {
+ inputUrl.value = '';
+ }
+
+ if (inputSaveDir) inputSaveDir.value = settings.saveDir;
+ if (inputThreads) inputThreads.value = settings.maxThreads;
+ if (newTaskModal) newTaskModal.classList.add('active');
+ });
+ }
+
+ if (btnBrowseDir) {
+ btnBrowseDir.addEventListener('click', () => {
+ const chosen = services.selectFolder(inputSaveDir ? inputSaveDir.value : '');
+ if (chosen && inputSaveDir) inputSaveDir.value = chosen;
+ });
+ }
+
+ if (btnSubmitNewTask) {
+ btnSubmitNewTask.addEventListener('click', async () => {
+ const rawUrl = inputUrl ? inputUrl.value.trim() : '';
+ if (!rawUrl) {
+ await showAlert('提示', '请填入要下载的 URL 链接！');
+ return;
+ }
+
+ const urls = rawUrl.split('\n')
+ .map(u => {
+ let cleaned = u.trim().replace(/^['"]+|['"]+$/g, '').trim();
+ cleaned = cleaned.replace(/[\u200B-\u200D\uFEFF]/g, '');
+ if (!cleaned) return null;
+ try {
+ if (cleaned.includes(' ') || /[\u4e00-\u9fa5]/.test(cleaned)) {
+ cleaned = encodeURI(decodeURI(cleaned));
+ }
+ } catch (e) {
+ if (cleaned.includes(' ')) {
+ cleaned = cleaned.replace(/ /g, '%20');
+ }
+ }
+ return cleaned;
+ })
+ .filter(Boolean);
+
+ if (urls.length === 0) {
+ await showAlert('提示', '请填入有效的 URL 下载链接！');
+ return;
+ }
+
+ const saveDir = (inputSaveDir && inputSaveDir.value.trim()) || settings.saveDir;
+ const threads = parseInt(inputThreads ? inputThreads.value : '16', 10) || 16;
+ const outName = inputOutName ? inputOutName.value.trim() : '';
+
+ // 磁盘空间前置拦截检查
+ if (services.getDiskFreeSpace) {
+ const diskInfo = services.getDiskFreeSpace(saveDir);
+ if (diskInfo && diskInfo.success && diskInfo.freeBytes < 50 * 1024 * 1024) {
+ await showAlert('磁盘空间不足', `目标保存路径所在磁盘（${saveDir.substring(0, 3)}）可用空间仅剩 ${formatBytes(diskInfo.freeBytes)}！存储空间极度不足，无法新建下载任务，请清理磁盘后重试。`);
+ return;
+ }
+ }
+
+ try {
+ const options = {
+ dir: saveDir,
+ 'max-connection-per-server': String(threads),
+ split: String(threads),
+ 'file-allocation': 'none',
+ 'async-dns': 'false',
+ 'enable-async-dns6': 'false',
+ 'check-certificate': 'false',
+ 'user-agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36',
+ header: [
+ 'Accept: */*',
+ 'Accept-Language: zh-CN,zh;q=0.9,en;q=0.8'
+ ],
+ 'allow-overwrite': 'true',
+ 'auto-file-renaming': 'true',
+ 'continue': 'true'
+ };
+ if (outName && urls.length === 1) {
+ options.out = outName;
+ }
+
+ await aria2.addUri(urls, options);
+
+ if (newTaskModal) newTaskModal.classList.remove('active');
+ if (inputUrl) inputUrl.value = '';
+ if (inputOutName) inputOutName.value = '';
+ services.showNotification('已添加下载任务', `解析成功，开始多线程下载...`);
+ fetchTaskData();
+ } catch (e) {
+ await showAlert('创建任务失败', e.message || String(e));
+ }
+ });
+ }
+
+ // ---------- 6. 设置模态框 ----------
+ const settingSaveDir = document.getElementById('settingSaveDir');
+ const settingMaxThreads = document.getElementById('settingMaxThreads');
+ const settingRpcPort = document.getElementById('settingRpcPort');
+ const settingRpcSecret = document.getElementById('settingRpcSecret');
+ const btnSettingBrowseDir = document.getElementById('btnSettingBrowseDir');
+
+ if (btnOpenSettings) {
+ btnOpenSettings.addEventListener('click', () => {
+ if (settingSaveDir) settingSaveDir.value = settings.saveDir;
+ if (settingMaxThreads) settingMaxThreads.value = settings.maxThreads;
+ if (settingRpcPort) settingRpcPort.value = settings.rpcPort;
+ if (settingRpcSecret) settingRpcSecret.value = settings.rpcSecret;
+ if (settingsModal) settingsModal.classList.add('active');
+ });
+ }
+
+ if (btnSettingBrowseDir) {
+ btnSettingBrowseDir.addEventListener('click', () => {
+ const chosen = services.selectFolder(settingSaveDir ? settingSaveDir.value : '');
+ if (chosen && settingSaveDir) settingSaveDir.value = chosen;
+ });
+ }
+
+ if (btnSaveSettings) {
+ btnSaveSettings.addEventListener('click', async () => {
+ settings.saveDir = (settingSaveDir && settingSaveDir.value) || services.getDefaultDownloadDir();
+ settings.maxThreads = parseInt(settingMaxThreads ? settingMaxThreads.value : '16', 10) || 16;
+ settings.fileAlloc = 'none';
+ settings.rpcPort = parseInt(settingRpcPort ? settingRpcPort.value : '6800', 10) || 6800;
+ settings.rpcSecret = settingRpcSecret ? settingRpcSecret.value.trim() : '';
+
+ services.dbSet('aria2_settings', JSON.stringify(settings));
+ aria2.updateConfig({ port: settings.rpcPort, secret: settings.rpcSecret });
+
+ // 重置/重启后台进程使新的 CLI 参数生效
+ if (services.restartAria2) {
+ services.restartAria2({
+ port: settings.rpcPort,
+ secret: settings.rpcSecret,
+ dir: settings.saveDir,
+ fileAlloc: settings.fileAlloc
+ });
+ }
+
+ if (settingsModal) settingsModal.classList.remove('active');
+ initAria2Engine();
+ });
+ }
+
+ // 关闭 Modal
+ document.querySelectorAll('.closeModal').forEach(btn => {
+ btn.addEventListener('click', () => {
+ if (newTaskModal) newTaskModal.classList.remove('active');
+ if (settingsModal) settingsModal.classList.remove('active');
+ const cModal = document.getElementById('confirmModal');
+ if (cModal) {
+ cModal.classList.remove('active');
+ cModal.style.display = 'none';
+ }
+ });
+ });
+
+ // 标签过滤
+ document.querySelectorAll('.tab-btn').forEach(btn => {
+ btn.addEventListener('click', (e) => {
+ document.querySelectorAll('.tab-btn').forEach(b => b.classList.remove('active'));
+ e.target.classList.add('active');
+ currentFilter = e.target.dataset.filter;
+ renderTaskList();
+ });
+ });
+
+ function getFileName(t) {
+ if (!t) return '未命名下载任务';
+
+ // 1. 优先获取 Aria2 在磁盘上落地的真实文件名
+ if (t.files && t.files.length > 0 && t.files[0].path) {
+ let raw = t.files[0].path.split(/[/\\]/).pop();
+ if (raw) {
+ raw = raw.split('?')[0].split('#')[0];
+ try {
+ raw = decodeURIComponent(raw);
+ } catch (e) {}
+
+ if (raw && !raw.startsWith('[METADATA]')) {
+ return raw;
+ }
+ }
+ }
+
+ // 2. 若是 BT / 磁力任务且已解析出种子信息
+ if (t.bittorrent && t.bittorrent.info && t.bittorrent.info.name) {
+ return t.bittorrent.info.name;
+ }
+
+ // 3. 从原始 URL 解析文件名
+ const url = getTaskUrl(t);
+ if (url) {
+ try {
+ const u = new URL(url);
+ let name = u.pathname.split('/').pop();
+ if (name) {
+ name = name.split('?')[0].split('#')[0];
+ try {
+ name = decodeURIComponent(name);
+ } catch (e) {}
+ if (name && name.length > 0) return name;
+ }
+ } catch (e) {}
+ }
+
+ // 4. 磁力链解析中状态
+ if (t.files && t.files[0] && t.files[0].path && t.files[0].path.includes('[METADATA]')) {
+ return '正在解析磁力种子信息...';
+ }
+
+ return '未命名下载任务_' + t.gid;
+ }
+
+ function getFilePath(t) {
+ const saveDir = (t && t.dir) ? t.dir : (settings ? settings.saveDir : 'C:\\Downloads');
+ let rawPath = '';
+ if (t && t.files && t.files.length > 0 && t.files[0].path) {
+ rawPath = t.files[0].path;
+ }
+
+ const fileName = getFileName(t);
+
+ if (rawPath) {
+ // 判断是否包含 Windows 绝对盘符 (如 C:\)
+ if (/^[a-zA-Z]:[\\/]|^\\\\/.test(rawPath)) {
+ return rawPath.replace(/\//g, '\\');
+ }
+ // 相对路径：拼接到保存目录 saveDir 下
+ const cleanDir = saveDir.replace(/[\\/]+$/, '');
+ const cleanRaw = rawPath.replace(/^[\\/]+/, '');
+ return (cleanDir + '\\' + cleanRaw).replace(/\//g, '\\');
+ }
+
+ const cleanDir = saveDir.replace(/[\\/]+$/, '');
+ return (cleanDir + '\\' + fileName).replace(/\//g, '\\');
+ }
+
+ function getTaskUrl(t) {
+ if (t.files && t.files.length > 0 && t.files[0].uris && t.files[0].uris.length > 0) {
+ return t.files[0].uris[0].uri;
+ }
+ return '';
+ }
+
+ function formatBytes(bytes) {
+ const b = parseInt(bytes || 0, 10);
+ if (b === 0) return '0 B';
+ const k = 1024;
+ const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];
+ const i = Math.floor(Math.log(b) / Math.log(k));
+ return parseFloat((b / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
+ }
+
+ function formatSpeed(bytesPerSec) {
+ return formatBytes(bytesPerSec) + '/s';
+ }
+
+ function formatETA(seconds) {
+ const s = Math.max(0, Math.floor(seconds));
+ if (s > 86400) return '> 1 天';
+ const h = Math.floor(s / 3600).toString().padStart(2, '0');
+ const m = Math.floor((s % 3600) / 60).toString().padStart(2, '0');
+ const sec = (s % 60).toString().padStart(2, '0');
+ return `${h}:${m}:${sec}`;
+ }
+
+ function escapeHtml(str) {
+ return String(str || '').replace(/&/g, '&').replace(//g, '>').replace(/"/g, '"');
+ }
+
+ function getFileTypeSvg(name) {
+ const ext = (name.split('.').pop() || '').toLowerCase();
+ if (['zip', 'rar', '7z', 'tar', 'gz'].includes(ext)) {
+ return `
`;
+ }
+ if (['mp4', 'mkv', 'avi', 'mov', 'flv'].includes(ext)) {
+ return `
`;
+ }
+ if (['png', 'jpg', 'jpeg', 'gif', 'webp'].includes(ext)) {
+ return `
`;
+ }
+ if (['exe', 'msi', 'iso', 'dmg'].includes(ext)) {
+ return `
`;
+ }
+ return `
`;
+ }
+}
+
+if (document.readyState === 'loading') {
+ document.addEventListener('DOMContentLoaded', startApp);
+} else {
+ startApp();
+}
diff --git a/plugins/ztools-download/js/aria2-rpc.js b/plugins/ztools-download/js/aria2-rpc.js
new file mode 100644
index 000000000..45ca845e8
--- /dev/null
+++ b/plugins/ztools-download/js/aria2-rpc.js
@@ -0,0 +1,166 @@
+/**
+ * Aria2 JSON-RPC 客户端封装库
+ */
+class Aria2Client {
+ constructor(options = {}) {
+ this.host = options.host || '127.0.0.1';
+ this.port = options.port || 6800;
+ this.secret = options.secret || '';
+ this.protocol = options.protocol || 'http';
+ }
+
+ updateConfig(options = {}) {
+ if (options.host) this.host = options.host;
+ if (options.port) this.port = options.port;
+ if (options.secret !== undefined) this.secret = options.secret;
+ }
+
+ get rpcUrl() {
+ return `${this.protocol}://${this.host}:${this.port}/jsonrpc`;
+ }
+
+ async call(method, params = []) {
+ const finalParams = [];
+ if (this.secret) {
+ finalParams.push(`token:${this.secret}`);
+ }
+ if (Array.isArray(params)) {
+ finalParams.push(...params);
+ } else if (params !== undefined) {
+ finalParams.push(params);
+ }
+
+ const payload = {
+ jsonrpc: '2.0',
+ id: `ztools_${Date.now()}_${Math.random().toString(36).substring(2, 6)}`,
+ method: `aria2.${method}`,
+ params: finalParams
+ };
+
+ // 优先使用 window.services.aria2Rpc (Node.js 原生 http 通信，规避 Web Fetch 的 CORS/PNA 限制)
+ if (window.services && typeof window.services.aria2Rpc === 'function') {
+ return await window.services.aria2Rpc(payload, this.port);
+ }
+
+ try {
+ const response = await fetch(this.rpcUrl, {
+ method: 'POST',
+ headers: {
+ 'Content-Type': 'application/json'
+ },
+ body: JSON.stringify(payload)
+ });
+
+ if (!response.ok) {
+ throw new Error(`HTTP Error: ${response.status} ${response.statusText}`);
+ }
+
+ const json = await response.json();
+ if (json.error) {
+ throw new Error(json.error.message || 'RPC Error');
+ }
+ return json.result;
+ } catch (err) {
+ throw err;
+ }
+ }
+
+ // ---------------- Aria2 RPC 常用 API 方法 ----------------
+
+ /** 获取 Aria2 版本及功能信息 */
+ async getVersion() {
+ return await this.call('getVersion');
+ }
+
+ /** 获取全局统计（实时下载速度、上传速度、活动任务数等） */
+ async getGlobalStat() {
+ return await this.call('getGlobalStat');
+ }
+
+ /**
+ * 添加下载任务
+ * @param {string[]} uris 下载链接数组 [url1, url2]
+ * @param {Object} options 下载参数 (dir, out, max-connection-per-server, split 等)
+ */
+ async addUri(uris, options = {}) {
+ const uriList = Array.isArray(uris) ? uris : [uris];
+ return await this.call('addUri', [uriList, options]);
+ }
+
+ /** 获取活动中（正在下载）的任务列表 */
+ async tellActive(keys = []) {
+ return await this.call('tellActive', [keys]);
+ }
+
+ /** 获取等待中/暂停的任务列表 */
+ async tellWaiting(offset = 0, num = 100, keys = []) {
+ return await this.call('tellWaiting', [offset, num, keys]);
+ }
+
+ /** 获取已停止/已完成/已失败的任务列表 */
+ async tellStopped(offset = 0, num = 100, keys = []) {
+ return await this.call('tellStopped', [offset, num, keys]);
+ }
+
+ /** 获取指定 GID 任务状态信息 */
+ async tellStatus(gid, keys = []) {
+ return await this.call('tellStatus', [gid, keys]);
+ }
+
+ /** 暂停任务 */
+ async pause(gid) {
+ return await this.call('pause', [gid]);
+ }
+
+ /** 强制暂停任务 */
+ async forcePause(gid) {
+ return await this.call('forcePause', [gid]);
+ }
+
+ /** 恢复暂停的任务 */
+ async unpause(gid) {
+ return await this.call('unpause', [gid]);
+ }
+
+ /** 取消/移除正在进行或等待中的任务 */
+ async remove(gid) {
+ return await this.call('remove', [gid]);
+ }
+
+ /** 强制移除任务 */
+ async forceRemove(gid) {
+ return await this.call('forceRemove', [gid]);
+ }
+
+ /** 从已停止列表中清理/移除下载结果记录 */
+ async removeDownloadResult(gid) {
+ return await this.call('removeDownloadResult', [gid]);
+ }
+
+ /** 清理所有已完成/已停止的记录 */
+ async purgeDownloadResult() {
+ return await this.call('purgeDownloadResult');
+ }
+
+ /** 改变单个任务的配置参数 */
+ async changeOption(gid, options) {
+ return await this.call('changeOption', [gid, options]);
+ }
+
+ /** 获取全局默认参数 */
+ async getGlobalOption() {
+ return await this.call('getGlobalOption');
+ }
+
+ /** 修改全局参数 */
+ async changeGlobalOption(options) {
+ return await this.call('changeGlobalOption', [options]);
+ }
+
+ /** 保存当前会话记录到 session 文件 */
+ async saveSession() {
+ return await this.call('saveSession');
+ }
+}
+
+window.Aria2Client = Aria2Client;
diff --git a/plugins/ztools-download/logo.png b/plugins/ztools-download/logo.png
new file mode 100644
index 000000000..5daf9358c
Binary files /dev/null and b/plugins/ztools-download/logo.png differ
diff --git a/plugins/ztools-download/plugin.json b/plugins/ztools-download/plugin.json
new file mode 100644
index 000000000..4b8b56885
--- /dev/null
+++ b/plugins/ztools-download/plugin.json
@@ -0,0 +1,28 @@
+{
+ "name": "ztools-download",
+ "title": "Aria2 多线程下载器",
+ "pluginName": "Aria2 多线程下载器",
+ "description": "基于 Aria2 的高性能多线程下载工具，支持最高16线程分片加速、断点续传与剪贴板快捷吸附",
+ "version": "1.0.0",
+ "author": "zhanglei",
+ "main": "index.html",
+ "preload": "preload.js",
+ "logo": "logo.png",
+ "features": [
+ {
+ "code": "download",
+ "explain": "打开 Aria2 多线程下载器",
+ "cmds": [
+ "download",
+ "aria2",
+ "下载",
+ "下载器",
+ "多线程下载",
+ "xz"
+ ]
+ }
+ ],
+ "platform": [
+ "win32"
+ ]
+}
\ No newline at end of file
diff --git a/plugins/ztools-download/preload.js b/plugins/ztools-download/preload.js
new file mode 100644
index 000000000..02c458a4d
--- /dev/null
+++ b/plugins/ztools-download/preload.js
@@ -0,0 +1,617 @@
+console.log('ztools-download preload.js loaded!');
+
+const { spawn, exec, execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const http = require('http');
+
+const ztools = window.ztools || window.utools || {};
+let aria2Process = null;
+let currentRpcPort = 6800;
+let currentFileAlloc = 'none';
+let lastAria2Log = '';
+
+// ztools 插件入口钩子
+window.exports = {
+ 'download': {
+ mode: 'none',
+ args: {
+ enter() {
+ if (ztools.setExpendHeight) ztools.setExpendHeight(660);
+ if (ztools.showMainWindow) ztools.showMainWindow();
+ },
+ leave() {
+ // 插件隐藏/切出切回时不关停 aria2c，保证后台下载持续进行
+ }
+ }
+ }
+};
+
+function killAria2Process() {
+ if (aria2Process) {
+ try {
+ aria2Process.kill('SIGKILL');
+ if (aria2Process.pid) {
+ execSync(`taskkill /F /PID ${aria2Process.pid}`, { stdio: 'ignore' });
+ }
+ } catch (e) {}
+ aria2Process = null;
+ }
+ // 强制清理残余的 aria2c.exe 进程
+ try {
+ execSync('taskkill /F /IM aria2c.exe', { stdio: 'ignore' });
+ } catch (e) {}
+}
+
+function getSystemProxy() {
+ try {
+ const envProxy = process.env.HTTP_PROXY || process.env.HTTPS_PROXY || process.env.http_proxy || process.env.https_proxy;
+ if (envProxy) return envProxy;
+
+ // 自动检测 Windows 系统代理设置 (注册表查询 ProxyEnable 与 ProxyServer)
+ const regRes = execSync('reg query "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Internet Settings" /v ProxyEnable', { encoding: 'utf8', stdio: 'pipe' });
+ if (regRes && regRes.includes('0x1')) {
+ const serverRes = execSync('reg query "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Internet Settings" /v ProxyServer', { encoding: 'utf8', stdio: 'pipe' });
+ const match = serverRes.match(/ProxyServer\s+REG_SZ\s+(.+)/);
+ if (match && match[1]) {
+ let p = match[1].trim();
+ if (p.includes(';')) p = p.split(';')[0];
+ if (p.includes('=')) p = p.split('=')[1];
+ if (!p.startsWith('http://') && !p.startsWith('https://')) p = 'http://' + p;
+ return p;
+ }
+ }
+ } catch (e) {}
+ return null;
+}
+
+// 仅在进程真正退出 (SIGINT/SIGTERM/process exit) 时关闭 Aria2 守护进程
+// 切勿在 unload/beforeunload 钩子中杀死进程，确保切出插件或隐藏窗口时后台下载不中断
+
+// 查找/验证 aria2c 可执行文件路径
+function resolveAria2Path() {
+ const pluginRoot = __dirname;
+ const cwd = process.cwd();
+
+ const candidates = [
+ path.join(pluginRoot, 'bin', 'aria2c.exe'),
+ path.join(pluginRoot, 'aria2c.exe'),
+ path.join(cwd, 'bin', 'aria2c.exe'),
+ path.join(cwd, 'aria2c.exe'),
+ path.join(pluginRoot, '..', 'bin', 'aria2c.exe')
+ ];
+
+ let foundPath = null;
+
+ for (const p of candidates) {
+ try {
+ if (fs.existsSync(p)) {
+ foundPath = p;
+ break;
+ }
+ } catch (e) {}
+ }
+
+ // 查系统 PATH
+ if (!foundPath) {
+ try {
+ const whichRes = execSync('where aria2c.exe', { encoding: 'utf8', stdio: 'pipe' });
+ if (whichRes && whichRes.trim()) {
+ foundPath = whichRes.trim().split('\r\n')[0].trim();
+ }
+ } catch (e) {}
+ }
+
+ if (!foundPath) {
+ return null;
+ }
+
+ // 特殊处理 Electron / zTools .asar 包机制:
+ // child_process.spawn 无法直接执行 asar 内部的二进制 .exe 文件 (会报 ENOENT 错误)
+ // 如果路径包含 .asar，必须解压提取至系统真实临时目录 (os.tmpdir)
+ if (foundPath.includes('.asar')) {
+ try {
+ const tempDir = path.join(os.tmpdir(), 'ztools-download-bin');
+ if (!fs.existsSync(tempDir)) {
+ fs.mkdirSync(tempDir, { recursive: true });
+ }
+ const tempExe = path.join(tempDir, 'aria2c.exe');
+
+ const sourceBuf = fs.readFileSync(foundPath);
+ let needWrite = true;
+ if (fs.existsSync(tempExe)) {
+ try {
+ const stat = fs.statSync(tempExe);
+ if (stat.size === sourceBuf.length) {
+ needWrite = false;
+ }
+ } catch (e) {}
+ }
+
+ if (needWrite) {
+ fs.writeFileSync(tempExe, sourceBuf);
+ }
+ return tempExe;
+ } catch (err) {
+ console.error('解压 asar 内部 aria2c.exe 失败:', err);
+ }
+ }
+
+ return foundPath;
+}
+
+window.services = {
+ // ---------- 1. Aria2 守护进程管理 ----------
+ aria2Rpc(payload, port = 6800) {
+ return new Promise((resolve, reject) => {
+ const data = JSON.stringify(payload);
+ const req = http.request({
+ hostname: '127.0.0.1',
+ port: port,
+ path: '/jsonrpc',
+ method: 'POST',
+ headers: {
+ 'Content-Type': 'application/json',
+ 'Content-Length': Buffer.byteLength(data)
+ },
+ timeout: 5000
+ }, (res) => {
+ let body = '';
+ res.on('data', chunk => { body += chunk; });
+ res.on('end', () => {
+ try {
+ const json = JSON.parse(body);
+ if (json.error) {
+ reject(new Error(json.error.message || 'RPC Error'));
+ } else {
+ resolve(json.result);
+ }
+ } catch (e) {
+ reject(new Error('Aria2 RPC 响应数据解析异常'));
+ }
+ });
+ });
+
+ req.on('error', (err) => {
+ reject(err);
+ });
+
+ req.on('timeout', () => {
+ req.destroy();
+ reject(new Error('RPC 通信超时'));
+ });
+
+ req.write(data);
+ req.end();
+ });
+ },
+
+ async startAria2(options = {}) {
+ const port = options.port || 6800;
+ const secret = options.secret || '';
+ let saveDir = options.dir || path.join(os.homedir(), 'Downloads');
+ // 默认使用 none 文件预分配，防止 non-NTFS / FAT32 / exFAT 磁盘或权限受限电脑报 falloc error
+ let fileAlloc = options.fileAlloc || 'none';
+ if (fileAlloc === 'fallocate' || fileAlloc === 'falloc') fileAlloc = 'none';
+
+ // 1. 如果已有进程引用且正常运行，直接复用
+ if (aria2Process && !aria2Process.killed && currentFileAlloc === fileAlloc && currentRpcPort === port) {
+ return { success: true, pid: aria2Process.pid, port: port, status: 'running' };
+ }
+
+ // 2. 先做健康检查：如果端口 6800 上已存在能回应 RPC 的 Aria2 进程，直接复用
+ try {
+ const checkRes = await this.aria2Rpc({
+ jsonrpc: '2.0',
+ id: 'healthcheck',
+ method: 'aria2.getVersion',
+ params: secret ? [`token:${secret}`] : []
+ }, port);
+ if (checkRes && checkRes.version) {
+ currentRpcPort = port;
+ currentFileAlloc = fileAlloc;
+ return { success: true, port: port, status: 'already_running' };
+ }
+ } catch (e) {}
+
+ // 3. 清理已有残留进程并给 Windows socket 释放留出缓冲时间
+ killAria2Process();
+ await new Promise(r => setTimeout(r, 200));
+
+ currentRpcPort = port;
+ currentFileAlloc = fileAlloc;
+
+ const aria2Path = resolveAria2Path();
+ if (!aria2Path) {
+ lastAria2Log = `[错误] 未找到 aria2c.exe 二进制文件！\n插件期望路径: ${path.join(__dirname, 'bin', 'aria2c.exe')}\n请确认已放置 aria2c.exe 文件。`;
+ return {
+ success: false,
+ error: 'missing_binary',
+ message: '未在 bin 目录下找到 aria2c.exe，请确保放置二进制文件。'
+ };
+ }
+
+ // 尝试确保下载目录存在（无法创建时自动降级回退到系统默认 User/Downloads 目录）
+ try {
+ if (!fs.existsSync(saveDir)) {
+ fs.mkdirSync(saveDir, { recursive: true });
+ }
+ } catch (e) {
+ console.warn('指定保存路径不存在或无权限创建，自动降级回退至系统 User Downloads:', saveDir);
+ saveDir = path.join(os.homedir(), 'Downloads');
+ try {
+ if (!fs.existsSync(saveDir)) fs.mkdirSync(saveDir, { recursive: true });
+ } catch (err) {}
+ }
+
+ // 确保 session 任务保存文件存在，防止 aria2c 加载失败报错崩溃退出
+ const sessionDir = path.join(os.homedir(), '.ztools-download');
+ try {
+ if (!fs.existsSync(sessionDir)) {
+ fs.mkdirSync(sessionDir, { recursive: true });
+ }
+ } catch (e) {}
+ const sessionFilePath = path.join(sessionDir, 'aria2.session');
+ try {
+ if (!fs.existsSync(sessionFilePath)) {
+ fs.writeFileSync(sessionFilePath, '');
+ }
+ } catch (e) {}
+
+ const args = [
+ '--enable-rpc=true',
+ `--rpc-listen-port=${port}`,
+ '--rpc-listen-all=true',
+ '--rpc-allow-origin-all=true',
+ '--async-dns=false',
+ '--enable-async-dns6=false',
+ '--max-connection-per-server=16',
+ '--split=16',
+ '--min-split-size=1M',
+ '--continue=true',
+ '--allow-overwrite=true',
+ '--auto-file-renaming=true',
+ '--check-certificate=false',
+ '--user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36',
+ '--enable-dht=true',
+ '--enable-dht6=true',
+ '--enable-peer-exchange=true',
+ '--bt-enable-lpd=true',
+ '--listen-port=6881-6999',
+ '--dht-listen-port=6881-6999',
+ '--bt-max-peers=128',
+ '--bt-tracker=udp://tracker.opentrackr.org:1337/announce,udp://open.stealth.si:80/announce,udp://tracker.torrent.eu.org:451/announce,udp://tracker.bittorrent.jp:8880/announce,udp://tracker.open-internet.nl:6969/announce,udp://tracker.zerobytes.xyz:1337/announce,udp://tracker.moeking.me:6969/announce,http://tracker.ipv6tracker.ru:80/announce',
+ '--file-allocation=' + (fileAlloc || 'none'),
+ `--dir=${saveDir}`,
+ '--force-save=true',
+ `--input-file=${sessionFilePath}`,
+ `--save-session=${sessionFilePath}`,
+ '--save-session-interval=2'
+ ];
+
+ if (secret) {
+ args.push(`--rpc-secret=${secret}`);
+ }
+
+ const sysProxy = getSystemProxy();
+ if (sysProxy) {
+ args.push(`--all-proxy=${sysProxy}`);
+ }
+
+ lastAria2Log = `[启动准备] 可执行文件: ${aria2Path}\n[启动参数]: ${args.join(' ')}\n----------------------------------------\n`;
+
+ try {
+ aria2Process = spawn(aria2Path, args, {
+ windowsHide: true,
+ detached: false
+ });
+
+ if (aria2Process.stderr) {
+ aria2Process.stderr.on('data', (d) => {
+ lastAria2Log += d.toString();
+ });
+ }
+ if (aria2Process.stdout) {
+ aria2Process.stdout.on('data', (d) => {
+ lastAria2Log += d.toString();
+ });
+ }
+
+ aria2Process.on('error', (err) => {
+ console.error('Aria2 启动异常:', err);
+ const codeStr = (err && err.code) ? `${err.code} ` : '';
+ const errnoStr = (err && err.errno) ? ` (errno=${err.errno})` : '';
+ lastAria2Log += `\n[Error] ${codeStr}${err.message}${errnoStr}`;
+ aria2Process = null;
+ });
+
+ aria2Process.on('exit', (code) => {
+ console.log(`Aria2 进程退出, code: ${code}`);
+ if (code !== 0 && code !== null) {
+ lastAria2Log += `\n[Exit] 进程非正常退出，退出码: ${code}`;
+ }
+ aria2Process = null;
+ });
+
+ // 启动握手：等待 RPC 就绪或进程退出（最长 5 秒），把真实启动结果返回给 UI，
+ // 避免 spawn 成功但进程随即崩溃（杀软拦截/端口被占/依赖缺失）时界面误报「已启动」
+ const spawnStartedAt = Date.now();
+ let spawnReady = false;
+ let spawnLastErr = null;
+ while (Date.now() - spawnStartedAt < 5000) {
+ if (aria2Process === null) break; // 进程已退出或 spawn 失败
+ try {
+ const v = await this.aria2Rpc({
+ jsonrpc: '2.0',
+ id: 'spawncheck',
+ method: 'aria2.getVersion',
+ params: secret ? [`token:${secret}`] : []
+ }, port);
+ if (v && v.version) {
+ spawnReady = true;
+ break;
+ }
+ } catch (e) {
+ spawnLastErr = e;
+ }
+ await new Promise(r => setTimeout(r, 300));
+ }
+
+ if (!spawnReady) {
+ // 进程启动失败或已退出，清理并返回带日志的明确错误
+ if (aria2Process) {
+ try { aria2Process.kill('SIGKILL'); } catch (e) {}
+ aria2Process = null;
+ }
+ const briefLog = lastAria2Log.split(/\r?\n/).filter(Boolean).slice(-10).join('\n');
+ return {
+ success: false,
+ error: 'startup_failed',
+ message: spawnLastErr ? spawnLastErr.message : '进程已退出但 RPC 未就绪',
+ log: briefLog || lastAria2Log
+ };
+ }
+
+ return {
+ success: true,
+ pid: aria2Process.pid,
+ port: port,
+ status: 'started'
+ };
+ } catch (err) {
+ lastAria2Log = err.message;
+ return { success: false, error: err.message };
+ }
+ },
+
+ getAria2Logs() {
+ if (!lastAria2Log) return '暂无后台控制台日志';
+ // 规范换行并消除连续 3 个以上的空白空行，防止诊断弹窗中出现大范围空白
+ let cleaned = lastAria2Log.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+ cleaned = cleaned.replace(/\n{3,}/g, '\n\n').trim();
+ if (cleaned.endsWith('----------------------------------------')) {
+ cleaned += '\n(引擎已正常就绪，暂无最新错误或控制台输出日志)';
+ }
+ return cleaned || '暂无后台控制台日志';
+ },
+
+ stopAria2() {
+ killAria2Process();
+ return true;
+ },
+
+ restartAria2(options = {}) {
+ killAria2Process();
+ return this.startAria2(options);
+ },
+
+ isAria2Running() {
+ return !!(aria2Process && !aria2Process.killed);
+ },
+
+ getAria2BinaryStatus() {
+ const aria2Path = resolveAria2Path();
+ return {
+ found: !!aria2Path,
+ path: aria2Path || ''
+ };
+ },
+
+ // ---------- 2. 数据库读写 (持久化设置与任务) ----------
+ dbGet(key) {
+ try {
+ if (ztools.dbStorage) {
+ return ztools.dbStorage.getItem(key);
+ }
+ return localStorage.getItem(key);
+ } catch (e) {
+ return null;
+ }
+ },
+
+ dbSet(key, val) {
+ try {
+ if (ztools.dbStorage) {
+ ztools.dbStorage.setItem(key, val);
+ } else {
+ localStorage.setItem(key, val);
+ }
+ return true;
+ } catch (e) {
+ return false;
+ }
+ },
+
+ // ---------- 3. 系统路径与文件操作 ----------
+ getDefaultDownloadDir() {
+ return path.join(os.homedir(), 'Downloads');
+ },
+
+ // 打开所在文件夹或定位文件 (精确高亮选中目标文件)
+ openInExplorer(filePath, defaultSaveDir) {
+ if (!filePath) return false;
+ try {
+ let targetPath = String(filePath).trim();
+ const baseDir = defaultSaveDir || path.join(os.homedir(), 'Downloads');
+
+ // 强制绝对路径解析：若路径不是带盘符的绝对路径 (如 C:\)，自动与目标下载目录拼接
+ if (!/^[a-zA-Z]:[\\/]|^\\\\/.test(targetPath)) {
+ targetPath = path.join(baseDir, targetPath);
+ }
+
+ targetPath = path.normalize(targetPath).replace(/\//g, '\\');
+
+ // 如果目标未下载完成，但存在 .aria2 临时文件，则精确定位至 .aria2 临时文件
+ let checkPath = targetPath;
+ if (!fs.existsSync(checkPath) && fs.existsSync(checkPath + '.aria2')) {
+ checkPath = checkPath + '.aria2';
+ }
+
+ // 优先使用 Electron 原生 shell.showItemInFolder API (最精准高亮)
+ try {
+ const { shell } = require('electron');
+ if (shell && typeof shell.showItemInFolder === 'function') {
+ if (fs.existsSync(checkPath)) {
+ shell.showItemInFolder(checkPath);
+ return true;
+ }
+ }
+ } catch (e) {}
+
+ // CMD 命令降级备用
+ if (fs.existsSync(checkPath)) {
+ const stat = fs.statSync(checkPath);
+ if (stat.isDirectory()) {
+ exec(`explorer.exe "${checkPath}"`);
+ } else {
+ exec(`explorer.exe /select,"${checkPath}"`);
+ }
+ return true;
+ } else {
+ let parentDir = path.dirname(targetPath);
+ if (!fs.existsSync(parentDir)) {
+ parentDir = baseDir;
+ }
+ if (fs.existsSync(parentDir)) {
+ exec(`explorer.exe "${parentDir.replace(/\//g, '\\')}"`);
+ return true;
+ }
+ }
+ } catch (e) {
+ console.error('打开 Explorer 异常:', e);
+ }
+ return false;
+ },
+
+ // 选择文件夹
+ selectFolder(defaultPath) {
+ if (ztools.showOpenDialog) {
+ const result = ztools.showOpenDialog({
+ properties: ['openDirectory'],
+ defaultPath: defaultPath || this.getDefaultDownloadDir()
+ });
+ if (result && result.length > 0) return result[0];
+ return null;
+ }
+ if (typeof utools !== 'undefined' && utools.showOpenDialog) {
+ const result = utools.showOpenDialog({
+ properties: ['openDirectory'],
+ defaultPath: defaultPath || this.getDefaultDownloadDir()
+ });
+ if (result && result.length > 0) return result[0];
+ return null;
+ }
+ try {
+ const { dialog } = require('electron');
+ if (dialog && typeof dialog.showOpenDialogSync === 'function') {
+ const result = dialog.showOpenDialogSync({
+ properties: ['openDirectory'],
+ defaultPath: defaultPath || this.getDefaultDownloadDir()
+ });
+ if (result && result.length > 0) return result[0];
+ return null;
+ }
+ } catch (e) {}
+
+ // PowerShell 目录选择框降级备用
+ try {
+ const psScript = `
+ Add-Type -AssemblyName System.Windows.Forms
+ $dialog = New-Object System.Windows.Forms.FolderBrowserDialog
+ $dialog.SelectedPath = '${(defaultPath || '').replace(/'/g, "''")}'
+ if ($dialog.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK) {
+ Write-Output $dialog.SelectedPath
+ }
+ `;
+ const res = execSync(`powershell -NoProfile -ExecutionPolicy Bypass -Command "${psScript.replace(/\n/g, ' ')}"`, { encoding: 'utf8' });
+ return res ? res.trim() : null;
+ } catch (e) {
+ return null;
+ }
+ },
+
+ // 删除本地文件
+ removeLocalFile(filePath) {
+ try {
+ if (fs.existsSync(filePath)) {
+ fs.unlinkSync(filePath);
+ return true;
+ }
+ } catch (e) {
+ console.error('删除文件失败:', e);
+ }
+ return false;
+ },
+
+ // 获取磁盘剩余空闲空间 (字节)
+ getDiskFreeSpace(dirPath) {
+ try {
+ const targetPath = dirPath || os.homedir();
+ let checkDir = targetPath;
+ while (checkDir && !fs.existsSync(checkDir)) {
+ const parent = path.dirname(checkDir);
+ if (parent === checkDir) break;
+ checkDir = parent;
+ }
+ const stats = fs.statfsSync(checkDir || 'C:\\');
+ const freeBytes = Number(BigInt(stats.bsize) * BigInt(stats.bavail));
+ return { success: true, freeBytes, dir: checkDir };
+ } catch (e) {
+ return { success: false, error: e.message, freeBytes: Infinity };
+ }
+ },
+
+ // ---------- 4. 剪贴板与系统通知 ----------
+ getClipboardText() {
+ try {
+ if (ztools.readClipboardText) {
+ return ztools.readClipboardText();
+ }
+ if (typeof utools !== 'undefined' && utools.readClipboardText) {
+ return utools.readClipboardText();
+ }
+ // Electron 原生剪贴板读取 (极速 0 延迟)
+ try {
+ const { clipboard } = require('electron');
+ if (clipboard && typeof clipboard.readText === 'function') {
+ return clipboard.readText();
+ }
+ } catch (e) {}
+
+ return '';
+ } catch (e) {
+ return '';
+ }
+ },
+
+ showNotification(title, body) {
+ try {
+ if (ztools.showNotification) {
+ ztools.showNotification(body, title);
+ } else if (window.Notification && Notification.permission === 'granted') {
+ new Notification(title, { body });
+ }
+ } catch (e) {}
+ }
+};