@zshuangmu/agenthub 0.3.7 → 0.3.9

package/package.json

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

package/src/cli.js

@@ -111,11 +111,13 @@ agenthub pack - 打包 Agent
   --workspace <dir>   OpenClaw 工作区目录 (必需)
   --config <file>     openclaw.json 配置文件路径 (必需)
   --output <dir>      输出目录 (默认: ./bundles)
+  --version <ver>     版本号 (默认: 1.0.0)
   --tags <tags>       标签，逗号分隔
   --category <cat>    分类
 
 示例:
   agenthub pack --workspace ./my-agent --config ./openclaw.json
+  agenthub pack --workspace ./my-agent --config ./openclaw.json --version 2.0.0
 `,
     publish: `
 agenthub publish - 发布 Agent
@@ -284,11 +286,7 @@ function parseArgs(argv) {
   const options = {};
   for (let index = 0; index < argv.length; index += 1) {
     const token = argv[index];
-    if (token === "--help" || token === "-h") {
-      options.help = true;
-    } else if (token === "--version" || token === "-v") {
-      options.version = true;
-    } else if (token.startsWith("--")) {
+    if (token.startsWith("--")) {
       const rawKey = token.slice(2);
       const camelKey = rawKey.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
       const value = argv[index + 1];
@@ -300,6 +298,10 @@ function parseArgs(argv) {
         options[rawKey] = true;
         options[camelKey] = true;
       }
+    } else if (token === "-h") {
+      options.help = true;
+    } else if (token === "-v") {
+      options.version = true;
     } else {
       positionals.push(token);
     }
@@ -311,8 +313,8 @@ async function main() {
   const { positionals, options } = parseArgs(process.argv.slice(2));
   const [command, ...rest] = positionals;
 
-  // 全局选项
-  if (options.version) {
+  // 全局选项 - only show version if --version/-v is a boolean flag, not a string value
+  if (options.version === true) {
     console.log(`AgentHub v${VERSION}`);
     return;
   }
@@ -527,14 +529,32 @@ async function main() {
       console.log(`\n${warning("建议:")}`);
       console.log(`  - 检查文件权限`);
       console.log(`  - 尝试使用 ${highlight("sudo")} 命令`);
-    } else if (errMsg.includes("network") || errMsg.includes("econnrefused") || errMsg.includes("timeout")) {
+    } else if (errMsg.includes("network") || errMsg.includes("econnrefused") || errMsg.includes("timeout") || errMsg.includes("fetch failed")) {
       console.log(`\n${warning("建议:")}`);
       console.log(`  - 检查网络连接`);
       console.log(`  - 确认服务器地址正确`);
       console.log(`  - 使用 ${highlight("--registry")} 指定本地 registry`);
+      console.log(`  - 运行 ${highlight("agenthub doctor")} 诊断环境问题`);
+    } else if (errMsg.includes("agent not found") || errMsg.includes("no agent")) {
+      console.log(`\n${warning("建议:")}`);
+      console.log(`  - 运行 ${highlight("agenthub search")} 查看可用 Agent`);
+      console.log(`  - 检查 Agent 名称拼写`);
+      console.log(`  - 确认使用正确的 --registry 路径`);
+    } else if (errMsg.includes("invalid") || errMsg.includes("validation")) {
+      console.log(`\n${warning("建议:")}`);
+      console.log(`  - 检查配置文件格式 (openclaw.json)`);
+      console.log(`  - 确认 workspace 包含必需文件 (AGENTS.md, SOUL.md 等)`);
+      console.log(`  - 运行 ${highlight("agenthub verify")} 检查安装完整性`);
+    } else if (errMsg.includes("version") || errMsg.includes("already")) {
+      console.log(`\n${warning("建议:")}`);
+      console.log(`  - 运行 ${highlight("agenthub versions <agent>")} 查看可用版本`);
+      console.log(`  - 使用 ${highlight("--force")} 强制覆盖安装`);
+      console.log(`  - 运行 ${highlight("agenthub list")} 查看已安装的 Agent`);
     }
 
-    console.log(`\n${muted("如需更多帮助，运行: agenthub <command> --help")}`);
+    console.log(`\n${muted("如需更多帮助:")}`);
+    console.log(`${muted("  - 运行: agenthub <command> --help")}`);
+    console.log(`${muted("  - 诊断: agenthub doctor")}`);
     process.exitCode = 1;
   }
 }

package/src/commands/pack.js

@@ -67,10 +67,11 @@ export async function packCommand(options) {
   const workspace = path.resolve(options.workspace || process.cwd());
   const output = path.resolve(options.output ?? "./bundles");
   const configPath = options.config ? path.resolve(options.config) : null;
+  const version = options.version || "1.0.0";
 
   // 从工作区名称生成 slug
   const slug = path.basename(workspace).toLowerCase().replace(/[^a-z0-9-]/g, "-");
-  const bundleDir = path.join(output, `${slug}-1.0.0.agent`);
+  const bundleDir = path.join(output, `${slug}-${version}.agent`);
 
   // 1. 扫描工作区
   const workspaceFiles = await scanWorkspace(workspace);
@@ -99,6 +100,7 @@ export async function packCommand(options) {
     prompts: workspaceFiles.prompts,
     tags: options.tags ? options.tags.split(",").map((t) => t.trim()) : [],
     category: options.category,
+    version,
   });
 
   // 5. 验证 MANIFEST

package/src/lib/manifest.js

@@ -5,7 +5,7 @@
 
 const WORKSPACE_FILES = ["AGENTS.md", "SOUL.md", "USER.md", "IDENTITY.md", "TOOLS.md", "HEARTBEAT.md", "BOOTSTRAP.md"];
 
-export function createManifest({ slug, name, description, author, memoryCounts, openclawTemplate, skills = [], prompts = [], tags = [], category, language = "zh-CN" }) {
+export function createManifest({ slug, name, description, author, memoryCounts, openclawTemplate, skills = [], prompts = [], tags = [], category, language = "zh-CN", version = "1.0.0" }) {
   const hasModel = openclawTemplate?.agents?.defaults?.model?.primary;
   const totalMemory = memoryCounts.public + memoryCounts.portable + memoryCounts.private;
 
@@ -13,7 +13,7 @@ export function createManifest({ slug, name, description, author, memoryCounts,
     // 基本信息
     name: name || slug,
     slug,
-    version: "1.0.0",
+    version,
     description: description || `OpenClaw agent bundle for ${name || slug}`,
     author: author || "anonymous",
     icon: undefined,