Team.Feeder.Abstractions

Team.Feeder.Abstractions 是 Team.Feeder 体系的最小公共契约包。它只定义“宿主应该看到什么”，不定义“设备内部怎么实现”。如果你的代码希望面向接口编程、保持与具体设备协议解耦，这个包通常就是第一层依赖。

适用场景

• 你的应用只想依赖 IFeeder / FeederStatus 这类公共契约，不直接依赖某个设备实现。
• 你要编写新的设备驱动包，并希望遵守 Team.Feeder 的统一生命周期模型。
• 你要写宿主层、监控层、日志层或测试替身，需要一个稳定的抽象层。

包内提供的核心对象

安装

dotnet add package Team.Feeder.Abstractions

这是基础包，没有对其他 Team.Feeder 业务包的反向依赖。

最小用法

下面的代码演示如何在完全不知道具体设备实现的情况下，只面向 IFeeder 读取状态并执行连接：

using Team.Feeder.Abstractions.Contracts;

public static class FeederRuntime
{
	public static async Task PrintStatusAsync(IFeeder feeder, CancellationToken cancellationToken)
	{
		await feeder.InitializeAsync(cancellationToken);
		await feeder.ConnectAsync(cancellationToken);

		Console.WriteLine($"Name: {feeder.Name}");
		Console.WriteLine($"State: {feeder.Status.State}");
		Console.WriteLine($"Health: {feeder.Status.HealthState}");
		Console.WriteLine($"Connected: {feeder.Status.IsConnected}");
	}
}

事件与状态模型

• IFeeder.StatusChanged 用于低频、结构化的设备状态变化通知。
• FeederStatus.State 表示生命周期位置，例如 Created、Connected、Faulted。
• FeederStatus.HealthState 表示健康程度，适合给 UI 或监控系统做健康展示。
• FeederStatus.LastError 用于收敛最近一次失败，不要求调用方解析底层异常类型。

扩展一个新设备时通常怎么用

如果你在编写一个新的设备实现包，通常会：

1. 用 FeederOptions 或其派生类承载配置。
2. 实现 IFeeder，或在 Team.Feeder.Core 中基于 FeederBase 扩展。
3. 对宿主暴露 IFeederFactory，让宿主按设备类型创建实例。

与其他包的关系

• 想要复用状态机、基类和异常映射：继续引用 Team.Feeder.Core。
• 想要使用现成的 FFFeeder TCP 客户端：引用 Team.Feeder.FFFeeder。
• 想要管理多个设备：引用 Team.Feeder.Service。

边界说明

• 这里不放 TCP、串口、UDP、Socket 等通信细节。
• 这里不放 WPF 控件、ViewModel 或资源字典。
• 这里不放 FFFeeder 专属参数和协议命令。

公共契约一旦放入本包，就会成为其他包共同依赖的稳定面。因此新增成员时应优先考虑跨设备通用性，而不是为某个单一设备定制语义。