Senparc.Ncf.Core 0.31.0-preview11

Prefix Reserved

This is a prerelease version of Senparc.Ncf.Core.

dotnet add package Senparc.Ncf.Core --version 0.31.0-preview11

NuGet\Install-Package Senparc.Ncf.Core -Version 0.31.0-preview11

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Senparc.Ncf.Core" Version="0.31.0-preview11" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Senparc.Ncf.Core" Version="0.31.0-preview11" />
                    

                            Directory.Packages.props

<PackageReference Include="Senparc.Ncf.Core" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add Senparc.Ncf.Core --version 0.31.0-preview11

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Senparc.Ncf.Core, 0.31.0-preview11"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package Senparc.Ncf.Core@0.31.0-preview11

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=Senparc.Ncf.Core&version=0.31.0-preview11&prerelease
                    

                            Install as a Cake Addin

#tool nuget:?package=Senparc.Ncf.Core&version=0.31.0-preview11&prerelease
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Senparc.Ncf.Core

Senparc.Ncf.Core is the shared application foundation for NeuCharFramework (NCF). It contains the request/response model, application-service, event, authorization, localization, entity, and web API primitives used by NCF and XNCF packages.

Features

AppServiceBase, AppRequestBase, and AppResponseBase<T> for consistent application-service contracts.
In-process event bus and request/response event support with cancellation, timeout, and correlation handling.
Permission requirements, permission attributes, administrator context, and authorization handlers.
Function-render metadata and localized descriptions for module functions and parameters.
Core entities, DTO support, paging models, validation, cache markers, and common web helpers.

Installation

<PackageReference Include="Senparc.Ncf.Core" Version="0.26.0-preview3" />

Key API

Derive application services from AppServiceBase and use AppServiceHelper for common response and request handling.
Use AppRequestBase/AppResponseBase<T> and StringAppResponse as transport-friendly function contracts.
Register or consume IEventBus, IEventBusRequestClient, InMemoryEventBus, and EventBusExtensions for integration events and request clients.
Apply PermissionAttribute, PermissionFilterAttribute, PermissionRequirement, and PermissionHandler for NCF authorization.
Use FunctionRenderAttribute, LocalizedDescriptionAttribute, LocalizedRequiredAttribute, and ResourceStringLocalizer to expose localized module metadata.

NCF hosts normally load this package through the standard NCF startup pipeline. When composing a smaller host, register the required DI, authentication, data, and localization services explicitly and do not assume that a package reference alone enables authorization.

Product	Compatible and additional computed target framework versions.
.NET	net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- AutoMapper.Extensions.Microsoft.DependencyInjection (>= 12.0.1)
- Microsoft.EntityFrameworkCore (>= 8.0.10)
- Microsoft.EntityFrameworkCore.Relational (>= 8.0.10)
- Senparc.CO2NET (>= 4.2.0)
- Senparc.CO2NET.Cache.CsRedis (>= 2.3.3)
- Senparc.CO2NET.WebApi (>= 2.1.9-preview)
- Senparc.Ncf.Log (>= 0.20.1-preview1)
- Senparc.Ncf.Shared.Abstractions (>= 0.7.0-preview1)
- Senparc.Ncf.Utility (>= 0.21.2-preview4)

NuGet packages (25)

Showing the top 5 NuGet packages that depend on Senparc.Ncf.Core:

