跳到主要内容

v5.0.0-beta.6​

更新日期: 2026.11.12

更新描述:

  • 新增统一等待响应客户端
  • 移除旧接收器接口 ⚠️ 破坏性变更
  • 修复连接关闭与重连阻塞
  • 调整 DMTP 连接与通道行为
  • 修复 DMTP RPC 取消阻塞
  • 新增 MQTT 保留消息支持
  • 修复 HSMS 请求应答匹配
  • 修复 Socket.IO 握手与确认
  • 修复流量限制与静态文件缓存

更新详情:

TouchSocket.Core​

  •   FlowGate.AddCheckWait 与 AddCheckWaitAsync 在同一统计周期内持续超出流量上限时正确等待,修复等待时间计算溢出及不足一毫秒时限流失效的问题。

TouchSocket​

  •   IWaitingResponseClient、WaitingTcpClient、WaitingTcpSessionClient、WaitingTcpService 与 WaitingUdpSession,支持通过 SendThenResponseAsync 发送字节数据或 IRequestInfo 并等待响应。
  •   WaitingResponseClientExtension 提供毫秒超时与 UTF-8 字符串发送重载;超时抛出 TimeoutException,调用方取消时抛出 OperationCanceledException,响应 ResponsedData 使用后需释放。
  •   新等待客户端按客户端串行处理并发请求,使用 WaitingOptions 筛选响应;匹配的数据作为响应返回,不再触发接收事件与插件,不匹配的数据继续进入正常接收流程。UDP 设置 RemoteIPHost 时只匹配该地址的响应,连接断开或 UDP 停止时结束当前等待。
  •   TCP 客户端与会话在接收、连接或关闭回调中调用关闭、重连时的相互等待问题,并在连接结束后再释放连接资源。
  •   TCP 关闭前等待已写入的数据完成发送,支持收到远端 FIN 后继续处理剩余请求并发送响应;并发关闭时保留最先记录的关闭原因,保持关闭事件信息一致。
  •   IReceiver<TResult>、IReceiverClient<TResult>、IReceiverResult、IUdpReceiverResult,以及客户端和会话的 CreateReceiver、ClearReceiver 与对应受保护方法。⚠️ 破坏性变更
  •   IWaitingClient<TClient, TResult>、CreateWaitingClient 及旧等待客户端扩展重载。原发送后等待响应的用法需迁移到对应 Waiting* 类型及 SendThenResponseAsync,自定义接收流程可通过接收事件或插件处理。⚠️ 破坏性变更

TouchSocket.NamedPipe​

  •   WaitingNamedPipeClient、WaitingNamedPipeSessionClient 与 WaitingNamedPipeService,支持命名管道客户端及服务端会话发送后等待响应,响应过滤与并发排队规则与 TCP 一致。
  •   命名管道回调中关闭或重连时的等待阻塞,关闭前完成待发送数据;修复 .NET Framework 下管道读取无法仅靠取消令牌结束的问题,并保持并发关闭时的原因一致。
  •   命名管道客户端及会话的旧接收器接口、CreateReceiver、ClearReceiver 与 CreateWaitingClient 扩展;等待响应场景需迁移到对应 WaitingNamedPipe* 类型。⚠️ 破坏性变更

TouchSocket.SerialPorts​

  •   WaitingSerialPortClient,支持串口发送后等待响应、响应过滤、请求排队、取消与超时,适用于没有请求标识的一问一答通信。
  •   串口回调中关闭或重连时的相互等待问题,并发关闭时保持关闭原因一致。
  •   串口客户端的旧接收器接口、CreateReceiver、ClearReceiver 与 CreateWaitingClient 扩展;等待响应场景需迁移到 WaitingSerialPortClient。⚠️ 破坏性变更

