模块目录
Olivares AI 以单一可信事实源构建（Claude Code 处于最深层次，Codex 与 Grok Build 并列其旁），用于在企业中集成、管理和保护 AI。 它是一个模块化平台 —— 一个引擎、一个控制台、目录中的 35 个可选模块 —— 它观察 agent 在何处运行，治理它们被允许做什么，并（在不断扩大的子集上）对你的真实 基础设施执行操作。每个模块都会：(a) 从核心消费规范化的事件/数据，(b) 在共享数据模型中 声明其实体，以及 (c) 暴露自己的 API 端点和 UI 视图 —— 而不触碰核心或其他模块。
这 35 个可选模块由 32 个模块包实现；governance 包提供四个可分别选择的模块。它们按下文的九大能力领域组织。请将每个模块的状态读作两个部分：
治理/观察（Govern/Observe）（编目、观察、把关、报告）今天已构建并接入；
执行（Actuate）（在真实基础设施上执行操作 —— 部署、调度、发送、强制、运行）落入若干
诚实的状态 —— 在默认二进制文件中对一个子集是实时（live）的，对若干模块是按需
（on-demand）的（后端已构建并接入到一个注入点，但在运营者通过环境配置进行预置之前
保持拒止关闭或降级），在表面受门控/可选启用之处为 PARTIAL（部分），其余则是一个声明
的拒止关闭接缝（deny-closed seam）。特别地，部署（deploy）会规划并治理部署，但
在执行器被预置之前不会将其应用到实时基础设施上：apply/retire 会返回明确的 503。部署是 Business 功能，Community 对每个部署路由返回 501。
各模块的深度有所不同，且产品的大部分在所注明之处处于 pre-1.0 / 设计阶段（参见
诚实与局限）。
访问图谱（access map）（iii-access-map）—— 即每个 agent 能够触及以及实际触及哪些
内容的读取/读写图谱，配合最小权限漂移（least-privilege drift）= Permitted ≠ Observed
—— 是这 35 个可选模块中最有用的能力之一，而非整个产品。广度才是要点：九大领域、一个引擎、
一个控制台。
35 个可选模块，按能力领域
Section titled “35 个可选模块，按能力领域”每一行都链接到其模块页面（/reference/modules/<slug>/）。**Actuate（执行）**列是执行部分
的诚实状态；— 表示该模块在本质上是治理/观察型的，没有执行表面。
观察（Observe）
Section titled “观察（Observe）”| 模块 | 执行 | 用途 |
|---|---|---|
| 清点与发现 | — | 发现并编目连接器观察到的 agent、会话、MCP 服务器、工具、模型和身份。 |
| 实时运行与会话 | — | 每个 agent 与会话的实时状态；同时托管受治理的 Claude Code 会话运行时。 |
| 访问与资源图谱（R/RW） | — | 每个 agent 访问什么，以及它是读取还是写入；最小权限漂移 = Permitted ≠ Observed。 |
| 编排与 A2A | 按需 | 对实时委派/通信图谱进行观察与治理；调度按需接入，在预置之前拒止关闭。 |
| MCP、技能与能力 | — | 可视化地治理 agent 的工具与能力。 |
| 健康、SLA 与正常运行时间 | — | 治理范围中各 agent 与 MCP 服务器的可靠性；检查、事件、依赖图谱。 |
| 可观测性只读模型 | — | 引擎对自身的只读模型：固定的互操作标准、经 W3C 关联的账本/追踪视图、供应链证明。 |
| Claude Code 采用度 | — | Claude Code 采用度/生产力的只读模型：会话、代码行数、commit、PR、工具接受-拒绝、按模型的 token，按团队/开发者/日；默认按团队，按开发者下钻为可选启用。仅限-Claude-API 边界；从不携带成本。 |
| 实时摄取 | PARTIAL | 进程内产生连接器无法发出的侦测事件；受环境门控、拒止关闭、最小数据。 |
治理与强制（Govern & enforce）
Section titled “治理与强制（Govern & enforce）”| 模块 | 执行 | 用途 |
|---|---|---|
| 身份、权限与治理 | — | 谁以及什么能做什么，粒度化：Cedar RBAC + 拒止覆盖层 + 作用域授权、名册对账、作用域化管理员/自定义角色、应急破窗（break-glass）、紧急停止开关（kill-switch）。 |
身份（identity） |
— | 只读工作负载身份联邦、SSO、外部密钥和驻留姿态。 |
| 源与凭据作用域化 | — | 将源绑定到某个工作区/agent 组；拒止关闭的作用域解析器 + 解析时的作用域化凭据。 |
| 部署与集成 | Business，按需（503） | Business 功能：Community 返回 501。规划并治理向真实基础设施的部署；执行器为按需 —— 在预置之前，实时的 apply/retire 返回 503。 |
| 受治理的 Git 发布 | on-demand | 通过批准的 Git 主机绑定推送提交、创建合并请求并合并，检查当前权限并保留操作结果。 |
Identity 是用于只读身份姿态控制台的独立可选模块。它共享 governance 包，并依赖拥有授权模型和身份生命周期的 governance。共享包不代表共享模块开关。
Claude 与 agent 生态
Section titled “Claude 与 agent 生态”| 模块 | 执行 | 用途 |
|---|---|---|
Claude Code 受管策略（claude-policy） |
— | 验证和预览受管策略；Business 版可向整个机群发布，并查看分发与已观测漂移。 |
Claude agent 确认（claude-agents） |
— | 读取受管 agent 线程事件，并批准或拒绝待处理工具确认。 |
| 技能目录与分配 | — | 不可变的技能目录与固定分配：经摘要验证的技能包安装在 /v1/m/skills/packs 下，按目标固定，绝不在原地修改。 |
| 模型与提供商管理 | 按需（503） | 跨整个模型/提供商栈进行治理：模型访问、逐表面上下文窗口、模型组门控；模型执行为按需 —— 在推理凭据被预置之前返回 503。 |
| 内联推理代理 | PARTIAL | 为内联 /v1/messages PEP 代理提供逐租户的推理出口配置 + DLP；模块配置已实时生效，监听器为可选启用、回环默认、失败时关闭（fail-CLOSED）。 |
| 内部目录与市场 | — | 经核准/签名的 agent、MCP 服务器与技能的精选市场。 |
| 语音与实时 agent | 按需 | 对会话式/实时 agent 进行观察与治理（默认拒止、两阶段 human-in-the-loop）；永不打开媒体流；调度为按需。 |
安全与数据保护（Security & data protection）
Section titled “安全与数据保护（Security & data protection）”| 模块 | 执行 | 用途 |
|---|---|---|
| 安全、护栏与审计 | 实时 | 护栏（guardrails，PII/注入/越狱）、异常、事件时间线；BYOK/DLP/RTBF/保留/WORM/驻留位于此平面。 |
| 特权会话录制 | 实时 | 与 PAM 对齐的特权会话录制：哈希链式（hash-chained）帧、写入时脱敏、锚定到账本。 |
| 数据、知识与上下文 | 按需 | 受治理的数据平面：知识库 + RAG、受治理的检索、血缘、提示词注册表、agent 记忆；基于模型的语义嵌入为按需。 |
合规与证据（Compliance & evidence）
Section titled “合规与证据（Compliance & evidence）”| 模块 | 执行 | 用途 |
|---|---|---|
| 合规与监管 | — | 26 个框架目录 + 经密封的、源自账本的证据，并提供实时链式校验。 |
| SIEM/ITSM 转发器 | 实时 | 将密封的账本 + 发现项推送到 SIEM 塔（OCSF 1.8/CEF/LEEF/syslog/OTLP），领导者门控的游标遍历，至少一次（at-least-once）。 |
| 态势导出 | PARTIAL | 面向控制塔的只读态势/清点拉取（中立 JSON）；不声称已校验的下游推送。 |
| Reporting | — | 根据平台的合规、审计与 FinOps 数据生成专业 PDF/HTML 报告 —— 内置 5 种类型；审计人员下载文档，无需复制粘贴 JSON。 |
FinOps
Section titled “FinOps”| 模块 | 执行 | 用途 |
|---|---|---|
| 成本与 AI FinOps | 实时 | 在上限处拒止/限流的执行型预算、按结果计成本（cost-per-outcome）、取消风险；预算与身份强绑定。 |
评估与安全性（Evals & safety）
Section titled “评估与安全性（Evals & safety）”| 模块 | 执行 | 用途 |
|---|---|---|
| 质量、评估与测试 | — | 经校准的 LLM 裁判 + 一道阻塞式 CI 回归门控；离线裁判 → SKIPPED，绝不静默通过。 |
| Agent 沙箱 | 按需 | 在投产前测试 agent 的安全环境；真正的操作系统隔离（gVisor/Firecracker）为按需。 |
| 红队与对抗测试 | 按需 | 经同意门控的对抗测试集；在沙箱运行时被预置之前为 DEGRADED（降级）—— 绝不假通过。 |
平台与集成（Platform & integrations）
Section titled “平台与集成（Platform & integrations）”| 模块 | 执行 | 用途 |
|---|---|---|
| 输出集成与通知 | 实时 | 面向公司已运行系统的通知路由器；调度已实时接入，目的地由运营者预置。 |
| 事件订阅 | 实时 | 总线之上的外部订阅表面：类型化订阅、持久的至少一次投递、重试/退避、DLQ、游标重放。 |
| 已保存的控制台视图 | — | 控制台视图状态（过滤器、范围）的命名、可共享快照，按租户存储在服务端：保存一次调查，与团队共享。接受上限 4096 字节、用于视图参数的 JSON 对象——请勿在其中存放敏感数据或查询结果。创建/更新仅限所有者；租户管理员/所有者和超级管理员可为清理而删除；每次变更均被审计。 |
Actuate（执行）列：live（实时）= 执行已接入并在默认二进制文件中实时生效，无需预置
（例如 FinOps 预算强制在上限处拒止、通知路由器进行调度）；on-demand（按需）/
on-demand (503)（按需（503））= 后端已构建并接入到一个注入点，但在运营者通过环境配置
进行预置之前保持拒止关闭或降级（部署是 Business 功能，在 Community 中应答 501，在执行器存在之前应答 503；编排/语音调度在配置
之前拒止关闭；红队在沙箱运行时被预置之前以 DEGRADED 运行；模型执行与语义嵌入在凭据被预置
之前返回 503）；PARTIAL（部分）= 表面是真实的但受门控/可选启用，或不声称已校验的下游
（推理代理监听器为可选启用、回环默认；实时摄取受环境门控；态势导出是一个中立的只读投影）；
— = 该模块在本质上是治理/观察型的，没有执行表面。这一拆分就是诚实的契约：产品今天广泛地
观察并治理，并在一个不断扩大、大多受预置门控的子集上执行 —— 参见
诚实与局限。可选目录来自 core/modulespec/modules.json，这也是 olivares modules ls 和控制台版本与模块列表使用的来源。npm run test:modules 检查每个可选命名空间是否链接到参考页面，并验证计数。
版本可用性接缝（不计入 35 个可选模块之内）
Section titled “版本可用性接缝（不计入 35 个可选模块之内）”上表目录涵盖共享模块规范中的 35 个可选模块。另外，Community 在 session-cockpit API 命名空间下注册一个可用性描述符。它不是这 35 个之一。
- 会话驾驶舱（可用性） ——
Community 中没有处理程序；
/v1/m/session-cockpit因缺失而返回 404。 本制品没有交互式驾驶舱。实时会话、AgentOps 与官方 CLI 生命周期仍在开放产品中 —— 见 实时运行与会话 和 在 Olivares 中运行 Claude Code。
平台与核心能力（不计入 35 个可选模块之内）
Section titled “平台与核心能力（不计入 35 个可选模块之内）”以下是真实的已交付能力，但它们是引擎／核心／Web 能力，不是独立可选模块，因此不计入这 35 个之内：
- 自有 API + 以代码管理 —— 引擎/核心能力。 引擎自有的、带版本的 REST/gRPC API，外加 Terraform provider； 通过 API 与 IaC 来管理平台本身。
- 多租户与组织管理 —— 引擎/核心能力。 组织层级与委派式管理，配合 Postgres 行级安全（row-level-security） 的租户隔离。
- 高管仪表盘 —— Web 能力。 与技术 UI 并列的领导层控制台视图。（其报告生成后端是 reporting 模块，该模块计入 35 个可选模块。）
- 模型运维（自有模型） —— models 模块的能力（通过模块 X 的行计数，不是单独一行）：受治理的自有模型注册表、 签名模型准入、数据集/微调作业的血缘记录、本地推理部署治理，以及 AIBOM/模型卡片证据。
计划中： 自有模型微调与本地推理的执行 （xxiii-fine-tuning）—— 平台今天已治理并记录 这些工作（见上文模型运维），但自身不执行训练、不提供推理服务；执行的那一半是有文档记载的 计划中工作，未交付，也不在这 35 个之内。
模块如何在 API 与总线中呈现
Section titled “模块如何在 API 与总线中呈现”- REST。 API 参考 从产品的 OpenAPI 3.1 契约渲染核心 REST 表面。 某些模块路由可达，但有意不出现在该文档中；它们的字段级契约存在于产品的类型化接口里。
- 事件。 模块对 事件总线 作出反应：访问图谱消费
edge.observed，FinOps 消费cost.sampled，安全模块消费finding.reported和guardrail.observed。
这 35 个可选模块构建在引擎之上的若干层级上，与上文的引擎/核心及 Web 能力并列：
- 引擎（第 0 层） —— 自有 API/以代码管理与多租户能力（核心，不计入这 35 个）。
- 核心（第 1 层） —— 清点、会话、访问图谱、模型、健康、可观测性。
- 管理（第 2 层） —— 能力、治理、identity、claude-policy、claude-agents、skills、sourcescope、部署、gitpublish、知识。
- 智能（第 3 层） —— 编排、安全、录制、推理代理、finops、评估、合规、reporting、siemforward、 态势导出、目录、notify、事件订阅、语音、沙箱、红队、实时摄取、已保存的控制台视图。
- Web（第 4 层） —— UI 与高管仪表盘能力。
参见 架构概览 以了解引擎与这些层级如何组合。