# UB-agent

**Repository Path**: minknov/ub-agent

## Basic Information

- **Project Name**: UB-agent
- **Description**: 华为灵衡总线（UB）个人知识库系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-18
- **Last Updated**: 2026-05-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# UB-agent - 华为灵衢总线（UB）个人知识库系统

## 项目简介

UB-agent 是一个基于华为灵衢总线（Unified Bus，简称 UB）的个人知识库系统，通过 Claude Code 实现智能化的知识管理和源码分析。

## 项目目标

1. 自动从网上获取最新的 UB 相关信息
2. 将获取的信息以 Markdown 格式固化到本地知识库
3. 记录用户对灵衢总线的独有关注点和观点
4. 在后续交流中作为参考依据
5. 跟踪华为灵衢总线相关的源码更新，并进行深入分析
6. 在问答过程中使用技术架构图、部署图等形式回答问题
7. 使用 Git 跟踪知识库的修改历史

## 华为灵衢总线（UB）背景

灵衢总线（Unified Bus，简称 UB）是华为在 2025 年 9 月全联接大会上发布的面向超节点的新型互联协议。

### 核心信息

- **发布时间**：2025 年 9 月 18 日
- **发布场合**：华为全联接大会 2025
- **发布人**：华为副董事长、轮值董事长 徐直军
- **研究起始**：2019 年
- **当前版本**：灵衢 2.0（技术规范已开放）
- **英文名称**：Unified Bus (UB)

### 技术特点

- 面向超节点的新型互联协议
- 目标是将数据中心变成一个总线
- 实现"去中心化超节点"架构
- 引领 AI 基础设施新范式

## 项目结构

```
UB-agent/
├── .claude/                    # Claude Code 配置目录
│   └── project_prompt.md       # 项目 Prompt 文件
├── .git/                       # Git 仓库
├── .gitignore                  # Git 忽略文件配置
├── .gitmodules                 # Git Submodule 配置
├── .mcp.json                  # MCP 服务器配置
├── README.md                   # 项目说明文档
├── PROJECT_PROMPT.md           # 项目说明文档
├── knowledge-base/            # 知识库目录
│   ├── research/              # 研究资料
│   │   ├── 2025-01-17-灵衢总线初始研究.md
│   │   ├── 2025-01-17-灵衢总线技术架构图.md
│   │   └── 2025-01-17-源码仓库说明.md
│   ├── my-notes/             # 用户关注点
│   │   └── 2025-01-17-用户关注点模板.md
│   └── summaries/            # 知识总结
└── source-code/              # 源码目录
    └── huawei-ub/            # 华为灵衢总线源码
        ├── obmm/             # obmm sub-module
        └── sysSentry/         # sysSentry sub-module
```

## 知识库目录说明

### research/ - 研究资料

存放从网上获取的最新 UB 研究资料，包括：
- 华为官方发布信息
- 技术博客和文档
- 新闻报道和行业分析
- 技术规范和标准

### my-notes/ - 用户关注点

存放用户对灵衢总线的独有关注点和观点，包括：
- 技术架构层面的关注点
- 性能指标层面的关注点
- 应用场景层面的关注点
- 生态建设层面的关注点

### summaries/ - 知识总结

存放对分散的研究资料和用户笔记的总结，包括：
- 关键发现
- 主要结论
- 后续建议

## 源码仓库说明

### obmm (OpenEuler OBMM)

- **仓库地址**：https://gitee.com/openeuler/obmm.git
- **项目描述**：OpenEuler OBMM（OpenEuler Bus Memory Management）项目
- **主要功能**：
  - 远程内存访问（Remote Memory Access）
  - 共享内存设备（Shared Memory Device）
  - 内存导入/导出管理
  - 内存所有权管理

### sysSentry (OpenEuler SysSentry)

- **仓库地址**：https://gitee.com/openeuler/sysSentry.git
- **项目描述**：OpenEuler SysSentry 系统哨兵项目
- **主要功能**：
  - CPU 故障检测
  - 块设备 I/O 监控
  - AI 驱动的异常检测
  - SOC 环形缓冲区监控
  - HBM 在线修复
  - 告警消息监控

## 配置说明

### MCP 服务器

