Hyperkit-Labs/hyperagent

## 目录 - [概述](#overview) - [第一阶段 (封闭测试)](#phase-1-closed-beta) - [架构](#architecture) - [功能特性](#features) - [快速开始](#quick-start) - [文档](#documentation) - [贡献指南](#contributing) - [许可证](#license) - [支持](#support) - [致谢](#acknowledgments) ## 概述 HyperAgent 是一个 AI 驱动的多智能体平台，可将自然语言规范转化为可生产部署、经过审计、模拟和部署的智能合约，覆盖多个 EVM 网络。该系统采用微服务和服务导向架构 (SOA)。智能体通过 Agent2Agent (A2A) 协议进行通信，并使用 ERC-8004 链上注册表进行身份、声誉和验证。LLM 访问采用 BYOK 模式：用户工作负载不使用服务器端 LLM 密钥；密钥存储在隔离的加密环境中，仅用于该用户的运行任务。 **目标：** 使端到端智能合约开发可验证、可重复且安全。开发者从“英文构思”到部署并监控合约，尽可能减少手动步骤，同时在必要处保留可审计性和人工监督。 ## 第一阶段 (封闭测试) **当前阶段：** 封闭测试 v0.1.0 - 基于 Web 的 IDE (HyperAgent Studio) - 默认公开，经用户测试 - SKALE Base 网络 (SKALE Base 主网, SKALE Base Sepolia 测试网)。默认网络：Sepolia。 **用户流程：** 连接 (钱包) → BYOK (提供 LLM 密钥：Gemini, OpenAI, Claude, OpenRouter) → 批准 → 运行完整流水线 (规范、生成、审计、Tenderly 模拟和报告、部署（如适用）)。Tenderly 模拟和报告是可见工作流的一部分。用户可以随时移除密钥配置；密钥将被彻底清除，无长期暴露风险。 ## 架构 **三层结构：** 客户端 Shell、编排/智能体 和核心服务。智能体是具有明确输入/输出 schema 的独立服务；它们通过 A2A 进行通信，并使用兼容 ERC-8004 的链上注册表。 **核心技术栈：** Python/FastAPI, Next.js/React/TypeScript, Supabase (PostgreSQL), VectorDB (e.g., Pinecone), Redis, Acontext, Docker, Tenderly。智能合约工具：Hardhat, Foundry, Thirdweb SDK。 **流水线：** SpecAgent (版本化 Spec Lock) → 设计和提案智能体 → CodegenAgent (流式护栏) → Autofixer 和审计智能体 (Slither, Mythril, MythX, Echidna) → TenderlySimAgent → DeployAgent 和 VerifyAgent → MonitorAgent。安全性通过 Spec Lock、Tenderly 的模拟优先验证以及强制性安全工具来保障。 **部署：** Vercel (前端), Contabo/Coolify (后端)。 **网络：** SKALE Base 路线图包括 Mantle, Avalanche, BNB, Arbitrum 以及其他 EVM 兼容链，通过链注册表和 SDK 能力注册表 (x402, AA, Thirdweb 一流支持) 实现。 ## 功能特性 - **自然语言转合约** – 用通俗语言描述行为；获取 Solidity 代码、测试和可审计的构件。 - **BYOK** – 自带 LLM 密钥 (OpenAI, Anthropic, Google, OpenRouter)；用户工作负载无服务器端 LLM 配置。 - **模拟优先** – 集成 Tenderly，在部署前进行交易模拟和生成报告。 - **安全工具** – Slither, Mythril, MythX, Echidna 作为强制性流水线阶段。 - **多链** – 用于即插即用网络的链和 SDK 注册表 - **账户抽象** – 通过 Thirdweb 实现 ERC-4337 和 EIP-7702；在配置处使用 x402 计量。 - **可观测性** – OpenTelemetry, MLflow, Tenderly 监控, Dune 仪表板。 - **RAG 和记忆** – 精选语料库和 Acontext 用于长期智能体记忆；IPFS/Pinata, Arweave, Filecoin 用于存储构件。 ## 快速开始 ### 前置条件 - Node.js 18 或更高版本 - pnpm 8 或更高版本 - Git - (可选) Python 3.11+, Docker (用于后端) ### 安装说明 1. **克隆仓库** git clone https://github.com/Hyperkit-Labs/hyperagent.git cd hyperagent 2. **安装依赖** pnpm install 3. **设置环境** - 本地开发：将 `.env.development.example` 复制为 `.env`。生产环境：将 `.env.example` 复制为 `.env` 或 `.env.production`。 - 设置 `NEXT_PUBLIC_THIRDWEB_CLIENT_ID` 和 `NEXT_PUBLIC_API_URL` (例如 `http://localhost:4000` 对应 Docker 后端)。 4. **启动前端 (Studio)** pnpm --filter hyperagent-studio dev 打开 [http://localhost:3000](http://localhost:3000)。 5. **后端 (可选)** 如果提供了后端 (例如 API + Docker)，请按照其运行说明进行操作，以便 API 在 `NEXT_PUBLIC_API_URL` 设置的 URL 处可用。Web 应用程序调用该 URL 以进行工作流和数据处理。 有关完整的设置和使用，请参阅 [入门指南](docs/getting-started.md) 和 [开发者指南](docs/developer-guide.md)。 ## 文档 - [文档索引](docs/README.md) – 入门、用户和开发者信息。 - [入门指南](docs/getting-started.md) – 首次设置和本地运行。 - [用户指南](docs/user-guide.md) – 如何使用 HyperAgent Studio (连接、BYOK、运行工作流)。 - [开发者指南](docs/developer-guide.md) – 仓库结构、本地设置、贡献。 - [平台蓝图](external/docs/detailed/draft.md) – 完整规范 (SOA, A2A, ERC-8004, 流水线, 注册表)。 - [项目详情](external/docs/detailed/Project%20Details.md) – 目标、架构、技术栈、路线图。 ## 许可证 本项目根据 MIT 许可证授权。详见 [LICENSE](LICENSE)。 ## 支持 - [文档](docs/README.md) – 入门、用户指南、开发者指南。 - [GitHub Issues](https://github.com/Hyperkit-Labs/hyperagent/issues) – 报告 Bug 或请求功能。 - [GitHub Discussions](https://github.com/Hyperkit-Labs/hyperagent/discussions) – 问题和想法。 ## 致谢 **核心栈：** [FastAPI](https://fastapi.tiangolo.com/), [Next.js](https://nextjs.org/), [Supabase](https://supabase.com/), [pnpm](https://pnpm.io/), [Turbo](https://turbo.build/). **Web3:** [Thirdweb](https://thirdweb.com/) (x402, 账户抽象), [Mantle](https://www.mantle.xyz/), [Pinata](https://www.pinata.cloud/) (IPFS). **LLM 提供商 (BYOK):** [Anthropic](https://www.anthropic.com/), [OpenAI](https://openai.com/), [Google Gemini](https://deepmind.google/technologies/gemini/), [OpenRouter](https://openrouter.ai/). 密钥由用户提供并存储在隔离的加密环境中；用户工作负载不使用服务器端 LLM 密钥。

标签：Agent2Agent协议, ERC-8004, EVM, GNU通用公共许可证, HyperAgent, IDE, Node.js, PyRIT, Python, SOA, Solidity, StruQ, Web3, 人工智能, 低代码/无代码, 加密货币, 区块链, 去中心化应用, 多智能体系统, 威胁情报, 开发者工具, 微服务架构, 搜索引擎查询, 无后门, 智能合约安全, 智能合约开发, 服务器监控, 测试用例, 特权提升, 生产就绪, 用户模式Hook绕过, 自动化攻击, 自动化部署, 请求拦截, 跨链, 逆向工具, 金融科技