Files
DataMate/frontend/src/pages/KnowledgeManagement/Detail/KnowledgeSetDetail.tsx
Jerry Yan d996040b7f feat(KnowledgeManagement): 添加知识条目阅读功能
- 在知识集详情页面中添加阅读按钮,支持查看知识条目的内容
- 实现文本和Markdown格式知识条目的在线阅读预览
- 集成文件下载功能,支持从数据集文件中读取内容
- 添加内容长度限制,超过50000字符时截断并提示
- 使用模态框展示阅读内容,提供良好的用户体验
-
2026-01-22 15:09:10 +08:00

425 lines
12 KiB
TypeScript

import { useCallback, useEffect, useMemo, useState } from "react";
import {
App,
Breadcrumb,
Button,
Card,
Descriptions,
Empty,
Modal,
Table,
Tag,
Tooltip,
} from "antd";
import { DeleteOutlined, EditOutlined, EyeOutlined, PlusOutlined } from "@ant-design/icons";
import { useNavigate, useParams } from "react-router";
import DetailHeader from "@/components/DetailHeader";
import { SearchControls } from "@/components/SearchControls";
import useFetchData from "@/hooks/useFetchData";
import {
deleteKnowledgeItemByIdUsingDelete,
deleteKnowledgeSetByIdUsingDelete,
queryKnowledgeItemsUsingGet,
queryKnowledgeSetByIdUsingGet,
} from "../knowledge-management.api";
import {
knowledgeContentTypeOptions,
knowledgeStatusMap,
mapKnowledgeItem,
KnowledgeItemView,
} from "../knowledge-management.const";
import {
KnowledgeItem,
KnowledgeSet,
KnowledgeContentType,
KnowledgeStatusType,
} from "../knowledge-management.model";
import CreateKnowledgeSet from "../components/CreateKnowledgeSet";
import KnowledgeItemEditor from "../components/KnowledgeItemEditor";
import ImportKnowledgeItemsDialog from "../components/ImportKnowledgeItemsDialog";
import { formatDate } from "@/utils/unit";
const MAX_READ_LENGTH = 50000;
const KnowledgeSetDetail = () => {
const navigate = useNavigate();
const { message } = App.useApp();
const { id } = useParams<{ id: string }>();
const [knowledgeSet, setKnowledgeSet] = useState<KnowledgeSet | null>(null);
const [showEdit, setShowEdit] = useState(false);
const [itemEditorOpen, setItemEditorOpen] = useState(false);
const [currentItem, setCurrentItem] = useState<KnowledgeItem | null>(null);
const [readItemId, setReadItemId] = useState<string | null>(null);
const [readModalOpen, setReadModalOpen] = useState(false);
const [readContent, setReadContent] = useState("");
const [readTitle, setReadTitle] = useState("");
const fetchKnowledgeSet = useCallback(async () => {
if (!id) return;
const { data } = await queryKnowledgeSetByIdUsingGet(id);
setKnowledgeSet(data);
}, [id]);
useEffect(() => {
fetchKnowledgeSet();
}, [fetchKnowledgeSet]);
const {
loading,
tableData: items,
searchParams,
pagination,
fetchData,
setSearchParams,
handleFiltersChange,
handleKeywordChange,
} = useFetchData<KnowledgeItemView>(
(params) => (id ? queryKnowledgeItemsUsingGet(id, params) : Promise.resolve({ data: [] })),
mapKnowledgeItem,
30000,
false,
[],
0
);
const isReadOnly =
knowledgeSet?.status === KnowledgeStatusType.ARCHIVED ||
knowledgeSet?.status === KnowledgeStatusType.DEPRECATED;
const handleDeleteSet = async () => {
if (!knowledgeSet) return;
await deleteKnowledgeSetByIdUsingDelete(knowledgeSet.id);
message.success("知识集已删除");
navigate("/data/knowledge-management");
};
const handleDeleteItem = async (item: KnowledgeItemView) => {
if (!id) return;
await deleteKnowledgeItemByIdUsingDelete(id, item.id);
message.success("知识条目已删除");
fetchData();
};
const isReadableItem = (record: KnowledgeItemView) => {
return (
record.contentType === KnowledgeContentType.TEXT ||
record.contentType === KnowledgeContentType.MARKDOWN
);
};
const handleReadItem = async (record: KnowledgeItemView) => {
setReadItemId(record.id);
setReadTitle(record.title || "知识条目");
if (!record.sourceDatasetId || !record.sourceFileId) {
const content = record.content || "";
if (content.length > MAX_READ_LENGTH) {
setReadContent(
`${content.slice(0, MAX_READ_LENGTH)}\n\n... (内容过长,仅显示前 ${MAX_READ_LENGTH} 字符)`
);
} else {
setReadContent(content);
}
setReadModalOpen(true);
setReadItemId(null);
return;
}
const fileUrl = `/api/data-management/datasets/${record.sourceDatasetId}/files/${record.sourceFileId}/download`;
try {
const response = await fetch(fileUrl);
if (!response.ok) {
throw new Error("下载失败");
}
const text = await response.text();
if (text.length > MAX_READ_LENGTH) {
setReadContent(
`${text.slice(0, MAX_READ_LENGTH)}\n\n... (内容过长,仅显示前 ${MAX_READ_LENGTH} 字符)`
);
} else {
setReadContent(text);
}
setReadModalOpen(true);
} catch (error) {
console.error("读取知识条目失败", error);
message.error("读取失败,请稍后重试");
} finally {
setReadItemId(null);
}
};
const statusMeta = knowledgeSet?.status
? knowledgeStatusMap[knowledgeSet.status]
: undefined;
const statistics = useMemo(
() => [
{
key: "items",
icon: <PlusOutlined className="text-blue-500" />,
label: "条目数",
value: pagination.total || 0,
},
{
key: "updated",
icon: <EditOutlined className="text-gray-500" />,
label: "更新时间",
value: knowledgeSet?.updatedAt ? formatDate(knowledgeSet.updatedAt) : "-",
},
],
[pagination.total, knowledgeSet?.updatedAt]
);
const itemColumns = [
{
title: "标题",
dataIndex: "title",
key: "title",
fixed: "left" as const,
width: 220,
ellipsis: true,
},
{
title: "状态",
dataIndex: "status",
key: "status",
width: 120,
render: (status: KnowledgeItemView["status"]) => (
<Tag color={status?.color}>{status?.label}</Tag>
),
},
{
title: "类型",
dataIndex: "contentType",
key: "contentType",
width: 120,
render: (contentType: string) =>
knowledgeContentTypeOptions.find((opt) => opt.value === contentType)?.label ||
contentType,
},
{
title: "负责人",
dataIndex: "owner",
key: "owner",
width: 120,
ellipsis: true,
},
{
title: "来源",
dataIndex: "sourceType",
key: "sourceType",
width: 140,
ellipsis: true,
},
{
title: "更新时间",
dataIndex: "updatedAt",
key: "updatedAt",
width: 180,
ellipsis: true,
},
{
title: "操作",
key: "actions",
width: 200,
render: (_: unknown, record: KnowledgeItemView) => (
<div className="flex items-center gap-2">
<Tooltip title="阅读">
<Button
type="text"
icon={<EyeOutlined />}
onClick={() => handleReadItem(record)}
disabled={!isReadableItem(record)}
loading={readItemId === record.id}
aria-label="阅读"
/>
</Tooltip>
<Button
type="text"
icon={<EditOutlined />}
onClick={() => {
setCurrentItem({
...(record as unknown as KnowledgeItem),
status: record.rawStatus,
});
setItemEditorOpen(true);
}}
disabled={isReadOnly || record.rawStatus === KnowledgeStatusType.ARCHIVED || record.rawStatus === KnowledgeStatusType.DEPRECATED}
/>
<Button
type="text"
danger
icon={<DeleteOutlined />}
onClick={() => handleDeleteItem(record)}
disabled={isReadOnly}
/>
</div>
),
},
];
return (
<div className="h-full flex flex-col">
<div className="mb-4">
<Breadcrumb>
<Breadcrumb.Item>
<a onClick={() => navigate("/data/knowledge-management")}></a>
</Breadcrumb.Item>
<Breadcrumb.Item>{knowledgeSet?.name || "-"}</Breadcrumb.Item>
</Breadcrumb>
</div>
<DetailHeader
data={{
name: knowledgeSet?.name,
description: knowledgeSet?.description,
status: statusMeta,
tags: knowledgeSet?.tags,
}}
statistics={statistics}
operations={[
{
key: "edit",
label: "编辑",
icon: <EditOutlined />,
onClick: () => setShowEdit(true),
danger: false,
},
{
key: "delete",
label: "删除",
icon: <DeleteOutlined />,
danger: true,
confirm: {
title: "确认删除该知识集吗?",
description: "删除后将无法恢复,请谨慎操作。",
cancelText: "取消",
okText: "删除",
okType: "danger",
onConfirm: () => handleDeleteSet(),
},
},
]}
/>
<CreateKnowledgeSet
showBtn={false}
isEdit={showEdit}
data={knowledgeSet}
onUpdate={() => {
setShowEdit(false);
fetchKnowledgeSet();
}}
onClose={() => setShowEdit(false)}
/>
<Card className="mt-4">
<Descriptions column={2} size="small">
<Descriptions.Item label="领域">{knowledgeSet?.domain || "-"}</Descriptions.Item>
<Descriptions.Item label="业务线">{knowledgeSet?.businessLine || "-"}</Descriptions.Item>
<Descriptions.Item label="负责人">{knowledgeSet?.owner || "-"}</Descriptions.Item>
<Descriptions.Item label="敏感级别">{knowledgeSet?.sensitivity || "-"}</Descriptions.Item>
<Descriptions.Item label="有效期">
{knowledgeSet?.validFrom || "-"} ~ {knowledgeSet?.validTo || "-"}
</Descriptions.Item>
<Descriptions.Item label="来源类型">{knowledgeSet?.sourceType || "-"}</Descriptions.Item>
</Descriptions>
</Card>
<div className="flex-1 border-card p-6 mt-4">
<div className="flex items-center justify-between mb-4 gap-3">
<SearchControls
searchTerm={searchParams.keyword}
onSearchChange={handleKeywordChange}
searchPlaceholder="搜索标题或内容"
filters={[]}
onFiltersChange={handleFiltersChange}
onClearFilters={() => setSearchParams({ ...searchParams, filter: { type: [], status: [], tags: [] } })}
showViewToggle={false}
showReload={false}
/>
<div className="flex items-center gap-2">
<Button
type="primary"
icon={<PlusOutlined />}
onClick={() => {
setCurrentItem(null);
setItemEditorOpen(true);
}}
disabled={isReadOnly}
>
</Button>
<ImportKnowledgeItemsDialog
setId={id || ""}
onImported={fetchData}
disabled={isReadOnly}
/>
</div>
</div>
{items.length === 0 ? (
<Empty description="暂无知识条目" />
) : (
<Table
loading={loading}
columns={itemColumns}
dataSource={items}
rowKey="id"
pagination={pagination}
scroll={{ y: "calc(100vh - 36rem)" }}
/>
)}
</div>
<KnowledgeItemEditor
open={itemEditorOpen}
setId={id || ""}
data={currentItem}
readOnly={isReadOnly}
onCancel={() => {
setItemEditorOpen(false);
setCurrentItem(null);
}}
onSuccess={() => {
setItemEditorOpen(false);
setCurrentItem(null);
fetchData();
}}
/>
<Modal
open={readModalOpen}
title={`阅读:${readTitle}`}
width={820}
onCancel={() => {
setReadModalOpen(false);
setReadContent("");
setReadTitle("");
}}
footer={[
<Button
key="close"
onClick={() => {
setReadModalOpen(false);
setReadContent("");
setReadTitle("");
}}
>
</Button>,
]}
>
<pre
className="max-h-[520px] overflow-auto rounded bg-gray-50 p-4 text-xs whitespace-pre-wrap break-all"
>
{readContent}
</pre>
</Modal>
</div>
);
};
export default KnowledgeSetDetail;