@zshuangmu/agenthub 0.4.14 → 0.4.16

package/src/lib/debug.js

@@ -1,135 +1,135 @@
-/**
- * Debug Logger
- * 性能日志工具，用于调试和性能分析
- */
-
-let verboseMode = false;
-
-/**
- * 设置 verbose 模式
- * @param {boolean} enabled - 是否启用
- */
-export function setVerbose(enabled) {
-  verboseMode = enabled;
-  if (enabled) {
-    process.env.AGENTHUB_DEBUG = "true";
-  }
-}
-
-/**
- * 获取是否处于 debug 模式
- */
-export function isDebug() {
-  return verboseMode || process.env.AGENTHUB_DEBUG === "true" || process.env.AGENTHUB_DEBUG === "1";
-}
-
-const DEBUG = isDebug();
-
-/**
- * 计时器存储
- */
-const timers = new Map();
-
-/**
- * 开始计时
- * @param {string} label - 计时标签
- */
-export function time(label) {
-  if (!DEBUG) return;
-  timers.set(label, Date.now());
-}
-
-/**
- * 结束计时并输出
- * @param {string} label - 计时标签
- * @returns {number|null} 耗时毫秒数
- */
-export function timeEnd(label) {
-  if (!DEBUG) return null;
-  const start = timers.get(label);
-  if (!start) return null;
-  const elapsed = Date.now() - start;
-  timers.delete(label);
-  console.log(`[DEBUG] ${label}: ${elapsed}ms`);
-  return elapsed;
-}
-
-/**
- * 输出调试日志
- * @param {string} message - 日志消息
- * @param {...any} args - 额外参数
- */
-export function debug(message, ...args) {
-  if (!DEBUG) return;
-  const timestamp = new Date().toISOString().split("T")[1].slice(0, 12);
-  console.log(`[DEBUG ${timestamp}] ${message}`, ...args);
-}
-
-/**
- * 输出警告日志
- * @param {string} message - 日志消息
- * @param {...any} args - 额外参数
- */
-export function warn(message, ...args) {
-  if (!DEBUG) return;
-  const timestamp = new Date().toISOString().split("T")[1].slice(0, 12);
-  console.warn(`[WARN ${timestamp}] ${message}`, ...args);
-}
-
-/**
- * 输出错误日志
- * @param {string} message - 日志消息
- * @param {...any} args - 额外参数
- */
-export function error(message, ...args) {
-  if (!DEBUG) return;
-  const timestamp = new Date().toISOString().split("T")[1].slice(0, 12);
-  console.error(`[ERROR ${timestamp}] ${message}`, ...args);
-}
-
-/**
- * 性能追踪装饰器
- * @param {string} label - 标签
- * @param {Function} fn - 要执行的函数
- * @returns {any} 函数执行结果
- */
-export async function trace(label, fn) {
-  time(label);
-  try {
-    const result = await fn();
-    timeEnd(label);
-    return result;
-  } catch (err) {
-    timeEnd(label);
-    throw err;
-  }
-}
-
-/**
- * 同步版本的性能追踪
- * @param {string} label - 标签
- * @param {Function} fn - 要执行的函数
- * @returns {any} 函数执行结果
- */
-export function traceSync(label, fn) {
-  time(label);
-  try {
-    const result = fn();
-    timeEnd(label);
-    return result;
-  } catch (err) {
-    timeEnd(label);
-    throw err;
-  }
-}
-
-export default {
-  DEBUG,
-  time,
-  timeEnd,
-  debug,
-  warn,
-  error,
-  trace,
-  traceSync,
-};
+/**
+ * Debug Logger
+ * 性能日志工具，用于调试和性能分析
+ */
+
+let verboseMode = false;
+
+/**
+ * 设置 verbose 模式
+ * @param {boolean} enabled - 是否启用
+ */
+export function setVerbose(enabled) {
+  verboseMode = enabled;
+  if (enabled) {
+    process.env.AGENTHUB_DEBUG = "true";
+  }
+}
+
+/**
+ * 获取是否处于 debug 模式
+ */
+export function isDebug() {
+  return verboseMode || process.env.AGENTHUB_DEBUG === "true" || process.env.AGENTHUB_DEBUG === "1";
+}
+
+const DEBUG = isDebug();
+
+/**
+ * 计时器存储
+ */
+const timers = new Map();
+
+/**
+ * 开始计时
+ * @param {string} label - 计时标签
+ */
+export function time(label) {
+  if (!DEBUG) return;
+  timers.set(label, Date.now());
+}
+
+/**
+ * 结束计时并输出
+ * @param {string} label - 计时标签
+ * @returns {number|null} 耗时毫秒数
+ */
+export function timeEnd(label) {
+  if (!DEBUG) return null;
+  const start = timers.get(label);
+  if (!start) return null;
+  const elapsed = Date.now() - start;
+  timers.delete(label);
+  console.log(`[DEBUG] ${label}: ${elapsed}ms`);
+  return elapsed;
+}
+
+/**
+ * 输出调试日志
+ * @param {string} message - 日志消息
+ * @param {...any} args - 额外参数
+ */
+export function debug(message, ...args) {
+  if (!DEBUG) return;
+  const timestamp = new Date().toISOString().split("T")[1].slice(0, 12);
+  console.log(`[DEBUG ${timestamp}] ${message}`, ...args);
+}
+
+/**
+ * 输出警告日志
+ * @param {string} message - 日志消息
+ * @param {...any} args - 额外参数
+ */
+export function warn(message, ...args) {
+  if (!DEBUG) return;
+  const timestamp = new Date().toISOString().split("T")[1].slice(0, 12);
+  console.warn(`[WARN ${timestamp}] ${message}`, ...args);
+}
+
+/**
+ * 输出错误日志
+ * @param {string} message - 日志消息
+ * @param {...any} args - 额外参数
+ */
+export function error(message, ...args) {
+  if (!DEBUG) return;
+  const timestamp = new Date().toISOString().split("T")[1].slice(0, 12);
+  console.error(`[ERROR ${timestamp}] ${message}`, ...args);
+}
+
+/**
+ * 性能追踪装饰器
+ * @param {string} label - 标签
+ * @param {Function} fn - 要执行的函数
+ * @returns {any} 函数执行结果
+ */
+export async function trace(label, fn) {
+  time(label);
+  try {
+    const result = await fn();
+    timeEnd(label);
+    return result;
+  } catch (err) {
+    timeEnd(label);
+    throw err;
+  }
+}
+
+/**
+ * 同步版本的性能追踪
+ * @param {string} label - 标签
+ * @param {Function} fn - 要执行的函数
+ * @returns {any} 函数执行结果
+ */
+export function traceSync(label, fn) {
+  time(label);
+  try {
+    const result = fn();
+    timeEnd(label);
+    return result;
+  } catch (err) {
+    timeEnd(label);
+    throw err;
+  }
+}
+
+export default {
+  DEBUG,
+  time,
+  timeEnd,
+  debug,
+  warn,
+  error,
+  trace,
+  traceSync,
+};

