@zshuangmu/agenthub 0.1.0

package/src/commands/serve.js

@@ -0,0 +1,9 @@
+import path from "node:path";
+import { createServer } from "../server.js";
+
+export async function serveCommand(options) {
+  const registryDir = path.resolve(options.registry);
+  const port = options.port ? Number(options.port) : 3000;
+  const host = options.host || "0.0.0.0";
+  return createServer({ registryDir, port, host });
+}

package/src/commands/stats.js

@@ -0,0 +1,90 @@
+/**
+ * Stats Command
+ * 查看 Agent 统计信息
+ */
+
+import path from "node:path";
+import { pathExists, readJson } from "../lib/fs-utils.js";
+
+export async function statsCommand(agentSpec, options) {
+  const registryDir = path.resolve(options.registry);
+  const [slug] = agentSpec.split(":");
+
+  const indexPath = path.join(registryDir, "index.json");
+  if (!(await pathExists(indexPath))) {
+    throw new Error(`Agent not found: ${slug}`);
+  }
+
+  const index = await readJson(indexPath);
+  const agentEntries = index.agents.filter((entry) => entry.slug === slug);
+
+  if (agentEntries.length === 0) {
+    throw new Error(`Agent not found: ${slug}`);
+  }
+
+  // 获取最新版本的完整信息
+  const latestEntry = agentEntries.sort((a, b) =>
+    b.version.localeCompare(a.version, undefined, { numeric: true })
+  )[0];
+
+  // 读取完整 MANIFEST
+  const manifestPath = path.join(
+    registryDir,
+    "agents",
+    slug,
+    latestEntry.version,
+    "MANIFEST.json"
+  );
+  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;
+}
+
+export function formatStatsOutput(stats) {
+  const lines = [];
+  lines.push("\n╔═══════════════════════════════════════════════════════════════╗");
+  lines.push("║                     Agent Statistics                          ║");
+  lines.push("╠═══════════════════════════════════════════════════════════════╣");
+  lines.push(`║ Name:           ${stats.name.substring(0, 44).padEnd(44)}║`);
+  lines.push(`║ Slug:           ${stats.slug.padEnd(44)}║`);
+  lines.push(`║ Version:        ${stats.latestVersion.padEnd(44)}║`);
+  lines.push(`║ Author:         ${(stats.author || "unknown").padEnd(44)}║`);
+  lines.push("╠═══════════════════════════════════════════════════════════════╣");
+  lines.push("║ Statistics:                                                    ║");
+  lines.push(`║   Downloads:    ${String(stats.downloads).padEnd(44)}║`);
+  lines.push(`║   Stars:        ${String(stats.stars).padEnd(44)}║`);
+  lines.push(`║   Versions:     ${String(stats.totalVersions).padEnd(44)}║`);
+  if (stats.rating) {
+    lines.push(`║   Rating:       ${`${stats.rating}/5.0`.padEnd(44)}║`);
+  }
+  lines.push("╠═══════════════════════════════════════════════════════════════╣");
+  lines.push("║ Content:                                                       ║");
+  const memory = stats.includes?.memory || {};
+  lines.push(`║   Memory:       ${`共 ${memory.count || 0} 条 (public: ${memory.public || 0}, portable: ${memory.portable || 0})`.padEnd(42)}║`);
+  if (stats.includes?.skills?.length > 0) {
+    lines.push(`║   Skills:       ${stats.includes.skills.join(", ").substring(0, 42).padEnd(42)}║`);
+  }
+  lines.push("╠═══════════════════════════════════════════════════════════════╣");
+  lines.push(`║ Runtime:        ${`${stats.runtime?.type || "openclaw"} ${stats.runtime?.version || ""}`.padEnd(44)}║`);
+  lines.push("╚═══════════════════════════════════════════════════════════════╝");
+
+  return lines.join("\n");
+}

package/src/commands/update.js

