API-AI-010：PromptVersion / OutputSchemaVersion 记录字段设计 #171

New Issue

wangdl · 2026-06-10T21:02:30+08:00

wangdl commented

2026-06-10 21:02:30 +08:00

目标

为 AI 分析、题目生成、卡片生成增加 Prompt 版本和输出 Schema 版本追踪能力。

要求

AiRuntimeJob 必须记录 promptVersion。
AiRuntimeJob 必须记录 outputSchemaVersion。
AiRuntimeResult 必须记录 schemaVersion。
ModelInvocationLog 必须记录 promptName / promptVersion / outputSchemaVersion。
AI 分析结果表必须能追溯 promptVersion。
题目 / 卡片产物必须能追溯生成版本。

可选表

第一阶段可以不做完整 PromptTemplate 表，但必须预留字段。

后续可扩展：

PromptTemplate: id, name, version, content, status, createdAt

说明

promptVersion / outputSchemaVersion 字段为后续 Prompt A/B 测试和质量对比预留。本批不实现完整实验框架。

验收标准

所有 Runtime Job 记录 promptVersion。
所有 Runtime Result 记录 schemaVersion。
所有模型调用日志记录 promptName / promptVersion。
后续可以根据版本筛选失败率和质量反馈。
文档说明第一阶段 Prompt 模板实际存放在 Runtime 项目，API 只记录版本。

## 目标为 AI 分析、题目生成、卡片生成增加 Prompt 版本和输出 Schema 版本追踪能力。 ## 要求 1. AiRuntimeJob 必须记录 promptVersion。 2. AiRuntimeJob 必须记录 outputSchemaVersion。 3. AiRuntimeResult 必须记录 schemaVersion。 4. ModelInvocationLog 必须记录 promptName / promptVersion / outputSchemaVersion。 5. AI 分析结果表必须能追溯 promptVersion。 6. 题目 / 卡片产物必须能追溯生成版本。 ## 可选表第一阶段可以不做完整 PromptTemplate 表，但必须预留字段。后续可扩展： PromptTemplate: id, name, version, content, status, createdAt ## 说明 promptVersion / outputSchemaVersion 字段为后续 Prompt A/B 测试和质量对比预留。本批不实现完整实验框架。 ## 验收标准 1. 所有 Runtime Job 记录 promptVersion。 2. 所有 Runtime Result 记录 schemaVersion。 3. 所有模型调用日志记录 promptName / promptVersion。 4. 后续可以根据版本筛选失败率和质量反馈。 5. 文档说明第一阶段 Prompt 模板实际存放在 Runtime 项目，API 只记录版本。

wangdl added this to the M-API-AI-RUNTIME：API AI Runtime 调度与落库 milestone 2026-06-10 21:02:30 +08:00

wangdl added the

labels 2026-06-10 21:02:30 +08:00

wangdl commented

2026-06-11 20:44:36 +08:00

完成证据

产物: prisma/schema.prisma — 各模型中的 promptVersion / outputSchemaVersion / schemaVersion 字段
提交: 6888fe1 feat: AI Runtime Prisma Schema (API-AI-004~010)

覆盖模型:

AiRuntimeJob.promptVersion + outputSchemaVersion
AiRuntimeResult.schemaVersion
ModelInvocationLog.promptName + promptVersion + outputSchemaVersion
AiLearningAnalysis.promptVersion + schemaVersion
Flashcard.promptVersion + schemaVersion

说明: 第一阶段 Prompt 模板存放在 Rust Runtime 项目，API 只记录版本号用于追踪和后续 A/B 测试

## 完成证据 **产物**: `prisma/schema.prisma` — 各模型中的 promptVersion / outputSchemaVersion / schemaVersion 字段 **提交**: `6888fe1` feat: AI Runtime Prisma Schema (API-AI-004~010) **覆盖模型**: - AiRuntimeJob.promptVersion + outputSchemaVersion - AiRuntimeResult.schemaVersion - ModelInvocationLog.promptName + promptVersion + outputSchemaVersion - AiLearningAnalysis.promptVersion + schemaVersion - Flashcard.promptVersion + schemaVersion **说明**: 第一阶段 Prompt 模板存放在 Rust Runtime 项目，API 只记录版本号用于追踪和后续 A/B 测试

wangdl closed this issue

2026-06-11 20:44:37 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wangdl/api-server#171