配置中心 + 服务发现 + 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 组合客户端，覆盖：

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

3. ASP.NET Core 深度集成

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

4. 工程质量的全面升级

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

二、三分钟上手

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

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

依赖注入一行注册：

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

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

services.AddNacosAi();

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

按需分包也很清晰：

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

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

1. 不再支持 Nacos 2.x，本次验收基线为 Nacos 3.2.4
2. 公开命名空间和部分入口发生变化
3. AddNacos 默认使用 gRPC Config/Naming
4. 纯 HTTP 配置监听和模糊监听明确报不支持，请使用 gRPC 入口
5. 默认鉴权使用用户名密码 / Token，不再支持旧实现假设的 AK/SK 登录
6. 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 与项目文档整理。