World's first open-source enterprise world model.
Rust agent-memorybitemporalgraphragknowledge-baseknowledge-graphllmontologypgvectorpostgresqlragrustself-hostedsemantic-searchtemporal-knowledge-graphworld-model
import { Button, CARD_ACTIONS, Status } from "../ui";
/* 等人点头的事实(docs/decisions/0015)。
一句 remember 抽出的三元组先进待确认队列,不上图;人在这里点头它才进账本。
**原句在上,三元组在下**:只列三元组等于要人凭空判断它对不对——
实测里 `Acme --?--> 深圳` 那条,人一看原句就知道该拒。
两处共用同一行组件:Review 页的「待确认」一档,与 Chat 里跟在 remember 步骤后面的那张卡。 */
import { fmtObjectValue } from "../objectValue";
import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
import { api, type PendingFactItem } from "../api";
import { S } from "../i18n";
import { toast } from "../toast";
function ym(iso: string | null): string | null {
return iso ? iso.slice(0, 7) : null;
}
/** 记忆落库时正文前面带着 `[YYYY-MM-DD HH:MM] `(`memory::append_episode` 加的时间戳)。
* 卡片上要的是那句话本身,时间戳是索引用的,剥掉 */
function sentence(quote: string): string {
return quote.replace(/^\[\d{4}-\d{2}-\d{2}(?: \d{2}:\d{2})?\]\s*/, "");
}
function objectText(f: PendingFactItem): string {
if (f.object_name) return f.object_name;
return fmtObjectValue(f.object_value as Record<string, unknown> | null) ?? "?";
}
/** 点头是写图的动作,Editor 起步——与服务端 `require_kb(Role::Editor)` 同一口径。
* Viewer 看得见提议、看不见按钮:按钮亮着却点不动,等于让人猜自己有没有权限。
* 查询键与 Library 页共用(`kbOne`),不多打一次接口 */
export function useCanDecide(kbId: string | undefined): boolean {
const kbDetail = useQuery({
queryKey: ["kbOne", kbId],
queryFn: () => api.kbDetail(kbId!),
enabled: !!kbId,
});
return ["editor", "admin", "owner"].includes(kbDetail.data?.my_role ?? "");
}
export function PendingFactRow({
fact,
busy,
canDecide,
onConfirm,
onReject,
}: {
fact: PendingFactItem;
busy: boolean;
canDecide: boolean;
onConfirm: () => void;
onReject: () => void;
}) {
const from = ym(fact.valid_from);
const to = ym(fact.valid_to);
// 开放陈述(0044)带的是照抄的时间词,不是算出来的区间:有词就显示词
const timeWords = (fact.time_words ?? []).map((t) => t.text).join(" · ");
const range = timeWords
? timeWords
: from || to
? `${from ?? "…"} → ${to ?? S.review.ongoing}`
: null;
const qualifiers = fact.qualifiers ?? [];
return (
<div className="glass rounded-panel p-4">
{/* 原句先出。它是人自己说的,判断的依据就是它 */}
<p className="text-small text-ink-2 italic">“{sentence(fact.quote)}”</p>
<div className="mt-3 flex items-center gap-2 flex-wrap">
<span className="text-body font-medium text-ink">{fact.subject_name}</span>
<span className="text-small text-ink-2">
—{" "}
{fact.predicate_label ? (
<span>{fact.predicate_label}</span>
) : fact.phrase ? (
/* 开放陈述:文档自己的话,斜体标明它是原话而不是词表里的词(0044) */
<span className="italic text-ink-2" title={S.review.pendingOwnWords}>
{fact.phrase}
</span>
) : (
/* 本体里没有这个关系:显示原话,斜体标明它不是词表里的词(0010) */
<span
className="italic text-ink-2"
title={S.review.pendingNoPredicate}
>
{fact.proposed_predicate ?? S.graph.unknownPredicate}
</span>
)}{" "}
→
</span>
<span className="text-body font-medium text-ink">{objectText(fact)}</span>
{range && <span className="text-small text-ink-2">({range})</span>}
{!fact.predicate_label && !fact.phrase && (
<Status tone="warn" className="ml-auto shrink-0">
{S.review.pendingNoPredicateChip}
</Status>
)}
</div>
{qualifiers.length > 0 && (
/* 限定按文档的角色词挂着(0044):金额、对象、比较基准 */
<div className="mt-2 flex flex-wrap gap-1">
{qualifiers.map((q) => (
<span key={q.role} className="rounded-full bg-surface-2 px-2 py-1 text-fine text-ink-2">
{q.role}: {q.entity_name ?? String(q.value ?? "")}
</span>
))}
</div>
)}
{/* 与审阅页其余六种卡同一副页脚(CARD_ACTIONS):动作在左,「谁说的」推到右边 */}
<div className={CARD_ACTIONS}>
{canDecide && (
<>
<Button variant="secondary" size="sm"
disabled={busy}
onClick={onConfirm}
>
{S.review.confirm}
</Button>
<Button variant="danger" size="sm"
disabled={busy}
onClick={onReject}
>
{S.review.reject}
</Button>
</>
)}
{fact.proposed_by_name && (
<span className="ml-auto truncate text-fine text-ink-2">
{fact.proposed_token_name
? S.review.pendingSaidVia(
fact.proposed_by_name,
fact.proposed_token_name,
)
: S.review.pendingSaidBy(fact.proposed_by_name)}
</span>
)}
</div>
</div>
);
}
/** 跟在 remember 步骤后面的确认卡。
* 抽取是异步的,卡片在任务完成时才长出来(SSE `pending` 事件让查询失效重取);
* 回放旧会话时同样按 chunk 取——还有没点头的就照样显示,都处理完了就不占地方。 */
export function NodCard({ kbId, chunkId }: { kbId: string; chunkId: string }) {
const queryClient = useQueryClient();
const canDecide = useCanDecide(kbId);
const q = useQuery({
queryKey: ["pending", kbId, chunkId],
queryFn: () => api.pendingForChunk(kbId, chunkId),
});
const decide = useMutation({
mutationFn: ({ id, action }: { id: string; action: "confirm" | "reject" }) =>
api.decidePending(kbId, id, action),
onError: (e: Error) => toast.error(e.message),
onSettled: () => {
queryClient.invalidateQueries({ queryKey: ["pending", kbId] });
queryClient.invalidateQueries({ queryKey: ["review", kbId] });
},
});
const items = q.data?.items ?? [];
if (items.length === 0) return null;
return (
<div className="my-2 space-y-2">
<div className="text-small text-ink-2">{S.review.nodCardTitle(items.length)}</div>
{items.map((f) => (
<PendingFactRow
key={f.id}
fact={f}
busy={decide.isPending && decide.variables?.id === f.id}
canDecide={canDecide}
onConfirm={() => decide.mutate({ id: f.id, action: "confirm" })}
onReject={() => decide.mutate({ id: f.id, action: "reject" })}
/>
))}
</div>
);
}