World's first open-source enterprise world model.
Rust agent-memorybitemporalgraphragknowledge-baseknowledge-graphllmontologypgvectorpostgresqlragrustself-hostedsemantic-searchtemporal-knowledge-graphworld-model
/* 个人访问令牌页(docs/decisions/0014,0016 的 A2)。
令牌属于人、以人的身份行事:有效权限 = 角色 ∩ scope,`kb_ids` 只收窄不授权。
服务端三个端点早就在(发放 / 列表 / 撤销),缺的只是这一页——没有它,
MCP 对用户就是「有 API、配不了」。
明文只在发放那一次的响应里出现,所以这一页的重心是那一刻:把令牌和一段可复制的
客户端配置一起端出来,人复制完点「完成」,之后列表里只剩前缀。 */
import { useMemo, useState } from "react";
import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
import { Check, Copy, KeyRound, Plus } from "lucide-react";
import { api, type TokenView } from "../api";
import { S } from "../i18n";
import { useKb } from "../kb";
import {
Button,
Chip,
Dialog,
Dropdown,
Field,
Input,
Loading,
MultiSearchSelect,
PageHeader,
RadioGroup,
Table,
TBody,
Td,
Th,
THead,
Tr,
buttonLike,
localDate,
} from "../ui";
import { toast } from "../toast";
import { copyAndSay } from "../clipboard";
import { kbOptions } from "./kbGroups";
const EXPIRY_CHOICES = [30, 90, 365, 0] as const;
/** Claude Code / Claude Desktop 一族的 Streamable HTTP 写法。每个库一个端点(0014:
* 令牌限定到库,端点也按库分),所以片段里要把库选出来 */
function mcpSnippet(kbId: string, kbName: string, token: string): string {
const slug = kbName
.toLowerCase()
.replace(/[^a-z0-9]+/g, "-")
.replace(/^-+|-+$/g, "") || "kb";
const cfg = {
mcpServers: {
[`utopia-${slug}`]: {
type: "http",
url: `${window.location.origin}/api/v1/kbs/${kbId}/mcp`,
headers: { Authorization: `Bearer ${token}` },
},
},
};
return JSON.stringify(cfg, null, 2);
}
function CopyButton({ text, small }: { text: string; small?: boolean }) {
const [done, setDone] = useState(false);
return (
<Button variant="secondary" size="sm"
className={buttonLike("ghost", small ? "sm" : "md")}
onClick={async () => {
// 复制成了才换成「已复制」。从前先换字再复制,在 http 打开的页面上什么也没
// 复制,按钮也照样说已复制
if (!(await copyAndSay(text, S.account.copied))) return;
setDone(true);
setTimeout(() => setDone(false), 1500);
}}
>
{done ? <Check size={12} /> : <Copy size={12} />}
{done ? S.account.copied : S.account.copy}
</Button>
);
}
/** 刚发出来的那一枚:明文 + 配置片段,关掉就再也看不到。
住在发令牌那个弹窗里——发放的下一秒就是"把它抄走",中间不该有一次关窗 */
function IssuedBody({
token,
info,
kbs,
}: {
token: string;
info: TokenView;
kbs: { id: string; name: string }[];
}) {
// 片段默认指向令牌限定的第一个库;没限定就取列表第一个
const candidates = info.kb_ids?.length
? kbs.filter((k) => info.kb_ids!.includes(k.id))
: kbs;
const [kbId, setKbId] = useState(candidates[0]?.id ?? kbs[0]?.id ?? "");
const kb = kbs.find((k) => k.id === kbId);
const snippet = kb ? mcpSnippet(kb.id, kb.name, token) : "";
return (
<div>
<div className="flex items-center gap-2">
<code className="min-w-0 flex-1 truncate rounded-cell bg-well px-3 py-2 font-mono text-small text-ink">
{token}
</code>
<CopyButton text={token} />
</div>
<div className="mt-6 flex items-baseline justify-between gap-3 flex-wrap">
<div className="text-body font-medium text-ink">{S.account.mcpTitle}</div>
{candidates.length > 1 && (
<span className="flex items-center gap-2 text-small text-ink-2">
{S.account.mcpBase}
<Dropdown
size="sm"
className="w-40"
value={kbId}
onChange={setKbId}
options={candidates.map((k) => ({ value: k.id, label: k.name }))}
/>
</span>
)}
</div>
<p className="mt-1 text-small text-ink-2">{S.account.mcpHint}</p>
<div className="mt-2 relative">
<pre className="rounded-panel bg-well px-3 py-2 font-mono text-small text-ink-2 overflow-x-auto u-scroll">
{snippet}
</pre>
<div className="absolute top-1.5 right-1.5">
<CopyButton text={snippet} small />
</div>
</div>
</div>
);
}
function TokenRow({
t,
kbName,
busy,
onRevoke,
}: {
t: TokenView;
kbName: (id: string) => string;
busy: boolean;
onRevoke: () => void;
}) {
// 撤销不可撤回,但代价只是重发一枚——轻确认(二次点击),不做打字解锁
const [arm, setArm] = useState(false);
const revoked = !!t.revoked_at;
const bases = t.kb_ids?.length
? t.kb_ids.map(kbName).join(" · ")
: S.account.allBases;
return (
<Tr className={revoked ? "opacity-55" : undefined}>
<Td>
<div className="flex items-center gap-2">
<KeyRound size={13} className="shrink-0 text-ink-2" />
<span className="truncate text-body text-ink">{t.name}</span>
<code className="shrink-0 font-mono text-fine text-ink-2">
{t.token_prefix}…
</code>
</div>
</Td>
<Td>
<Chip tone={t.scope === "write" ? "warn" : "neutral"}>
{t.scope === "write" ? S.account.scopeWrite : S.account.scopeRead}
</Chip>
</Td>
<Td className="text-small text-ink-2" title={bases}>
{t.kb_ids?.length ? S.account.nBases(t.kb_ids.length) : S.account.allBases}
</Td>
<Td className="u-num text-small text-ink-2">
{t.last_used_at ? localDate(t.last_used_at) : S.account.neverUsed}
</Td>
<Td className="u-num text-small text-ink-2">
{t.expires_at ? localDate(t.expires_at) : S.account.noExpiry}
</Td>
<Td className="u-num text-small text-ink-2">{localDate(t.created_at)}</Td>
<Td className="text-right">
{revoked ? (
<Chip tone="danger">{S.account.revokedOn(localDate(t.revoked_at!))}</Chip>
) : arm ? (
<Button variant="danger" size="sm"
disabled={busy}
onClick={onRevoke}
onBlur={() => setArm(false)}
>
{S.account.revokeConfirm}
</Button>
) : (
<Button variant="secondary" size="sm"
disabled={busy}
onClick={() => setArm(true)}
>
{S.account.revoke}
</Button>
)}
</Td>
</Tr>
);
}
export function Tokens() {
const queryClient = useQueryClient();
const { kbs } = useKb();
const list = useQuery({ queryKey: ["tokens"], queryFn: api.tokens });
// 发令牌是个动作,不是这一页的常驻内容:表单住在弹窗里,页面上只有名单
const [creating, setCreating] = useState(false);
const [name, setName] = useState("");
const [scope, setScope] = useState<"read" | "write">("read");
const [picked, setPicked] = useState<Set<string>>(new Set());
const [days, setDays] = useState<number>(90);
const [issued, setIssued] = useState<{ token: string; info: TokenView } | null>(null);
const issue = useMutation({
mutationFn: () =>
api.issueToken({
name: name.trim(),
scope,
kb_ids: picked.size ? Array.from(picked) : null,
expires_in_days: days,
}),
onSuccess: (res) => {
// 同一个窗口换一副内容:发完立刻是"把它抄走",明文只有这一次
setIssued(res);
setName("");
setPicked(new Set());
queryClient.invalidateQueries({ queryKey: ["tokens"] });
},
onError: (e) => toast.error((e as Error).message),
});
const revoke = useMutation({
mutationFn: (id: string) => api.revokeToken(id),
onSettled: () => queryClient.invalidateQueries({ queryKey: ["tokens"] }),
onError: (e) => toast.error((e as Error).message),
});
const kbName = useMemo(() => {
const m = new Map(kbs.map((k) => [k.id, k.name]));
return (id: string) => m.get(id) ?? id.slice(0, 8);
}, [kbs]);
if (list.isPending) return <Loading>{S.nav.loading}</Loading>;
// 活的在前、按新到旧;撤销过的沉底但仍然列着——撤过这件事本身要看得见
const rows = [...(list.data?.tokens ?? [])].sort((a, b) => {
if (!!a.revoked_at !== !!b.revoked_at) return a.revoked_at ? 1 : -1;
return b.created_at.localeCompare(a.created_at);
});
const close = () => {
setCreating(false);
setIssued(null);
};
return (
<div className="px-8 py-6">
{/* 与管理页同一副身材:内容居中限宽,行长不随窗口拉长 */}
<div className="mx-auto w-full max-w-4xl">
<PageHeader
title={S.account.tokensTitle}
sub={S.account.tokensHint}
actions={
<Button variant="primary" size="sm" onClick={() => setCreating(true)}>
<Plus size={12} />
{S.account.newToken}
</Button>
}
/>
{rows.length === 0 ? (
<div className="glass rounded-panel p-8 text-center text-body text-ink-2">
{S.account.noTokens}
</div>
) : (
<div className="glass rounded-panel overflow-hidden">
<Table>
<THead>
<Tr>
<Th>{S.account.tokenName}</Th>
<Th>{S.account.tokenScope}</Th>
<Th>{S.account.tokenKbs}</Th>
<Th>{S.account.colLastUsed}</Th>
<Th>{S.account.tokenExpires}</Th>
<Th>{S.account.colCreated}</Th>
<Th />
</Tr>
</THead>
<TBody>
{rows.map((t) => (
<TokenRow
key={t.id}
t={t}
kbName={kbName}
busy={revoke.isPending && revoke.variables === t.id}
onRevoke={() => revoke.mutate(t.id)}
/>
))}
</TBody>
</Table>
</div>
)}
{/* 一个窗口两副内容:先是表单,发出来之后是那一枚明文。中间不关窗——
关掉就再也看不到它了 */}
<Dialog
open={creating || !!issued}
onOpenChange={(o) => !o && close()}
width={issued ? "lg" : "md"}
closeLabel={S.ui.close}
title={issued ? S.account.issuedTitle : S.account.newToken}
description={issued ? S.account.issuedHint : undefined}
footer={
issued ? (
<Button variant="primary" size="sm" onClick={close}>
{S.account.tokenDone}
</Button>
) : (
<>
<Button variant="secondary" size="sm" onClick={close}>
{S.account.cancel}
</Button>
<Button variant="primary" size="sm"
disabled={!name.trim() || issue.isPending}
onClick={() => issue.mutate()}
>
{S.account.issueToken}
</Button>
</>
)
}
>
{issued ? (
<IssuedBody token={issued.token} info={issued.info} kbs={kbs} />
) : (
<div>
<Field label={S.account.tokenName}>
<Input className="w-full"
autoFocus
placeholder={S.account.tokenNamePlaceholder}
value={name}
maxLength={64}
onChange={(e) => setName(e.target.value)}
/>
</Field>
{/* 范围与有效期并排:两个都是一眼扫过去就定下来的小选择,
各占一整行只是把这张表拉长 */}
<div className="grid grid-cols-2 gap-4">
{/* 二选一,且两个选项都要读得到——单选按钮,不是一排按钮 */}
<Field label={S.account.tokenScope} hint={S.account.scopeHint}>
<RadioGroup
name="token-scope"
className="flex h-8 flex-row items-center gap-4"
value={scope}
onChange={(v) => setScope(v)}
options={[
{ value: "read" as const, label: S.account.scopeRead },
{ value: "write" as const, label: S.account.scopeWrite },
]}
/>
</Field>
<Field label={S.account.tokenExpires}>
<Dropdown
className="w-full"
value={String(days)}
onChange={(v) => setDays(Number(v))}
options={EXPIRY_CHOICES.map((d) => ({
value: String(d),
label: d === 0 ? S.account.expiresNever : S.account.expiresDays(d),
}))}
/>
</Field>
</div>
{/* 库可以很多:搜着选,选中的堆在框上面。芯片墙的高度随库数长,
这个不随。**不再另写一句「不选就是全部」**——控件自己就写着
「All bases」,同一件事说两遍只是把表单拉长 */}
<Field label={S.account.tokenKbs} className="mb-0">
<MultiSearchSelect
className="w-full"
values={Array.from(picked)}
options={kbOptions(kbs)}
placeholder={S.account.pickBases}
emptyHint={S.account.allBases}
onToggle={(id) => {
const next = new Set(picked);
if (next.has(id)) next.delete(id);
else next.add(id);
setPicked(next);
}}
/>
</Field>
</div>
)}
</Dialog>
</div>
</div>
);
}