@zshuangmu/agenthub 0.1.2 → 0.1.4

package/README.md

@@ -86,6 +86,11 @@ Visit http://localhost:3000 to see your agents!
 | `search` | Search agents in registry |
 | `info` | View agent details |
 | `install` | Install agent to workspace |
+| `list` | List installed agents in workspace |
+| `versions` | List available versions for one agent |
+| `update` | Update installed agent to latest version |
+| `rollback` | Roll back an installed agent |
+| `stats` | View detailed statistics for an agent |
 | `serve` | Start web + API service |
 | `api` | Start API server only |
 | `web` | Start web frontend only |

package/package.json

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

package/src/cli.js

@@ -16,9 +16,17 @@ import {
   searchCommand,
   apiCommand,
   webCommand,
+  updateCommand,
+  rollbackCommand,
+  listCommand,
+  formatListOutput,
+  statsCommand,
+  formatStatsOutput,
+  versionsCommand,
+  formatVersionsOutput,
 } from "./index.js";
 
-const VERSION = "0.1.0";
+const VERSION = "0.1.3";
 
 function printHelp() {
   console.log(`
@@ -31,9 +39,14 @@ AgentHub v${VERSION} - AI Agent 打包与分发平台
   pack        打包 OpenClaw 工作区为 Agent Bundle
   publish     发布 Bundle 到本地 Registry
   publish-remote  发布 Bundle 到远程服务器
-  install     安装 Agent 到目标工作区
+  install     安装 Agent 到目标工作区（默认当前目录）
   search      搜索 Registry 中的 Agent
   info        查看 Agent 详情
+  list        列出当前目录/指定目录的已安装 Agent
+  versions    查看 Agent 版本历史
+  update      更新已安装 Agent 到最新版
+  rollback    回滚已安装 Agent 到指定版本
+  stats       查看 Agent 统计信息
   serve       启动 Web + API 服务
 
 选项:
@@ -121,6 +134,70 @@ agenthub search - 搜索 Agent
 示例:
   agenthub search "code review" --registry ./.registry
   agenthub search "" --registry ./.registry  # 列出所有
+`,
+    list: `
+agenthub list - 列出已安装 Agent
+
+用法:
+  agenthub list [--target-workspace <dir>]
+
+选项:
+  --target-workspace <dir>  指定工作区目录（可选）
+
+示例:
+  agenthub list
+  agenthub list --target-workspace ./my-workspace
+`,
+    versions: `
+agenthub versions - 查看版本历史
+
+用法:
+  agenthub versions <agent-slug> --registry <dir>
+
+选项:
+  --registry <dir>    Registry 目录 (必需)
+
+示例:
+  agenthub versions workspace --registry ./.registry
+`,
+    update: `
+agenthub update - 更新 Agent 到最新版
+
+用法:
+  agenthub update <agent-slug> --registry <dir> --target-workspace <dir>
+
+选项:
+  --registry <dir>          Registry 目录 (必需)
+  --target-workspace <dir>  目标工作区目录 (必需)
+
+示例:
+  agenthub update workspace --registry ./.registry --target-workspace ./my-workspace
+`,
+    rollback: `
+agenthub rollback - 回滚 Agent 到指定版本
+
+用法:
+  agenthub rollback <agent-slug> --to <version> --registry <dir> --target-workspace <dir>
+
+选项:
+  --to <version>            目标版本 (必需)
+  --registry <dir>          Registry 目录 (必需)
+  --target-workspace <dir>  目标工作区目录 (必需)
+
+示例:
+  agenthub rollback workspace --to 1.0.0 --registry ./.registry --target-workspace ./my-workspace
+`,
+    stats: `
+agenthub stats - 查看 Agent 统计信息
+
+用法:
+  agenthub stats <agent-slug> --registry <dir>
+
+选项:
+  --registry <dir>    Registry 目录 (必需)
+
+示例:
+  agenthub stats workspace --registry ./.registry
 `,
     serve: `
 agenthub serve - 启动完整服务（前端+后端）
@@ -265,12 +342,62 @@ async function main() {
           return;
         }
         console.log(`\n📥 正在安装 ${rest[0]}...\n`);
-        const result = await installCommand(rest[0], options);
-        console.log(`✓ 已安装 ${result.manifest.slug}@${result.manifest.version}`);
+        const installResult = await installCommand(rest[0], options);
+        console.log(`✓ 已安装 ${installResult.manifest.slug}@${installResult.manifest.version}`);
         console.log(`  位置: ${options.targetWorkspace || "当前目录"}`);
         return;
       }
 
+      case "list": {
+        const list = await listCommand(options);
+        console.log(formatListOutput(list));
+        return;
+      }
+
+      case "versions": {
+        if (!rest[0]) {
+          console.error("错误: 需要指定 agent slug");
+          process.exitCode = 1;
+          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;
+        }
+        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;
+        }
+        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;
+        }
+        const stats = await statsCommand(rest[0], options);
+        console.log(formatStatsOutput(stats));
+        return;
+      }
+
       case "serve": {
         const result = await serveCommand(options);
         console.log(`Server listening at ${result.baseUrl}`);
@@ -338,7 +465,10 @@ async function main() {
         process.exitCode = 1;
     }
   } catch (error) {
-    console.error(`\n❌ 错误: ${error.message}`);
+    // 提取更详细的错误信息
+    const causeMsg = error.cause?.errors?.[0]?.message || error.cause?.message || "";
+    const detailMsg = causeMsg ? `${error.message}\n   原因: ${causeMsg}` : error.message;
+    console.error(`\n❌ 错误: ${detailMsg}`);
     process.exitCode = 1;
   }
 }

package/src/commands/install.js

@@ -1,28 +1,56 @@
 import path from "node:path";
 import { installBundle } from "../lib/install.js";
+import { writeJson } from "../lib/fs-utils.js";
 
 export async function installCommand(agentSpec, options) {
-  const targetWorkspace = path.resolve(options.targetWorkspace);
-  if (!targetWorkspace) {
-    throw new Error("--target-workspace is required");
-  }
+  // 未显式提供时，默认在当前目录执行安装
+  const targetWorkspace = path.resolve(options.targetWorkspace || process.cwd());
 
   // 默认走远程服务器，提升网站复制命令可用性
   if (!options.registry && !options.server) {
     options.server = "https://agenthub.cyou";
   }
 
+  const debugEnabled = Boolean(process.env.AGENTHUB_DEBUG_INSTALL);
+  const debug = (message, details) => {
+    if (!debugEnabled) return;
+    console.error(`[agenthub:install] ${message} | ${JSON.stringify(details)}`);
+  };
+
+  debug("start install", {
+    agentSpec,
+    hasRegistry: Boolean(options.registry),
+    hasServer: Boolean(options.server),
+    targetWorkspace,
+  });
+
+  let result;
   if (options.registry) {
-    return installBundle({
+    result = await installBundle({
       registryDir: path.resolve(options.registry),
       agentSpec,
       targetWorkspace,
     });
+  } else {
+    result = await installBundle({
+      serverUrl: options.server,
+      agentSpec,
+      targetWorkspace,
+    });
   }
 
-  return installBundle({
-    serverUrl: options.server,
-    agentSpec,
-    targetWorkspace,
+  debug("install finished", {
+    slug: result.manifest.slug,
+    version: result.manifest.version,
+    installedAt: new Date().toISOString(),
   });
+
+  const installRecordPath = path.join(targetWorkspace, ".agenthub", "install.json");
+  await writeJson(installRecordPath, {
+    slug: result.manifest.slug,
+    version: result.manifest.version,
+    installedAt: new Date().toISOString(),
+  });
+
+  return result;
 }

package/src/lib/html.js

@@ -1643,7 +1643,7 @@ export function renderAgentDetailPage(manifest) {
         </div>
       </div>
       <div class="detail-install" title="Click to copy">
-        <span class="code-text">npx @zshuangmu/agenthub install ${manifest.slug}</span>
+        <span class="code-text">npx @zshuangmu/agenthub install ${manifest.slug} --target-workspace ./my-workspace</span>
         <button class="copy-btn" title="Copy">📋</button>
       </div>
     </div>

package/src/lib/install.js

@@ -2,6 +2,79 @@ import path from "node:path";
 import { copyDir, ensureDir, readJson, writeJson } from "./fs-utils.js";
 import { readAgentInfo } from "./registry.js";
 import { materializeBundlePayload } from "./bundle-transfer.js";
+import { request as httpsRequest } from "node:https";
+import { request as httpRequest } from "node:http";
+
+function debugLog(message, details) {
+  if (!process.env.AGENTHUB_DEBUG_INSTALL) return;
+  const suffix = details ? ` | ${JSON.stringify(details)}` : "";
+  console.error(`[agenthub:install] ${message}${suffix}`);
+}
+
+async function requestPayloadText(rawUrl) {
+  const parsed = new URL(rawUrl);
+  const transport = parsed.protocol === "http:" ? httpRequest : httpsRequest;
+  const requestOptions = {
+    method: "GET",
+    hostname: parsed.hostname,
+    port: parsed.port,
+    path: `${parsed.pathname}${parsed.search || ""}`,
+    protocol: parsed.protocol,
+    headers: {
+      "User-Agent": "agenthub-cli/0.1.3",
+      Accept: "application/json",
+    },
+  };
+
+  debugLog("fallback request begin", { url: rawUrl, protocol: parsed.protocol, hostname: parsed.hostname, path: requestOptions.path });
+
+  return await new Promise((resolve, reject) => {
+    const req = transport(requestOptions, (res) => {
+      let data = "";
+      res.on("data", (chunk) => {
+        data += chunk;
+      });
+      res.on("end", () => {
+        if (res.statusCode < 200 || res.statusCode >= 300) {
+          const reason = `${res.statusCode} ${res.statusMessage || ""}`;
+          debugLog("fallback request failed", { reason, rawUrl });
+          reject(new Error(`Remote install failed: ${reason}`));
+          return;
+        }
+        debugLog("fallback request success", { rawUrl, bytes: data.length });
+        resolve(data);
+      });
+    });
+
+    req.on("error", (error) => {
+      debugLog("fallback request error", { rawUrl, message: error.message });
+      reject(error);
+    });
+    req.end();
+  });
+}
+
+async function fetchPayload(url) {
+  const baseUrl = url.toString();
+  debugLog("requesting payload", { url: baseUrl });
+
+  try {
+    const response = await fetch(baseUrl);
+    debugLog("primary fetch done", { url: baseUrl, ok: response.ok, status: response.status, statusText: response.statusText });
+    if (!response.ok) {
+      throw new Error(`${response.status} ${response.statusText}`);
+    }
+    return response;
+  } catch (err) {
+    debugLog("primary fetch failed, fallback to http/https", { url: baseUrl, error: err.message });
+    const payloadText = await requestPayloadText(baseUrl);
+    return {
+      ok: true,
+      json: async () => JSON.parse(payloadText),
+      statusText: "OK",
+    };
+  }
+}
 
 async function applyBundleDir({ bundleDir, targetWorkspace }) {
   const manifest = await readJson(path.join(bundleDir, "MANIFEST.json"));
@@ -39,11 +112,26 @@ async function installFromRemote({ serverUrl, agentSpec, targetWorkspace }) {
   if (version) {
     url.searchParams.set("version", version);
   }
-  const response = await fetch(url);
+
+  debugLog("installing from remote", { serverUrl, slug, version: version || "latest", targetWorkspace, url: url.toString() });
+
+  let response;
+  try {
+    response = await fetchPayload(url);
+  } catch (error) {
+    debugLog("remote install failed", { slug, error: error.message, cause: error.cause });
+    // 提取更详细的错误信息
+    const causeMsg = error.cause?.errors?.[0]?.message || error.cause?.message || "";
+    const detailMsg = causeMsg ? `${error.message}: ${causeMsg}` : error.message;
+    throw new Error(`Remote install failed: ${detailMsg}`);
+  }
+
   if (!response.ok) {
-    throw new Error(`Remote install failed: ${response.status} ${await response.text()}`);
+    throw new Error(`Remote install failed: ${response.status} ${response.statusText}`);
   }
+
   const payload = await response.json();
+  debugLog("payload received", { slug, size: JSON.stringify(payload).length });
   const bundleDir = await materializeBundlePayload(payload);
   return applyBundleDir({ bundleDir, targetWorkspace });
 }