Senparc.Xncf.KnowledgeBase 0.6.0-preview8

Prefix Reserved
This is a prerelease version of Senparc.Xncf.KnowledgeBase.
dotnet add package Senparc.Xncf.KnowledgeBase --version 0.6.0-preview8
                    
NuGet\Install-Package Senparc.Xncf.KnowledgeBase -Version 0.6.0-preview8
                    
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.Xncf.KnowledgeBase" Version="0.6.0-preview8" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Senparc.Xncf.KnowledgeBase" Version="0.6.0-preview8" />
                    
Directory.Packages.props
<PackageReference Include="Senparc.Xncf.KnowledgeBase" />
                    
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.Xncf.KnowledgeBase --version 0.6.0-preview8
                    
#r "nuget: Senparc.Xncf.KnowledgeBase, 0.6.0-preview8"
                    
#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.Xncf.KnowledgeBase@0.6.0-preview8
                    
#: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.Xncf.KnowledgeBase&version=0.6.0-preview8&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Senparc.Xncf.KnowledgeBase&version=0.6.0-preview8&prerelease
                    
Install as a Cake Tool

Senparc.Xncf.KnowledgeBase

Senparc.Xncf.KnowledgeBase is an NCF module for importing text sources, publishing versioned vector collections, and providing RAG retrieval to other XNCF modules.

Features

  • Stores inline text and FileManager source IDs as independently traceable chunks.
  • Extracts supported source files through FileManager, then performs one bounded, overlapping chunk pass.
  • Publishes a new timestamped vector collection only after every chunk has been written successfully, so readers never see a half-built collection.
  • Uses the configured TextEmbedding model for both indexing and retrieval and exposes source names in recall results.
  • Provides bounded retry, top-K limits, RAG context length limits, and fail-fast validation for unsupported vector stores.
  • Protects management, import, and recall APIs with the NCF AdminOnly policy.
  • Includes matching migrations for Dm, MySql, Oracle, PostgreSQL, SqlServer, and Sqlite.

Installation

<PackageReference Include="Senparc.Xncf.KnowledgeBase" Version="0.4.0-preview5" />

Key API

  • KnowledgeBaseService.CreateOrUpdateAsync synchronizes metadata, inline content, and selected FileManager files.
  • KnowledgeBaseService.EmbeddingKnowledgeBaseAsync builds and atomically publishes a new vector collection.
  • KnowledgeBaseService.RecallTestAsync and BuildRagContextAsync provide retrieval and bounded context generation.
  • KnowledgeBaseItemAppService supports management-page source/chunk inspection.
  • RecallTestAppService supports administrator retrieval evaluation.

Current boundaries

  • Persistent KnowledgeBase retrieval currently supports Redis and Qdrant. In-memory stores are rejected because they do not survive a request-scoped runner; other vector providers require an AgentKernel adapter before they can be enabled safely.
  • PDF, legacy Office, images, audio, OCR, web crawling, automatic collection cleanup, reranking, and document-level ACL filtering are not implemented.
  • A FileManager source is ingested as a snapshot. Deleting or changing the original file does not silently rewrite an already published knowledge collection; re-import and re-embed explicitly.
  • Vector-store and model credentials remain host configuration. Do not index secrets or restricted documents without a tenant/document permission policy.
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.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Senparc.Xncf.KnowledgeBase:

Package Downloads
Senparc.Xncf.AgentsManager

Agents 管理模块

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.6.0-preview8 0 8/12/2026
0.5.1-preview7 53 8/8/2026
0.5.0-preview6 66 8/3/2026
0.4.0-preview5 55 7/31/2026
0.3.1-preview4 52 7/28/2026
0.3.0-preview3 55 7/26/2026
0.2.3-preview2 173 7/15/2026
0.2.2-preview1 65 7/3/2026
0.2.1-preview1 69 6/17/2026
0.1.11.1-preview 74 5/22/2026
0.1.2-preview 75 6/16/2026

v0.1 创世
[2025-07-27] v0.1.5-preview1s update Knowledge Base
[2025-11-01] update basic libraries, including Senparc.AI
[2025-01-07] v0.1.8-preview.1 Reset all database migrations
[2026-04-24] Simplify FunctionRender request parameters and keep SelectionList UI metadata compatibility
[2026-07-02] v0.2.2-preview1 新增 PromptRange 与 AgentsManager 使用记录能力,升级 Senparc.AI.AgentKernel 并完成兼容性适配
1、新增 PromptRange 与 AgentsManager 使用记录能力
2、升级 Senparc.AI.AgentKernel 并完成兼容性适配
[2026-07-07] v0.2.3-preview2 Dependency updates from upstream modules
1、Dependency update from Senparc.Xncf.AIKernel to 0.13.5-preview4
2、升级 Senparc.AI 至 0.27.3、Senparc.AI.AgentKernel 至 0.1.10
[2026-07-17] v0.3.0-preview3 为 KnowledgeBase 模块接入统一资源本地化并优化功能文案
1、接入统一资源本地化机制,支持模块功能文案按当前文化动态显示
2、更新 FunctionRender 与请求模型文案的资源化解析
3、统一模块注册信息、菜单名称与功能描述的本地化输出
4、同步管理页面与前端交互文案的多语言显示
5、同步 AIKernel 0.14.0-preview5 的 NeuChar 模型 API 版本适配
[2026-07-29] v0.3.1-preview4 通过文件服务读取知识库文件并限制物理路径
1、复用 NcfFileService 读取文件内容,统一文件存储边界校验
2、避免篡改数据库路径字段后直接访问站点外部文件
[2026-07-31] v0.4.0-preview5 扩展 KnowledgeBase 管理界面的多语言能力
1、补齐知识库编辑、检索测试、菜单与交互文案的多语言资源
2、升级 Senparc.AI 组件与 CO2NET WebApi 兼容依赖
[2026-08-04] v0.5.0-preview6 新增知识库生命周期管理与 Agent 模板集成
1、扩展知识库及条目生命周期字段并补齐六类数据库迁移与快照
2、完善知识库管理页、应用服务、召回测试与请求响应模型
3、支持 AgentsManager 按知识库状态完成关联和调用
[2026-08-08] v0.5.1-preview7 Dependency updates from upstream projects
1、Dependency update from Senparc.Ncf.AreaBase to 0.23.2-preview6
2、Dependency update from Senparc.Ncf.DatabasePlant to 0.21.6-preview6
3、Dependency update from Senparc.Ncf.Service to 0.23.6-preview6
4、Dependency update from Senparc.Xncf.AIKernel to 0.15.2-preview9
5、Dependency update from Senparc.Xncf.FileManager to 0.5.1-preview6
6、Dependency update from Senparc.Xncf.AreasBase to 0.13.4-preview6
[2026-08-13] v0.6.0-preview8 完善知识库文件删除保护、召回测试与管理界面
1、增加知识库文件删除边界保护并同步资源服务策略
2、优化知识库列表、召回测试页面及多语言交互反馈
3、适配统一 Agent 执行和文件资源边界变更