日志

2026-09-20更新

NcfPackageSources（Developer-MAF-V3-Spark 分支）——多租户模块完整升级 + AdminChat 按账号隔离：

1、XNCF 数据库多租户引擎（Senparc.Ncf.XncfBase）：XncfDatabaseDbContext 的全局查询过滤器与 SenparcEntitiesDbContextBase 对齐——开启多租户（SenparcCoreSetting:EnableMultiTenant: true）后，所有实现 IMultiTenancy 且未实现 IIgnoreMulitTenant 的实体自动追加 TenantId == 当前请求租户Id 过滤（与软删除过滤叠加）；SaveChanges/SaveChangesAsync 自动为新增实体写入当前 TenantId。租户注册表 TenantInfo 等全局实体通过 IIgnoreMulitTenant 豁免（TenantInfos 表按设计不存储 TenantId 列，模型以 [NotMapped] 遮蔽基类属性，升级中修复了该遮蔽被误删导致 EF 映射不存在列的缺陷）。单租户模式（默认）行为与旧版本完全一致。

2、登录链路的租户解析：Web（Cookie）登录页在开启多租户时支持输入租户（TenantKey），先解析租户并设置租户上下文再查询账号；JWT（桌面/后端 API）登录 LoginAsync 同步补齐——按 TenantKey 入参先解析租户、设置租户上下文、再将 TenantKey 写入 JWT Claim（此前查询发生在租户解析之前，LoginInput 规则下会查不到该租户的账号）。租户不存在/停用时返回与“账号或密码错误”一致的提示，避免租户枚举。

3、租户管理页升级（/Admin/TenantInfo）：新增「管理员数」列（每个租户下的管理员账号数量，辅助决策）；新增受保护的删除接口 OnPostDeleteAsync，内置三级校验——不能删除当前正在使用的租户、必须保留至少一个启用租户、租户下仍有管理员账号时禁止删除（防孤儿账号），失败时返回本地化的具体原因。

4、AdminChat 按账号隔离：会话/消息的列表、详情、发送、归档、删除、反馈与 Harness Trajectory 全部接口均按登录管理员做归属校验，跨账号访问返回“会话不存在或无权限”；消息反馈接口增加防御性归属校验。超级管理员（administrator 角色）在 AdminChat 页面新增「用量统计」面板：展示各账号会话（总数/活跃/归档/删除）、消息数与最后活跃时间，仅数量、不含任何内容；多租户开启时统计同样受租户过滤器约束。

单元测试：新增 AdminChatAccountIsolationTests（跨账号会话/消息越权拒绝、按用户统计口径、超级管理员角色判定），Admin 测试工程 166 个用例全部通过。

详见配置多租户。

NcfPackageSources（Developer-MAF-V3-Spark 分支）——Sandbox v0.3.3：JupyterLab 外部控制、可选容器端口映射与会话别名：

1、JupyterLab 外部控制：模块现具备完整的外部操作接口。新增可被 AI 调用的「创建 Notebook」（LabCreateNotebook）Function：在运行中的 Lab 工作区写入 nbformat-4 的 .ipynb 文件，支持 Python 与 C#（dotnet-interactive，内核 C# .NET SDK）；Notebook 源码遵循 Jupyter 百分号文件约定（# %% 分隔代码单元格、# %% [markdown] 标记 Markdown 单元格；可选标题生成首个 Markdown 标题单元格），单个字符串即可完整描述 Notebook。「执行 Lab 命令」Function 新增可选 StdinContent 参数（最多 32 KB），经 docker exec -i 执行，可向容器内终端程序 / REPL 批量提交指令。