TouchSocket.Dmtp​

  •   IReconnectableActor,允许功能件在连接结束时通过 OnDisconnected 清理会话资源,并由宿主插件持有和最终释放,以支持跨重连保留配置。
  •   HTTP、WebSocket 客户端及 TCP、HTTP 会话补齐 OnDmtpConnecting、OnDmtpConnected、OnDmtpRouting 与 OnDmtpCreatedChannel 重写入口,保留原有入口兼容;DmtpActor 新增受保护的 OnTransportClosing 方法,供自定义宿主关闭承载连接。
  •   DMTP 主动关闭时触发 Closing,被动关闭不再触发;CloseAsync 同时关闭协议及承载连接,取消等待并清理通道后触发一次 Closed,支持在回调中关闭和重连。⚠️ 行为变更
  •   DmtpMessage.Head 由公开的 byte[] 字段改为 ReadOnlySpan<byte> 属性,消息头不再允许修改。⚠️ 破坏性变更
  •   IDmtpChannel.ReadAsync 返回的内存在下一次读取开始或通道释放前有效,长期保存需自行复制;同一通道并发读取时抛出 InvalidOperationException,通道完成或释放后注销本地 ID。
  •   握手拒绝、连接失败及取消时清理底层连接和等待项,可靠传输在握手完成前或关闭期间拒绝业务报文,并避免重复握手和在线状态残留。
  •   DmtpAdapter 校验报文长度与最大包限制,DmtpMessage.Parse 校验完整报文长度;使用输出委托发送时保证每次输出完整 DMTP 报文,避免 WebSocket 等传输收到不完整消息。
  •   ResetIdAsync 与创建通道操作取消时抛出 OperationCanceledException;连接断开时解除通道读写等待,避免读取结果引用已释放缓冲区。
  •   DmtpRpcActor.InvokeAsync 的直连与路由请求在发送阶段应用调用取消令牌或配置的超时,避免等待发送锁或管道刷新时无法取消;取消通知使用独立的一秒超时并关联连接关闭令牌,通知发送失败不再持续阻塞调用方退出。

TouchSocket.Http​

  •   SetupClientWebSocket 提供受保护的 WebSocketCloseAsync 方法,可选择是否等待关闭回调,供握手失败等场景使用。
  •   WebSocket 回调中关闭或重连时的相互等待问题,关闭操作始终作用于调用时的连接,避免关闭回调重新建立的连接受到影响。
  •   StaticFilesPool 在目录扫描与按需加载并发时丢失缓存关联的问题,确保删除文件后清除相应缓存,并在文件监控错误后重新扫描目录恢复缓存一致性。

TouchSocket.AspNetCore​

  •   WebSocketDmtpSessionClient 统一协议与 WebSocket 传输的关闭流程,在承载连接结束后完成 DMTP 等待项和通道清理,避免接收回调关闭时阻塞。

TouchSocket.Mqtt​

  •   MQTT 服务端支持保留消息,按主题保存带 Retain 标记的消息,订阅确认后发送匹配的保留消息;空负载保留消息用于清除该主题的记录。
  •   MQTT 5 服务端声明保留消息可用,并按订阅的 RetainHandling 决定是否发送;保留消息投递使用发布与订阅 QoS 的较小值,MqttBroker.Clear 同时清除保留消息。

TouchSocket.Semi​

  •   HsmsClient 与 HsmsSessionClient 收到偶数 Function 的数据应答时,按 SystemBytes 匹配等待中的请求,避免 SendHsmsMessageAsync 无法获得已收到的应答。

TouchSocket.SocketIo​

  •   SocketIoConnectException 提供带错误消息的构造函数,连接被拒绝时保留服务端返回的错误信息。
  •   SocketIoClient.ConnectAsync 等待目标命名空间确认后再标记上线,修复 Engine.IO 连接成功但 Socket.IO 握手尚未完成的问题,并清理连接失败时的资源。
  •   Engine.IO 3 与 4 轮询连接的命名空间报文格式及握手应答处理,正确识别不含 JSON 数据的命名空间连接消息。
  •   应用事件按顺序在连接回调完成后处理,同时继续接收 ACK,避免事件回调内等待双向确认时互相阻塞;关闭 WebSocket 时避免与接收循环争用关闭应答。

TouchSocketPro.Dmtp​

  •   NamedPipeDmtpClient 与 NamedPipeDmtpSessionClient 补齐 OnDmtpConnecting、OnDmtpConnected、OnDmtpRouting 和 OnDmtpCreatedChannel 重写入口,保留原有入口兼容。
  •   命名管道 DMTP 连接失败、关闭与重连时的资源清理和在线状态判定;中继功能保留可重连客户端的配置,并在重连后关联新的 DMTP 连接。
  •   远程流操作实际应用 Timeout,响应用户取消与连接断开;取消请求远程流时抛出 OperationCanceledException,避免返回空结果或持续等待。

