# 沧溟

**Repository Path**: fangyu_fy/cangming

## Basic Information

- **Project Name**: 沧溟
- **Description**: 沧溟，客户端通用基座框架。百川入沧溟，万象共一基。取沧溟万川归海之意，不拘组件来源、协议差异，统一承载异构业务模块，为客户端应用提供可扩展、插件化的运行宿主。沧溟是面向C#的客户端通用基座框架，主打插件化宿主、异构组件兼容、多协议适配。框架提供统一的组件生命周期管理、依赖注入、消息通信、资源隔离能力，业务模块可独立开发、热加载、按需挂载，无需强耦合于主程序。
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-18
- **Last Updated**: 2026-10-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 沧溟

> 百川入沧溟，万象共一基

沧溟，客户端通用基座框架。取沧溟万川归海之意，不拘组件来源、协议差异，统一承载异构业务模块，为客户端应用提供可扩展、插件化的运行宿主。

## 简介
沧溟是面向C#的客户端通用基座框架，主打插件化宿主、异构组件兼容、多协议适配。
框架提供统一的组件生命周期管理、依赖注入、消息通信、资源隔离能力，业务模块可独立开发、热加载、按需挂载，无需强耦合于主程序。

无论自研业务组件、第三方SDK、异构协议接入模块，均可接入沧溟宿主，实现“一次适配，统一运行”。

## 核心特性
- 🔌 **强兼容**：不限制组件来源与通信协议，支持多类型业务模块接入
- 🧩 **插件化架构**：独立插件沙箱，支持模块热加载、动态卸载、版本隔离
- 📦 **统一宿主**：标准化组件生命周期、依赖管理、事件总线
- ⚙️ **可扩展**：内置抽象层，可自定义适配器、调度器、通信通道
- 🛡️ **隔离运行**：插件资源隔离，单个模块异常不直接摧毁主客户端

## 模块体系
- `Cangming.Kernel` —— 框架核心内核，抽象定义与基础运行时
- `Cangming.Channel` —— 通信管道、事件总线与消息分发
- `Cangming.Islet` —— 插件沙箱，提供模块隔离运行环境
- `Cangming.Tributary` —— 适配器层，对接第三方组件、外部协议
- `Cangming.Wave` —— 异步任务调度与任务生命周期管理
- `Cangming.Ferry` —— 跨后端、跨平台对接适配层

## 快速开始
```csharp
// 初始化沧溟宿主
var host = CangmingHost.CreateDefaultBuilder()
    .ConfigureKernel(kernel =>
    {
        // 注册插件、适配器、业务组件
    })
    .Build();

await host.StartAsync();