# Prompt 管理中心

后台入口为“系统工具 → Prompt 中心”，用于在不重新发布应用的情况下管理 AI Prompt。

## 能力

- 模板管理：以稳定的 `promptCode` 和生成类型标识业务 Prompt。
- 版本管理：System Prompt 与 User Prompt 模板均进入不可变版本，支持发布、退役和回滚，并保存 SHA-256 指纹。
- 模型配置：每个版本独立绑定 Provider 和 Model；调试时也可以临时选择可用网关与模型。
- 在线调试：草稿、已发布和已退役版本均可测试，记录输入、输出、模型、耗时、成功状态和人工评分。
- A/B 测试：同一模板下选择两个不可变版本，用相同输入运行对比，统计成功次数、平均耗时与人工评分。

## 初始化 V1

首次启用后，在 Prompt 中心点击“初始化 V1”。系统会把每个生成类型各自的业务 Prompt 写成 `V1` 并立即发布，包括对应任务、输出格式和业务约束的 System Prompt、Builder 合约、`{{input}}` User Prompt 模板和模型网关配置。

初始化是幂等的：处理完全没有版本的模板；早期由系统生成且内容同质化的唯一 V1 会被安全修复。已有人工草稿、后续版本或实验版本的模板都会跳过，不覆盖后台维护内容。

## 数据库升级

按顺序执行：

1. `sql/factory_prompt_registry.sql`
2. 如果 Prompt 表已在旧版本创建，执行 `sql/factory_prompt_user_template_upgrade.sql`
3. `sql/factory_prompt_lab.sql`
4. `sql/prompt_registry_menu.sql`

然后将 `factory.prompt-registry.database-enabled`（环境变量 `FACTORY_PROMPT_REGISTRY_DATABASE_ENABLED`）设为 `true`，数据库中的已发布版本才会替代内置 Prompt。关闭时仍使用应用内置资源版本作为安全后备。

## 结构化上下文契约

前台 AI 生成入口只向 Prompt Registry 传递 JSON 动态上下文。角色设定、输出格式、字段约束、禁止项和纠错规则均由 Prompt 中心的 System Prompt 与 User Prompt 模板控制，User Prompt 模板必须保留 `{{input}}`。

当前可执行契约使用 `context-json:<generateType>:v1`。升级前发布的 `legacy-builder:*` 版本依赖 Java 内置规则，系统会将其视为过期版本并安全回退到资源模板；需要在 Prompt 中心基于新的 JSON 契约创建并发布新版本，才能重新由数据库版本接管。

## 权限

- `generator:prompt:list/query/add/edit`
- `generator:prompt:version/publish/rollback`
- `generator:prompt:debug`
- `generator:prompt:experiment`

在线调试会真实调用模型并产生费用，也会保存测试输入和输出；生产环境应仅授予可信管理员，并避免输入密钥、个人信息等敏感数据。