Package	Downloads
Senparc.Ncf.XncfBase Senparc.Ncf.XncfBase	111.3K
Senparc.Ncf.Database Senparc.Ncf.Database	110.7K
Senparc.Ncf.Service Senparc.Ncf.Service	105.5K
Senparc.Ncf.SMS Senparc.Ncf.SMS	100.2K
Senparc.Ncf.Repository Senparc.Ncf.Repository	100.1K

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
0.31.0-preview11	252	11/11/2026
0.30.4-preview10	461	11/5/2026
0.30.3-preview9	228	11/2/2026
0.30.2-preview9	531	10/4/2026
0.30.0-preview9	1,394	8/29/2026
0.29.0-preview8	1,012	8/14/2026
0.28.2-preview7	467	8/12/2026
0.28.1-preview6	446	8/8/2026
0.28.0-preview5	481	8/3/2026
0.27.0-preview4	467	7/31/2026
0.26.0-preview3	394	7/28/2026
0.25.0-preview2	373	7/26/2026
0.24.2-preview1	261	7/3/2026
0.24.1-preview1	626	6/17/2026
0.23.18.1-preview	675	5/9/2026
0.23.17-preview.1	227	2/13/2026
0.23.16.3-preview	404	12/28/2025
0.23.16.1-preview	441	12/28/2025
0.23.16-preview	307	11/1/2025
0.23.2-preview	439	6/16/2026