TouchSocketPro.AspNetCore​

  •   HttpMiddlewareDmtpSessionClient 统一协议与底层传输的关闭流程,连接结束时完成等待项与通道清理,避免回调关闭时等待自身。

TouchSocketPro.SocketIo​

  •   Engine.IO 4 轮询连接等待 Socket.IO CONNECT 后再通知上线,避免 GET 与 POST 并发导致重复连接通知;服务端应用事件在连接回调完成后顺序执行,并保持 ACK 接收畅通。

v4.3.11​

更新日期: 2026.10.25

更新描述:

  • MCP 支持命名管道传输
  • 修复 MCP 资源读取序列化
  • 新增单驱动 PLC 操作器
  • 修复 PLC 取消状态判定

更新详情:

TouchSocket.Mcp​

  •   McpNamedPipeClient、IMcpNamedPipeClient 与 McpNamedPipeService,支持通过命名管道建立 MCP 客户端和服务端通信。
  •   McpNamedPipeSessionClient 与 McpNamedPipeCallContext,支持在 MCP 调用中访问当前命名管道会话。
  •   McpNamedPipeClient 支持消息分包粘包处理、请求取消及连接断开时取消待处理请求。
  •   IMcpClient.ReadResourceAsync 使用 McpReadResourceParams 传递参数,确保源生成 JSON 序列化正常工作。

TouchSocketPro.PlcBridges​

  •   PlcDriveOperator<TValue>,支持直接读写单个 PlcDrive<TValue>,无需启动 PlcBridgeService。
  •   PLC 操作取消时正确返回 Canceled 状态,超时场景仍返回 Overtime 状态。

v4.3.10​

更新日期: 2026.10.11

更新描述:

  • 新增 S7 通信模块
  • 修复 WebSocket 分片帧标记
  • 优化串口关闭流程

更新详情:

TouchSocketPro.S7(新模块)​

  •   S7Client、S7Server 与 IS7Service,提供基于 ISO-on-TCP 的 S7comm 客户端和服务端通信能力。
  •   S7Client 支持读取和写入数据块、输入、输出与标志区的字节及位数据。
  •   S7ClientOption、S7ConnectionType、S7Area 与 S7ConfigExtension,支持配置 PLC 机架、插槽、连接类型、PDU 长度和响应超时。
  •   S7Server 支持注册数据块及输入、输出、标志区内存,供 S7 客户端读写。

TouchSocket​

  •   WebSocketDataFrame 使用分段发送多帧消息时,正确标记最后一个数据帧。

TouchSocket.SerialPorts​

  •   SerialCore 关闭串口前清空输出缓冲,避免硬件流控或蓝牙断连时关闭阻塞。

v4.3.8​

更新日期: 2026.9.17

更新描述:

  • 新增传输发送完成接口 ⚠️ 破坏性变更
  • 连接关闭前完成待发送数据
  • MCP 工具结果新增成功状态
  • MQTT 连接状态判断修正

更新详情:

TouchSocket.Core​

  •   ITransport 新增 CompleteSendAsync(CancellationToken) 方法,用于完成发送队列并等待待发送数据处理结束。⚠️ 破坏性变更

TouchSocket​

  •   TCP 与 HTTP 传输关闭连接前完成发送队列并等待发送任务结束,确保已写入的数据能够发送完成。

TouchSocket.Mcp​

  •   IMcpToolResult 新增 IsSuccess 属性,用于标识 MCP 工具调用结果是否成功。

TouchSocket.Mqtt​

  •   MqttClientActor 与 MqttSessionActor 仅在连接成功后将 Online 设为 true,断开或连接失败时正确重置状态。
  •   MQTT TCP 会话客户端在 CONNACK 拒绝时主动关闭连接,避免连接状态残留。
  •   MQTT TCP 与 WebSocket 客户端在连接被拒绝时主动关闭连接。

v4.3.6(5)​

更新日期: 2026.9.5

更新描述:

  • MCP 客户端支持列表分页
  • MCP 工具适配 AI 函数
  • MCP HTTP 客户端升级 ⚠️ 破坏性变更
  • SSH 支持 Ed25519 私钥认证
  • SSH Shell 支持调整终端尺寸
  • OpenAPI 架构生成优化

