yidaima/RuoYi-Vue/docs/prompt-management-center.md

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

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