@njuptlzf/agent-chat-web 0.1.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/AgentChat.d.ts +28 -0
- package/dist/AgentChat.js +355 -0
- package/dist/AgentChatApp.d.ts +31 -0
- package/dist/AgentChatApp.js +90 -0
- package/dist/DockPanel.d.ts +22 -0
- package/dist/DockPanel.js +22 -0
- package/dist/PersonasPage.d.ts +1 -0
- package/dist/PersonasPage.js +318 -0
- package/dist/adapter.d.ts +52 -0
- package/dist/adapter.js +242 -0
- package/dist/app-def-check.d.ts +50 -0
- package/dist/app-def-check.js +184 -0
- package/dist/app.d.ts +112 -0
- package/dist/app.js +174 -0
- package/dist/auth.d.ts +41 -0
- package/dist/auth.js +86 -0
- package/dist/dock.d.ts +52 -0
- package/dist/dock.js +132 -0
- package/dist/docs.d.ts +48 -0
- package/dist/docs.js +178 -0
- package/dist/index.d.ts +17 -0
- package/dist/index.js +8 -0
- package/dist/mount.d.ts +50 -0
- package/dist/mount.js +38 -0
- package/dist/qual.d.ts +21 -0
- package/dist/qual.js +53 -0
- package/dist/sse.d.ts +14 -0
- package/dist/sse.js +99 -0
- package/dist/styles.css +1478 -0
- package/dist/theme.d.ts +10 -0
- package/dist/theme.js +14 -0
- package/dist/ui/CodeCopyHeader.d.ts +7 -0
- package/dist/ui/CodeCopyHeader.js +22 -0
- package/dist/ui/ConfirmCard.d.ts +15 -0
- package/dist/ui/ConfirmCard.js +9 -0
- package/dist/ui/Lightbox.d.ts +6 -0
- package/dist/ui/Lightbox.js +31 -0
- package/dist/ui/QueueBar.d.ts +44 -0
- package/dist/ui/QueueBar.js +17 -0
- package/dist/ui/Splitter.d.ts +27 -0
- package/dist/ui/Splitter.js +61 -0
- package/dist/ui/ThemeToggle.d.ts +2 -0
- package/dist/ui/ThemeToggle.js +16 -0
- package/dist/ui/TierPicker.d.ts +14 -0
- package/dist/ui/TierPicker.js +54 -0
- package/dist/ui/UIPromptCard.d.ts +17 -0
- package/dist/ui/UIPromptCard.js +18 -0
- package/dist/ui/timefmt.d.ts +35 -0
- package/dist/ui/timefmt.js +110 -0
- package/dist/ui/useNarrow.d.ts +7 -0
- package/dist/ui/useNarrow.js +15 -0
- package/package.json +72 -68
- package/src/App.tsx +13 -0
- package/src/agent-chat/AgentChat.tsx +692 -692
- package/src/agent-chat/AgentChatApp.tsx +206 -206
- package/src/agent-chat/{Dock.tsx → DockPanel.tsx} +73 -73
- package/src/agent-chat/PersonasPage.tsx +678 -678
- package/src/agent-chat/adapter.ts +272 -272
- package/src/agent-chat/app-def-check.ts +215 -215
- package/src/agent-chat/app.tsx +327 -327
- package/src/agent-chat/auth.ts +83 -83
- package/src/agent-chat/dock.ts +161 -161
- package/src/agent-chat/docs.ts +179 -179
- package/src/agent-chat/index.ts +17 -17
- package/src/agent-chat/mount.tsx +123 -123
- package/src/agent-chat/qual.ts +55 -55
- package/src/agent-chat/sse.ts +104 -104
- package/src/agent-chat/theme.ts +23 -23
- package/src/agent-chat/ui/CodeCopyHeader.tsx +29 -29
- package/src/agent-chat/ui/ConfirmCard.tsx +32 -32
- package/src/agent-chat/ui/Lightbox.tsx +32 -32
- package/src/agent-chat/ui/QueueBar.tsx +70 -70
- package/src/agent-chat/ui/Splitter.tsx +81 -81
- package/src/agent-chat/ui/ThemeToggle.tsx +25 -25
- package/src/agent-chat/ui/TierPicker.tsx +112 -112
- package/src/agent-chat/ui/UIPromptCard.tsx +68 -68
- package/src/agent-chat/ui/timefmt.ts +110 -110
- package/src/agent-chat/ui/useNarrow.ts +20 -20
- package/src/fake-product/entry.tsx +54 -0
- package/src/main.tsx +8 -0
- package/src/styles.css +1478 -1478
package/src/agent-chat/app.tsx
CHANGED
|
@@ -1,327 +1,327 @@
|
|
|
1
|
-
import { useEffect, useRef, useState } from "react";
|
|
2
|
-
import type { ReactNode } from "react";
|
|
3
|
-
import type { BrandingResponse, ProductOption, WhoamiResponse } from "@njuptlzf/agent-chat-protocol";
|
|
4
|
-
import { Splitter, usePaneWidth } from "./ui/Splitter.tsx";
|
|
5
|
-
import ThemeToggle from "./ui/ThemeToggle.tsx";
|
|
6
|
-
import { auth, DEV_USERS, devIdentityEnabled } from "./auth.ts";
|
|
7
|
-
import { confirmInterrupt } from "./dock.ts";
|
|
8
|
-
import { fetchJson } from "./sse.ts";
|
|
9
|
-
import { currentQual, isEnabled, qualFromHash, saveQual } from "./qual.ts";
|
|
10
|
-
|
|
11
|
-
/**
|
|
12
|
-
* 通用应用壳——「导航注册表」的 core 侧。
|
|
13
|
-
*
|
|
14
|
-
* 组合根(App.tsx,产品侧)只做三件事:声明 `AppDef`(路由表/导航规则/守卫/页面)、
|
|
15
|
-
* 调 `useAppHost(def)`、把结果交给 `<AppShell>` 与 `<Dock>`。产品事实全部住在
|
|
16
|
-
* def 里;本文件不 import 任何业务代码(boundary ② 守着)。
|
|
17
|
-
*
|
|
18
|
-
* 从 App.tsx / Shell.tsx 外置的机制(2026-11-03):branding/whoami 拉取、hash 路由、
|
|
19
|
-
* 老链接改写、守卫弹回、主题变量、lastBiz 回退、选项偏好(qual.ts)、DevIdentity。
|
|
20
|
-
*/
|
|
21
|
-
|
|
22
|
-
/** 宿主交给 def 的上下文:页面渲染、导航规则、守卫都从这拿数据。 */
|
|
23
|
-
export interface HostCtx {
|
|
24
|
-
branding: BrandingResponse;
|
|
25
|
-
who: WhoamiResponse | null;
|
|
26
|
-
qual: ProductOption | null;
|
|
27
|
-
/** 当前 hash 路由(未做高亮归并前的原始值)。 */
|
|
28
|
-
route: string;
|
|
29
|
-
/** 当前人格:"" = 默认助手,否则是 branding.personas 的键。 */
|
|
30
|
-
persona: string;
|
|
31
|
-
/** 选项页显示中(#/quals 或全部选项被禁用):页面表应渲染选项页。 */
|
|
32
|
-
onQuals: boolean;
|
|
33
|
-
go(route: string): void;
|
|
34
|
-
/** 切换选项(确认框文案取当前助手的人格名;同 id 静默保存)。 */
|
|
35
|
-
pickQual(id: string): void;
|
|
36
|
-
}
|
|
37
|
-
|
|
38
|
-
export interface NavItem {
|
|
39
|
-
route: string;
|
|
40
|
-
label: string;
|
|
41
|
-
}
|
|
42
|
-
|
|
43
|
-
/** 产品的导航注册表:路由表、条目规则、守卫、页面渲染,全是产品事实。 */
|
|
44
|
-
export interface AppDef {
|
|
45
|
-
/** 收起聊天坞时退回的业务页(lastBiz 的初始值)。 */
|
|
46
|
-
home: string;
|
|
47
|
-
/**
|
|
48
|
-
* 聊天坞的路由键(Dock 是常驻能力,这个 hash 只让它撑满内容区)。
|
|
49
|
-
* 由产品声明——人格 id 是产品事实,core 不认识(守卫会红)。
|
|
50
|
-
*/
|
|
51
|
-
chatRoute: string;
|
|
52
|
-
/** 路由键 → 导航文案。键集 = 合法 hash 路由;文案进侧栏。 */
|
|
53
|
-
routes: Record<string, string>;
|
|
54
|
-
/**
|
|
55
|
-
* 老链接就地改写:键不存在于页面表,见到就 replaceState 到值路由
|
|
56
|
-
* (用 replaceState 而不是改 hash,避免 hashchange 再触发一轮渲染闪一帧)。
|
|
57
|
-
*/
|
|
58
|
-
rewrites?: Record<string, string>;
|
|
59
|
-
/** 高亮归属:某路由的导航高亮留在另一项上(如刷内容是产品页的另一种节奏)。 */
|
|
60
|
-
navAlias?: Record<string, string>;
|
|
61
|
-
/** 侧栏条目与顺序(科目→页面、闸→可见性都是产品事实)。 */
|
|
62
|
-
navItems(ctx: HostCtx): NavItem[];
|
|
63
|
-
/**
|
|
64
|
-
* 守卫:返回应弹回的路由;null/undefined = 留在原地。只在闸启用且本人非
|
|
65
|
-
* admin 时被调用(App.tsx 原注释:显隐是体验不是安全边界,端点自己会 403)。
|
|
66
|
-
*/
|
|
67
|
-
guard?(route: string, ctx: HostCtx): string | null;
|
|
68
|
-
/** 页面渲染:路由 → 内容(onQuals 在 ctx 里:onQuals 时任何路由都渲染选项页)。 */
|
|
69
|
-
page(ctx: HostCtx): ReactNode;
|
|
70
|
-
/** 工具产物卡的渲染器(可选):core 只透传 details,形状由产品契约解释。 */
|
|
71
|
-
cardRenderer?(details: unknown): ReactNode;
|
|
72
|
-
/** 产品自定的界面文案;core 只提供通用兜底,不写死任何产品词。 */
|
|
73
|
-
labels?: { switchConfirm?: string; switchTitle?: string };
|
|
74
|
-
}
|
|
75
|
-
|
|
76
|
-
function routeFromHash(def: AppDef): string {
|
|
77
|
-
const m = /^#\/([a-z]+)/.exec(window.location.hash);
|
|
78
|
-
return m && m[1] in def.routes ? m[1] : def.chatRoute;
|
|
79
|
-
}
|
|
80
|
-
|
|
81
|
-
/** 主题变量:调色板默认值在 styles.css(root),这里只做覆盖注入 + 老别名。 */
|
|
82
|
-
export function themeVarsOf(branding: BrandingResponse): React.CSSProperties {
|
|
83
|
-
const theme: Record<string, string> = { ...(branding.theme ?? {}) };
|
|
84
|
-
// Legacy alias: manifests written before batch 12 themed with --chat-primary.
|
|
85
|
-
if (theme["--chat-primary"] && !theme["--ac-primary"]) theme["--ac-primary"] = theme["--chat-primary"];
|
|
86
|
-
return theme as React.CSSProperties;
|
|
87
|
-
}
|
|
88
|
-
|
|
89
|
-
/**
|
|
90
|
-
* 宿主状态机:branding/whoami/选项偏好/人格/hash 路由/守卫,全部通用机制。
|
|
91
|
-
* 返回值里 `shown` 是导航高亮应落在的路由(选项页与 navAlias 归并后)。
|
|
92
|
-
*/
|
|
93
|
-
export function useAppHost(def: AppDef) {
|
|
94
|
-
const [route, setRoute] = useState<string>(() => routeFromHash(def));
|
|
95
|
-
// 人格:入口决定身份,不由模型自述。切人格 = 换一个会话(会话绑死人格)。
|
|
96
|
-
const [persona, setPersona] = useState("");
|
|
97
|
-
const [branding, setBranding] = useState<BrandingResponse | null>(null);
|
|
98
|
-
const [loadError, setLoadError] = useState<string | null>(null);
|
|
99
|
-
// 当前选项 id:本地偏好优先;branding 加载后没有偏好也回落第一个可用选项
|
|
100
|
-
// (currentQual 的兜底),所以初始就是 null——「没选过就强制选」的旧设计
|
|
101
|
-
// 已被这个兜底击穿,不要复活它(2026-11-03 死代码清理)。
|
|
102
|
-
const [qualId, setQualId] = useState<string | null>(null);
|
|
103
|
-
// 首帧快照:深链带的选项必须在页面的 effect 改写 hash 之前读走——子组件 effect
|
|
104
|
-
// 先跑,产品页/业务数据页会 replaceState 重写 hash(丢掉 qual),晚一步就没了。
|
|
105
|
-
const [bootQual] = useState<string | null>(() => qualFromHash(window.location.hash));
|
|
106
|
-
// 从聊天页收起坞时退回到最近一个业务页(没有就退 def.home)。
|
|
107
|
-
const lastBiz = useRef<string>(def.home);
|
|
108
|
-
// 「我是谁」:token 在 boot 定死不会变,拉一次就够;失败(未登录/
|
|
109
|
-
// 服务旧版没有 whoami)留 null = 导航照常显示——显隐是体验,边界在端点自己。
|
|
110
|
-
const [who, setWho] = useState<WhoamiResponse | null>(null);
|
|
111
|
-
|
|
112
|
-
useEffect(() => {
|
|
113
|
-
fetchJson<BrandingResponse>("/api/branding")
|
|
114
|
-
.then((b) => {
|
|
115
|
-
setBranding(b);
|
|
116
|
-
// 深链指定了选项且它在目录里可用 → 以深链为准(静默保存,不弹确认框);
|
|
117
|
-
// 否则沿用旧规则:本地偏好失效(选项被下线/改名)时回落第一个可用。
|
|
118
|
-
const wanted = bootQual ? b.quals?.find((q) => q.id === bootQual && isEnabled(q)) : undefined;
|
|
119
|
-
if (wanted) {
|
|
120
|
-
saveQual(wanted.id);
|
|
121
|
-
setQualId(wanted.id);
|
|
122
|
-
} else {
|
|
123
|
-
setQualId((id) => currentQual(b.quals)?.id ?? id);
|
|
124
|
-
}
|
|
125
|
-
})
|
|
126
|
-
.catch((e) => setLoadError(String(e)));
|
|
127
|
-
}, []);
|
|
128
|
-
|
|
129
|
-
useEffect(() => {
|
|
130
|
-
fetchJson<WhoamiResponse>("/api/whoami", auth.token)
|
|
131
|
-
.then(setWho)
|
|
132
|
-
.catch(() => {});
|
|
133
|
-
}, []);
|
|
134
|
-
|
|
135
|
-
useEffect(() => {
|
|
136
|
-
const onHash = () => {
|
|
137
|
-
setRoute(routeFromHash(def));
|
|
138
|
-
// 深链带选项(助手回复里的贴链):静默切过去——不弹确认框(贴链的人意图明确),
|
|
139
|
-
// 也不 go(chatRoute) 离开当前页。未知/被禁用的选项忽略,页面按当前选项给错,
|
|
140
|
-
// 不静默改道(用户会以为链接坏了)。
|
|
141
|
-
const want = qualFromHash(window.location.hash);
|
|
142
|
-
const hit = want ? branding?.quals?.find((q) => q.id === want && isEnabled(q)) : undefined;
|
|
143
|
-
if (hit) {
|
|
144
|
-
saveQual(hit.id);
|
|
145
|
-
setQualId((cur) => (cur === hit.id ? cur : hit.id));
|
|
146
|
-
}
|
|
147
|
-
};
|
|
148
|
-
window.addEventListener("hashchange", onHash);
|
|
149
|
-
return () => window.removeEventListener("hashchange", onHash);
|
|
150
|
-
}, [def, branding]);
|
|
151
|
-
|
|
152
|
-
// 老链接改写:`#/wrong` 这类历史路由就地 replaceState(见 AppDef.rewrites)。
|
|
153
|
-
// 值可以带 query(如 "record?tab=wrong"):hash 整体替换,路由状态只取路径部分。
|
|
154
|
-
useEffect(() => {
|
|
155
|
-
const target = def.rewrites?.[route];
|
|
156
|
-
if (!target) return;
|
|
157
|
-
const url = new URL(window.location.href);
|
|
158
|
-
url.hash = `#/${target}`;
|
|
159
|
-
window.history.replaceState(null, "", url.toString().slice(url.origin.length));
|
|
160
|
-
setRoute(target.split("?")[0]!);
|
|
161
|
-
}, [route, def]);
|
|
162
|
-
|
|
163
|
-
const go = (r: string) => {
|
|
164
|
-
if (r !== def.chatRoute) lastBiz.current = r;
|
|
165
|
-
window.location.hash = `#/${r}`;
|
|
166
|
-
setRoute(r);
|
|
167
|
-
};
|
|
168
|
-
|
|
169
|
-
// 切选项:换选项会换助手、换会话,正在跑的那一轮就没了——先问一句。
|
|
170
|
-
// 确认文案取当前助手的人格名(branding.personas 都带 label;老服务端
|
|
171
|
-
// 没有时回落 persona id——只影响确认框文案,不影响行为)。
|
|
172
|
-
const pickQual = (id: string) => {
|
|
173
|
-
const current = persona || branding?.defaultPersona || "";
|
|
174
|
-
const label = branding?.personas?.[current]?.label ?? current ?? "助手";
|
|
175
|
-
if (id !== qualId && !confirmInterrupt(def.labels?.switchConfirm ?? "切换选项", label)) return;
|
|
176
|
-
saveQual(id);
|
|
177
|
-
setQualId(id);
|
|
178
|
-
go(def.chatRoute);
|
|
179
|
-
};
|
|
180
|
-
|
|
181
|
-
const quals = branding?.quals ?? [];
|
|
182
|
-
const qual = branding?.quals?.find((q) => q.id === qualId) ?? null;
|
|
183
|
-
// 显示选项页的两种情况:用户点了「切换」(#/quals),或**全部选项被禁用**
|
|
184
|
-
// (此时 currentQual 落空、qual 为 null——展示全「即将上线」的选择页是合理死端)。
|
|
185
|
-
// 「没选过偏好就强制选」永远不会发生(回落兜底),别把它加回来。
|
|
186
|
-
const onQuals = (quals.length > 0 && qual === null) || route === "quals";
|
|
187
|
-
const ctx: HostCtx | null = branding
|
|
188
|
-
? { branding, who, qual, route, persona, onQuals, go, pickQual }
|
|
189
|
-
: null;
|
|
190
|
-
|
|
191
|
-
// 直接敲受限路由进来的人(老链接、助手回复里的贴链):闸启用且不是 admin,
|
|
192
|
-
// 回能去的页——导航里已经没有这些入口了,停在一个进不去的 hash 只是难堪。
|
|
193
|
-
useEffect(() => {
|
|
194
|
-
if (!ctx || !def.guard || !who?.authzEnabled || who.roles.includes("admin")) return;
|
|
195
|
-
const target = def.guard(route, ctx);
|
|
196
|
-
if (target) window.location.hash = `#/${target}`;
|
|
197
|
-
}, [ctx, def, who, route]);
|
|
198
|
-
|
|
199
|
-
const shown = onQuals ? "quals" : (def.navAlias?.[route] ?? route);
|
|
200
|
-
|
|
201
|
-
return {
|
|
202
|
-
/** false = branding 还没回来(宿主应显示加载中)。 */
|
|
203
|
-
ready: branding !== null,
|
|
204
|
-
loadError,
|
|
205
|
-
branding: branding!,
|
|
206
|
-
who,
|
|
207
|
-
quals,
|
|
208
|
-
qual,
|
|
209
|
-
qualId,
|
|
210
|
-
route,
|
|
211
|
-
shown,
|
|
212
|
-
onQuals,
|
|
213
|
-
persona,
|
|
214
|
-
setPersona,
|
|
215
|
-
go,
|
|
216
|
-
/** 收起聊天坞:回到最近一个业务页(没有业务页历史就回 def.home)。 */
|
|
217
|
-
closeChat: () => go(lastBiz.current),
|
|
218
|
-
pickQual,
|
|
219
|
-
/** 守卫后的页面渲染入口(组合根直接调 def.page 也行;这里给齐 ctx)。 */
|
|
220
|
-
ctx,
|
|
221
|
-
};
|
|
222
|
-
}
|
|
223
|
-
|
|
224
|
-
/**
|
|
225
|
-
* 侧栏(呈现层):品牌区 + 选项切换 + 导航 + 底部产品入口 + 开发身份。
|
|
226
|
-
* 导航条目由 def.navItems 算好传进来;本组件只管渲染。
|
|
227
|
-
*/
|
|
228
|
-
export function AppShell({
|
|
229
|
-
branding,
|
|
230
|
-
qual,
|
|
231
|
-
route,
|
|
232
|
-
nav,
|
|
233
|
-
who,
|
|
234
|
-
onRoute,
|
|
235
|
-
onQuals,
|
|
236
|
-
switchTitle,
|
|
237
|
-
footer,
|
|
238
|
-
children,
|
|
239
|
-
}: {
|
|
240
|
-
branding: BrandingResponse;
|
|
241
|
-
qual: ProductOption | null;
|
|
242
|
-
/** 导航高亮应落在的路由(host 已归并 quals/navAlias)。 */
|
|
243
|
-
route: string;
|
|
244
|
-
nav: NavItem[];
|
|
245
|
-
who: WhoamiResponse | null;
|
|
246
|
-
onRoute: (r: string) => void;
|
|
247
|
-
onQuals: () => void;
|
|
248
|
-
/** 切换按钮的悬浮文案,由产品注入。 */
|
|
249
|
-
switchTitle?: string;
|
|
250
|
-
/** 侧栏底部的产品入口(声明人格/反馈问题),由组合根渲染。 */
|
|
251
|
-
footer?: ReactNode;
|
|
252
|
-
children: ReactNode;
|
|
253
|
-
}) {
|
|
254
|
-
const navWidth = usePaneWidth("shellnav.width", 150, 120, 280);
|
|
255
|
-
return (
|
|
256
|
-
<>
|
|
257
|
-
<aside className="side shellnav" style={{ flexBasis: navWidth.width }}>
|
|
258
|
-
<div className="brand">
|
|
259
|
-
{branding.logo ? <img className="logo" src={branding.logo} alt="" /> : null}
|
|
260
|
-
<span>{branding.title}</span>
|
|
261
|
-
<ThemeToggle />
|
|
262
|
-
</div>
|
|
263
|
-
{qual && (
|
|
264
|
-
<button className="qual-pick" onClick={onQuals} title={switchTitle ?? "切换选项"}>
|
|
265
|
-
<span className="qual-name">{qual.label}</span>
|
|
266
|
-
<span className="qual-switch">切换</span>
|
|
267
|
-
</button>
|
|
268
|
-
)}
|
|
269
|
-
<nav className="nav">
|
|
270
|
-
{nav.map((item) => (
|
|
271
|
-
<button
|
|
272
|
-
key={item.route}
|
|
273
|
-
className={item.route === route ? "nav-item on" : "nav-item"}
|
|
274
|
-
onClick={() => onRoute(item.route)}
|
|
275
|
-
>
|
|
276
|
-
{item.label}
|
|
277
|
-
</button>
|
|
278
|
-
))}
|
|
279
|
-
</nav>
|
|
280
|
-
{footer}
|
|
281
|
-
{devIdentityEnabled && <DevIdentity who={who} />}
|
|
282
|
-
</aside>
|
|
283
|
-
<Splitter {...navWidth.handlers} />
|
|
284
|
-
{children}
|
|
285
|
-
</>
|
|
286
|
-
);
|
|
287
|
-
}
|
|
288
|
-
|
|
289
|
-
/**
|
|
290
|
-
* 开发身份条(补):dev 后端(未设 AUTH_JWT_SECRET)的身份来自 `x-user-id`,
|
|
291
|
-
* 没有这一条浏览器就永远是 anonymous——权限管理页不会出现、会员卡永远是空的。
|
|
292
|
-
* 下拉切换写 localStorage 后整页重载(whoami 在 boot 时拉一次,重载最省事)。
|
|
293
|
-
* 只在 vite dev 构建渲染;角色/会员到期直接显示,方便一眼确认权益是否生效。
|
|
294
|
-
*/
|
|
295
|
-
function DevIdentity({ who }: { who: WhoamiResponse | null }) {
|
|
296
|
-
const current = auth.devUserId ?? "";
|
|
297
|
-
const roles = who?.roles ?? [];
|
|
298
|
-
const plan = roles.includes("admin") ? "管理员" : roles.includes("member") ? "会员" : "普通用户";
|
|
299
|
-
const known = DEV_USERS.some((u) => u.id === current);
|
|
300
|
-
return (
|
|
301
|
-
<div className="dev-id">
|
|
302
|
-
<label className="dev-id-row">
|
|
303
|
-
<span>开发身份</span>
|
|
304
|
-
<select
|
|
305
|
-
value={current}
|
|
306
|
-
onChange={(e) => {
|
|
307
|
-
auth.setDevUserId(e.target.value);
|
|
308
|
-
window.location.reload();
|
|
309
|
-
}}
|
|
310
|
-
aria-label="开发身份"
|
|
311
|
-
>
|
|
312
|
-
{!known && current && <option value={current}>{current}</option>}
|
|
313
|
-
{DEV_USERS.map((u) => (
|
|
314
|
-
<option key={u.id} value={u.id}>
|
|
315
|
-
{u.label}
|
|
316
|
-
</option>
|
|
317
|
-
))}
|
|
318
|
-
</select>
|
|
319
|
-
</label>
|
|
320
|
-
<span className="dev-id-note" title={`${who?.userId ?? current} · ${plan}`}>
|
|
321
|
-
{plan}
|
|
322
|
-
{who?.memberUntil ? ` 至 ${who.memberUntil.slice(5, 10)}` : ""}
|
|
323
|
-
{who?.bannedUntil ? " · 已封禁" : ""}
|
|
324
|
-
</span>
|
|
325
|
-
</div>
|
|
326
|
-
);
|
|
327
|
-
}
|
|
1
|
+
import { useEffect, useRef, useState } from "react";
|
|
2
|
+
import type { ReactNode } from "react";
|
|
3
|
+
import type { BrandingResponse, ProductOption, WhoamiResponse } from "@njuptlzf/agent-chat-protocol";
|
|
4
|
+
import { Splitter, usePaneWidth } from "./ui/Splitter.tsx";
|
|
5
|
+
import ThemeToggle from "./ui/ThemeToggle.tsx";
|
|
6
|
+
import { auth, DEV_USERS, devIdentityEnabled } from "./auth.ts";
|
|
7
|
+
import { confirmInterrupt } from "./dock.ts";
|
|
8
|
+
import { fetchJson } from "./sse.ts";
|
|
9
|
+
import { currentQual, isEnabled, qualFromHash, saveQual } from "./qual.ts";
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* 通用应用壳——「导航注册表」的 core 侧。
|
|
13
|
+
*
|
|
14
|
+
* 组合根(App.tsx,产品侧)只做三件事:声明 `AppDef`(路由表/导航规则/守卫/页面)、
|
|
15
|
+
* 调 `useAppHost(def)`、把结果交给 `<AppShell>` 与 `<Dock>`。产品事实全部住在
|
|
16
|
+
* def 里;本文件不 import 任何业务代码(boundary ② 守着)。
|
|
17
|
+
*
|
|
18
|
+
* 从 App.tsx / Shell.tsx 外置的机制(2026-11-03):branding/whoami 拉取、hash 路由、
|
|
19
|
+
* 老链接改写、守卫弹回、主题变量、lastBiz 回退、选项偏好(qual.ts)、DevIdentity。
|
|
20
|
+
*/
|
|
21
|
+
|
|
22
|
+
/** 宿主交给 def 的上下文:页面渲染、导航规则、守卫都从这拿数据。 */
|
|
23
|
+
export interface HostCtx {
|
|
24
|
+
branding: BrandingResponse;
|
|
25
|
+
who: WhoamiResponse | null;
|
|
26
|
+
qual: ProductOption | null;
|
|
27
|
+
/** 当前 hash 路由(未做高亮归并前的原始值)。 */
|
|
28
|
+
route: string;
|
|
29
|
+
/** 当前人格:"" = 默认助手,否则是 branding.personas 的键。 */
|
|
30
|
+
persona: string;
|
|
31
|
+
/** 选项页显示中(#/quals 或全部选项被禁用):页面表应渲染选项页。 */
|
|
32
|
+
onQuals: boolean;
|
|
33
|
+
go(route: string): void;
|
|
34
|
+
/** 切换选项(确认框文案取当前助手的人格名;同 id 静默保存)。 */
|
|
35
|
+
pickQual(id: string): void;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
export interface NavItem {
|
|
39
|
+
route: string;
|
|
40
|
+
label: string;
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/** 产品的导航注册表:路由表、条目规则、守卫、页面渲染,全是产品事实。 */
|
|
44
|
+
export interface AppDef {
|
|
45
|
+
/** 收起聊天坞时退回的业务页(lastBiz 的初始值)。 */
|
|
46
|
+
home: string;
|
|
47
|
+
/**
|
|
48
|
+
* 聊天坞的路由键(Dock 是常驻能力,这个 hash 只让它撑满内容区)。
|
|
49
|
+
* 由产品声明——人格 id 是产品事实,core 不认识(守卫会红)。
|
|
50
|
+
*/
|
|
51
|
+
chatRoute: string;
|
|
52
|
+
/** 路由键 → 导航文案。键集 = 合法 hash 路由;文案进侧栏。 */
|
|
53
|
+
routes: Record<string, string>;
|
|
54
|
+
/**
|
|
55
|
+
* 老链接就地改写:键不存在于页面表,见到就 replaceState 到值路由
|
|
56
|
+
* (用 replaceState 而不是改 hash,避免 hashchange 再触发一轮渲染闪一帧)。
|
|
57
|
+
*/
|
|
58
|
+
rewrites?: Record<string, string>;
|
|
59
|
+
/** 高亮归属:某路由的导航高亮留在另一项上(如刷内容是产品页的另一种节奏)。 */
|
|
60
|
+
navAlias?: Record<string, string>;
|
|
61
|
+
/** 侧栏条目与顺序(科目→页面、闸→可见性都是产品事实)。 */
|
|
62
|
+
navItems(ctx: HostCtx): NavItem[];
|
|
63
|
+
/**
|
|
64
|
+
* 守卫:返回应弹回的路由;null/undefined = 留在原地。只在闸启用且本人非
|
|
65
|
+
* admin 时被调用(App.tsx 原注释:显隐是体验不是安全边界,端点自己会 403)。
|
|
66
|
+
*/
|
|
67
|
+
guard?(route: string, ctx: HostCtx): string | null;
|
|
68
|
+
/** 页面渲染:路由 → 内容(onQuals 在 ctx 里:onQuals 时任何路由都渲染选项页)。 */
|
|
69
|
+
page(ctx: HostCtx): ReactNode;
|
|
70
|
+
/** 工具产物卡的渲染器(可选):core 只透传 details,形状由产品契约解释。 */
|
|
71
|
+
cardRenderer?(details: unknown): ReactNode;
|
|
72
|
+
/** 产品自定的界面文案;core 只提供通用兜底,不写死任何产品词。 */
|
|
73
|
+
labels?: { switchConfirm?: string; switchTitle?: string };
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
function routeFromHash(def: AppDef): string {
|
|
77
|
+
const m = /^#\/([a-z]+)/.exec(window.location.hash);
|
|
78
|
+
return m && m[1] in def.routes ? m[1] : def.chatRoute;
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
/** 主题变量:调色板默认值在 styles.css(root),这里只做覆盖注入 + 老别名。 */
|
|
82
|
+
export function themeVarsOf(branding: BrandingResponse): React.CSSProperties {
|
|
83
|
+
const theme: Record<string, string> = { ...(branding.theme ?? {}) };
|
|
84
|
+
// Legacy alias: manifests written before batch 12 themed with --chat-primary.
|
|
85
|
+
if (theme["--chat-primary"] && !theme["--ac-primary"]) theme["--ac-primary"] = theme["--chat-primary"];
|
|
86
|
+
return theme as React.CSSProperties;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/**
|
|
90
|
+
* 宿主状态机:branding/whoami/选项偏好/人格/hash 路由/守卫,全部通用机制。
|
|
91
|
+
* 返回值里 `shown` 是导航高亮应落在的路由(选项页与 navAlias 归并后)。
|
|
92
|
+
*/
|
|
93
|
+
export function useAppHost(def: AppDef) {
|
|
94
|
+
const [route, setRoute] = useState<string>(() => routeFromHash(def));
|
|
95
|
+
// 人格:入口决定身份,不由模型自述。切人格 = 换一个会话(会话绑死人格)。
|
|
96
|
+
const [persona, setPersona] = useState("");
|
|
97
|
+
const [branding, setBranding] = useState<BrandingResponse | null>(null);
|
|
98
|
+
const [loadError, setLoadError] = useState<string | null>(null);
|
|
99
|
+
// 当前选项 id:本地偏好优先;branding 加载后没有偏好也回落第一个可用选项
|
|
100
|
+
// (currentQual 的兜底),所以初始就是 null——「没选过就强制选」的旧设计
|
|
101
|
+
// 已被这个兜底击穿,不要复活它(2026-11-03 死代码清理)。
|
|
102
|
+
const [qualId, setQualId] = useState<string | null>(null);
|
|
103
|
+
// 首帧快照:深链带的选项必须在页面的 effect 改写 hash 之前读走——子组件 effect
|
|
104
|
+
// 先跑,产品页/业务数据页会 replaceState 重写 hash(丢掉 qual),晚一步就没了。
|
|
105
|
+
const [bootQual] = useState<string | null>(() => qualFromHash(window.location.hash));
|
|
106
|
+
// 从聊天页收起坞时退回到最近一个业务页(没有就退 def.home)。
|
|
107
|
+
const lastBiz = useRef<string>(def.home);
|
|
108
|
+
// 「我是谁」:token 在 boot 定死不会变,拉一次就够;失败(未登录/
|
|
109
|
+
// 服务旧版没有 whoami)留 null = 导航照常显示——显隐是体验,边界在端点自己。
|
|
110
|
+
const [who, setWho] = useState<WhoamiResponse | null>(null);
|
|
111
|
+
|
|
112
|
+
useEffect(() => {
|
|
113
|
+
fetchJson<BrandingResponse>("/api/branding")
|
|
114
|
+
.then((b) => {
|
|
115
|
+
setBranding(b);
|
|
116
|
+
// 深链指定了选项且它在目录里可用 → 以深链为准(静默保存,不弹确认框);
|
|
117
|
+
// 否则沿用旧规则:本地偏好失效(选项被下线/改名)时回落第一个可用。
|
|
118
|
+
const wanted = bootQual ? b.quals?.find((q) => q.id === bootQual && isEnabled(q)) : undefined;
|
|
119
|
+
if (wanted) {
|
|
120
|
+
saveQual(wanted.id);
|
|
121
|
+
setQualId(wanted.id);
|
|
122
|
+
} else {
|
|
123
|
+
setQualId((id) => currentQual(b.quals)?.id ?? id);
|
|
124
|
+
}
|
|
125
|
+
})
|
|
126
|
+
.catch((e) => setLoadError(String(e)));
|
|
127
|
+
}, []);
|
|
128
|
+
|
|
129
|
+
useEffect(() => {
|
|
130
|
+
fetchJson<WhoamiResponse>("/api/whoami", auth.token)
|
|
131
|
+
.then(setWho)
|
|
132
|
+
.catch(() => {});
|
|
133
|
+
}, []);
|
|
134
|
+
|
|
135
|
+
useEffect(() => {
|
|
136
|
+
const onHash = () => {
|
|
137
|
+
setRoute(routeFromHash(def));
|
|
138
|
+
// 深链带选项(助手回复里的贴链):静默切过去——不弹确认框(贴链的人意图明确),
|
|
139
|
+
// 也不 go(chatRoute) 离开当前页。未知/被禁用的选项忽略,页面按当前选项给错,
|
|
140
|
+
// 不静默改道(用户会以为链接坏了)。
|
|
141
|
+
const want = qualFromHash(window.location.hash);
|
|
142
|
+
const hit = want ? branding?.quals?.find((q) => q.id === want && isEnabled(q)) : undefined;
|
|
143
|
+
if (hit) {
|
|
144
|
+
saveQual(hit.id);
|
|
145
|
+
setQualId((cur) => (cur === hit.id ? cur : hit.id));
|
|
146
|
+
}
|
|
147
|
+
};
|
|
148
|
+
window.addEventListener("hashchange", onHash);
|
|
149
|
+
return () => window.removeEventListener("hashchange", onHash);
|
|
150
|
+
}, [def, branding]);
|
|
151
|
+
|
|
152
|
+
// 老链接改写:`#/wrong` 这类历史路由就地 replaceState(见 AppDef.rewrites)。
|
|
153
|
+
// 值可以带 query(如 "record?tab=wrong"):hash 整体替换,路由状态只取路径部分。
|
|
154
|
+
useEffect(() => {
|
|
155
|
+
const target = def.rewrites?.[route];
|
|
156
|
+
if (!target) return;
|
|
157
|
+
const url = new URL(window.location.href);
|
|
158
|
+
url.hash = `#/${target}`;
|
|
159
|
+
window.history.replaceState(null, "", url.toString().slice(url.origin.length));
|
|
160
|
+
setRoute(target.split("?")[0]!);
|
|
161
|
+
}, [route, def]);
|
|
162
|
+
|
|
163
|
+
const go = (r: string) => {
|
|
164
|
+
if (r !== def.chatRoute) lastBiz.current = r;
|
|
165
|
+
window.location.hash = `#/${r}`;
|
|
166
|
+
setRoute(r);
|
|
167
|
+
};
|
|
168
|
+
|
|
169
|
+
// 切选项:换选项会换助手、换会话,正在跑的那一轮就没了——先问一句。
|
|
170
|
+
// 确认文案取当前助手的人格名(branding.personas 都带 label;老服务端
|
|
171
|
+
// 没有时回落 persona id——只影响确认框文案,不影响行为)。
|
|
172
|
+
const pickQual = (id: string) => {
|
|
173
|
+
const current = persona || branding?.defaultPersona || "";
|
|
174
|
+
const label = branding?.personas?.[current]?.label ?? current ?? "助手";
|
|
175
|
+
if (id !== qualId && !confirmInterrupt(def.labels?.switchConfirm ?? "切换选项", label)) return;
|
|
176
|
+
saveQual(id);
|
|
177
|
+
setQualId(id);
|
|
178
|
+
go(def.chatRoute);
|
|
179
|
+
};
|
|
180
|
+
|
|
181
|
+
const quals = branding?.quals ?? [];
|
|
182
|
+
const qual = branding?.quals?.find((q) => q.id === qualId) ?? null;
|
|
183
|
+
// 显示选项页的两种情况:用户点了「切换」(#/quals),或**全部选项被禁用**
|
|
184
|
+
// (此时 currentQual 落空、qual 为 null——展示全「即将上线」的选择页是合理死端)。
|
|
185
|
+
// 「没选过偏好就强制选」永远不会发生(回落兜底),别把它加回来。
|
|
186
|
+
const onQuals = (quals.length > 0 && qual === null) || route === "quals";
|
|
187
|
+
const ctx: HostCtx | null = branding
|
|
188
|
+
? { branding, who, qual, route, persona, onQuals, go, pickQual }
|
|
189
|
+
: null;
|
|
190
|
+
|
|
191
|
+
// 直接敲受限路由进来的人(老链接、助手回复里的贴链):闸启用且不是 admin,
|
|
192
|
+
// 回能去的页——导航里已经没有这些入口了,停在一个进不去的 hash 只是难堪。
|
|
193
|
+
useEffect(() => {
|
|
194
|
+
if (!ctx || !def.guard || !who?.authzEnabled || who.roles.includes("admin")) return;
|
|
195
|
+
const target = def.guard(route, ctx);
|
|
196
|
+
if (target) window.location.hash = `#/${target}`;
|
|
197
|
+
}, [ctx, def, who, route]);
|
|
198
|
+
|
|
199
|
+
const shown = onQuals ? "quals" : (def.navAlias?.[route] ?? route);
|
|
200
|
+
|
|
201
|
+
return {
|
|
202
|
+
/** false = branding 还没回来(宿主应显示加载中)。 */
|
|
203
|
+
ready: branding !== null,
|
|
204
|
+
loadError,
|
|
205
|
+
branding: branding!,
|
|
206
|
+
who,
|
|
207
|
+
quals,
|
|
208
|
+
qual,
|
|
209
|
+
qualId,
|
|
210
|
+
route,
|
|
211
|
+
shown,
|
|
212
|
+
onQuals,
|
|
213
|
+
persona,
|
|
214
|
+
setPersona,
|
|
215
|
+
go,
|
|
216
|
+
/** 收起聊天坞:回到最近一个业务页(没有业务页历史就回 def.home)。 */
|
|
217
|
+
closeChat: () => go(lastBiz.current),
|
|
218
|
+
pickQual,
|
|
219
|
+
/** 守卫后的页面渲染入口(组合根直接调 def.page 也行;这里给齐 ctx)。 */
|
|
220
|
+
ctx,
|
|
221
|
+
};
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
/**
|
|
225
|
+
* 侧栏(呈现层):品牌区 + 选项切换 + 导航 + 底部产品入口 + 开发身份。
|
|
226
|
+
* 导航条目由 def.navItems 算好传进来;本组件只管渲染。
|
|
227
|
+
*/
|
|
228
|
+
export function AppShell({
|
|
229
|
+
branding,
|
|
230
|
+
qual,
|
|
231
|
+
route,
|
|
232
|
+
nav,
|
|
233
|
+
who,
|
|
234
|
+
onRoute,
|
|
235
|
+
onQuals,
|
|
236
|
+
switchTitle,
|
|
237
|
+
footer,
|
|
238
|
+
children,
|
|
239
|
+
}: {
|
|
240
|
+
branding: BrandingResponse;
|
|
241
|
+
qual: ProductOption | null;
|
|
242
|
+
/** 导航高亮应落在的路由(host 已归并 quals/navAlias)。 */
|
|
243
|
+
route: string;
|
|
244
|
+
nav: NavItem[];
|
|
245
|
+
who: WhoamiResponse | null;
|
|
246
|
+
onRoute: (r: string) => void;
|
|
247
|
+
onQuals: () => void;
|
|
248
|
+
/** 切换按钮的悬浮文案,由产品注入。 */
|
|
249
|
+
switchTitle?: string;
|
|
250
|
+
/** 侧栏底部的产品入口(声明人格/反馈问题),由组合根渲染。 */
|
|
251
|
+
footer?: ReactNode;
|
|
252
|
+
children: ReactNode;
|
|
253
|
+
}) {
|
|
254
|
+
const navWidth = usePaneWidth("shellnav.width", 150, 120, 280);
|
|
255
|
+
return (
|
|
256
|
+
<>
|
|
257
|
+
<aside className="side shellnav" style={{ flexBasis: navWidth.width }}>
|
|
258
|
+
<div className="brand">
|
|
259
|
+
{branding.logo ? <img className="logo" src={branding.logo} alt="" /> : null}
|
|
260
|
+
<span>{branding.title}</span>
|
|
261
|
+
<ThemeToggle />
|
|
262
|
+
</div>
|
|
263
|
+
{qual && (
|
|
264
|
+
<button className="qual-pick" onClick={onQuals} title={switchTitle ?? "切换选项"}>
|
|
265
|
+
<span className="qual-name">{qual.label}</span>
|
|
266
|
+
<span className="qual-switch">切换</span>
|
|
267
|
+
</button>
|
|
268
|
+
)}
|
|
269
|
+
<nav className="nav">
|
|
270
|
+
{nav.map((item) => (
|
|
271
|
+
<button
|
|
272
|
+
key={item.route}
|
|
273
|
+
className={item.route === route ? "nav-item on" : "nav-item"}
|
|
274
|
+
onClick={() => onRoute(item.route)}
|
|
275
|
+
>
|
|
276
|
+
{item.label}
|
|
277
|
+
</button>
|
|
278
|
+
))}
|
|
279
|
+
</nav>
|
|
280
|
+
{footer}
|
|
281
|
+
{devIdentityEnabled && <DevIdentity who={who} />}
|
|
282
|
+
</aside>
|
|
283
|
+
<Splitter {...navWidth.handlers} />
|
|
284
|
+
{children}
|
|
285
|
+
</>
|
|
286
|
+
);
|
|
287
|
+
}
|
|
288
|
+
|
|
289
|
+
/**
|
|
290
|
+
* 开发身份条(补):dev 后端(未设 AUTH_JWT_SECRET)的身份来自 `x-user-id`,
|
|
291
|
+
* 没有这一条浏览器就永远是 anonymous——权限管理页不会出现、会员卡永远是空的。
|
|
292
|
+
* 下拉切换写 localStorage 后整页重载(whoami 在 boot 时拉一次,重载最省事)。
|
|
293
|
+
* 只在 vite dev 构建渲染;角色/会员到期直接显示,方便一眼确认权益是否生效。
|
|
294
|
+
*/
|
|
295
|
+
function DevIdentity({ who }: { who: WhoamiResponse | null }) {
|
|
296
|
+
const current = auth.devUserId ?? "";
|
|
297
|
+
const roles = who?.roles ?? [];
|
|
298
|
+
const plan = roles.includes("admin") ? "管理员" : roles.includes("member") ? "会员" : "普通用户";
|
|
299
|
+
const known = DEV_USERS.some((u) => u.id === current);
|
|
300
|
+
return (
|
|
301
|
+
<div className="dev-id">
|
|
302
|
+
<label className="dev-id-row">
|
|
303
|
+
<span>开发身份</span>
|
|
304
|
+
<select
|
|
305
|
+
value={current}
|
|
306
|
+
onChange={(e) => {
|
|
307
|
+
auth.setDevUserId(e.target.value);
|
|
308
|
+
window.location.reload();
|
|
309
|
+
}}
|
|
310
|
+
aria-label="开发身份"
|
|
311
|
+
>
|
|
312
|
+
{!known && current && <option value={current}>{current}</option>}
|
|
313
|
+
{DEV_USERS.map((u) => (
|
|
314
|
+
<option key={u.id} value={u.id}>
|
|
315
|
+
{u.label}
|
|
316
|
+
</option>
|
|
317
|
+
))}
|
|
318
|
+
</select>
|
|
319
|
+
</label>
|
|
320
|
+
<span className="dev-id-note" title={`${who?.userId ?? current} · ${plan}`}>
|
|
321
|
+
{plan}
|
|
322
|
+
{who?.memberUntil ? ` 至 ${who.memberUntil.slice(5, 10)}` : ""}
|
|
323
|
+
{who?.bannedUntil ? " · 已封禁" : ""}
|
|
324
|
+
</span>
|
|
325
|
+
</div>
|
|
326
|
+
);
|
|
327
|
+
}
|