更新详情:

TouchSocket.Mcp​

  •   IMcpClient、McpStdioClient 与 McpHttpClient 的工具、资源、资源模板和提示列表新增 cursor 参数重载及 ListAll*Async 方法,支持获取分页结果或自动聚合全部分页。
  •   McpAIFunction 类型,以及 IMcpClient.ListAllAIFunctionsAsync、ListAllAIToolsAsync 方法,可将 MCP 工具转换为 Microsoft.Extensions.AI 的 AIFunction 或 AITool。
  •   McpListRequestParams 类型,用于传递 MCP 列表请求的分页游标。
  •   McpHttpClientSlim 更名为 McpHttpClient,并支持在构造函数传入 System.Net.Http.HttpClient。⚠️ 破坏性变更

TouchSocketPro.Ssh​

  •   SshClient 支持使用 OpenSSH 格式的 Ed25519 私钥进行公钥认证。
  •   SshShellSession.ResizeTerminalAsync 方法,可向服务端发送窗口尺寸变更请求,更新 Shell 伪终端的字符与像素尺寸。

TouchSocket.WebApi​

  •   OpenApiPlugin 生成的数组、泛型、指针及引用类型 Schema 名称将过滤非法字符,避免 OpenAPI 文档出现无效引用。
  •   OpenApiPlugin 自动移除未被接口引用的组件 Schema,并对枚举值去重,精简生成的 OpenAPI 文档。
  •   OpenApiPlugin 不再为 GET、DELETE 和 HEAD 接口生成请求体,符合 HTTP 与 OpenAPI 规范。

v4.3.4​

更新日期: 2026.8.27

更新描述:

  • MCP 工具列表支持分页
  • MCP 可省略工具输出架构
  • 新增 SMB2 客户端与服务端
  • SSH 客户端支持 RSA 私钥认证
  • SSH 服务端支持通道读写
  • SSH 服务端支持 SFTP
  • SSH 插件可接管通道请求
  • 精简 SSH 旧版插件接口 ⚠️ 破坏性变更

更新详情:

TouchSocket.Mcp​

  •   McpServerOptions.ToolListPageSize 属性,用于限制 tools/list 每页返回的工具数;设为小于等于 0 时保持一次返回全部工具的行为。
  •   McpServerOptions.IncludeToolOutputSchemaInToolList 属性,可控制 tools/list 响应是否包含工具输出 Schema,默认包含。
  •   tools/list 支持通过 cursor 参数分页获取工具,并在存在后续工具时返回 nextCursor。

TouchSocket.Redis​

  •   IRedisClient 移除重复声明的 ConnectAsync 方法,统一继承 IConnectableClient 提供的连接契约。⚠️ 破坏性变更

TouchSocketPro.Smb(新模块)​

  •   ISmbClient、SmbClient、ISmbService、SmbService 与 SmbSessionClient,提供原生 SMB2 客户端和服务端通信能力,支持协商、NTLMv2 认证及共享连接。
  •   ISmbClient 提供共享列举和切换、文件上传下载、目录列举、路径检查、创建、删除与重命名方法,支持断点续传、进度回调及传输块大小设置。
  •   SmbService.AddShare、RemoveShare 方法及 SmbShareOption 配置类型,支持将本地目录发布为 SMB 共享。
  •   SMB 会话与访问插件接口,支持认证、连接生命周期、共享和文件目录访问的权限控制及审计。

TouchSocketPro.Ssh​

  •   SshClient 支持通过 PrivateKeyFilePath 使用 RSA 私钥认证,兼容 PKCS#1、PKCS#8 及未加密 OpenSSH PEM 密钥。
  •   服务端 ISshChannel 新增 ReadAsync、WriteAsync、WriteExtendedDataAsync、CompleteAsync 与 CloseAsync 方法,支持在通道请求插件中收发数据并完成请求。
  •   SshChannelRequestEventArgs.Channel 属性,向通道请求插件提供当前 ISshChannel 实例。
  •   ISshChannelRequestPlugin 可接管 shell、exec 与 subsystem 请求,并在未标记为已处理时回退至默认处理逻辑。
  •   SshExecCommandPlugin、SshSubsystemPlugin 及 UseSshExecCommand、UseSshSubsystem 扩展方法,支持通过插件处理远程命令和自定义子系统。
  •   UseSshSftp 扩展方法与 SshServerSftpSubsystem,支持在服务端注册 SFTP 子系统并限制文件根目录。
  •   ISshSession 继承 ITcpSession,可访问 TCP 会话能力。
  •   SshChannelDataEventArgs、SshConnectionFailedEventArgs、ISshChannelDataPlugin、ISshConnectionFailedPlugin 已移除;SSH 文件传输类型迁移至 TouchSocket.Ssh 命名空间。⚠️ 破坏性变更