@@ -0,0 +1,68 @@
+/**
+ * Update Command
+ * 更新已安装的 Agent 到最新版本
+ */
+
+import path from "node:path";
+import { pathExists, readJson, writeJson } from "../lib/fs-utils.js";
+import { installBundle } from "../lib/install.js";
+import { versionsCommand } from "./versions.js";
+
+export async function updateCommand(agentSpec, options) {
+  const registryDir = path.resolve(options.registry);
+  const targetWorkspace = options.targetWorkspace ? path.resolve(options.targetWorkspace) : null;
+  const [slug] = agentSpec.split(":");
+
+  // 获取可用版本
+  const versions = await versionsCommand(slug, { registry: registryDir });
+  if (versions.length === 0) {
+    throw new Error(`Agent not found: ${slug}`);
+  }
+
+  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;
+    }
+  }
+
+  if (currentVersion === latestVersion) {
+    return {
+      updated: false,
+      message: `已是最新版本: ${latestVersion}`,
+      currentVersion,
+      latestVersion,
+    };
+  }
+
+  // 执行更新
+  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,
+    });
+  }
+
+  return {
+    updated: true,
+    message: `已更新 ${slug} 从 ${currentVersion || "未知"} 到 ${latestVersion}`,
+    currentVersion: latestVersion,
+    previousVersion: currentVersion,
+    manifest: result.manifest,
+  };
+}

package/src/commands/versions.js

@@ -0,0 +1,63 @@
+/**
+ * Versions Command
+ * 查看 Agent 的所有可用版本
+ */
+
+import { pathExists, readJson } from "../lib/fs-utils.js";
+import path from "node:path";
+
+export async function versionsCommand(agentSpec, options) {
+  const registryDir = path.resolve(options.registry);
+  const [slug] = agentSpec.split(":");
+
+  const indexPath = path.join(registryDir, "index.json");
+  if (!(await pathExists(indexPath))) {
+    return [];
+  }
+
+  const index = await readJson(indexPath);
+  const versions = index.agents
+    .filter((entry) => entry.slug === slug)
+    .map((entry) => ({
+      version: entry.version,
+      name: entry.name,
+      description: entry.description,
+      updatedAt: entry.updatedAt || entry.createdAt,
+    }))
+    .sort((a, b) => b.version.localeCompare(a.version, undefined, { numeric: true }));
+
+  return versions;
+}
+
+export function formatVersionsOutput(slug, versions, currentVersion = null) {
+  const lines = [];
+  lines.push(`\n📋 ${slug} 可用版本:\n`);
+  lines.push("─".repeat(50));
+
+  for (const v of versions) {
+    const isLatest = v === versions[0];
+    const isCurrent = currentVersion && v.version === currentVersion;
+    const marker = isCurrent ? "✓" : isLatest ? "*" : " ";
+    const latestTag = isLatest ? " (latest)" : "";
+    const currentTag = isCurrent ? " (installed)" : "";
+
+    lines.push(`  ${marker} ${v.version}${latestTag}${currentTag}`);
+    if (v.description) {
+      lines.push(`      ${v.description.substring(0, 60)}`);
+    }
+  }
+
+  lines.push("─".repeat(50));
+
+  if (currentVersion) {
+    lines.push(`\n当前安装: ${currentVersion}`);
+    if (versions.length > 0 && versions[0].version !== currentVersion) {
+      lines.push(`可更新到: ${versions[0].version}`);
+      lines.push(`\n更新命令: agenthub update ${slug}`);
+    }
+  } else {
+    lines.push(`\n安装命令: agenthub install ${slug}`);
+  }
+
+  return lines.join("\n");
+}

package/src/commands/web.js

@@ -0,0 +1,8 @@
+import { createWebServer } from "../web-server.js";
+
+export async function webCommand(options) {
+  const port = parseInt(options.port || "3000", 10);
+  const apiBase = options.apiBase || "http://127.0.0.1:3001";
+
+  return createWebServer({ port, apiBase });
+}

package/src/index.js

