概览

现代企业 IT 基础设施高度分布式且动态多变。当生产故障、服务降级或告警风暴突发时，AI 智能体与工程师无法仅仅依靠模糊文本检索或零散的配置片段来理解复杂系统。团队需要一个本体驱动的知识图谱，能够从顶层业务系统自顶向下精确穿透至微服务、数据库实例、物理宿主机、网络设备乃至存储卷。

Mopheus 的 IT 资产本体与拓扑（IT Asset Ontology & Topology） 模块正是为此而生。它取代了传统、孤岛式的 CMDB 表格，通过严格的概念元模型模式（TBox）与有向拓扑关系（ABox），为智能体与技术团队提供确定性的系统全貌与因果推理能力。

为什么需要 IT 资产本体？Copy Anchor Link

传统 CMDB 在实际协作中通常存在三大痛点：

1. 刚性宽表 vs 无序松散 — 传统 CMDB 要么把所有资产塞进数百个冗余字段的大宽表，导致多数列常年为空；要么退化为无类型的键值杂货铺，缺乏语义约束与校验。
2. 缺乏因果拓扑能力 — 资产以孤立台账方式记录。当某台物理机或交换机发生故障时，无法直接计算其向上波及的业务爆炸半径，也难以追溯上层微服务超时与底层存储降级之间的因果调用链。
3. 运维逻辑耦合污染 — 传统 CMDB 经常将运维脚本、排障 SOP 与资产记录强行混杂，极易发生配置漂移与文档陈旧。

Mopheus 遵循三大架构原则来解决这些问题：

• 强类型概念元模型（TBox）：内置 17 类标准本体概念，通过 JSONSchema 严格校验技术属性，并强制执行允许的拓扑公理规则。
• 极简信封图谱存储（ABox）：资产实体与有向关系基于高性能表结构存储，依托 PostgreSQL 递归 CTE 算法实现毫秒级下游依赖遍历、上游爆炸半径分析与最短因果路径搜索。
• 清晰职责解耦：客观技术属性（attributes）与组织治理标签（labels）完全解耦，故障处置 SOP 完整沉淀在智能体技能（如 mopheus-assets）中。

Web 端资产中心与交互式架构拓扑Copy Anchor Link

Mopheus 在 Web 界面提供原生集成的 「资产中心」（Asset Center），包含 应用全景 (L1)、架构拓扑大图 (L2) 与 资产清单表格 (Inventory Table) 三重视图：

1. 分层架构导航与下钻Copy Anchor Link

• 应用全景 (L1)：展示工作区内所有已登记的业务系统（Application）卡片，直观呈现各系统包含的微服务数量、数据库规模、跨应用级联依赖边与核心环境分布。
• 架构拓扑大图 (L2)：点击任意应用卡片或顶部切换，即可深入该系统的细粒度微服务与基础设施多层拓扑。

2. 逻辑资产与物理资产分层规范Copy Anchor Link

• 拓扑画布聚焦逻辑资产：为了保证大图的可读性与架构清晰度，L1/L2 架构拓扑画布聚焦展示逻辑架构节点（微服务 Service、高可用数据库集群 Database、负载均衡 LoadBalancer、域名解析 DNSRecord、计算宿主机 Host 等）。
• 物理实体清单查看：底层物理实体（如容器实例 Container、单机数据库进程实例 DatabaseInstance、分片组 DatabaseShard 等）不直接平铺在主架构大图上，用户可无缝切换至「资产清单表格」或打开详情抽屉查看物理运行参数。
• 图例说明与定位置灰：
  • 画布左下角图例区明示提示文案：“拓扑图仅展示逻辑资产，物理资产（容器、数据库实例等）请前往「资产清单表格」查询详情。”
  • 在「资产清单表格」与详情抽屉中，对于未在拓扑画布中投影的物理实体，其「拓扑定位」按钮自动置灰禁用并提供悬浮说明，避免无效点击。

3. 画布高级交互能力Copy Anchor Link

• 节点聚焦与下钻抽屉：单击任意架构节点，右侧即刻滑出资产技术属性、治理标签与全量上下游关系抽屉，并自动同步 URL 锚点，便于分享协作。
• 爆炸半径（Blast Radius）非破坏性高亮：支持一键扩散分析受影响的服务与数据库调用依赖链，非相关节点自动弱化淡出。
• 多环境集群并列呈现：生产（PROD）、测试（TEST）、开发（DEV）等多套环境集群采用响应式包围盒智能排布，直观呈现跨环境调用链路。
• 主题同步与全屏演示：实时联动工作区深色/浅色模式，支持一键进入全屏汇报演讲模式并导出高清图片。

领域模型与核心本体体系Copy Anchor Link

Mopheus 将企业 IT 基础设施划分为 7 大核心领域，抽象为 17 类标准本体概念 与 7 大规范拓扑谓词：

7 大领域分层模型Copy Anchor Link

1. 业务层 (Business)：顶层企业业务系统 Application 与微服务组件 Service。
2. 平台层 (Platform)：基础设施控制面 Cluster 与容器实例 Container。
3. 计算层 (Compute)：物理裸机、虚拟机与云服务器 Host。
4. 数据库 (Database)：逻辑集群 Database、单机实例 DatabaseInstance、分片组 DatabaseShard 与协调节点 DatabaseComponent。
5. 中间件 (Middleware)：消息队列代理与流式组件 MessageQueue。
6. 网络层 (Network)：域名记录 DNSRecord、虚 IP VirtualIP、负载均衡器 LoadBalancer、网络基础设施 NetworkDevice 与接口 IP IPAddress。
7. 存储层 (Storage)：集中/分布式存储池 StoragePool 与持久化卷 StorageVolume。

