@roaming-ai/dsh-group-chat 0.2.2 → 0.3.0

package/lib/types/client/components/Bubble.d.ts

@@ -8,12 +8,15 @@
  * @module dsh-group-chat/client/Bubble
  */
 import { type ReactNode } from 'react';
-import { type ClientSnapshot, type SnapshotRole } from '../lib/model.ts';
+import { type SnapshotRole } from '../lib/model.ts';
+import type { SnapshotMessage } from '../lib/model.ts';
 export interface BubbleProps {
-    m: ClientSnapshot['messages'][number];
+    m: SnapshotMessage;
     /** 父级解析好的发言角色（user/system 消息为 null）——避免 Bubble 依赖 snap identity。 */
     role: SnapshotRole | null;
+    busy?: boolean;
+    onRetry?: (messageId: string) => void;
 }
-declare function BubbleInner({ m, role }: BubbleProps): ReactNode;
+declare function BubbleInner({ m, role, busy, onRetry }: BubbleProps): ReactNode;
 export declare const Bubble: import("react").MemoExoticComponent<typeof BubbleInner>;
 export {};

package/lib/types/client/components/ChatPanel.d.ts

@@ -52,6 +52,7 @@ interface ChatPanelProps {
     action: (payload: Record<string, unknown>) => Promise<unknown>;
     mutate: (args: Record<string, unknown>) => Promise<unknown>;
     setMention: (val: AtToken | null) => void;
+    onRetrySpeak: (messageId: string) => void;
 }
 export declare function ChatPanel(props: ChatPanelProps): ReactNode;
 export {};

package/lib/types/client/components/ConstraintList.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 会话流折点处：只读结论备忘卡（超过 4 条默认露 3 条）。
+ * @module dsh-group-chat/client/components
+ */
+import { type ReactNode } from 'react';
+import type { SessionConstraint } from '../../core/types.ts';
+interface ConstraintListProps {
+    items: SessionConstraint[];
+}
+export declare function ConstraintList(props: ConstraintListProps): ReactNode;
+export {};

package/lib/types/client/components/FailCard.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 角色发言失败卡：人话标题 + 可展开原文。操作条由 Bubble 放在气泡外下方。
+ * @module dsh-group-chat/client/FailCard
+ */
+import { type ReactNode } from 'react';
+export interface FailCardProps {
+    raw: string;
+}
+export declare function FailCard(props: FailCardProps): ReactNode;

package/lib/types/client/components/Fold.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 会话内折叠：高度 0fr→1fr + 溢出滚动遮罩。思考 / 工具 / 失败原文 / 结论备忘共用。
+ * @module dsh-group-chat/client/components
+ */
+import { type ReactNode } from 'react';
+interface FoldProps {
+    open: boolean;
+    children: ReactNode;
+    className?: string;
+}
+export declare function Fold(props: FoldProps): ReactNode;
+interface ClipWellProps {
+    children: ReactNode;
+    maxHeight: number;
+    className?: string;
+    watch?: unknown;
+}
+export declare function ClipWell(props: ClipWellProps): ReactNode;
+export {};

package/lib/types/client/components/HoverTip.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 对齐宿主 Tooltip 的 hover 气泡：portal 到 document.body，躲开
+ * `.dsgc-root` 的 container-type 把 position:fixed 按容器定位。
+ * @module dsh-group-chat/client/components
+ */
+import { type ReactNode } from 'react';
+export type HoverTipSide = 'top' | 'right';
+interface HoverTipProps {
+    label: string;
+    side?: HoverTipSide;
+    delayMs?: number;
+    maxWidth?: number;
+    className?: string;
+    children: ReactNode;
+}
+/**
+ * @param props.label 气泡正文（pre-line）
+ * @param props.side 默认 right（对齐侧栏会话行）；composer 轮数用 top
+ * @param props.delayMs hover 延迟，默认 500；键盘 focus 立即出
+ */
+export declare function HoverTip(props: HoverTipProps): ReactNode;
+export {};

package/lib/types/client/components/MessageFlow.d.ts

@@ -10,6 +10,7 @@ interface MessageFlowProps {
     busyNow: boolean;
     msgById: Record<string, ClientSnapshot['messages'][number]>;
     action: (payload: Record<string, unknown>) => Promise<unknown>;
+    onRetrySpeak: (messageId: string) => void;
 }
 export declare function MessageFlow(props: MessageFlowProps): ReactNode;
 export {};