v4.3.3​

更新日期: 2026.8.22

更新描述:

  • 新增 SSH 客户端与服务端
  • TransportStream 支持 APM 异步

更新详情:

TouchSocketPro.Ssh(新模块)​

  •   ISshClient、SshClient、ISshService、SshService 与 SshSessionClient,提供基于 TCP 的 SSH 客户端与服务端通信能力。
  •   ISshClient 提供 PingAsync、ExecuteCommandAsync 和 OpenShellAsync 方法,支持连接保活、远程命令执行及交互式 Shell 会话。
  •   SshFileOperator 与 ISshClient 的上传、下载、目录列举、路径检查、创建、删除及重命名方法,支持远程文件管理、进度回调、限速与断点续传。
  •   SshClientOption、SshServiceOption、SshShellOption 配置类型及连接、通道、文件传输相关插件接口,支持客户端、服务端与文件传输流程扩展。

TouchSocket​

  •   TransportStream 新增 BeginRead、EndRead、BeginWrite、EndWrite 覆盖,实现任务异步模式到 APM 异步模式的兼容转换。

v4.3.2​

更新日期: 2026.8.15

更新描述:

  • WebApi 枚举序列化优化:新增转换器,枚举按小写字符串序列化并统一识别为整数类型。
  • WebApi 支持可空类型标注:属性与 Schema 新增 Nullable 标识。
  • WebApi 新增 Guid/Uri 类型映射:均序列化为 String 类型。
  • WebApi 新增 Binary/Record/Tuple 等类型支持:完善 Schema 生成分支。
  • WebApi 属性名支持 JsonPropertyName:优先读取序列化命名,避免与实际字段名不一致。
  • WebApi 修复参数类型遗漏注册问题:修复表单参数类型未加入组件 Schema 列表。

更新详情:

TouchSocket.WebApi​

  •   OpenApiDataTypesJsonConverter 类(JsonConverter<OpenApiDataTypes>),按 OpenAPI 规范将枚举值序列化为小写字符串,OpenApiJsonSerializerContext 与 OpenApiDataTypes 均切换至该转换器。
  •   OpenApiProperty 新增 Enum(long[])与 Nullable(bool?)属性;OpenApiSchema 新增 Nullable(bool?)属性,用于标注可空类型。
  •   OpenApiPlugin.CreateProperty 与 CreateSchema 统一重构:识别 Nullable<T> 并展开为实际类型同时标记 Nullable = true;枚举类型统一识别为 Integer 并携带 Enum 可选值列表与格式。
  •   OpenApiPlugin.CreateProperty、CreateSchema 新增对 Binary、BinaryCollection、Record、Struct、Tuple 数据类型的处理分支,生成对应的 binary 格式、数组或对象 Schema。
  •   OpenApiPlugin.ParseDataTypes 新增 Guid、Uri 类型映射为 OpenApiDataTypes.String;GetSchemaFormat 对 Guid 类型返回 uuid 格式,未知类型默认格式由 object 调整为空。
  •   OpenApiPlugin.AddSchemaType 新增空类型判断及 Nullable<T> 展开处理,并在解析请求体表单参数时补充调用,修复参数类型未注册到组件 Schema 列表的问题。
  •   OpenApiPlugin 新增 GetOpenApiPropertyName 静态方法,生成属性 Schema 时优先读取 JsonPropertyNameAttribute,否则按驼峰命名策略转换,避免与实际 JSON 输出字段名不一致。
  •   OpenApiPlugin.CreateProperty、CreateSchema 中 Object 类型引用统一改为 GetSchemaName(type) 生成 $ref,与组件命名保持一致。

v4.3.1​