package/src/lib/fs-utils.js

@@ -1,50 +1,107 @@
-import { cp, mkdir, readdir, readFile, rm, stat, writeFile } from "node:fs/promises";
-import path from "node:path";
-
-export async function ensureDir(dirPath) {
-  await mkdir(dirPath, { recursive: true });
-}
-
-export async function copyDir(source, destination) {
-  await ensureDir(path.dirname(destination));
-  await cp(source, destination, { recursive: true });
-}
-
-export async function readJson(filePath) {
-  return JSON.parse(await readFile(filePath, "utf8"));
-}
-
-export async function writeJson(filePath, value) {
-  await ensureDir(path.dirname(filePath));
-  await writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
-}
-
-export async function pathExists(targetPath) {
-  try {
-    await stat(targetPath);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-export async function removeDir(dirPath) {
-  await rm(dirPath, { recursive: true, force: true });
-}
-
-export async function countFiles(dirPath) {
-  if (!(await pathExists(dirPath))) {
-    return 0;
-  }
-  const entries = await readdir(dirPath, { withFileTypes: true });
-  let total = 0;
-  for (const entry of entries) {
-    const fullPath = path.join(dirPath, entry.name);
-    if (entry.isDirectory()) {
-      total += await countFiles(fullPath);
-    } else {
-      total += 1;
-    }
-  }
-  return total;
-}
+import { cp, mkdir, readdir, readFile, rm, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+
+export async function ensureDir(dirPath) {
+  await mkdir(dirPath, { recursive: true });
+}
+
+export async function copyDir(source, destination) {
+  await ensureDir(path.dirname(destination));
+  await cp(source, destination, { recursive: true });
+}
+
+/**
+ * 带过滤的目录复制
+ * @param {string} source - 源目录
+ * @param {string} destination - 目标目录
+ * @param {object} options - 过滤选项
+ * @param {string[]} [options.excludeDirs] - 排除的目录名/相对路径
+ * @param {string[]} [options.excludeFiles] - 排除的文件名
+ * @param {number} [options.maxFileSize] - 跳过超过此大小(字节)的文件
+ * @returns {Promise<{copied: string[], skipped: string[]}>} 复制报告
+ */
+export async function copyDirFiltered(source, destination, options = {}) {
+  const { excludeDirs = [], excludeFiles = [], maxFileSize = 50 * 1024 * 1024 } = options;
+  const report = { copied: [], skipped: [] };
+
+  async function walkAndCopy(srcDir, destDir, relativeBase = "") {
+    await ensureDir(destDir);
+    const entries = await readdir(srcDir, { withFileTypes: true });
+
+    for (const entry of entries) {
+      const srcPath = path.join(srcDir, entry.name);
+      const destPath = path.join(destDir, entry.name);
+      const relativePath = relativeBase ? `${relativeBase}/${entry.name}` : entry.name;
+
+      if (entry.isDirectory()) {
+        // 检查是否在排除目录列表中（匹配目录名或相对路径）
+        const shouldExclude = excludeDirs.some((pattern) => {
+          const normalized = pattern.replace(/\\/g, "/");
+          return entry.name === normalized || relativePath === normalized || relativePath.startsWith(`${normalized}/`);
+        });
+        if (shouldExclude) {
+          report.skipped.push(relativePath);
+          continue;
+        }
+        await walkAndCopy(srcPath, destPath, relativePath);
+      } else if (entry.isFile()) {
+        // 检查排除文件名
+        if (excludeFiles.includes(entry.name)) {
+          report.skipped.push(relativePath);
+          continue;
+        }
+        // 检查文件大小
+        const fileStat = await stat(srcPath);
+        if (fileStat.size > maxFileSize) {
+          report.skipped.push(relativePath);
+          continue;
+        }
+        await ensureDir(path.dirname(destPath));
+        await cp(srcPath, destPath);
+        report.copied.push(relativePath);
+      }
+    }
+  }
+
+  await walkAndCopy(source, destination);
+  return report;
+}
+
+export async function readJson(filePath) {
+  return JSON.parse(await readFile(filePath, "utf8"));
+}
+
+export async function writeJson(filePath, value) {
+  await ensureDir(path.dirname(filePath));
+  await writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+
+export async function pathExists(targetPath) {
+  try {
+    await stat(targetPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export async function removeDir(dirPath) {
+  await rm(dirPath, { recursive: true, force: true });
+}
+
+export async function countFiles(dirPath) {
+  if (!(await pathExists(dirPath))) {
+    return 0;
+  }
+  const entries = await readdir(dirPath, { withFileTypes: true });
+  let total = 0;
+  for (const entry of entries) {
+    const fullPath = path.join(dirPath, entry.name);
+    if (entry.isDirectory()) {
+      total += await countFiles(fullPath);
+    } else {
+      total += 1;
+    }
+  }
+  return total;
+}