Senparc.Xncf.PromptRange 0.20.14

Prefix Reserved
.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
dotnet add package Senparc.Xncf.PromptRange --version 0.20.14
                    


                    

                
NuGet\Install-Package Senparc.Xncf.PromptRange -Version 0.20.14
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.PromptRange" Version="0.20.14" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Senparc.Xncf.PromptRange" Version="0.20.14" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Senparc.Xncf.PromptRange" />
                    


                            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.PromptRange --version 0.20.14
                    


                    

                
#r "nuget: Senparc.Xncf.PromptRange, 0.20.14"
#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.PromptRange@0.20.14
#: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.PromptRange&version=0.20.14
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Senparc.Xncf.PromptRange&version=0.20.14
                    


                            Install as a Cake Tool

Senparc.Xncf.PromptRange

Senparc.Xncf.PromptRange is an NCF module for organizing prompts, model configurations, prompt results, chat history, scoring, and prompt usage insights.

Features

  • Manages prompt ranges, prompt items, model records, and generated results.
  • Supports prompt tree/list operations, import/export, score feedback, chat continuation, and history views.
  • Provides text embedding search request/response models and multimodal execution options for text, images, audio, speech-to-text, and text-to-speech.
  • Emits prompt initialization and optimization events through the companion abstractions package.

Installation

<PackageReference Include="Senparc.Xncf.PromptRange" Version="0.26.0-preview3" />

Key API

  • PromptRangeService/PromptRangeAppService manage prompt ranges and dashboard data.
  • PromptItemService/PromptItemAppService manage prompt trees, versions, import/export, and range-name responses.
  • LlmModelService/LlmModelAppService manage available language-model metadata.
  • PromptResultService/PromptResultAppService manage generated results, robot/human scores, chat continuation, and feedback.
  • PromptTextEmbeddingExecutionOptions, PromptImageController, PromptAudioController, and PromptStreamController expose execution integration points.
  • PromptResult_TextEmbeddingSearchRequest and PromptResult_TextEmbeddingSearchResponse model vector-search calls.

The module records prompts, model usage, scores, and generated output. Apply tenant isolation, data retention, PII redaction, provider quotas, and authorization at the host boundary.

Reusable prompt picker

Admin's shared v-prompt-range directive provides an on-demand picker for text inputs, including both AdminChat composers and the Footer's embedded chat. See the integration guide.

The following GET methods on PromptItemAppService use the existing AdminOnly policy and preserve tenant/soft-delete filters on both ranges and items:

  • GetSelectorOptionsAsync: distinct range/lane metadata for Prompt-kind ranges.
  • SearchSelectorAsync: rangeId (0 = all), exact tactic, keyword (up to 200 characters), pageIndex (1-based), pageSize (1–50, default 10). Returns items and totalCount; each item's content is a preview of at most 240 characters. Searches name, content, range alias and full version. sortBy=score (default) orders by current score descending, with unrated items last and newer IDs breaking ties; sortBy=promptCode orders by the full PromptCode string ascending, with newer IDs breaking ties. Sorting runs before pagination. Items and full-content responses include currentScore (-1 means unrated); evalAvgScore and evalMaxScore remain available for older clients as result statistics. The picker displays the current score to one decimal place and resets to page 1 when sorting changes.
  • GetSelectorPromptAsync(id): fetches full content only for the selected prompt.
  • GetSelectorRangeScoresAsync(id): resolves an accessible PromptCode and returns lightweight ID/code/range/lane/current-score entries for all accessible versions in its range, ordered by PromptCode and ID. It contains no prompt text and is not limited to the picker's current page. Admin's independent score-chart component uses this read-only endpoint, loading content and AI/manual score details only when a bar is clicked. It does not create a range-level rating.

Drafts are labeled and selectable. Selection inserts literal content only; it does not execute prompts/skills, expand variables, copy model settings or send a chat message.

Explicit PromptCode references and shared scoring

IPromptReferenceService (in the abstractions package) validates exact text references and reads/scores a concrete full PromptCode. It does not rate a range or create usage-rating records. Each version keeps its AI and manual source scores; the last successfully saved score wins, regardless of source. FinalScore is only the cached current value, not a third scoring dimension. Existing PromptResult manual/AI scoring also updates that version. New scores must be between 0 and 10 with at most one decimal place.

