# Prompt 管理中心

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

## 能力

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

## 唯一来源

Prompt 中心的数据库发布版是运行时唯一来源。系统不提供代码内置 Prompt、初始化 V1 或缺失回退；模板没有当前已发布版本、被停用或版本内容校验失败时，生成任务会明确失败。首个版本应通过部署 SQL 导入，或由管理员在 Prompt 中心创建并发布。

## 数据库升级

按顺序执行：

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`

完成升级后，确认每个正在使用的生成类型都有当前已发布版本。运行时始终读取数据库，不存在切换到代码内置 Prompt 的配置项。

## 结构化上下文契约

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

当前版本通常使用 `context-json:<generateType>:v1`。契约和 Prompt 正文均随后台版本保存；升级前的 `legacy-builder:*` 版本不会触发代码回退，应在 Prompt 中心创建并发布完整的新版本。

## 权限

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

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