@zshuangmu/agenthub 0.2.0 → 0.2.2

package/README.md

@@ -87,6 +87,28 @@ agenthub serve --registry ./.registry --port 3000
 
 访问 http://localhost:3000 查看你的 Agent！
 
+### 🎯 试用样板 Agent
+
+我们提供了一个官方样板 Agent，帮助你快速体验：
+
+```bash
+# 1. 克隆仓库
+git clone https://github.com/itshaungmu/AgentHub.git
+cd AgentHub
+
+# 2. 打包样板 Agent
+agenthub pack --workspace ./samples/code-review-assistant --config ./samples/code-review-assistant/openclaw.json
+
+# 3. 发布到本地 Registry
+agenthub publish ./bundles/code-review-assistant-1.0.0.agent --registry ./.registry
+
+# 4. 安装到你的 workspace
+agenthub install code-review-assistant --registry ./.registry --target-workspace ./my-workspace
+
+# 5. 校验安装
+agenthub verify code-review-assistant --registry ./.registry --target-workspace ./my-workspace
+```
+
 ---
 
 ## 📖 命令文档

package/package.json

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

package/src/commands/rollback.js

@@ -8,6 +8,7 @@ import { getCurrentVersion, updateInstallRecord, buildInstallOptions } from "../
 import { installBundle } from "../lib/install.js";
 import { parseSpec } from "../lib/registry.js";
 import { versionsCommand } from "./versions.js";
+import { success, warning, highlight, muted, symbols } from "../lib/colors.js";
 
 export async function rollbackCommand(agentSpec, options = {}) {
   const targetWorkspace = options.targetWorkspace ? path.resolve(options.targetWorkspace) : null;
@@ -41,7 +42,16 @@ export async function rollbackCommand(agentSpec, options = {}) {
 
   return {
     rolledBack: true,
-    message: `已回滚 ${slug} 从 ${currentVersion || "未知"} 到 ${targetVersion}`,
+    message: [
+      success(`${symbols.success} 回滚成功`),
+      "",
+      `  ${highlight("Agent:")} ${slug}`,
+      `  ${muted("回滚前:")} ${currentVersion || "未知"}`,
+      `  ${highlight("当前版本:")} ${targetVersion}`,
+      "",
+      `  ${muted("运行")} ${highlight("agenthub verify " + slug)} ${muted("校验安装状态")}`,
+      `  ${muted("运行")} ${highlight("agenthub update " + slug)} ${muted("恢复到最新版本")}`,
+    ].join("\n"),
     currentVersion: targetVersion,
     previousVersion: currentVersion,
     manifest: result.manifest,

package/src/commands/update.js

@@ -7,6 +7,7 @@ import path from "node:path";
 import { getCurrentVersion, performVersionChange } from "../lib/version-manager.js";
 import { parseSpec } from "../lib/registry.js";
 import { versionsCommand } from "./versions.js";
+import { success, warning, highlight, muted, symbols } from "../lib/colors.js";
 
 export async function updateCommand(agentSpec, options = {}) {
   const targetWorkspace = options.targetWorkspace ? path.resolve(options.targetWorkspace) : null;
@@ -26,7 +27,7 @@ export async function updateCommand(agentSpec, options = {}) {
   if (currentVersion === latestVersion) {
     return {
       updated: false,
-      message: `已是最新版本: ${latestVersion}`,
+      message: `${success(`${symbols.success} ${slug} 已是最新版本`)} ${muted(`(${latestVersion})`)}`,
       currentVersion,
       latestVersion,
     };
@@ -37,7 +38,15 @@ export async function updateCommand(agentSpec, options = {}) {
 
   return {
     updated: true,
-    message: `已更新 ${slug} 从 ${currentVersion || "未知"} 到 ${latestVersion}`,
+    message: [
+      success(`${symbols.success} 更新成功`),
+      "",
+      `  ${highlight("Agent:")} ${slug}`,
+      `  ${muted("旧版本:")} ${currentVersion || "未知"}`,
+      `  ${highlight("新版本:")} ${latestVersion}`,
+      "",
+      `  ${muted("运行")} ${highlight("agenthub verify " + slug)} ${muted("校验安装状态")}`,
+    ].join("\n"),
     currentVersion: latestVersion,
     previousVersion: currentVersion,
     manifest: result.manifest,

package/src/commands/verify.js

@@ -2,6 +2,7 @@ import path from "node:path";
 import { pathExists, readJson } from "../lib/fs-utils.js";
 import { parseSpec } from "../lib/registry.js";
 import { infoCommand } from "./info.js";
+import { success, error, warning, info as infoColor, highlight, muted, symbols } from "../lib/colors.js";
 
 export async function verifyCommand(agentSpec, options = {}) {
   const targetWorkspace = path.resolve(options.targetWorkspace || process.cwd());
@@ -78,17 +79,55 @@ export async function verifyCommand(agentSpec, options = {}) {
 
 export function formatVerifyOutput(result) {
   const lines = [];
-  lines.push(`\n${result.verified ? "✅" : "❌"} Verify ${result.verified ? "passed" : "failed"}\n`);
+
+  // 标题
+  if (result.verified) {
+    lines.push(`\n${success(`${symbols.success} 校验通过`)}\n`);
+  } else {
+    lines.push(`\n${error(`${symbols.error} 校验失败`)}\n`);
+  }
+
+  // Agent 信息
   if (result.installRecord) {
-    lines.push(`Agent: ${result.installRecord.slug}@${result.installRecord.version}`);
+    lines.push(`${highlight("Agent:")} ${result.installRecord.slug}@${result.installRecord.version}`);
   }
-  lines.push(`Workspace: ${result.targetWorkspace}`);
+  lines.push(`${highlight("Workspace:")} ${result.targetWorkspace}`);
   lines.push("");
+
+  // 检查结果
+  lines.push(`${infoColor("检查项目:")}`);
   for (const check of result.checks || []) {
-    lines.push(`- ${check.ok ? "PASS" : "FAIL"} ${check.name}: ${check.detail}`);
+    const status = check.ok
+      ? success(`${symbols.success} PASS`)
+      : error(`${symbols.error} FAIL`);
+    const checkName = check.name.replace(":", ": ").replace("_", " ");
+    lines.push(`  ${status} ${muted(checkName)}`);
+    if (!check.ok || check.name.includes(":")) {
+      lines.push(`         ${muted(check.detail)}`);
+    }
   }
+
+  // 失败原因
   if (result.reason) {
-    lines.push(`\nReason: ${result.reason}`);
+    lines.push(`\n${warning(`原因: ${result.reason}`)}`);
+  }
+
+  // 健康度建议
+  if (result.verified) {
+    lines.push(`\n${success("Agent 安装完整，可以正常使用。")}`);
+  } else {
+    lines.push(`\n${warning("建议:")}`);
+    if (result.checks?.some(c => c.name === "install_record" && !c.ok)) {
+      lines.push(`  - 运行 ${highlight("agenthub install <agent-slug>")} 安装 Agent`);
+    }
+    if (result.checks?.some(c => c.name.includes("workspace_file") && !c.ok)) {
+      lines.push(`  - 检查 workspace 文件是否完整`);
+      lines.push(`  - 尝试重新安装: ${highlight("agenthub install <agent-slug> --force")}`);
+    }
+    if (result.checks?.some(c => c.name === "applied_config" && !c.ok)) {
+      lines.push(`  - 配置文件未应用，检查 OPENCLAW.template.json`);
+    }
   }
+
   return lines.join("\n");
 }