7 大规范拓扑谓词Copy Anchor Link

• contains — 结构性包含归属（Application contains Service，Database contains DatabaseInstance）。
• runs_on — 物理或逻辑承载（Container runs_on Host，DatabaseInstance runs_on Host）。
• routes_to — 流量转发与网络路由（DNSRecord routes_to VirtualIP，LoadBalancer routes_to Service）。
• depends_on — 运行时强业务/因果调用依赖（Service depends_on Database）。
• replicates_to — 有状态数据主备同步（主库 replicates_to 备库）。
• clustered_with — 同级高可用对等互联（Host clustered_with Host）。
• manages — 管控平面自动化监管（Cluster manages Service）。

[!TIP] 完整的 17 类概念属性 JSONSchema 约束、字段类型定义、枚举限制与拓扑公理合法性矩阵，请参阅专门的 本体规范与 Schema 参考。

技术属性 vs 治理标签Copy Anchor Link

Mopheus 在数据建模上对事实和治理做了严格切分：

图谱操作与 CLI 命令Copy Anchor Link

通过 mop asset 命令集，用户和智能体可以高效操作知识图谱：

1. 实体消解与详细探查Copy Anchor Link

支持从业务别名、服务名或 IP 快速定位唯一资产 ID：

# 从服务别名解析出标准资产 ID
mop asset resolve "order-gateway"

# 查看资产属性、标签及所属概念模式
mop asset inspect "svc:order-gateway"

2. 多跳拓扑下钻分析Copy Anchor Link

支持任意深度的上下游拓扑图谱展开：

# 下游依赖探查：该服务依赖了哪些底层组件与数据库？
mop asset topology "svc:order-gateway" --depth 3 --direction downstream

# 上游爆炸半径评估：该宿主机宕机后，将波及哪些上层业务服务？
mop asset topology "host:db-node-01" --depth 3 --direction upstream

# 双向全景邻域分析：
mop asset topology "db:settle-oracle-rac" --depth 2 --direction both

3. 最短因果路径追踪Copy Anchor Link

在发生生产故障时，秒级计算从表象组件（如报错微服务）到嫌疑根因（如异常数据库节点）的最短因果路径：

mop asset path --from "svc:order-gateway" --to "host:db-node-01"

输出示例：

Causal Path: svc:order-gateway -> host:db-node-01 (length: 3 hops)

  [1] svc:order-gateway (Service) -[depends_on]-> db:settle-oracle-rac (Database)
  [2] db:settle-oracle-rac (Database) -[contains]-> db_instance:rac-node1 (DatabaseInstance)
  [3] db_instance:rac-node1 (DatabaseInstance) -[runs_on]-> host:db-node-01 (Host)

4. 架构拓扑大图投影与独立渲染 (mop asset diagram)Copy Anchor Link

mop asset diagram 支持将当前工作区资产或离线清单确定性投影为符合 Archify 规范的架构大图，并一键渲染为完全独立的交互式单页 HTML：

# 投影指定业务系统（如 app:mopheus）的架构大图（输出 JSON 规范）
mop asset diagram --app "app:mopheus" -o json

# 渲染为完全独立的单页交互式 HTML 文件
mop asset diagram --app "app:mopheus" --locale zh-Hans --render -f mopheus-arch.html

# 脱机离线投影：直接从本地 YAML 清单生成架构图
mop asset diagram --input ./offline-manifest.yaml --render -f offline-arch.html

智能体集成与内置技能Copy Anchor Link

Mopheus 内置了专属的 mopheus-assets 技能。当智能体处理生产报警工单或回答架构问题时，将自动执行标准操作程序（SOP）：

1. 实体消解：将告警信息中的关键词映射到标准资产实体。
2. 依赖展开：通过拓扑下钻探寻服务的全量下游调用链。
3. 因果定界：搜索因果路径确认底层设备告警是否是上层故障的直接诱因。
4. 爆炸半径：在处置节点前，向上评估受影响的关联业务与所有者团队。

功能门控 (Feature Gating)Copy Anchor Link

资产系统受工作区特性开关 asset 保护。默认处于禁用状态（system_state = 1），管理员可按需为特定工作区开启：

# 为指定工作区开启资产功能
mop workspace feature enable <workspace-id> asset

SSH 凭证集成与受控远程执行Copy Anchor Link

Mopheus IT 资产中心与内置的 SSH 远程执行能力深度联动，采用元数据与私钥严格解耦的零信任安全架构：

• 资产仅声明连接元数据 (credential_ref)：在物理宿主机资产（Host）的 attributes 中配置 credential_ref: ssh://user@host:22?key=keyname，资产本体库中绝不保存任何私钥明文。
• 逻辑资产下钻穿透：当微服务或数据库等逻辑资产报警时，智能体通过 mop asset topology 自动下钻寻址底层承载的物理宿主机，再向宿主机发起受控连接。
• 用户密钥安全托管与沙箱注入：私钥由用户加密托管，仅在任务运行时动态注入沙箱，任务结束即刻销毁。

有关密钥配置生成、常用 CLI 命令（mop ssh exec、upload、download）以及智能体排障 SOP 的完整指南，请参阅 SSH 远程运维。