Files
knowledge-governance/internal/qaopsai/assessment.go
T
姚章浩 87f97a2f9b
build / build (push) Successful in 1m7s
feat(qaops): 完成详情下拉与每周自动保存草稿
详情使用共享主表字典,稀疏修改所选字段并保留原始问答及旧复核审计。
月周统计提供文本和下拉双入口;每租户每周一份持久草稿,按技能六节双语模板真实预填。
加入幂等自动保存、冲突保留、未知响应重试、切周及离开保护和schema58非破坏降级保护。

验证:完整make verify、隔离PostgreSQL全mirror竞态回归、真实恢复库浏览器验收通过。
浏览器实测字段精确读回、月周双输入、模板预填、MD/CSV、自动保存、冲突、失败重试与API重启恢复。
未连接或改写DobotAI生产源库,未运行付费模型;提交时尚未部署。
2026-10-20 05:44:02 +08:00

128 lines
3.6 KiB
Go

package qaopsai
import (
"encoding/json"
"io"
"knowledge-governance/internal/qaopsfields"
"knowledge-governance/internal/strictjson"
"strings"
"unicode/utf8"
)
const DictionaryVersion = "qa-approved-labels-v1"
const EvaluationPromptVersion = "qa-evaluate-evidence-v1"
const TranslationPromptVersion = "qa-question-zh-v1"
var Taxonomy = qaopsfields.ClassificationTaxonomy
func allowedLabel(field, value string) bool {
for _, label := range Taxonomy[field] {
if label == value {
return true
}
}
return field == "root_cause" && value == ""
}
func decodeContract(raw string, target any) error {
if !utf8.ValidString(raw) || len(raw) > 4<<20 {
return ErrInvalid
}
check := json.NewDecoder(strings.NewReader(raw))
if strictjson.Walk(check) != nil {
return ErrInvalid
}
var extra any
if check.Decode(&extra) != io.EOF {
return ErrInvalid
}
decoder := json.NewDecoder(strings.NewReader(raw))
decoder.DisallowUnknownFields()
if decoder.Decode(target) != nil || decoder.Decode(&extra) != io.EOF {
return ErrInvalid
}
return nil
}
type Quote struct {
Source string `json:"source"`
Text string `json:"text"`
ReferenceIndex int `json:"reference_index"`
}
type Reference struct {
Title string `json:"title"`
Excerpt string `json:"excerpt"`
}
type FieldEvaluation struct {
Value string `json:"value"`
Basis string `json:"basis"`
Reason string `json:"reason"`
Quotes []Quote `json:"quotes"`
}
type Assessment struct {
Fields map[string]FieldEvaluation `json:"fields"`
}
type AssessmentInput struct {
Question string `json:"question"`
Answer string `json:"answer"`
References []Reference `json:"references"`
NeededFields []string `json:"needed_fields"`
CurrentCorrectness string `json:"current_correctness"`
}
func DecodeAssessment(raw string, input AssessmentInput) (Assessment, error) {
var out Assessment
if decodeContract(raw, &out) != nil || out.Fields == nil || len(out.Fields) != len(input.NeededFields) {
return out, ErrInvalid
}
needed := map[string]bool{}
for _, field := range input.NeededFields {
if _, ok := Taxonomy[field]; !ok || needed[field] {
return out, ErrInvalid
}
needed[field] = true
}
correctness := input.CurrentCorrectness
if f, ok := out.Fields["is_correct"]; ok {
correctness = f.Value
}
for field, value := range out.Fields {
if !needed[field] || !allowedLabel(field, value.Value) || strings.TrimSpace(value.Reason) == "" || utf8.RuneCountInString(value.Reason) > 2000 || len(value.Quotes) > 8 {
return out, ErrInvalid
}
if value.Basis != "semantic_only" && value.Basis != "reference_evidence" && value.Basis != "insufficient_evidence" {
return out, ErrInvalid
}
if field == "root_cause" && correctness == "是" && value.Value != "" {
return out, ErrInvalid
}
referenceEvidence := false
for _, quote := range value.Quotes {
source := ""
switch quote.Source {
case "question":
source = input.Question
case "answer":
source = input.Answer
case "reference":
if quote.ReferenceIndex < 0 || quote.ReferenceIndex >= len(input.References) {
return out, ErrInvalid
}
source = input.References[quote.ReferenceIndex].Excerpt
referenceEvidence = true
default:
return out, ErrInvalid
}
if strings.TrimSpace(quote.Text) == "" || utf8.RuneCountInString(quote.Text) > 2000 || !strings.Contains(source, quote.Text) {
return out, ErrInvalid
}
}
if value.Basis == "reference_evidence" && !referenceEvidence {
return out, ErrInvalid
}
if field == "is_correct" && value.Value == "是" && value.Basis != "reference_evidence" {
return out, ErrInvalid
}
}
return out, nil
}