@njuptlzf/agent-chat-web 0.2.0 → 0.4.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 +7 -1
- package/dist/AgentChat.js +35 -5
- package/dist/AgentChatApp.d.ts +4 -1
- package/dist/AgentChatApp.js +2 -2
- package/dist/PersonasPage.js +8 -0
- package/dist/adapter.d.ts +9 -0
- package/dist/adapter.js +15 -0
- package/dist/mount.d.ts +7 -1
- package/dist/mount.js +2 -2
- package/dist/styles.css +1505 -1478
- package/dist/suggestions.d.ts +41 -0
- package/dist/suggestions.js +98 -0
- package/dist/ui/FollowUpSuggestions.d.ts +9 -0
- package/dist/ui/FollowUpSuggestions.js +13 -0
- package/dist/ui/Icon.d.ts +8 -0
- package/dist/ui/Icon.js +26 -0
- package/dist/ui/MemberCards.d.ts +15 -0
- package/dist/ui/MemberCards.js +13 -0
- package/dist/ui/icons.d.ts +19 -0
- package/dist/ui/icons.js +25 -0
- package/dist/ui/members.d.ts +42 -0
- package/dist/ui/members.js +53 -0
- package/dist/ui/slots.d.ts +29 -0
- package/dist/ui/slots.js +14 -0
- package/package.json +71 -72
- package/src/App.tsx +13 -13
- package/src/agent-chat/AgentChat.tsx +741 -692
- package/src/agent-chat/AgentChatApp.tsx +211 -206
- package/src/agent-chat/DockPanel.tsx +73 -73
- package/src/agent-chat/PersonasPage.tsx +705 -678
- package/src/agent-chat/adapter.ts +293 -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 +130 -123
- package/src/agent-chat/qual.ts +55 -55
- package/src/agent-chat/sse.ts +104 -104
- package/src/agent-chat/suggestions.ts +127 -0
- 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/FollowUpSuggestions.tsx +28 -0
- package/src/agent-chat/ui/Icon.tsx +53 -0
- package/src/agent-chat/ui/Lightbox.tsx +32 -32
- package/src/agent-chat/ui/MemberCards.tsx +46 -0
- 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/icons.ts +31 -0
- package/src/agent-chat/ui/members.ts +106 -0
- package/src/agent-chat/ui/slots.tsx +41 -0
- package/src/agent-chat/ui/timefmt.ts +110 -110
- package/src/agent-chat/ui/useNarrow.ts +20 -20
- package/src/fake-product/entry.tsx +63 -54
- package/src/main.tsx +8 -8
- package/src/styles.css +1505 -1478
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 多 phase 的成员卡片归集(W4 / R-010,S6):把 SSE 的 `member_*` / `run_done`
|
|
3
|
+
* 事件流折成「谁在跑、各自说了什么、各自花了多少」的状态。
|
|
4
|
+
*
|
|
5
|
+
* 为什么是纯 reducer 而不是塞进 React state:
|
|
6
|
+
* ① 归集逻辑(乱序 done、delta 拼接、runId 切换时重置)是本次最该被测的东西,
|
|
7
|
+
* 纯函数能在**原生 loader**下测(web 测试默认不走 tsx,见 test-stable.mjs);
|
|
8
|
+
* ② adapter.ts 只负责把协议事件分发到 bridge,不认识 UI 形状;
|
|
9
|
+
* ③ UI 组件只渲染快照,不写状态机——与 ConfirmCard / QueueBar 同构。
|
|
10
|
+
*
|
|
11
|
+
* 降级契约:任何不认识的事件类型进 `reduceMembers` 都被安全忽略(返回原状态),
|
|
12
|
+
* 绝不 throw、绝不往成员卡片里塞垃圾。这样平台将来加事件,旧前端不会崩。
|
|
13
|
+
*/
|
|
14
|
+
import type { ChatEvent, TokenUsage } from "@njuptlzf/agent-chat-protocol";
|
|
15
|
+
|
|
16
|
+
/** 一个成员的视图状态。 */
|
|
17
|
+
export interface MemberView {
|
|
18
|
+
readonly memberId: string;
|
|
19
|
+
readonly phaseId: string;
|
|
20
|
+
/** running / completed / failed / stopped / blocked。 */
|
|
21
|
+
readonly state: "running" | "completed" | "failed" | "stopped" | "blocked";
|
|
22
|
+
/** 这个成员流式吐出的全部文本(delta 依次拼接)。 */
|
|
23
|
+
readonly text: string;
|
|
24
|
+
/** 交给它的任务文本(member_started 时带)。 */
|
|
25
|
+
readonly task: string;
|
|
26
|
+
/** 该成员自己的 usage;未收口时为空。 */
|
|
27
|
+
readonly usage: TokenUsage | undefined;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/** 一次 multi-phase Run 的视图快照。 */
|
|
31
|
+
export interface MembersState {
|
|
32
|
+
/** 当前 runId;切换 Run 时整组重置。 */
|
|
33
|
+
readonly runId: string | undefined;
|
|
34
|
+
readonly members: readonly MemberView[];
|
|
35
|
+
/** Run 收口(run_done)。 */
|
|
36
|
+
readonly done: boolean;
|
|
37
|
+
/** Run 级 usage(run_done 带)。 */
|
|
38
|
+
readonly usage: TokenUsage | undefined;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
export const emptyMembersState: MembersState = { runId: undefined, members: [], done: false, usage: undefined };
|
|
42
|
+
|
|
43
|
+
const zeroUsage: TokenUsage = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0, costUsd: 0 };
|
|
44
|
+
|
|
45
|
+
function isMemberState(s: string): s is MemberView["state"] {
|
|
46
|
+
return s === "running" || s === "completed" || s === "failed" || s === "stopped" || s === "blocked";
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* 折一个事件进状态。**纯函数**:不修改 prev,返回新对象(未命中时原样返回 prev)。
|
|
51
|
+
*/
|
|
52
|
+
export function reduceMembers(prev: MembersState, ev: ChatEvent): MembersState {
|
|
53
|
+
// 只处理编排事件;其余一律安全忽略(降级契约)。
|
|
54
|
+
if (
|
|
55
|
+
ev.type !== "member_started" &&
|
|
56
|
+
ev.type !== "member_delta" &&
|
|
57
|
+
ev.type !== "member_done" &&
|
|
58
|
+
ev.type !== "run_done"
|
|
59
|
+
) {
|
|
60
|
+
return prev;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
// 换 Run 重置:一个 session 里可以连续跑多个 flow,每组成员互不串台。
|
|
64
|
+
const base: MembersState =
|
|
65
|
+
prev.runId === undefined || prev.runId === ev.runId ? prev : emptyMembersState;
|
|
66
|
+
|
|
67
|
+
if (ev.type === "run_done") {
|
|
68
|
+
return { ...base, runId: ev.runId, done: true, usage: ev.usage };
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
const key = (m: MemberView) => `${m.memberId}\u0000${m.phaseId}`;
|
|
72
|
+
const id = `${ev.memberId}\u0000${ev.phaseId}`;
|
|
73
|
+
const at = base.members.findIndex((m) => key(m) === id);
|
|
74
|
+
|
|
75
|
+
if (ev.type === "member_started") {
|
|
76
|
+
// started 可能晚于 delta(乱序)或重复到达:保留已有的 text/usage,只刷新
|
|
77
|
+
// task 与状态为 running。绝不用空串覆盖已经收到的字。
|
|
78
|
+
const next: MemberView = {
|
|
79
|
+
memberId: ev.memberId,
|
|
80
|
+
phaseId: ev.phaseId,
|
|
81
|
+
state: "running",
|
|
82
|
+
text: at === -1 ? "" : base.members[at]!.text,
|
|
83
|
+
task: ev.task,
|
|
84
|
+
usage: at === -1 ? undefined : base.members[at]!.usage,
|
|
85
|
+
};
|
|
86
|
+
const members = at === -1 ? [...base.members, next] : base.members.map((m, i) => (i === at ? next : m));
|
|
87
|
+
return { ...base, runId: ev.runId, members };
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
// delta / done 若在 started 之前到达(乱序),建一个占位成员再更新——
|
|
91
|
+
// 前端不该因为服务端事件顺序抖动就丢字。
|
|
92
|
+
const cur: MemberView =
|
|
93
|
+
at === -1
|
|
94
|
+
? { memberId: ev.memberId, phaseId: ev.phaseId, state: "running", text: "", task: "", usage: undefined }
|
|
95
|
+
: base.members[at]!;
|
|
96
|
+
const updated: MemberView =
|
|
97
|
+
ev.type === "member_delta"
|
|
98
|
+
? { ...cur, text: cur.text + ev.delta }
|
|
99
|
+
: {
|
|
100
|
+
...cur,
|
|
101
|
+
state: isMemberState(ev.state) ? ev.state : "failed",
|
|
102
|
+
usage: ev.usage ?? zeroUsage,
|
|
103
|
+
};
|
|
104
|
+
const members = at === -1 ? [...base.members, updated] : base.members.map((m, i) => (i === at ? updated : m));
|
|
105
|
+
return { ...base, runId: ev.runId, members };
|
|
106
|
+
}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import { createContext, useContext, type ComponentType, type ReactNode } from "react";
|
|
2
|
+
import { Icon } from "./Icon.tsx";
|
|
3
|
+
import { FollowUpSuggestions } from "./FollowUpSuggestions.tsx";
|
|
4
|
+
import { MemberCards, type MemberCardsProps } from "./MemberCards.tsx";
|
|
5
|
+
|
|
6
|
+
export interface IconProps {
|
|
7
|
+
/** 图标值(`branding.ui.icons` 里该槽的字符串);缺省回落内置矢量。 */
|
|
8
|
+
spec?: string;
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* 聊天壳的视觉件槽位注册表:所有视觉件要么是 assistant-ui 原生原语,要么是
|
|
13
|
+
* 这里登记的可替换自定义组件——壳体 JSX 不写死字形、不自造建议状态机。
|
|
14
|
+
*
|
|
15
|
+
* `Slots` / `IconProps` **故意不进公共 barrel**(不新增公开导出符号):产品要
|
|
16
|
+
* 整体换皮时,在 `AgentApp` 的 `slots` 里传结构兼容的组件即可,TS 自动对上。
|
|
17
|
+
* 槽组件渲染在 `AssistantRuntimeProvider`(`FollowUpSuggestions` 还在
|
|
18
|
+
* `ThreadPrimitive.Root`)之内,可直接使用库原语;不得反向 import 平台内部路径。
|
|
19
|
+
*/
|
|
20
|
+
export interface Slots {
|
|
21
|
+
Icon: ComponentType<IconProps>;
|
|
22
|
+
FollowUpSuggestions: ComponentType;
|
|
23
|
+
/**
|
|
24
|
+
* 多 phase 成员卡片视图(W4)。产品可整体换皮;默认实现消费 `reduceMembers`
|
|
25
|
+
* 的快照。档 1 传空数组 ⇒ 默认实现返回 null,零 DOM、零视觉变化。
|
|
26
|
+
*/
|
|
27
|
+
MemberCards: ComponentType<MemberCardsProps>;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
export const defaultSlots: Slots = { Icon, FollowUpSuggestions, MemberCards };
|
|
31
|
+
|
|
32
|
+
const SlotsContext = createContext<Slots>(defaultSlots);
|
|
33
|
+
export const SlotsProvider = SlotsContext.Provider;
|
|
34
|
+
export function useSlots(): Slots {
|
|
35
|
+
return useContext(SlotsContext);
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/** 纯函数:默认槽位 + 局部覆盖(未覆盖的槽保持默认),不渲染 DOM 即可单测。 */
|
|
39
|
+
export function resolveSlots(overrides?: Partial<Slots>): Slots {
|
|
40
|
+
return { ...defaultSlots, ...overrides };
|
|
41
|
+
}
|
|
@@ -1,110 +1,110 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Session-list time helpers (batch 12, DSH-inspired): human relative labels
|
|
3
|
-
* and calendar-day grouping. Pure and `now`-injected so they are testable
|
|
4
|
-
* without a clock mock.
|
|
5
|
-
*
|
|
6
|
-
* 另外提供**绝对时刻**显示(`fmtTime` / `fmtDate`):
|
|
7
|
-
* 服务端一律存 UTC ISO,页面以前直接 `iso.slice(0,16)` 截出来显示——那是 UTC,
|
|
8
|
-
* +08:00 的运维看审计流水/学习记录会以为「8 小时前」。现在统一转成浏览器本地时区。
|
|
9
|
-
*/
|
|
10
|
-
|
|
11
|
-
const DAY = 86_400_000;
|
|
12
|
-
|
|
13
|
-
function startOfDay(t: number): number {
|
|
14
|
-
const d = new Date(t);
|
|
15
|
-
d.setHours(0, 0, 0, 0);
|
|
16
|
-
return d.getTime();
|
|
17
|
-
}
|
|
18
|
-
|
|
19
|
-
/** Whole calendar days between the item's day and today (0 = today, 1 = yesterday). */
|
|
20
|
-
function daysAgo(iso: string, now: Date): number {
|
|
21
|
-
const t = Date.parse(iso);
|
|
22
|
-
if (Number.isNaN(t)) return 0;
|
|
23
|
-
return Math.round((startOfDay(now.getTime()) - startOfDay(t)) / DAY);
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
/** 刚刚 / N 分钟前 / N 小时前 / 昨天 / M月D日(跨年带年份)。 */
|
|
27
|
-
export function relativeTime(iso: string, now: Date): string {
|
|
28
|
-
const t = Date.parse(iso);
|
|
29
|
-
if (Number.isNaN(t)) return "";
|
|
30
|
-
const diff = now.getTime() - t; // negative (clock skew / future) reads as "刚刚"
|
|
31
|
-
if (diff < 60_000) return "刚刚";
|
|
32
|
-
if (diff < 3_600_000) return `${Math.floor(diff / 60_000)} 分钟前`;
|
|
33
|
-
const days = daysAgo(iso, now);
|
|
34
|
-
if (days === 0) return `${Math.floor(diff / 3_600_000)} 小时前`;
|
|
35
|
-
const d = new Date(t);
|
|
36
|
-
if (days === 1) return "昨天";
|
|
37
|
-
const md = `${d.getMonth() + 1}月${d.getDate()}日`;
|
|
38
|
-
return d.getFullYear() === now.getFullYear() ? md : `${d.getFullYear()}年${md}`;
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
/** Group label for a session row; buckets follow calendar days, not 24h windows. */
|
|
42
|
-
export function groupOf(iso: string, now: Date): string {
|
|
43
|
-
const days = daysAgo(iso, now);
|
|
44
|
-
if (days <= 0) return "今天";
|
|
45
|
-
if (days === 1) return "昨天";
|
|
46
|
-
if (days <= 6) return "近 7 天";
|
|
47
|
-
if (days <= 29) return "近 30 天";
|
|
48
|
-
return "更早";
|
|
49
|
-
}
|
|
50
|
-
|
|
51
|
-
/**
|
|
52
|
-
* Bucket a session list in order. Assumes items are sorted newest-first (the
|
|
53
|
-
* server does that); a newer item after an older one starts a new bucket run
|
|
54
|
-
* rather than being silently merged — same behaviour as DSH's list.
|
|
55
|
-
*/
|
|
56
|
-
export function groupSessions<T extends { updatedAt: string }>(
|
|
57
|
-
items: readonly T[],
|
|
58
|
-
now: Date,
|
|
59
|
-
): Array<{ label: string; items: T[] }> {
|
|
60
|
-
const out: Array<{ label: string; items: T[] }> = [];
|
|
61
|
-
for (const item of items) {
|
|
62
|
-
const label = groupOf(item.updatedAt, now);
|
|
63
|
-
const last = out[out.length - 1];
|
|
64
|
-
if (last && last.label === label) last.items.push(item);
|
|
65
|
-
else out.push({ label, items: [item] });
|
|
66
|
-
}
|
|
67
|
-
return out;
|
|
68
|
-
}
|
|
69
|
-
|
|
70
|
-
/**
|
|
71
|
-
* 绝对时刻 → 「2026-11-03 09:12」(本地时区)。
|
|
72
|
-
*
|
|
73
|
-
* - `timeZone` 只给测试用(固定时区做断言);页面调用不传 = 用户本地时区。
|
|
74
|
-
* - 空值显示「—」;**解析不了就原样返回**(不吞、不假装是今天)。
|
|
75
|
-
* - 只喂 ISO 时刻(含 Z 或偏移);别喂「2026-11-03」这种纯日期——那会被当 UTC 零点,
|
|
76
|
-
* 在负时区会退到前一天。
|
|
77
|
-
*/
|
|
78
|
-
export function fmtTime(iso: string | null | undefined, timeZone?: string): string {
|
|
79
|
-
const parts = fmtParts(iso, timeZone, true);
|
|
80
|
-
if (!parts) return iso ? String(iso) : "—";
|
|
81
|
-
return `${parts.year}-${parts.month}-${parts.day} ${parts.hour}:${parts.minute}`;
|
|
82
|
-
}
|
|
83
|
-
|
|
84
|
-
/** 绝对时刻 → 「2026-11-03」(本地时区)。语义同 `fmtTime`。 */
|
|
85
|
-
export function fmtDate(iso: string | null | undefined, timeZone?: string): string {
|
|
86
|
-
const parts = fmtParts(iso, timeZone, false);
|
|
87
|
-
if (!parts) return iso ? String(iso) : "—";
|
|
88
|
-
return `${parts.year}-${parts.month}-${parts.day}`;
|
|
89
|
-
}
|
|
90
|
-
|
|
91
|
-
function fmtParts(
|
|
92
|
-
iso: string | null | undefined,
|
|
93
|
-
timeZone: string | undefined,
|
|
94
|
-
withTime: boolean,
|
|
95
|
-
): { year: string; month: string; day: string; hour: string; minute: string } | null {
|
|
96
|
-
if (!iso) return null;
|
|
97
|
-
const d = new Date(iso);
|
|
98
|
-
if (Number.isNaN(d.getTime())) return null;
|
|
99
|
-
const parts = new Intl.DateTimeFormat("zh-CN", {
|
|
100
|
-
...(timeZone ? { timeZone } : {}),
|
|
101
|
-
year: "numeric",
|
|
102
|
-
month: "2-digit",
|
|
103
|
-
day: "2-digit",
|
|
104
|
-
...(withTime ? { hour: "2-digit", minute: "2-digit" } : {}),
|
|
105
|
-
// h23:不用 hour12:false——某些 ICU 版本会把午夜排成 "24:00"。
|
|
106
|
-
hourCycle: withTime ? "h23" : undefined,
|
|
107
|
-
}).formatToParts(d);
|
|
108
|
-
const get = (type: string) => parts.find((p) => p.type === type)?.value ?? "";
|
|
109
|
-
return { year: get("year"), month: get("month"), day: get("day"), hour: get("hour"), minute: get("minute") };
|
|
110
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* Session-list time helpers (batch 12, DSH-inspired): human relative labels
|
|
3
|
+
* and calendar-day grouping. Pure and `now`-injected so they are testable
|
|
4
|
+
* without a clock mock.
|
|
5
|
+
*
|
|
6
|
+
* 另外提供**绝对时刻**显示(`fmtTime` / `fmtDate`):
|
|
7
|
+
* 服务端一律存 UTC ISO,页面以前直接 `iso.slice(0,16)` 截出来显示——那是 UTC,
|
|
8
|
+
* +08:00 的运维看审计流水/学习记录会以为「8 小时前」。现在统一转成浏览器本地时区。
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
const DAY = 86_400_000;
|
|
12
|
+
|
|
13
|
+
function startOfDay(t: number): number {
|
|
14
|
+
const d = new Date(t);
|
|
15
|
+
d.setHours(0, 0, 0, 0);
|
|
16
|
+
return d.getTime();
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
/** Whole calendar days between the item's day and today (0 = today, 1 = yesterday). */
|
|
20
|
+
function daysAgo(iso: string, now: Date): number {
|
|
21
|
+
const t = Date.parse(iso);
|
|
22
|
+
if (Number.isNaN(t)) return 0;
|
|
23
|
+
return Math.round((startOfDay(now.getTime()) - startOfDay(t)) / DAY);
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
/** 刚刚 / N 分钟前 / N 小时前 / 昨天 / M月D日(跨年带年份)。 */
|
|
27
|
+
export function relativeTime(iso: string, now: Date): string {
|
|
28
|
+
const t = Date.parse(iso);
|
|
29
|
+
if (Number.isNaN(t)) return "";
|
|
30
|
+
const diff = now.getTime() - t; // negative (clock skew / future) reads as "刚刚"
|
|
31
|
+
if (diff < 60_000) return "刚刚";
|
|
32
|
+
if (diff < 3_600_000) return `${Math.floor(diff / 60_000)} 分钟前`;
|
|
33
|
+
const days = daysAgo(iso, now);
|
|
34
|
+
if (days === 0) return `${Math.floor(diff / 3_600_000)} 小时前`;
|
|
35
|
+
const d = new Date(t);
|
|
36
|
+
if (days === 1) return "昨天";
|
|
37
|
+
const md = `${d.getMonth() + 1}月${d.getDate()}日`;
|
|
38
|
+
return d.getFullYear() === now.getFullYear() ? md : `${d.getFullYear()}年${md}`;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/** Group label for a session row; buckets follow calendar days, not 24h windows. */
|
|
42
|
+
export function groupOf(iso: string, now: Date): string {
|
|
43
|
+
const days = daysAgo(iso, now);
|
|
44
|
+
if (days <= 0) return "今天";
|
|
45
|
+
if (days === 1) return "昨天";
|
|
46
|
+
if (days <= 6) return "近 7 天";
|
|
47
|
+
if (days <= 29) return "近 30 天";
|
|
48
|
+
return "更早";
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/**
|
|
52
|
+
* Bucket a session list in order. Assumes items are sorted newest-first (the
|
|
53
|
+
* server does that); a newer item after an older one starts a new bucket run
|
|
54
|
+
* rather than being silently merged — same behaviour as DSH's list.
|
|
55
|
+
*/
|
|
56
|
+
export function groupSessions<T extends { updatedAt: string }>(
|
|
57
|
+
items: readonly T[],
|
|
58
|
+
now: Date,
|
|
59
|
+
): Array<{ label: string; items: T[] }> {
|
|
60
|
+
const out: Array<{ label: string; items: T[] }> = [];
|
|
61
|
+
for (const item of items) {
|
|
62
|
+
const label = groupOf(item.updatedAt, now);
|
|
63
|
+
const last = out[out.length - 1];
|
|
64
|
+
if (last && last.label === label) last.items.push(item);
|
|
65
|
+
else out.push({ label, items: [item] });
|
|
66
|
+
}
|
|
67
|
+
return out;
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
/**
|
|
71
|
+
* 绝对时刻 → 「2026-11-03 09:12」(本地时区)。
|
|
72
|
+
*
|
|
73
|
+
* - `timeZone` 只给测试用(固定时区做断言);页面调用不传 = 用户本地时区。
|
|
74
|
+
* - 空值显示「—」;**解析不了就原样返回**(不吞、不假装是今天)。
|
|
75
|
+
* - 只喂 ISO 时刻(含 Z 或偏移);别喂「2026-11-03」这种纯日期——那会被当 UTC 零点,
|
|
76
|
+
* 在负时区会退到前一天。
|
|
77
|
+
*/
|
|
78
|
+
export function fmtTime(iso: string | null | undefined, timeZone?: string): string {
|
|
79
|
+
const parts = fmtParts(iso, timeZone, true);
|
|
80
|
+
if (!parts) return iso ? String(iso) : "—";
|
|
81
|
+
return `${parts.year}-${parts.month}-${parts.day} ${parts.hour}:${parts.minute}`;
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
/** 绝对时刻 → 「2026-11-03」(本地时区)。语义同 `fmtTime`。 */
|
|
85
|
+
export function fmtDate(iso: string | null | undefined, timeZone?: string): string {
|
|
86
|
+
const parts = fmtParts(iso, timeZone, false);
|
|
87
|
+
if (!parts) return iso ? String(iso) : "—";
|
|
88
|
+
return `${parts.year}-${parts.month}-${parts.day}`;
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
function fmtParts(
|
|
92
|
+
iso: string | null | undefined,
|
|
93
|
+
timeZone: string | undefined,
|
|
94
|
+
withTime: boolean,
|
|
95
|
+
): { year: string; month: string; day: string; hour: string; minute: string } | null {
|
|
96
|
+
if (!iso) return null;
|
|
97
|
+
const d = new Date(iso);
|
|
98
|
+
if (Number.isNaN(d.getTime())) return null;
|
|
99
|
+
const parts = new Intl.DateTimeFormat("zh-CN", {
|
|
100
|
+
...(timeZone ? { timeZone } : {}),
|
|
101
|
+
year: "numeric",
|
|
102
|
+
month: "2-digit",
|
|
103
|
+
day: "2-digit",
|
|
104
|
+
...(withTime ? { hour: "2-digit", minute: "2-digit" } : {}),
|
|
105
|
+
// h23:不用 hour12:false——某些 ICU 版本会把午夜排成 "24:00"。
|
|
106
|
+
hourCycle: withTime ? "h23" : undefined,
|
|
107
|
+
}).formatToParts(d);
|
|
108
|
+
const get = (type: string) => parts.find((p) => p.type === type)?.value ?? "";
|
|
109
|
+
return { year: get("year"), month: get("month"), day: get("day"), hour: get("hour"), minute: get("minute") };
|
|
110
|
+
}
|
|
@@ -1,20 +1,20 @@
|
|
|
1
|
-
import { useSyncExternalStore } from "react";
|
|
2
|
-
|
|
3
|
-
/**
|
|
4
|
-
* 视口是否窄于 maxWidth(响应式布局用)。
|
|
5
|
-
*
|
|
6
|
-
* 用 useSyncExternalStore 而不是 useState+useEffect:首帧就能拿到正确值,
|
|
7
|
-
* 不会出现"先按宽屏渲染再跳成窄屏"的闪动。服务端渲染(无 window)回落 false。
|
|
8
|
-
*/
|
|
9
|
-
export function useNarrow(maxWidth: number): boolean {
|
|
10
|
-
const query = `(max-width: ${maxWidth}px)`;
|
|
11
|
-
return useSyncExternalStore(
|
|
12
|
-
(onChange) => {
|
|
13
|
-
const mql = window.matchMedia(query);
|
|
14
|
-
mql.addEventListener("change", onChange);
|
|
15
|
-
return () => mql.removeEventListener("change", onChange);
|
|
16
|
-
},
|
|
17
|
-
() => window.matchMedia(query).matches,
|
|
18
|
-
() => false,
|
|
19
|
-
);
|
|
20
|
-
}
|
|
1
|
+
import { useSyncExternalStore } from "react";
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* 视口是否窄于 maxWidth(响应式布局用)。
|
|
5
|
+
*
|
|
6
|
+
* 用 useSyncExternalStore 而不是 useState+useEffect:首帧就能拿到正确值,
|
|
7
|
+
* 不会出现"先按宽屏渲染再跳成窄屏"的闪动。服务端渲染(无 window)回落 false。
|
|
8
|
+
*/
|
|
9
|
+
export function useNarrow(maxWidth: number): boolean {
|
|
10
|
+
const query = `(max-width: ${maxWidth}px)`;
|
|
11
|
+
return useSyncExternalStore(
|
|
12
|
+
(onChange) => {
|
|
13
|
+
const mql = window.matchMedia(query);
|
|
14
|
+
mql.addEventListener("change", onChange);
|
|
15
|
+
return () => mql.removeEventListener("change", onChange);
|
|
16
|
+
},
|
|
17
|
+
() => window.matchMedia(query).matches,
|
|
18
|
+
() => false,
|
|
19
|
+
);
|
|
20
|
+
}
|
|
@@ -1,54 +1,63 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* **第二产品的最小样板**:用于构建期产品切换验收。
|
|
3
|
-
*
|
|
4
|
-
* 它不是真产品,是「照抄起点」:一个 AppDef(路由表 + 侧栏 + 页面)加一个
|
|
5
|
-
* 组合根调用,就能接进 core 的壳。真实产品照它写,再补自己的页面与文案。
|
|
6
|
-
*
|
|
7
|
-
* 与真产品同契约(`vite.config.ts` 的 `appDefGuard` 会校验 appDef):
|
|
8
|
-
* - `export const appDef`:导航注册表,必须过 core 的 20 条结构契约;
|
|
9
|
-
* - `export function App`:组合根组件(`AgentApp` + 产品的事实)。
|
|
10
|
-
*
|
|
11
|
-
* 构建:`VITE_PRODUCT=fake-product npm --prefix apps/web run build`
|
|
12
|
-
* (CI 里跑这一条,等于每次都在验「切换真的有效」)。
|
|
13
|
-
*/
|
|
14
|
-
import { AgentApp } from "../agent-chat/mount.tsx";
|
|
15
|
-
import
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
*
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
<
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
1
|
+
/**
|
|
2
|
+
* **第二产品的最小样板**:用于构建期产品切换验收。
|
|
3
|
+
*
|
|
4
|
+
* 它不是真产品,是「照抄起点」:一个 AppDef(路由表 + 侧栏 + 页面)加一个
|
|
5
|
+
* 组合根调用,就能接进 core 的壳。真实产品照它写,再补自己的页面与文案。
|
|
6
|
+
*
|
|
7
|
+
* 与真产品同契约(`vite.config.ts` 的 `appDefGuard` 会校验 appDef):
|
|
8
|
+
* - `export const appDef`:导航注册表,必须过 core 的 20 条结构契约;
|
|
9
|
+
* - `export function App`:组合根组件(`AgentApp` + 产品的事实)。
|
|
10
|
+
*
|
|
11
|
+
* 构建:`VITE_PRODUCT=fake-product npm --prefix apps/web run build`
|
|
12
|
+
* (CI 里跑这一条,等于每次都在验「切换真的有效」)。
|
|
13
|
+
*/
|
|
14
|
+
import { AgentApp } from "../agent-chat/mount.tsx";
|
|
15
|
+
import { PersonasPage } from "../agent-chat/index.ts";
|
|
16
|
+
import type { AppDef } from "../agent-chat/app.tsx";
|
|
17
|
+
|
|
18
|
+
/**
|
|
19
|
+
* 路由键只能是**小写字母**(core 用 `/^#\/([a-z]+)/` 从 hash 取键)。
|
|
20
|
+
* 写成 "my-page" 这类取不出来,页面会像「点不动」——契约里有这一条。
|
|
21
|
+
*/
|
|
22
|
+
const ROUTES = {
|
|
23
|
+
chat: "助手",
|
|
24
|
+
home: "首页",
|
|
25
|
+
// core 内置的人格配置页:样板把它挂出来,活体才有面可验;真产品可不挂。
|
|
26
|
+
personas: "人格",
|
|
27
|
+
} as const;
|
|
28
|
+
|
|
29
|
+
const appDef: AppDef = {
|
|
30
|
+
home: "home",
|
|
31
|
+
// core 不认识这个键,它只是「坞撑满内容区」的那个路由。
|
|
32
|
+
chatRoute: "chat",
|
|
33
|
+
routes: { ...ROUTES },
|
|
34
|
+
navItems: () => [
|
|
35
|
+
{ route: "chat", label: ROUTES.chat },
|
|
36
|
+
{ route: "home", label: ROUTES.home },
|
|
37
|
+
{ route: "personas", label: ROUTES.personas },
|
|
38
|
+
],
|
|
39
|
+
page: (ctx) => {
|
|
40
|
+
if (ctx.route === "home") {
|
|
41
|
+
return (
|
|
42
|
+
<main className="content" style={{ padding: 24 }}>
|
|
43
|
+
<h2>样板首页</h2>
|
|
44
|
+
<p>这是第二产品样板:只有两个业务路由,没有业务页面。</p>
|
|
45
|
+
</main>
|
|
46
|
+
);
|
|
47
|
+
}
|
|
48
|
+
if (ctx.route === "personas") return <PersonasPage />;
|
|
49
|
+
return null;
|
|
50
|
+
},
|
|
51
|
+
};
|
|
52
|
+
|
|
53
|
+
export { appDef };
|
|
54
|
+
|
|
55
|
+
export function App() {
|
|
56
|
+
return (
|
|
57
|
+
<AgentApp
|
|
58
|
+
def={appDef}
|
|
59
|
+
// 文案(坞标题、助手名)由产品给;core 不写死任何一句话、不认任何人格名。
|
|
60
|
+
texts={() => ({ title: "样板助手", assistantLabel: "助手" })}
|
|
61
|
+
/>
|
|
62
|
+
);
|
|
63
|
+
}
|
package/src/main.tsx
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
import { createRoot } from "react-dom/client";
|
|
2
|
-
import App from "./App.tsx";
|
|
3
|
-
import { applyThemeMode, loadThemeMode } from "./agent-chat/theme.ts";
|
|
4
|
-
import "./styles.css";
|
|
5
|
-
|
|
6
|
-
// Pin the saved theme mode before the first paint to avoid a flash.
|
|
7
|
-
applyThemeMode(loadThemeMode());
|
|
8
|
-
createRoot(document.getElementById("root")!).render(<App />);
|
|
1
|
+
import { createRoot } from "react-dom/client";
|
|
2
|
+
import App from "./App.tsx";
|
|
3
|
+
import { applyThemeMode, loadThemeMode } from "./agent-chat/theme.ts";
|
|
4
|
+
import "./styles.css";
|
|
5
|
+
|
|
6
|
+
// Pin the saved theme mode before the first paint to avoid a flash.
|
|
7
|
+
applyThemeMode(loadThemeMode());
|
|
8
|
+
createRoot(document.getElementById("root")!).render(<App />);
|