术语表

运行

构建配置的一次执行。 在 TeamCity web 接口中，相当于 构建。

工作

运行构建的一套设置指令。 在 TeamCity web 接口中，相当于 build configuration（构建配置）。

Project（项目）

具有名称和描述的一组构建配置（作业）。 项目可以嵌套以形成层次结构。

管道

共享同一个 .teamcity.yml 源的、YAML 定义的作业集合。 Pipeline 是 TeamCity 针对 Kotlin DSL 和 web UI 的声明式替代方案；CLI 可列出、视图、校验并同步它们。

VCS Root（VCS 根）

指向版本控制仓库（Git、Mercurial、Perforce 等）的指针。 作业会附加到一个或多个 VCS 根，以获取其构建所需的源代码。 CLI 在项目级别管理 VCS 根。

连接

TeamCity 代表作业使用的外部服务（GitHub 应用、Bitbucket、Docker 注册表、AWS 等）的存储凭据。 连接存在于项目级别，避免在单独作业中嵌入密钥。

版本化设置

TeamCity 的一项功能，可将项目的配置（作业、参数、触发器）与 Git 仓库同步为 Kotlin DSL 或 XML。 CLI 可在本地导出并校验 DSL，无需来回转换至 UI。

构建队列

等待分配至可用代理的构建列表。 队列中的构建会在资源可用时分布式到兼容的代理。 队列可手动重新排序。

Build Agent（构建代理）

执行构建的软件。 代理安装在独立机器上，并根据其与构建配置的兼容性被分配构建任务。

代理池

命名的构建代理组。 项目可关联至代理池以控制哪些代理运行其构建任务。

云配置文件

项目与云服务商（AWS、GCP、Azure、Kubernetes 等）之间的绑定。 配置文件定义了一个或多个镜像，TeamCity 用于按需启动短时构建代理。

云端镜像

用于通过云配置文件启动短时代理的模板 —— 例如 EC2 的 AMI 或 Kubernetes 上的容器镜像。 每个镜像都指定了 TeamCity 启动构建所需代理时使用的代理运行时。

云实例

由云端镜像创建的单个运行中的临时代理。 实例是短时的：当构建需要代理时，TeamCity 会创建实例，任务结束后销毁。

Change（更改）

TeamCity 检测到的源代码修改。 当更改已提交到 VCS 但尚未包含在构建中时，被视为待处理状态。

个人构建

开发者发起的构建，用于测试本地更改而不影响主构建历史。 在 TeamCity CLI 中，个人构建是通过 --local-changes 标志触发的。

别名

可扩展为完整 teamCity 命令的自定义命令快捷键。 别名支持位置实参和 shell 表达式。

技能

用于教 AI 编码代理（如 Claude Code、Cursor 等）如何使用 TeamCity CLI 的捆绑配置文件。 技能遵循 Agent Skills 规范。

术语映射