glossary - mclucy/lucy GitHub Wiki
技术词汇表（Glossary）
本页是 Lucy Minecraft 服务器包管理器 的双语技术词汇表，覆盖核心领域术语及中文释义，面向以下读者：
为保持与代码一致性：
- 技术词汇统一保留英文原词。
- 中文释义基于源码注释与
README.md 编写。
- 凡属于代码结构推断、未被官方文档直接确认的内容，均使用 推断内容（Inferred） 警示说明。
词汇按功能领域分组，表格列含义如下：
| 列名 |
说明 |
| 中文术语 |
推荐使用的中文称谓或音译 |
| English Term |
代码中使用的英文原词 |
| 中文释义 |
该术语在 Lucy 语境下的含义 |
常见标识与约束写法示例：
PackageId 序列化格式: platform/project@version
Version 选择器: @latest | @compatible | <exact-version>
Maven 范围语法: [1.0,2.0)
关键要点
核心实体（Core Entities）
| 中文术语 |
English Term |
中文释义 |
| 包 |
Package |
可安装到 Minecraft 服务器的具体软件单元；是 project 的已编译、可部署实例，携带特定的 platform 与 version 信息。由 PackageId 唯一标识。参见 types/type_id.go:124 |
| 项目 |
Project |
mod 或 plugin 的软件本体，不绑定具体版本或平台。一个 project 可发布多个 package 版本。参见 README.md:151 |
| 包标识符 |
PackageId |
唯一标识 package 的结构体，字段由 Platform、ProjectName、RawVersion 组成，序列化格式为 platform/project@version。参见 types/type_id.go:124 |
| 项目名称 |
ProjectName |
package 的 slug 标识，使用连字符分隔（如 fabric-api），大小写不敏感。参见 types/type_id.go:99 |
| 平台 |
Platform |
修改 Minecraft 原版游戏行为的服务端框架或运行环境，也是某组 package 的公共依赖。已知值：fabric、forge、neoforge、mcdr、minecraft、none。参见 types/type_id.go:16 |
数据来源（Data Sources）
| 中文术语 |
English Term |
中文释义 |
| 数据源 |
Source |
提供 package 元数据的上游平台标识符。已知值：modrinth、curseforge、github、mcdr。参见 types/source.go:16 |
| Provider |
Provider |
上游数据源的统一接口，定义了搜索、获取包信息等操作。每个数据源（Modrinth、CurseForge 等）实现此接口。参见 upstream/upstream_types.go:21 |
版本与依赖（Versioning & Dependency）
| 中文术语 |
English Term |
中文释义 |
| 版本范围方言 |
VersionRangeDialect |
Lucy 解析版本约束字符串时使用的语法规则集合，根据 platform 自动推断。参见 dependency/version_range_dialect.go:13 |
| NPM Semver 方言 |
DialectNpmSemver |
MCDR 插件元数据使用的 NPM 风格语义版本方言。参见 dependency/version_range_dialect.go:13 |
| Fabric Semver 方言 |
DialectFabricSemver |
Fabric 加载器特定的语义版本方言，^ 符号行为与标准 Semver 不同。参见 dependency/version_range_dialect.go:13 |
| Maven 范围方言 |
DialectMavenRange |
Forge 与 NeoForge 的 mods.toml 使用的 Maven 版本范围方言，通过方括号和圆括号表达开闭区间（如 [1.0,2.0)）。参见 dependency/version_range_dialect.go:26 |
| 版本约束表达式 |
VersionConstraintExpression |
依赖约束的内部表示：外层切片是 OR 关系，内层切片是 AND 关系，每个叶节点由"比较运算符 + 版本值"构成约束对。参见 dependency/version_range_semver.go:140 |
| Minecraft 快照版本 |
MinecraftSnapshotVersion |
Minecraft 快照版本的结构化表示，支持 2026 年前格式（YY.WW.X）和 2026 年后格式（YY.U-snapshot-N）。参见 dependency/version_minecraft_types.go |
| Minecraft 正式版本 |
MinecraftVersion |
Minecraft 正式版本的结构化表示，支持预发布版本（pre-release、rc）。参见 dependency/version_minecraft_types.go |
运行时拓扑（Runtime Topology）
| 中文术语 |
English Term |
中文释义 |
| 运行时拓扑 |
RuntimeTopology |
服务器运行时环境的结构化表示，包含一组 RuntimeNode 与 RuntimeEdge，用于判定 package 安装兼容性。参见 types/type_server_topology.go:109 |
| 运行时节点 |
RuntimeNode |
拓扑中的单个运行时单元，代表服务器组件（如 mod loader、plugin core）。字段包括节点 ID、角色、所属 platform、能力列表与风险等级。参见 types/type_server_topology.go:73 |
| 运行时节点 ID |
RuntimeNodeID |
运行时节点的唯一标识符。参见 types/type_server_topology.go:3 |
| 运行时角色 |
RuntimeRole |
节点在服务器中的角色类型，如 ModLoader、PluginCore、Hybrid、Proxy、Bridge 等。参见 types/type_server_topology.go:7 |
| 运行时能力 |
RuntimeCapability |
运行时节点支持的包生态系统能力。参见 types/type_server_topology.go:20 |
| 运行时边 |
RuntimeEdge |
拓扑中节点间的关系边，描述节点之间的依赖或交互关系。参见 types/type_server_topology.go:102 |
| 运行时边类型 |
RuntimeEdgeKind |
边的类型分类，如 hosts（托管）、bridges（桥接）、routes（路由）、adapts（适配）。参见 types/type_server_topology.go:93 |
| 运行时注册表 |
RuntimeRegistry |
存储已知平台及其拓扑配置的注册表，可按节点 ID 或 platform 检索 RegistryEntry。参见 probe/probe_topology_registry.go:24 |
| 风险等级 |
RuntimeRiskLevel |
运行时节点的风险等级分类，如 None、Low、Medium、High、Critical。参见 types/type_server_topology.go:32 |
兼容性判定（Compatibility）
| 中文术语 |
English Term |
中文释义 |
| 兼容性判定 |
CompatVerdict |
package 与运行时拓扑的兼容性判定结果，包括 compatible（兼容）、degraded（降级）、incompatible（不兼容）、unresolved（未解析）。参见 types/type_server_topology.go:42 |
| 兼容性结果 |
CompatResult |
兼容性检查的完整结果，包含判定、原因、风险等级等信息。参见 types/type_server_topology.go:51 |
| 兼容性策略 |
CompatPolicy |
定义运行时与包生态系统的兼容关系的策略。参见 types/type_server_topology.go:60 |
包信息（Package Information）
| 中文术语 |
English Term |
中文释义 |
| 包依赖 |
PackageDependencies |
包的依赖列表及真实性标记。参见 types/type_package.go:63 |
| 包安装信息 |
PackageInstallation |
本地安装的包信息，包含安装路径、时间等。参见 types/type_package.go:91 |
| 包远程信息 |
PackageRemote |
远程包信息，包含来源、下载 URL、文件哈希等。参见 types/type_package.go:97 |
| 平台支持 |
PlatformSupport |
项目支持的平台和 Minecraft 版本列表。参见 types/type_package.go:110 |
| 项目信息 |
ProjectInformation |
项目元数据，包含标题、描述、作者、许可证等。参见 types/type_package.go:70 |
相关页面
参考文件
本词汇表的主要依据如下：
README.md — 项目概览、核心概念定义、命令说明types/type_id.go — Platform、ProjectName、PackageId 定义types/type_dependency.go — 版本常量、依赖关系、版本约束表达式types/type_package.go — 包信息、依赖、远程信息、项目元数据types/type_server_topology.go — 运行时拓扑、节点、边、兼容性判定types/source.go — 数据源枚举定义upstream/upstream_types.go — Provider 接口定义probe/probe_topology_registry.go — RuntimeRegistry 与拓扑构建逻辑dependency/version_range_dialect.go — 版本范围方言定义及推断逻辑dependency/version_minecraft_types.go — Minecraft 版本类型定义