NCF 核心能力详解（面向实战）

适用范围：NcfPackageSources 当前版本。
基线提交：631f16b4（2026-06-17）。

1. 核心能力总览

学习当前版本时，建议优先掌握以下能力：

EventBus 已形成“高并发 + 重试 + 去重 + 事件链深度/循环保护”的完整机制。
PromptRange 与 AgentsManager 的协作链路已通过事件模型和 AppService 进一步标准化。
KnowledgeBase 已具备“文件切片 -> 向量化 -> 召回测试”的基础闭环。
XncfModuleManager 增强了面向 AI 的模块安装/开放能力（UID 或名称关键字匹配）。
FirmwareUpdate 提供了 GitHub Release 到站点本地 wwwroot/NcfPackages 的镜像能力。
MCP 相关能力已下沉到 IXncfRegister/XncfRegisterBase 统一协议，可按模块开关。

1.1 XNCF 的单粒度模块定义（框架意义）

在 NCF 中，Senparc.Xncf.xxx 并不是“可有可无的插件集合”，而是模块化框架中的核心能力单元。
每个 XNCF 都应按“单粒度模块”理解：一个模块聚焦一个能力域，具备独立注册、独立生命周期、独立治理边界。

这意味着：

Senparc.Ncf.* 负责框架底座能力。
Senparc.Xncf.* 负责业务能力装配与演进。

如果只看基础库、不看 XNCF，就只能理解“框架怎么跑”，却无法理解“功能怎么拼”。

2. 扩展模块能力清单（按源码 Register 实际值）

2.1 系统核心模块（59xx）

模块	版本	XncfOrder	作用
Senparc.Xncf.Menu	0.1	5940	系统菜单管理
Senparc.Xncf.XncfModuleManager	0.1.2	5950	模块状态治理、安装开放、Function 状态检查
Senparc.Xncf.AreasBase	0.1	5955	Area 基础能力
Senparc.Xncf.SystemPermission	0.2.0	5960	权限管理
Senparc.Xncf.SystemManager	1.1.2	5970	系统管理与核心配置
Senparc.Xncf.SystemCore	0.1.1	5980	系统核心数据结构
Senparc.Xncf.Tenant	0.1	5990	多租户能力

2.2 AI / RAG / Agents 相关模块

模块	版本	XncfOrder	MCP	说明
Senparc.Xncf.AIKernel	5.0.5	-	否	AI 模型/向量模型配置与运行基础
Senparc.Xncf.PromptRange	0.15.2	5897	否	提示词靶场、PromptCode 体系
Senparc.Xncf.AgentsManager	0.3.18.9	-	否	智能体模板、群聊任务、优化流程
Senparc.Xncf.KnowledgeBase	0.1.10	-	否	知识库管理、导入、向量化、召回测试
Senparc.Xncf.AIAgentsHub	0.1.0	-	否	Agent Hub（早期）
Senparc.Xncf.MCP	0.1.0	-	是	MCP 端点与调用管理

2.3 开发与运维模块

模块	版本	XncfOrder	MCP	说明
Senparc.Xncf.XncfBuilder	0.10.1	5896	是	模块脚手架、迁移命令、AI 辅助代码生成
Senparc.Xncf.DatabaseToolkit	0.7.1	-	否	数据库更新、备份、结构查询、Agent 集成查询
Senparc.Xncf.Swagger	0.7.1	0	否	接口文档
Senparc.Xncf.Terminal	0.1.6	-	否	服务器终端命令执行（高权限）
Senparc.Xncf.FileManager	0.2.5	-	否	文件管理
Senparc.Xncf.FirmwareUpdate	0.1.0	-	否	同步 NCF 安装包并维护 latest-release.json
Senparc.Xncf.ChangeNamespace	0.3.9	-	否	全局命名空间替换（高风险）
Senparc.Xncf.DynamicData	0.1.0	-	否	动态数据基础模块（早期）
Senparc.Xncf.SenMapic	0.1.3	-	否	爬虫示例模块
Senparc.Xncf.Application	0.0.5	-	否	外部程序调用模块
Senparc.Xncf.WeixinManager	0.21.1	5880	是	微信管理与对应 MCP 能力

3. 关键机制详解（直接对应源码）

3.1 EventBus：高并发与安全边界

核心文件：

Senparc.Ncf.Core/EventBus/InMemoryEventBus.cs
Senparc.Ncf.Core/EventBus/EventBusHostedService.cs
Senparc.Ncf.Shared.Abstractions/Events/IIntegrationEvent.cs

关键能力：

MaxConcurrency 并发处理（默认 max(4, CPU*2)）
去重处理（10 分钟窗口，TryMarkEventAsProcessed）
失败重试（指数退避）
事件链深度上限控制（MaxEventChainDepth）
循环引用检测（事件链模式校验）

推荐注册方式：

services.AddSenparcEventBus(options =>
{
    options.MaxConcurrency = Math.Max(8, Environment.ProcessorCount * 2);
    options.EnableDuplicateDetection = true;
    options.RetryOnFailure = true;
    options.MaxRetryAttempts = 3;
    options.MaxEventChainDepth = 10;
    options.EnableCircularReferenceDetection = true;
}, typeof(YourHandler).Assembly);