package/lib/types/client/components/MsgActions.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 消息操作条：贴在气泡外下方。用户/角色消息悬停出「复制」；失败卡常驻「复制 / 重试」。
+ * @module dsh-group-chat/client/MsgActions
+ */
+import { type ReactNode } from 'react';
+export interface MsgActionsProps {
+    copyText: string;
+    onRetry?: () => void;
+    retryDisabled?: boolean;
+    retryTitle?: string;
+    /** 失败卡：不依赖悬停，始终可见。 */
+    always?: boolean;
+}
+export declare function MsgActions(props: MsgActionsProps): ReactNode;

package/lib/types/client/hooks/useComposer.d.ts

@@ -8,13 +8,18 @@ import type { SnapshotRole } from '../lib/model.ts';
 export declare function useComposerEffects(inputRef: React.RefObject<HTMLDivElement>, scrollRef: React.RefObject<HTMLDivElement>, input: string, atBottom: boolean, snap: unknown): {
     onMsgsScroll: () => boolean | undefined;
 };
-export declare function useComposerInput(inputRef: React.RefObject<HTMLDivElement>, setInput: (val: string) => void, setMention: (val: AtToken | null) => void, setMentionIdx: (val: number) => void): {
+export declare function useComposerInput(inputRef: React.RefObject<HTMLDivElement>, setInput: (val: string) => void, setMention: (val: AtToken | null) => void, setMentionIdx: (val: number) => void, sessionId?: string | null): {
     syncFromDOM: () => void;
     onInputCE: () => void;
     onPasteCE: (e: ReactClipboardEvent<HTMLDivElement>) => void;
     onDragOverCE: (e: ReactDragEvent<HTMLDivElement>) => void;
     onDropCE: (e: ReactDragEvent<HTMLDivElement>) => void;
 };
+/**
+ * 按会话恢复草稿：切会话时先把当前 HTML 写入旧槽，再灌入新槽；
+ * 面板重挂载（主会话⇄群聊）时 editor 是新节点，从模块缓存灌回。
+ */
+export declare function useComposerDraft(sessionId: string | null | undefined, inputRef: React.RefObject<HTMLDivElement>, setInput: (val: string) => void, setMention: (val: AtToken | null) => void): void;
 export declare function useMentionChip(inputRef: React.RefObject<HTMLDivElement>, setMention: (val: AtToken | null) => void, setMentionIdx: (val: number) => void, syncFromDOM: () => void): {
     insertChip: (role: SnapshotRole) => void;
     insertFileChip: (path: string, kind: "file" | "directory") => void;

package/lib/types/client/lib/composer-draft.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 未发送草稿：按会话 id 分槽，模块级跨挂载存活。
+ * 主会话⇄群聊会整页卸载 composer，contentEditable 的 HTML 必须自行记住。
+ * @module dsh-group-chat/client/composer-draft
+ */
+export interface ComposerDraft {
+    html: string;
+    text: string;
+}
+/** 读指定会话草稿；命中则提到 LRU 最近端。 */
+export declare function readComposerDraft(sessionId: string | null | undefined): ComposerDraft;
+/** 写入；空草稿删槽。超出上限淘汰最旧槽。 */
+export declare function writeComposerDraft(sessionId: string | null | undefined, html: string, text: string): void;
+/** 发送成功或明确丢弃时摘槽。 */
+export declare function clearComposerDraft(sessionId: string | null | undefined): void;
+/** 测试用：清空全部槽位。 */
+export declare function resetComposerDrafts(): void;

package/lib/types/core/constraints.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 会话约束备忘纯逻辑：滑动 40 条窗口、挤出集、压行、临时原文、解析与截断。
+ * @module dsh-group-chat/core/constraints
+ */
+import { type MessageRecord, type SessionConstraint, type SessionRecord } from './types.ts';
+/** 当场原文窗口（含系统行）。 */
+export declare const WINDOW_SIZE = 40;
+/** 折叠失败时临时原文条数上限。 */
+export declare const TEMP_MAX_MESSAGES = 20;
+/** 折叠失败时临时原文总长上限。 */
+export declare const TEMP_MAX_CHARS = 16000;
+/** 单轮折叠最多消耗的挤出条数（含系统行；超出留待下一轮）。 */
+export declare const FOLD_MAX_MESSAGES = 40;
+/** 单轮折叠输入总长上限（格式化后）。 */
+export declare const FOLD_MAX_CHARS = 16000;
+/** 备忘条数上限。 */
+export declare const CONSTRAINT_MAX_ITEMS = 12;
+/** 备忘总长上限（条目前缀+正文）。 */
+export declare const CONSTRAINT_MAX_CHARS = 1200;
+/** 单条备忘正文上限。 */
+export declare const CONSTRAINT_ITEM_MAX_CHARS = 160;
+export declare const KIND_LABEL: Record<SessionConstraint['kind'], string>;
+/** 已折入水位（缺省 0）。 */
+export declare function constraintsWatermark(sess: SessionRecord): number;
+/** 重试：只取失败卡之前的时间线；untilId 不在列表则原样。 */
+export declare function prefixIds(ids: string[], untilId?: string): string[];
+/**
+ * 新挤出：seq > 水位 且不在最近 40 条。只扫窗口外前缀（旧→新）。
+ * untilId：重试时把窗口截到该消息之前，不带上后面已经发生的发言。
+ */
+export declare function squeezedMessages(messages: Map<string, MessageRecord>, sess: SessionRecord, untilId?: string): MessageRecord[];
+/** 说话人展示名（折叠输入 / transcript 共用）。 */
+export declare function speakerLabel(speaker: string, roleName?: string): string;
+/** 单条消息压成 transcript 行（正文 8k + 工具一行摘要）。 */
+export declare function formatTranscriptLine(m: MessageRecord, name: string): string;
+/**
+ * 单轮折叠消耗前缀：从最旧挤出起，最多 40 条 / 16k；系统行与失败卡计入消耗但不进模型。
+ * 水位只能推到 consumed 的 max seq，剩余留待下一轮。
+ */
+export declare function takeFoldBatch(squeezed: MessageRecord[], nameOf: (m: MessageRecord) => string): {
+    consumed: MessageRecord[];
+    lines: string[];
+    hasUser: boolean;
+    allSystem: boolean;
+};
+/**
+ * 未折入的挤出原文（失败缓冲）：只格式化最近 20 条，再按 16k 从最旧往下丢。
+ */
+export declare function tempTranscript(squeezed: MessageRecord[], nameOf: (m: MessageRecord) => string): string;
+/** 水位 = 本批挤出的 max(seq)；空批为 0。 */
+export declare function squeezedMaxSeq(squeezed: MessageRecord[]): number;
+/** hydrate / 模型输出：非法 kind 丢条目；空 text 丢；条数与总长截断。 */
+export declare function sanitizeConstraints(raw: unknown): SessionConstraint[];
+/**
+ * 解析折叠模型输出。null = 解析失败（水位不推）；[] = 无新结论（水位推、备忘不动）。
+ */
+export declare function parseConstraints(raw: string): SessionConstraint[] | null;
+/** 本批无用户消息时，新的已定/否决降为未决。 */
+export declare function downgradeWithoutUser(list: SessionConstraint[], hasUser: boolean): SessionConstraint[];
+/** system 提示词「已确认约束」块；空则空串。 */
+export declare function constraintBlock(list: SessionConstraint[] | undefined): string;

package/lib/types/core/errors.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 角色发言失败：供应商原文 → 人话标题/原因（core 纯函数，无 React）。
+ * 原始 JSON 仍落盘在消息 text 里，UI 默认只展示短因，展开才看原文。
+ * @module dsh-group-chat/core/errors
+ */
+export interface SpeakFailureView {
+    /** 一行标题，例如「额度已用尽」。 */
+    title: string;
+    /** 可选短因：重置时间、HTTP 状态等。 */
+    detail?: string;
+    /** 复制/排障用的供应商原文（已剥「模型输出异常终止: 」前缀）。 */
+    raw: string;
+}
+/** 剥旧系统胶囊与引擎包装前缀，保留供应商原文。 */
+export declare function unwrapSpeakFailure(raw: string): string;
+/** 旧系统胶囊文案：角色「名」发言失败：原文。对不上则 null。 */
+export declare function parseLegacyRoleFailure(text: string): {
+    roleName: string;
+    rest: string;
+} | null;
+export interface RoleRef {
+    id: string;
+    name: string;
+    provider?: string;
+    model?: string;
+}
+export interface FailedMessageRef {
+    speaker: string;
+    text: string;
+    error?: boolean;
+    failedRoleId?: string;
+}
+/** 发言失败卡：error 标记，或旧系统胶囊文案。 */
+export declare function isSpeakFailure(m: FailedMessageRef): boolean;
+/** 失败回合对应角色：failedRoleId / speaker / 旧文案里的角色名（恰好一名才命中）。 */
+export declare function resolveFailedRole<T extends RoleRef>(m: FailedMessageRef, roles: T[]): T | null;
+/**
+ * 把旧系统失败行挂到对应角色（恰好一名命中才迁）。
+ * 返回是否改写了记录。
+ */
+export declare function repairFailedMessage(m: {
+    speaker: string;
+    text: string;
+    error?: boolean;
+    failedRoleId?: string;
+    model?: string;
+}, roles: RoleRef[]): boolean;
+/**
+ * 把供应商错误压成可扫描的标题 + 短因。
+ * 未知形态回退为「发言失败」，原文仍可展开。
+ */
+export declare function classifySpeakFailure(raw: string): SpeakFailureView;
+/** 失败卡默认复制内容：标题 + 短因 + 原文。 */
+export declare function formatSpeakFailureCopy(view: SpeakFailureView): string;

package/lib/types/core/types.d.ts

@@ -29,6 +29,17 @@ export interface GroupRecord {
     roleIds: string[];
     sessionIds: string[];
 }
+/** 会话约束条目类型（窗口外结论/约束备忘）。 */
+export type ConstraintKind = 'decided' | 'rejected' | 'open';
+/** 全部合法约束类型。 */
+export declare const CONSTRAINT_KINDS: readonly ConstraintKind[];
+/** 合法 kind 原样，其余 undefined。 */
+export declare function asConstraintKind(value: unknown): ConstraintKind | undefined;
+/** 一条无主结论/约束（已定 / 否决 / 未决）。 */
+export interface SessionConstraint {
+    kind: ConstraintKind;
+    text: string;
+}
 /** 会话：消息挂在会话上。 */
 export interface SessionRecord {
     id: string;
@@ -39,6 +50,10 @@ export interface SessionRecord {
     namePinned?: boolean;
     /** 主题已被手动编辑：自动整理永久跳过（隐式固定）。 */
     topicPinned?: boolean;
+    /** 窗口外结论/约束备忘；空则省略。 */
+    constraints?: SessionConstraint[];
+    /** 已折入备忘的最大消息 seq；0/缺省 = 尚未折过。 */
+    constraintsUpToSeq?: number;
     messageIds: string[];
     createdAt: number;
 }
@@ -76,6 +91,8 @@ export interface MessageRecord {
     thinkingSummary?: string;
     model?: string;
     error?: boolean;
+    /** 发言失败时的角色 id；刷新后仍可对该条点重试。角色消息 speaker 即角色 id，此字段冗余兼容旧系统错误行。 */
+    failedRoleId?: string;
     toolCalls?: ToolCallRecord[];
     ts: number;
 }
@@ -114,6 +131,8 @@ export interface RunState {
     childProc: import('node:child_process').ChildProcess | null;
     /** 最近一次 run 的结束标记：会话列表「已完成/已出错」状态的数据源。 */
     finished: RunFinished | null;
+    /** 原地重试时被覆盖的失败消息 id；普通 send 为 null。 */
+    replaceMessageId: string | null;
 }
 /** 角色发言的引擎产物。 */
 export interface SpeakResult {
@@ -185,6 +204,7 @@ export interface Snapshot {
         partialReasoning: string;
         pendingConfirm: PendingConfirm | null;
         finished: RunFinished | null;
+        replaceMessageId: string | null;
     };
     lastCreated: LastCreated | null;
     groups: {
@@ -200,6 +220,7 @@ export interface Snapshot {
         groupId: string;
         name: string;
         topic: string;
+        constraints?: SessionConstraint[];
         messageIds: string[];
         createdAt: number;
     }[];
@@ -225,6 +246,7 @@ export interface Snapshot {
         reasoning?: string;
         model?: string;
         error?: boolean;
+        failedRoleId?: string;
         toolCalls?: ToolCallRecord[];
         ts: number;
     }[];

package/lib/types/host/api/actions.d.ts

@@ -1,6 +1,6 @@
 /**
  * 动作分发（handleAction，POST /api/group-chat/action 的载荷）：
- * mutate（12 种 CRUD/配置操作）| send | stop | confirmCommand | models | efforts。
+ * mutate（12 种 CRUD/配置操作）| send | retrySpeak | stop | confirmCommand | models | efforts。
  * @module dsh-group-chat/host/api/actions
  */
 import type { Snapshot } from '../../core/types.ts';

package/lib/types/host/engine/conversation.d.ts

@@ -1,6 +1,6 @@
 /**
  * 对话引擎：消息追加、群聊记录转写、角色发言（speak：prompt 构建 + 流式
- * 轮次 + 工具回注循环）、多轮 runLoop（每轮结束触发 retitle 标题整理）。
+ * 轮次 + 工具回注循环）、多轮 runLoop（结束时后台 retitle + 窗口外约束折叠）。
  * @module dsh-group-chat/host/engine/conversation
  */
 import type { MessageRecord, SessionRecord } from '../../core/types.ts';
@@ -11,8 +11,10 @@ import type { Tools } from '../tools/index.ts';
 export interface Conversation {
     /** 追加一条消息到会话（touch + 落盘调度）。 */
     appendMessage: (sess: SessionRecord, speaker: string, text: string, extra?: Partial<MessageRecord>) => MessageRecord;
-    /** 多轮 round-robin 主循环（send 触发；finally 复位 run）。 */
-    runLoop: (sess: SessionRecord) => Promise<void>;
+    /** 多轮 round-robin 主循环（send / retrySpeak 触发；finally 复位 run）。 */
+    runLoop: (sess: SessionRecord, opts?: {
+        replaceMessageId?: string;
+    }) => Promise<void>;
 }
 /** 创建对话引擎。 */
 export declare function createConversation(core: HostState, deps: {

package/lib/types/host/engine/fold.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 窗口外结论/约束备忘：整次 runLoop 结束后后台折叠（仿 retitle）。
+ * 立刻 idle；未折完用水位 + 临时原文表达。v1 复用 purpose session-title 关思考。
+ * @module dsh-group-chat/host/engine/fold
+ */
+import type { SessionRecord } from '../../core/types.ts';
+import type { HostState } from '../state.ts';
+/**
+ * 每轮 send 结束后折叠窗口外约束：fire-and-forget、不产生消息、静默失败。
+ * 同会话去重；会话已清空则 abort。内存 {constraints, constraintsUpToSeq} 一次挂上。
+ */
+export declare function createFold(core: HostState, deps: {
+    touch: () => void;
+    schedulePersist: (targets?: {
+        session?: string | null;
+    }) => void;
+}): (sess: SessionRecord) => Promise<void>;

package/lib/types/host/engine/index.d.ts

@@ -4,4 +4,5 @@
  */
 export { createConversation } from './conversation.ts';
 export type { Conversation } from './conversation.ts';
+export { createFold } from './fold.ts';
 export { createRetitle } from './retitle.ts';

package/lib/types/host/engine/retitle.d.ts

@@ -1,16 +1,16 @@
 /**
  * 会话标题/主题自动整理（参照 oil-codex-title）：每轮结束后用 DSH 默认模型
- * 后台生成「类别 emoji + 对象｜目标」名称与演进式主题；手动编辑过的字段
+ * 后台生成。名称只在仍为默认占位时写一次；主题每轮演进。手动编辑过的字段
  * 永久跳过（隐式固定）。
  * @module dsh-group-chat/host/engine/retitle
  */
 import type { SessionRecord } from '../../core/types.ts';
-import type { HostState } from '../state.ts';
+import { type HostState } from '../state.ts';
 /**
  * 每轮结束后根据聊天内容整理会话名称与主题：后台 fire-and-forget、不产生
- * 消息、静默失败。名称 =「类别 emoji + 对象｜目标」（类别固定、对象稳定、
- * 目标实质变化才改）；主题 = 演进式一句话摘要（对象+目标+当前焦点），注入
- * 后续轮次的角色上下文。手动编辑过的字段永久跳过（隐式固定，apply 时复查）。
+ * 消息、静默失败。名称只在仍为默认占位时生成一次（「类别 emoji + 对象｜目标」）；
+ * 主题 = 演进式一句话摘要（对象+目标+当前焦点），每轮更新，注入后续角色上下文。
+ * 手动编辑过的字段永久跳过（隐式固定，apply 时复查）。
  */
 export declare function createRetitle(core: HostState, deps: {
     touch: () => void;

package/lib/types/host/service.d.ts

@@ -6,7 +6,7 @@
  *   persistence/   持久化（store 文件原语 + 脏标记合并落盘 + 启动恢复）
  *   materials/     资料读取与路径解析 + 目录浏览器
  *   tools/         工具执行（沙箱 + 确认闸门）
- *   engine/        对话引擎（conversation：speak/runLoop；retitle：标题整理）
+ *   engine/        对话引擎（conversation：speak/runLoop；retitle：标题整理；fold：窗口外约束）
  *   api/           HTTP 传输（http 护栏 + routes 路由）与动作分发（actions）
  * @module dsh-group-chat/host/service
  */

package/lib/types/host/state.d.ts

@@ -20,6 +20,8 @@ declare module '@deepseek-ai/cordis' {
 }
 /** 角色标识色板（新增角色依序取色）。 */
 export declare const PALETTE: string[];
+/** 新建会话默认名称（自动标题只在仍为此占位名时生成一次）。 */
+export declare const DEFAULT_SESSION_NAME = "\u65B0\u4F1A\u8BDD";
 /** 宿主服务共享状态容器（见模块注释；可变原始值一律经 core.* 访问）。 */
 export interface HostState {
     ctx: Context;

package/lib/types/index.d.ts

@@ -10,6 +10,8 @@
  *    数据模型：Group 1..N Session，消息挂在会话上；角色与工作区目录挂在群组上
  *  - 群组与会话的增删改；群组/会话检索由客户端在快照上过滤
  *  - 角色发言经 `llm` 服务流式生成，按角色绑定的 provider/model 路由
+ *  - 整次 runLoop 结束后后台折叠被 40 条窗口挤出的消息为会话级约束备忘
+ *    （engine/fold.ts；立刻 idle、fire-and-forget，不产生消息）
  *  - 群组工作区目录经 `fs` 服务读取（根下一层文本文件，最多 20 个），
  *    以「共享资料」块注入每个角色的 system 提示词；无独立笔记/文件清单
  *  - 经 `webServer` 暴露 HTTP API：

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@roaming-ai/dsh-group-chat",
   "description": "DSH 模型群聊：多模型角色群组对话面板。角色绑定不同 provider/model，群内共享对话记录；设置页支持启用/停用。",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"

package/src/client/GroupChatPanel.tsx

@@ -15,9 +15,10 @@ import { NavPanel } from './components/NavPanel.tsx'
 import { AsidePanel } from './components/AsidePanel.tsx'
 import { ChatPanel } from './components/ChatPanel.tsx'
 import { useGroupChatState, type ActionOk } from './hooks/useGroupChatState.ts'
-import { useComposerEffects, useComposerInput, useMentionChip, useInputKeyboard } from './hooks/useComposer.ts'
+import { useComposerEffects, useComposerInput, useComposerDraft, useMentionChip, useInputKeyboard } from './hooks/useComposer.ts'
 import { useFileSearch } from './hooks/useFileSearch.ts'
 import { useMentionCandidates, useMentionedRoles, useSafeMentionIndex } from './hooks/useMentionState.ts'
+import { clearComposerDraft } from './lib/composer-draft.ts'
 import { draftFromRole, blankDraft, groupById, roleById, sessById, type ClientSnapshot, type ModelsResponse, type SnapshotRole } from './lib/model.ts'
 
 export function GroupChatPanel(): ReactNode {
@@ -83,7 +84,6 @@ export function GroupChatPanel(): ReactNode {
   // ---- 所有 Hooks 必须在条件返回之前调用 ----
   // Composer effects
   const { onMsgsScroll } = useComposerEffects(inputRef, scrollRef, input, atBottom, snap)
-  const { syncFromDOM, onInputCE, onPasteCE, onDragOverCE, onDropCE } = useComposerInput(inputRef, setInput, setMention, setMentionIdx)
 
   // 选中群组/会话解析（用于 hooks 依赖）
   let group = snap && gid ? groupById(snap, gid) : null
@@ -96,6 +96,9 @@ export function GroupChatPanel(): ReactNode {
     sess = group.sessionIds.length ? sessById(snap, group.sessionIds[group.sessionIds.length - 1]) : null
   }
 
+  const { syncFromDOM, onInputCE, onPasteCE, onDragOverCE, onDropCE } = useComposerInput(inputRef, setInput, setMention, setMentionIdx, sess ? sess.id : null)
+  useComposerDraft(sess ? sess.id : null, inputRef, setInput, setMention)
+
   const enabledRoles = group ? group.roleIds.map((id) => roleById(snap!, id)).filter((r): r is SnapshotRole => !!r && r.enabled) : []
   const participants = partsSel || enabledRoles.map((r) => r.id)
   const busyNow = !!(sess && snap && snap.run.running && snap.run.sessionId === sess.id)
@@ -140,6 +143,7 @@ export function GroupChatPanel(): ReactNode {
         setMention(null)
         setErr('')
         setAtBottom(true)
+        clearComposerDraft(sess.id)
         syncFromDOM()
       }
     } finally {
@@ -174,6 +178,16 @@ export function GroupChatPanel(): ReactNode {
     setPartsSel(has ? participants.filter((x) => x !== rid) : participants.concat([rid]))
   }
 
+  const retrySpeak = async (messageId: string): Promise<void> => {
+    if (!sess) return
+    if (busyNow || (snap && snap.run.running)) {
+      setToast({ text: '已有对话进行中，请先停止', seq: Date.now() })
+      return
+    }
+    const res = await action({ kind: 'retrySpeak', sessionId: sess.id, messageId }) as ActionOk | null
+    if (res && !res.ok && res.error) setToast({ text: res.error, seq: Date.now() })
+  }
+
   // 清空确认：不可清空（对话进行中）走 toast 提示，不再落到输入框上方的红字
   const doClear = async (): Promise<void> => {
     if (!sess) return
@@ -318,6 +332,7 @@ export function GroupChatPanel(): ReactNode {
         action={action}
         mutate={mutate}
         setMention={setMention}
+        onRetrySpeak={(messageId) => { void retrySpeak(messageId) }}
       />
       <AsidePanel
         snap={snap}
@@ -348,7 +363,7 @@ export function GroupChatPanel(): ReactNode {
             )}
           >
             <ul className="dsgc-clearnotes">
-              <li>删除内容：本会话的用户消息与角色发言（含思考、工具调用记录），确认后立即落盘</li>
+              <li>删除内容：本会话的用户消息与角色发言（含思考、工具调用记录）以及本会话结论/约束备忘，确认后立即落盘</li>
               <li>不可恢复：此操作没有回收站，也没有撤销</li>
               <li>不受影响：会话本身与主题、群成员角色、工作区目录、权限档位</li>
             </ul>

package/src/client/components/AsidePanel.tsx

@@ -78,15 +78,17 @@ export function AsidePanel(props: AsidePanelProps): ReactNode {
                     </div>
                     {r.persona ? <div className="dsgc-rolepersona" title={r.persona}>{r.persona}</div> : null}
                     <div className="dsgc-rolemenu">
-                      <span
-                        className="dsgc-rolemodel"
-                        title={r.provider + ' / ' + r.model + (r.thinking ? ' · 深度思考' + (r.reasoningEffort && r.reasoningEffort !== 'default' ? '（' + r.reasoningEffort + '）' : '') : '')}
-                      >
-                        {r.provider} / {r.model}
+                      <span className="dsgc-rolemeta">
+                        <span
+                          className="dsgc-rolemodel"
+                          title={r.provider + ' / ' + r.model + (r.thinking ? ' · 深度思考' + (r.reasoningEffort && r.reasoningEffort !== 'default' ? '（' + r.reasoningEffort + '）' : '') : '')}
+                        >
+                          {r.provider} / {r.model}
+                        </span>
+                        {r.thinking
+                          ? <span className="dsgc-rolethink" title="深度思考">{Icon(P.IconThinkOutline14, 14)}</span>
+                          : null}
                       </span>
-                      {r.thinking
-                        ? <span title="深度思考" style={{ display: 'inline-flex', alignItems: 'center', color: 'var(--dsw-alias-label-tertiary,inherit)' }}>{Icon(P.IconThinkOutline14, 14)}</span>
-                        : null}
                       <span className="dsgc-roleops">
                         <button
                           className="dsgc-opbtn"