# vane.net **Repository Path**: netcasewqs/vane.net ## Basic Information - **Project Name**: vane.net - **Description**: 纯托管 .NET 10 / .NET 11 网络内核,零第三方依赖,交付物为单个 Vane.NET.dll。 一套 Host / ClientBuilder 编程模型覆盖 8 种介质:TCP、UDS、NamedPipe、InProcess、HTTP、WebSocket、QUIC、UDP。 帧层基于 IFrameDecoder / IFrameEncoder 与 BCL IBufferWriter - **Primary Language**: C# - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-19 - **Last Updated**: 2026-11-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Vane.NET 纯托管 .NET 10 / .NET 11 网络内核,零第三方依赖,交付物为单个 `Vane.NET.dll`。 - 一套 `Host` / `ClientBuilder` 编程模型覆盖 8 种介质:TCP、UDS、NamedPipe、InProcess、HTTP、WebSocket、QUIC、UDP。 - 帧层基于 `IFrameDecoder` / `IFrameEncoder` 与 BCL `IBufferWriter`,帧边界由业务选择。 - 连接级超时、背压水位、TLS、准入限流,以及日志 / Meter / EventSource 三类观测通道,全部内置。 - `Vane.Rpc`、`Vane.Mqtt` 与 `Vane.Dispatch` 叠在内核之上(各自独立成仓发包),内核本身不依赖它们。 - 可选集成包:`Vane.AspNetCore` 把内核 `Host` 作为 `IHostedService` 与 ASP.NET Core / Generic Host 同进程并跑;`Vane.Mcp` 提供独立 MCP 服务端协议(stdio + Vane WebSocket)。两者都不进入内核公开面。 ## 安装 首版为预发布,三包同发;正式 `1.0.0` 等验证闭环后再发布。 ```bash dotnet add package Vane.NET --version 1.0.0-preview.1 ``` 可选集成包: ```bash dotnet add package Vane.AspNetCore --version 1.0.0-preview.1 # ASP.NET Core / Generic Host 同进程并跑 dotnet add package Vane.Mcp --version 1.0.0-preview.1 # MCP 服务端(stdio + Vane WebSocket) ``` 目标框架支持: | TFM | 状态 | |---|---| | `net10.0` | 支持 | | `net11.0` | 支持 | ## 快速开始 ```csharp using System.IO.Pipelines; using System.Net; using Vane.Hosting; Host host = Host.CreateDefault(); host.Listen(IPAddress.Loopback, 8080); await host.StartAsync(async connection => { PipeReader input = connection.Transport.Input; PipeWriter output = connection.Transport.Output; while (true) { ReadResult result = await input.ReadAsync(); foreach (ReadOnlyMemory segment in result.Buffer) await output.WriteAsync(segment); input.AdvanceTo(result.Buffer.End); if (result.IsCompleted || result.IsCanceled) break; } await output.CompleteAsync(); }); ``` `Host.CreateDefault()` 装配全部内置传输工厂;`new Host()` 保持零工厂,可只注册需要的介质。 ## 文档 - [1.0.0-preview.1 发布说明](https://gitee.com/netcasewqs/vane.net/blob/main/RELEASE_NOTES.md):版本范围、验证结果与升级说明。 - [变更记录](https://gitee.com/netcasewqs/vane.net/blob/main/CHANGELOG.md)。 - [Vane.NET 示例](https://gitee.com/netcasewqs/vane.net/tree/main/samples):按编号渐进,可直接运行。 - [Vane.NET 从入门到实践](https://gitee.com/netcasewqs/vane.net/blob/main/docs/Vane.NET_从入门到实践.md):系统教程,含可运行示例与练习。 - [Vane.NET 内核架构详解](https://gitee.com/netcasewqs/vane.net/blob/main/docs/Vane.NET_内核架构详解.md):分层、启动事务、连接数据路径、EventLoop、Session/Command、role 与观测面,含三种开发模式对比。 - [可选集成包与 Kestrel 决策](https://gitee.com/netcasewqs/vane.net/blob/main/docs/Vane.NET-可选集成包与Kestrel决策.md):AspNetCore / MCP 包边界、启动时序与测试矩阵。 - RPC 与 MQTT 的教程、线协议规范与示例已随拆仓迁出:`Vane.Rpc` → [vane.rpc](https://gitee.com/netcasewqs/vane.rpc),`Vane.Mqtt` → [vane.mqtt](https://gitee.com/netcasewqs/vane.mqtt)。 - 其余设计文档由作者另行维护,不随代码仓库发布。 ## 构建 ```bash dotnet build -m:1 dotnet test tests/Vane.NET.Tests -f net10.0 -m:1 ``` ## 许可 [MIT](LICENSE)。 ## 发布状态 当前为 `1.0.0-preview.1` 预发布,三包同发:`Vane.NET`、`Vane.AspNetCore`、`Vane.Mcp`。正式 `1.0.0` 尚未发布;版本范围与验证结果见 [RELEASE_NOTES.md](RELEASE_NOTES.md)。