2、创建容器时可选的附加端口映射：创建 JupyterLab 沙箱（jupyter-python / jupyter-csharp）时可传入可选 ExtraPortMappings 字符串（最多 8 条，; 或 , 分隔）。格式：3000 —— 自动分配 loopback 宿主端口到容器 3000 端口；9000:3000 —— 指定 loopback 宿主端口；*:3000 —— 自动分配绑定 0.0.0.0 的宿主端口（外部可访问）；*:9000:3000 —— 指定 0.0.0.0 宿主端口。默认仅绑定 loopback，0.0.0.0 外部暴露为显式可选，用于暴露容器内运行的 Web 站点。非法条目、超范围端口与重复宿主端口在创建时即被拒绝；NCF 预览工作负载不受影响，保持加固状态。

3、会话别名：每个沙箱会话支持可选显示别名（≤ 128 字符），创建时通过 Alias 参数设置，之后可随时经新增「修改别名」（UpdateAlias）Function 修改或清除。管理端会话列表新增别名与附加端口两列，并支持行内重命名对话框。

4、配额提升：每用户并发会话上限由 2 提高到 10，全局并发上限由 20 提高到 50。

持久化：SandboxSession.Alias / SandboxSession.ExtraPorts 两个新的可空列随六个提供方（Sqlite / SqlServer / MySql / Dm / Oracle / PostgreSQL）的迁移加入。两个字段均不随容器销毁清除、运行时永不自动清空，仅手动重命名/清除会变更。单元测试同步扩展（端口映射解析、Notebook 构建、配额策略、别名规范化；共 52 个用例通过）。

完整模块清单见 NCF 核心能力详解，升级注意事项见版本升级说明。

2026-09-18更新

NcfPackageSources（Developer-MAF-V3-Spark 分支）——Function 全局 Provit 访问控制：覆盖代码属性的数据库策略：

1、数据库访问策略（Senparc.Areas.Admin）：Function 的全局 Provit（跨模块浮动调用）访问此前仅在代码中约束（FunctionRenderAttribute 的 AllowGlobalPivot / GlobalPivotRoleCodes / GlobalPivotPermissionCodes）。现可为每个 Function 在新表 ADMIN_NeuCharFunctionProvitAccess（ModuleUid + FunctionKey 唯一）中维护策略，采用 Ontology 风格的「主体–资源–效果」三元组：资源为稳定键 (ModuleUid, FunctionKey)；主体为后台管理员用户、角色码与/或权限码（任一命中即放行）；效果为继承 / 开放 / 受限 / 禁用四态之一。非“继承”策略双向覆盖代码属性——可让代码未声明全局的 Function 出现在全局 Provit，也可禁用代码允许的 Function；“继承”或策略不存在时回退代码基线。

2、缓存 + 模块清除韧性：全部策略行由 FullNeuCharFunctionProvitAccessCache 缓存在内存（CO2NET 缓存策略，与 FullSystemConfigCache 同范式），每次写入即失效；数据库异常时优雅降级为代码基线，全局 Provit 不受影响。策略行不随 XNCF 模块清除而删除——模块被清除后以“孤儿策略”形式冗余保留，模块重装后自动继续生效；仅管理页的手动清除才会删除。

3、访问控制管理页：NeuCharPivot 菜单下新增页面（/Admin/NeuCharPivot/Access，仅超级管理员），为每个 Function 完整展示决策上下文——模块标识/版本/可用状态、代码基线、当前数据库策略与最终生效策略（含来源：数据库或代码）——以及模块已清除的孤儿策略。支持单条编辑（策略模式、用户/角色/权限选择器、备注）与对选中行的批量操作：批量应用开放 / 受限 / 禁用 / 继承，或批量清除。数据库迁移已同步六个提供方（Sqlite / SqlServer / MySql / Dm / Oracle / PostgreSQL）；单元测试同步扩展（覆盖语义、受限主体匹配、孤儿保留、绑定规范化）。

完整模块清单见 NCF 核心能力详解，升级注意事项见版本升级说明。

2026-09-14更新

NcfPackageSources（Developer-MAF-V3-Spark 分支）——NeuBell WebHook v3：请求方式、请求体模板与占位符：

