# 术语表

## 1. 首选术语

| 英文或标识 | 中文正文首选写法 | 说明 |
| --- | --- | --- |
| Distributed Shared Memory | 分布式共享内存（DSM） | 首次出现写全称，后文使用 DSM |
| runtime | Runtime 或运行时 | 指 `DsmRuntime` 时保留 Runtime；泛指执行环境时写「运行时」 |
| register | Register 集合 | 不翻译为「寄存器」 |
| lease | Lease 集合／租约 | 指集合类型时保留 Lease；指实例语义时写「租约」 |
| CRDT | CRDT 集合 | 首次解释为「无冲突复制数据类型」，后文保留缩写 |
| locator | 集合定位符 | 首次说明由 `tenantId / applicationId / collectionId` 组成 |
| live delta | 在线 delta | 指正常传播路径；不写成「实时强同步」 |
| repair | repair／副本修复 | 首次写「副本修复（repair）」；类名和命令保留英文 |
| anti-entropy | anti-entropy／反熵 | 首次并列，后文按上下文使用 |
| replay | 增量重放 | DSM repair 语境，不等于业务事件重放 |
| snapshot | 快照 | 指某一时点的可见状态集合 |
| convergence | 收敛 | 多节点最终得到等价可见状态 |
| fencing token | fencing token／围栏令牌 | 类名或字段保留英文；概念解释使用中文 |
| membership | 成员视图 | 指集群当前知道的节点及其状态 |
| schema fingerprint | schema fingerprint／结构指纹 | 首次解释其兼容性作用 |
| change stream | ChangeStream／变更流 | 指公开类型时使用类名 |
| federation | Federation／跨集群联邦 | 当前实现范围必须单独说明 |
| evidence | 证据 | 必须附来源和验证范围，不写「充分证明」除非门禁明确 |

## 2. 容易混淆的概念

| 不要混写 | 区分方式 |
| --- | --- |
| 本地提交与集群可见 | `put` 返回只确认本地路径；远端可见需要复制或 repair 证据 |
| 收敛与强一致 | 收敛描述恢复后的等价状态，不保证任意时刻读到同一值 |
| repair 与历史重放 | repair 修复当前副本状态，不保证重建完整业务事件历史 |
| Lease 与分布式事务 | Lease 提供有期限的所有权与 fencing，不提供跨资源原子提交 |
| CRDT 与计数事实 | CRDT 可合并运行计数不等于可审计账务数据 |
| 测试通过与生产就绪 | 测试只证明给定环境、拓扑和断言；生产还需要安全、容量与运维证据 |
| In-memory relay 与生产跨集群传输 | 前者是 Federation 语义基线，不证明真实网络、认证或跨区域可用性 |

## 3. 禁用或受限表达

- 不写「零成本一致性」「自动解决所有一致性问题」「绝不丢数据」。
- 不用「强一致」描述 Register、CRDT 或一般 repair 行为，除非具体 API 契约明确使用该术语。
- 不用「实时」替代「在线传播」；需要延迟结论时必须给出测量环境。
- 不把 `dsm-redis-server` 称为 Redis Server 产品或 Redis 替代品。
- 不把 `InMemoryFederationRelay` 称为生产跨集群网络实现。
- 不用「无缝」「开箱即用」隐藏 JDK、版本、网络或安全前置条件。

## 4. 排版约定

- 中文与英文缩写、独立数字和版本号之间保留空格。
- 代码、命令、配置键、类名和错误码使用反引号。
- 中文正文使用全角标点；机器可读文本保持原样。
- 标题说明读者将解决的问题，不只写抽象模块名。