@@ -0,0 +1,14 @@
+export { packCommand } from "./commands/pack.js";
+export { publishCommand } from "./commands/publish.js";
+export { publishRemoteCommand } from "./commands/publish-remote.js";
+export { searchCommand } from "./commands/search.js";
+export { infoCommand } from "./commands/info.js";
+export { installCommand } from "./commands/install.js";
+export { serveCommand } from "./commands/serve.js";
+export { versionsCommand, formatVersionsOutput } from "./commands/versions.js";
+export { updateCommand } from "./commands/update.js";
+export { rollbackCommand } from "./commands/rollback.js";
+export { statsCommand, formatStatsOutput } from "./commands/stats.js";
+export { listCommand, formatListOutput } from "./commands/list.js";
+export { apiCommand } from "./commands/api.js";
+export { webCommand } from "./commands/web.js";

package/src/lib/bundle-transfer.js

@@ -0,0 +1,58 @@
+import { mkdtemp, readdir, readFile, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { ensureDir } from "./fs-utils.js";
+import { publishBundle } from "./registry.js";
+
+async function walk(dirPath, baseDir = dirPath) {
+  const entries = await readdir(dirPath, { withFileTypes: true });
+  const files = [];
+  for (const entry of entries) {
+    const fullPath = path.join(dirPath, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...(await walk(fullPath, baseDir)));
+    } else {
+      files.push({
+        path: path.relative(baseDir, fullPath),
+        contentBase64: (await readFile(fullPath)).toString("base64"),
+      });
+    }
+  }
+  return files;
+}
+
+export async function serializeBundleDir(bundleDir) {
+  return {
+    bundleName: path.basename(bundleDir),
+    files: await walk(bundleDir),
+  };
+}
+
+export async function materializeBundlePayload(payload) {
+  const tempRoot = await mkdtemp(path.join(tmpdir(), "agenthub-upload-"));
+  const bundleDir = path.join(tempRoot, payload.bundleName);
+  for (const file of payload.files) {
+    const destination = path.join(bundleDir, file.path);
+    await ensureDir(path.dirname(destination));
+    await writeFile(destination, Buffer.from(file.contentBase64, "base64"));
+  }
+  return bundleDir;
+}
+
+export async function publishUploadedBundle({ payload, registryDir }) {
+  const bundleDir = await materializeBundlePayload(payload);
+  return publishBundle(bundleDir, registryDir);
+}
+
+export async function publishRemoteBundle({ bundleDir, serverUrl }) {
+  const payload = await serializeBundleDir(bundleDir);
+  const response = await fetch(new URL("/api/publish-upload", serverUrl), {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify(payload),
+  });
+  if (!response.ok) {
+    throw new Error(`Remote publish failed: ${response.status} ${await response.text()}`);
+  }
+  return response.json();
+}

package/src/lib/database.js

