Struct ReportAgentFactSummary 

pub struct ReportAgentFactSummary {

    pub api_version: String,
    pub kind: String,
    pub report_id: String,
    pub agent_id: String,
    pub instance_id: String,
    pub content_digest: String,
    pub revision: i64,
    pub observed_at: String,
    pub os: String,
    pub arch: String,
    pub process_count: i64,
    pub process_executables: Vec<String>,
    pub packages: Vec<String>,
    pub listen_ports: Vec<String>,
    pub host_id: String,
    pub host_name: String,
    pub network_addresses: Vec<String>,
    pub reported_at: String,
}

agentd → 网关的事实摘要上报（控制面）。

与数据面上的原文快照（ReportDiscoverySnapshot）分工不同，不是同一条路： 摘要只服务用途推断（网关侧按规则表算），去重后 10~30 KB，走已认证的控制面； 原文快照一台几百 KB，走数据面给中心做资产整理。所以网关只接摘要。

幂等键是内容摘要，不是 revision（后者每轮 refresh 无条件 +1）。

agentd 无条件周期全量上报，判重归网关：网关用 wist_contracts::fact_summary::FactContent::content_digest 从收到的内容自己算摘要， 以此判重。content_digest 字段因此只是 agent 的声明： 与网关算出来的不一致时会记 FactDigestMismatch 告警（可能只是版本偏差，不拒收）。

Fields

api_version: String

kind: String

report_id: String

agent_id: String

instance_id: String

content_digest: String

agent 侧声明的内容摘要。不是判重键：网关从下列内容字段自算，此值只作版本偏差的金丝雀。

revision: i64

仅留痕：快照 revision 每轮 refresh 无条件 +1，网关不据它判重。

observed_at: String

仅留痕：观察到的事实属于哪一刻（快照生成时间）。

os: String

arch: String

process_count: i64

仅留痕：去重前的进程条数（去重会毁掉基数，留一个原始计数备查），不进摘要。

process_executables: Vec<String>

去重后的进程可执行标识。注意两边不同源： macOS 是 ps -axo comm= 给的完整路径，Linux 是 /proc/{pid}/comm（只有 basename）。

packages: Vec<String>

已装包名（仅 linux；macOS 侧待定）。

listen_ports: Vec<String>

host_id: String

主机标识（发现里 host 方向的 host.id）。

host_name: String

主机名（host.name）。

network_addresses: Vec<String>

网卡地址（每块网卡一条，形如 en0 192.168.1.5/24）。

reported_at: String

Implementations

impl ReportAgentFactSummary

pub fn new_agent_facts( report_id: String, agent_id: String, instance_id: String, content_digest: String, revision: i64, observed_at: String, os: String, arch: String, process_count: i64, process_executables: Vec<String>, packages: Vec<String>, listen_ports: Vec<String>, reported_at: String, ) -> Self

pub fn with_display( self, host_id: String, host_name: String, network_addresses: Vec<String>, ) -> Self

补上留痕/展示字段（不参与内容摘要与判重）。

为什么另开一个方法而不是给构造函数再加三个参数：那个函数已经有 13 个位置参数， 再加就是 16 个 —— 调用方只需错一次顺序，就会把主机名传成 os、把端口传成包名， 而这类错不会报错（都是 String/Vec），只会静默写错数据。

Trait Implementations

impl Clone for ReportAgentFactSummary

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ReportAgentFactSummary

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ReportAgentFactSummary

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ReportAgentFactSummary

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ReportAgentFactSummary

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ReportAgentFactSummary