[2024-08-11] v0.19.2.0-preview1 新增 DtoBase<T> 类型
[2024-08-22] v0.20.0-preview1 为MethodCache 添加异步方法
v0.1.0 创世
v0.1.1 完善自动部署模块 Xncf
v0.3.101 丰富 XncfModule 的数据库属性
v0.7.3 AppServiceHelper.GetResponseAsync() 增加统一请求日志缓存功能
v0.9.4.4 完善出错日志输出
v0.11.5.2 完善系统启动自检信息输出
v0.11.6 添加 SenparcCoreSetting.PasswordSaltToken 参数
v0.14.0 支持根据运行环境，自动启用 SenparcConfig.Development.config
v0.14.1 ConvertXmlToEntity 中加入 TimeOnly 和 DateOnly 类型
v0.16.4 重构 EntityBase 属性
v0.16.7 添加 MultipleDatabaseType.Dm 枚举类型
[2024-08-26] v0.20.1 修改 SystemConfig，添加 NeuCharAppKey 等云端账户信息
[2024-08-27] v0.20.2 修改 FullSystemConfig，添加 NeuCharAppKey 等云端账户信息
[2024-08-28] v0.20.3 系统启动自检时已载入的 XNCF 模块显示版本号
[2024-09-10] v0.20.4-preview1 升级缓存基础库
[2024-10-16] v0.20.6-preview1 添加 Service 对 PagedList 对象快速 Mapping 到 DTO 对象的方法
[2024-10-16] v0.21.0 优化 AppServiceBase，提供依赖注入快捷方法
[2024-10-26] v0.21.2 更新启动标志信息
[2024-11-15] v0.22.0-preview1 使用新版本 AutoGen，升级 AgentsManager；解决 AgentsManager 中状态获取的异常
[2024-11-16] v0.22.2-preview1 启动日志的版本号提供外部自定义
[2024-11-19] v0.23.1-preview1 升级基础库，支持 Aspire 提供对的支持和优化
[2024-11-20] v0.23.2-preview1 新增发方法：获取 Aspire 使用的统一默认 XNCF 名称
[2024-11-21] v0.23.3-preview1 更新 CO2NET 及缓存基础库
[2024-11-28] v0.23.5-preview1 update CO2NET, use new SenparcSetting with UseLowerCaseApiName property
[2025-01-12] v0.23.8-preview1 add LoginLockException
[2025-01-25] v0.23.10-preview1 Update Agents functions, support for function calling
[2025-04-29] v0.23.12-preview1 Update CO2NET and AIKernel
[2025-04-29] v0.23.13-preview1 Update CO2NET and AIKernel
[2025-11-01] update basic libraries, including Senparc.AI
[2026-07-02] v0.24.2-preview1 新增 PromptRange 与 AgentsManager 使用记录能力，升级 Senparc.AI.AgentKernel 并完成兼容性适配
1、新增 PromptRange 与 AgentsManager 使用记录能力
2、升级 Senparc.AI.AgentKernel 并完成兼容性适配
[2026-07-17] v0.25.0-preview2 新增统一资源本地化基础设施并支持 FunctionRender 动态文案
1、扩展 FunctionRenderAttribute 与本地化特性，支持资源键动态解析
2、新增统一资源定位、文化回退与本地化服务基础能力
3、为模块功能描述和请求参数提供一致的多语言输出机制
4、增加请求客户端、请求事件和处理器回环机制
5、支持超时、取消、类型检查及请求关联清理
[2026-07-29] v0.26.0-preview3 修复安装状态写入并统一授权策略名称
1、修复 SiteConfig 安装状态属性未保存赋值的问题
2、新增跨模块共享的 NCF 授权策略名称定义
[2026-07-31] v0.27.0-preview4 新增核心验证与授权消息的共享本地化资源
1、新增 NcfCoreResource 及多语言资源，统一核心验证和授权提示
2、将通用验证错误接入文化回退机制
3、升级 Senparc.CO2NET 4.2.0 与 Senparc.CO2NET.WebApi 2.1.9-preview
[2026-08-04] v0.28.0-preview5 新增数据库升级维护状态与可配置页脚安全处理
1、新增数据库安装与升级状态检测、升级异常及 Razor 维护流程支持
2、扩展 SystemConfig.FooterContent、缓存与页脚内容安全清理能力
[2026-08-08] v0.28.1-preview6 Dependency update from Senparc.Ncf.Shared.Abstractions to 0.5.0-preview4
[2026-08-13] v0.28.2-preview7 Dependency update from Senparc.Ncf.Shared.Abstractions to 0.6.0-preview5
[2026-08-15] v0.29.0-preview8 新增 FunctionRender 的 AI 自动调用控制
1、为 FunctionRenderAttribute 增加 AllowAiInvocation 开关，允许模块声明是否自动暴露给 AI 对话工具
2、保持原有 FunctionRender 页面和显式 AppService 调用行为不变，区分 AI 自动调用与人工触发路径
[2026-08-29] v0.30.0-preview9 新增 FunctionRender 函数名匹配与全局调用控制能力
1、新增 MethodName 和函数键匹配逻辑，兼容按方法名解析 FunctionRender
2、扩展全局 NeuCharPivot 调用访问策略元数据，保持人工触发与受控调用边界
[2026-10-01] v0.30.1-preview9 提供可等待的安装完成标记 API
1、新增 SetInstallFinishedAsync，使文件写入失败可由安装流程观察和处理
2、保留同步兼容入口并标记迁移提示
[2026-10-02] 提供统一后台租户作用域入口，复用租户注册信息并保持独立作用域
[2026-11-03] v0.30.3-preview9 新增请求租户快照 RequestTenantSnapshot，统一后台任务/隔离作用域的租户上下文传播
1、新增 RequestTenantSnapshot：请求作用域捕获租户（Capture/From），独立作用域还原（Restore），仅多租户启用且匹配成功时生效
2、保持 fail-closed 语义：未匹配或作用域已释放时不修改目标作用域租户上下文
3、配合各模块修复 ChatGroup、A2A、Token 用量、沙箱、Workspace、Workflow 等后台/跨作用域场景的租户隔离
4、提供请求租户快照与后台租户作用域，支持隔离作用域恢复租户上下文
[2026-11-03] v0.30.4-preview10 以中文资源为基准统一整理多语言文案
1、补齐并校正各语言资源条目，使模块界面文案与中文基准保持一致
[2026-11-11] v0.30.4-preview10 统一字符串资源的文化回退
1、资源查找按当前文化、英语、简体中文，再回退到中性资源。
2、本地化服务注册与资源读取共用这条回退链，缺少翻译时仍显示已有文案。
[2026-11-12] v0.31.0-preview11 增强本地化资源文化回退能力
1、资源查找按当前文化、英语、简体中文和中性资源逐级回退。
2、本地化服务注册与资源读取共用一致的回退链，缺少翻译时仍保留可用文案。