@@ -0,0 +1,244 @@
+import path from "node:path";
+import { pathExists, ensureDir } from "./fs-utils.js";
+import { readFile, writeFile } from "node:fs/promises";
+import initSqlJs from "sql.js";
+
+let db = null;
+let dbPath = null;
+
+/**
+ * 初始化数据库
+ */
+export async function initDatabase(registryDir) {
+  if (db) return db;
+
+  const SQL = await initSqlJs();
+  dbPath = path.join(registryDir, "agenthub.db");
+
+  // 确保目录存在
+  await ensureDir(registryDir);
+
+  // 尝试加载现有数据库
+  if (await pathExists(dbPath)) {
+    const buffer = await readFile(dbPath);
+    db = new SQL.Database(buffer);
+  } else {
+    db = new SQL.Database();
+  }
+
+  // 创建表
+  db.run(`
+    CREATE TABLE IF NOT EXISTS download_stats (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      agent_slug TEXT NOT NULL UNIQUE,
+      downloads INTEGER DEFAULT 0,
+      last_download_at TEXT,
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+      updated_at TEXT DEFAULT CURRENT_TIMESTAMP
+    )
+  `);
+
+  db.run(`
+    CREATE TABLE IF NOT EXISTS download_logs (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      agent_slug TEXT NOT NULL,
+      installed_at TEXT DEFAULT CURRENT_TIMESTAMP,
+      target_workspace TEXT,
+      ip_address TEXT,
+      user_agent TEXT
+    )
+  `);
+
+  // 创建索引
+  db.run(`CREATE INDEX IF NOT EXISTS idx_download_stats_slug ON download_stats(agent_slug)`);
+  db.run(`CREATE INDEX IF NOT EXISTS idx_download_logs_slug ON download_logs(agent_slug)`);
+
+  await saveDatabase();
+  return db;
+}
+
+/**
+ * 保存数据库到文件
+ */
+export async function saveDatabase() {
+  if (!db || !dbPath) return;
+  const data = db.export();
+  const buffer = Buffer.from(data);
+  await writeFile(dbPath, buffer);
+}
+
+/**
+ * 关闭数据库连接
+ */
+export async function closeDatabase() {
+  if (db) {
+    await saveDatabase();
+    db.close();
+    db = null;
+  }
+}
+
+/**
+ * 增加下载次数
+ */
+export async function incrementDownloads(registryDir, slug, metadata = {}) {
+  await initDatabase(registryDir);
+
+  // 更新或插入下载统计
+  const existing = db.exec(`SELECT downloads FROM download_stats WHERE agent_slug = ?`, [slug]);
+
+  if (existing.length > 0 && existing[0].values.length > 0) {
+    db.run(`
+      UPDATE download_stats
+      SET downloads = downloads + 1,
+          last_download_at = CURRENT_TIMESTAMP,
+          updated_at = CURRENT_TIMESTAMP
+      WHERE agent_slug = ?
+    `, [slug]);
+  } else {
+    db.run(`
+      INSERT INTO download_stats (agent_slug, downloads, last_download_at, created_at, updated_at)
+      VALUES (?, 1, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)
+    `, [slug]);
+  }
+
+  // 记录下载日志
+  db.run(`
+    INSERT INTO download_logs (agent_slug, target_workspace, ip_address, user_agent)
+    VALUES (?, ?, ?, ?)
+  `, [slug, metadata.targetWorkspace || null, metadata.ip || null, metadata.userAgent || null]);
+
+  await saveDatabase();
+
+  return getAgentDownloads(registryDir, slug);
+}
+
+/**
+ * 获取单个 Agent 的下载次数
+ */
+export async function getAgentDownloads(registryDir, slug) {
+  await initDatabase(registryDir);
+
+  const result = db.exec(`SELECT downloads FROM download_stats WHERE agent_slug = ?`, [slug]);
+  if (result.length > 0 && result[0].values.length > 0) {
+    return result[0].values[0][0];
+  }
+  return 0;
+}
+
+/**
+ * 批量获取多个 Agent 的下载次数
+ */
+export async function getAgentsDownloads(registryDir, slugs) {
+  await initDatabase(registryDir);
+
+  const result = {};
+  for (const slug of slugs) {
+    result[slug] = 0;
+  }
+
+  const placeholders = slugs.map(() => '?').join(',');
+  const rows = db.exec(`SELECT agent_slug, downloads FROM download_stats WHERE agent_slug IN (${placeholders})`, slugs);
+
+  if (rows.length > 0) {
+    for (const row of rows[0].values) {
+      result[row[0]] = row[1];
+    }
+  }
+
+  return result;
+}
+
+/**
+ * 获取所有 Agent 的下载次数
+ */
+export async function getAllDownloads(registryDir) {
+  await initDatabase(registryDir);
+
+  const result = {};
+  const rows = db.exec(`SELECT agent_slug, downloads FROM download_stats`);
+
+  if (rows.length > 0) {
+    for (const row of rows[0].values) {
+      result[row[0]] = row[1];
+    }
+  }
+
+  return result;
+}
+
+/**
+ * 获取总下载次数
+ */
+export async function getTotalDownloads(registryDir) {
+  await initDatabase(registryDir);
+
+  const result = db.exec(`SELECT COALESCE(SUM(downloads), 0) as total FROM download_stats`);
+  if (result.length > 0 && result[0].values.length > 0) {
+    return result[0].values[0][0];
+  }
+  return 0;
+}
+
+/**
+ * 获取下载排行
+ */
+export async function getDownloadRanking(registryDir, limit = 10) {
+  await initDatabase(registryDir);
+
+  const rows = db.exec(`
+    SELECT agent_slug, downloads, last_download_at
+    FROM download_stats
+    ORDER BY downloads DESC
+    LIMIT ?
+  `, [limit]);
+
+  if (rows.length > 0) {
+    return rows[0].values.map(row => ({
+      slug: row[0],
+      downloads: row[1],
+      lastDownload: row[2]
+    }));
+  }
+  return [];
+}
+
+/**
+ * 获取最近的下载日志
+ */
+export async function getRecentDownloads(registryDir, limit = 50) {
+  await initDatabase(registryDir);
+
+  const rows = db.exec(`
+    SELECT agent_slug, installed_at, target_workspace
+    FROM download_logs
+    ORDER BY installed_at DESC
+    LIMIT ?
+  `, [limit]);
+
+  if (rows.length > 0) {
+    return rows[0].values.map(row => ({
+      slug: row[0],
+      installedAt: row[1],
+      targetWorkspace: row[2]
+    }));
+  }
+  return [];
+}
+
+/**
+ * 获取数据库统计信息
+ */
+export async function getDatabaseStats(registryDir) {
+  await initDatabase(registryDir);
+
+  const totalAgents = db.exec(`SELECT COUNT(*) FROM download_stats`)[0]?.values[0][0] || 0;
+  const totalDownloads = await getTotalDownloads(registryDir);
+  const totalLogs = db.exec(`SELECT COUNT(*) FROM download_logs`)[0]?.values[0][0] || 0;
+
+  return {
+    totalAgents,
+    totalDownloads,
+    totalLogs
+  };
+}

