什么是 提示词版本管理（Prompt Versioning）？
提示词版本管理（Prompt Versioning）是跟踪提示词源码历史，并用不可变清单把每个大模型行为发布与其运行时依赖绑定的工程实践。
工作原理
提示词版本管理承担两个相关职责。源码版本管理通过 Git 或其他可审查历史记录谁修改了提示词文本、模板、示例、策略和配置；运行时版本管理则标识真正经过评测和部署的行为包，包括模型修订、解码参数、工具 Schema 与授权规则、检索语料和索引、输出 Schema 与解析器、评测数据集、评估器及路由策略。
Prompt Registry 通常提供 staging、production 等可移动环境标签。它们适合发布提升，但应用必须在执行前把标签解析为不可变 Commit，并记录解析结果；否则两个携带相同友好名称的 Run 可能使用不同字节。除 Source Template Digest 外，还要保存最终 Rendered Prompt Digest，因为变量值、Import、本地化和宿主转换都可能改变模型实际输入。
发布记录应被视为 Provenance，而不只是附属 Metadata。它需要说明可部署行为包从哪里来、何时及如何生成、由哪些已审阅 Source 与 Builder 构建，以及核验过哪些 Attestation 或 Approval。Secret 与个人数据不能进入 Manifest，应改存不透明引用并由独立权限控制。可复现回滚需要完整 Manifest Digest、经过校验的 Artifact Byte 和仍可获取的全部固定依赖。
主要特点
- 保留可审查的源码 Diff、作者、批准记录和变更理由
- 区分源码、Registry 解析 Commit、Rendered Prompt 与部署运行时身份
- 用不可变修订或内容摘要固定影响行为的依赖
- 把每个发布候选与数据集、评估器版本和证据连接
- 执行前把可变环境别名解析为不可变 Revision，并记录解析关系
- 支持事故归因和完整依赖回滚
常见用途
- 追踪某次响应由哪套提示词、模型、索引和工具策略产生
- 在评测前通过 Pull Request 审查提示词模板变更
- 根据不可变 Manifest 复现离线回归结果
- 区分提示词编辑与同期模型或检索迁移的影响
- 事故期间恢复已知良好发布包
示例
Loading code...常见问题
只用 Git 做提示词版本管理够吗？
Git 是可靠的源码历史基础，但若没有不可变运行时 Manifest，它无法标识已部署的模型、工具、检索、Schema、数据集、评估器和路由修订。
提示词发布清单应该包含哪些内容？
应包含提示词与模板摘要、模型修订和参数、工具 Schema 与策略、检索快照、输出契约、数据集和评估器修订、源码 Commit 及路由配置。
为什么 latest 指针不算提示词版本？
`latest`、`staging` 或 `production` 都是可变指针，在不同时间可能指向不同制品。执行前应解析为不可变 Commit，同时记录别名与解析值，并在评测、部署、审计和回滚记录中使用解析 Revision 与内容摘要。
评测数据集也要和提示词一起版本化吗？
需要。没有数据集和评估器修订，分数变化可能来自测试变化而非应用行为改进，发布证据也无法复现。
提示词版本管理和 Prompt CI/CD 有什么区别？
版本管理记录源码历史和不可变发布身份；Prompt CI/CD 使用这些身份运行检查、比较证据、批准交付、监控生产并执行回滚。