From eddc53d043186e4ebe7f231989a1982583bbd362 Mon Sep 17 00:00:00 2001
From: yuqei <cyuqei@gmail.com>
Date: Fri, 15 May 2026 13:30:58 +0800
Subject: [PATCH] feat: connect knowledge base publish workflow UI

---
 frontend/src/app/knowledge-bases/page.tsx     | 213 +++++++++++++++++-
 frontend/src/services/knowledge-base.ts       |  27 +++
 frontend/src/types/api.ts                     |  22 ++
 ...µ·è�‰ä¸Žå®¡æŸ¥åŠ©æ‰‹-当å‰�工作进度ä¿�å­˜-2026-05-11.md |  58 ++++-
 .../governance-productization-backlog.csv     |   2 +-
 5 files changed, 308 insertions(+), 14 deletions(-)

diff --git a/frontend/src/app/knowledge-bases/page.tsx b/frontend/src/app/knowledge-bases/page.tsx
index e1c4f6f6..8c71c5a4 100644
--- a/frontend/src/app/knowledge-bases/page.tsx
+++ b/frontend/src/app/knowledge-bases/page.tsx
@@ -6,9 +6,19 @@ import { Alert, Button, Card, Empty, Form, Input, List, Select, Space, Table, Ta
 import type { UploadFile } from "antd/es/upload/interface";
 import { useCallback, useEffect, useMemo, useState } from "react";
 
-import { createKnowledgeBase, listKnowledgeBaseDocuments, listKnowledgeBases, retryKnowledgeBaseDocument, uploadKnowledgeBaseDocument } from "@/services/knowledge-base";
+import {
+  createKnowledgeBase,
+  listKnowledgeBaseDocuments,
+  listKnowledgeBaseVersions,
+  listKnowledgeBases,
+  publishKnowledgeBase,
+  retryKnowledgeBaseDocument,
+  rollbackKnowledgeBase,
+  unpublishKnowledgeBase,
+  uploadKnowledgeBaseDocument,
+} from "@/services/knowledge-base";
 import { useAuthStore } from "@/stores/auth.store";
-import type { KnowledgeBaseDocumentItem, KnowledgeBaseItem } from "@/types/api";
+import type { KnowledgeBaseDocumentItem, KnowledgeBaseItem, KnowledgeBaseVersionItem } from "@/types/api";
 
 const { Dragger } = Upload;
 const { Title, Text } = Typography;
@@ -23,6 +33,10 @@ type KnowledgeBaseFormValues = {
   region?: string;
   tags?: string;
 };
+type KnowledgeBaseRollbackFormValues = {
+  target_version_label: string;
+  change_summary?: string;
+};
 
 const DOCUMENT_STATUS_META: Record<string, { color: string; label: string }> = {
   pending: { color: "gold", label: "待处�" },
@@ -91,6 +105,20 @@ function getRetrievalModeMeta(value: string | null | undefined) {
   return { color: "default", label: value || "Default" };
 }
 
+function getKnowledgeBaseStatusMeta(value: string | null | undefined) {
+  const normalized = (value || "").toLowerCase();
+  if (normalized === "active") {
+    return { color: "green", label: "已�布" };
+  }
+  if (normalized === "archived") {
+    return { color: "default", label: "已下线" };
+  }
+  if (normalized === "draft") {
+    return { color: "gold", label: "�稿" };
+  }
+  return { color: "blue", label: value || "未命�状�" };
+}
+
 function getErrorMessage(error: unknown, fallback: string) {
   return error instanceof Error && error.message ? error.message : fallback;
 }
@@ -170,9 +198,13 @@ export default function KnowledgeBasesPage() {
   const currentUser = useAuthStore((state) => state.currentUser);
   const [createForm] = Form.useForm<KnowledgeBaseFormValues>();
   const [uploadForm] = Form.useForm<KnowledgeBaseFormValues>();
+  const [rollbackForm] = Form.useForm<KnowledgeBaseRollbackFormValues>();
   const [loading, setLoading] = useState(true);
   const [submitting, setSubmitting] = useState(false);
   const [uploading, setUploading] = useState(false);
+  const [publishing, setPublishing] = useState(false);
+  const [unpublishing, setUnpublishing] = useState(false);
+  const [rollingBack, setRollingBack] = useState(false);
   const [refreshingDocuments, setRefreshingDocuments] = useState(false);
   const [retryingDocumentId, setRetryingDocumentId] = useState<string | null>(null);
   const [listError, setListError] = useState<string | null>(null);
@@ -180,6 +212,8 @@ export default function KnowledgeBasesPage() {
   const [items, setItems] = useState<KnowledgeBaseItem[]>([]);
   const [selectedId, setSelectedId] = useState<string | null>(null);
   const [documents, setDocuments] = useState<KnowledgeBaseDocumentItem[]>([]);
+  const [versions, setVersions] = useState<KnowledgeBaseVersionItem[]>([]);
+  const [versionsLoading, setVersionsLoading] = useState(false);
   const [sourceTypeFilter, setSourceTypeFilter] = useState<string>("all");
   const [regionFilter, setRegionFilter] = useState<string>("all");
   const [documentsLoading, setDocumentsLoading] = useState(false);
@@ -224,6 +258,16 @@ export default function KnowledgeBasesPage() {
     return [{ value: "all", label: "全部适用区域" }, ...values.map((value) => ({ value, label: value }))];
   }, [documents]);
 
+  const selectedKnowledgeBaseStatus = getKnowledgeBaseStatusMeta(selectedKnowledgeBase?.status);
+  const rollbackVersionOptions = useMemo(
+    () =>
+      versions.map((item) => ({
+        value: item.version_label,
+        label: `${item.version_label} · ${item.status}`,
+      })),
+    [versions],
+  );
+
   const loadKnowledgeBases = useCallback(async () => {
     if (currentUser?.role !== "admin") {
       setLoading(false);
@@ -283,6 +327,29 @@ export default function KnowledgeBasesPage() {
     }
   }, [messageApi]);
 
+  const loadVersions = useCallback(async (knowledgeBaseId: string) => {
+    setVersionsLoading(true);
+    try {
+      const result = await listKnowledgeBaseVersions(knowledgeBaseId);
+      if (result.code !== 0) {
+        messageApi.error(result.message || "获�知识库版本失败");
+        setVersions([]);
+        rollbackForm.resetFields(["target_version_label", "change_summary"]);
+        return;
+      }
+      setVersions(result.data);
+      rollbackForm.setFieldsValue({
+        target_version_label: result.data[0]?.version_label,
+      });
+    } catch (error: unknown) {
+      messageApi.error(getErrorMessage(error, "获�知识库版本失败，请���试"));
+      setVersions([]);
+      rollbackForm.resetFields(["target_version_label", "change_summary"]);
+    } finally {
+      setVersionsLoading(false);
+    }
+  }, [messageApi, rollbackForm]);
+
   useEffect(() => {
     const timer = window.setTimeout(() => {
       void loadKnowledgeBases();
@@ -296,14 +363,15 @@ export default function KnowledgeBasesPage() {
       if (!selectedId || currentUser?.role !== "admin") {
         setDocuments([]);
         setDocumentsError(null);
+        setVersions([]);
         return;
       }
 
-      void loadDocuments(selectedId);
+      void Promise.all([loadDocuments(selectedId), loadVersions(selectedId)]);
     }, 0);
 
     return () => window.clearTimeout(timer);
-  }, [currentUser?.role, loadDocuments, selectedId]);
+  }, [currentUser?.role, loadDocuments, loadVersions, selectedId]);
 
   useEffect(() => {
     if (!selectedId || currentUser?.role !== "admin") {
@@ -421,6 +489,74 @@ export default function KnowledgeBasesPage() {
     }
   };
 
+  const handlePublishKnowledgeBase = async () => {
+    if (!selectedId) {
+      return;
+    }
+    setPublishing(true);
+    try {
+      const result = await publishKnowledgeBase(selectedId);
+      if (result.code !== 0) {
+        messageApi.error(result.message || "�布知识库失败");
+        return;
+      }
+      messageApi.success("知识库已�布");
+      await Promise.all([loadKnowledgeBases(), loadVersions(selectedId)]);
+    } catch (error: unknown) {
+      messageApi.error(getErrorMessage(error, "�布知识库失败，请���试"));
+    } finally {
+      setPublishing(false);
+    }
+  };
+
+  const handleUnpublishKnowledgeBase = async () => {
+    if (!selectedId) {
+      return;
+    }
+    setUnpublishing(true);
+    try {
+      const result = await unpublishKnowledgeBase(selectedId);
+      if (result.code !== 0) {
+        messageApi.error(result.message || "下线知识库失败");
+        return;
+      }
+      messageApi.success("知识库已下线");
+      await Promise.all([loadKnowledgeBases(), loadVersions(selectedId)]);
+    } catch (error: unknown) {
+      messageApi.error(getErrorMessage(error, "下线知识库失败，请���试"));
+    } finally {
+      setUnpublishing(false);
+    }
+  };
+
+  const handleRollbackKnowledgeBase = async () => {
+    if (!selectedId) {
+      return;
+    }
+    const values = await rollbackForm.validateFields();
+    setRollingBack(true);
+    try {
+      const result = await rollbackKnowledgeBase(selectedId, {
+        target_version_label: values.target_version_label,
+        change_summary: values.change_summary?.trim() || undefined,
+      });
+      if (result.code !== 0) {
+        messageApi.error(result.message || "回滚知识库失败");
+        return;
+      }
+      messageApi.success(`知识库已回滚到 ${values.target_version_label}`);
+      await Promise.all([loadKnowledgeBases(), loadVersions(selectedId)]);
+    } catch (error: unknown) {
+      if (error instanceof Error && error.message === "Validation failed") {
+        setRollingBack(false);
+        return;
+      }
+      messageApi.error(getErrorMessage(error, "回滚知识库失败，请���试"));
+    } finally {
+      setRollingBack(false);
+    }
+  };
+
   if (currentUser?.role !== "admin") {
     return (
       <main className="page-shell review-history-page">
@@ -514,6 +650,75 @@ export default function KnowledgeBasesPage() {
           </Space>
 
           <Space direction="vertical" size="middle" style={{ width: "100%" }}>
+            <Card className="review-surface-card" title="�布治�">
+              <Space direction="vertical" size="middle" style={{ width: "100%" }}>
+                {selectedKnowledgeBase ? (
+                  <>
+                    <Space wrap size={[8, 8]}>
+                      <Tag color={selectedKnowledgeBaseStatus.color}>{selectedKnowledgeBaseStatus.label}</Tag>
+                      <Tag color={getRetrievalModeMeta(selectedKnowledgeBase.retrieval_mode).color}>
+                        {getRetrievalModeMeta(selectedKnowledgeBase.retrieval_mode).label}
+                      </Tag>
+                      {selectedKnowledgeBase.current_version_label ? <Tag>当�版本 {selectedKnowledgeBase.current_version_label}</Tag> : null}
+                    </Space>
+                    <Text>{selectedKnowledgeBase.description || "当�知识库暂无说明。"}</Text>
+                    <Space direction="vertical" size={4}>
+                      <Text type="secondary">�布人：{selectedKnowledgeBase.published_by || "-"}</Text>
+                      <Text type="secondary">�布时间：{selectedKnowledgeBase.published_at ? formatDateTime(selectedKnowledgeBase.published_at) : "-"}</Text>
+                    </Space>
+                    <Space wrap>
+                      <Button type="primary" loading={publishing} onClick={() => void handlePublishKnowledgeBase()}>
+                        �布知识库
+                      </Button>
+                      <Button loading={unpublishing} onClick={() => void handleUnpublishKnowledgeBase()}>
+                        下线知识库
+                      </Button>
+                    </Space>
+                    <Form form={rollbackForm} layout="vertical">
+                      <Form.Item label="回滚到版本" name="target_version_label" rules={[{ required: true, message: "请选择目标版本" }]}>
+                        <Select
+                          placeholder="选择历�版本"
+                          loading={versionsLoading}
+                          options={rollbackVersionOptions}
+                          disabled={!rollbackVersionOptions.length}
+                        />
+                      </Form.Item>
+                      <Form.Item label="回滚说明" name="change_summary">
+                        <Input placeholder="例如：��到稳定知识库版本" />
+                      </Form.Item>
+                    </Form>
+                    <Button loading={rollingBack} disabled={!rollbackVersionOptions.length} onClick={() => void handleRollbackKnowledgeBase()}>
+                      回滚知识库
+                    </Button>
+                    <List
+                      header="版本历�"
+                      loading={versionsLoading}
+                      locale={{ emptyText: "当�知识库还没有�布历�。" }}
+                      dataSource={versions}
+                      renderItem={(item) => (
+                        <List.Item>
+                          <Space direction="vertical" size={2} style={{ width: "100%" }}>
+                            <Space wrap size={[8, 8]}>
+                              <Text strong>{item.version_label}</Text>
+                              <Tag color={getKnowledgeBaseStatusMeta(item.status).color}>{getKnowledgeBaseStatusMeta(item.status).label}</Tag>
+                            </Space>
+                            <Text type="secondary">{item.change_summary || "无�更说明"}</Text>
+                            <Text type="secondary">
+                              {item.published_at ? formatDateTime(item.published_at) : formatDateTime(item.created_at)}
+                              {" · "}
+                              {item.published_by || "-"}
+                            </Text>
+                          </Space>
+                        </List.Item>
+                      )}
+                    />
+                  </>
+                ) : (
+                  <Alert showIcon type="info" message="请先从左侧选择知识库，�进行�布�下线或回滚。" />
+                )}
+              </Space>
+            </Card>
+
             <Card className="review-surface-card" title="上传文档">
               <Space direction="vertical" size="middle" style={{ width: "100%" }}>
                 <Alert showIcon type="info" message={selectedKnowledgeBase ? `当�知识库：${selectedKnowledgeBase.name}` : "请先从左侧选择知识库"} />
diff --git a/frontend/src/services/knowledge-base.ts b/frontend/src/services/knowledge-base.ts
index ef7a1554..26e3167a 100644
--- a/frontend/src/services/knowledge-base.ts
+++ b/frontend/src/services/knowledge-base.ts
@@ -4,6 +4,8 @@ import type {
   KnowledgeBaseCreatePayload,
   KnowledgeBaseDocumentItem,
   KnowledgeBaseItem,
+  KnowledgeBaseRollbackPayload,
+  KnowledgeBaseVersionItem,
   PageResponse,
 } from "@/types/api";
 
@@ -41,6 +43,31 @@ export async function createKnowledgeBase(payload: KnowledgeBaseCreatePayload) {
   return response.data;
 }
 
+export async function listKnowledgeBaseVersions(knowledgeBaseId: string) {
+  const response = await http.get<ApiResponse<KnowledgeBaseVersionItem[]>>(`/knowledge-bases/${knowledgeBaseId}/versions`);
+  return response.data;
+}
+
+export async function publishKnowledgeBase(knowledgeBaseId: string) {
+  const response = await http.post<ApiResponse<KnowledgeBaseItem>>(`/knowledge-bases/${knowledgeBaseId}/publish`);
+  return response.data;
+}
+
+export async function unpublishKnowledgeBase(knowledgeBaseId: string) {
+  const response = await http.post<ApiResponse<KnowledgeBaseItem>>(`/knowledge-bases/${knowledgeBaseId}/unpublish`);
+  return response.data;
+}
+
+export async function rollbackKnowledgeBase(knowledgeBaseId: string, payload: KnowledgeBaseRollbackPayload) {
+  const formData = new FormData();
+  formData.append("target_version_label", payload.target_version_label);
+  if (payload.change_summary) {
+    formData.append("change_summary", payload.change_summary);
+  }
+  const response = await http.post<ApiResponse<KnowledgeBaseItem>>(`/knowledge-bases/${knowledgeBaseId}/rollback`, formData);
+  return response.data;
+}
+
 export async function listKnowledgeBaseDocuments(knowledgeBaseId: string, page = 1, pageSize = 20) {
   const response = await http.get<ApiResponse<PageResponse<KnowledgeBaseDocumentItem>>>(`/knowledge-bases/${knowledgeBaseId}/documents`, {
     params: {
diff --git a/frontend/src/types/api.ts b/frontend/src/types/api.ts
index 8f58a07c..31e0ff19 100644
--- a/frontend/src/types/api.ts
+++ b/frontend/src/types/api.ts
@@ -232,10 +232,27 @@ export type KnowledgeBaseItem = {
   status: string;
   document_count: number;
   retrieval_mode?: string | null;
+  current_version_label?: string | null;
+  published_at?: string | null;
+  published_by?: string | null;
   created_at: string;
   updated_at: string;
 };
 
+export type KnowledgeBaseVersionItem = {
+  id: string;
+  knowledge_base_id: string;
+  version_label: string;
+  name: string;
+  description: string | null;
+  retrieval_mode?: string | null;
+  status: string;
+  published_at?: string | null;
+  published_by?: string | null;
+  change_summary?: string | null;
+  created_at: string;
+};
+
 export type KnowledgeBaseDocumentItem = {
   id: string;
   knowledge_base_id: string;
@@ -274,6 +291,11 @@ export type KnowledgeBaseCreatePayload = {
   description?: string;
 };
 
+export type KnowledgeBaseRollbackPayload = {
+  target_version_label: string;
+  change_summary?: string;
+};
+
 export type KnowledgeBaseListResponse = PageResponse<KnowledgeBaseItem>;
 export type KnowledgeBaseDocumentListResponse = PageResponse<KnowledgeBaseDocumentItem>;
 
diff --git a/project-docs/AI��起�与审查助手-当�工作进度�存-2026-05-11.md b/project-docs/AI��起�与审查助手-当�工作进度�存-2026-05-11.md
index 11fa07a1..77a551d2 100644
--- a/project-docs/AI��起�与审查助手-当�工作进度�存-2026-05-11.md
+++ b/project-docs/AI��起�与审查助手-当�工作进度�存-2026-05-11.md
@@ -1579,17 +1579,57 @@
 - 从代�链角度看，`knowledge_bases` 的远端�布链已�补�：
   - 共享平�有真实端点
   - ��平�有 SDK / client / backend API 桥接
-- 但当� `shared-ai-platform-java` 仓库存在用户已有的未�交改动，�适�未�确认直接把整个仓库工作树部署到远端�行环境。
-- 因此这轮状�定义为：
-  - 代�实现：已完�
-  - 本地 / smoke 验�：已完�
-  - �行中 shared-ai �务部署：待�独确认
+  - ��平��端知识库页已接上�布治���
+- �行中的 shared-ai Java �务也已更新到包�这组端点的版本：
+  - 远端仓库 `/opt/shared-ai-platform-java` 已 `git pull --ff-only` 到 `f925913`
+  - `docker compose -f docker-compose.server.yml up -d --build shared-ai-platform-java` 已执行
+  - `/health` 正常
+  - 远端 HTTP smoke 已通过：
+    - `publish -> versions -> unpublish -> rollback`
+- 当��将 `knowledge_bases` �布链定义为：
+  - 代�实现：完�
+  - 本地 / smoke 验�：完�
+  - 远端�行时验�：完�
 
 ### 当�阻塞项
-- `knowledge_bases` �布链当�已��是代�缺�。
-- 目�剩下的是�布层�阻塞：
-  - `D:\shared-ai-platform-java` 工作区�用户已有未�交改动，直接部署会混入无关�更
-  - 若�把�行中的 shared-ai Java �务也切到新端点，需�先确认是��许按当�工作树部署，或先整� shared repo 交付边界
+- `knowledge_bases` �布链已无代�级或�行级阻塞。
+
+## 2026-05-15 knowledge-bases 页�已接上�布链
+
+### 本轮完�项
+- `frontend/src/services/knowledge-base.ts`
+  - 已补�知识库�布链�端�务：
+    - `listKnowledgeBaseVersions`
+    - `publishKnowledgeBase`
+    - `unpublishKnowledgeBase`
+    - `rollbackKnowledgeBase`
+- `frontend/src/types/api.ts`
+  - 已补�知识库�布链�端类型：
+    - `KnowledgeBaseVersionItem`
+    - `KnowledgeBaseRollbackPayload`
+    - `KnowledgeBaseItem.current_version_label / published_at / published_by`
+- `frontend/src/app/knowledge-bases/page.tsx`
+  - 已新增“�布治����：
+    - 展示当�知识库�布状��当�版本��布人��布时间
+    - 支�“�布知识库�
+    - 支�“下线知识库�
+    - 支�查看版本历�
+    - 支�选择历�版本并执行“回滚知识库�
+  - ��现有上传文档�异常文档���索引状�表��，��把本页�新���一套管��
+
+### 本轮验�
+- �端检查：
+  - `npm --prefix frontend run lint`
+  - 结果：通过
+  - `npm --prefix frontend run build`
+  - 结果：通过
+- 说明：
+  - `ai-contract-platform` 的�端与 backend bridge 已�接上
+  - `shared-ai-platform-java` 的知识库�布端点 smoke 也已在上一轮通过
+
+### 当�状�更新
+- `knowledge_bases` �布链现在已�形�“共享平�远端端点 -> ��平� SDK/client/backend -> ��平��端页��的完整代�闭环。
+- 当��行中的 shared-ai Java �务已�切到包�这组新端点的版本，�端按钮�以按新链路继续验�。
 
 ## 2026-05-15 默认无�正��程验�与治�状�刷新
 
diff --git a/project-docs/formal-launch-ops/governance-productization-backlog.csv b/project-docs/formal-launch-ops/governance-productization-backlog.csv
index 8b53b9d9..07eee8ec 100644
--- a/project-docs/formal-launch-ops/governance-productization-backlog.csv
+++ b/project-docs/formal-launch-ops/governance-productization-backlog.csv
@@ -12,7 +12,7 @@ batch,priority,area,task_id,title,current_gap,target_deliverable,depends_on,acce
 5B,P0,backend_api,GOV-API-004,新增��上传绑定接�,当�系统没有专门的治���绑定接�,新增 /governance/evidences 上传绑定替�校验接�,GOV-DB-004,系统�阻止模���进入已批准状�,COMPLETED
 5B,P0,backend_api,GOV-API-005,新增上线批准汇总接�,当�没有系统内 release approval summary,新增 /governance/releases/summary 和 /governance/releases/{id} 接�,GOV-DB-005,�端�直接展示当�上线阻断项与通过项,COMPLETED
 5B,P0,backend_api,GOV-API-006,新增CSV�账导入接�,当�正�上线�账��仓库脚本导入,新增 /governance/imports/formal-launch 接�读�既有 CSV 映射到治�表,GOV-DB-001;GOV-DB-002;GOV-DB-003;GOV-DB-004,旧�账�一次性导入数�库且�留��信�,COMPLETED
-5B,P1,backend_api,GOV-API-007,模�规则知识库�布接�,当�内容模�没有生产�布动作,为 templates review-rules knowledge-bases 增加 publish/unpublish/rollback 接�,GOV-DB-005;GOV-DB-006,已批准资产�能被�布到生产�用集�,IN_PROGRESS
+5B,P1,backend_api,GOV-API-007,模�规则知识库�布接�,当�内容模�没有生产�布动作,为 templates review-rules knowledge-bases 增加 publish/unpublish/rollback 接�,GOV-DB-005;GOV-DB-006,已批准资产�能被�布到生产�用集�,COMPLETED
 5C,P0,frontend,GOV-WEB-001,新增�核总控中心页�,当�没有统一治�控制�,新增 /governance 页�展示资产统计阻断项角色视图和�布批次,GOV-API-001;GOV-API-005,管�员�在�页看到当�正�上线治�全貌,COMPLETED
 5C,P0,frontend,GOV-WEB-002,新增�核人工作�页�,当�真实法务业务��没有系统内待办页,新增 /governance/workbench 页�支�按角色查看待处�任务,GOV-API-001;GOV-API-002;GOV-API-003,�核人��看到与自己相关的任务包,COMPLETED
 5C,P0,frontend,GOV-WEB-003,新增资产详情与��页,当�无法在系统内查看�资产的签署链和��链,新增治�资产详情页和����,GOV-API-001;GOV-API-003;GOV-API-004,�在页�内查看�个资产的�核记录和��状�,COMPLETED