1、请求方式：每个 WebHook 端点支持 GET / POST / PUT（默认 POST）。GET 不发送请求体（数据经地址占位符传递）也不携带签名；HMAC-SHA256 签名（X-NeuBell-Signature）始终覆盖实际发出的请求体字节。创建函数（「纽铃可见提醒测试」）新增可选参数 WebHookMethod。

2、请求体模板 + 占位符：每个端点可配置可选的请求体模板，使用 {{token}} 占位符（与 Workflow 文本模板同格式）。模板（去首尾空白后）以 { 或 [ 开头时按 JSON 处理（字符串占位符自动 JSON 转义，{{payload}} 原样嵌入为 JSON 片段，Content-Type: application/json）；否则按纯文本发送。WebHook 地址本身也可包含占位符——替换值自动 URL 编码，且发送前对渲染后的真实地址再次严格校验（渲染后不合法的地址只记失败日志、不发起 HTTP 请求）。可用占位符：{{kind}} {{provider}} {{providerName}} {{time}} {{payload}}，条目占位符 {{id}} {{title}} {{summary}} {{link}} {{status}} {{count}} {{updated}}，变更占位符 {{addedCount}} {{removedCount}} {{addedTitles}} {{removedTitles}}；未知占位符替换为空字符串。配置 NeuBellWebHook:BaseUrl（appsettings 可选）可让 {{link}} 输出绝对链接。

3、请求日志新增记录实际请求方式与渲染后的真实地址/报文；管理页设置表格与请求日志新增「方式」列，设置表单新增请求方式选择、请求体模板编辑器与内置占位符说明。同时修复一个隐性缺陷：变更通知成功后日志曾被错误地标记为“请求未完成”。数据库迁移已同步六个提供方（Sqlite / SqlServer / MySql / Dm / Oracle / PostgreSQL），单元测试同步扩展（渲染器行为、GET 语义、模板地址、渲染后二次校验、日志状态）。

完整模块清单见 NCF 核心能力详解，升级注意事项见版本升级说明。

2026-09-13更新

NcfPackageSources（Developer-MAF-V3-Spark 分支）——NeuCharWorkflow（v0.4.0）：Chat 触发器 + Chat 消息持久化：

1、Chat 触发器：工作流设计器中选择“Chat 触发”后，工作流获得一个可直接分享的聊天页面 URL。打开该页面即可像聊天一样逐条发送消息，每条消息都会作为输入启动一次工作流运行（完全由服务端运行协调器执行，浏览器端不参与运行）。支持登录用户（Claims 身份）与未登录访客（32 字节随机令牌写入 HttpOnly Cookie，访客开关可在设置中关闭）；同一工作流下两种身份互不混用。页面为自包含 HTML：消息气泡、运行中的节点状态提示与“新对话”重置按钮；管理端设计器同步新增 Chat 配置（标题、欢迎语、访客开关）与“聊天页面”入口。

2、Chat 消息持久化：聊天历史落库到新表 NEUCHAR_WORKFLOW_NeuCharWorkflowChatMessage（每会话保留最近 200 条；数据库只保存参与者标识的 SHA256 摘要，原始访客令牌不落库）。主机重启后打开页面自动从数据库恢复历史（类似 n8n 的按数据库重建方式）；历史保留 30 天，宿主服务每日清理过期数据；会话重置时内存与数据库一并清空；工作流删除时其全部聊天历史随之删除。消息内容上限 8000 字符。数据库迁移已同步 Sqlite / SqlServer / MySql / PostgreSQL / Oracle / Dm 六个提供方（Oracle 的 Chat 内容列使用 NCLOB；回放 JSON 列沿用原迁移保持 CLOB，避免收缩列类型）。

完整模块清单见 NCF 核心能力详解，升级注意事项见版本升级说明。

2026-09-11更新

NcfPackageSources（Developer-MAF-V3-Spark 分支）——NeuBell WebHook v2：创建时按参数通知 + 请求数据与结果全量留痕：

1、创建 NeuBell 时按调用触发 WebHook（Senparc.Areas.Admin）：FunctionRender「纽铃可见提醒测试」（send 动作）新增可选参数 WebHookUrl。填写后，创建该条纽铃时会立即向该地址以异步方式（fire-and-forget，不阻塞 Function 响应）POST 一条 kind=item-created 事件；地址留空则不触发。无效地址不会发起 HTTP 请求，但会落一条失败日志便于排查。

2、WebHook 请求日志：每一次出站 WebHook 请求（item-created / items-changed / test）的完整请求报文与结果均记录到新表 ADMIN_NeuBellWebHookLog（状态 sending → success/failed、HTTP 状态码、耗时毫秒、触发管理员 Id）。NeuBell 管理页新增「请求日志」列表：查看报文（JSON 美化展示）、按条删除、批量清空（保留最近 50 条）。日志写入失败仅记警告，绝不影响通知本身。数据库迁移已同步 Sqlite / SqlServer / MySql / Dm / Oracle / PostgreSQL 六个提供方。

完整模块清单见 NCF 核心能力详解，升级注意事项见版本升级说明。

2026-09-06更新

NcfPackageSources（Developer-MAF-V3 分支）——后台体验、AIKernel 可观测性、站点防护与 NeuBell WebHook 通知：

1、NeuBell WebHook（WebAPI）通知设置（Senparc.Areas.Admin）：管理员可为纽铃（NeuBell）添加 WebHook 通知端点，按 Provider 过滤（留空为全部 Provider）。当任一纽铃 Provider 的条目发生新增（added）或移除（removed）时，系统以异步方式（fire-and-forget，SemaphoreSlim(4) 限制并发出站）POST 通知，不阻塞业务请求与 Footer 刷新。每条设置支持：新增/移除分别开关、启用开关、可选 HMAC-SHA256 签名密钥（请求携带 X-NeuBell-Signature: t=<unix>,v1=<hex>，v1 = HMAC-SHA256(secret, t + "." + body)）；管理页"测试"按钮发送 kind=test 事件验证连通性。数据表 ADMIN_NeuBellWebHook（Sqlite / SqlServer / MySql / Dm / Oracle / PostgreSQL 六库迁移已同步）；后台 IHostedService 监测循环（NeuBellWebHook:PollingIntervalSeconds 配置轮询间隔，默认 30 秒、最小 5 秒，并订阅纽铃变更事件提前唤醒）按 Provider 基线做差异对比：首次观测只建基线避免重启误报，Provider 本轮缺席但仍在开放列表（快照获取失败）时保留基线，模块被关闭才将存量条目按"移除"通知。管理入口：页脚"纽铃"抽屉 → "WebHook 设置"（/Admin/NeuBell/Index，仅超级管理员）。

2、AIKernel：Token 用量监测——实时聚合 + 按运行异步进度；AI 模型列表页直接展示用量。

3、后台菜单：左侧菜单新增搜索过滤；菜单"配置模式"支持拖拽调整一级菜单（如 XNCF）顺序，保存后真实更新存储的 Sort 数值。

4、Provits（NeuCharPivot）：支持逐个创建 Provit，支持通过 AI Chat 创建或修改；可创建"Provit Panel"面板并绑定到特定页面（如后台首页 admin-home），面板组合来自任意 XNCF 模块的 Provit Block，支持拖拽排序与 AI 辅助编辑块。

5、Admin Chat：新增可选的"长任务（Harness）"模式，基于 Microsoft Agent Framework（MAF）多步骤自主执行——步数预算、超时控制、[[DONE]] 完成标记识别，执行步骤返回前端展示；默认仍为普通对话模式。

6、站点防护：Senparc.Web 新增 CloudflareProtect SystemConfig 配置节（默认关闭）。开启后，自用户打开网站（首个请求）起立即生效固定窗口限流与安全响应头。

完整模块清单见 NCF 核心能力详解，升级注意事项见版本升级说明。

2026-08-30更新

NcfPackageSources（Developer-MAF-V3 分支）各 XNCF 模块功能文档同步更新，主要内容：

1、NeuCharWorkflow（0.1.0-preview1，XncfOrder 5890）：服务端工作流编排能力成体系——可视化设计器与布局管理、版本管理与自动保存、运行回放（事件/快照持久化、加载更多事件）、Webhook 触发、并行节点（并发执行下游分支）、Human Input 人工输入节点（外部恢复 resume）、NeuBell 通知消费、Workflow 分析（Analytics）页面；模板表达式绑定与校验、观测输出 Schema；全局 NeuCharPivot 悬浮调用（AllowGlobalPivot 特性控制角色级访问）。

2、AgentsManager（0.3.22）：A2A（Agent-to-Agent）远程智能体支持——远程智能体接入/发布管理、ChatGroup 上下文共享（可配置）、AgentTemplateRunner 统一本地与 A2A 智能体执行、已发布 A2A 智能体手动 Prompt 执行与部署模型回退机制；AgentModelRequestDiagnostics 模型请求诊断（敏感数据脱敏）；线程管理引入取消令牌实现优雅停机。

3、新增模块：

Senparc.Xncf.Sandbox（0.1.0-preview1）：独立沙箱编排，Docker/Wasm 快速创建/销毁隔离实验环境，支持配额/TTL、JupyterLab、csharp-exec（.NET 10）、持久化 Lab 工作区文件上传/下载，与 XncfBuilder Preview Host 解耦。
Senparc.Xncf.DesktopBridge（0.2.1-preview2）：为 NCF 桌面伴侣应用提供受保护的 HTTP/SSE 桥接：能力发现、活动快照、授权资源变更同步流、一次性 PKCE 会话交接；以 NCF_DESKTOP_BRIDGE_TOKEN 作为启动安全边界。
Senparc.Xncf.Dapr（0.0.1）：Dapr 客户端抽象，提供服务调用（GET/POST/PUT/PATCH/DELETE）、Pub/Sub 发布、状态读写删除、健康检查与序列化抽象。
新增一批 Abstractions 契约包：AIKernel.Abstractions、AgentsManager.Abstractions（0.3.0）、NeuCharWorkflow.Abstractions（0.2.0）、PromptRange.Abstractions（0.2.5-preview5）、Sandbox.Abstractions（0.2.0）、MCP.Abstractions，用于跨模块契约与集成事件抽象。

4、FirmwareUpdate 扩展为 NCF Host 与 NCF Desktop 双安装包镜像（wwwroot/NcfPackages/host 与 /desktop），提供独立下载清单、下载源选择（自动/本地/GitHub）与 MD5 指纹展示。

5、其他：SystemManager 1.1.3、XncfBuilder 0.10.3（Preview Host 进程级模块预览）、FileManager 0.6.0；PromptRange 新增 API 文档 XML（ApiDocXML）。

详细模块清单见 NCF 核心能力详解，升级注意事项见版本升级说明。

2026-08-29更新

NcfPackageSources（Developer-MAF-V3 分支）发布更新，主要内容：

1、AgentsManager 支持 Human-in-the-Loop（人工介入）：任务可配置人工审批、最大对话轮次与工具权限；新增独立 AgentExecutionTask 管理、AgentTemplate 模型绑定与空输出 token 重试，Agent 编辑器支持新窗口打开。

2、NeuCharWorkflow 新增全局 NeuCharPivot 悬浮调用（AllowGlobalPivot 特性控制访问权限）、Workflow 分析页面（按日期 / 工作流 / 状态筛选并生成摘要）、Human Input 人工输入节点（用户输入提示与外部恢复）；时间戳统一为 DateTimeOffset，AbortRun 支持按执行日志 ID 中止，回放支持加载更多事件。

3、稳定性与诊断：新增 AgentModelRequestDiagnostics 模型请求诊断（敏感数据自动脱敏），表达式引擎 JSON 序列化完整保留非 ASCII 字符，ChatGroupService 独立 scope 执行并优化 token 逻辑。

4、版本更新：XncfBuilder 模板 1.1.7、Senparc.Ncf.Database 0.21.8-preview8；下载页支持选择下载源（自动 / 本地 / GitHub）并展示 MD5 指纹；NCF Desktop 更新至 0.10.1-build10066。

详细升级说明见 NcfPackageSources 版本升级说明。

2025-05-04更新

1、添加租户（还没做名称唯一性判断）

2、初始化租户（还没做重复生成判断）：

3、完成后可获得新租户的默认管理员账号密码，从登录页面输入即可登录：

注意： 1、appsettings.json 有变化，需要设置："TenantRule": "LoginInput" （之前为 DomainName） 2、已经安装完的系统，需要在 Senparc.Web/App_Data 目录下，新建一个文件：install_finished.txt（内容无所谓）

Senparc.AI v0.1.4-beta1 新版本发布
添加对话聊天、Embedding  Sample
后续将开始接入 Senparc.Weixin SDK，敬请关注！
开源地址：https://github.com/Senparc/Senparc.AI

Sample 使用介绍：
https://github.com/Senparc/Senparc.AI#%E5%91%BD%E4%BB%A4%E8%A1%8C%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E

2023-03-10更新

ChatGPT + Dall·E + 盛派微信 SDK +NeuCharFramework，实现模块化架构基础上的微信机器人（群）方案，将会全部开源，即插即用。

2023-03-06更新

Senparc.Xncf.OpenAI 模块最新版本已经发布：https://www.nuget.org/packages/Senparc.Xncf.OpenAI/0.1.4-beta1

加载到 NCF 项目后，可以通过 Swagger 测试接口（本地测试建议使用源码，去掉Jwt锁），接下来将发布基于微信对话的 Demo，完全开源，请关注开源项目：

Xncf.OpenAI模块：https://github.com/NeuCharFramework/Senparc.Xncf.OpenAI

微信SDK：https://github.com/JeffreySu/WeiXinMPSDK

2021-08-01更新

1.更新发布xncf包到nuget
2.增加配置
3.增加配置数据库
4.增加配置多租户
5.更新名词解释
6.增加配置Redis
7.完善指定数据库
8.完善更新基础库
9.完善Xncf 中实现自己的业务逻辑
10.完善进阶开发

2021-07-20更新

1.更新多数据库支持
2.更新多数据库切换
3.更新多数据库原理
4.更新日志
5.更新常见问题

2020-09-20更新

NCF已经发布新的beta5，本次更新了底层的数据库、重构了数据库同步的方法、更新了文档模块，如果新项目建议用新的模板，老项目可以手动更新数据库，步骤：
1、更新最新NCF项目代码
2、将 `Senparc.Service` 项目设为启动项目
3、在 【程序包管理器控制台】选中 `Senparc.Service` ，然后输入：`update-database  -Context SenparcEntities` 回车
4、完成。无需其他操作。

日志

2026-09-20更新

2026-09-18更新

2026-09-14更新

2026-09-13更新

2026-09-11更新

2026-09-06更新

2026-08-30更新

2026-08-29更新

2025-05-04更新

2025-01-31更新

2025-01-24更新

2025-01-22更新

2025-01-09更新

2024-12-27更新

2024-12-23更新

2024-12-21更新

2024-12-19更新

2024-12-08更新

2024-11-17更新

2024-11-15更新

2023-04-21更新

2023-03-10更新

2023-03-06更新

2021-08-01更新

2021-07-20更新

2020-09-20更新