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

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/defaults.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 引擎共享小件：DSH 默认模型读取 + 发言人展示名（retitle / fold / conversation 共用）。
+ * @module dsh-group-chat/host/engine/defaults
+ */
+import type { RoleRecord } from '../../core/types.ts';
+import type { HostState } from '../state.ts';
+/** DSH 默认模型（agentDefaultModel 服务缺位或未配置时返回 null，调用方静默跳过）。 */
+export declare const defaultModel: (core: HostState) => {
+    provider: string;
+    model: string;
+} | null;
+/** 发言人展示名（roles 表内查角色名；user/system 固定文案，见 speakerLabel）。 */
+export declare const speakerNameOf: (roles: Map<string, RoleRecord>, speaker: string) => string;

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/lib/types/shared/file-mention-grammar.d.ts

@@ -4,6 +4,9 @@
  * Sourced from @deepseek-ai/dsh-file-reference/lib/types/grammar.js
  * Cannot import directly due to client bundle purity gate (dsh-client-bundle-purity).
  *
+ * 只保留输入侧的 @token 识别（activeAtToken）；候选的文本化（formatFileMention）
+ * 未被本插件采用——目录钻入走「插入整颗芯片」语义，见 docs/DESIGN.md Composer 契约。
+ *
  * @module dsh-group-chat/shared
  */
 export interface AtToken {
@@ -14,10 +17,6 @@ export interface AtToken {
     /** Whether the token uses quoted form @"..." */
     quoted: boolean;
 }
-export interface FileCandidate {
-    kind: 'file' | 'directory';
-    path: string;
-}
 /**
  * Extract active @token at cursor position.
  * Matches @ at word boundary (line start or after whitespace).
@@ -27,11 +26,3 @@ export interface FileCandidate {
  * @returns Token or undefined if no active @token at cursor
  */
 export declare function activeAtToken(line: string, cursor: number): AtToken | undefined;
-/**
- * Format file/directory candidate as @mention text.
- *
- * @param candidate - File or directory to format
- * @param preserveQuote - Keep quotes even when unnecessary (for drill-down continuity)
- * @returns Formatted @path or undefined for invalid paths
- */
-export declare function formatFileMention(candidate: FileCandidate, preserveQuote: boolean): string | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@roaming-ai/dsh-group-chat",
   "description": "DSH 模型群聊：多模型角色群组对话面板。角色绑定不同 provider/model，群内共享对话记录；设置页支持启用/停用。",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "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 {
@@ -40,16 +41,10 @@ export function GroupChatPanel(): ReactNode {
     setConfirmClear,
     roleDraft,
     setRoleDraft,
-    roleFormError,
-    setRoleFormError,
     models,
     setModels,
     modelsError,
     setModelsError,
-    fileBrowser,
-    setFileBrowser,
-    wsDraft,
-    setWsDraft,
     partsSel,
     setPartsSel,
     rounds,
@@ -83,7 +78,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 +90,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)
@@ -126,11 +123,11 @@ export function GroupChatPanel(): ReactNode {
     if (busyNow || !sess || sendingRef.current) return
     sendingRef.current = true
     try {
-      const parts = mentionedRoles.length ? mentionedRoles.map((r) => r.id) : participants
-      if (!parts.length) {
-        setErr(mentionedRoles.length ? '' : '请至少选择一个参与角色（或在消息中 @成员）')
-        if (!mentionedRoles.length) return
+      if (!participants.length && !mentionedRoles.length) {
+        setErr('请至少选择一个参与角色（或在消息中 @成员）')
+        return
       }
+      const parts = mentionedRoles.length ? mentionedRoles.map((r) => r.id) : participants
       const res = await action({ kind: 'send', sessionId: sess.id, text: input, participantRoleIds: parts, rounds }) as ActionOk | null
       if (res && !res.ok && res.error) setErr(res.error)
       else if (res && res.ok) {
@@ -140,6 +137,7 @@ export function GroupChatPanel(): ReactNode {
         setMention(null)
         setErr('')
         setAtBottom(true)
+        clearComposerDraft(sess.id)
         syncFromDOM()
       }
     } finally {
@@ -174,6 +172,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
@@ -206,51 +214,14 @@ export function GroupChatPanel(): ReactNode {
 
   const openRoleEditor = async (role: SnapshotRole | null): Promise<void> => {
     setErr('')
-    setRoleFormError('')
     if (!models || modelsError) await fetchModels()
     setRoleDraft(role ? draftFromRole(role) : blankDraft())
   }
 
-  const saveRole = async (): Promise<void> => {
-    if (!roleDraft) return
-    if (!roleDraft.name.trim()) {
-      setRoleFormError('角色名称不能为空')
-      return
-    }
-    if (!roleDraft.provider || !roleDraft.model) {
-      setRoleFormError('请选择角色绑定的模型')
-      return
-    }
-    const res = await mutate({ op: 'upsertRole', groupId: group.id, role: roleDraft })
-    if (res && res.ok && res.snapshot && !res.snapshot.error) {
-      setRoleDraft(null)
-      setRoleFormError('')
-    }
-  }
-
   const stopRun = async (): Promise<void> => {
     await action({ kind: 'stop', sessionId: sess!.id })
   }
 
-  const openBrowser = async (path: string | undefined): Promise<void> => {
-    setFileBrowser({ open: true, loading: true, list: null, error: '' })
-    try {
-      const res = await api.action({ kind: 'browse', path: path || '' }) as import('../core/types.ts').BrowseResult
-      if (res && res.ok) setFileBrowser({ open: true, loading: false, list: res, error: '' })
-      else setFileBrowser({ open: true, loading: false, list: null, error: (res && res.error) || '浏览失败' })
-    } catch (e) {
-      setFileBrowser({ open: true, loading: false, list: null, error: String((e && (e as Error).message) || e) })
-    }
-  }
-
-  const selectCurrentDir = (): void => {
-    if (!fileBrowser || !fileBrowser.list || !group) return
-    const path = fileBrowser.list.path!
-    void mutate({ op: 'setWorkspaceDir', groupId: group.id, path })
-    setWsDraft(null)
-    setFileBrowser(null)
-  }
-
   return (
     <div className="dsgc-root">
       <NavPanel
@@ -318,19 +289,14 @@ export function GroupChatPanel(): ReactNode {
         action={action}
         mutate={mutate}
         setMention={setMention}
+        onRetrySpeak={(messageId) => { void retrySpeak(messageId) }}
       />
       <AsidePanel
         snap={snap}
         group={group}
         asideOpen={asideOpen}
-        wsDraft={wsDraft}
-        setWsDraft={setWsDraft}
-        fileBrowser={fileBrowser}
-        setFileBrowser={setFileBrowser}
         mutate={mutate}
         openRoleEditor={openRoleEditor}
-        openBrowser={openBrowser}
-        selectCurrentDir={selectCurrentDir}
       />
       {sess && confirmClear
         ? (
@@ -348,7 +314,7 @@ export function GroupChatPanel(): ReactNode {
             )}
           >
             <ul className="dsgc-clearnotes">
-              <li>删除内容：本会话的用户消息与角色发言（含思考、工具调用记录），确认后立即落盘</li>
+              <li>删除内容：本会话的用户消息与角色发言（含思考、工具调用记录）以及本会话结论/约束备忘，确认后立即落盘</li>
               <li>不可恢复：此操作没有回收站，也没有撤销</li>
               <li>不受影响：会话本身与主题、群成员角色、工作区目录、权限档位</li>
             </ul>
@@ -371,12 +337,12 @@ export function GroupChatPanel(): ReactNode {
           <RoleDrawer
             draft={roleDraft}
             set={setRoleDraft}
+            groupId={group.id}
             models={models}
             modelsError={modelsError}
             onRetryModels={() => { void fetchModels() }}
-            onSave={() => { void saveRole() }}
-            onCancel={() => { setRoleDraft(null); setRoleFormError('') }}
-            formError={roleFormError}
+            mutate={mutate}
+            onCancel={() => { setRoleDraft(null) }}
           />
           )
         : null}

package/src/client/components/AsidePanel.tsx

@@ -1,28 +1,34 @@
 /**
- * 右侧成员与工作区栏组件
+ * 右侧成员与工作区栏组件。工作区目录编辑态（草稿、文件浏览器）为栏内自有状态。
  * @module dsh-group-chat/client/components
  */
 
-import type { ReactNode } from 'react'
+import { useState, type ReactNode } from 'react'
 import { Icon, P } from '../lib/ui.ts'
-import { roleById, type ClientSnapshot, type ModelsResponse, type RoleDraft, type SnapshotRole } from '../lib/model.ts'
+import { api } from '../lib/api.ts'
+import { roleById, type ClientSnapshot, type SnapshotRole } from '../lib/model.ts'
+import type { BrowseResult } from '../../core/types.ts'
 
 interface AsidePanelProps {
   snap: ClientSnapshot
   group: ClientSnapshot['groups'][number]
   asideOpen: boolean
-  wsDraft: string | null
-  setWsDraft: (val: string | null) => void
-  fileBrowser: { open: boolean, loading: boolean, list: import('../../core/types.ts').BrowseResult | null, error: string } | null
-  setFileBrowser: (val: { open: boolean, loading: boolean, list: import('../../core/types.ts').BrowseResult | null, error: string } | null) => void
   mutate: (args: Record<string, unknown>) => Promise<unknown>
-  openRoleEditor: (role: SnapshotRole | null) => Promise<void>
-  openBrowser: (path: string | undefined) => Promise<void>
-  selectCurrentDir: () => void
+  openRoleEditor: (role: SnapshotRole | null) => void
+}
+
+/** 文件浏览器态（栏内自有）。 */
+interface FileBrowserState {
+  open: boolean
+  loading: boolean
+  list: BrowseResult | null
+  error: string
 }
 
 export function AsidePanel(props: AsidePanelProps): ReactNode {
-  const { snap, group, asideOpen, wsDraft, setWsDraft, fileBrowser, setFileBrowser, mutate, openRoleEditor, openBrowser, selectCurrentDir } = props
+  const { snap, group, asideOpen, mutate, openRoleEditor } = props
+  const [wsDraft, setWsDraft] = useState<string | null>(null)
+  const [fileBrowser, setFileBrowser] = useState<FileBrowserState | null>(null)
 
   const commitWsDir = (): void => {
     if (wsDraft !== null && group && wsDraft !== (group.workspaceDir || '')) {
@@ -31,6 +37,25 @@ export function AsidePanel(props: AsidePanelProps): ReactNode {
     setWsDraft(null)
   }
 
+  const openBrowser = async (path: string | undefined): Promise<void> => {
+    setFileBrowser({ open: true, loading: true, list: null, error: '' })
+    try {
+      const res = await api.action({ kind: 'browse', path: path || '' }) as BrowseResult
+      if (res && res.ok) setFileBrowser({ open: true, loading: false, list: res, error: '' })
+      else setFileBrowser({ open: true, loading: false, list: null, error: (res && res.error) || '浏览失败' })
+    } catch (e) {
+      setFileBrowser({ open: true, loading: false, list: null, error: String((e && (e as Error).message) || e) })
+    }
+  }
+
+  const selectCurrentDir = (): void => {
+    if (!fileBrowser || !fileBrowser.list || !group) return
+    const path = fileBrowser.list.path!
+    void mutate({ op: 'setWorkspaceDir', groupId: group.id, path })
+    setWsDraft(null)
+    setFileBrowser(null)
+  }
+
   return (
     <div className={'dsgc-aside' + (asideOpen ? '' : ' closed')} aria-hidden={asideOpen ? undefined : 'true'}>
       <div className="dsgc-sec">
@@ -38,7 +63,7 @@ export function AsidePanel(props: AsidePanelProps): ReactNode {
           群成员
           <span className="dsgc-secspacer" />
           <span className="dsgc-seccount">{group.roleIds.length ? group.roleIds.length + ' 个' : ''}</span>
-          <P.Button variant="ghost" size="sm" onClick={() => { void openRoleEditor(null) }} aria-label="添加角色">
+          <P.Button variant="ghost" size="sm" onClick={() => { openRoleEditor(null) }} aria-label="添加角色">
             {Icon(P.IconPlusOutline16, 14)}添加
           </P.Button>
         </div>
@@ -54,8 +79,8 @@ export function AsidePanel(props: AsidePanelProps): ReactNode {
                     className={'dsgc-role' + (r.enabled ? '' : ' off')}
                     role="button"
                     tabIndex={0}
-                    onClick={() => { void openRoleEditor(r) }}
-                    onKeyDown={(e) => { if (e.key === 'Enter') { e.preventDefault(); void openRoleEditor(r) } }}
+                    onClick={() => { openRoleEditor(r) }}
+                    onKeyDown={(e) => { if (e.key === 'Enter') { e.preventDefault(); openRoleEditor(r) } }}
                     title="点击编辑角色"
                   >
                     <div className="dsgc-rolehead">
@@ -78,21 +103,23 @@ 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"
                           title="编辑角色"
                           aria-label="编辑角色"
-                          onClick={(e) => { e.stopPropagation(); void openRoleEditor(r) }}
+                          onClick={(e) => { e.stopPropagation(); openRoleEditor(r) }}
                         >
                           {Icon(P.IconEditOutline16, 14)}
                         </button>

package/src/client/components/Bubble.tsx

@@ -10,23 +10,40 @@
 
 import { memo, type ReactNode } from 'react'
 import { P } from '../lib/ui.ts'
-import { fmtTime, MD_LABELS, type ClientSnapshot, type SnapshotRole } from '../lib/model.ts'
+import { classifySpeakFailure, formatSpeakFailureCopy, isSpeakFailure } from '../../core/errors.ts'
+import { fmtTime, MD_LABELS, type SnapshotRole } from '../lib/model.ts'
+import type { SnapshotMessage } from '../lib/model.ts'
 import { ThinkRow } from './ThinkRow.tsx'
 import { ToolRow } from './ToolRow.tsx'
+import { FailCard } from './FailCard.tsx'
+import { MsgActions } from './MsgActions.tsx'
 
 export interface BubbleProps {
-  m: ClientSnapshot['messages'][number]
+  m: SnapshotMessage
   /** 父级解析好的发言角色（user/system 消息为 null）——避免 Bubble 依赖 snap identity。 */
   role: SnapshotRole | null
+  busy?: boolean
+  onRetry?: (messageId: string) => void
 }
 
-function BubbleInner({ m, role }: BubbleProps): ReactNode {
+function BubbleInner({ m, role, busy, onRetry }: BubbleProps): ReactNode {
   const isUser = m.speaker === 'user'
-  const isSys = m.speaker === 'system'
-  const name = isUser ? '我' : isSys ? '系统' : role ? role.name : '成员'
-  if (isSys) return <div className={'dsgc-sysmsg' + (m.error ? ' err' : '')}>{m.text}</div>
+  const isFail = isSpeakFailure(m)
+  const isSys = m.speaker === 'system' && !isFail && !role
+  const name = isUser ? '我' : role ? role.name : isSys ? '系统' : '成员'
+  if (isSys) return <div className="dsgc-sysmsg">{m.text}</div>
+
+  const retryTitle = !role
+    ? '失败角色已不存在，无法重试'
+    : !role.enabled
+      ? '该角色已停用，无法重试'
+      : busy
+        ? '已有对话进行中，请先停止'
+        : '重试该角色发言'
+  const copyText = isFail ? formatSpeakFailureCopy(classifySpeakFailure(m.text)) : (m.text || '')
+
   return (
-    <div className={'dsgc-msg' + (isUser ? ' mine' : '')}>
+    <div className={'dsgc-msg' + (isUser ? ' mine' : '') + (isFail ? ' fail' : '')}>
       <div
         className={'dsgc-avatar' + (isUser ? ' mine' : '')}
         style={isUser || !role ? undefined : { border: '2px solid ' + (role.color || '#888') }}
@@ -39,15 +56,24 @@ function BubbleInner({ m, role }: BubbleProps): ReactNode {
           {m.model ? <span className="dsgc-msgmodel" title={m.model}>{m.model}</span> : null}
           {m.ts ? <span className="dsgc-msgtime">{fmtTime(m.ts)}</span> : null}
         </div>
-        {isUser
-          ? <div className="dsgc-msgtext">{m.text}</div>
-          : (
-            <div className="dsgc-msgtext">
-              {m.reasoning ? <ThinkRow text={m.reasoning} /> : null}
-              {(Array.isArray(m.toolCalls) ? m.toolCalls : []).map((c, i) => <ToolRow key={'tc' + i} c={c} />)}
-              <P.MarkdownText text={m.text || '（无内容）'} labels={MD_LABELS} />
-            </div>
-            )}
+        {isFail
+          ? <FailCard raw={m.text} />
+          : isUser
+            ? <div className="dsgc-msgtext">{m.text}</div>
+            : (
+              <div className="dsgc-msgtext">
+                {m.reasoning ? <ThinkRow text={m.reasoning} /> : null}
+                {(Array.isArray(m.toolCalls) ? m.toolCalls : []).map((c, i) => <ToolRow key={'tc' + i} c={c} />)}
+                <P.MarkdownText text={m.text || '（无内容）'} labels={MD_LABELS} />
+              </div>
+              )}
+        <MsgActions
+          copyText={copyText}
+          always={isFail}
+          onRetry={isFail && onRetry ? () => { onRetry(m.id) } : undefined}
+          retryDisabled={busy || !role || !role.enabled}
+          retryTitle={retryTitle}
+        />
       </div>
     </div>
   )
@@ -55,10 +81,11 @@ function BubbleInner({ m, role }: BubbleProps): ReactNode {
 
 /** 渲染相关字段的值比较（消息不可变；角色仅名/色参与渲染）。 */
 function bubblePropsEqual(a: BubbleProps, b: BubbleProps): boolean {
+  if (a.busy !== b.busy || (a.onRetry == null) !== (b.onRetry == null)) return false
   const x = a.m
   const y = b.m
   if (x !== y) {
-    if (x.id !== y.id || x.speaker !== y.speaker || x.text !== y.text || x.reasoning !== y.reasoning || x.model !== y.model || x.error !== y.error || x.ts !== y.ts) return false
+    if (x.id !== y.id || x.speaker !== y.speaker || x.text !== y.text || x.reasoning !== y.reasoning || x.model !== y.model || x.error !== y.error || x.failedRoleId !== y.failedRoleId || x.ts !== y.ts) return false
     const ta = Array.isArray(x.toolCalls) ? x.toolCalls : []
     const tb = Array.isArray(y.toolCalls) ? y.toolCalls : []
     if (ta.length !== tb.length) return false
@@ -70,7 +97,7 @@ function bubblePropsEqual(a: BubbleProps, b: BubbleProps): boolean {
   }
   const ra = a.role
   const rb = b.role
-  return (ra ? ra.name + '\u0000' + (ra.color || '') : '') === (rb ? rb.name + '\u0000' + (rb.color || '') : '')
+  return (ra ? ra.id + '\u0000' + ra.name + '\u0000' + (ra.color || '') + '\u0000' + (ra.enabled ? '1' : '0') : '') === (rb ? rb.id + '\u0000' + rb.name + '\u0000' + (rb.color || '') + '\u0000' + (rb.enabled ? '1' : '0') : '')
 }
 
 export const Bubble = memo(BubbleInner, bubblePropsEqual)

package/src/client/components/ChatPanel.tsx

@@ -54,6 +54,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 function ChatPanel(props: ChatPanelProps): ReactNode {
@@ -101,6 +102,7 @@ export function ChatPanel(props: ChatPanelProps): ReactNode {
     action,
     mutate,
     setMention,
+    onRetrySpeak,
   } = props
 
   const commitTopic = (): void => {
@@ -115,6 +117,7 @@ export function ChatPanel(props: ChatPanelProps): ReactNode {
       busyNow={busyNow}
       msgById={msgById}
       action={action}
+      onRetrySpeak={onRetrySpeak}
     />
   )
 
@@ -143,18 +146,20 @@ export function ChatPanel(props: ChatPanelProps): ReactNode {
       </button>
       
       <div className="dsgc-chathead">
-        {sess ? <span className="dsgc-sess-title" title={'当前会话：' + sess.name}>{sess.name}</span> : null}
-        <input
-          className="dsgc-topic"
-          value={topicDraft === null ? (sess ? sess.topic : '') : topicDraft}
-          placeholder="设置本会话主题（可选）…"
-          onChange={(e) => { setTopicDraft(e.target.value) }}
-          onBlur={commitTopic}
-          onKeyDown={(e) => { if (e.key === 'Enter') (e.target as HTMLInputElement).blur() }}
-        />
-        <P.Button variant="ghost" size="sm" className="dsgc-clearbtn" title="清空当前会话的消息记录" onClick={() => { if (sess) setConfirmClear(true) }}>
-          清空
-        </P.Button>
+        <div className="dsgc-chathead-row">
+          {sess ? <span className="dsgc-sess-title" title={'当前会话：' + sess.name}>{sess.name}</span> : null}
+          <input
+            className="dsgc-topic"
+            value={topicDraft === null ? (sess ? sess.topic : '') : topicDraft}
+            placeholder="设置本会话主题（可选）…"
+            onChange={(e) => { setTopicDraft(e.target.value) }}
+            onBlur={commitTopic}
+            onKeyDown={(e) => { if (e.key === 'Enter') (e.target as HTMLInputElement).blur() }}
+          />
+          <P.Button variant="ghost" size="sm" className="dsgc-clearbtn" title="清空当前会话的消息记录" onClick={() => { if (sess) setConfirmClear(true) }}>
+            清空
+          </P.Button>
+        </div>
       </div>
       
       <div className="dsgc-msgs" ref={scrollRef} onScroll={onMsgsScroll}>