@zshuangmu/agenthub 0.1.7 → 0.2.0

package/README.md

@@ -2,15 +2,16 @@
 
 # 🤖 AgentHub
 
-**The Open Source Marketplace for AI Agents**
+**OpenClaw Agent 的打包、发布与分发平台**
 
+[![npm version](https://img.shields.io/npm/v/@zshuangmu/agenthub.svg)](https://www.npmjs.com/package/@zshuangmu/agenthub)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
 [![Node: >=18](https://img.shields.io/badge/Node.js->=18-green.svg)](https://nodejs.org/)
-[![GitHub Stars](https://img.shields.io/github/stars/agenthub/agenthub?style=social)](https://github.com/agenthub/agenthub)
+[![GitHub Stars](https://img.shields.io/github/stars/itshaungmu/AgentHub?style=social)](https://github.com/itshaungmu/AgentHub)
 
-**Package and upload your Agent's full capabilities in one command.<br>Download and gain those powers with one click.**
+**把你调教好的 OpenClaw Agent 变成可复用、可分发、可升级的标准资产**
 
-🌐 **Live Demo**: [https://agenthub.cyou](https://agenthub.cyou/)
+🌐 **在线演示**: [https://agenthub.cyou](https://agenthub.cyou/)
 
 [English](README.md) | [中文](README_CN.md)
 
@@ -18,108 +19,123 @@
 
 ---
 
-## 🎯 What is AgentHub?
+## 🎯 AgentHub 是什么？
 
-AgentHub is an open-source platform for packaging and distributing AI Agents. It allows you to:
+AgentHub 是一个专为 **OpenClaw** 设计的 Agent 打包与分发平台，类似于：
+- **Docker Hub** 之于 Docker 容器
+- **npm** 之于 Node.js 包
 
-- **📦 Package** your Agent's personality, memory, and skills into a single bundle
-- **🚀 Publish** to a local or remote registry with one command
-- **🔍 Discover** and search agents from the marketplace
-- **⚡ Install** agents to any workspace instantly
+但专注于 **OpenClaw Agent 的分发与复刻**。
 
-Perfect for teams who want to share AI capabilities across projects, or individuals who want to backup and version their agent configurations.
+### 核心能力
 
-## ✨ Features
+| 能力 | 描述 |
+|------|------|
+| 📦 **一键打包** | 将 Agent 的 personality、memory、skills 打包成标准 Bundle |
+| 🚀 **发布分发** | 发布到本地或远程 Registry，生成可分享链接 |
+| ⚡ **一键安装** | 团队成员通过统一命令安装，复刻完整 Agent 能力 |
+| 🔄 **版本管理** | 完整的升级、回滚、校验支持 |
 
-| Feature | Description |
-|---------|-------------|
-| 📦 **One-Click Packaging** | Automatically scan workspace and package Agent capabilities |
-| 🚀 **Local-First** | No cloud required, runs entirely on your machine |
-| 🌐 **Web Interface** | Beautiful dark-themed UI with i18n support (EN/中文) |
-| 🔐 **Memory Layers** | Three-tier memory: public, portable, private |
-| 🔄 **Version Control** | Full version history with rollback support |
-| 📊 **Analytics** | Built-in download tracking and statistics |
+### 适合谁？
+
+- **✅ OpenClaw 团队用户**: 统一分发、版本管理、团队复用
+- **✅ Agent 创作者**: 打包分享你调教好的 Agent
+- **✅ AI 重度用户**: 快速获得别人调教好的 Agent 能力
+
+### 不适合谁？
+
+- ❌ 非 OpenClaw 用户（当前仅支持 OpenClaw）
+- ❌ 需要 Prompt 收藏夹（请使用专门的 Prompt 工具）
+- ❌ 单个 Skill 分发（请使用 ClawHub）
 
 ## 📸 Screenshots
 
-![alt text](./docs/image.png)
-## 🚀 Quick Start
+![AgentHub Web Interface](./docs/image.png)
 
-### Installation
+## 🚀 3 步上手
 
-```bash
-# Clone the repository
-git clone https://github.com/agenthub/agenthub.git
-cd agenthub
+### 第一步：安装
 
-# Install dependencies
-npm install
+```bash
+# 通过 npm 全局安装
+npm install -g @zshuangmu/agenthub
 
-# Link globally (optional)
-npm link
+# 或克隆源码
+git clone https://github.com/itshaungmu/AgentHub.git
+cd AgentHub && npm install && npm link
 ```
 
-### Basic Usage
+### 第二步：打包并发布你的 Agent
 
 ```bash
-# 1. Pack your agent
-agenthub pack --workspace ./my-agent --config openclaw.json
+# 1. 打包你的 OpenClaw workspace
+agenthub pack --workspace ./my-workspace --config openclaw.json
 
-# 2. Publish to registry
+# 2. 发布到 Registry
 agenthub publish ./bundles/my-agent.agent --registry ./.registry
+```
 
-# 3. Start web interface
+### 第三步：团队成员安装使用
+
+```bash
+# 团队成员一键安装
+agenthub install my-agent --registry ./.registry --target-workspace ./workspace
+
+# 或启动 Web 界面浏览
 agenthub serve --registry ./.registry --port 3000
 ```
 
-Visit http://localhost:3000 to see your agents!
-
-## 📖 Documentation
-
-### Commands
-
-| Command | Description |
-|---------|-------------|
-| `pack` | Pack workspace into Agent Bundle |
-| `publish` | Publish to local registry |
-| `publish-remote` | Publish to remote server |
-| `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 |
+访问 http://localhost:3000 查看你的 Agent！
+
+---
+
+## 📖 命令文档
+
+### CLI 命令
+
+| 命令 | 描述 |
+|------|------|
+| `pack` | 打包 workspace 为 Agent Bundle |
+| `publish` | 发布到本地 Registry |
+| `publish-remote` | 发布到远程服务器 |
+| `search` | 搜索 Registry 中的 Agent |
+| `info` | 查看 Agent 详情 |
+| `install` | 安装 Agent 到 workspace |
+| `list` | 列出已安装的 Agent |
+| `verify` | 校验已安装 Agent 是否完整 |
+| `versions` | 查看 Agent 版本历史 |
+| `update` | 更新 Agent 到最新版 |
+| `rollback` | 回滚 Agent 到指定版本 |
+| `stats` | 查看 Agent 统计信息 |
+| `serve` | 启动 Web + API 服务 |
+| `api` | 仅启动 API 服务 |
+| `web` | 仅启动 Web 前端 |
 
 ### HTTP API
 
 ```bash
-# List all agents
+# 列出所有 Agent
 curl http://localhost:3001/api/agents
 
-# Search agents
+# 搜索 Agent
 curl "http://localhost:3001/api/agents?q=react"
 
-# Get agent details
+# 获取 Agent 详情
 curl http://localhost:3001/api/agents/my-agent
 
-# Get statistics
+# 获取统计信息
 curl http://localhost:3001/api/stats
 ```
 
-### AI Auto-Discovery
+### AI 自动发现
 
-Let your AI assistant automatically discover available agents:
+让你的 AI 助手自动发现可用的 Agent：
 
 ```bash
 curl http://localhost:3001/api/skills/agenthub-discover
 ```
 
-## 🏗️ Architecture
+## 🏗️ 架构
 
 ```
 ┌─────────────────┐     pack      ┌─────────────────┐    publish    ┌─────────────────┐
@@ -136,45 +152,45 @@ curl http://localhost:3001/api/skills/agenthub-discover
                                   └─────────────────┘
 ```
 
-## 🧪 Development
+## 🧪 开发
 
 ```bash
-# Run tests
+# 运行测试
 npm test
 
-# Start development server
+# 启动开发服务器
 node src/cli.js serve --registry ./.registry
 ```
 
-## 🐳 Docker Deployment
+## 🐳 Docker 部署
 
 ```bash
-# Production start (in container)
+# 生产环境启动（容器内）
 NODE_ENV=production node src/cli.js serve --registry ./.registry --port 3000 --host 0.0.0.0
 ```
 
-## 🤝 Contributing
+## 🤝 贡献
 
-We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+欢迎贡献！请查看 [CONTRIBUTING.md](CONTRIBUTING.md) 了解详情。
 
-- 🐛 [Report a Bug](https://github.com/agenthub/agenthub/issues/new?template=bug_report.md)
-- 💡 [Request a Feature](https://github.com/agenthub/agenthub/issues/new?template=feature_request.md)
-- 🔧 [Submit a Pull Request](https://github.com/agenthub/agenthub/pulls)
+- 🐛 [报告 Bug](https://github.com/itshaungmu/AgentHub/issues/new?template=bug_report.md)
+- 💡 [请求功能](https://github.com/itshaungmu/AgentHub/issues/new?template=feature_request.md)
+- 🔧 [提交 PR](https://github.com/itshaungmu/AgentHub/pulls)
 
-## 📄 License
+## 📄 许可证
 
 [MIT License](LICENSE) © AgentHub Team
 
-## 🙏 Acknowledgments
+## 🙏 致谢
 
-- Built for [OpenClaw](https://github.com/openclaw) ecosystem
-- Inspired by npm and Docker Hub
+- 为 [OpenClaw](https://github.com/openclaw) 生态系统构建
+- 灵感来自 npm 和 Docker Hub
 
 ---
 
 <div align="center">
 
-**[⬆ Back to Top](#agenthub)**
+**[⬆ 返回顶部](#agenthub)**
 
 Made with ❤️ by the AgentHub Team
 

package/package.json

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

package/src/cli.js

@@ -28,6 +28,8 @@ import {
   formatVersionsOutput,
 } from "./index.js";
 
+import { success, error, warning, info as infoColor, highlight, muted, symbols } from "./lib/colors.js";
+
 import { createRequire } from "node:module";
 const require = createRequire(import.meta.url);
 const VERSION = require("../package.json").version;
@@ -40,7 +42,7 @@ const VERSION = require("../package.json").version;
  */
 function requireArg(arg, message) {
   if (!arg) {
-    console.error(message);
+    console.error(error(message));
     process.exitCode = 1;
     return false;
   }
@@ -313,38 +315,38 @@ async function main() {
     switch (command) {
       case "pack": {
         if (!options.workspace || !options.config) {
-          console.error("错误: --workspace 和 --config 是必需的");
-          console.log("\n运行 'agenthub pack --help' 查看帮助");
+          console.error(error("错误: --workspace 和 --config 是必需的"));
+          console.log(muted("\n运行 'agenthub pack --help' 查看帮助"));
           process.exitCode = 1;
           return;
         }
         const result = await packCommand(options);
-        console.log(`✓ 打包完成: ${result.bundleDir}`);
+        console.log(success(`${symbols.success} 打包完成: ${result.bundleDir}`));
         return;
       }
 
       case "publish": {
         if (!requireArg(rest[0], "错误: 需要指定 bundle 目录")) return;
         const result = await publishCommand(rest[0], options);
-        console.log(`✓ 已发布 ${result.slug}@${result.version}`);
+        console.log(success(`${symbols.success} 已发布 ${highlight(`${result.slug}@${result.version}`)}`));
         return;
       }
 
       case "publish-remote": {
         if (!requireArg(rest[0], "错误: 需要指定 bundle 目录")) return;
         const result = await publishRemoteCommand(rest[0], options);
-        console.log(`✓ 已发布到远程 ${result.slug}@${result.version}`);
+        console.log(success(`${symbols.success} 已发布到远程 ${highlight(`${result.slug}@${result.version}`)}`));
         return;
       }
 
       case "search": {
         const results = await searchCommand(rest[0] || "", options);
         if (results.length === 0) {
-          console.log("未找到匹配的 Agent");
+          console.log(warning("未找到匹配的 Agent"));
         } else {
-          console.log(`\n找到 ${results.length} 个 Agent:\n`);
+          console.log(`\n${infoColor(`找到 ${results.length} 个 Agent:`)}\n`);
           for (const entry of results) {
-            console.log(`  ${entry.slug}@${entry.version} - ${entry.description || ""}`);
+            console.log(`  ${highlight(entry.slug)}${muted("@")}${entry.version} ${muted("-")} ${entry.description || ""}`);
           }
         }
         return;
@@ -353,23 +355,23 @@ async function main() {
       case "info": {
         if (!requireArg(rest[0], "错误: 需要指定 agent slug")) return;
         const result = await infoCommand(rest[0], options);
-        console.log(`\n📦 ${result.name} (${result.slug}@${result.version})`);
+        console.log(`\n${highlight("📦")} ${result.name} (${result.slug}@${result.version})`);
         console.log(`   ${result.description}`);
-        console.log(`   Runtime: ${result.runtime?.type || "openclaw"} ${result.runtime?.version || ""}`);
+        console.log(`   ${muted("Runtime:")} ${result.runtime?.type || "openclaw"} ${result.runtime?.version || ""}`);
         const mem = result.includes?.memory || {};
         if (mem.count > 0) {
-          console.log(`   Memory: ${mem.count} 条 (public: ${mem.public}, portable: ${mem.portable})`);
+          console.log(`   ${muted("Memory:")} ${mem.count} 条 (public: ${mem.public}, portable: ${mem.portable})`);
         }
-        console.log(`\n   安装命令: agenthub install ${result.slug}`);
+        console.log(`\n   ${infoColor("安装命令:")} agenthub install ${result.slug}`);
         return;
       }
 
       case "install": {
         if (!requireArg(rest[0], "错误: 需要指定 agent slug")) return;
-        console.log(`\n📥 正在安装 ${rest[0]}...\n`);
+        console.log(`\n${infoColor("📥 正在安装")} ${highlight(rest[0])}...\n`);
         const installResult = await installCommand(rest[0], options);
-        console.log(`✓ 已安装 ${installResult.manifest.slug}@${installResult.manifest.version}`);
-        console.log(`  位置: ${options.targetWorkspace || "当前目录"}`);
+        console.log(success(`${symbols.success} 已安装 ${highlight(`${installResult.manifest.slug}@${installResult.manifest.version}`)}`));
+        console.log(`  ${muted("位置:")} ${options.targetWorkspace || "当前目录"}`);
         return;
       }
 
@@ -418,11 +420,11 @@ async function main() {
 
       case "serve": {
         const result = await serveCommand(options);
-        console.log(`Server listening at ${result.baseUrl}`);
-        console.log(`\n🌐 AgentHub 服务已启动`);
-        console.log(`   地址: ${result.baseUrl}`);
-        console.log(`   API:  ${result.baseUrl}/api/agents`);
-        console.log(`\n按 Ctrl+C 停止服务\n`);
+        console.log(success(`Server listening at ${result.baseUrl}`));
+        console.log(`\n${highlight("🌐 AgentHub 服务已启动")}`);
+        console.log(`   ${muted("地址:")} ${result.baseUrl}`);
+        console.log(`   ${muted("API:")}  ${result.baseUrl}/api/agents`);
+        console.log(`\n${muted("按 Ctrl+C 停止服务")}\n`);
 
         const shutdown = async () => {
           process.off("SIGINT", shutdown);
@@ -438,12 +440,12 @@ async function main() {
       case "api": {
         const port = options.port || "3001";
         const result = await apiCommand({ ...options, port });
-        console.log(`Server listening at ${result.baseUrl}`);
-        console.log(`\n🔧 API 服务已启动`);
-        console.log(`   地址: ${result.baseUrl}`);
-        console.log(`   端点: ${result.baseUrl}/api/agents`);
-        console.log(`   统计: ${result.baseUrl}/api/stats`);
-        console.log(`\n按 Ctrl+C 停止服务\n`);
+        console.log(success(`Server listening at ${result.baseUrl}`));
+        console.log(`\n${highlight("🔧 API 服务已启动")}`);
+        console.log(`   ${muted("地址:")} ${result.baseUrl}`);
+        console.log(`   ${muted("端点:")} ${result.baseUrl}/api/agents`);
+        console.log(`   ${muted("统计:")} ${result.baseUrl}/api/stats`);
+        console.log(`\n${muted("按 Ctrl+C 停止服务")}\n`);
 
         const shutdown = async () => {
           process.off("SIGINT", shutdown);
@@ -460,11 +462,11 @@ async function main() {
         const port = options.port || "3000";
         const apiBase = options.apiBase || "http://127.0.0.1:3001";
         const result = await webCommand({ port, apiBase });
-        console.log(`Server listening at ${result.baseUrl}`);
-        console.log(`\n🌐 Web 服务已启动`);
-        console.log(`   地址: ${result.baseUrl}`);
-        console.log(`   API:  ${apiBase}`);
-        console.log(`\n按 Ctrl+C 停止服务\n`);
+        console.log(success(`Server listening at ${result.baseUrl}`));
+        console.log(`\n${highlight("🌐 Web 服务已启动")}`);
+        console.log(`   ${muted("地址:")} ${result.baseUrl}`);
+        console.log(`   ${muted("API:")}  ${apiBase}`);
+        console.log(`\n${muted("按 Ctrl+C 停止服务")}\n`);
 
         const shutdown = async () => {
           process.off("SIGINT", shutdown);
@@ -478,15 +480,15 @@ async function main() {
       }
 
       default:
-        console.error(`未知命令: ${command}`);
-        console.log("\n运行 'agenthub --help' 查看可用命令");
+        console.error(error(`未知命令: ${command}`));
+        console.log(muted("\n运行 'agenthub --help' 查看可用命令"));
         process.exitCode = 1;
     }
-  } catch (error) {
+  } catch (err) {
     // 提取更详细的错误信息
-    const causeMsg = error.cause?.errors?.[0]?.message || error.cause?.message || "";
-    const detailMsg = causeMsg ? `${error.message}\n   原因: ${causeMsg}` : error.message;
-    console.error(`\n❌ 错误: ${detailMsg}`);
+    const causeMsg = err.cause?.errors?.[0]?.message || err.cause?.message || "";
+    const detailMsg = causeMsg ? `${err.message}\n   原因: ${causeMsg}` : err.message;
+    console.error(`\n${error(`${symbols.error} 错误:`)} ${detailMsg}`);
     process.exitCode = 1;
   }
 }

package/src/lib/colors.js

@@ -0,0 +1,60 @@
+/**
+ * Terminal Colors Utility
+ * 简单的终端颜色支持（无需额外依赖）
+ */
+
+// 检测是否支持颜色
+const supportsColor = process.stdout.isTTY && process.env.NO_COLOR === undefined;
+
+// ANSI 颜色代码
+const codes = {
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
+  dim: "\x1b[2m",
+  red: "\x1b[31m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  blue: "\x1b[34m",
+  magenta: "\x1b[35m",
+  cyan: "\x1b[36m",
+  white: "\x1b[37m",
+};
+
+/**
+ * 创建颜色函数
+ */
+function colorize(code) {
+  return (text) => supportsColor ? `${code}${text}${codes.reset}` : text;
+}
+
+// 导出颜色函数
+export const colors = {
+  reset: (text) => text,
+  bold: colorize(codes.bold),
+  dim: colorize(codes.dim),
+  red: colorize(codes.red),
+  green: colorize(codes.green),
+  yellow: colorize(codes.yellow),
+  blue: colorize(codes.blue),
+  magenta: colorize(codes.magenta),
+  cyan: colorize(codes.cyan),
+  white: colorize(codes.white),
+};
+
+// 语义化颜色
+export const success = (text) => colors.green(text);
+export const error = (text) => colors.red(text);
+export const warning = (text) => colors.yellow(text);
+export const info = (text) => colors.cyan(text);
+export const highlight = (text) => colors.bold(colors.cyan(text));
+export const muted = (text) => colors.dim(text);
+
+// 常用符号
+export const symbols = {
+  success: supportsColor ? "✓" : "[OK]",
+  error: supportsColor ? "✗" : "[ERR]",
+  warning: supportsColor ? "⚠" : "[!]",
+  info: supportsColor ? "ℹ" : "[i]",
+  arrow: supportsColor ? "→" : "->",
+  bullet: supportsColor ? "•" : "*",
+};