@zshuangmu/agenthub 0.1.6 → 0.1.8

package/package.json

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

package/src/api-server.js

@@ -23,6 +23,30 @@ const RATE_LIMIT_MAX = parseInt(process.env.RATE_LIMIT_MAX || "100", 10); // 100
 
 // 简单的速率限制器
 const rateLimiter = new Map();
+let cleanupInterval = null;
+
+function startRateLimiterCleanup() {
+  if (cleanupInterval) return;
+  cleanupInterval = setInterval(() => {
+    const now = Date.now();
+    const windowStart = now - RATE_LIMIT_WINDOW;
+    for (const [ip, requests] of rateLimiter.entries()) {
+      const recentRequests = requests.filter(t => t > windowStart);
+      if (recentRequests.length === 0) {
+        rateLimiter.delete(ip);
+      } else if (recentRequests.length !== requests.length) {
+        rateLimiter.set(ip, recentRequests);
+      }
+    }
+  }, RATE_LIMIT_WINDOW);
+}
+
+function stopRateLimiterCleanup() {
+  if (cleanupInterval) {
+    clearInterval(cleanupInterval);
+    cleanupInterval = null;
+  }
+}
 
 function checkRateLimit(ip) {
   const now = Date.now();
@@ -203,6 +227,7 @@ export async function createApiServer({ registryDir, port = 3000 }) {
     }
   });
 
+  startRateLimiterCleanup();
   await new Promise((resolve) => server.listen(port, "0.0.0.0", resolve));
   const address = server.address();
   const actualPort = typeof address === "object" && address ? address.port : port;
@@ -211,6 +236,9 @@ export async function createApiServer({ registryDir, port = 3000 }) {
     server,
     port: actualPort,
     baseUrl: `http://127.0.0.1:${actualPort}`,
-    close: () => new Promise((resolve, reject) => server.close((error) => (error ? reject(error) : resolve()))),
+    close: () => new Promise((resolve, reject) => {
+      stopRateLimiterCleanup();
+      server.close((error) => (error ? reject(error) : resolve()));
+    }),
   };
 }

package/src/cli.js

