From 5beff9af07c7febbc70d461c69e00b8f0307dc6b Mon Sep 17 00:00:00 2001
From: yuqei <cyuqei@gmail.com>
Date: Thu, 21 May 2026 20:54:46 +0800
Subject: [PATCH] feat: add quality evaluation center

---
 frontend/src/app/quality-evals/page.tsx       | 472 ++++++++++++++++++
 frontend/src/components/layout/app-topbar.tsx |   2 +
 ...µ·è�‰ä¸Žå®¡æŸ¥åŠ©æ‰‹-当å‰�工作进度ä¿�å­˜-2026-05-11.md |  32 +-
 ...法律文书能力�收开�方案-代�对�检查-2026-05-21.md |  54 +-
 4 files changed, 532 insertions(+), 28 deletions(-)
 create mode 100644 frontend/src/app/quality-evals/page.tsx

diff --git a/frontend/src/app/quality-evals/page.tsx b/frontend/src/app/quality-evals/page.tsx
new file mode 100644
index 00000000..6a7fd930
--- /dev/null
+++ b/frontend/src/app/quality-evals/page.tsx
@@ -0,0 +1,472 @@
+"use client";
+
+import {
+  CheckCircleOutlined,
+  CloseCircleOutlined,
+  ClockCircleOutlined,
+  ExperimentOutlined,
+  FileSearchOutlined,
+  LinkOutlined,
+  PlayCircleOutlined,
+  ReloadOutlined,
+} from "@ant-design/icons";
+import { Alert, Button, Card, Empty, Progress, Select, Space, Statistic, Table, Tag, Typography, message } from "antd";
+import type { ColumnsType } from "antd/es/table";
+import Link from "next/link";
+import { useCallback, useEffect, useMemo, useState } from "react";
+
+import { getPromptAssetDetail, listPromptAssets, runPromptAssetEvaluation } from "@/services/prompt-asset";
+import { useAuthStore } from "@/stores/auth.store";
+import type { PromptAssetDetailResponse, PromptAssetEvaluationRunItem, PromptAssetItem, PromptAssetType } from "@/types/api";
+
+const { Paragraph, Text, Title } = Typography;
+
+const promptTypeOptions: Array<{ value: PromptAssetType | "all"; label: string }> = [
+  { value: "all", label: "全部能力" },
+  { value: "contract_generation", label: "��/文书生�" },
+  { value: "contract_review", label: "��自动审查" },
+  { value: "clause_recommendation", label: "�款推�" },
+  { value: "legal_chat", label: "法规问答" },
+  { value: "wording_rewrite", label: "措辞改写" },
+  { value: "regulation_impact", label: "法规影�分�" },
+];
+
+const evaluationStatusOptions = [
+  { value: "all", label: "全部评测状�" },
+  { value: "passed", label: "评测通过" },
+  { value: "failed", label: "评测失败" },
+  { value: "pending", label: "等待评测" },
+  { value: "not_evaluated", label: "尚未评测" },
+  { value: "blocked", label: "�布�阻" },
+];
+
+const statusOrder: Record<string, number> = {
+  failed: 0,
+  pending: 1,
+  not_evaluated: 2,
+  passed: 3,
+};
+
+function formatDateTime(value?: string | null) {
+  return value ? new Date(value).toLocaleString("zh-CN", { hour12: false }) : "-";
+}
+
+function getPromptTypeLabel(value?: string | null) {
+  return promptTypeOptions.find((item) => item.value === value)?.label ?? value ?? "-";
+}
+
+function getEvaluationLabel(value?: string | null) {
+  if (value === "passed") return "评测通过";
+  if (value === "failed") return "评测失败";
+  if (value === "pending") return "等待评测";
+  return "尚未评测";
+}
+
+function getEvaluationTag(value?: string | null) {
+  if (value === "passed") return <Tag color="green">评测通过</Tag>;
+  if (value === "failed") return <Tag color="red">评测失败</Tag>;
+  if (value === "pending") return <Tag color="gold">等待评测</Tag>;
+  return <Tag color="default">尚未评测</Tag>;
+}
+
+function getPublishTag(item: PromptAssetItem) {
+  if (item.status === "published") return <Tag color="green">已�布</Tag>;
+  if (item.latest_evaluation_status === "passed") return <Tag color="blue">��布</Tag>;
+  return <Tag color="red">�布�阻</Tag>;
+}
+
+function getEvaluationModeLabel(report?: Record<string, unknown> | null) {
+  const mode = typeof report?.evaluation_mode === "string" ? report.evaluation_mode : "";
+  if (mode === "llm") return "��大模型";
+  if (mode === "local_fallback") return "本地兜底";
+  if (mode === "llm_required_not_configured") return "模型未�置";
+  if (mode === "local") return "本地规则";
+  return "未记录";
+}
+
+function getReportNumber(report: Record<string, unknown> | null | undefined, key: string) {
+  const value = report?.[key];
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+
+function getSampleCount(report?: Record<string, unknown> | null) {
+  const sampleCount = getReportNumber(report, "sample_count");
+  if (sampleCount != null) return sampleCount;
+  const sampleResults = report?.sample_results;
+  return Array.isArray(sampleResults) ? sampleResults.length : 0;
+}
+
+function getPassedSamples(report?: Record<string, unknown> | null) {
+  const passed = getReportNumber(report, "passed_samples");
+  if (passed != null) return passed;
+  const sampleResults = report?.sample_results;
+  return Array.isArray(sampleResults) ? sampleResults.filter((item) => Boolean((item as { passed?: unknown }).passed)).length : 0;
+}
+
+function getPassRateFromAsset(item: PromptAssetItem) {
+  const sampleCount = getSampleCount(item.latest_evaluation_report);
+  if (sampleCount > 0) {
+    return Math.round((getPassedSamples(item.latest_evaluation_report) / sampleCount) * 100);
+  }
+  const score = item.latest_evaluation_score;
+  if (typeof score === "number" && Number.isFinite(score)) {
+    return Math.max(0, Math.min(100, Math.round(score)));
+  }
+  return 0;
+}
+
+function sortByRisk(items: PromptAssetItem[]) {
+  return [...items].sort((left, right) => {
+    const leftOrder = statusOrder[left.latest_evaluation_status ?? "not_evaluated"] ?? 2;
+    const rightOrder = statusOrder[right.latest_evaluation_status ?? "not_evaluated"] ?? 2;
+    if (leftOrder !== rightOrder) return leftOrder - rightOrder;
+    return new Date(right.updated_at).getTime() - new Date(left.updated_at).getTime();
+  });
+}
+
+export default function QualityEvalsPage() {
+  const [messageApi, contextHolder] = message.useMessage();
+  const currentUser = useAuthStore((state) => state.currentUser);
+  const [loading, setLoading] = useState(true);
+  const [runningId, setRunningId] = useState<string | null>(null);
+  const [items, setItems] = useState<PromptAssetItem[]>([]);
+  const [promptTypeFilter, setPromptTypeFilter] = useState<PromptAssetType | "all">("all");
+  const [evaluationStatusFilter, setEvaluationStatusFilter] = useState("all");
+  const [selectedDetail, setSelectedDetail] = useState<PromptAssetDetailResponse | null>(null);
+
+  const isAdmin = currentUser?.role === "admin";
+
+  const loadAssets = useCallback(async () => {
+    if (!isAdmin) {
+      setLoading(false);
+      return;
+    }
+    setLoading(true);
+    try {
+      const first = await listPromptAssets(1, 100, promptTypeFilter, "all");
+      if (first.code !== 0) {
+        messageApi.error(first.message || "质�评测数�加载失败");
+        return;
+      }
+      const allItems = [...first.data.items];
+      const totalPages = Math.ceil(first.data.total / first.data.page_size);
+      for (let page = 2; page <= totalPages; page += 1) {
+        const next = await listPromptAssets(page, 100, promptTypeFilter, "all");
+        if (next.code === 0) {
+          allItems.push(...next.data.items);
+        }
+      }
+      setItems(sortByRisk(allItems));
+    } catch (error) {
+      messageApi.error(error instanceof Error ? error.message : "质�评测数�加载失败");
+    } finally {
+      setLoading(false);
+    }
+  }, [isAdmin, messageApi, promptTypeFilter]);
+
+  const loadDetail = useCallback(
+    async (assetId: string) => {
+      try {
+        const result = await getPromptAssetDetail(assetId);
+        if (result.code !== 0) {
+          messageApi.error(result.message || "评测历�加载失败");
+          return null;
+        }
+        setSelectedDetail(result.data);
+        return result.data;
+      } catch (error) {
+        messageApi.error(error instanceof Error ? error.message : "评测历�加载失败");
+        return null;
+      }
+    },
+    [messageApi],
+  );
+
+  useEffect(() => {
+    void loadAssets();
+  }, [loadAssets]);
+
+  const filteredItems = useMemo(() => {
+    if (evaluationStatusFilter === "all") return items;
+    if (evaluationStatusFilter === "blocked") {
+      return items.filter((item) => item.status !== "published" && item.latest_evaluation_status !== "passed");
+    }
+    return items.filter((item) => (item.latest_evaluation_status ?? "not_evaluated") === evaluationStatusFilter);
+  }, [evaluationStatusFilter, items]);
+
+  useEffect(() => {
+    if (!selectedDetail && filteredItems[0]) {
+      void loadDetail(filteredItems[0].id);
+    }
+    if (selectedDetail && !filteredItems.some((item) => item.id === selectedDetail.asset.id)) {
+      setSelectedDetail(null);
+    }
+  }, [filteredItems, loadDetail, selectedDetail]);
+
+  const summary = useMemo(() => {
+    const total = items.length;
+    const passed = items.filter((item) => item.latest_evaluation_status === "passed").length;
+    const failed = items.filter((item) => item.latest_evaluation_status === "failed").length;
+    const pending = items.filter((item) => item.latest_evaluation_status === "pending").length;
+    const notEvaluated = items.filter((item) => !item.latest_evaluation_status || item.latest_evaluation_status === "not_evaluated").length;
+    const publishBlocked = items.filter((item) => item.status !== "published" && item.latest_evaluation_status !== "passed").length;
+    const totalSamples = items.reduce((sum, item) => sum + getSampleCount(item.latest_evaluation_report), 0);
+    const passedSamples = items.reduce((sum, item) => sum + getPassedSamples(item.latest_evaluation_report), 0);
+    return {
+      total,
+      passed,
+      failed,
+      pending,
+      notEvaluated,
+      publishBlocked,
+      samplePassRate: totalSamples > 0 ? Math.round((passedSamples / totalSamples) * 100) : 0,
+    };
+  }, [items]);
+
+  const handleRunEvaluation = async (item: PromptAssetItem) => {
+    setRunningId(item.id);
+    try {
+      const result = await runPromptAssetEvaluation(item.id);
+      if (result.code !== 0) {
+        messageApi.error(result.message || "�行评测失败");
+        return;
+      }
+      messageApi.success(`评测完�：${getEvaluationLabel(result.data.version.evaluation_status)}`);
+      await loadAssets();
+      await loadDetail(item.id);
+    } catch (error) {
+      messageApi.error(error instanceof Error ? error.message : "�行评测失败");
+    } finally {
+      setRunningId(null);
+    }
+  };
+
+  const columns: ColumnsType<PromptAssetItem> = [
+    {
+      title: "评测对象",
+      key: "asset",
+      width: 260,
+      render: (_, item) => (
+        <Space direction="vertical" size={0}>
+          <Text strong>{item.name}</Text>
+          <Text code>{item.prompt_key}</Text>
+          <Text type="secondary">{getPromptTypeLabel(item.prompt_type)}</Text>
+        </Space>
+      ),
+    },
+    {
+      title: "质�门�",
+      key: "gate",
+      width: 160,
+      render: (_, item) => (
+        <Space direction="vertical" size={0}>
+          {getEvaluationTag(item.latest_evaluation_status)}
+          {getPublishTag(item)}
+        </Space>
+      ),
+    },
+    {
+      title: "样本通过率",
+      key: "passRate",
+      width: 180,
+      render: (_, item) => (
+        <Space direction="vertical" size={0} style={{ width: "100%" }}>
+          <Progress percent={getPassRateFromAsset(item)} size="small" status={item.latest_evaluation_status === "failed" ? "exception" : "normal"} />
+          <Text type="secondary">
+            {getPassedSamples(item.latest_evaluation_report)}/{getSampleCount(item.latest_evaluation_report)} �样本
+          </Text>
+        </Space>
+      ),
+    },
+    {
+      title: "执行方�",
+      key: "mode",
+      width: 130,
+      render: (_, item) => <Tag color="blue">{getEvaluationModeLabel(item.latest_evaluation_report)}</Tag>,
+    },
+    {
+      title: "当�版本",
+      key: "version",
+      width: 130,
+      render: (_, item) => (
+        <Space direction="vertical" size={0}>
+          <Text>{item.current_version_label}</Text>
+          <Text type="secondary">{item.version_count} 个版本</Text>
+        </Space>
+      ),
+    },
+    {
+      title: "更新时间",
+      dataIndex: "updated_at",
+      key: "updated_at",
+      width: 180,
+      render: (value: string) => formatDateTime(value),
+    },
+    {
+      title: "�作",
+      key: "actions",
+      width: 260,
+      render: (_, item) => (
+        <Space wrap>
+          <Button icon={<FileSearchOutlined />} size="small" onClick={() => void loadDetail(item.id)}>
+            历�
+          </Button>
+          <Button icon={<PlayCircleOutlined />} loading={runningId === item.id} size="small" type="primary" onClick={() => void handleRunEvaluation(item)}>
+            �行评测
+          </Button>
+          <Button icon={<LinkOutlined />} size="small">
+            <Link href="/prompt-assets">治�</Link>
+          </Button>
+        </Space>
+      ),
+    },
+  ];
+
+  const evaluationRunColumns: ColumnsType<PromptAssetEvaluationRunItem> = [
+    {
+      title: "套件",
+      dataIndex: "suite_key",
+      key: "suite_key",
+      width: 180,
+    },
+    {
+      title: "状�",
+      key: "status",
+      width: 120,
+      render: (_, item) => getEvaluationTag(item.status),
+    },
+    {
+      title: "样本",
+      key: "samples",
+      width: 120,
+      render: (_, item) => `${item.passed_samples}/${item.sample_count}`,
+    },
+    {
+      title: "通过率",
+      key: "pass_rate",
+      width: 140,
+      render: (_, item) => `${Math.round((item.pass_rate ?? 0) * 100)}%`,
+    },
+    {
+      title: "分数",
+      key: "quality_score",
+      width: 100,
+      render: (_, item) => item.quality_score ?? "-",
+    },
+    {
+      title: "执行方�",
+      key: "mode",
+      width: 150,
+      render: (_, item) => <Tag color="blue">{getEvaluationModeLabel(item.report)}</Tag>,
+    },
+    {
+      title: "失败原因",
+      dataIndex: "failure_reason",
+      key: "failure_reason",
+      ellipsis: true,
+      render: (value: string | null) => value ?? "-",
+    },
+    {
+      title: "完�时间",
+      dataIndex: "finished_at",
+      key: "finished_at",
+      width: 180,
+      render: (value: string | null) => formatDateTime(value),
+    },
+  ];
+
+  if (!isAdmin) {
+    return (
+      <main className="page-shell review-history-page">
+        {contextHolder}
+        <Card className="review-list-card">
+          <Alert title="�有管�员�以查看质�评测中心。" type="warning" showIcon />
+        </Card>
+      </main>
+    );
+  }
+
+  return (
+    <main className="page-shell review-page-grid">
+      {contextHolder}
+      <Space direction="vertical" size="large" style={{ width: "100%" }}>
+        <section className="review-page-hero">
+          <div className="review-page-hero-copy">
+            <span className="landing-badge">质�评测中心</span>
+            <Title level={2}>黄金样本评测与�布门�</Title>
+            <Text type="secondary">
+              汇总生��审查�法规问答��款推��措辞改写和法规影�分�的 Prompt 评测结果，把原�分散在 Prompt 治�里的质�状���独立入�。
+            </Text>
+          </div>
+          <Card className="review-side-card" variant="borderless">
+            <span className="landing-panel-eyebrow">Phase15-F</span>
+            <Title level={4} style={{ margin: 0, color: "inherit" }}>
+              �布�质�门�
+            </Title>
+            <Paragraph style={{ color: "inherit", opacity: 0.82, marginBottom: 0 }}>
+              未通过评测的 Prompt �能�布；已�布 Prompt �在治�页继续回滚�下线和查看�行��。
+            </Paragraph>
+          </Card>
+        </section>
+
+        <div style={{ display: "grid", gridTemplateColumns: "repeat(auto-fit, minmax(180px, 1fr))", gap: 12 }}>
+          <Card>
+            <Statistic title="评测对象" value={summary.total} prefix={<ExperimentOutlined />} />
+          </Card>
+          <Card>
+            <Statistic title="通过门�" value={summary.passed} prefix={<CheckCircleOutlined />} valueStyle={{ color: "#237804" }} />
+          </Card>
+          <Card>
+            <Statistic title="失败或待处�" value={summary.failed + summary.pending + summary.notEvaluated} prefix={<CloseCircleOutlined />} valueStyle={{ color: "#a8071a" }} />
+          </Card>
+          <Card>
+            <Statistic title="�布�阻" value={summary.publishBlocked} prefix={<ClockCircleOutlined />} valueStyle={{ color: "#ad6800" }} />
+          </Card>
+          <Card>
+            <Statistic title="样本通过率" value={summary.samplePassRate} suffix="%" prefix={<CheckCircleOutlined />} />
+          </Card>
+        </div>
+
+        <Card>
+          <Space direction="vertical" size="middle" style={{ width: "100%" }}>
+            <Space wrap>
+              <Select style={{ width: 190 }} options={promptTypeOptions} value={promptTypeFilter} onChange={(value) => setPromptTypeFilter(value)} />
+              <Select style={{ width: 170 }} options={evaluationStatusOptions} value={evaluationStatusFilter} onChange={setEvaluationStatusFilter} />
+              <Button icon={<ReloadOutlined />} loading={loading} onClick={() => void loadAssets()}>
+                刷新
+              </Button>
+              <Button icon={<LinkOutlined />}>
+                <Link href="/prompt-assets">进入 Prompt 治�</Link>
+              </Button>
+            </Space>
+
+            <Table
+              columns={columns}
+              dataSource={filteredItems}
+              loading={loading}
+              locale={{ emptyText: <Empty description="暂无质�评测对象" /> }}
+              pagination={{ pageSize: 10, showSizeChanger: true }}
+              rowKey="id"
+            />
+          </Space>
+        </Card>
+
+        <Card title={selectedDetail ? `${selectedDetail.asset.name} 评测历�` : "评测历�"}>
+          {selectedDetail ? (
+            <Space direction="vertical" size="middle" style={{ width: "100%" }}>
+              <Alert
+                message="当�版本质�状�"
+                description={`${selectedDetail.asset.current_version_label}：${getEvaluationLabel(selectedDetail.asset.latest_evaluation_status)}，执行方�：${getEvaluationModeLabel(selectedDetail.asset.latest_evaluation_report)}。`}
+                type={selectedDetail.asset.latest_evaluation_status === "passed" ? "success" : "warning"}
+                showIcon
+              />
+              <Table columns={evaluationRunColumns} dataSource={selectedDetail.evaluation_runs} pagination={false} rowKey="id" size="small" />
+            </Space>
+          ) : (
+            <Empty description="请选择一个评测对象查看历�" />
+          )}
+        </Card>
+      </Space>
+    </main>
+  );
+}
diff --git a/frontend/src/components/layout/app-topbar.tsx b/frontend/src/components/layout/app-topbar.tsx
index cbd0513f..48ef81b9 100644
--- a/frontend/src/components/layout/app-topbar.tsx
+++ b/frontend/src/components/layout/app-topbar.tsx
@@ -10,6 +10,7 @@ import {
   DashboardOutlined,
   DeploymentUnitOutlined,
   DownOutlined,
+  ExperimentOutlined,
   FileDoneOutlined,
   FileTextOutlined,
   FileSearchOutlined,
@@ -87,6 +88,7 @@ const adminNavItems = [
   { href: "/templates", label: "模�管�", icon: <BookOutlined /> },
   { href: "/knowledge-bases", label: "知识库管�", icon: <FolderOpenOutlined /> },
   { href: "/prompt-assets", label: "Prompt 治�", icon: <CodeOutlined /> },
+  { href: "/quality-evals", label: "质�评测", icon: <ExperimentOutlined /> },
   { href: "/legal-change-impacts", label: "法规影�分�", icon: <AlertOutlined /> },
   { href: "/operation-kpis", label: "�� KPI", icon: <BarChartOutlined /> },
   { href: "/sales-followups", label: "销售跟进", icon: <PhoneOutlined /> },
diff --git a/project-docs/AI��起�与审查助手-当�工作进度�存-2026-05-11.md b/project-docs/AI��起�与审查助手-当�工作进度�存-2026-05-11.md
index 65d103e6..1742da68 100644
--- a/project-docs/AI��起�与审查助手-当�工作进度�存-2026-05-11.md
+++ b/project-docs/AI��起�与审查助手-当�工作进度�存-2026-05-11.md
@@ -4211,7 +4211,7 @@
 - 本轮核对结论：
   - Phase15-A 到 Phase15-H 的主线开�已�在代�层闭环。
   - `/clauses/apply` 未�独实现，但�款推�和改写结果已�通过 `/documents/[id]/edit` 编辑器写入��正文并生� `generated_contract_versions`，属于等价闭环。
-  - `/quality-evals` 未�独实现，当�评测入�集中在 `/prompt-assets`，已能支撑 Prompt �布�评测门�；如��统一质�中心，�续��独补页�和通用评测表。
+  - `/quality-evals` 在本轮核对当时尚未�独实现，评测入�集中在 `/prompt-assets`；该缺�已在�续“Phase15-F 独立质�评测中心 `/quality-evals` 本地闭环�中补�。
   - 法规影�分�代�统一使用 `/legal-change-impacts`�`legal_change_events`�`legal_change_impacts` 命�，�续文档应以此为准。
 - 本轮验�：
   - `$env:PYTHONPATH='backend'; python -m unittest backend.tests.test_legal_document_type_service backend.tests.test_legal_document_types_api backend.tests.test_legal_document_element_schema_service backend.tests.test_legal_document_element_schemas_api backend.tests.test_legal_document_draft_service backend.tests.test_legal_document_drafts_api backend.tests.test_contracts_api backend.tests.test_review_risk_action_service backend.tests.test_review_risk_actions_api backend.tests.test_clause_recommendation_service backend.tests.test_clauses_api backend.tests.test_prompt_asset_service backend.tests.test_prompt_assets_api backend.tests.test_prompt_runtime_service backend.tests.test_legal_change_impact_service backend.tests.test_legal_change_impacts_api backend.tests.test_operation_kpi_service backend.tests.test_operation_kpis_api`
@@ -4223,7 +4223,7 @@
 - 剩余边界：
   - 当��有 Phase15-C�Phase15-F�Phase15-G 相关未�交改动，需��续统一整��交。
   - 最新代�尚未部署到 `192.168.3.90` �真实库烟测。
-  - 专业富文本库�字段级 diff�独立 `/quality-evals`�全�法规��化�真实微信或支付�支付�电�签章和�程��属于�续增强，�是当�法律文书能力�收主线阻塞。
+  - 专业富文本库�字段级 diff�全�法规��化�真实微信或支付�支付�电�签章和�程��属于�续增强，�是当�法律文书能力�收主线阻塞；独立 `/quality-evals` 已在�续闭环中补�。
 
 ## 2026-05-21 Phase15-C/F/G �交推�与 3.90 真实库烟测闭环
 
@@ -4270,6 +4270,32 @@
   - 远程真实 PostgreSQL 已在 `20260521_0038 (head)`。
   - 法规影� worker 已在测试�务器常驻�行，并通过真实库临时事件消费烟测。
 - 剩余边界：
-  - 本轮没有� `/quality-evals` 独立质�中心。
+  - 本轮当时没有� `/quality-evals` 独立质�中心；该项已在�续“Phase15-F 独立质�评测中心 `/quality-evals` 本地闭环�中补�。
   - 本轮没有�全�法规��化。
   - 本轮没有接入真实微信或支付�支付。
+
+## 2026-05-21 Phase15-F 独立质�评测中心 `/quality-evals` 本地闭环
+
+- 已按《AI��起�与审查助手-法律文书能力�收开�方案-2026-05-20.md》补�文档�到的独立质�评测产�入�。
+- 本轮新增�端页�：
+  - `frontend/src/app/quality-evals/page.tsx`
+  - 管�员��新增“质�评测�，入��于 `frontend/src/components/layout/app-topbar.tsx`。
+- 当�实现�径：
+  - �新增��的质�评测�端模型，继续以 `prompt_assets`�`prompt_asset_versions`�`prompt_asset_evaluation_runs` 作为黄金样本评测真相�。
+  - `/quality-evals` 负责��生��审查�法规问答��款推��措辞改写�法规影�分�等 Prompt 类型的评测状�。
+  - 页�支�按能力类型�评测状���布�阻筛选。
+  - 页�展示评测对象�质�门��样本通过率�执行方��当�版本�更新时间和评测历�。
+  - 页��直接触� Prompt 黄金样本评测，并�跳转 `/prompt-assets` ��布�下线�回滚和�行��治�。
+- 已更新代�对�检查报告：
+  - `project-docs/AI��起�与审查助手-法律文书能力�收开�方案-代�对�检查-2026-05-21.md`
+  - 旧结论“没有独立 `/quality-evals` 页��已改为“独立入�已闭环�。
+- 本地验�：
+  - `cd frontend; npx eslint "src/app/quality-evals/page.tsx" "src/components/layout/app-topbar.tsx"`
+  - `cd frontend; npm run build`
+  - 构建结果：`Compiled successfully`，��页�生� `40/40`，路由清�包� `/quality-evals`。
+- 当�闭环结论：
+  - 文档�到的“独立 `/quality-evals` 页��已�完�本地开�闭环。
+  - Phase15-F 现在形�“Prompt 治�评测真相� -> `/quality-evals` 独立质�入� -> �行评测 -> 查看历� -> �布门� -> 回到 Prompt 治��的产�入�闭环。
+- 剩余边界：
+  - 本轮暂未新增通用 `ai_quality_eval_runs/items` 表；该表�在未��把� Prompt 质�评测也��独立�端领域时�补。
+  - 下一步需��交推�，并部署到 `192.168.3.90` �访问 `/quality-evals` ��端路由烟测。
diff --git a/project-docs/AI��起�与审查助手-法律文书能力�收开�方案-代�对�检查-2026-05-21.md b/project-docs/AI��起�与审查助手-法律文书能力�收开�方案-代�对�检查-2026-05-21.md
index 834e2e95..1b0859eb 100644
--- a/project-docs/AI��起�与审查助手-法律文书能力�收开�方案-代�对�检查-2026-05-21.md
+++ b/project-docs/AI��起�与审查助手-法律文书能力�收开�方案-代�对�检查-2026-05-21.md
@@ -15,11 +15,11 @@
 
 当�代�已�覆盖 Phase15-A 到 Phase15-H 的主线开�闭环。也就是说，文书类型入��动��素表���稿�存���生�接��级�审查建议采纳��款推�与行业惯例�富文本编辑器和 AI 侧边��Prompt 治��黄金样本评测�法规影�扫���� KPI 与商业化增强，�已在代�层形���行闭环。
 
-但�有三类事项需�分开看：
+截至本轮独立质�评测中心收��，�有三类事项需�分开看：
 
-1. 已开�但待�交或待部署验�：当�工作区存在 Phase15-C�Phase15-F�Phase15-G 的未�交改动，且最新 worker 和语义扫�未在 `192.168.3.90` �远程部署烟测。
-2. 文档建议路径与代�等价实现��：例如文档建议 `/quality-evals` 和 `/clauses/apply`，当�分别�在 `/prompt-assets` 评测历�和��编辑器版本链中。
-3. �续增强项：专业富文本库�字段级差异对比�独立质�评测中心�全�法规��化�真实微信或支付�支付�电�签章��程�等�属于当� Phase15 主线硬阻塞。
+1. 本轮新增 `/quality-evals` 独立页�，�新增数�库�移，继续�用 Prompt 评测�行记录作为质�评测真相�。
+2. 文档建议路径与代���留一个等价实现差异：文档建议 `/clauses/apply`，当��在��编辑器版本链中；`/quality-evals` 已补�独立产�入�。
+3. �续增强项：专业富文本库�字段级差异对比�通用 `ai_quality_eval_runs/items`�全�法规��化�真实微信或支付�支付�电�签章��程�等�属于当� Phase15 主线硬阻塞。
 
 ## 三��阶段对�表
 
@@ -39,7 +39,7 @@
 | LAW-CLAUSE-002 | 措辞优化 | 支�专业化�简化��甲方��乙方��衡等改写模�，返回法律边界和谈判建议 | 已闭环 |
 | Phase15-D | 富文本编辑器与 AI 侧边� | `/documents/[id]/edit` 支�正文编辑�自动�存�版本历���款推��措辞改写�相关法�和 Chat 入� | 主线已闭环 |
 | Phase15-E | Prompt 资产治� | `/prompt-assets` 支� Prompt 类型�版本�评测��布�下线�回滚和�行�� | 已闭环 |
-| Phase15-F | 黄金样本与质�评测 | 已有 Prompt 评测�行记录���黄金样本报告��布�门�和�端评测历� | 已闭环 |
+| Phase15-F | 黄金样本与质�评测 | 已有 Prompt 评测�行记录���黄金样本报告��布�门��`/prompt-assets` 治�入�和 `/quality-evals` 独立质�评测中心 | 已闭环 |
 | Phase15-G | 法规�更影�分� | 已有法��更入队�结构化和语义影�扫��影�项�页���� worker 和 Docker �务 | 已闭环 |
 | Phase15-H | �� KPI 与商业化增强 | `/operation-kpis` 已展示用��文书生��审查�Chat�模���款采纳�试用和转化指标；计费��票状��销售跟进已有业务闭环 | 主线已闭环 |
 
@@ -83,6 +83,7 @@
 - ��编辑器和 AI 侧边�：`frontend/src/app/documents/[id]/edit/page.tsx`
 - 审查建议处�：`frontend/src/app/reviews/[id]/page.tsx`
 - Prompt 治�：`frontend/src/app/prompt-assets/page.tsx`
+- 质�评测中心：`frontend/src/app/quality-evals/page.tsx`
 - 法规影�分�：`frontend/src/app/legal-change-impacts/page.tsx`
 - �� KPI：`frontend/src/app/operation-kpis/page.tsx`
 - 销售跟进：`frontend/src/app/sales-followups/page.tsx`
@@ -108,14 +109,15 @@
 
 ### 5.2 `/quality-evals`
 
-文档建议新增独立 `/quality-evals` 页�。当�代�没有这个独立路由，质�评测�在 `/prompt-assets` 中：
+文档建议新增独立 `/quality-evals` 页�。本轮已�补�独立路由，并��评测数�真相����：
 
-- Prompt 详情页�以�行评测。
-- 评测结果回填当�版本。
-- �布按钮�评测状�约�。
-- 评测�行历��以追溯。
+- `/quality-evals` ��生��审查�法规问答��款推��措辞改写�法规影�分�等 Prompt 类型的评测状�。
+- 页�支�按 Prompt 类型�评测状�和“�布�阻�筛选。
+- 页�展示评测对象�质�门��样本通过率�执行方��版本�更新时间和评测历�。
+- 页��直接触� `POST /api/v1/prompt-assets/{asset_id}/evaluations/run` �新�行黄金样本评测。
+- 页��留跳转 `/prompt-assets` 的治�入�，�布�下线�回滚和�行���由 Prompt 治�承接。
 
-这对“Prompt �布�黄金样本评测门��已�闭环。但如果��跨生��审查�Chat��款推��法规影�的统一质�中心，�建议�续补独立 `/quality-evals`。
+因此，“文档�求独立质�评测产�入��已�闭环；�续�有在需�把� Prompt 质�评测也沉淀为独立领域模型时，�需��补通用 `ai_quality_eval_runs/items` 表。
 
 ### 5.3 `regulation-changes`
 
@@ -131,19 +133,20 @@
 
 ### 6.1 待�交和待部署验�
 
-当�工作区存在未�交改动，主�集中在：
+Phase15-C�Phase15-F�Phase15-G 已完��交�推�和 `192.168.3.90` 真实库烟测，详�当�工作进度�存文档。
 
-- Phase15-C 行业惯例推�。
-- Phase15-F 真实黄金样本��评测。
-- Phase15-G 法规影�语义扫�和�� worker。
-
-这些代�本地测试已通过，但尚未�交远程 Git，也未在 `192.168.3.90` �新部署��真实库烟测。
+本轮新增 `/quality-evals` �涉� Alembic �移或�端�务�更。完��交�，�需�部署�端并访问 `/quality-evals` �页�烟测。
 
 ### 6.2 独立质�评测中心
 
-当�评测能力已�在 Prompt 治�内闭环，但没有独立 `/quality-evals` 页�，也没有通用 `ai_quality_eval_runs/items` 表承接所有质�评测类型。
+独立 `/quality-evals` 页�已�补�，当�闭环采用“独立页� + �用 Prompt 评测真相��的方�：
 
-这�是 Prompt �布门�阻塞项，但属于文档和产�形�的一个剩余增强点。
+- �端入�：`frontend/src/app/quality-evals/page.tsx`。
+- ��入�：管�员��“质�评测�。
+- 数���：`prompt_assets`�`prompt_asset_versions`�`prompt_asset_evaluation_runs`。
+- 执行动作：�用 Prompt 资产评测接��新�行黄金样本评测。
+
+当��未�独新增通用 `ai_quality_eval_runs/items` 表。这个表属于�续“跨 Prompt�跨业务对象的统一质�评测域�增强，�影� Phase15-F 的产�入�闭环。
 
 ### 6.3 专业级富文本增强
 
@@ -194,7 +197,7 @@ OK
 命令：
 
 ```powershell
-npx eslint "src/app/documents/new/page.tsx" "src/app/documents/new/[type]/page.tsx" "src/app/documents/[id]/edit/page.tsx" "src/app/prompt-assets/page.tsx" "src/app/legal-change-impacts/page.tsx" "src/app/operation-kpis/page.tsx" "src/components/layout/app-topbar.tsx" "src/types/api.ts"
+npx eslint "src/app/documents/new/page.tsx" "src/app/documents/new/[type]/page.tsx" "src/app/documents/[id]/edit/page.tsx" "src/app/prompt-assets/page.tsx" "src/app/quality-evals/page.tsx" "src/app/legal-change-impacts/page.tsx" "src/app/operation-kpis/page.tsx" "src/components/layout/app-topbar.tsx" "src/types/api.ts"
 ```
 
 结果：通过，无错误输出。
@@ -211,7 +214,7 @@ npm run build
 
 ```text
 Compiled successfully
-Generating static pages (39/39)
+Generating static pages (40/40)
 ```
 
 构建路由中已包�：
@@ -220,6 +223,7 @@ Generating static pages (39/39)
 - `/documents/new/[type]`
 - `/documents/[id]/edit`
 - `/prompt-assets`
+- `/quality-evals`
 - `/legal-change-impacts`
 - `/operation-kpis`
 - `/sales-followups`
@@ -228,9 +232,9 @@ Generating static pages (39/39)
 
 为了让文档和代�彻底闭�，建议下一步��继续堆新功能，先按这个顺�收�：
 
-1. 整�并�交当� Phase15-C�Phase15-F�Phase15-G 的代�和文档改动。
-2. 如果本阶段�求“文档路径和产�入�完全一致�，补独立 `/quality-evals` 质�评测中心，把 `/prompt-assets` 中的评测历���过去。
+1. �交并推�本轮 `/quality-evals` 页�和文档更新。
+2. 部署�端到 `192.168.3.90`，访问 `/quality-evals` �页�烟测。
 3. 统一文档命�，把法规影�分�的接��称固定为 `/legal-change-impacts`，���续误认为还缺 `/regulation-changes`。
-4. 等决定部署时，在 `192.168.3.90` 执行最新 Alembic，并�用 `legal-change-impact-worker` �务�真实库烟测。
+4. 如未���更宽的统一质�平�，�补通用 `ai_quality_eval_runs/items` 和� Prompt 质�评测对象。
 
-按当�代�状�判断，《法律文书能力�收开�方案》的主线开�没有跑�，已�基本完�。真正剩下的是�交�部署验��独立质�中心和若干生产级增强。
+按当�代�状�判断，《法律文书能力�收开�方案》的主线开�没有跑�，已�基本完�。`/quality-evals` 独立入�补��，真正剩下的是若干生产级增强，而�是 Phase15 主线功能缺�。