@njuptlzf/agent-chat-web 0.2.0 → 0.3.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.
Files changed (61) hide show
  1. package/dist/AgentChat.d.ts +7 -1
  2. package/dist/AgentChat.js +23 -5
  3. package/dist/AgentChatApp.d.ts +4 -1
  4. package/dist/AgentChatApp.js +2 -2
  5. package/dist/PersonasPage.js +8 -0
  6. package/dist/assets/_commonjs-dynamic-modules-TDtrdbi3.js +1 -0
  7. package/dist/assets/exceljs.min-jlEt4kSc.js +29 -0
  8. package/dist/assets/index-B7uSE8SM.css +1 -0
  9. package/dist/assets/index-D57mU5H5.js +50 -0
  10. package/dist/assets/index-Dviy7gnB.js +44 -0
  11. package/dist/assets/pdf-CfhDiWmk.js +55 -0
  12. package/dist/assets/pdf.worker.min-CdXBBzB4.js +1 -0
  13. package/dist/assets/pdf.worker.min-CjEcRF4W.mjs +28 -0
  14. package/dist/index.html +13 -0
  15. package/dist/mount.d.ts +7 -1
  16. package/dist/mount.js +2 -2
  17. package/dist/styles.css +1492 -1478
  18. package/dist/suggestions.d.ts +41 -0
  19. package/dist/suggestions.js +98 -0
  20. package/dist/ui/FollowUpSuggestions.d.ts +9 -0
  21. package/dist/ui/FollowUpSuggestions.js +13 -0
  22. package/dist/ui/Icon.d.ts +8 -0
  23. package/dist/ui/Icon.js +26 -0
  24. package/dist/ui/icons.d.ts +19 -0
  25. package/dist/ui/icons.js +25 -0
  26. package/dist/ui/slots.d.ts +23 -0
  27. package/dist/ui/slots.js +13 -0
  28. package/package.json +71 -72
  29. package/src/App.tsx +13 -13
  30. package/src/agent-chat/AgentChat.tsx +729 -692
  31. package/src/agent-chat/AgentChatApp.tsx +211 -206
  32. package/src/agent-chat/PersonasPage.tsx +705 -678
  33. package/src/agent-chat/adapter.ts +272 -272
  34. package/src/agent-chat/app-def-check.ts +215 -215
  35. package/src/agent-chat/app.tsx +327 -327
  36. package/src/agent-chat/auth.ts +83 -83
  37. package/src/agent-chat/dock.ts +161 -161
  38. package/src/agent-chat/docs.ts +179 -179
  39. package/src/agent-chat/index.ts +17 -17
  40. package/src/agent-chat/mount.tsx +8 -1
  41. package/src/agent-chat/qual.ts +55 -55
  42. package/src/agent-chat/sse.ts +104 -104
  43. package/src/agent-chat/suggestions.ts +127 -0
  44. package/src/agent-chat/theme.ts +23 -23
  45. package/src/agent-chat/ui/CodeCopyHeader.tsx +29 -29
  46. package/src/agent-chat/ui/ConfirmCard.tsx +32 -32
  47. package/src/agent-chat/ui/FollowUpSuggestions.tsx +28 -0
  48. package/src/agent-chat/ui/Icon.tsx +53 -0
  49. package/src/agent-chat/ui/Lightbox.tsx +32 -32
  50. package/src/agent-chat/ui/QueueBar.tsx +70 -70
  51. package/src/agent-chat/ui/Splitter.tsx +81 -81
  52. package/src/agent-chat/ui/ThemeToggle.tsx +25 -25
  53. package/src/agent-chat/ui/TierPicker.tsx +112 -112
  54. package/src/agent-chat/ui/UIPromptCard.tsx +68 -68
  55. package/src/agent-chat/ui/icons.ts +31 -0
  56. package/src/agent-chat/ui/slots.tsx +35 -0
  57. package/src/agent-chat/ui/timefmt.ts +110 -110
  58. package/src/agent-chat/ui/useNarrow.ts +20 -20
  59. package/src/fake-product/entry.tsx +63 -54
  60. package/src/main.tsx +8 -8
  61. package/src/styles.css +1492 -1478