@@ -9,6 +9,8 @@
 import {
   infoCommand,
   installCommand,
+  verifyCommand,
+  formatVerifyOutput,
   packCommand,
   publishCommand,
   publishRemoteCommand,
@@ -26,7 +28,26 @@ import {
   formatVersionsOutput,
 } from "./index.js";
 
-const VERSION = "0.1.3";
+import { success, error, warning, info as infoColor, highlight, muted, symbols } from "./lib/colors.js";
+
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const VERSION = require("../package.json").version;
+
+/**
+ * 验证必需参数，如果缺失则打印错误并设置退出码
+ * @param {string} arg - 要验证的参数
+ * @param {string} message - 错误消息
+ * @returns {boolean} 参数是否存在
+ */
+function requireArg(arg, message) {
+  if (!arg) {
+    console.error(error(message));
+    process.exitCode = 1;
+    return false;
+  }
+  return true;
+}
 
 function printHelp() {
   console.log(`
@@ -43,6 +64,7 @@ AgentHub v${VERSION} - AI Agent 打包与分发平台
   search      搜索 Registry 中的 Agent
   info        查看 Agent 详情
   list        列出当前目录/指定目录的已安装 Agent
+  verify      校验已安装 Agent 是否完整可用
   versions    查看 Agent 版本历史
   update      更新已安装 Agent 到最新版
   rollback    回滚已安装 Agent 到指定版本
@@ -147,45 +169,66 @@ agenthub list - 列出已安装 Agent
 示例:
   agenthub list
   agenthub list --target-workspace ./my-workspace
+`,
+    verify: `
+agenthub verify - 校验已安装 Agent
+
+用法:
+  agenthub verify [agent-slug] [--registry <dir> | --server <url>] [--target-workspace <dir>]
+
+选项:
+  --registry <dir>          本地 Registry 目录（与 --server 二选一）
+  --server <url>            远程服务器地址（默认: https://agenthub.cyou）
+  --target-workspace <dir>  目标工作区目录（默认当前目录）
+
+示例:
+  agenthub verify workspace --registry ./.registry --target-workspace ./my-workspace
+  agenthub verify workspace --server https://agenthub.cyou --target-workspace ./my-workspace
 `,
     versions: `
 agenthub versions - 查看版本历史
 
 用法:
-  agenthub versions <agent-slug> --registry <dir>
+  agenthub versions <agent-slug> [--registry <dir> | --server <url>]
 
 选项:
-  --registry <dir>    Registry 目录 (必需)
+  --registry <dir>          本地 Registry 目录（与 --server 二选一）
+  --server <url>            远程服务器地址（默认: https://agenthub.cyou）
 
 示例:
   agenthub versions workspace --registry ./.registry
+  agenthub versions workspace --server https://agenthub.cyou
 `,
     update: `
 agenthub update - 更新 Agent 到最新版
 
 用法:
-  agenthub update <agent-slug> --registry <dir> --target-workspace <dir>
+  agenthub update <agent-slug> [--registry <dir> | --server <url>] --target-workspace <dir>
 
 选项:
-  --registry <dir>          Registry 目录 (必需)
+  --registry <dir>          本地 Registry 目录（与 --server 二选一）
+  --server <url>            远程服务器地址（默认: https://agenthub.cyou）
   --target-workspace <dir>  目标工作区目录 (必需)
 
 示例:
   agenthub update workspace --registry ./.registry --target-workspace ./my-workspace
+  agenthub update workspace --server https://agenthub.cyou --target-workspace ./my-workspace
 `,
     rollback: `
 agenthub rollback - 回滚 Agent 到指定版本
 
 用法:
-  agenthub rollback <agent-slug> --to <version> --registry <dir> --target-workspace <dir>
+  agenthub rollback <agent-slug> --to <version> [--registry <dir> | --server <url>] --target-workspace <dir>
 
 选项:
   --to <version>            目标版本 (必需)
-  --registry <dir>          Registry 目录 (必需)
+  --registry <dir>          本地 Registry 目录（与 --server 二选一）
+  --server <url>            远程服务器地址（默认: https://agenthub.cyou）
   --target-workspace <dir>  目标工作区目录 (必需)
 
 示例:
   agenthub rollback workspace --to 1.0.0 --registry ./.registry --target-workspace ./my-workspace
+  agenthub rollback workspace --to 1.0.0 --server https://agenthub.cyou --target-workspace ./my-workspace
 `,
     stats: `
 agenthub stats - 查看 Agent 统计信息
@@ -272,79 +315,63 @@ async function main() {
     switch (command) {
       case "pack": {
         if (!options.workspace || !options.config) {
-          console.error("错误: --workspace 和 --config 是必需的");
-          console.log("\n运行 'agenthub pack --help' 查看帮助");
+          console.error(error("错误: --workspace 和 --config 是必需的"));
+          console.log(muted("\n运行 'agenthub pack --help' 查看帮助"));
           process.exitCode = 1;
           return;
         }
         const result = await packCommand(options);
-        console.log(`✓ 打包完成: ${result.bundleDir}`);
+        console.log(success(`${symbols.success} 打包完成: ${result.bundleDir}`));
         return;
       }
 
       case "publish": {
-        if (!rest[0]) {
-          console.error("错误: 需要指定 bundle 目录");
-          process.exitCode = 1;
-          return;
-        }
+        if (!requireArg(rest[0], "错误: 需要指定 bundle 目录")) return;
         const result = await publishCommand(rest[0], options);
-        console.log(`✓ 已发布 ${result.slug}@${result.version}`);
+        console.log(success(`${symbols.success} 已发布 ${highlight(`${result.slug}@${result.version}`)}`));
         return;
       }
 
       case "publish-remote": {
-        if (!rest[0]) {
-          console.error("错误: 需要指定 bundle 目录");
-          process.exitCode = 1;
-          return;
-        }
+        if (!requireArg(rest[0], "错误: 需要指定 bundle 目录")) return;
         const result = await publishRemoteCommand(rest[0], options);
-        console.log(`✓ 已发布到远程 ${result.slug}@${result.version}`);
+        console.log(success(`${symbols.success} 已发布到远程 ${highlight(`${result.slug}@${result.version}`)}`));
         return;
       }
 
       case "search": {
         const results = await searchCommand(rest[0] || "", options);
         if (results.length === 0) {
-          console.log("未找到匹配的 Agent");
+          console.log(warning("未找到匹配的 Agent"));
         } else {
-          console.log(`\n找到 ${results.length} 个 Agent:\n`);
+          console.log(`\n${infoColor(`找到 ${results.length} 个 Agent:`)}\n`);
           for (const entry of results) {
-            console.log(`  ${entry.slug}@${entry.version} - ${entry.description || ""}`);
+            console.log(`  ${highlight(entry.slug)}${muted("@")}${entry.version} ${muted("-")} ${entry.description || ""}`);
           }
         }
         return;
       }
 
       case "info": {
-        if (!rest[0]) {
-          console.error("错误: 需要指定 agent slug");
-          process.exitCode = 1;
-          return;
-        }
+        if (!requireArg(rest[0], "错误: 需要指定 agent slug")) return;
         const result = await infoCommand(rest[0], options);
-        console.log(`\n📦 ${result.name} (${result.slug}@${result.version})`);
+        console.log(`\n${highlight("📦")} ${result.name} (${result.slug}@${result.version})`);
         console.log(`   ${result.description}`);
-        console.log(`   Runtime: ${result.runtime?.type || "openclaw"} ${result.runtime?.version || ""}`);
+        console.log(`   ${muted("Runtime:")} ${result.runtime?.type || "openclaw"} ${result.runtime?.version || ""}`);
         const mem = result.includes?.memory || {};
         if (mem.count > 0) {
-          console.log(`   Memory: ${mem.count} 条 (public: ${mem.public}, portable: ${mem.portable})`);
+          console.log(`   ${muted("Memory:")} ${mem.count} 条 (public: ${mem.public}, portable: ${mem.portable})`);
         }
-        console.log(`\n   安装命令: agenthub install ${result.slug}`);
+        console.log(`\n   ${infoColor("安装命令:")} agenthub install ${result.slug}`);
         return;
       }
 
       case "install": {
-        if (!rest[0]) {
-          console.error("错误: 需要指定 agent slug");
-          process.exitCode = 1;
-          return;
-        }
-        console.log(`\n📥 正在安装 ${rest[0]}...\n`);
+        if (!requireArg(rest[0], "错误: 需要指定 agent slug")) return;
+        console.log(`\n${infoColor("📥 正在安装")} ${highlight(rest[0])}...\n`);
         const installResult = await installCommand(rest[0], options);
-        console.log(`✓ 已安装 ${installResult.manifest.slug}@${installResult.manifest.version}`);
-        console.log(`  位置: ${options.targetWorkspace || "当前目录"}`);
+        console.log(success(`${symbols.success} 已安装 ${highlight(`${installResult.manifest.slug}@${installResult.manifest.version}`)}`));
+        console.log(`  ${muted("位置:")} ${options.targetWorkspace || "当前目录"}`);
         return;
       }
 
@@ -354,45 +381,38 @@ async function main() {
         return;
       }
 
-      case "versions": {
-        if (!rest[0]) {
-          console.error("错误: 需要指定 agent slug");
+      case "verify": {
+        const result = await verifyCommand(rest[0], options);
+        console.log(formatVerifyOutput(result));
+        if (!result.verified) {
           process.exitCode = 1;
-          return;
         }
+        return;
+      }
+
+      case "versions": {
+        if (!requireArg(rest[0], "错误: 需要指定 agent slug")) return;
         const versions = await versionsCommand(rest[0], options);
         console.log(formatVersionsOutput(rest[0], versions));
         return;
       }
 
       case "update": {
-        if (!rest[0]) {
-          console.error("错误: 需要指定 agent slug");
-          process.exitCode = 1;
-          return;
-        }
+        if (!requireArg(rest[0], "错误: 需要指定 agent slug")) return;
         const updateResult = await updateCommand(rest[0], options);
         console.log(updateResult.message);
         return;
       }
 
       case "rollback": {
-        if (!rest[0]) {
-          console.error("错误: 需要指定 agent slug");
-          process.exitCode = 1;
-          return;
-        }
+        if (!requireArg(rest[0], "错误: 需要指定 agent slug")) return;
         const rollbackResult = await rollbackCommand(rest[0], options);
         console.log(rollbackResult.message);
         return;
       }
 
       case "stats": {
-        if (!rest[0]) {
-          console.error("错误: 需要指定 agent slug");
-          process.exitCode = 1;
-          return;
-        }
+        if (!requireArg(rest[0], "错误: 需要指定 agent slug")) return;
         const stats = await statsCommand(rest[0], options);
         console.log(formatStatsOutput(stats));
         return;
@@ -400,11 +420,11 @@ async function main() {
 
       case "serve": {
         const result = await serveCommand(options);
-        console.log(`Server listening at ${result.baseUrl}`);
-        console.log(`\n🌐 AgentHub 服务已启动`);
-        console.log(`   地址: ${result.baseUrl}`);
-        console.log(`   API:  ${result.baseUrl}/api/agents`);
-        console.log(`\n按 Ctrl+C 停止服务\n`);
+        console.log(success(`Server listening at ${result.baseUrl}`));
+        console.log(`\n${highlight("🌐 AgentHub 服务已启动")}`);
+        console.log(`   ${muted("地址:")} ${result.baseUrl}`);
+        console.log(`   ${muted("API:")}  ${result.baseUrl}/api/agents`);
+        console.log(`\n${muted("按 Ctrl+C 停止服务")}\n`);
 
         const shutdown = async () => {
           process.off("SIGINT", shutdown);
@@ -420,12 +440,12 @@ async function main() {
       case "api": {
         const port = options.port || "3001";
         const result = await apiCommand({ ...options, port });
-        console.log(`Server listening at ${result.baseUrl}`);
-        console.log(`\n🔧 API 服务已启动`);
-        console.log(`   地址: ${result.baseUrl}`);
-        console.log(`   端点: ${result.baseUrl}/api/agents`);
-        console.log(`   统计: ${result.baseUrl}/api/stats`);
-        console.log(`\n按 Ctrl+C 停止服务\n`);
+        console.log(success(`Server listening at ${result.baseUrl}`));
+        console.log(`\n${highlight("🔧 API 服务已启动")}`);
+        console.log(`   ${muted("地址:")} ${result.baseUrl}`);
+        console.log(`   ${muted("端点:")} ${result.baseUrl}/api/agents`);
+        console.log(`   ${muted("统计:")} ${result.baseUrl}/api/stats`);
+        console.log(`\n${muted("按 Ctrl+C 停止服务")}\n`);
 
         const shutdown = async () => {
           process.off("SIGINT", shutdown);
@@ -442,11 +462,11 @@ async function main() {
         const port = options.port || "3000";
         const apiBase = options.apiBase || "http://127.0.0.1:3001";
         const result = await webCommand({ port, apiBase });
-        console.log(`Server listening at ${result.baseUrl}`);
-        console.log(`\n🌐 Web 服务已启动`);
-        console.log(`   地址: ${result.baseUrl}`);
-        console.log(`   API:  ${apiBase}`);
-        console.log(`\n按 Ctrl+C 停止服务\n`);
+        console.log(success(`Server listening at ${result.baseUrl}`));
+        console.log(`\n${highlight("🌐 Web 服务已启动")}`);
+        console.log(`   ${muted("地址:")} ${result.baseUrl}`);
+        console.log(`   ${muted("API:")}  ${apiBase}`);
+        console.log(`\n${muted("按 Ctrl+C 停止服务")}\n`);
 
         const shutdown = async () => {
           process.off("SIGINT", shutdown);
@@ -460,15 +480,15 @@ async function main() {
       }
 
       default:
-        console.error(`未知命令: ${command}`);
-        console.log("\n运行 'agenthub --help' 查看可用命令");
+        console.error(error(`未知命令: ${command}`));
+        console.log(muted("\n运行 'agenthub --help' 查看可用命令"));
         process.exitCode = 1;
     }
-  } catch (error) {
+  } catch (err) {
     // 提取更详细的错误信息
-    const causeMsg = error.cause?.errors?.[0]?.message || error.cause?.message || "";
-    const detailMsg = causeMsg ? `${error.message}\n   原因: ${causeMsg}` : error.message;
-    console.error(`\n❌ 错误: ${detailMsg}`);
+    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}`);
     process.exitCode = 1;
   }
 }

