Skip to content

World's first open-source enterprise world model.

11.4 KB
Raw Blame
import { useEffect, useMemo, useRef, useState } from "react";
import { useQuery } from "@tanstack/react-query";
import { Link, useNavigate, useParams, useSearch } from "@tanstack/react-router";
import { api, type ChunkFact, type Doc } from "../api";
import { S } from "../i18n";
import { useKbId } from "../kb";
import { originHint, originLabel } from "../origin";
import { fmtTime } from "../time";
import { GroupLabel, LinkButton, PageHeader, Pager, pageSlice } from "../ui";
import { AddOntologyRegressionDialog } from "./AddOntologyRegressionDialog";
import { QuotedText } from "../ui/citation";
import { SourcesRail } from "./SourcesRail";

const DOC_PAGE = 12;

const ym = (iso: string | null) => (iso ? iso.slice(0, 7) : null);

function factRange(f: ChunkFact): string | null {
  if (!f.valid_from && !f.valid_to) return null;
  return `${ym(f.valid_from) ?? "…"} → ${ym(f.valid_to) ?? S.doc.ongoing}`;
}

export function DocViewer() {
  const kbId = useKbId();
  const [caseStatement, setCaseStatement] = useState<ChunkFact | null>(null);
  const { docId } = useParams({ from: "/app/kb/$kbId/doc/$docId" });
  const { chunk, quote } = useSearch({ from: "/app/kb/$kbId/doc/$docId" });
  const navigate = useNavigate();

  const detail = useQuery({
    queryKey: ["docDetail", docId],
    queryFn: () => api.documentDetail(docId),
  });
  // 角色仅详情接口返回;复用 KbScope 的键,不能从工作区 KB 列表判断写权限。
  const roleKbId = detail.data?.document.kb_id;
  const role = useQuery({
    queryKey: ["kbOne", roleKbId],
    queryFn: () => api.kbDetail(roleKbId!),
    enabled: !!roleKbId,
  });
  // 反向证据链:各分块抽出的事实(一次取整文档,按 chunk 分组)
  const extractions = useQuery({
    queryKey: ["docExtractions", docId],
    queryFn: () => api.documentExtractions(docId),
  });
  const factsByChunk = useMemo(() => {
    const map = new Map<string, ChunkFact[]>();
    for (const f of extractions.data?.facts ?? []) {
      if (!map.has(f.chunk_id)) map.set(f.chunk_id, []);
      map.get(f.chunk_id)!.push(f);
    }
    return map;
  }, [extractions.data]);

  // null = 自动定位:有引用跳转时翻到目标分块所在页
  const [page, setPage] = useState<number | null>(null);
  useEffect(() => setPage(null), [chunk, docId]);
  useEffect(() => setCaseStatement(null), [docId]);

  const highlightRef = useRef<HTMLDivElement>(null);
  // 引用跳转:滚动到目标分块点亮一下,稍候淡出恢复普通状态(不常驻高亮)
  const [flash, setFlash] = useState(false);
  useEffect(() => {
    if (detail.data && highlightRef.current) {
      highlightRef.current.scrollIntoView({ behavior: "smooth", block: "center" });
      setFlash(true);
      // 平滑滚动本身耗几百毫秒,点亮窗口要留足滚动后的可视时间
      const t = setTimeout(() => setFlash(false), 2600);
      return () => clearTimeout(t);
    }
  }, [detail.data, chunk]);

  if (detail.isPending)
    return <div className="p-8 text-body text-ink-2">{S.doc.loading}</div>;
  if (detail.isError)
    return (
      <div className="p-8 text-body text-danger">
        {(detail.error as Error).message}
      </div>
    );

  const { document: doc, chunks } = detail.data;
  const targetIdx = chunk ? chunks.findIndex((c) => c.id === chunk) : -1;
  const curPage = page ?? (targetIdx >= 0 ? Math.floor(targetIdx / DOC_PAGE) : 0);
  const { rows: pagedChunks, safe: safePage } = pageSlice(chunks, curPage, DOC_PAGE);

  return (
    <div className="h-full flex">
      {/* 来源栏常驻:当前文档所属文件夹高亮,点其他文件夹跳回 Library 对应视图 */}
      <SourcesRail
        kbId={doc.kb_id}
        active={doc.source_id ?? "uploads"}
        onSelect={(sel) => navigate({ to: "/kb/$kbId/library", params: { kbId }, search: { src: sel } })}
      />
      <div className="flex-1 min-w-0 overflow-y-auto u-scroll">
        {/* 靠左排,与文库列表同一个内距(px-8 py-6),铺满栏右的整个宽度:
            分块那一栏和右边的抽取栏一起摊开 */}
        <div className="px-8 py-6">
        <PageHeader
          title={doc.filename}
          sub={<DocMeta doc={doc} chunks={chunks.length} />}
          actions={
            <Link to="/kb/$kbId/library" params={{ kbId }} className="u-link shrink-0 text-body">
              {S.doc.backToLibrary}
            </Link>
          }
        />

        <div className="space-y-3">
          {pagedChunks.map((c) => {
            const hit = c.id === chunk;
            const facts = factsByChunk.get(c.id) ?? [];
            return (
              <div key={c.id} ref={hit ? highlightRef : undefined} className="flex gap-3">
                <div
                  className={`u-chunk flex-1 min-w-0 rounded-panel border p-4 text-body leading-relaxed whitespace-pre-wrap border-line ${
                    hit && flash ? "u-flash" : "bg-surface"
                  }`}
                >
                  <div className="mb-2 text-small text-ink-2">
                    {S.doc.section} {c.seq + 1}
                    {/* 认出来、转写出来的字标一句出处:可能认错一个数、听错一个名字 */}
                    {originLabel(c.origin, c.anchor) && (
                      <span title={originHint(c.origin, c.origin_model)}>
                        {" · "}
                        {originLabel(c.origin, c.anchor)}
                      </span>
                    )}
                    {hit && (
                      <span
                        className={`u-fade-slow ml-2 text-accent ${
                          flash ? "opacity-100" : "opacity-0"
                        }`}
                      >
                        {S.doc.citedHere}
                      </span>
                    )}
                  </div>
                  {/* 从一条图谱事实的号跳来时,标出说出它的那一句(#968 的后续) */}
                  {hit && quote ? <QuotedText text={c.text} quotes={[quote]} /> : c.text}
                </div>

                {/* 抽取对照栏:这个分块产出了哪些事实(实体可跳图谱)。
                    **宽度跟着屏幕走**:每一条都是一个三元组,窄栏里一条要折三行,
                    读者要在原文和它之间来回看,折行越多越难对上。384 的时候大多数
                    三元组占一到两行 */}
                {facts.length > 0 && (
                  <aside className="w-64 shrink-0 rounded-panel border border-line bg-surface p-3 xl:w-80 2xl:w-96">
                    <GroupLabel className="mb-2" count={facts.length}>
                      {S.doc.extracted}
                    </GroupLabel>
                    {/* **条与条之间画一条线**:一条折了三行、下一条折了两行,只靠 8px 的
                        间距分不开,一栏读下来是一团字。线比加大间距省地方 */}
                    <div className="divide-y divide-line">
                      {facts.map((f) => {
                        const range = factRange(f);
                        return (
                          <div
                            key={f.fact_id}
                            className="py-2 text-small leading-snug first:pt-0 last:pb-0"
                          >
                            <div>
                              <Link
                                to="/kb/$kbId/graph"
                                params={{ kbId }}
                                search={{ entity: f.subject_id }}
                                className="u-inline-link text-ink"
                              >
                                {f.subject}
                              </Link>
                              <span
                                className={
                                  f.predicate === null
                                    ? "italic text-ink-2"
                                    : "text-ink-2"
                                }
                                title={
                                  f.predicate && f.inferred
                                    ? S.graph.inferredPredicate
                                    : undefined
                                }
                              >
                                {" "}
                                {f.predicate ?? S.graph.unknownPredicate}{" "}
                              </span>
                              {f.object_id ? (
                                <Link
                                  to="/kb/$kbId/graph"
                                  params={{ kbId }}
                                  search={{ entity: f.object_id }}
                                  className="u-inline-link text-ink"
                                >
                                  {f.object}
                                </Link>
                              ) : (
                                /* 字面值的宾语与实体的宾语**一样深**:浅一档的话它和
                                   中间的短语同色,三元组读起来就断不开哪里是关系、
                                   哪里是值 */
                                <span className="text-ink">{f.object ?? ""}</span>
                              )}
                            </div>
                            {range && <div className="u-num text-fine text-ink-2">{range}</div>}
                            {f.is_open_statement &&
                              ["editor", "admin", "owner"].includes(role.data?.my_role ?? "") && (
                              <LinkButton className="mt-1 text-fine" onClick={() => setCaseStatement(f)}>
                                {S.ontology.caseMake}
                              </LinkButton>
                            )}
                          </div>
                        );
                      })}
                    </div>
                  </aside>
                )}
              </div>
            );
          })}
        </div>
          <Pager total={chunks.length} pageSize={DOC_PAGE} page={safePage} onPage={setPage} />
        </div>
      </div>
      {caseStatement && (
        <AddOntologyRegressionDialog
          key={caseStatement.fact_id}
          kbId={doc.kb_id}
          statementId={caseStatement.fact_id}
          statement={`${caseStatement.subject} ${caseStatement.predicate ?? ""} ${caseStatement.object ?? ""}`}
          isValue={!caseStatement.object_id}
          onClose={() => setCaseStatement(null)}
        />
      )}
    </div>
  );
}

/** 文档头部的元数据条:段数 · 大小 · 文档日期 · 上传时刻。
 *
 *  文档日期(`doc_time`)与上传时刻(`created_at`)分开显示(#610):合成一格,读的人会把
 *  上传时间当成文档上写的日期。两者的读法也不同:文档日期是**日历日期**,存的是那一天的
 *  UTC 午夜,按 UTC 读(`fmtTime`)——按本地读,UTC-5 的人看到的是前一天;上传时刻是一个
 *  真实的时刻,按看的人所在的时区读。 */
function DocMeta({ doc, chunks }: { doc: Doc; chunks: number }) {
  const docDate = fmtTime(doc.doc_time, "day");
  return (
    <>
      {chunks} {S.doc.sections} · {(doc.size_bytes / 1024).toFixed(0)} KB ·{" "}
      {docDate && (
        <>
          <span title={S.doc.docDateFromContent}>
            {S.doc.docDate}: {docDate}
          </span>
          {" · "}
        </>
      )}
      {S.doc.uploadedAt} {new Date(doc.created_at).toLocaleDateString()}
    </>
  );
}