Appearance
扩展术语表
本章补充水声通信、分布式系统与本项目特有的专业术语，作为 00-doc-info.md 基础术语表的扩展。
水声通信术语
| 术语 | 英文全称 | 说明 |
|---|---|---|
| UnetStack | Underwater Networks Stack | 水声通信协议栈框架，基于 Java Agent 架构，提供物理层到应用层的完整协议实现 |
| UnetSim | Underwater Networks Simulator | UnetStack 配套的离散事件仿真环境，用于水声网络协议的开发与验证 |
| fjage | Framework for Java and Groovy Agents | UnetStack 底层的多 Agent 框架，提供 Agent 通信、服务发现与消息路由 |
| fjage gateway | fjage TCP Gateway | fjage 对外暴露的 TCP 网关接口，允许外部进程（如 Python）通过 JSON 协议与 Agent 交互 |
| PHY | Physical Layer | 物理层，负责信号调制/解调、信道编码等底层通信功能 |
| SNR | Signal-to-Noise Ratio | 信噪比，衡量接收信号质量的关键指标（dB） |
| RSSI | Received Signal Strength Indicator | 接收信号强度指示，用于评估链路质量 |
| Datagram | — | UnetStack 中的数据报文单元，通过 DATAGRAM service 传输 |
| MTU | Maximum Transmission Unit | 最大传输单元，水声信道中通常较小（如 56 bytes） |
| NODE_INFO | Node Information Service | UnetStack 提供的节点信息服务，用于查询节点的 UNet 地址、位置等属性 |
| ARP | Address Resolution Protocol | 地址解析协议，在 UnetStack 中用于将逻辑地址映射到物理寻址 |
| arlpy | — | UnetStack 官方 Python 绑定库，通过 fjage gateway 提供 Python 端 API |
| fjagepy | — | fjage 的轻量级 Python 客户端库，作为 arlpy 的备选方案 |
| Tx / Rx | Transmit / Receive | 发送 / 接收，水声通信中的数据传输方向标识 |
分布式系统术语
| 术语 | 英文全称 | 说明 |
|---|---|---|
| Barrier | Barrier Synchronization | 栅栏同步，所有参与者到达同步点后才共同继续，确保步间一致性 |
| Logical Clock | — | 逻辑时钟，不依赖物理时钟的事件排序机制，本系统中以 step_id 实现 |
| Step | Time Step | 时间步，系统以固定步长 ΔT 推进的离散时间单位 |
| Seed | Random Seed | 随机种子，用于确保实验的可复现性 |
| Idempotent | — | 幂等性，同一操作重复执行结果不变（如终态 run 的 stop 操作） |
| State Machine | — | 状态机，本系统中 run 的生命周期由有限状态机管理（created → running → finished） |
| Graceful Degradation | — | 优雅降级，核心功能不可用时自动切换到低精度但可用的备选方案 |
本项目特有术语
| 术语 | 说明 |
|---|---|
| Run | 一次完整的仿真运行，由 run_id 唯一标识，包含场景、策略、参数与全部产物 |
| Run 产物 | 一次 run 输出的全部文件：scenario.yaml / strategy.json / versions.json / traces.csv / metrics.csv / report.md |
| Trace | 单条消息的发送/接收事件记录，包含时间戳、源/目标节点、序列号等 |
| Metrics | 按 step 或窗口聚合的统计指标，包含吞吐量、时延分位数、丢包率等 |
| Schedule Decision | 每步的调度决策记录，包含 active_nodes、quota_frames、调度开销等 |
| PHY Preflight | 运行前对各仿真节点物理层的健康预检流程，确认网关可连、agent/service 正常 |
| Gateway Preflight | 启动 gateway 模式 run 前的完整预检流程，包含 PHY 检查、UNet 地址解析与节点选择 |
| PreflightSelection | Preflight 结果数据结构，包含 candidates / healthy / selected / reports |
| UnetAdapter | UNET 操作的抽象适配器接口，隔离仿真底座差异，提供 connect / probe / send / subscribe 等统一方法 |
| UnetInstance | 单个仿真节点的连接实例，包含 name / host / port / meta 信息 |
| LogOnly | 仅通过日志文件解析完成指标采集的降级模式，不依赖 fjage gateway |
| Payload Header | 发送 payload 前附加的 24 字节固定头部，确保跨版本的指标计算稳定性 |
| RunRepository | 管理 runs / run_summary / run_events 三张表的持久化仓储类 |
| TraceRepository | 管理 run_traces / run_metrics 两张表的持久化仓储类 |
| RuntimeSettings | 集中管理数据库连接、UNET 端点、表名映射等运行时配置的类 |
| Scenario CRUD | 通过 REST API 对场景配置进行创建/读取/更新/删除的标准操作 |
| Demo-0 / Demo-1 / Demo-2 | 三个递进式验收里程碑：离线闭环 / Gateway 端到端 / Dashboard 全流程 |