@zshuangmu/agenthub 0.1.0 → 0.1.2

package/src/lib/install.js

@@ -1,10 +1,10 @@
 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";
 
-export async function installBundle({ registryDir, agentSpec, targetWorkspace }) {
-  const manifest = await readAgentInfo(registryDir, agentSpec);
-  const bundleDir = path.join(registryDir, "agents", manifest.slug, manifest.version);
+async function applyBundleDir({ bundleDir, targetWorkspace }) {
+  const manifest = await readJson(path.join(bundleDir, "MANIFEST.json"));
   await ensureDir(targetWorkspace);
   await copyDir(path.join(bundleDir, "WORKSPACE"), targetWorkspace);
   const template = await readJson(path.join(bundleDir, "OPENCLAW.template.json"));
@@ -12,3 +12,52 @@ export async function installBundle({ registryDir, agentSpec, targetWorkspace })
   await writeJson(appliedPath, template);
   return { manifest, appliedPath };
 }
+
+/**
+ * 解析 agentSpec，支持两种格式：
+ * - 短名格式：slug 或 slug:version
+ * - URI 格式：agenthub://owner/slug@version
+ */
+function parseAgentSpec(agentSpec) {
+  // URI 格式：agenthub://owner/slug@version
+  if (agentSpec.startsWith("agenthub://")) {
+    const uri = agentSpec.slice("agenthub://".length);
+    // owner/slug@version -> slug@version
+    const parts = uri.split("/");
+    const lastPart = parts[parts.length - 1] || parts[parts.length - 2];
+    const [slug, version] = lastPart.split("@");
+    return { slug, version: version || undefined };
+  }
+  // 短名格式：slug 或 slug:version
+  const [slug, version] = agentSpec.split(":");
+  return { slug, version: version || undefined };
+}
+
+async function installFromRemote({ serverUrl, agentSpec, targetWorkspace }) {
+  const { slug, version } = parseAgentSpec(agentSpec);
+  const url = new URL(`/api/agents/${slug}/download`, serverUrl);
+  if (version) {
+    url.searchParams.set("version", version);
+  }
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new Error(`Remote install failed: ${response.status} ${await response.text()}`);
+  }
+  const payload = await response.json();
+  const bundleDir = await materializeBundlePayload(payload);
+  return applyBundleDir({ bundleDir, targetWorkspace });
+}
+
+export async function installBundle({ registryDir, serverUrl, agentSpec, targetWorkspace }) {
+  if (registryDir) {
+    const manifest = await readAgentInfo(registryDir, agentSpec);
+    const bundleDir = path.join(registryDir, "agents", manifest.slug, manifest.version);
+    return applyBundleDir({ bundleDir, targetWorkspace });
+  }
+
+  if (serverUrl) {
+    return installFromRemote({ serverUrl, agentSpec, targetWorkspace });
+  }
+
+  throw new Error("Either registryDir or serverUrl is required");
+}

package/src/lib/registry.js

@@ -1,9 +1,23 @@
 import path from "node:path";
 import { copyDir, ensureDir, pathExists, readJson, writeJson } from "./fs-utils.js";
 
+/**
+ * 解析 agentSpec，支持两种格式：
+ * - 短名格式：slug 或 slug:version
+ * - URI 格式：agenthub://owner/slug@version
+ */
 function parseSpec(agentSpec) {
+  // URI 格式：agenthub://owner/slug@version
+  if (agentSpec.startsWith("agenthub://")) {
+    const uri = agentSpec.slice("agenthub://".length);
+    const parts = uri.split("/");
+    const lastPart = parts[parts.length - 1] || parts[parts.length - 2];
+    const [slug, version] = lastPart.split("@");
+    return { slug, version: version || undefined };
+  }
+  // 短名格式：slug 或 slug:version
   const [slug, version] = agentSpec.split(":");
-  return { slug, version };
+  return { slug, version: version || undefined };
 }
 
 export async function publishBundle(bundleDir, registryDir) {
@@ -30,6 +44,9 @@ export async function publishBundle(bundleDir, registryDir) {
     name: manifest.name,
     description: manifest.description,
     runtime: manifest.runtime,
+    updatedAt: new Date().toISOString(),
+    tags: manifest.metadata?.tags || [],
+    category: manifest.metadata?.category || 'General',
   });
   index.agents.sort((left, right) => left.slug.localeCompare(right.slug));
   await writeJson(indexPath, index);
@@ -43,8 +60,26 @@ export async function searchRegistry(registryDir, query) {
     return [];
   }
   const index = await readJson(indexPath);
