RedNb.Nacos 2.0.0 正式发布：.NET 接入 Nacos 3.2.4，AI Registry 全能力落地

配置中心 + 服务发现 + AI 注册中心，一个 SDK 全部搞定。

引言

Nacos 3.x 最大的变化是什么？不只是配置和服务发现的协议升级，而是它正式把 AI 资产（MCP Server、A2A Agent、Prompt、Skill、AgentSpec）纳入了注册中心的一等公民体系。

但对于 .NET 开发者来说，此前想用上这些能力并不容易------官方 SDK 对 3.x 新协议和 AI 模块的支持一直滞后。

现在，这个空白被填上了。RedNb.Nacos 2.0.0 正式发布 ，这是一个面向 Nacos 3.2.4 的 .NET 8 / .NET 10 SDK，配置、服务发现、ASP.NET Core 集成之外，还带来了完整的 AI Registry 客户端能力。

一、2.0.0 带来了什么

1. 全面拥抱 Nacos 3.2.4

配置和服务发现默认使用 gRPC，性能与实时性对齐官方协议
增加 v3 命名空间管理和原生 gRPC 互斥锁
按 3.2.4 协议修复了模糊监听（Fuzzy Watch）和初始同步

2. AI Registry：五大 AI 资产全支持

这是本次发布的重头戏。SDK 提供统一的 AI 组合客户端，覆盖：

AI 资产	说明
MCP Server	模型上下文协议服务的注册与发现
A2A Agent	Agent 间协作协议的注册与管理
Prompt	提示词的版本化托管
Skill	技能单元的注册与治理
AgentSpec	Agent 声明式规格描述

内部会按服务器实际能力，自动在 HTTP Client、Admin、Console 通道之间选择，调用者无需关心底层差异。

3. ASP.NET Core 深度集成

IConfiguration 配置热更新开箱即用
健康检查、服务注册一站集成
支持命名客户端，多套 Nacos 环境相互隔离

4. 工程质量的全面升级

本地 1,356 个测试实例全部通过，云端集成测试 110 通过、0 失败
修复断线重连、服务注册重放和订阅恢复等稳定性问题
6 个 NuGet 包通过内容校验，并完成 .NET 8 / .NET 10 独立安装验证

二、三分钟上手

安装聚合包即可体验全部组件：

bash 复制代码

dotnet add package RedNb.Nacos.All --version 2.0.0

依赖注入一行注册：

csharp 复制代码

services.AddNacos(options =>
{
    options.ServerAddresses = "localhost:8848";
    options.Username = Environment.GetEnvironmentVariable("NACOS_USERNAME");
    options.Password = Environment.GetEnvironmentVariable("NACOS_PASSWORD");
});

AI 能力单独启用，模块延迟创建，不会因为注册基础服务就连接 AI 模块：

csharp 复制代码

services.AddNacosAi();

// 或者不走 DI，直接创建组合客户端
var ai = new NacosAiClient(options);

按需分包也很清晰：

NuGet 包	用途
RedNb.Nacos	接口、模型、选项和公共功能
RedNb.Nacos.Http	显式 HTTP 客户端和 v3 管理接口
RedNb.Nacos.Grpc	配置、服务发现、原生锁和 AI 组合客户端
RedNb.Nacos.DependencyInjection	推荐的 DI 注册入口
RedNb.Nacos.AspNetCore	配置热更新、健康检查、服务注册
RedNb.Nacos.All	纯依赖聚合包

三、升级前必读：破坏性变化

2.0.0 是一次包含破坏性调整的主版本，从 1.x 升级请注意：

不再支持 Nacos 2.x，本次验收基线为 Nacos 3.2.4
公开命名空间和部分入口发生变化
AddNacos 默认使用 gRPC Config/Naming
纯 HTTP 配置监听和模糊监听明确报不支持，请使用 gRPC 入口
默认鉴权使用用户名密码 / Token，不再支持旧实现假设的 AK/SK 登录
RedNb.Nacos.All 改为纯依赖聚合包

官方提供了完整的迁移说明 和能力矩阵，升级前建议先对照阅读。

四、已知边界

坦诚地说，本次认证也有明确边界：

MCP / A2A 的 Console 操作在 Nacos 3.2.4 上限定 public 命名空间
原生互斥锁不提供 fencing 或可重入语义
TLS、自定义代理、多节点集群故障切换及极端并发场景未纳入本次完整认证

五、为什么值得关注

如果说 Nacos 3.x 的野心是成为"AI 时代的注册配置中心"，那么 RedNb.Nacos 2.0.0 就是让 .NET 生态不掉队的关键拼图。

想象这样一个场景：你的 Agent 系统里，Prompt 版本、Skill 定义、AgentSpec 规格、MCP 工具端点全部托管在 Nacos 中，运行时动态拉取、热更新------Agent 的行为可以像配置一样被治理。这在 Prompt 工程和 Agent 编排日益复杂的今天，是一个非常实用的基础设施方向。

结语

项目以 Apache-2.0 协议开源，欢迎试用与反馈：

GitHub：https://github.com/yinghongzhen/RedNb.Nacos
NuGet：搜索 RedNb.Nacos

如果你正在 .NET 技术栈上构建微服务或 AI Agent 应用，这个 SDK 值得一试。

本文基于 RedNb.Nacos 2.0.0 官方 Release Notes 与项目文档整理。