Senparc.Xncf.DesktopBridge 0.1.1-preview3

Prefix Reserved
.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
This is a prerelease version of Senparc.Xncf.DesktopBridge. 
dotnet add package Senparc.Xncf.DesktopBridge --version 0.1.1-preview3
                    


                    

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


                            Directory.Packages.props
                        

                    

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


                            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.DesktopBridge --version 0.1.1-preview3
                    


                    

                
#r "nuget: Senparc.Xncf.DesktopBridge, 0.1.1-preview3"
#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.DesktopBridge@0.1.1-preview3
#: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.DesktopBridge&version=0.1.1-preview3&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Senparc.Xncf.DesktopBridge&version=0.1.1-preview3&prerelease
                    


                            Install as a Cake Tool

Senparc.Xncf.DesktopBridge

DesktopBridge 是 NCF 桌面助手的可选 XNCF 模块。它通过逆变事件处理器的闭合服务映射旁路观察 EventBus 中的集成事件，并通过仅限本机会话令牌访问的 HTTP/SSE 接口，把当前活动安全地发送给桌面 GUI。

  • 不读取或修改业务 MemoryCache。
  • 不替代原有 EventBus 消费者，也不改变事件处理顺序。
  • 仅当桌面应用通过 NCF_DESKTOP_BRIDGE_TOKEN 启动站点时启用接口。
  • 未安装或未启用本模块时，NCF 本身仍可正常运行，GUI 自动降级为进程/日志兼容模式。

受权同步

authorized-sync/events 用于 Admin Chat 等需要登录身份的资源同步，并同时要求：

  • 桌面会话头 X-Ncf-Desktop-Token；
  • Bearer_Backend JWT；
  • AdminOnly 授权策略；
  • 事件的 OwnerId 与当前 JWT 的管理员 ID 一致。

EventBus 和 SSE 只传输频道、资源 ID 与变更类型，不传输密码、JWT 或聊天正文。桌面端收到通知后，使用同一管理员 JWT 从原业务 API 重新读取数据；未登录、非管理员、令牌过期或 Bridge 断开时，快捷聊天保持禁用。

模块安装或更新后需要重启 NCF 站点。

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

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.1.1-preview3 33 7/28/2026
0.1.0-preview2 43 7/27/2026

[2026-07-25] v0.1.0-preview1 新增 NCF 桌面状态桥接能力
     1、使用逆变事件处理器的闭合服务映射旁路观察 EventBus，不改变原事件消费行为
     2、避免开放泛型实现被 NCF 扫描为无效 DI 描述符，确保站点容器可正常构建
     3、提供带会话令牌保护的能力探测、活动快照和 SSE 实时事件接口
     4、在未由桌面应用启动时默认关闭桥接接口，避免暴露进程内状态
     [2026-07-26] v0.1.0-preview2 新增受管理员身份隔离的资源同步通知
     1、仅同步资源标识和变更类型，不通过 EventBus 或 SSE 传输聊天正文、密码或令牌
     2、同步流同时要求桌面会话令牌、Bearer_Backend JWT 和 AdminOnly 策略
     3、按管理员账号隔离通知，为桌面 Admin Chat 和后续受权模块提供通用扩展点
     [2026-07-29] v0.1.1-preview3 复用 NCF 标准 AdminOnly 策略名称
     1、桌面桥接控制器改用 Core 统一授权策略常量，避免策略字符串漂移