Meridian

人员交互层 · Human Interface

Meridian Console

运维工作台

React

面向工程师的统一前端。待办驱动，聚合所有需要人工确认的变更、标注、审批任务。

元数据总览语义标注变更待办知识管理 Manifest 审批排障工作台

Meridian Agent

诊断智能体

Agent

面向 AI 的统一入口。通过 MCP 协议调用下层所有工具，执行证据采集、链路拼接、候选归因等任务。

证据整理链路分析候选归因案例检索配置草稿生成

Developer AI Client

开发者本地 Codex / Claude

DevOps

开发者本地通过 Nexus:3000 连接 MCP，直接观察 Meridian 自身运行状态、服务日志、配置缺口和 smoke test。

devops.runtime_status tail_service_log config_check smoke_test

MCP Protocol / HTTP API

编排与网关层 · Orchestration

Nexus

MCP 网关 & 编排器

Python

受控工具网关。通过 registry / manifest 动态暴露 MCP 工具，统一执行权限、审计、限流、错误归一、返回裁剪与 adapter 调用。

MCP Registry DevOps MCP Console Static Tool Manifest Adapter Pipeline Rate Limit Audit Log Auth

Forge

MCP Builder

Python

模板驱动的配置生成器。基于 Atlas 元数据生成 Lens entity_definition 或 Nexus tool_manifest 草稿，经审批后动态生效，不生成生产代码。

模板引擎 Entity Definition Tool Manifest 配置校验版本管理

调用 / Manifest 注册 / 配置下发

核心 MCP 服务层 · Core MCP Services

Atlas

Meta MCP · 元数据中心

Python

整个平台的"真相源"。自动采集数据库 schema、服务列表，管理语义标注，提供 diff 与搜索能力。

list_services get_schema diff_schema search_meta get_semantics

Probe

日志观测 MCP

Python

安全只读的日志证据采集器。从服务日志文件中按条件检索，返回结构化日志片段。L1 层核心组件。

search_logs tail_logs grep_pattern log_stats

Lens

数据查询 MCP

Python

基于语义层的结构化数据查询。AI 通过 DSL 表达查询意图，Lens 生成安全 SQL 并执行。严格只读。

query_entity describe_entity DSL → SQL 风控约束

Trace

链路关联 MCP

Python

L2 层核心。按 request_id / trace_id / order_id 等主键，跨服务聚合日志与状态，还原事件链路。

trace_by_id link_events timeline_view

读取元数据 / 语义规则 / 历史案例

语义 & 知识层 · Semantic & Knowledge

Codex

诊断知识库

Store

L3 层核心。存储业务规则、历史案例、排查路径、噪音说明、归因规则等结构化经验知识。

问题案例排查路径业务规则噪音白名单归因规则链路说明

Semantic Registry

语义注册表

Store

三层语义模型存储。自动推断层 + 规则增强层 + 人工标注层合并为统一语义视图，供所有 MCP 引用。

字段语义业务对象定义实体关系枚举映射

Changelog

变更追踪

Store

存储所有 schema diff、服务变更、配置变更的历史记录。驱动待办生成和知识过时检测。

Schema Diff 服务变更过时检测待办生成

自动采集 / 定时扫描 / 只读查询

业务数据源层 · Business Data Sources

MySQL Clusters

业务数据库

Store

业务系统的 MySQL 实例。Atlas 从 information_schema 采集表结构，Lens 执行只读查询。

information_schema 业务表只读副本

Service Hosts

业务服务器 · Supervisor

Go Binary

物理机部署的 Go 微服务。通过 supervisor 管理进程。Atlas 扫描服务列表，Probe 读取日志文件。

supervisor Go 二进制日志文件配置文件

WeChat Work API

企业微信接口

External

企业微信相关的回调记录、消息状态、RPA 任务执行结果等外部数据源。

回调记录消息状态 RPA 结果

持久化

平台自身存储 · Platform Storage

Meridian DB

平台数据库 · PostgreSQL

PostgreSQL

Meridian 平台自身的持久化存储。存放元数据快照、语义标注、知识条目、变更记录、tool manifest、entity definition、审计日志。

meta_snapshots semantic_annotations knowledge_entries changelog tool_manifests entity_definitions audit_logs

Runtime Logs

开发服务器运行日志

Files

非 Docker 开发部署由 dev-server.sh 将各服务 stdout/stderr 写入 .meridian/logs，DevOps MCP 只读这些日志。

nexus.log atlas.log probe.log lens.log trace.log

核心数据流 · Key Data Flows

Flow 1 · 元数据自举（Atlas 驱动）

Atlas 定时连接 MySQL information_schema，采集表结构快照

Atlas 通过 supervisor XML-RPC 扫描服务列表与进程状态

Changelog 对比新旧快照，生成 diff 记录

Console 展示变更待办，等待人工确认或 Agent 生成标注草稿

Semantic Registry 更新语义视图，下游 MCP 自动生效

Flow 2 · 排障查询（Agent 驱动）

Agent 收到排障请求，通过 Nexus 发现可用工具

Agent 调用 Atlas 了解涉及的服务与数据结构

Agent 调用 Probe 采集日志证据

Agent 调用 Lens 通过 DSL 查询业务数据

Agent 调用 Trace 按主键拼接跨服务链路

Agent 检索 Codex 匹配历史案例与业务规则

Agent 输出：证据摘要 + 候选归因 + 待验证项 + 下一步建议

Flow 3 · 工具自扩展（Forge 驱动）

Agent 识别到新业务对象需要查询能力

Agent 调用 Atlas 获取该对象的 schema 与语义

Agent 调用 Forge 基于模板生成 entity_definition 或 tool_manifest 草稿

Console 展示草稿，人工审批后写入 Lens 配置或 Nexus registry

Nexus 通过 adapter pipeline 动态暴露工具；普通扩展不修改 server.py

新业务对象或新工具能力即时可用，Agent 能力受控扩展

Flow 4 · 知识沉淀（人 + Agent 协作）

事故复盘后，工程师通过 Console 提交案例到 Codex

Changelog 检测到关联服务变更时，标记知识条目为"待复查"

Agent 排障时发现建议被工程师否定，反馈标记知识为"可能过时"

知识质量随使用持续提升，而不是随时间衰减

Flow 5 · 开发者观察（DevOps MCP）

开发者本地 Codex / Claude 连接 Nexus:3000 的 MCP 入口

Nexus 暴露只读 devops.* 工具，不直接执行重启或改配置

dev-server.sh 将服务 stdout/stderr 落盘到 .meridian/logs/*.log

开发者可查看运行状态、服务日志、配置缺口、Console 构建状态和 smoke test

项目命名 · Project Naming

核心数据流 · Key Data Flows