NcfPackageSources

目录 / Table of Contents

• 项目介绍 / Introduction
• 开发环境 / Development Environment
• 快速开始 / Quick Start
• 项目结构 / Project Structure
• 模块加载顺序 / Module Loading Order
• 可用的 Nuget 包 / Available NuGet Packages
• 贡献指南 / Contributing
• 许可证 / License

项目介绍 / Introduction

本项目为 NCF（NeuCharFramework） 模板官方包的核心基础库源码。

当您使用 NCF 模板开发项目时，核心基础库将为您提供一系列基础能力的支撑，通常情况下您无需关心这些库的具体实现，只需要引用即可。

当您需要了解、修改或调试相关基础库时，您可以通过本项目获取源码。

NCF 文档地址：https://doc.ncf.pub/。

开发环境 / Development Environment

• Visual Studio 2019+ 或 VS Code 最新版本
• .NET 8.0
• 支持的数据库：
  • SQLite
  • MySQL
  • SQL Server (2012+)
  • PostgreSQL
  • Oracle
  • DM（达梦）

快速开始 / Quick Start

1. 克隆仓库

git clone https://github.com/NeuCharFramework/NcfPackageSources.git

2. 打开解决方案

cd NcfPackageSources
start NcfPackageSources.sln  # Windows
open NcfPackageSources.sln   # macOS

3. 还原包

dotnet restore

4. 还原工作负载（可选）

dotnet workload restore

5. 编译运行

dotnet build
dotnet run

项目结构 / Project Structure

文件夹 / Folder	说明 / Description
src/Basic	必须安装的基础官方库，以 Separc.Ncf. 开头 Required basic official libraries, prefixed with Separc.Ncf.
src/Extensions	可选的扩展包，以 Senparc.Xncf. 开头 Optional extension packages, prefixed with Senparc.Xncf.
src/Extensions/System	系统模块 System modules

模块加载顺序 / Module Loading Order

使用 [XncfOrder(x)] 特性指定模块的加载顺序，为降序排列，数字越大越在前：

The [XncfOrder(x)] attribute specifies the loading order of modules in descending order, larger numbers load first:

• 0：默认值，可以不用设置 / Default value, no need to set
• 1 ~ 5000：需要预加载的重要模块 / Important modules that need preloading
• 5000+：系统及基础模块 / System and basic modules
• 58xx：AI 相关基础模块 / AI-related basic modules
• 59xx：系统底层基础模块 / System underlying basic modules

可用的 Nuget 包 / Available NuGet Packages

基础库 / Basic Libraries

包名 / Package Name	描述 / Description	版本 / Version
Senparc.Ncf.XncfBase	XNCF 模块基础库
Senparc.Ncf.Core	核心基础库
Senparc.Ncf.DatabasePlant	数据库组装厂
Senparc.Ncf.Log	日志模块
Senparc.Ncf.AreaBase	Area 基础模块
Senparc.Ncf.UnitTestExtension	单元测试扩展
Senparc.Ncf.Mvc.UI	MVC UI 组件
Senparc.Ncf.Database	数据库基础库
Senparc.Ncf.Database.MySql.Backup	MySQL 数据库备份
Senparc.Ncf.Database.MySql	MySQL 数据库支持
Senparc.Ncf.Database.Oracle	Oracle 数据库支持
Senparc.Ncf.Database.PostgreSQL	PostgreSQL 数据库支持
Senparc.Ncf.Database.Sqlite	SQLite 数据库支持
Senparc.Ncf.Database.SqlServer	SQL Server 数据库支持
Senparc.Ncf.Database.Dm	达梦(DM)数据库支持
Senparc.Ncf.Database.InMemory	内存数据库支持
Senparc.Ncf.Repository	仓储层
Senparc.Ncf.Service	服务层
Senparc.Ncf.SMS	短信服务
Senparc.Ncf.Utility	工具类库

扩展 XNCF 模块 / Extension XNCF Modules

包名 / Package Name	描述 / Description	版本 / Version
Senparc.Xncf.AgentsManager	智能体管理器
Senparc.Xncf.AIAgentsHub	AI 智能体中心
Senparc.Xncf.AIKernel	AI 内核
Senparc.Xncf.ChangeNamespace	命名空间修改工具
Senparc.Xncf.Dapr	Dapr 分布式运行时支持
Senparc.Xncf.DatabaseToolkit	数据库工具包模块
Senparc.Xncf.DynamicData	动态数据基础模块
Senparc.Xncf.FileManager	文件管理模块
Senparc.Xncf.KnowledgeBase	AI 知识库
Senparc.Xncf.MCP	MCF 多租户微服务平台
Senparc.Xncf.PromptRange	AI 提示词靶场
Senparc.Xncf.SenMapic	SenMapic 爬虫模块
Senparc.Xncf.Swagger	Swagger 接口文档
Senparc.Xncf.Terminal	终端命令模块
Senparc.Xncf.XncfBuilder	XNCF 模块生成器
Senparc.Xncf.AreasBase	系统区域基础模块
Senparc.Xncf.Menu	菜单管理模块
Senparc.Xncf.SystemCore	系统核心模块
Senparc.Xncf.SystemManager	系统管理模块
Senparc.Xncf.SystemPermission	系统权限模块
Senparc.Xncf.Tenant	多租户管理模块
Senparc.Xncf.Tenant.Interface	多租户接口模块
Senparc.Xncf.XncfModuleManager	XNCF 模块管理器

贡献指南 / Contributing

我们欢迎开发者为 NCF 贡献代码。如果您想要贡献，请：

We welcome developers to contribute to NCF. If you want to contribute, please:

1. Fork 本仓库 / Fork this repository
2. 创建您的特性分支 / Create your feature branch
3. 提交您的改动 / Commit your changes
4. 推送到分支 / Push to the branch
5. 创建 Pull Request / Create a Pull Request

许可证 / License

Apache License Version 2.0

详细请参考 / For details, please refer to: LICENSE

---