附录C 术语与缩略语
本附录列出全书采用的主要术语。正文优先使用中文名称。命令、文件名和软件界面中的英文名称保持原样。
C.1 Git与协作
| 中文术语 |
英文名称或缩略语 |
本书中的含义 |
| 仓库 |
repository |
保存项目文件、提交历史、分支和标签的版本库 |
| 工作区 |
working tree |
当前在文件系统中看到和编辑的项目文件 |
| 暂存区 |
index；staging area |
为下一次提交选择的内容 |
| 提交 |
commit |
含有父提交、作者、时间和说明的项目快照 |
| 分支 |
branch |
指向提交，并随新提交移动的引用 |
| 标签 |
tag |
固定指向某一提交的版本标识 |
| 远程仓库 |
remote repository |
与本地仓库交换提交和引用的另一仓库 |
| 差异 |
diff |
两个项目状态之间的内容变化 |
| 合并 |
merge |
将不同开发路径中的变化组合起来 |
| 冲突 |
conflict |
Git不能自动确定两项变化的最终结果 |
| 反向提交 |
revert |
用一个新提交撤销已有提交的影响 |
| 议题 |
issue |
记录问题、范围、验收条件和讨论的工作项 |
| 合并请求 |
merge request |
请求评审任务分支并将其合入目标分支 |
| 主分支 |
main branch |
团队认可的稳定开发基线，本书示例名称为main |
| 受保护分支 |
protected branch |
通过权限和规则限制直接推送或合并的分支 |
C.2 AI协同
| 中文术语 |
英文名称或缩略语 |
本书中的含义 |
| 人工智能 |
Artificial Intelligence，AI |
使机器表现出感知、推理、生成或决策能力的技术总称 |
| AI开发智能体 |
coding agent |
能调用文件、终端等工具完成开发任务的AI软件 |
| 规划模式 |
Plan |
读取和分析工程、形成方案，但不修改文件的工作模式 |
| 实施模式 |
Act |
在批准的权限范围内修改文件和执行命令的工作模式 |
| 上下文 |
context |
当前任务提供给AI的文件、说明、错误和约束 |
| 幻觉 |
hallucination |
AI生成的、缺少事实或项目依据的内容 |
| 越界修改 |
out-of-scope change |
超出议题、文件、接口、权限或产品范围的变化 |
| 人工确认 |
human approval |
人阅读计划、工具调用或差异后作出的批准或拒绝决定 |
C.3 产品与软件工程
| 中文术语 |
英文名称或缩略语 |
本书中的含义 |
| 最小可行产品 |
Minimum Viable Product，MVP |
能够检验核心用户问题和解决方式的最小产品 |
| 产品需求文档 |
Product Requirements Document，PRD |
记录用户问题、产品范围、需求和验收条件的文档 |
| 产品需求 |
Product Requirement，PR |
描述用户需要的结果，不预先限定具体实现 |
| 功能需求 |
Functional Requirement，FR |
描述系统应当提供的可观察行为 |
| 非功能需求 |
Non-functional Requirement，NFR |
描述时延、资源、功耗、可靠性、隐私和成本等约束 |
| 接口契约 |
interface contract |
两个组件交换数据、状态和错误的明确约定 |
| JSON模式 |
JSON Schema |
用机器可检查的形式描述JSON数据结构和类型的规则 |
| 技术决策记录 |
Architecture Decision Record，ADR |
保存重要技术选择、候选、理由和后果的文件 |
| 追踪关系 |
traceability |
产品需求、规格、实现、测试和版本之间的联系 |
| 原子提交 |
atomic commit |
只完成一个可说明、可验证、可撤销的逻辑变化 |
| 回归测试 |
regression test |
修改后重复检查已有行为是否仍然成立的测试 |
| 持续集成 |
Continuous Integration，CI |
对提交或合并请求自动执行构建和测试的过程 |
| 发布候选 |
Release Candidate，RC |
已满足计划功能，等待最终试用和发布审查的版本 |
| 语义化版本 |
Semantic Versioning |
用主版本、次版本和修订版本表达兼容性变化的规则 |
C.4 物理AI、数据与模型
| 中文术语 |
英文名称或缩略语 |
本书中的含义 |
| 物理AI产品 |
physical AI product |
感知物理环境、完成智能判断并产生用户结果的产品 |
| 样本 |
sample |
一次带有时间、通道、单位和状态的传感器读取 |
| 数据窗口 |
data window |
按固定长度和步长组织的一段连续样本 |
| 数据回放 |
data replay |
将已记录的受控数据重新送入同一工程接口 |
| 数据集清单 |
dataset manifest |
记录数据版本、来源、划分、散列值和授权的清单 |
| 模型发布包 |
model package |
模型文件、构建物清单、模型卡、标签、预处理、评价和基准样例的组合 |
| 模型卡 |
model card |
说明模型目的、数据、评价、运行要求、限制和风险的文档 |
| 构建物清单 |
manifest |
记录构建物身份、文件、来源、散列值和兼容性的清单 |
| 基准输入输出 |
golden input and output |
用于检查不同运行环境数值接口是否一致的固定样例 |
| 端侧推理 |
on-device inference |
在设备本地运行模型并得到结果 |
| 事件策略 |
event policy |
将连续模型结果转化为产品事件的平滑、确认和冷却规则 |
| 错报 |
false alarm |
系统在不应产生目标事件时产生了事件 |
| 漏报 |
missed detection |
目标事件发生，但系统没有形成产品事件 |
C.5 硬件、发布与开源
| 中文术语 |
英文名称或缩略语 |
本书中的含义 |
| 物料清单 |
Bill of Materials，BOM |
记录物料、数量、成本、来源、状态和替代方案的清单 |
| 硬件修订 |
hardware revision |
一套确定的器件、连接和设计版本 |
| 适配器 |
adapter |
将具体硬件或服务实现转换为项目稳定接口的组件 |
| 构建物 |
artifact |
由代码和配置产生，能够被验证或发布的文件 |
| 256位安全散列算法 |
Secure Hash Algorithm 256，SHA-256 |
用于核对文件内容是否一致的散列算法 |
| Git大文件存储 |
Git Large File Storage，Git LFS |
由Git保存指针、由独立存储保存大型二进制文件的扩展 |
| 软件物料清单 |
Software Bill of Materials，SBOM |
记录发布软件所含组件、版本、许可证和关系的清单 |
| 软件包数据交换 |
Software Package Data Exchange，SPDX |
用于标准化许可证标识和软件物料信息的规范体系 |
| 开源许可证 |
open-source license |
规定软件或其他材料使用、修改和再分发条件的法律文本 |
| 第三方声明 |
third-party notice |
记录非本项目原创材料的来源、版本、版权和许可证 |
| 可复现构建 |
reproducible build |
从固定版本和环境重新产生对应构建物的过程 |