@@ -1,83 +1,83 @@
1
- /**
2
- * Where the agent chat and the business pages read the host auth token from.
3
- *
4
- * Kept separate from the (being-retired) postMessage bridge: a dock-mounted
5
- * chat and a same-window business page must share one token without a message
6
- * round-trip. One mutable holder is enough — the token is set once at boot
7
- * (empty in the default `insecureHeaderAuth` deployment) and never changes.
8
- *
9
- * 开发身份(补):`insecureHeaderAuth` 部署(未设 AUTH_JWT_SECRET)里身份来自
10
- * `x-user-id` 请求头而不是 token,浏览器此前从不发它 → 永远 anonymous → 权限管理页
11
- * 进不去、会员卡永远不出现,看起来像「权限与会员体系没做」。vite dev 构建下补一条
12
- * 身份通道:侧栏可选 dev-admin / dev-free,请求统一带 `x-user-id`。
13
- * 只在 `import.meta.env.DEV` 下**默认开启**(下拉渲染 + 缺省发 dev-admin)。注意边界:
14
- * `?as=` 与 localStorage 通道在生产构建同样生效(那是刻意的「生产前端 + 本地后端」
15
- * 联调门)——所以严格说「生产构建不发头」不成立,成立的是 JWT 部署里服务端根本不
16
- * 读这个头,发了也只是发给不存在的门。
17
- */
18
-
19
- const DEV_USER_KEY = "agentchat.devUserId";
20
- /** 开发身份默认值:进 dev 就是管理员,权限管理页/会员发放开箱可用。 */
21
- export const DEV_DEFAULT_USER = "dev-admin";
22
- export const DEV_USERS = [
23
- { id: DEV_DEFAULT_USER, label: "dev-admin" },
24
- // 审计=登录默认可看,普通身份 dev-free 即是「能看审计的普通用户」;
25
- // 原 dev-auditor 演示身份随 auditor 角色退役删除。
26
- { id: "dev-free", label: "dev-free" },
27
- ] as const;
28
-
29
- /** 生产构建里恒 false;node 测试(tsx 直跑)里 `import.meta.env` 不存在也不炸。 */
30
- export const devIdentityEnabled = (() => {
31
- try {
32
- return Boolean(import.meta.env?.DEV);
33
- } catch {
34
- return false;
35
- }
36
- })();
37
-
38
- function readDevUser(): string | null {
39
- try {
40
- // `?as=dev-free` 一次性切换身份:给「生产构建 + 开发后端」的联调场景留的门,
41
- // 写进 localStorage 后刷新即沿用。JWT 部署里服务端根本不读这个头,无风险。
42
- const q = new URLSearchParams(location.search).get("as");
43
- if (q && /^[\w.@-]{1,64}$/.test(q)) {
44
- localStorage.setItem(DEV_USER_KEY, q);
45
- return q;
46
- }
47
- const saved = localStorage.getItem(DEV_USER_KEY);
48
- if (saved) return saved;
49
- } catch {
50
- /* node 测试 / 隐私模式:没有 location 或写不了 localStorage */
51
- }
52
- return devIdentityEnabled ? DEV_DEFAULT_USER : null;
53
- }
54
-
55
- export const auth = {
56
- token: undefined as string | undefined,
57
- set(token?: string): void {
58
- auth.token = token || undefined;
59
- },
60
- /** 当前开发身份;JWT 部署里服务端不读这个头,非 dev 构建默认 null。 */
61
- devUserId: readDevUser(),
62
- setDevUserId(id: string): void {
63
- auth.devUserId = id || null;
64
- try {
65
- if (id) localStorage.setItem(DEV_USER_KEY, id);
66
- else localStorage.removeItem(DEV_USER_KEY);
67
- } catch {
68
- /* 隐私模式下写不了 localStorage:本页仍然生效,刷新后回落默认值 */
69
- }
70
- },
71
- };
72
-
73
- /**
74
- * 所有 `/api` 请求的头部:Bearer token(宿主注入时)+ 开发身份头。
75
- * 单点出口,避免每处 fetch 各拼一次头——漏一处就会出现「这个页面有身份、
76
- * 那个页面是 anonymous」的幽灵 bug。
77
- */
78
- export function apiHeaders(token?: string): Record<string, string> {
79
- const headers: Record<string, string> = {};
80
- if (token) headers.authorization = `Bearer ${token}`;
81
- if (auth.devUserId) headers["x-user-id"] = auth.devUserId;
82
- return headers;
83
- }
1
+ /**
2
+ * Where the agent chat and the business pages read the host auth token from.
3
+ *
4
+ * Kept separate from the (being-retired) postMessage bridge: a dock-mounted
5
+ * chat and a same-window business page must share one token without a message
6
+ * round-trip. One mutable holder is enough — the token is set once at boot
7
+ * (empty in the default `insecureHeaderAuth` deployment) and never changes.
8
+ *
9
+ * 开发身份(补):`insecureHeaderAuth` 部署(未设 AUTH_JWT_SECRET)里身份来自
10
+ * `x-user-id` 请求头而不是 token,浏览器此前从不发它 → 永远 anonymous → 权限管理页
11
+ * 进不去、会员卡永远不出现,看起来像「权限与会员体系没做」。vite dev 构建下补一条
12
+ * 身份通道:侧栏可选 dev-admin / dev-free,请求统一带 `x-user-id`。
13
+ * 只在 `import.meta.env.DEV` 下**默认开启**(下拉渲染 + 缺省发 dev-admin)。注意边界:
14
+ * `?as=` 与 localStorage 通道在生产构建同样生效(那是刻意的「生产前端 + 本地后端」
15
+ * 联调门)——所以严格说「生产构建不发头」不成立,成立的是 JWT 部署里服务端根本不
16
+ * 读这个头,发了也只是发给不存在的门。
17
+ */
18
+
19
+ const DEV_USER_KEY = "agentchat.devUserId";
20
+ /** 开发身份默认值:进 dev 就是管理员,权限管理页/会员发放开箱可用。 */
21
+ export const DEV_DEFAULT_USER = "dev-admin";
22
+ export const DEV_USERS = [
23
+ { id: DEV_DEFAULT_USER, label: "dev-admin" },
24
+ // 审计=登录默认可看,普通身份 dev-free 即是「能看审计的普通用户」;
25
+ // 原 dev-auditor 演示身份随 auditor 角色退役删除。
26
+ { id: "dev-free", label: "dev-free" },
27
+ ] as const;
28
+
29
+ /** 生产构建里恒 false;node 测试(tsx 直跑)里 `import.meta.env` 不存在也不炸。 */
30
+ export const devIdentityEnabled = (() => {
31
+ try {
32
+ return Boolean(import.meta.env?.DEV);
33
+ } catch {
34
+ return false;
35
+ }
36
+ })();
37
+
38
+ function readDevUser(): string | null {
39
+ try {
40
+ // `?as=dev-free` 一次性切换身份:给「生产构建 + 开发后端」的联调场景留的门,
41
+ // 写进 localStorage 后刷新即沿用。JWT 部署里服务端根本不读这个头,无风险。
42
+ const q = new URLSearchParams(location.search).get("as");
43
+ if (q && /^[\w.@-]{1,64}$/.test(q)) {
44
+ localStorage.setItem(DEV_USER_KEY, q);
45
+ return q;
46
+ }
47
+ const saved = localStorage.getItem(DEV_USER_KEY);
48
+ if (saved) return saved;
49
+ } catch {
50
+ /* node 测试 / 隐私模式:没有 location 或写不了 localStorage */
51
+ }
52
+ return devIdentityEnabled ? DEV_DEFAULT_USER : null;
53
+ }
54
+
55
+ export const auth = {
56
+ token: undefined as string | undefined,
57
+ set(token?: string): void {
58
+ auth.token = token || undefined;
59
+ },
60
+ /** 当前开发身份;JWT 部署里服务端不读这个头,非 dev 构建默认 null。 */
61
+ devUserId: readDevUser(),
62
+ setDevUserId(id: string): void {
63
+ auth.devUserId = id || null;
64
+ try {
65
+ if (id) localStorage.setItem(DEV_USER_KEY, id);
66
+ else localStorage.removeItem(DEV_USER_KEY);
67
+ } catch {
68
+ /* 隐私模式下写不了 localStorage:本页仍然生效,刷新后回落默认值 */
69
+ }
70
+ },
71
+ };
72
+
73
+ /**
74
+ * 所有 `/api` 请求的头部:Bearer token(宿主注入时)+ 开发身份头。
75
+ * 单点出口,避免每处 fetch 各拼一次头——漏一处就会出现「这个页面有身份、
76
+ * 那个页面是 anonymous」的幽灵 bug。
77
+ */
78
+ export function apiHeaders(token?: string): Record<string, string> {
79
+ const headers: Record<string, string> = {};
80
+ if (token) headers.authorization = `Bearer ${token}`;
81
+ if (auth.devUserId) headers["x-user-id"] = auth.devUserId;
82
+ return headers;
83
+ }
@@ -1,162 +1,162 @@
1
- import { useSyncExternalStore } from "react";
2
-
3
- /**
4
- * 全局聊天坞(agentChat Dock)的状态。
5
- *
6
- * 三种形态:
7
- * - `docked` 宽屏默认:贴右缘、挤压业务内容区;
8
- * - `floating` 悬浮面板,不改变业务布局(窄屏首选);
9
- * - `closed` 收起成右缘一条竖排唤回按钮。
10
- * 「聊天」路由(#/<默认路由>)不是第四种形态,它是把坞撑满内容区的用法,由路由决定,
11
- * 因此不在这里存——少一份要同步的状态。
12
- *
13
- * 业务页只通过 `sendToChat()` / `useDockMode()` 与它交互,不再 iframe/postMessage。
14
- */
15
-
16
- export type DockMode = "closed" | "docked" | "floating";
17
- /** 打开态(不含 closed),收起后要记住它以便原样唤回。 */
18
- export type DockOpen = Exclude<DockMode, "closed">;
19
-
20
- const MODE_KEY = "dock.mode";
21
- const LAST_KEY = "dock.last";
22
-
23
- /** 宽屏默认挤压式常驻;窄屏没有余量,先收起,需要时由业务页唤出悬浮。 */
24
- export function defaultMode(wide: boolean): DockMode {
25
- return wide ? "docked" : "closed";
26
- }
27
-
28
- /** 记忆值合法才用(损坏的 localStorage 不能把布局带坏),否则回落默认。 */
29
- export function resolveMode(stored: string | null, wide: boolean): DockMode {
30
- return stored === "docked" || stored === "floating" || stored === "closed" ? stored : defaultMode(wide);
31
- }
32
-
33
- /** 收起态被唤醒时该用哪种打开态:记住上次的,没记忆就按屏宽给默认。 */
34
- export function reopenMode(mode: DockMode, last: DockOpen, wide: boolean): DockOpen {
35
- if (mode !== "closed") return mode;
36
- return last === "floating" || last === "docked" ? last : (defaultMode(wide) as DockOpen);
37
- }
38
-
39
- function read(key: string): string | null {
40
- try {
41
- return localStorage.getItem(key);
42
- } catch {
43
- return null;
44
- }
45
- }
46
-
47
- function write(key: string, value: string): void {
48
- try {
49
- localStorage.setItem(key, value);
50
- } catch {
51
- /* 隐私模式写不进去只影响"记忆",不影响本次布局 */
52
- }
53
- }
54
-
55
- const subs = new Set<() => void>();
56
- const wideNow = () => typeof window !== "undefined" && window.innerWidth > 1100;
57
-
58
- let mode: DockMode = "closed";
59
- let last: DockOpen = "docked";
60
- let running = false;
61
- let initialised = false;
62
-
63
- function emit(): void {
64
- for (const fn of subs) fn();
65
- }
66
-
67
- /** 首次访问时按屏宽+记忆定形(放在读取处而不是模块顶层,避免测试环境无 window)。 */
68
- function ensureInit(): void {
69
- if (initialised) return;
70
- initialised = true;
71
- const storedLast = read(LAST_KEY);
72
- if (storedLast === "docked" || storedLast === "floating") last = storedLast;
73
- mode = resolveMode(read(MODE_KEY), wideNow());
74
- }
75
-
76
- export const dockStore = {
77
- subscribe(fn: () => void): () => void {
78
- subs.add(fn);
79
- return () => subs.delete(fn);
80
- },
81
- mode(): DockMode {
82
- ensureInit();
83
- return mode;
84
- },
85
- lastOpen(): DockOpen {
86
- ensureInit();
87
- return last;
88
- },
89
- running(): boolean {
90
- return running;
91
- },
92
- setMode(next: DockMode): void {
93
- ensureInit();
94
- if (next !== "closed") {
95
- last = next;
96
- write(LAST_KEY, next);
97
- }
98
- if (next === mode) return;
99
- mode = next;
100
- write(MODE_KEY, next);
101
- emit();
102
- },
103
- setRunning(next: boolean): void {
104
- if (next === running) return;
105
- running = next;
106
- emit();
107
- },
108
- };
109
-
110
- /** 当前坞形态(响应式)。
111
- * `wide` 由调用方传入,避免这里再挂一个 matchMedia 监听——路由层已经知道屏宽了。
112
- * 实际取值在首次渲染时由 `ensureInit` 按真实屏宽定形。 */
113
- export function useDockMode(): DockMode {
114
- return useSyncExternalStore(dockStore.subscribe, dockStore.mode, () => "closed" as DockMode);
115
- }
116
-
117
- /** 坞里是否有对话正在跑(业务页跳转前要用它决定是否提示,见 C7)。 */
118
-
119
- /* ── 业务页 → 对话 的单向投递 ───────────────────────────────────────── */
120
-
121
- export interface ChatTask {
122
- text: string;
123
- context?: Record<string, unknown>;
124
- }
125
-
126
- type Sink = (task: ChatTask) => void;
127
-
128
- let sink: Sink | undefined;
129
- let queue: ChatTask[] = [];
130
-
131
- /**
132
- * 把一段话(连同页面上下文)投给对话。坞收起时会顺带唤出,对话组件随后
133
- * 挂载并从队列里取走——所以业务页不需要关心坞当前开没开。
134
- */
135
- export function sendToChat(text: string, context?: Record<string, unknown>): void {
136
- dockStore.setMode(reopenMode(dockStore.mode(), dockStore.lastOpen(), wideNow()));
137
- const task: ChatTask = context ? { text, context } : { text };
138
- if (sink) sink(task);
139
- else queue.push(task);
140
- }
141
-
142
- /** 对话组件登记消费端(返回注销函数,严格模式双挂载也安全)。 */
143
- export function subscribeChat(fn: Sink): () => void {
144
- sink = fn;
145
- const pending = queue;
146
- queue = [];
147
- for (const t of pending) fn(t);
148
- return () => {
149
- if (sink === fn) sink = undefined;
150
- };
151
- }
152
-
153
- /**
154
- * 换会话 / 换选项会丢掉正在跑的那一轮回答,动手前先问一句。
155
- * 切业务路由**不是**打断(坞常驻、对话流不断),所以不在这里拦。
156
- */
157
- export function confirmInterrupt(what = "切换", who = "助手"): boolean {
158
- if (!running) return true;
159
- if (typeof window === "undefined") return true;
160
- // 助手的名字是产品事实:core 的默认说法是「助手」,产品传自己的叫法。
161
- return window.confirm(`${who}正在回答,${what}会中断这一轮。继续?`);
1
+ import { useSyncExternalStore } from "react";
2
+
3
+ /**
4
+ * 全局聊天坞(agentChat Dock)的状态。
5
+ *
6
+ * 三种形态:
7
+ * - `docked` 宽屏默认:贴右缘、挤压业务内容区;
8
+ * - `floating` 悬浮面板,不改变业务布局(窄屏首选);
9
+ * - `closed` 收起成右缘一条竖排唤回按钮。
10
+ * 「聊天」路由(#/<默认路由>)不是第四种形态,它是把坞撑满内容区的用法,由路由决定,
11
+ * 因此不在这里存——少一份要同步的状态。
12
+ *
13
+ * 业务页只通过 `sendToChat()` / `useDockMode()` 与它交互,不再 iframe/postMessage。
14
+ */
15
+
16
+ export type DockMode = "closed" | "docked" | "floating";
17
+ /** 打开态(不含 closed),收起后要记住它以便原样唤回。 */
18
+ export type DockOpen = Exclude<DockMode, "closed">;
19
+
20
+ const MODE_KEY = "dock.mode";
21
+ const LAST_KEY = "dock.last";
22
+
23
+ /** 宽屏默认挤压式常驻;窄屏没有余量,先收起,需要时由业务页唤出悬浮。 */
24
+ export function defaultMode(wide: boolean): DockMode {
25
+ return wide ? "docked" : "closed";
26
+ }
27
+
28
+ /** 记忆值合法才用(损坏的 localStorage 不能把布局带坏),否则回落默认。 */
29
+ export function resolveMode(stored: string | null, wide: boolean): DockMode {
30
+ return stored === "docked" || stored === "floating" || stored === "closed" ? stored : defaultMode(wide);
31
+ }
32
+
33
+ /** 收起态被唤醒时该用哪种打开态:记住上次的,没记忆就按屏宽给默认。 */
34
+ export function reopenMode(mode: DockMode, last: DockOpen, wide: boolean): DockOpen {
35
+ if (mode !== "closed") return mode;
36
+ return last === "floating" || last === "docked" ? last : (defaultMode(wide) as DockOpen);
37
+ }
38
+
39
+ function read(key: string): string | null {
40
+ try {
41
+ return localStorage.getItem(key);
42
+ } catch {
43
+ return null;
44
+ }
45
+ }
46
+
47
+ function write(key: string, value: string): void {
48
+ try {
49
+ localStorage.setItem(key, value);
50
+ } catch {
51
+ /* 隐私模式写不进去只影响"记忆",不影响本次布局 */
52
+ }
53
+ }
54
+
55
+ const subs = new Set<() => void>();
56
+ const wideNow = () => typeof window !== "undefined" && window.innerWidth > 1100;
57
+
58
+ let mode: DockMode = "closed";
59
+ let last: DockOpen = "docked";
60
+ let running = false;
61
+ let initialised = false;
62
+
63
+ function emit(): void {
64
+ for (const fn of subs) fn();
65
+ }
66
+
67
+ /** 首次访问时按屏宽+记忆定形(放在读取处而不是模块顶层,避免测试环境无 window)。 */
68
+ function ensureInit(): void {
69
+ if (initialised) return;
70
+ initialised = true;
71
+ const storedLast = read(LAST_KEY);
72
+ if (storedLast === "docked" || storedLast === "floating") last = storedLast;
73
+ mode = resolveMode(read(MODE_KEY), wideNow());
74
+ }
75
+
76
+ export const dockStore = {
77
+ subscribe(fn: () => void): () => void {
78
+ subs.add(fn);
79
+ return () => subs.delete(fn);
80
+ },
81
+ mode(): DockMode {
82
+ ensureInit();
83
+ return mode;
84
+ },
85
+ lastOpen(): DockOpen {
86
+ ensureInit();
87
+ return last;
88
+ },
89
+ running(): boolean {
90
+ return running;
91
+ },
92
+ setMode(next: DockMode): void {
93
+ ensureInit();
94
+ if (next !== "closed") {
95
+ last = next;
96
+ write(LAST_KEY, next);
97
+ }
98
+ if (next === mode) return;
99
+ mode = next;
100
+ write(MODE_KEY, next);
101
+ emit();
102
+ },
103
+ setRunning(next: boolean): void {
104
+ if (next === running) return;
105
+ running = next;
106
+ emit();
107
+ },
108
+ };
109
+
110
+ /** 当前坞形态(响应式)。
111
+ * `wide` 由调用方传入,避免这里再挂一个 matchMedia 监听——路由层已经知道屏宽了。
112
+ * 实际取值在首次渲染时由 `ensureInit` 按真实屏宽定形。 */
113
+ export function useDockMode(): DockMode {
114
+ return useSyncExternalStore(dockStore.subscribe, dockStore.mode, () => "closed" as DockMode);
115
+ }
116
+
117
+ /** 坞里是否有对话正在跑(业务页跳转前要用它决定是否提示,见 C7)。 */
118
+
119
+ /* ── 业务页 → 对话 的单向投递 ───────────────────────────────────────── */
120
+
121
+ export interface ChatTask {
122
+ text: string;
123
+ context?: Record<string, unknown>;
124
+ }
125
+
126
+ type Sink = (task: ChatTask) => void;
127
+
128
+ let sink: Sink | undefined;
129
+ let queue: ChatTask[] = [];
130
+
131
+ /**
132
+ * 把一段话(连同页面上下文)投给对话。坞收起时会顺带唤出,对话组件随后
133
+ * 挂载并从队列里取走——所以业务页不需要关心坞当前开没开。
134
+ */
135
+ export function sendToChat(text: string, context?: Record<string, unknown>): void {
136
+ dockStore.setMode(reopenMode(dockStore.mode(), dockStore.lastOpen(), wideNow()));
137
+ const task: ChatTask = context ? { text, context } : { text };
138
+ if (sink) sink(task);
139
+ else queue.push(task);
140
+ }
141
+
142
+ /** 对话组件登记消费端(返回注销函数,严格模式双挂载也安全)。 */
143
+ export function subscribeChat(fn: Sink): () => void {
144
+ sink = fn;
145
+ const pending = queue;
146
+ queue = [];
147
+ for (const t of pending) fn(t);
148
+ return () => {
149
+ if (sink === fn) sink = undefined;
150
+ };
151
+ }
152
+
153
+ /**
154
+ * 换会话 / 换选项会丢掉正在跑的那一轮回答,动手前先问一句。
155
+ * 切业务路由**不是**打断(坞常驻、对话流不断),所以不在这里拦。
156
+ */
157
+ export function confirmInterrupt(what = "切换", who = "助手"): boolean {
158
+ if (!running) return true;
159
+ if (typeof window === "undefined") return true;
160
+ // 助手的名字是产品事实:core 的默认说法是「助手」,产品传自己的叫法。
161
+ return window.confirm(`${who}正在回答,${what}会中断这一轮。继续?`);
162
162
  }