术语表

本页只解释 Jugg Wiki、CLI/MCP 输出和日志里会反复出现的稳定术语。它不展开机制细节；如果一个词只在单篇文章里出现，优先在原文就地解释。

编译

术语	含义
增量编译	只处理本轮变更影响到的源码、资源、Manifest、dex 或其他产物。
Gradle 回退	Jugg 判断增量链路不可靠或用户强制要求时，转为完整 Gradle 构建。
Full build baseline	Jugg 通过一次完整构建建立的项目、classpath、APK 和部署历史基线。
Build target	当前构建目标，例如普通 App 或 Android Test。
Source compiler	处理 Java/Kotlin 源码、注解处理和 dex 输出的编译阶段。
Resource compile	处理 res/、assets/、资源表和资源 APK 的编译阶段。
Manifest compile	处理 AndroidManifest 合并、差异和安装包声明的阶段。
Const-ref	编译期常量定义和引用影响分析，用于判断常量变更需要重编译哪些源码。

部署

术语	含义
Deploy	把编译产物安装或更新到设备，并按策略启动、重启或热更新 App。
Clean reinstall	清除数据并重新安装 APK，用于恢复不一致状态。
Code swap	只下发可热替换的代码变化，尽量避免重启 App。
Full swap	下发更完整的变更集合，通常比 code swap 更重，可能需要重启。
Hot reload	部署后不重启 App 的快速路径，要求变更满足运行时热更新条件。
Hot fix	更保守的部署路径，通常会强制重启 App。
Direct overlay	不依赖 App 进程在线的 overlay 部署快捷路径。
Deploy history	Jugg 记录的已部署 APK、overlay、dex 和设备状态历史。

项目和缓存

术语	含义
Project info	Jugg 从 IDE 和 Gradle 读取的模块、source set、variant、依赖和 APK 信息快照。
Compile context	增量编译使用的模块、classpath、依赖和构建目标上下文。
Staging	本轮增量编译输出的临时部署目录，位于 build/jugg/build/staging/。
Classpath backup	Jugg 保存的 classpath、APK、library backup 和 embedded APK 缓存。
Include build	Gradle composite build 中被合并进主工程模型的外部构建。

androidTest

术语	含义
Instrumentation	Android am instrument 测试运行方式。
Test APK	包含 androidTest 代码和测试 runner 的 APK。
Library Test APK	library 模块自测时生成的测试 APK。
Synthetic module	Jugg 为 androidTest source set 构造的测试模块视图。
Rerun failed	只重新运行上次失败测试项的能力。

MCP / CLI

术语	含义
MCP	Model Context Protocol，Agent 调用 Jugg 的本地工具协议。
Tool	MCP 中可调用的能力，例如 deploy、layout-dump、wait-logs。
Structured content	MCP tool 返回的结构化 JSON 结果。
Artifact	MCP tool 生成的文件产物，例如 UI HTML、日志窗口或 dump 文件。
projectDir	MCP 和 CLI 用来定位 IDE 中 Jugg 项目的绝对路径。
isFinal=false	编译类工具已启动异步任务，客户端需要继续轮询 get-compile-status。