Agentlas-OS

<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">Agentlas 操作系统</h1> <p align="center"> <strong>代理程序易于创建。 Agentlas 为它们提供了一个操作系统。</strong><br> 运行自有代理程序，借用 Hub 专家，控制真实浏览器，保留受控内存，并在您已使用的 LLMs 上验证工作。<br> Hephaestus 是其底层的开源引擎。 </p> <p align="center"> <a href="https://github.com/agentlas-ai/Agentlas-OS/releases/latest"> <img alt="最新发布版本" src="https://img.shields.io/github/v/release/agentlas-ai/Agentlas-OS?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="LLMs" src="https://img.shields.io/badge/LLMs-Claude%20Code%20%7C%20Codex%20%7C%20Gemini%20%7C%20Antigravity%20%7C%20Cursor%20%7C%20DeepSeek%20%7C%20GLM%20%7C%20Ollama-black"> </p> <p align="center"> <a href="README.md">英语</a> · <a href="README.ko.md">韩语</a> · <a href="README.zh-CN.md">中文</a> · <a href="README.ja.md">日语</a> · <a href="README.hi.md">印地语</a> </p> ## 粘贴安装 将以下内容粘贴到您当前使用的 LLM 中，例如 Claude Code、Codex、Gemini CLI、Antigravity 或 Cursor： ```text 从 GitHub 仓库安装 Agentlas OS / Hephaestus： https://github.com/agentlas-ai/Agentlas-OS 在插件市场中注册它，安装插件，并使 Hephaestus 插件和命令可用于我的下一个会话。如果支持全局路由，请启用它。 最后，确认活动的插件、命令界面和全局路由状态。 ``` 当您已经在 LLM 中并希望激活 Agentlas 命令界面时使用此方法。有关直接 shell 命令，请参见下面的安装方法。 <p align="center"> <img src="assets/hephaestus-network-mcp-demo.gif" alt="Hephaestus Network 2.0 将任务实时路由到正确的代理程序以通过 MCP" width="760"> </p> <p align="center"> _{借用专家，在本地路由，并在 LLMs、浏览器、文件、内存和工具中验证实际工作。} </p> <p align="center"> <a href="#为什么选择agentlas-os">为什么选择 Agentlas OS</a> · <a href="#粘贴安装">粘贴安装</a> · <a href="#为什么不直接创建一个claude代理程序">为什么不直接创建 Claude 代理程序？</a> · <a href="#所有安装方法">所有安装方法</a> · <a href="#命令界面">命令界面</a> · <a href="#v110中的新增功能-简报面试引擎">v1.1.0 中的新增功能</a> · <a href="#操作系统子系统">操作系统子系统</a> · <a href="#产品表面">产品表面</a> · <a href="#构建的系统包装">构建的系统包装</a> · <a href="#文档注册表">文档注册表</a> </p> --- ## 为什么选择 Agentlas OS 大多数 AI 产品帮助您创建另一个代理程序。 Agentlas OS 用于更难的部分：使代理程序作为一个您可以拥有的团队运行。 您应该能够在安装后想象到这一点： - 您的 LLMs 像一个团队一样工作，而不是孤立的聊天会话。 - 您的真实浏览器成为一个执行表面，而不是提示中的截图。 - 您的代理程序在聊天结束后保留软件包合同、路由卡、内存规则、权限和验证收据。 - 您现有的 Claude Code、Codex、Gemini、Cursor、Antigravity、API 密钥和本地模型成为一个操作层的部分。 - Hub 专家可以被借用到您的本地运行时，而无需复制创建者的私有工作或将您的私有文件发送到他们的代理程序。 Hephaestus 是 Agentlas OS 下面的开源引擎。 它不是一个提示市场、代理程序模板生成器或另一个模型订阅。 它是一个本地优先的运行时，它跨 LLM 命令表面构建、路由、借用、运行、验证和打包代理程序。 重点不是“从提示创建代理程序”。 重点是： > 跨 LLMs、浏览器、内存和本地工具创建、打包、路由、运行和验证代理程序。 ## 为什么不直接创建 Claude 代理程序？ Claude 子代理程序和自定义代理程序非常有用。 它们为任务提供了一个自己的提示、工具和上下文窗口。 Agentlas 从这一点开始。 LLM 可以草拟一个代理程序。 Agentlas 将其变成一个操作单元: | 层 | 由提示创建的代理程序 | Agentlas 软件包 | | --- | --- | --- | | 定义 | 角色提示、Markdown、工具列表 | 清单、代理程序卡、模式映射、软件包合同 | | 调用 | 手动提及或简单触发器 | 路由卡、触发器、反触发器、基准、收据 | | 浏览器 | 临时浏览或截图 | 真实浏览器硬点，具有可见的点击、表单、等待和快照 | | 内存 | 复制的上下文或聊天历史 | 内存映射、内存票证、内存保管人、策略门 | | 运行时 | 一个 LLM 会话或一个供应商运行时 | 跨 Claude Code、Codex、Gemini、Cursor、Antigravity 和本地运行时的适配器 | | 团队 | 另一个提示层 | 协调器、PM 灵魂、内存保管人、策略门、评估裁判、QA 门 | | 验证 | 用户手动检查 | 软件包检查、收据、Stormbreaker 最终门 | | 分发 | 复制提示 | Hub/Cloud 软件包，具有公共/私有边界检查 | 这是产品边界：Agentlas 不竞争“更好的提示”。 它为代理程序提供了一个架构，以便在一次聊天之外继续工作。 ## Agentlas 操作系统栈 Agentlas 将代理程序工作映射到类似操作系统的职责，而不强制您的工作适应一个模型提供商： | 操作系统抽象 | Hephaestus 中的实现 | | --- | --- | | **内核 / 策略门** | 确定性路由器 + 安全门。 每个路由操作都会产生一个可审计的收据；工具执行权限严格沙盒并由活动运行时强制执行。 | | **进程 / 线程** | 独立代理程序和多代理程序团队编译为具有明确、类型化的合同（路由卡、反作用域、内存边界和验证插桩）的软件包。 | | **进程调度器** | 网络 2.0 路由（本地优先、质量门控和基准门控调度）与 Stormbreaker 的并行执行结构和仅追加运行日志相结合。 | | **内存管理（MMU）** | 双边界受控内存：本地项目内存保留在机器上，而持久提升由本地内存保管人控制。 | | **虚拟文件系统** | 生产本体运行时：本地优先源摄取、CJK trigram FTS5 搜索、混合互惠排名融合和 GraphRAG 检索。 | | **进程间调用（IPC）** | A2A 代理程序卡边界（加密导入/导出和调用者门控）+ 模型上下文协议（MCP）工具注册。 | | **软件包管理器** | Agentlas Hub & Cloud：编译、发布、版本和共享代理程序软件包，具有内置质量门控。 | | **Shell 接口** | 外部客户端运行时中的小型统一命令集；本地 Agentlas shell 中的纯语言意图路由。 | | **进程初始化** | 具有集成简报面试门的 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 中的新增功能 - 简报面试引擎 由模糊的单句提示生成的代理程序在现实世界的边缘情况下会失败。 Hephaestus v1.1.0 通过 **简报面试引擎** 将任务规范定位为一流的操作系统服务： * **量化模糊门控：** 编译调度器在四个关键向量（目标、约束、范围、上下文）上评估提示清晰度。 构建过程严格受到门控，直到模糊度得分通过数值阈值（模糊度得分 $\le 0.2$，每个维度有安全底线）。 清晰的提示通过预算系统完全绕过面试循环，该系统为琐碎任务限制问题数量。 * **基于镜头的系统分析：** 澄清问题动态来源于结构化的镜头表（范围、意图、挑战、系统架构），聚焦于关键路由指标： *反作用域边界*（代理程序必须 **不** 执行的操作）、 *可验证的验收标准* 和 *退出条件*。 * **工作简报：** 已解析的详细信息冻结到 `.agentlas/work-brief.json` 中 - 记录验证的目标、具体约束、带有源标签的假设账本和元数据模糊度得分。 * **上下文飞行简报：** CLI 工具 `cards migrate` 自动将简报详细信息直接映射到代理程序路由卡上的触发器和反触发器。 运行 `route --brief` 将此简报传播到所有 Stormbreaker 执行数据包，确保约束和退出条件控制整个生命周期的并行子进程。 * **增强路由判别：** 通过双侧门控防止相同主题/不同意图的冲突（例如，安全代理程序拦截部署提示）：路由卡上的面试验证反触发器和路由器内的低置信度 LLM 重新排名提升。 --- ## 所有安装方法 ### 手动 LLM 适配器安装 仅当您的当前 LLM 无法为您运行安装程序时使用。 它安装共享的 Hephaestus 运行器和受支持的 LLM 工具的命令适配器。 ```bash xcode-select --install # 命令行工具（如果已安装，请跳过） git --version # 确认 git 可用 curl -fsSL https://raw.githubusercontent.com/agentlas-ai/Agentlas-OS/main/scripts/install-all-runtimes.sh | bash ``` 此安装程序在 `~/.agentlas/runtime/current/bin/hephaestus` 处安装中立的运行器，并为 Claude Code、Codex、Gemini CLI、Antigravity 和 Cursor 注册命令适配器。 安装程序在注册后验证每个运行时表面。 ### 可选的全局路由器 ```bash hep-global install ``` 这将一个托管的标记块追加到 `~/.codex/AGENTS.md` 、 `~/.claude/CLAUDE.md` 和 `~/.gemini/GEMINI.md`。 之后，Codex、Claude Code 和 Antigravity/Gemini 可以像 Agentlas 原生会话一样处理普通提示。 对于实质性工作，路由器顺序为：Hephaestus Network 优先，Hephaestus Cloud 第二，本地代理程序第三，本地技能最后。 如果 Network 或 Cloud 因信用、权利或匹配不良而被阻止，运行时会报告该边界并继续按照回退顺序。 安装的路由器提示名称为最终工作器，而不是路由器命令。 它为英语和韩语会话携带明确的状态行合同： | 会话语言 | 代理程序路由示例 | 技能回退示例 | | --- | --- | --- | | 英语 | `使用的代理程序：<代理程序名称>。 原因：<简短原因>` | `使用的技能：<技能名称>。 原因：<简短原因>` | | 韩语 | `사용 에이전트：<代理程序名称>。 이유：<简短原因>` | `사용 스킬：<技能名称>。 이유：<简短原因>` | 全局路由器命令参考： | 命令 | 它执行的操作 | | --- | --- | | `hep-global install` | 为 Codex、Claude Code 和 Antigravity/Gemini 安装或刷新托管路由器块。 | | `hep-global status` | 显示每个运行时文件是否具有托管路由器块。 | | `hep-global remove` | 仅删除托管的 Hephaestus 路由器块。 现有用户内容保持不变。 | | `hep-global install --target codex` | 仅安装 `~/.codex/AGENTS.md`。 | | `hep-global install --target claude` | 仅安装 `~/.claude/CLAUDE.md`。 | | `hep-global install --target antigravity` | 仅安装 `~/.gemini/GEMINI.md`，Antigravity 与 Gemini CLI 共享。 | | `hep-global install --target codex --target claude --target antigravity` | 显式安装所有支持的目标。 | | `hep-global install --dry-run` | 预览将更改的内容而不写入文件。 | | `hep-global install --no-backup` | 编辑时不写入时间戳 `.bak.*` 文件。 | | `hep-global install --home /tmp/test-home` | 测试另一个 home 目录。 安装程序 QA 有用。 | | `hephaestus global install` | 通过主 Hephaestus 运行器执行相同的命令。 | | `~/.agentlas/runtime/current/bin/hephaestus global status` | 直接使用安装的运行时（当 shell shims 不在 `PATH` 上时）。 | ### 每个运行时的插件驱动程序 <details> <summary>Claude Code 插件</summary> 从您的 OS 终端： ```bash claude plugin marketplace add https://github.com/agentlas-ai/Agentlas-OS --sparse .claude-plugin claude/plugins claude plugin install hephaestus@agentlas-core-engine ``` *注意：Claude Code 还支持 `claude plugins ...` 作为别名，但本 README 使用一致的 `claude plugin ...`。* </details> <details> <summary>Codex 插件</summary> 从您的 OS 终端： ```bash codex plugin marketplace add agentlas-ai/Agentlas-OS --ref v1.1.10 codex plugin add hephaestus@agentlas-core-engine ``` *注意：Codex 不接受 `/plugin marketplace add` 在应用程序内 - 在您的 OS 终端运行上述两个命令。 OS 终端 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 接口内用普通语言说话以自动路由任务。 在外部 LLM 工具中使用下面的显式命令。 当您不知道存在哪些代理程序时，请启动 `/hep-search`。 要连接 Telegram，请在 Claude Code 中使用 `/hep-connect` 或在 Codex 中使用 `/prompts:hep-connect`。 --- ## 产品表面 此存储库安装 Hephaestus 引擎和 LLM 命令适配器。 它是 Agentlas OS 下的开源命令界面。 | 表面 | 角色 | | --- | --- | | **Agentlas 桌面版** | 用于运行 AI 原生应用、代理程序团队、内存、浏览器工作和 Hub 专家视觉本地操作系统。 | | **Hephaestus 插件** | 用于 Claude Code、Codex、Gemini CLI、Antigravity、Cursor 和兼容运行器的开源引擎和命令界面。 | | **Agentlas Hub / Cloud** | 借用、发布和同步代理程序软件包，而不将 Hub 变成服务器端模型代理。 | 上面的安装提示故意限定在此存储库和当前 LLM 表面。 桌面版和 Hub 是围绕相同 Agentlas OS 架构的产品表面；它们不是安装插件的前提条件。 --- ## 命令界面 在原生 Agentlas 环境中，Hephaestus 操作无命令。 外部 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` | | **Cloud State Sync** | `/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` | | **浏览器硬点** | `/hep-browser` 或 `/prompts:hep-browser` | `/hep-browser https://example.com` | | **进程间调用（IPC） | `/hep-call` | `/hep-call market-researcher, report-writer {draft a market report}` | | **软件包导出器** | `/hep-upload` | `/hep-upload ./agents/customer-support-hq` | | **Telegram 设置** | `/hep-connect` 或 `/prompts:hep-connect` | `/hep-connect Telegram for Marketing Agent Team` | --- ## 操作系统子系统 ### Meta-Agent 工厂 — 进程创建 一个统一的编译工厂，使用三个构建器。每个生成的软件包注册其全局命令（`.agentlas/global-commands.json`）并附带验证脚本 - 用户永远不必推断如何运行编译的软件包： | 编译模式 | 路由目标 | 输出工件 | | --- | --- | --- | | **单代理** | `10-single-agent-builder` | 具有本地化技能、内存合同和运行时适配器的独立工作器。 | | **多代理团队** | `20-multi-agent-team-builder` | 包含 PM 协调器、内存保管人、策略门、QA 和验证脚本的层次结构团队。 | | **工作区打包器** | `30-agentlas-packager` | 编译的捆绑包，准备好导入运行时、CLI 执行或 GitHub 分发。 | *简报面试门：* 构建器使用 **简报面试门** 启动流程：提出镜头驱动的问题，评估模糊度阈值，搜索主要来源，并输出工作简报。 --- ### 网络 2.0 — 调度器 <p align="center"> <img src="assets/hephaestus-network-architecture.svg" alt="图 2. Hephaestus 网络 2.0 A2A 网络架构"> </p> _{图 2. A2A 调度：LLM 运行时、本地优先编排器、路由卡、本地内存和 Agentlas Hub A2A/MCP 备用。} * **路由卡：** 每个代理、团队和插件都附带一张标准化的卡片，包含触发器、反触发器、能力、风险配置文件和内存参数。未能通过验证的卡片将被排除在路由之外。 * **本地优先调度：** 调度首先在本地解决（项目覆盖 $\rightarrow$ 本地卡片）。通过 Agentlas Hub 的外部查询被简化为关键词；您的原始提示永远不会离开您的本地环境。 * **临时任务部队：** 复合请求分解为 Hub/本地任务部队计划，封装 Stormbreaker 信封、会话提示和本体路径。命名专家动态调度，临时编排器管理任务交接。 * **基于回执的执行：** 每个路由决策都写入回执。路由器仅确定要调用的代理或包；工具执行权限仍然严格沙箱化，由活动运行时管理。 * **双语基准测试：** 自动路由由双语（韩语 + 英语）基准测试控制，需要前 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 是 Agent OS 的执行门控子系统。它确保代理在所有结果通过确定性检查验证之前不会报告成功或终止： ```text 内核门控信封： [作用域锁定] -> [分解] -> [并行工作包] -> [验证合约] -> [有界修复] -> [最终门控] ``` 本地运行日志使长时间执行在中断后可恢复。执行包携带工作简介，以便反作用域规则和退出标准管辖所有并行子进程。Stormbreaker 报告明确的完成状态（**已验证 / 未验证 / 阻止**），以防止自主完成剧场。 执行协议：[docs/robustness-protocol.md](docs/robustness-protocol.md) · 基准测试和评估：[docs/robustness-eval.md](docs/robustness-eval.md) --- ### 本体运行时 — 知识文件系统 对于知识密集型操作，`bin/ontology` 作为语义文件系统，将非结构化本地文件转换为代理可读的数据库堆栈： ```text 已摄入文件 -> [解析器适配器] -> [CJK 三元组/二元组分词] -> [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/` 下，隔离到本地机器。未获得明确授权时无法导出。 * **工作区个性化：** 管理个性化日志（摘要、剧本、插件锁和回执），适用于借用的云/中心代理，不存储原始提示、凭证值或私有文件。 * **策展人门控：** 技能和内存修改保留为候选。仅当本地策展人确认退出/重放证明、回滚覆盖和安全策略批准后，才会晋升为持久状态。 --- ### 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 . ``` 导入作为提案（限制自动调用），导出会屏蔽私有路径和逻辑，调用者在路由解决前会被门控。 --- ## 为拥有代理操作而构建 用户和团队不需要另一种编写隔离代理的方式。他们需要的是拥有一个可控的代理工作队伍。Hephaestus 就是为此操作模型而设计的： * **模型中立性：** 代理、内存仓库和知识域作为本地资产存储在您的控制之下。迁移到新的模型提供商（或使用本地模型，如 Ollama、DeepSeek、GLM、Gemini 或 Claude）只需进行配置更新，而无需进行代码库迁移。 * **可审计性：** 每个路由决策、执行步骤、内存候选和策展人决策都记录为文本文件。您可以对其进行差异、审计和提交。工作要么被验证，要么被标记为未验证。 * **确定性流水线门控：** 安全过滤器、反作用域、路由卡触发器和提示净化被硬编码到操作系统流水线中；它们不依赖于 LLM 系统指令或指南。 * **生成前规范：** 简报面试引擎衡量请求模糊性，并在工作简介上盖章，确保任务执行始终可以审计回已同意的内容。 * **本地优先数据边界：** 原始文本、文档和数据库文件保持本地。外部交易被屏蔽且需选择加入。 ### 框架的位置 CrewAI、LangChain 和供应商代理 SDK 作为 **库** — 适用于在单个进程中编写自定义代理逻辑。Hephaestus 作为 **运行时基质**：它指定、打包、路由、运行、审计和迁移代理跨工作区运行时。框架代码在 Hephaestus 包中运行；内核只需要代理遵守其目录合约和路由卡。 --- ## 它构建的内容（进程打包） Hephaestus 将代理打包成标准目录布局，任何工作区运行时都可以解析、安装、验证和运行。重要的部分不仅仅是 `agent.md`；它是围绕它的操作合约： ```text ├── AGENTS.md # 规范操作循环和源真图 ├── agent.md / agents/ # 单个工作者、HQ/编排器或团队角色 │ ├── 10-single-agent-builder/ │ ├── 20-multi-agent-team-builder/ │ └── 30-agentlas-packager/ ├── .agentlas/ # Agentlas OS 系统目录 │ ├── sitemap.json # 产品图：模式、运行时适配器、内存、发布检查 │ ├── mode-map.json # 单代理 / 团队 / 打包分类合约 │ ├── routing-card.json # 触发器、反触发器、能力、风险、路由准备度 │ ├── agent-card.json # A2A 面向身份和能力卡 │ ├── company-blueprint.json # 团队/公司拓扑结构，用于多代理包 │ ├── global-commands.json # 运行时命令别名和安装界面 │ ├── memory-map.json # 内存根、写入所有者、信任标签、排除项 │ ├── memory-tickets.jsonl # 候选内存事件在持久化前 │ ├── project-soul-memory.md # 项目级操作内存 │ ├── curator-decisions.jsonl # 内存策展人推广/拒绝决定 │ ├── vault-references.json # 机密/凭证引用，无原始值 │ ├── validation-ledger.jsonl # 验证和发布证据 │ ├── field-test-report.json # 包准备度的现场测试结果 │ ├── skill-registry.json # 可重复使用的技能库存和生命周期元数据 │ ├── skill-trials.jsonl # 技能试验证据在推广前 │ ├── agent-ontology/ # 能力、工件、作用域、边际的本地代码/代理映射 │ └── super-ontology-*.json/jsonl # 治理合约：证据、隐私、副作用、弹性 ├── skills/ # 规范的可重复使用的技能 ├── modes/ # 构建/打包行为的模式合约 ├── schemas/ # JSON 模式用于卡片、内存映射、站点地图、评估、清单 ├── templates/ # 包、内存、面试、评估、本体和合约模板 ├── ontology/ + bin/ontology # 本地优先解析器/搜索/GraphRAG 运行时 ├── agentlas_cloud/ # 中心/云捆绑、路由、更新和运行时 API ├── .claude/ codex/ .gemini/ .agents/ # 薄运行时适配器在同一核心上 ├── claude/ codex/ gemini/ antigravity/ # 插件/扩展/工作流分发 ├── cursor/ hermes/ openclaw/ # 附加运行时垫片和技能镜像 ├── docs/ # 架构、链图、内存、本体、路由、评估文档 │ ├── source-of-truth.md │ ├── chain-map.md │ ├── memory-architecture.md │ ├── ontology-runtime.md │ ├── hephaestus-network-2.0.md │ └── builder-interview-research-gate.md └── scripts/ # 验证、安装、同步、发布和公共安全门控 ├── verify-package.sh ├── verify-ontology-runtime.sh ├── verify-routing-cards.sh ├── sync-adapters.sh └── public_safety_check.sh ``` 这种包结构使得 Agentlas 代理不仅仅是一个 LLM 编写的角色提示。它携带路由、内存、站点地图、代码/代理本体、权限、运行时适配器、验证账本和发布门控。 --- ## 按目标划分的文档 | 系统目标 | 参考文档 | |---|---| | 了解规范路由 | [`AGENTS.md`](AGENTS.md) | | 查看完整团队合约 | [`agent.md`](agent.md) | | 架构源真 | [`docs/source-of-truth.md`](docs/source-of-truth.md) | | 链/代码映射 | [`docs/chain-map.md`](docs/chain-map.md) | | 运行时边界 | [`docs/runtime-sync-boundaries.md`](docs/runtime-sync-boundaries.md) | | 站点地图合约 | [`.agentlas/sitemap.json`](.agentlas/sitemap.json) 和 [`schemas/sitemap.schema.json`](schemas/sitemap.schema.json) | | 模式映射 | [`.agentlas/mode-map.json`](.agentlas/mode-map.json) | | 路由卡 | [`.agentlas/routing-card.json`](.agentlas/routing-card.json) 和 [`schemas/routing-card.schema.json`](schemas/routing-card.schema.json) | | 内存映射 | [`.agentlas/memory-map.json`](.agentlas/memory-map.json) 和 [`schemas/memory-map.schema.json`](schemas/memory-map.schema.json) | | 代理本体 | [`.agentlas/agent-ontology/`](.agentlas/agent-ontology/) 和 [`docs/agent-ontology-a2a-plan.md`](docs/agent-ontology-a2a-plan.md) | | Agentlas OS 定位 | [`docs/agentlas-os-architecture-positioning-2026-07-08.md`](docs/agentlas-os-architecture-positioning-2026-07-08.md) | | Google Next 2026 比较 | [`docs/agentlas-os-google-next-2026-comparison-2026-07-08.md`](docs/agentlas-os-google-next-2026-comparison-2026-07-08.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 ``` --- ## 许可证 Apache-2.0。参见 [LICENSE](LICENSE)。