Hephaestus

<p align="center"> <a href="https://agentlas.cloud"> <img src="assets/agentlas-agent-lab-banner.svg" alt="Agentlas Agent Lab banner"> </a> </p> <h1 align="center">赫菲斯图斯 — 模型无关的智能体操作系统</h1> <p align="center"> <strong>停止为每个任务构建和配置新的智能体。赫菲斯图斯将专业智能体存储在中心，并为每个任务创建一个临时编排器。</strong><br> 优先考虑本地运行，适用于任何模型 — Claude Code、Codex、Gemini、Cursor，以及本地模型。 </p> <p align="center"> <a href="https://github.com/agentlas-ai/Hephaestus/releases/latest"> <img alt="最新发布版本" src="https://img.shields.io/github/v/release/agentlas-ai/Hephaestus?label=release"> </a> <a href="LICENSE"> <img alt="许可证：Apache-2.0" src="https://img.shields.io/badge/license-Apache--2.0-green"> </a> <img alt="运行时" src="https://img.shields.io/badge/runtimes-Claude%20Code%20%7C%20Codex%20%7C%20Gemini%20%7C%20Antigravity%20%7C%20Cursor%20%7C%20DeepSeek%20%7C%20GLM%20%7C%20Ollama%20%7C%20Terminal-black"> </p> <p align="center"> <a href="README.md">English</a> · <a href="README.ko.md">Korean</a> · <a href="README.zh-CN.md">中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.hi.md">हिन्दी</a> </p> <p align="center"> <img src="assets/hephaestus-network-mcp-demo.gif" alt="赫菲斯图斯网络2.0通过MCP将任务实时路由到正确的智能体" width="760"> </p> <p align="center"> _{从中心提取专家，组装成临时任务队伍，并通过MCP路由 — 无需为每个任务设置智能体。} </p> ## 快速入门 ```bash curl -fsSL https://raw.githubusercontent.com/agentlas-ai/Hephaestus/main/scripts/install-all-runtimes.sh | bash ``` 此命令安装中立的运行程序，并为Claude Code、Codex、Gemini CLI、Antigravity和Cursor注册命令适配器。您更喜欢插件、手动复制或让AI为您安装吗？请参阅[所有安装方法](#所有安装方法)。 <p align="center"> <a href="#智能体操作系统时代">智能体操作系统时代</a> · <a href="#快速入门">快速入门</a> · <a href="#所有安装方法">所有安装方法</a> · <a href="#命令界面">命令界面</a> · <a href="#v1.1.0中的新增功能--简报访谈引擎">v1.1.0中的新增功能 -- 简报访谈引擎</a> · <a href="#操作系统子系统">子系统</a> · <a href="#企业运营">企业运营</a> · <a href="#系统打包">系统打包</a> · <a href="#文档注册表">文档注册表</a> · <a href="#桌面外壳--agentlas桌面">桌面外壳 -- Agentlas桌面</a> </p> --- ## 智能体操作系统时代 行业已经从无状态、临时“带有工具的聊天机器人”发展而来。随着谷歌和主要AI实验室围绕**智能体操作系统**（如Antigravity编排平台和Gemini Spark守护进程）重构开发者策略，AI智能体正式成为一流的操作系统原语 — 长寿命、有状态的进程，具有不同的身份、关系内存系统、安全权限和原生工具调用环境。 这改变了团队的关键工程问题：**您的劳动力运行在哪个操作系统上？** 如果您的智能体紧密耦合到单个模型提供商的专有API，您的组织内存、自定义工具和任务特定逻辑实际上被锁定在该供应商的生态系统中。 **赫菲斯图斯是独立的、与模型无关的内核。** 它不是智能体框架或API包装器。它是一个优先考虑本地运行的智能体操作系统 — 一个统一的执行基质，用于编译、调度和管理跨任何主机运行时的可移植智能体进程。交换底层推理引擎；保留整个劳动力。 赫菲斯图斯直接映射到经典的操作系统概念： | 操作系统抽象 | 赫菲斯图斯实现 | | :--- | :--- | | **内核/策略门** | 确定性路由器 + 安全门。每个路由操作都会产生一个可审计的收据；工具执行权限严格沙盒化并由主机运行时强制执行。 | | **进程/线程** | 独立智能体和多智能体团队编译为具有显式、类型化契约的包（路由卡、反作用域、内存边界和验证垫片）。 | | **进程调度器** | 网络2.0路由（本地优先、质量门控和基准门控调度）与Stormbreaker的并行执行结构和仅追加运行日志相结合。 | | **内存管理（MMU）** | 双边界管理的内存：本地项目内存保留在机器上，而持久提升由本地内存管理者控制。 | | **虚拟文件系统** | 生产本体运行时：本地源摄取、CJK trigram FTS5搜索、混合互惠排名融合和GraphRAG检索。 | | **进程间调用（IPC）** | A2A智能体卡边界（加密导入/导出和调用者门控）+ 模型上下文协议（MCP）工具注册。 | | **包管理器** | Agentlas中心和云：编译、发布、版本和共享智能体，并具有内置的质量门控。 | | **外壳接口** | 外部客户端运行时中的小型统一六命令CLI；原生Agentlas外壳中的纯语言意图路由。 | | **进程初始化** | 带有集成简报访谈门的Meta-Agent工厂 — 在编译代码之前指定智能体参数。 | <p align="center"> <img src="assets/agentlas-meta-agent-architecture.svg" alt="图1. Agentlas Meta-Agent架构分解"> </p> <p align="center"> _{图1. 请求塑形、三构建器、生成的包契约、内存管理、技能生命周期、运行时适配器和同步边界。} </p> --- ## v1.1.0中的新增功能 — 简报访谈引擎 由模糊的单句提示生成的智能体会因现实世界的边缘情况而失败。赫菲斯图斯v1.1.0通过**简报访谈引擎**将任务规范定位为一流的操作系统服务： * **量化模糊门控：** 编译调度器在四个关键向量（目标、约束、范围、上下文）上评估提示清晰度。构建过程严格受到门控，直到模糊度得分通过数值阈值（模糊度得分$\le 0.2$，每个维度有安全底线）。清晰的提示直接绕过访谈循环，通过预算系统限制简单任务的提问次数。 * **基于镜头的系统分析：** 澄清问题动态来源于结构化的镜头表（范围、意图、挑战、系统架构），聚焦于关键路由指标：*反作用域边界*（智能体必须**不**执行的操作）、*可验证的验收标准*和*退出条件*。 * **工作简介：** 解析的详细信息冻结为`.agentlas/work-brief.json` — 记录验证的目标、具体约束、带有源标签的假设账本和元数据模糊度得分。 * **上下文飞行简介：** CLI工具`cards migrate`自动将简介详细信息映射到智能体的路由卡上的触发器和反触发器。运行`route --brief`将简介传播到Stormbreaker执行包，确保约束和退出条件控制整个生命周期中的并行子进程。 * **增强的路由判别：** 通过访谈验证的反触发器和路由卡上的低置信度LLM重新排序升级，防止相同主题不同意图的冲突（例如，安全智能体拦截部署提示）。 --- ## 所有安装方法 ### 粘贴安装（让您的AI为您安装） 将此内容粘贴到Claude Code、Codex、Gemini CLI、Antigravity或Cursor中： ```text 为此工作空间从此GitHub仓库安装赫菲斯图斯Agentlas： https://github.com/agentlas-ai/Hephaestus 使用最新的发布/说明。如果出现任何错误，请诊断并修复，然后重试，并确认在此工具中激活了哪个命令界面： - Agentlas终端/桌面原生支持纯语言路由。 - 外部LLM主机暴露的命令 exactly 六个：build、network、cloud、search、call、upload。 ``` ### macOS检查 ```bash xcode-select --install # 命令行工具（如果已安装则跳过） git --version # 确认git可用 ``` ### 所有运行时的单个终端命令 ```bash curl -fsSL https://raw.githubusercontent.com/agentlas-ai/Hephaestus/main/scripts/install-all-runtimes.sh | bash ``` 此命令在`~/.agentlas/runtime/current/bin/hephaestus`安装中立的运行程序，并为Claude Code、Codex、Gemini CLI、Antigravity和Cursor注册命令适配器。安装程序在注册后验证每个运行时表面。 ### 每个运行时的插件驱动程序 <details> <summary>Claude Code插件</summary> 从您的操作系统终端： ```bash claude plugin marketplace add https://github.com/agentlas-ai/Hephaestus --sparse .claude-plugin claude/plugins claude plugin install hephaestus@agentlas-core-engine ``` *注意：Claude Code也支持`claude plugins ...`作为别名，但本README使用一致的`claude plugin ...`。* </details> <details> <summary>Codex插件</summary> 从您的操作系统终端： ```bash codex plugin marketplace add agentlas-ai/Hephaestus --ref v1.1.0 codex plugin add hephaestus@agentlas-core-engine ``` *注意：Codex不接受`/plugin marketplace add`在应用程序内 — 在您的操作系统终端运行上述两个命令。操作系统终端CLI命令是单数（`codex plugin`）；在Codex应用程序中，插件浏览器斜杠命令是复数（`/plugins`). 安装后，`/prompts:hep-build`是应用程序内的入口。* </details> <details> <summary>复制文件到项目（手动驱动程序）</summary> 克隆仓库并复制`AGENTS.md`、`agent.md`、`agents/`、`skills/`、`modes/`、`schemas/`、`templates/`和`.agentlas/`到您的工作空间。运行时文件夹（`.claude/`、`codex/`、`gemini/`、`agents/`）作为同一规范核心的适配器。 </details> **直接对话：** 安装后，在原生Agentlas界面内使用纯语言对话自动路由任务。在外部主机工具中使用以下六个显式命令。当您不知道存在哪些智能体时，请从`/hep-search`开始。 --- ## 命令界面 在原生Agentlas环境中，赫菲斯图斯操作无命令。外部LLM主机使用一个故意设计的、小型的可见命令集。Stormbreaker、研究负载和配置表等系统级实用程序从上下文中自动附加： | 系统子系统 | Shell命令 | 示例 | | :--- | :--- | :--- | | **进程构建器** | `/hep-build` | `/hep-build create a customer support agent for Shopify refunds` | | **A2A调度器** | `/hep-network` | `/hep-network split this launch plan into research, copy, QA, and release agents` | | **云状态同步** | `/hep-cloud` | `/hep-cloud use my saved finance analyst agent to review this report` | | **目录搜索** | `/hep-search` | `/hep-search find agents for a market report workflow` | | **进程间调用（IPC）** | `/hep-call` | `/hep-call market-researcher, report-writer {draft a market report}` | | **包导出器** | `/hep-upload` | `/hep-upload ./agents/customer-support-hq` | --- ## 桌面外壳 — Agentlas桌面 [Agentlas桌面](https://agentlas.cloud/desktop)是此智能体操作系统的图形外壳 — 相同的内核、调度器和治理子系统，通过视觉操作。桌面0.6.0版附带赫菲斯图斯v1.1.0引擎捆绑和固定；应用程序及其内核版本锁定在一起，作为一个单元自动更新。 | 外壳表面 | 它操作什么 | | :--- | :--- | | **聊天工作区** | 与任何运行时绑定到原生语言 — Claude Code、Codex、Gemini CLI、Antigravity、BYOK API（DeepSeek、GLM、Kimi）或本地Ollama — 具有实时流媒体、控制队列和每个聊天的工作文件夹。 | | **构建菜单** | UI背后的Meta-Agent工厂：访谈门控构建（批处理提问问题渲染为原生问题卡），然后磁盘上的实际包文件。 | | **智能体库和中心** | 您编译的智能体、团队和借用的中心专家 — 安装、版本、发布和在Agentlas中心包注册表中定价。 | | **任务队伍和集群** | 借用的多智能体任务队伍、并行集群执行，具有机器规格的并发度滑块，以及长生命周期作业的连续实时运行。 | | **自动化** | cron/event/file-watch触发器编译为并行DAG工作流，具有可视化图形编辑器 — 调度智能体进程，以操作系统术语表示。 | | **内存和进化面板** | 治理内存子系统可见：管理票证、提升的剧本、自我进化提案和安全重新扫描。 | 桌面外壳强制执行与CLI相同的边界：BYOC在您的机器上执行和您的订阅，路由决策的收据和本地优先内存。下载：[agentlas.cloud/desktop](https://agentlas.cloud/desktop)。 --- ## 操作系统子系统 ### Meta-Agent工厂 — 进程创建 一个统一的编译工厂，使用三个构建器。每个生成的包都注册其全局命令（`.agentlas/global-commands.json`)并附带验证脚本 — 用户无需推断如何运行编译包： | 编译模式 | 路由目标 | 输出工件 | | :--- | :--- | | **单智能体** | `10-single-agent-builder` | 具有本地化技能、内存契约和运行时适配器的独立工作者。 | | **多智能体团队** | `20-multi-agent-team-builder` | 包含PM Orchestrator、内存管理者、策略门、QA和验证脚本的层次结构团队。 | | **工作空间打包器** | `30-agentlas-packager` | 编译的包，准备好桌面导入、CLI执行或GitHub分发。 | *简报访谈门：* 构建器使用**简报访谈门**启动进程：进行基于镜头的提问、评估模糊度阈值、搜索主要来源并输出工作简介。 --- ### 网络2.0 — 调度器 <p align="center"> <img src="assets/hephaestus-network-architecture.svg" alt="图2. 赫菲斯图斯网络2.0 A2A网络架构"> </p> _{图2. A2A调度：主机运行时、本地调度器、路由卡、本地内存和Agentlas中心A2A/MCP后备。} * **路由卡：** 每个智能体、团队和插件都附带一个标准化的卡，包含触发器、反触发器、功能、风险配置文件和内存参数。验证失败的卡将被排除路由。 * **本地优先调度：** 调度在本地解决（项目覆盖$\rightarrow$本地卡）。外部查找通过Agentlas中心被减少为关键词；您的原始提示永远不会离开您的本地环境。 * **临时任务队伍：** 复合请求分解为中心/本地任务队伍计划，包装Stormbreaker信封、会话提示和本体路径。命名专家动态调度，临时编排器管理任务交接。 * **收据驱动执行：** 每个路由决策都写入收据。路由器仅确定要调用哪个智能体或包；工具执行权限严格沙盒化并由主机运行时管理。 * **双语基准测试：** 自动路由受双语（韩语 + 英语）基准测试的约束，要求top-3召回率$\ge 90\%$且无隐私泄露。置信度低的路径升级到主机级路由器重新排序。 详情：[docs/hephaestus-network-2.0.md](docs/hephaestus-network-2.0.md) · 运行时支持矩阵：[docs/runtime-fallback-adapters.md](docs/runtime-fallback-adapters.md) --- ### Stormbreaker — 有纪律的执行 Stormbreaker是智能体操作系统的执行门控子系统。它确保智能体不会报告成功或终止，直到所有结果都经过确定性检查： ```text 内核门控信封： [作用域锁定] -> [分解] -> [并行工作包] -> [验证合约] -> [有界修复] -> [最终门控] ``` 本地运行日志使长时间执行在中断后可恢复。执行包携带工作简介，以便作用域规则和退出标准控制所有并行子进程。 执行协议：[docs/robustness-protocol.md](docs/robustness-protocol.md) · 基准测试和评估：[docs/robustness-eval.md](docs/robustness-eval.md) ### 本体运行时 — 知识文件系统 对于知识密集型操作，`bin/ontology`作为语义文件系统，将非结构化本地文件转换为智能体可读的数据库堆栈： ```text 摄取文件 -> [解析适配器] -> [CJK三元组/二元组tokenization] -> [FTS5 + SQLite存储] -> [互惠排名融合] -> [GraphRAG搜索] ``` 特性支持韩文文档解析器] ``` 特征包括韩国HWPX和旧版HWP5的文档解析（无GPL依赖）。完全本地和SQLite支持；机密和私有块被隔离，防止它们到达外部云钩。 ```bash bin/ontology ingest ./corpus --scope internal bin/ontology query "Project Helios Memory Curator" --agent verifier bin/ontology memory candidates ``` 详情：[docs/ontology-runtime.md](docs/ontology-runtime.md) ``` ### 受管内存 — 精选晋升 * **本地项目内存：** 存储在 `~/.agentlas/networking/` 下，并隔离到本地机器。未经明确授权，无法导出。 * **工作区个性化：** 管理借用 Cloud/Hub 代理的个性化日志（摘要、剧本、插件锁和收据），而不存储原始提示、凭证值或私有文件。 * **策展人准入：** 技能和内存修改被视为候选。它们仅在本地策展人确认隔离/重放证明、回滚覆盖和安全策略批准后才晋升为持久状态。 --- ### A2A 边界 — 代理间隔离 标准化的 CLI 命令允许安全的代理间协调： ```bash agentlas-cloud ao a2a import ./agent-card.json . agentlas-cloud ao a2a export . --agent local/10-builder agentlas-cloud route "run the release check" --caller local/orchestrator . ``` 导入作为提案（限制自动调用），导出会编辑私有路径和逻辑，调用在路由解析之前由调用者控制。 --- ## 为企业而建 企业不需要另一种编写隔离的 Python 代理的方法。他们需要 **操作一个受管的工作队伍**。赫菲斯图斯（Hephaestus）专门为此操作模型而设计： * **模型中立性作为采购杠杆：** 代理、内存仓库和知识域存储为本地资产，由您控制。迁移到新的模型提供商（或使用本地模型，如 Ollama、Llama 和企业引擎，如 DeepSeek、GLM、Gemini 或 Claude）只需简单的配置更新，而无需代码库迁移。 * **通过建设实现审计性：** 每个路由决策、执行步骤、内存候选和策展人决策都记录为文本文件。您可以对其进行差异、审计和提交。工作被验证或标记为未经验证。 * **确定性流水线门控：** 安全过滤器、反作用范围、路由卡触发器和提示净化被硬编码到操作系统流水线中 — 它们不依赖于 LLM 系统指令或指南。 * **生成前规范：** 简报采访引擎衡量请求模糊性并在工作简报上盖章，确保任务执行始终可以审计回已同意的内容。 * **本地优先的数据边界：** 原始文本、文档和数据库文件保持本地。外部交易被编辑并选择性加入。 ### 框架的适用位置 CrewAI、LangChain 和供应商代理 SDK 作为 **库** — 适用于在单个进程中编写自定义代理逻辑。赫菲斯图斯（Hephaestus）作为 **主机基质**：它指定、打包、路由、运行、审计和迁移代理跨工作区运行时。框架代码在赫菲斯图斯（Hephaestus）包内运行；内核只需要代理遵守其目录合约和路由卡。 --- ## 它构建的内容（流程打包） 赫菲斯图斯（Hephaestus）将代理打包成标准目录布局，任何工作区运行时都可以解析、安装、验证和运行： ```text ├── AGENTS.md # 规范路由配置 ├── agent.md / agents/ # 单个工作者或团队角色 ├── skills/ # 本地代理技能和能力 ├── modes/ # 自定义代理执行模式 ├── schemas/ # 验证合约和模式 ├── templates/ # 配置模板 ├── .agentlas/ # 系统目录：路由卡、工作简报、 │ # 全局命令、内存合约、评估计划 ├── .claude/ codex/ .gemini/ .agents/ # 运行时适配器（核心驱动适配器） ├── scripts/ │ ├── verify-package.sh # 包结构验证器 │ └── public_safety_check.sh # 机密和凭证扫描器 └── docs/ # 简报记录、工具规格、 # 和提示合约 ``` --- ## 按目标划分的文档 | 系统目标 | 参考文档 | |---|---| | 了解规范路由 | [`AGENTS.md`](AGENTS.md) | | 查看完整团队合约 | [`agent.md`](agent.md) | | 架构源代码 | [`docs/source-of-truth.md`](docs/source-of-truth.md) | | 运行时边界 | [`docs/runtime-sync-boundaries.md`](docs/runtime-sync-boundaries.md) | | 简报采访和研究门控 | [`docs/builder-interview-research-gate.md`](docs/builder-interview-research-gate.md) | | 网络 2.0 路由 | [`docs/hephaestus-network-2.0.md`](docs/hephaestus-network-2.0.md) | | Stormbreaker 协议 | [`docs/robustness-protocol.md`](docs/robustness-protocol.md) | | 本体运行时 | [`docs/ontology-runtime.md`](docs/ontology-runtime.md) | | 内存架构 | [`docs/memory-architecture.md`](docs/memory-architecture.md) | | 技能生命周期晋升 | [`docs/skill-lifecycle-promotion.md`](docs/skill-lifecycle-promotion.md) | | 云运行时包 | [`docs/agentlas-cloud-runtime.md`](docs/agentlas-cloud-runtime.md) | | 验证包 | [`scripts/verify-package.sh`](scripts/verify-package.sh) | | 公共安全检查 | [`scripts/public_safety_check.sh`](scripts/public_safety_check.sh) | --- ## 公共安全边界 此存储库 **不** 包括托管的 Agentlas 计费/账户逻辑、生产云凭证、客户数据库、原始私有转录、桌面钥匙链管理器或私有部署脚本。 赫菲斯图斯（Hephaestus）编译的公共输出包必须排除本地绝对路径、API 密钥、服务账户密钥、`.env` 机密、原始转录、客户日志或私有开发人员注释。 --- ## 贡献和验证 在打开拉取请求或发布更新之前，请运行验证测试套件： ```bash scripts/verify-package.sh scripts/verify-ontology-runtime.sh scripts/public_safety_check.sh ``` --- ## License Apache-2.0. See [LICENSE](LICENSE).