package/src/commands/info.js

@@ -1,6 +1,15 @@
 import path from "node:path";
-import { readAgentInfo } from "../lib/registry.js";
+import { readAgentInfo, parseSpec } from "../lib/registry.js";
+import { fetchRemoteJson } from "../lib/remote.js";
 
-export async function infoCommand(agentSpec, options) {
-  return readAgentInfo(path.resolve(options.registry), agentSpec);
+export async function infoCommand(agentSpec, options = {}) {
+  if (options.registry) {
+    return readAgentInfo(path.resolve(options.registry), agentSpec);
+  }
+
+  const { slug, version } = parseSpec(agentSpec);
+  const params = new URLSearchParams();
+  if (version) params.set("version", version);
+  const qs = params.toString();
+  return fetchRemoteJson(`/api/agents/${slug}${qs ? `?${qs}` : ""}`, options);
 }

package/src/commands/list.js

@@ -4,20 +4,7 @@
  */
 
 import path from "node:path";
-import { stat, readdir, readFile } from "node:fs/promises";
-
-async function pathExists(targetPath) {
-  try {
-    await stat(targetPath);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-async function readJson(filePath) {
-  return JSON.parse(await readFile(filePath, "utf8"));
-}
+import { pathExists, readJson } from "../lib/fs-utils.js";
 
 export async function listCommand(options = {}) {
   // 检查多个可能的安装位置

package/src/commands/rollback.js

@@ -4,12 +4,12 @@
  */
 
 import path from "node:path";
-import { pathExists, readJson, writeJson } from "../lib/fs-utils.js";
+import { getCurrentVersion, updateInstallRecord, buildInstallOptions } from "../lib/version-manager.js";
 import { installBundle } from "../lib/install.js";
+import { parseSpec } from "../lib/registry.js";
 import { versionsCommand } from "./versions.js";
 
-export async function rollbackCommand(agentSpec, options) {
-  const registryDir = path.resolve(options.registry);
+export async function rollbackCommand(agentSpec, options = {}) {
   const targetWorkspace = options.targetWorkspace ? path.resolve(options.targetWorkspace) : null;
   const targetVersion = options.to;
 
@@ -17,42 +17,27 @@ export async function rollbackCommand(agentSpec, options) {
     throw new Error("请指定回滚版本: --to <version>");
   }
 
-  const [slug] = agentSpec.split(":");
+  const { slug } = parseSpec(agentSpec);
 
   // 验证目标版本存在
-  const versions = await versionsCommand(slug, { registry: registryDir });
+  const versions = await versionsCommand(slug, options);
   const versionExists = versions.some((v) => v.version === targetVersion);
   if (!versionExists) {
     throw new Error(`版本 ${targetVersion} 不存在`);
   }
 
   // 获取当前版本
-  let currentVersion = null;
-  if (targetWorkspace) {
-    const installRecordPath = path.join(targetWorkspace, ".agenthub", "install.json");
-    if (await pathExists(installRecordPath)) {
-      const record = await readJson(installRecordPath);
-      currentVersion = record.version;
-    }
-  }
+  const currentVersion = await getCurrentVersion(targetWorkspace);
 
   // 执行回滚
-  const result = await installBundle({
-    registryDir,
-    agentSpec: `${slug}:${targetVersion}`,
-    targetWorkspace,
-  });
+  const installOptions = buildInstallOptions(slug, targetVersion, targetWorkspace, options);
+  const result = await installBundle(installOptions);
 
   // 记录回滚
-  if (targetWorkspace) {
-    const installRecordPath = path.join(targetWorkspace, ".agenthub", "install.json");
-    await writeJson(installRecordPath, {
-      slug,
-      version: targetVersion,
-      rolledBackAt: new Date().toISOString(),
-      rolledBackFrom: currentVersion,
-    });
-  }
+  await updateInstallRecord(targetWorkspace, slug, targetVersion, {
+    rolledBackAt: new Date().toISOString(),
+    rolledBackFrom: currentVersion,
+  });
 
   return {
     rolledBack: true,

package/src/commands/search.js

@@ -1,7 +1,14 @@
 import path from "node:path";
 import { searchRegistry } from "../lib/registry.js";
+import { fetchRemoteJson } from "../lib/remote.js";
 
-export async function searchCommand(query, options) {
-  const results = await searchRegistry(path.resolve(options.registry), query);
-  return results;
+export async function searchCommand(query, options = {}) {
+  if (options.registry) {
+    return searchRegistry(path.resolve(options.registry), query);
+  }
+
+  const params = new URLSearchParams();
+  if (query) params.set("q", query);
+  const result = await fetchRemoteJson(`/api/agents?${params.toString()}`, options);
+  return result.agents || [];
 }

package/src/commands/stats.js

@@ -5,11 +5,49 @@
 
 import path from "node:path";
 import { pathExists, readJson } from "../lib/fs-utils.js";
+import { fetchRemoteJson } from "../lib/remote.js";
+import { parseSpec, getLatestVersion } from "../lib/registry.js";
 
-export async function statsCommand(agentSpec, options) {
-  const registryDir = path.resolve(options.registry);
-  const [slug] = agentSpec.split(":");
+/**
+ * 构建统计返回对象的辅助函数
+ */
+function buildStatsResult(slug, manifest, agentEntries) {
+  const latestEntry = getLatestVersion(agentEntries);
+  return {
+    slug,
+    name: manifest.name,
+    latestVersion: latestEntry.version,
+    totalVersions: agentEntries.length,
+    description: manifest.description,
+    author: manifest.author,
+    runtime: manifest.runtime,
+    includes: manifest.includes,
+    requirements: manifest.requirements,
+    metadata: manifest.metadata,
+    downloads: manifest.downloads || 0,
+    stars: manifest.stats?.stars || 0,
+    rating: manifest.stats?.rating || null,
+  };
+}
+
+export async function statsCommand(agentSpec, options = {}) {
+  const { slug } = parseSpec(agentSpec);
+
+  if (!options.registry) {
+    const [manifest, agentsResult] = await Promise.all([
+      fetchRemoteJson(`/api/agents/${slug}`, options),
+      fetchRemoteJson(`/api/agents?q=${encodeURIComponent(slug)}`, options),
+    ]);
 
+    const agentEntries = (agentsResult.agents || []).filter((entry) => entry.slug === slug);
+    if (agentEntries.length === 0) {
+      throw new Error(`Agent not found: ${slug}`);
+    }
+
+    return buildStatsResult(slug, manifest, agentEntries);
+  }
+
+  const registryDir = path.resolve(options.registry);
   const indexPath = path.join(registryDir, "index.json");
   if (!(await pathExists(indexPath))) {
     throw new Error(`Agent not found: ${slug}`);
@@ -22,12 +60,7 @@ export async function statsCommand(agentSpec, options) {
     throw new Error(`Agent not found: ${slug}`);
   }
 
-  // 获取最新版本的完整信息
-  const latestEntry = agentEntries.sort((a, b) =>
-    b.version.localeCompare(a.version, undefined, { numeric: true })
-  )[0];
-
-  // 读取完整 MANIFEST
+  const latestEntry = getLatestVersion(agentEntries);
   const manifestPath = path.join(
     registryDir,
     "agents",
@@ -37,25 +70,7 @@ export async function statsCommand(agentSpec, options) {
   );
   const manifest = await readJson(manifestPath);
 
-  // 统计信息
-  const stats = {
-    slug,
-    name: manifest.name,
-    latestVersion: latestEntry.version,
-    totalVersions: agentEntries.length,
-    description: manifest.description,
-    author: manifest.author,
-    runtime: manifest.runtime,
-    includes: manifest.includes,
-    requirements: manifest.requirements,
-    metadata: manifest.metadata,
-    // 以下数据在实际系统中会从数据库获取
-    downloads: manifest.stats?.installs || 0,
-    stars: manifest.stats?.stars || 0,
-    rating: manifest.stats?.rating || null,
-  };
-
-  return stats;
+  return buildStatsResult(slug, manifest, agentEntries);
 }
 
 export function formatStatsOutput(stats) {