package/src/lib/download-stats.js

@@ -0,0 +1,77 @@
+import path from "node:path";
+import { pathExists, readJson, writeJson } from "./fs-utils.js";
+
+const STATS_FILE = "download-stats.json";
+
+/**
+ * 获取下载统计
+ */
+export async function getDownloadStats(registryDir) {
+  const statsPath = path.join(registryDir, STATS_FILE);
+  if (await pathExists(statsPath)) {
+    return readJson(statsPath);
+  }
+  return { agents: {} };
+}
+
+/**
+ * 保存下载统计
+ */
+export async function saveDownloadStats(registryDir, stats) {
+  const statsPath = path.join(registryDir, STATS_FILE);
+  await writeJson(statsPath, stats);
+}
+
+/**
+ * 增加下载次数
+ */
+export async function incrementDownloads(registryDir, slug) {
+  const stats = await getDownloadStats(registryDir);
+  if (!stats.agents[slug]) {
+    stats.agents[slug] = { downloads: 0 };
+  }
+  stats.agents[slug].downloads += 1;
+  stats.agents[slug].lastDownload = new Date().toISOString();
+  await saveDownloadStats(registryDir, stats);
+  return stats.agents[slug].downloads;
+}
+
+/**
+ * 获取单个 Agent 的下载次数
+ */
+export async function getAgentDownloads(registryDir, slug) {
+  const stats = await getDownloadStats(registryDir);
+  return stats.agents[slug]?.downloads || 0;
+}
+
+/**
+ * 批量获取多个 Agent 的下载次数
+ */
+export async function getAgentsDownloads(registryDir, slugs) {
+  const stats = await getDownloadStats(registryDir);
+  const result = {};
+  for (const slug of slugs) {
+    result[slug] = stats.agents[slug]?.downloads || 0;
+  }
+  return result;
+}
+
+/**
+ * 获取所有 Agent 的下载次数
+ */
+export async function getAllDownloads(registryDir) {
+  const stats = await getDownloadStats(registryDir);
+  return stats.agents;
+}
+
+/**
+ * 获取总下载次数
+ */
+export async function getTotalDownloads(registryDir) {
+  const stats = await getDownloadStats(registryDir);
+  let total = 0;
+  for (const agent of Object.values(stats.agents)) {
+    total += agent.downloads || 0;
+  }
+  return total;
+}

package/src/lib/fs-utils.js

@@ -0,0 +1,46 @@
+import { cp, mkdir, readdir, readFile, 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 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;
+}