更新日期: 2026.8.9

更新描述:

  • ReconnectionOption 新增 OnLog 统一回调:新增 OnLog 异步日志回调,统一重连成功/失败/放弃事件通知;旧三个回调保持兼容。
  • 新增 TouchSocket.Redis 模块:全新 Redis 客户端/服务端实现,支持 RESP 协议,内置内存数据库及常用命令。

更新详情:

TouchSocket​

  •   ReconnectionLogType 枚举,包含 Failed(重连失败)、GiveUp(放弃重连)、Success(重连成功)三个值。
  •   ReconnectionLogEventArgs 类,包含 Type(日志类型)、Attempts(当前尝试次数)、MaxRetryCount(最大重连次数)、Message(日志消息)、Exception(可选异常)属性。
  •   ReconnectionOption<TClient>.OnLog(Func<TClient, ReconnectionLogEventArgs, Task>)属性,统一异步重连日志回调;默认实现转调旧的 OnFailed/OnGiveUp/OnSuccessed,重新赋值后旧三个回调不再被自动调用。
  •   ReconnectionPlugin 内部将三处回调调用(成功/失败/放弃)统一重构为调用 InvokeReconnectionLogAsync,通过 OnLog 统一分发。

TouchSocket.Redis(新模块)​

  •   IRedisSession 接口,定义 SendRedisValueAsync 发送 RESP 值方法。
  •   IRedisClient 接口,继承 IRedisSession,新增 ConnectAsync 和 ExecuteAsync 方法,表示完整 Redis 客户端契约。
  •   RedisValueKind 枚举,定义 RESP 协议值类型:Null、SimpleString、Error、Integer、BulkString、Array。
  •   RedisValue 类,实现 RESP 值的构造、序列化与解析,提供 Command、BulkStringValue、IntegerValue、Error、SimpleString 等工厂方法。
  •   RedisClient 类,继承 TcpClientBase 实现 IRedisClient,内置请求/响应队列,支持并发命令执行及自动 AUTH 认证。
  •   RedisService 类,继承 TcpServiceBase<RedisSessionClient>,内置 RedisDatabase 内存数据库及 RedisCommandProcessor 命令处理器,提供兼容 Redis 协议的 TCP 服务端。
  •   RedisSessionClient 类,实现 IRedisSession,负责服务端会话的 RESP 接收与响应、AUTH 认证及插件派发。
  •   RedisDatabase 类,基于内存的 Redis 数据库,支持 String(GET/SET/DEL/EXISTS/INCR/DECR/MGET/MSET/EXPIRE/TTL/KEYS)、List(LPUSH/RPUSH/LLEN/LRANGE)、SortedSet(ZADD/ZCARD/ZREM)数据结构。
  •   RedisCommandProcessor 类,处理 RESP 命令分发,内置 PING、ECHO、QUIT、SELECT、AUTH、DBSIZE、FLUSHDB 及全部上述数据结构命令,支持继承扩展。
  •   RedisClientOption 配置类,包含 UserName、Password 属性,为空密码时使用旧式 AUTH 认证。
  •   RedisServerOption 配置类,包含 UserName、Password、AcceptSelectCommand 属性,控制服务端认证与 SELECT 命令支持。
  •   RedisConfigExtension,提供 SetRedisClientOption / SetRedisServerOption 配置扩展依赖属性。
  •   RedisClientExtension,提供 PingAsync、EchoAsync、QuitAsync、GetStringAsync、GetBytesAsync、SetAsync、ExecuteForStringResultAsync、ExecuteForLongResultAsync、ExecuteForStringArrayResultAsync、ExecuteForMemoryResultAsync 等常用命令扩展方法。
  •   IRedisReceivedPlugin 插件接口,支持在服务端接收到 RESP 值时通过插件系统派发 OnRedisReceived 事件。
  •   RedisReconnectionOptionsExtension.UseRedisCheckAction<TClient> 扩展方法,为 ReconnectionOption<TClient> 配置 Redis PING 心跳检测,支持自定义活动时间间隔与 PING 间隔。

v4.3.0​

更新日期: 2026.8.1