1. **Filesystem MCP**：访问本地文件系统
   - 配置文件：`.mcp.json`
   - 访问路径：`E:\work\denggx\src\test`

2. **GitHub MCP**：访问 GitHub 上的开源项目
   - 配置文件：`.mcp.json`
   - 功能：搜索、克隆、分析 GitHub 上的华为灵衢总线相关源码

### Git 版本控制

- 已初始化 Git 仓库
- 配置文件：`.gitignore`
- 功能：跟踪知识库的修改历史

### Claude Code 配置

- 项目 Prompt：`.claude/project_prompt.md`
- 项目说明：`PROJECT_PROMPT.md`
- 环境变量：
  - `ANTHROPIC_BASE_URL`：`https://open.bigmodel.cn/api/anthropic`
  - `ANTHROPIC_AUTH_TOKEN`：你的 GLM API Key
  - `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`：`1`

## 使用指南

### 1. 克隆项目

```bash
git clone --recurse-submodules https://gitee.com/minknov/ub-agent.git
cd ub-agent
```

### 2. 启动 Claude Code

```bash
claude
```

### 3. 获取最新信息

```
你：帮我搜索一下华为灵衢总线的最新技术进展
Claude：[搜索信息并整理成文档保存到 knowledge-base/research/]
```

### 4. 记录用户观点

```
你：我对灵衡总线的性能指标很关注
Claude：[记录你的关注点到 knowledge-base/my-notes/]
```

### 5. 生成技术架构图

```
你：请用图表形式展示灵衡总线的部署架构
Claude：[使用 Mermaid 语法生成部署图]
```

### 6. 跟踪源码更新

```
你：帮我更新一下 obmm 和 sysSentry 的源码
Claude：[使用 git submodule update 更新源码]
```

### 7. Git 版本控制

```bash
# 查看状态
git status

# 添加文件
git add .

# 提交更改
git commit -m "更新知识库内容"

# 推送到 Gitee
git push origin master
```

## 技术架构图

### 整体架构图

```mermaid
graph TD
    subgraph "应用层"
        A1[AI 训练任务]
        A2[推理服务]
        A3[数据存储]
    end

    subgraph "超节点层"
        N1[超节点 1]
        N2[超节点 2]
        N3[超节点 3]
    end

    subgraph "灵衡总线层"
        UB[灵衡总线 Unified Bus]
        UB1[互联协议 2.0]
        UB2[路由控制]
        UB3[流量管理]
    end

    A1 --> N1
    A2 --> N2
    A3 --> N3

    N1 --> UB
    N2 --> UB
    N3 --> UB

    UB --> UB1
    UB --> UB2
    UB --> UB3
```

### 部署架构图

```mermaid
graph LR
    subgraph "数据中心 A"
        A_N1[超节点 A1]
        A_N2[超节点 A2]
        A_UB[灵衡总线 A]
        A_N1 --> A_UB
        A_N2 --> A_UB
    end

    subgraph "数据中心 B"
        B_N1[超节点 B1]
        B_N2[超节点 B2]
        B_UB[灵衡总线 B]
        B_N1 --> B_UB
        B_N2 --> B_UB
    end

    A_UB <-->|跨数据中心互联| B_UB
```

## 后续计划

- [ ] 深入分析 OBMM 的核心实现
- [ ] 深入分析 SysSentry 的插件架构
- [ ] 研究 OBMM 与灵衡总线的集成方式
- [ ] 研究 SysSentry 的监控机制
- [ ] 总结关键技术点并记录到知识库
- [ ] 定期更新最新的 UB 信息

## 参考资料

- 华为全联接大会 2025 官方发布
- 灵衡 2.0 技术规范文档
- 华为昇腾产业峰会 2025
- OpenEuler OBMM 项目文档
- OpenEuler SysSentry 项目文档

## 许可证

本项目遵循相关开源项目的许可证。

## 联系方式

- Gitee：https://gitee.com/minknov/ub-agent

## 更新日志

- 2025-01-17：项目初始化
  - 配置 Filesystem MCP 和 GitHub MCP
  - 创建知识库目录结构
  - 初始化 Git 仓库
  - 添加 obmm 和 sysSentry sub-module
  - 创建初始研究文档和技术架构图
  - 推送到 Gitee