World's first open-source enterprise world model.
Rust agent-memorybitemporalgraphragknowledge-baseknowledge-graphllmontologypgvectorpostgresqlragrustself-hostedsemantic-searchtemporal-knowledge-graphworld-model
/* 账户层"我的知识库":可访问的库 + 我的角色 + 加入信息 + 概览统计,**以及建库**。
从前建库的入口在 Administration 里,而那一节只有系统管理员看得见——可建库要的
是工作区 Admin+,于是一个工作区管理员在界面上根本没有建库的门。两处列的又是
同一份数据(都读 `my-kbs`),所以并成这一页。 */
import { useState } from "react";
import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
import { useNavigate, useSearch } from "@tanstack/react-router";
import { Lock, Plus, Search } from "lucide-react";
import { api, type MyKb } from "../api";
import { S } from "../i18n";
import { useKb } from "../kb";
import { kbGroups } from "./kbGroups";
import {
Button,
Checkbox,
Chip,
Dialog,
Field,
Input,
Loading,
MultiSearchSelect,
PageHeader,
TBody,
THead,
Table,
Td,
Th,
Tr,
localDate,
} from "../ui";
import { fetchMe } from "../authSession";
function joinInfo(row: MyKb): string {
if (row.my_role === "owner") return S.account.deploymentAdmin;
if (row.joined_at) {
return row.added_by_name
? S.account.addedBy(row.added_by_name, localDate(row.joined_at))
: S.account.joinedOn(localDate(row.joined_at));
}
return S.account.openToEveryone;
}
export function MyKbs() {
const navigate = useNavigate();
const queryClient = useQueryClient();
const { workspace, setKb } = useKb();
// 库切换器最后一行带 ?create=true 过来:落地就开表单
const { create: deepLink } = useSearch({ from: "/account/account/kbs" });
const [creating, setCreating] = useState(!!deepLink);
const [filter, setFilter] = useState("");
const mine = useQuery({
queryKey: ["myKbs", workspace?.id],
queryFn: () => api.myKbs(workspace!.id),
enabled: !!workspace,
});
const me = useQuery({ queryKey: ["me"], queryFn: fetchMe });
/* 能不能建库:系统管理员,或者在这个工作区里是 Admin+(api/kbs.rs 的 create
就是这么判的)。**editor 不能**——它管的是库里的内容,不是有几个库 */
const wsRole = useQuery({
queryKey: ["workspaceRole", workspace?.id],
queryFn: () => api.workspaceRole(workspace!.id),
enabled: !!workspace,
});
const canCreate =
!!me.data?.is_admin ||
wsRole.data?.role === "admin" ||
wsRole.data?.role === "owner";
if (!workspace || mine.isPending) return <Loading>{S.nav.loading}</Loading>;
const q = filter.trim().toLowerCase();
const rows = (mine.data?.kbs ?? []).filter(
(r) =>
!q ||
r.kb.name.toLowerCase().includes(q) ||
(r.kb.description ?? "").toLowerCase().includes(q),
);
// 不筛选时按 `owner/` 归组:组名占一行,下面是短名(#1249);筛选时按全名平铺
const rowById = new Map(rows.map((r) => [r.kb.id, r]));
const lines: ({ heading: string } | { row: (typeof rows)[number]; label: string })[] = q
? rows.map((row) => ({ row, label: row.kb.name }))
: kbGroups(rows.map((r) => r.kb)).flatMap((entry) =>
entry.kind === "kb"
? [{ row: rowById.get(entry.kb.id)!, label: entry.kb.name }]
: [
{ heading: entry.name },
...entry.items.map((item) => ({ row: rowById.get(item.kb.id)!, label: item.label })),
],
);
const openKb = (id: string) => {
setKb(id);
navigate({ to: "/kb/$kbId/graph", params: { kbId: id } });
};
return (
<div className="px-8 py-6">
{/* 与管理页同一副身材:内容居中限宽,行长不随窗口拉长 */}
<div className="mx-auto w-full max-w-4xl">
<PageHeader
title={S.account.kbsTitle}
actions={
canCreate && (
<Button variant="primary" size="sm" onClick={() => setCreating(true)}>
<Plus size={12} />
{S.settings.kbs.newKb}
</Button>
)
}
/>
{/* 筛这份名单的东西在面板外面(DESIGN.md 6) */}
<div className="mb-4">
<Input
icon={<Search size={13} />}
/* 筛选条上的搜索框全站一个宽度:w-64(成员、规则、数据口径都是它) */
className="w-64"
placeholder={S.account.kbsFilter}
value={filter}
onChange={(e) => setFilter(e.target.value)}
/>
</div>
{/* **一张表,不是一列卡片。**这一页是一份记录清单——每个库的字段都一样,
人来这儿是横着比:谁的文档多、我在哪个库是 admin、哪个是受限的。
从前把这些堆成「名字 + 三枚胶囊」再加一行点号串起来的小字,同一个事实
在不同行落在不同的横向位置,比不了;而且全站别的清单(成员、令牌、
文库、规则、本体)早就是 Table / Th / Td,只有这一页是手写的。
身份那一列**是一个词,不是一枚填色胶囊**:它在自己那一列里,
列头已经说了这是什么,不需要再染一次色。 */}
<div className="glass rounded-panel overflow-hidden">
<Table>
<THead>
<Tr>
<Th>{S.account.kbNameLabel}</Th>
<Th>{S.account.kbRoleLabel}</Th>
<Th className="text-right">{S.account.kbDocsLabel}</Th>
<Th className="text-right">{S.account.kbMembersLabel}</Th>
<Th>{S.account.kbAccessLabel}</Th>
<Th />
</Tr>
</THead>
<TBody>
{lines.map((line) => {
if ("heading" in line)
return (
<Tr key={`group-${line.heading}`}>
<th
scope="rowgroup"
colSpan={6}
className="px-3 pt-4 pb-2 text-left align-top text-small font-medium text-ink-2"
>
{line.heading}
</th>
</Tr>
);
const { row, label } = line;
const canManage =
row.my_role === "admin" || row.my_role === "owner";
return (
<Tr key={row.kb.id}>
<Td>
<div className="flex items-center gap-2">
<span className="truncate text-body text-ink" title={row.kb.name}>
{label}
</span>
{/* 这两个是**库自己的性质**,不是一列数据:缺省库只有一个,
受限的也少,单开一列会空掉大半,所以贴在名字旁边 */}
{row.kb.is_default && (
<Chip tone="neutral">{S.settings.kbs.defaultChip}</Chip>
)}
{row.kb.visibility === "restricted" && (
<span
className="flex shrink-0 items-center gap-1 text-fine text-ink-2"
title={S.account.kbRestricted}
>
<Lock size={10} />
{S.account.kbRestricted}
</span>
)}
</div>
</Td>
<Td className="text-ink-2">
{row.my_role
? (S.account.roleNames[row.my_role] ?? row.my_role)
: "—"}
</Td>
<Td className="u-num text-right text-ink-2">{row.doc_count}</Td>
<Td className="u-num text-right text-ink-2">
{row.member_count}
</Td>
<Td className="text-small text-ink-2">{joinInfo(row)}</Td>
{/* 设置在前、打开在后:不是每一行都有设置(要 admin),把总是在的
那个放右端,一列按钮的右缘才不会一行一个样 */}
<Td className="text-right">
<div className="flex items-center justify-end gap-2">
{canManage && (
<Button variant="secondary" size="sm"
onClick={() => {
setKb(row.kb.id);
navigate({
to: "/kb/$kbId/settings",
params: { kbId: row.kb.id },
});
}}
>
{S.account.kbSettingsBtn}
</Button>
)}
<Button variant="secondary" size="sm"
onClick={() => openKb(row.kb.id)}
>
{S.account.openKb}
</Button>
</div>
</Td>
</Tr>
);
})}
</TBody>
</Table>
{rows.length === 0 && (
<p className="px-4 py-6 text-body text-ink-2">{S.ui.noMatches}</p>
)}
</div>
{creating && (
<NewKbModal
workspaceId={workspace.id}
onDone={(id) => {
setCreating(false);
queryClient.invalidateQueries({ queryKey: ["myKbs", workspace.id] });
queryClient.invalidateQueries({ queryKey: ["kbs", workspace.id] });
// 建完直达库设置:下一步几乎总是邀人/配置
if (id) {
setKb(id);
navigate({ to: "/kb/$kbId/settings", params: { kbId: id } });
}
}}
/>
)}
</div>
</div>
);
}
/** 新建知识库弹窗:缺省 restricted,不污染全员切换器。
**建库不是系统管理员专属**——工作区 Admin 起就能建(见 api/kbs.rs 的
create),所以它住在人人都会来的这一页,不在 Administration 里 */
function NewKbModal({
workspaceId,
onDone,
}: {
workspaceId: string;
onDone: (id?: string) => void;
}) {
const [name, setName] = useState("");
const [desc, setDesc] = useState("");
const [restricted, setRestricted] = useState(true);
// 默认一个包都不勾(#580)。从前预勾 schema.org,理由是"要一个已经能认出人、
// 组织、产品的起点";量过之后本体从文档里长出来的是库自己的十几个类,而 915 个
// 类的包让每块抽取提示词从 2k 涨到 18k tokens。要包的人在这里勾
const [packs, setPacks] = useState<string[]>([]);
const available = useQuery({
queryKey: ["ontologyPacks"],
queryFn: api.ontologyPacks,
});
// 勾选顺序即安装顺序:第一个包的类会认领同名的种子类,
// 后面的撞名才查得到对齐表。所以取消再勾会排到末尾——这是对的
const toggle = (id: string) =>
setPacks((prev) =>
prev.includes(id) ? prev.filter((p) => p !== id) : [...prev, id],
);
const create = useMutation({
mutationFn: () =>
api.createKb(workspaceId, {
name: name.trim(),
description: desc.trim() || null,
visibility: restricted ? "restricted" : "open",
ontology_packs: packs,
}),
onSuccess: (kb) => onDone(kb.id),
});
return (
<Dialog
open
onOpenChange={(o) => !o && onDone()}
title={S.settings.kbs.newKb}
closeLabel={S.ui.close}
width="sm"
footer={
<>
<Button variant="secondary" size="sm" onClick={() => onDone()}>
{S.library.cancel}
</Button>
<Button
variant="primary"
size="sm"
disabled={!name.trim() || create.isPending}
onClick={() => create.mutate()}
>
{S.settings.kbs.create}
</Button>
</>
}
>
<div>
<Input className="w-full mb-2"
autoFocus
placeholder={S.settings.kbs.name}
value={name}
onChange={(e) => setName(e.target.value)}
/>
<Input className="w-full mb-3"
placeholder={S.settings.kbs.description}
value={desc}
onChange={(e) => setDesc(e.target.value)}
/>
<Checkbox
className="mb-4"
checked={restricted}
onChange={(v) => setRestricted(v)}
label={S.settings.kbs.visRestricted}
/>
{/* 包是可选的,而且**多半只装一个**:五张卡片铺开占了这张弹窗一多半,
换成搜着选——说明与规模挪进下拉里的次要文案,选中的堆在框上面 */}
<Field label={S.settings.kbs.packsLabel} hint={S.settings.kbs.packsHint}>
<MultiSearchSelect
className="w-full"
values={packs}
options={(available.data?.packs ?? []).map((p) => ({
value: p.id,
label: p.name,
hint: `${p.summary} · ${S.settings.kbs.packsCount(p.classes, p.properties)}`,
}))}
placeholder={S.settings.kbs.packsPick}
emptyHint={S.settings.kbs.packsNone}
onToggle={toggle}
/>
</Field>
{create.isError && (
<p className="text-small text-danger mb-2">
{(create.error as Error).message}
</p>
)}
</div>
</Dialog>
);
}