@zshuangmu/agenthub 0.1.6 → 0.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zshuangmu/agenthub",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "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,24 @@ import {
   formatVersionsOutput,
 } from "./index.js";
 
-const VERSION = "0.1.3";
+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(message);
+    process.exitCode = 1;
+    return false;
+  }
+  return true;
+}
 
 function printHelp() {
   console.log(`
@@ -43,6 +62,7 @@ AgentHub v${VERSION} - AI Agent 打包与分发平台
   search      搜索 Registry 中的 Agent
   info        查看 Agent 详情
   list        列出当前目录/指定目录的已安装 Agent
+  verify      校验已安装 Agent 是否完整可用
   versions    查看 Agent 版本历史
   update      更新已安装 Agent 到最新版
   rollback    回滚已安装 Agent 到指定版本
@@ -147,45 +167,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 统计信息
@@ -283,22 +324,14 @@ async function main() {
       }
 
       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}`);
         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}`);
         return;
@@ -318,11 +351,7 @@ async function main() {
       }
 
       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(`   ${result.description}`);
@@ -336,11 +365,7 @@ async function main() {
       }
 
       case "install": {
-        if (!rest[0]) {
-          console.error("错误: 需要指定 agent slug");
-          process.exitCode = 1;
-          return;
-        }
+        if (!requireArg(rest[0], "错误: 需要指定 agent slug")) return;
         console.log(`\n📥 正在安装 ${rest[0]}...\n`);
         const installResult = await installCommand(rest[0], options);
         console.log(`✓ 已安装 ${installResult.manifest.slug}@${installResult.manifest.version}`);
@@ -354,45 +379,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;

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) {

package/src/commands/update.js

@@ -4,17 +4,16 @@
  */
 
 import path from "node:path";
-import { pathExists, readJson, writeJson } from "../lib/fs-utils.js";
-import { installBundle } from "../lib/install.js";
+import { getCurrentVersion, performVersionChange } from "../lib/version-manager.js";
+import { parseSpec } from "../lib/registry.js";
 import { versionsCommand } from "./versions.js";
 
-export async function updateCommand(agentSpec, options) {
-  const registryDir = path.resolve(options.registry);
+export async function updateCommand(agentSpec, options = {}) {
   const targetWorkspace = options.targetWorkspace ? path.resolve(options.targetWorkspace) : null;
-  const [slug] = agentSpec.split(":");
+  const { slug } = parseSpec(agentSpec);
 
   // 获取可用版本
-  const versions = await versionsCommand(slug, { registry: registryDir });
+  const versions = await versionsCommand(slug, options);
   if (versions.length === 0) {
     throw new Error(`Agent not found: ${slug}`);
   }
@@ -22,14 +21,7 @@ export async function updateCommand(agentSpec, options) {
   const latestVersion = versions[0].version;
 
   // 获取当前安装版本
-  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);
 
   if (currentVersion === latestVersion) {
     return {
@@ -41,22 +33,7 @@ export async function updateCommand(agentSpec, options) {
   }
 
   // 执行更新
-  const result = await installBundle({
-    registryDir,
-    agentSpec: `${slug}:${latestVersion}`,
-    targetWorkspace,
-  });
-
-  // 记录更新
-  if (targetWorkspace) {
-    const installRecordPath = path.join(targetWorkspace, ".agenthub", "install.json");
-    await writeJson(installRecordPath, {
-      slug,
-      version: latestVersion,
-      updatedAt: new Date().toISOString(),
-      previousVersion: currentVersion,
-    });
-  }
+  const result = await performVersionChange(slug, latestVersion, currentVersion, targetWorkspace, options);
 
   return {
     updated: true,

package/src/commands/verify.js

@@ -0,0 +1,94 @@
+import path from "node:path";
+import { pathExists, readJson } from "../lib/fs-utils.js";
+import { parseSpec } from "../lib/registry.js";
+import { infoCommand } from "./info.js";
+
+export async function verifyCommand(agentSpec, options = {}) {
+  const targetWorkspace = path.resolve(options.targetWorkspace || process.cwd());
+  const installRecordPath = path.join(targetWorkspace, ".agenthub", "install.json");
+  const appliedConfigPath = path.join(targetWorkspace, ".agenthub", "OPENCLAW.applied.json");
+
+  const checks = [];
+
+  if (!(await pathExists(installRecordPath))) {
+    return {
+      ok: false,
+      verified: false,
+      targetWorkspace,
+      reason: "install record missing",
+      checks: [{ name: "install_record", ok: false, detail: installRecordPath }],
+    };
+  }
+
+  const installRecord = await readJson(installRecordPath);
+  const expectedSlug = agentSpec ? parseSpec(agentSpec).slug : installRecord.slug;
+  if (expectedSlug && installRecord.slug !== expectedSlug) {
+    checks.push({
+      name: "slug_match",
+      ok: false,
+      detail: `installed=${installRecord.slug}, expected=${expectedSlug}`,
+    });
+    return {
+      ok: false,
+      verified: false,
+      targetWorkspace,
+      installRecord,
+      checks,
+      reason: "installed slug mismatch",
+    };
+  }
+
+  checks.push({ name: "install_record", ok: true, detail: installRecordPath });
+
+  const configExists = await pathExists(appliedConfigPath);
+  checks.push({ name: "applied_config", ok: configExists, detail: appliedConfigPath });
+
+  let manifest = null;
+  try {
+    manifest = await infoCommand(`${installRecord.slug}:${installRecord.version}`, options);
+    checks.push({ name: "manifest_lookup", ok: true, detail: `${installRecord.slug}@${installRecord.version}` });
+  } catch (error) {
+    checks.push({
+      name: "manifest_lookup",
+      ok: false,
+      detail: error.message,
+    });
+  }
+
+  const requiredFiles = ["AGENTS.md", "SOUL.md", "USER.md"];
+  for (const fileName of requiredFiles) {
+    const filePath = path.join(targetWorkspace, fileName);
+    checks.push({
+      name: `workspace_file:${fileName}`,
+      ok: await pathExists(filePath),
+      detail: filePath,
+    });
+  }
+
+  const verified = checks.every((check) => check.ok);
+  return {
+    ok: verified,
+    verified,
+    targetWorkspace,
+    installRecord,
+    manifest,
+    checks,
+  };
+}
+
+export function formatVerifyOutput(result) {
+  const lines = [];
+  lines.push(`\n${result.verified ? "✅" : "❌"} Verify ${result.verified ? "passed" : "failed"}\n`);
+  if (result.installRecord) {
+    lines.push(`Agent: ${result.installRecord.slug}@${result.installRecord.version}`);
+  }
+  lines.push(`Workspace: ${result.targetWorkspace}`);
+  lines.push("");
+  for (const check of result.checks || []) {
+    lines.push(`- ${check.ok ? "PASS" : "FAIL"} ${check.name}: ${check.detail}`);
+  }
+  if (result.reason) {
+    lines.push(`\nReason: ${result.reason}`);
+  }
+  return lines.join("\n");
+}