The reusable rating dialog provides a 0.1-step slider and a live draft bar. Dragging or clicking comparison bars never writes scores or changes the rating target. Saving applies only to the explicitly referenced PromptCode; cancelling discards the manual draft.

Before a version receives its first shared score, its old average result score is used for compatibility; historical result scores have no reliable cross-result rating timestamp. Once rated, that average never overrides the shared current value.

  • GetReferenceInfoAsync(id) returns the full code, source/current scores and benchmark availability.
  • POST ScoreReferenceAsync({ id, score }) saves the shared manual score under the AdminOnly policy.
  • ScoreWithAIAsync(id, context, result) is a server-side provider operation for authorized hosts. It reuses PromptRange's existing benchmark evaluator, requires a nonempty benchmark/result, and limits both context and result to 64,000 characters. Failed evaluation leaves scores unchanged. Hosts must verify ownership and bind context/result to a stored explicit reference before calling.
  • Reference validation requires exact content and version, ordered nonoverlapping UTF-16 spans, and at most 32 references. Tenant/soft-delete filters apply to both the item and its range.

Upgrade the PromptRange and Admin databases before using this integration. Add_PromptCode_Scores and Add_AdminChat_PromptReferences migrations cover SQLite, SQL Server, MySQL, PostgreSQL, Oracle and Dm. They add nullable columns only; old messages remain plain text. Generating these migration files does not apply them to a running database.

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 (4)

Showing the top 4 NuGet packages that depend on Senparc.Xncf.PromptRange:

Package Downloads
Senparc.Xncf.XncfBuilder

Senparc.Xncf.XncfBuilder 快速生成 XNCF 模块基础程序代码
Senparc.Xncf.WeixinManager

NCF 模块：盛派官方发布的微信管理后台 使用此插件可以在 NCF 中快速集成微信公众号、小程序的部分基础管理功能，欢迎大家一起扩展！ 微信 SDK 基于 Senparc.Weixin SDK 开发。
Senparc.Xncf.AgentsManager

Agents 管理模块
Senparc.Xncf.AIAgentsHub

人工智能代理枢纽模块

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.20.14 0 11/5/2026
0.20.12 46 11/4/2026
0.20.9 98 11/2/2026
0.19.9 123 10/10/2026
0.19.8 116 10/4/2026
0.19.7 138 9/18/2026
0.19.6 111 9/16/2026
0.19.5 112 9/15/2026
0.19.4 198 8/29/2026
0.19.3 283 8/23/2026
0.19.3-preview11 169 8/14/2026
0.19.2-preview10 154 8/12/2026
0.19.1-preview9 154 8/8/2026
0.19.0-preview8 169 8/3/2026
0.18.0-preview7 164 7/31/2026
0.17.1-preview6 191 7/28/2026
0.17.0-preview5 181 7/26/2026
0.16.5-preview4 146 7/15/2026
0.16.4-preview3 147 7/5/2026
0.16.2-preview1 148 7/3/2026
Loading failed

