@zshuangmu/agenthub 0.3.0 → 0.3.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zshuangmu/agenthub",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "AI Agent 打包与分发平台 - 一句话打包上传，一键下载获得能力",
   "type": "module",
   "main": "src/index.js",

package/src/cli.js

@@ -489,6 +489,26 @@ async function main() {
     const causeMsg = err.cause?.errors?.[0]?.message || err.cause?.message || "";
     const detailMsg = causeMsg ? `${err.message}\n   原因: ${causeMsg}` : err.message;
     console.error(`\n${error(`${symbols.error} 错误:`)} ${detailMsg}`);
+
+    // 提供友好的解决建议
+    const errMsg = err.message.toLowerCase();
+    if (errMsg.includes("not found") || errMsg.includes("does not exist") || errMsg.includes("enoent")) {
+      console.log(`\n${warning("建议:")}`);
+      console.log(`  - 检查文件路径是否正确`);
+      console.log(`  - 确认 workspace 目录存在`);
+      console.log(`  - 运行 ${highlight("agenthub --help")} 查看命令用法`);
+    } else if (errMsg.includes("permission") || errMsg.includes("eacces")) {
+      console.log(`\n${warning("建议:")}`);
+      console.log(`  - 检查文件权限`);
+      console.log(`  - 尝试使用 ${highlight("sudo")} 命令`);
+    } else if (errMsg.includes("network") || errMsg.includes("econnrefused") || errMsg.includes("timeout")) {
+      console.log(`\n${warning("建议:")}`);
+      console.log(`  - 检查网络连接`);
+      console.log(`  - 确认服务器地址正确`);
+      console.log(`  - 使用 ${highlight("--registry")} 指定本地 registry`);
+    }
+
+    console.log(`\n${muted("如需更多帮助，运行: agenthub <command> --help")}`);
     process.exitCode = 1;
   }
 }

package/src/lib/debug.js

@@ -0,0 +1,115 @@
+/**
+ * Debug Logger
+ * 性能日志工具，用于调试和性能分析
+ */
+
+const DEBUG = process.env.AGENTHUB_DEBUG === "true" || process.env.AGENTHUB_DEBUG === "1";
+
+/**
+ * 计时器存储
+ */
+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,
+};