更新描述:

  • 发送接口升级分段序列:ISender、IIdSender、IUdpClientSender 核心发送接口参数由 ReadOnlyMemory<byte> 升级为 ReadOnlySequence<byte>,支持零拷贝分段发送。⚠️ 破坏性变更
  • SendInput 升级为分段序列:SingleStreamDataHandlingAdapter.SendInput 参数升级为 ReadOnlySequence<byte>。⚠️ 破坏性变更
  • 新增 Memory 兼容扩展方法:SenderExtension 新增 ReadOnlyMemory<byte> 重载,向下兼容旧调用。
  • HTTP 新增流式表单读取:新增 IStreamingFormReader、IStreamFormSection 接口及 GetStreamingFormReader 扩展方法,支持流式读取表单,不加载整体请求体。
  • McpHttpCallContext 暴露 HTTP 上下文:实现 IMcpHttpCallContext,新增 HttpContext、HttpSessionClient 属性。

更新详情:

TouchSocket.Core​

  •   SingleStreamDataHandlingAdapter.SendInput<TWriter> 参数由 in ReadOnlyMemory<byte> memory 升级为 in ReadOnlySequence<byte> sequence,默认实现遍历分段逐段写入,子类如需覆盖需同步更新签名。⚠️ 破坏性变更
  •   FixedHeaderPackageAdapter.SendInput<TWriter> 参数同步升级为 ReadOnlySequence<byte>,长度计算改用 checked((int)sequence.Length) 防溢出,数据写入改为逐分段循环写入。
  •   FixedSizePackageAdapter.SendInput<TWriter> 参数同步升级为 ReadOnlySequence<byte>,长度验证使用 sequence.Length。
  •   TerminatorPackageAdapter.SendInput<TWriter> 参数同步升级为 ReadOnlySequence<byte>,数据写入改为逐分段写入后追加终止符。

TouchSocket​

  •   ISender.SendAsync、IIdSender.SendAsync、IUdpClientSender.SendAsync 接口方法签名统一由 ReadOnlyMemory<byte> 升级为 ReadOnlySequence<byte>,支持分段只读序列直接发送。⚠️ 破坏性变更
  •   SenderExtension 新增三组 ReadOnlyMemory<byte> 重载扩展方法(对应 ISender/IIdSender/IUdpClientSender),内部包装为 ReadOnlySequence<byte> 后转发,保持旧调用代码兼容。
  •   TCP/UDP/KCP/NatTarget 全系组件(TcpClient、TcpSessionClient、TcpService<TClient>、UdpSession、KcpClient、KcpSessionClient、NatTargetClient)统一新增 SendAsync(ReadOnlySequence<byte>, CancellationToken) 公共方法,服务端同步新增按 Id 分段发送重载。

TouchSocket.NamedPipe​

  •   NamedPipeClient.SendAsync(ReadOnlySequence<byte>, CancellationToken) 方法,委托至 ProtectedSendAsync。
  •   NamedPipeSessionClient.SendAsync(ReadOnlySequence<byte>, CancellationToken) 和 SendAsync(string, ReadOnlySequence<byte>, CancellationToken) 方法。
  •   NamedPipeService<TClient>.SendAsync(string, ReadOnlySequence<byte>, CancellationToken) 方法,通过 Id 查找客户端后转发。

TouchSocket.SerialPorts​

  •   SerialPortClient.SendAsync(ReadOnlySequence<byte>, CancellationToken) 方法,委托至 ProtectedSendAsync。

TouchSocket.Http​

  •   IStreamingFormReader 接口及 GetStreamingFormReader<TRequest> 扩展方法,支持流式拉取 multipart/form-data 或 application/x-www-form-urlencoded 表单数据,无论文件大小均不将请求体整体加载至内存。
  •   IStreamFormSection 接口,表示单个表单段,包含 Name、FileName、IsFile、ContentType、DataPair 等属性,以及 ReadAsync/CopyToAsync/ReadAsStringAsync 等流式读取方法。

TouchSocket.Mcp​

  •   IMcpHttpCallContext 接口,定义 HttpContext(HttpContext)和 HttpSessionClient(IHttpSessionClient)属性,供 HTTP 传输场景访问请求上下文。
  •   McpHttpCallContext 实现 IMcpHttpCallContext 接口,构造函数新增 HttpContext httpContext 参数并存储到同名属性;同时暴露 HttpSessionClient 属性,对外提供当前 HTTP 会话客户端引用。