-  const normalized = query.toLowerCase();
-  return index.agents.filter((entry) => entry.slug.toLowerCase().includes(normalized));
+  const normalized = query.toLowerCase().trim();
+
+  // 空查询返回所有
+  if (!normalized) {
+    return index.agents;
+  }
+
+  return index.agents.filter((entry) => {
+    // 搜索 slug
+    if (entry.slug?.toLowerCase().includes(normalized)) return true;
+    // 搜索 name
+    if (entry.name?.toLowerCase().includes(normalized)) return true;
+    // 搜索 description
+    if (entry.description?.toLowerCase().includes(normalized)) return true;
+    // 搜索 tags
+    if (entry.tags?.some(tag => tag.toLowerCase().includes(normalized))) return true;
+    // 搜索 category
+    if (entry.category?.toLowerCase().includes(normalized)) return true;
+    return false;
+  });
 }
 
 export async function readAgentInfo(registryDir, agentSpec) {

package/src/server.js

@@ -2,7 +2,7 @@ import http from "node:http";
 import path from "node:path";
 import { readFile } from "node:fs/promises";
 import { infoCommand, installCommand, publishCommand, searchCommand } from "./index.js";
-import { publishUploadedBundle } from "./lib/bundle-transfer.js";
+import { publishUploadedBundle, serializeBundleDir } from "./lib/bundle-transfer.js";
 import { notFound, readJsonBody, sendHtml, sendJson } from "./lib/http.js";
 import { renderAgentDetailPage, renderAgentListPage, renderStatsPage } from "./lib/html.js";
 import {
@@ -47,6 +47,16 @@ export async function createServer({ registryDir, port = 3000, host = "0.0.0.0"
         const slugs = agents.map(a => a.slug);
         const downloads = await getAgentsDownloads(registryDir, slugs);
         const agentsWithDownloads = agents.map(a => ({ ...a, downloads: downloads[a.slug] || 0 }));
+        // 按下载量降序排序，下载量一致时按更新时间降序排序
+        agentsWithDownloads.sort((a, b) => {
+          if (b.downloads !== a.downloads) {
+            return b.downloads - a.downloads;
+          }
+          // 下载量一致时，按更新时间降序（最近更新的排前面）
+          const timeA = a.updatedAt ? new Date(a.updatedAt).getTime() : 0;
+          const timeB = b.updatedAt ? new Date(b.updatedAt).getTime() : 0;
+          return timeB - timeA;
+        });
         sendJson(response, 200, { agents: agentsWithDownloads });
         return;
       }
@@ -99,6 +109,21 @@ export async function createServer({ registryDir, port = 3000, host = "0.0.0.0"
         return;
       }
 
+      if (url.pathname.startsWith("/api/agents/") && url.pathname.endsWith("/download")) {
+        const slug = url.pathname.slice("/api/agents/".length, -"/download".length);
+        const version = url.searchParams.get("version") || undefined;
+        const manifest = await infoCommand(version ? `${slug}:${version}` : slug, { registry: registryDir });
+        const bundleDir = path.join(registryDir, "agents", manifest.slug, manifest.version);
+        const payload = await serializeBundleDir(bundleDir);
+        // 记录下载（包含元数据）
+        await incrementDownloads(registryDir, manifest.slug, {
+          ip: request.socket.remoteAddress,
+          userAgent: request.headers['user-agent']
+        });
+        sendJson(response, 200, payload);
+        return;
+      }
+
       if (url.pathname.startsWith("/api/agents/")) {
         const slug = url.pathname.slice("/api/agents/".length);
         const manifest = await infoCommand(slug, { registry: registryDir });
@@ -116,6 +141,16 @@ export async function createServer({ registryDir, port = 3000, host = "0.0.0.0"
         const downloads = await getAgentsDownloads(registryDir, slugs);
         const totalDownloads = await getTotalDownloads(registryDir);
         const agentsWithDownloads = agents.map(a => ({ ...a, downloads: downloads[a.slug] || 0 }));
+        // 按下载量降序排序，下载量一致时按更新时间降序排序
+        agentsWithDownloads.sort((a, b) => {
+          if (b.downloads !== a.downloads) {
+            return b.downloads - a.downloads;
+          }
+          // 下载量一致时，按更新时间降序（最近更新的排前面）
+          const timeA = a.updatedAt ? new Date(a.updatedAt).getTime() : 0;
+          const timeB = b.updatedAt ? new Date(b.updatedAt).getTime() : 0;
+          return timeB - timeA;
+        });
         sendHtml(response, 200, renderAgentListPage({ query, agents: agentsWithDownloads, totalDownloads }));
         return;
       }