[2024-08-06] v0.9.6.0-preview1 update Senparc.AI.Kernel
     [2024-08-29] v0.9.9.0-preview1 更新首页统计
     [2024-08-31] v0.10.0-preview1 PromptRange 支持 Markdown 输出格式展示
     [2024-09-03] v0.10.1-preview1 PromptRange 结果提供“复制”功能
     [2024-09-04] v0.10.2-preview1 PromptRange 完善结果显示样式，添加“复制”功能
     [2024-09-07] v0.10.2.10-preview1 PromptRange 优化输出格式
     [2024-09-07] v0.10.2.11-preview1 PromptRange 修复自动初始化 Prompt 调用过程中的一个 bug
     [2024-09-07] v0.10.3-preview1 更新 Senparc.AI 基础库，并在 XncfBuilder 使用 AI 生成代码时，优先使用已选中的模型。
     [2024-09-08] v0.10.3.1-preview1 优化 XncfBuilder AI 代码生成过程的模型选用
     [2024-09-10] v0.10.4-preview1 升级缓存基础库
     [2024-09-27] v0.10.5-preview1 修复首页的下拉栏过长的问题
     [2024-10-09] v0.10.7-preview1 升级基础库
     [2024-10-16] v0.10.5-preview1 提供 PromptRangeAppService.GetPromptRangeTree() 方法，输出树状
     PromptRange 信息
     [2024-10-16] v0.10.8-preview1 添加 Service 对 PagedList 对象快速 Mapping 到 DTO 对象的方法
     [2024-10-16] v0.10.8-preview1 添加 Service 对 PagedList 对象快速 Mapping 到 DTO 对象的方法
     [2024-11-04] v0.11.0-preview1 重构 PromptRange 界面；大幅提升树状 Prompt 检索性能（约20倍）
     [2024-11-08] v0.11.1-preview1 升级 Senparc.AI
     [2024-11-15] v0.12.0-preview1 使用新版本 AutoGen，升级 AgentsManager；解决 AgentsManager 中状态获取的异常
     [2024-11-15] v0.12.1-preview1 升级备注名称替换功能
     [2024-11-21] v0.13.2-preview1 更新 CO2NET 及缓存基础库
     [2024-11-28] v0.13.3-preview1 update CO2NET, use new SenparcSetting with UseLowerCaseApiName
     property
     [2024-12-27] v0.13.4-preview1 Add exception log for UseXncfModules() auto progress
     [2025-01-25] v0.13.8-preview1 Update Agents functions, support for function calling
     [2025-01-28] v0.13.9-preview1 update Senparc.AI
     [2025-02-06] v0.13.10-preview1 update NeuCharAI model update
     [2025-02-22] v0.13.11-preview1 add DeepSeek-R1 <think> tag style
     [2025-03-21] v0.13.12-preview1 PromptRange's 3D charts are accurate to 1 decimal place
     [2025-04-29] v0.13.14-preview1 Update CO2NET and AIKernel
     [2025-05-18] v0.13.15-preview1 Update Installation
     [2025-06-20] v0.13.16-preview1 Add MCP functions in XncfRegisterBase class
     [2025-08-19] v0.13.17-preview.1 remove debug code in prompt.js
     [2025-11-01] update basic libraries, including Senparc.AI
     [2025-11-06] v0.13.19-preview.1 add AI score standard setting
     [2025-11-06] v0.14.0-preview.1 Support Prompt comparison; Optimize the PromptRange layout and
     provide a scalable layout
     [2025-11-07] v0.14.1-preview.1 Optimize Prompt comparison
     [2025-12-11] v0.14.2-preview.1 Optimize Prompt keyword highlight
     [2025-12-14] v0.15.0-preview.1 PromptRange support Chat mode
     [2025-12-14] v0.15.1-preview.1 Optimize Prompt score 3D chart and conversation mode for Brust Shotting mode
     [2025-12-16] v0.15.2-preview.1 Optimize Prompt score 3D chart
     [2025-12-17] v0.15.3-preview.1 Optimize Prompt score 3D chart, support SystemMessage storage for Chat Shooting mode
     [2026-07-02] v0.16.2-preview1 优化 PromptRange 提示处理流程与会话模式控制，支持流式输出并优化交互体验
     1、优化 PromptRange 提示处理流程与会话模式控制
     2、支持流式输出并优化交互体验
     [2026-07-05] v0.16.3-preview2 增强文生图重试机制并兼容 TLS1.2/TLS1.3，重构系统配置初始化与更新流程并统一模型处理
     1、增强文生图重试机制并兼容 TLS1.2/TLS1.3
     2、重构系统配置初始化与更新流程并统一模型处理
     [2026-07-05] v0.16.4-preview3 增强文生图重试机制并兼容 TLS1.2/TLS1.3，重构系统配置初始化与更新流程并统一模型处理
     1、增强文生图重试机制并兼容 TLS1.2/TLS1.3
     2、重构系统配置初始化与更新流程并统一模型处理
     3、支持 Continue Chat 待确认消息的追加、确认与移除，提升对话状态管理能力
     4、优化 PromptRange 页面间距与响应式布局，改善不同屏高下的展示一致性
     5、新增 Prompt 执行选项模型并补齐文本向量检索请求/响应结构，统一接口参数约定
     [2026-07-07] v0.16.5-preview4 增强 Embedding 请求兼容处理并优化向量检索稳定性
     1、新增 embedding 请求兼容逻辑，针对不支持 dimensions 参数的模型自动降级处理
     2、优化向量集合命名与来源 ID 生成策略，降低并发检索场景下的数据冲突风险
     3、调整嵌入检索卡片样式，避免右侧浮层遮挡操作按钮
     4、升级 Senparc.AI 至 0.27.3、Senparc.AI.AgentKernel 至 0.1.10
     [2026-07-17] v0.17.0-preview5 为 PromptRange 模块接入统一资源本地化并优化功能文案
     1、接入统一资源本地化机制，支持模块功能文案按当前文化动态显示
     2、更新 FunctionRender 与请求模型文案的资源化解析
     3、统一模块注册信息、菜单名称与功能描述的本地化输出
     4、同步管理页面与前端交互文案的多语言显示
     5、统一提示词页面复制工具和剪贴板回退，改善内嵌 WebView 兼容性
     [2026-07-29] v0.17.1-preview6 加强提示词接口授权并防护插件压缩包路径
     1、为提示词、音频、图片和流式接口统一增加 AdminOnly 授权保护
     2、限制插件压缩包大小、条目数、解压体积和路径穿越，并安全渲染结果内容
     [2026-07-31] v0.18.0-preview7 扩展 PromptRange 管理界面的多语言能力
     1、补齐提示词、模型、菜单、复制与日期显示的多语言资源
     2、升级 Senparc.AI 组件版本以适配 CO2NET 4.2.0
     [2026-08-04] v0.19.0-preview8 完善 PromptRange 管理页多语言体验
     1、为 Prompt、Model 与 Index 页面接入统一本地化脚本
     2、补充中文、英文、日文、法文、西班牙文与俄文资源
     [2026-08-08] v0.19.1-preview9 Dependency updates from upstream projects
     1、Dependency update from Senparc.Ncf.AreaBase to 0.23.2-preview6
     2、Dependency update from Senparc.Ncf.XncfBase to 0.24.1-preview6
     3、Dependency update from Senparc.Xncf.AIKernel to 0.15.2-preview9
     4、Dependency update from Senparc.Xncf.AreasBase to 0.13.4-preview6
     5、Dependency update from Senparc.Xncf.SystemCore to 0.14.4-preview6
     6、Dependency update from Senparc.Xncf.SystemManager to 0.15.4-preview7
     7、Dependency update from Senparc.Xncf.Tenant to 0.15.4-preview6
     8、Dependency update from Senparc.Xncf.PromptRange.Abstractions to 0.2.4-preview4
     [2026-08-13] v0.19.2-preview10 Dependency update from Senparc.Ncf.AreaBase to 0.23.3-preview7; Senparc.Ncf.XncfBase to 0.25.0-preview7; Senparc.Xncf.AIKernel to 0.15.3-preview10
     [2026-08-15] v0.19.3 Dependency update from Senparc.Xncf.AIKernel to 0.15.3-preview12
     1、改进流式输出文本提取，兼容更多 Agent 响应增量字段
     2、为 Ollama 低 Token 场景补充最小 thinking token 预算，降低流式调用失败率
     3、Dependency update from Senparc.Xncf.AIKernel to 0.15.4
     4、补充流式输出字段提取和低 Token 场景处理，降低 Ollama 调用结果为空的概率
     [2026-08-29] v0.19.4 Dependency updates from Senparc.Ncf.XncfBase to 0.26.1
     1、Dependency update from Senparc.Ncf.XncfBase to 0.26.1
     [2026-09-15] v0.19.5 适配共享 AI 依赖与 Harness 版本
     1、同步 AgentKernel 及 Microsoft Agents AI Harness 依赖
     2、保持 PromptRange 宿主集成与模型调用兼容
     [2026-09-16] v0.19.6 Dependency updates from Senparc.IntegrationSample to 0.0.13; Senparc.Xncf.AIAgentsHub to 0.13.9; Senparc.Xncf.AgentsManager to 0.17.2; Senparc.Xncf.AgentsManagerTests to 0.0.15; Senparc.Xncf.WeixinManager to 0.24.7; Senparc.Web to 0.39.1
     [2026-09-17] v0.19.7 适配共享 AgentKernel 预览依赖版本
     1、同步 Senparc.AI.AgentKernel 至 0.1.14-preview5
     2、保持 PromptRange 工具调用与模型集成兼容
     [2026-10-05] v0.19.8 Merge remote-tracking branch 'origin/Developer-MAF-V3' into Developer-MAF-V3-Spark
     1、Updated Senparc.Xncf.PromptRange project behavior and integration for the latest feature and reliability improvements.
     2、chore: update package versions and dependencies across multiple projects
     [2026-10-09] v0.19.9 Dependency update from Senparc.Xncf.AIKernel to 0.16.4
     v0.1.0 创世
     v0.2.0 完成数据库和基本测试功能
     v0.2.0.1024 升级至 1024 特别版，支持 SK v1.0.0-beta3（2023.10.24发布）
     v0.2.1 重构当前解决方案 XNCF 模块自动获取的方法到 Senparc.Xncf.XncfBase 项目中，位于 FunctionHelper.LoadXncfProjects()
     v0.3.0 重构 PromptRange 数据库和逻辑
     v0.3.10 引用 Senparc.Xncf.AIKernel
     v0.4.0 完成 PromptRange 基本功能
     v0.4.2 优化 PromptRange 模糊查询
     v0.4.7 支持手动打分精确到小数点后 1 位
     v0.4.11 添加 PromptResultService.GetPromptConfigParameterFromAiSetting() 方法
     v0.6.4 更新 Prompt 导入和导出 #207
     v0.6.5 优化通过 PromptRangeCode 查询
     [2026-10-21] v0.20.0 支持 Skill 类型、执行策略与隔离测试
     [2026-10-21] v0.20.1 generate PromptRange SkillKind migrations with dotnet ef
     1、Prompt 可标记为 Prompt 或 Skill，并携带执行策略
     2、新增 Skill 隔离测试运行器与管理端 Skill 页面
     3、执行请求可附带策略，并适配 Senparc.AI.AgentKernel 0.1.15-preview2
     [2026-10-21] v0.20.2 upgrade Skill management with GitHub folder import, AI Draft generation, version tree preview, and safer content inspection
     [2026-10-22] v0.20.3 persist Skill package artifacts through FileManager and add source metadata to PromptRange
     [2026-11-02] Fix Memory default prompt note length and support scoped, evidence-based incremental extraction.
     [2026-11-02] Add the AdminChat.Memory system prompt provider with published-version score selection.
     [2026-11-02] Return prompt scores and support server-side average-score and PromptCode sorting in the reusable selector.
     [2026-11-02] Add authorized prompt selector APIs for range/lane options, paginated keyword search and on-demand prompt content.
     [2026-11-03] Recognize durable reply preferences and safely refresh unchanged, unscored Memory defaults without replacing customized or scored prompts.
     [2026-11-03] v0.20.8 支持 Skill 管理、包上传和来源文件关联，并补齐多数据库迁移
     1、提供 PromptRange 选择与评分信息，支持聊天记忆提示词
   [2026-11-03] Add shared contextual documentation beside prompt range selection.
   [2026-11-04] Extend default Memory extraction to ordinary facts and explicit context references requiring review; migrate untouched prior defaults without replacing customized or scored prompts.
   [2026-11-04] Add explicit PromptCode references, shared last-successful AI/manual scoring, current-score selection and six-provider migrations.
   [2026-11-04] Add Memory intent classification and structured update/defer/none output; upgrade untouched context-extraction defaults while preserving custom prompts.
   [2026-11-05] Support short contextual Memory save commands and evidence-based review rules; upgrade untouched intent prompts without overwriting custom or scored versions.
   [2026-11-05] Expose authorized lightweight Range score overviews for all PromptCode versions without loading prompt content.
   [2026-11-05] v0.20.14 完善 PromptCode 评分、记忆保存规则与多语言文案
   1、提供 PromptCode 引用、共享评分、轻量分数总览和只读预览
   2、支持带证据审核的短上下文记忆保存，并避免覆盖已自定义或已评分提示词
   3、补齐并校正各语言资源条目，使模块界面文案与中文基准保持一致
   4、Dependency update from Senparc.Ncf.AreaBase to 0.23.10
   5、Dependency update from Senparc.Ncf.XncfBase to 0.28.2
   6、Dependency update from Senparc.Xncf.AIKernel to 0.17.2
   7、Dependency update from Senparc.Xncf.AreasBase to 0.13.12
   8、Dependency update from Senparc.Xncf.SystemCore to 0.14.12
   9、Dependency update from Senparc.Xncf.SystemManager to 0.15.12
   10、Dependency update from Senparc.Xncf.Tenant to 0.15.15
   11、Dependency update from Senparc.Xncf.PromptRange.Abstractions to 0.3.2-preview6