@ljwei-stak/dsh-model-route-bot 0.66.3 → 0.67.0

package/apps/integration-client/independent-chat-controller.mjs

@@ -0,0 +1,224 @@
+const failure = (code, message = code) => Object.assign(new Error(message), { code })
+const BOT = /^[-A-Za-z0-9_.]{1,128}$/
+const HOST = /^host-[0-9a-f]{16}$/
+const KEY = /^[-A-Za-z0-9_]{16,128}$/
+const STATES = new Set(['accepted', 'running', 'succeeded', 'unknown', 'refused', 'cancelled'])
+const withoutProgress = status => {
+  if (!status) return status
+  const { progress, ...stored } = status
+  return stored
+}
+export const independentChatStorageKey = (hostId, botId) => `bot-product:independent-chat:1:${hostId}:${botId}`
+export const independentChatNonce = () => {
+  if (typeof globalThis.crypto?.randomUUID !== 'function') throw failure('CHAT_NONCE_UNAVAILABLE', '浏览器无法生成安全请求编号。')
+  return globalThis.crypto.randomUUID()
+}
+export function validateChatRequest(value, botId, requestKey) {
+  if (value?.schemaVersion !== 1 || value.botId !== botId || !KEY.test(value.requestKey ?? '') || (requestKey && value.requestKey !== requestKey)
+    || !STATES.has(value.state) || typeof value.pending !== 'boolean' || typeof value.finished !== 'boolean' || value.stopConfirmed !== false) throw failure('CHAT_IDENTITY_MISMATCH', '宿主返回的请求身份或状态无效，请保留原编号核对。')
+  const progress = value.progress
+  if (value.operationKind !== undefined && !['send', 'new-conversation'].includes(value.operationKind)) throw failure('CHAT_IDENTITY_MISMATCH')
+  if (progress != null && (value.operationKind === 'new-conversation' || !value.pending || !['accepted', 'running'].includes(value.state) || !Number.isSafeInteger(progress.step) || progress.step < 1 || progress.step > 64
+    || !Number.isSafeInteger(progress.sequence) || progress.sequence < 1 || typeof progress.text !== 'string' || progress.text.length > 64000 || typeof progress.truncated !== 'boolean')) throw failure('CHAT_PROGRESS_INVALID', '宿主返回的生成预览格式无效。')
+  return value
+}
+export function validateChatPage(value, botId) {
+  if (value?.schemaVersion !== 1 || value.botId !== botId || !Array.isArray(value.items) || value.items.length > 100
+    || (value.nextCursor !== null && typeof value.nextCursor !== 'string')
+    || value.items.some(row => !row || typeof row.messageId !== 'string' || !row.messageId || typeof row.content !== 'string'
+      || !['user', 'assistant', 'tool', 'system'].includes(row.role) || row.contextId !== undefined && (typeof row.contextId !== 'string' || !row.contextId || row.contextId.length > 128))
+    || new Set(value.items.map(row => row.messageId)).size !== value.items.length) throw failure('CHAT_PAGE_INVALID', '会话页缺少稳定消息编号，已拒绝显示可能错位的内容。')
+  return value
+}
+
+/** One mounted, validated Host/Bot. This metadata never authenticates an owner.
+ * A persisted uncertain key is inspected only. send() is reachable solely from
+ * the owner's explicit submit, after its nonce and exact text are durable.
+ */
+export function createIndependentChatController({ api, hostId, botId, storage = globalThis.localStorage, pollMs = 1500, timeoutMs = 8000,
+  nonce = independentChatNonce, onHostChanged } = {}) {
+  if (!HOST.test(hostId ?? '') || !BOT.test(botId ?? '') || typeof api?.dispatch !== 'function') throw failure('CHAT_SCOPE_INVALID')
+  const key = independentChatStorageKey(hostId, botId), listeners = new Set(), calls = new Set()
+  let live = false, retired = false, timer, polling = false, lock = false, pageLock = false, revision = 0, pageLoaded = false, exhausted = false
+  let nextNonce = nonce()
+  if (!KEY.test(nextNonce ?? '')) throw failure('CHAT_NONCE_INVALID')
+  let state = { hostId, botId, draft: '', pending: null, lastRequest: null, view: null, items: [], nextCursor: null,
+    loading: true, sending: false, loadingOlder: false, error: '', storageError: '', acknowledgedRequestKey: null }
+  const publish = patch => { if (retired) return; state = { ...state, ...patch }; for (const listener of listeners) listener() }
+  const persist = patch => {
+    const next = { ...state, ...patch }
+    try {
+      const pending = next.pending ? { ...next.pending, status: withoutProgress(next.pending.status) } : null
+      storage.setItem(key, JSON.stringify({ schemaVersion: 1, hostId, botId, draft: next.draft, pending, acknowledgedRequestKey: next.acknowledgedRequestKey }))
+      publish({ ...patch, storageError: '' }); return true
+    } catch { publish({ storageError: '无法保存本机草稿与请求编号，请恢复浏览器存储后再发送。' }); return false }
+  }
+  try {
+    const saved = JSON.parse(storage.getItem(key) ?? 'null')
+    if (saved?.schemaVersion === 1 && saved.hostId === hostId && saved.botId === botId) {
+      const pending = saved.pending && KEY.test(saved.pending.requestKey ?? '') && typeof saved.pending.input === 'string' && saved.pending.input.length <= 64000
+        ? { ...saved.pending, status: withoutProgress(saved.pending.status) } : null
+      state = { ...state, draft: typeof saved.draft === 'string' ? saved.draft.slice(0, 64000) : '', pending, acknowledgedRequestKey: KEY.test(saved.acknowledgedRequestKey ?? '') ? saved.acknowledgedRequestKey : null }
+    }
+  } catch { state.storageError = '无法读取本机草稿与请求编号；请修复浏览器存储后再发送。' }
+  const call = async (action, payload) => {
+    const controller = new AbortController(); calls.add(controller)
+    let alarm, abort
+    const stopped = new Promise((_, reject) => {
+      abort = () => reject(failure('CHAT_TRANSPORT_UNKNOWN', '连接中断，发送结果尚未确认；只核对原请求，不会自动重发。'))
+      controller.signal.addEventListener('abort', abort, { once: true })
+      alarm = setTimeout(() => controller.abort(), timeoutMs)
+    })
+    try { return await Promise.race([Promise.resolve().then(() => api.dispatch(action, payload, controller.signal)), stopped]) }
+    finally { clearTimeout(alarm); calls.delete(controller); controller.signal.removeEventListener('abort', abort) }
+  }
+  const assertHost = async () => {
+    const namespace = await call('ui.namespace', {})
+    if (!live) throw failure('CHAT_SCOPE_RETIRED')
+    if (namespace?.schemaVersion !== 1 || !HOST.test(namespace.hostId ?? '')) throw failure('CHAT_SCOPE_INVALID', '宿主没有确认界面存储标识。')
+    if (namespace.hostId !== hostId) {
+      publish({ view: null, error: '宿主连接已切换，正在重新读取联系人与草稿。' })
+      live = false; revision++; clearTimeout(timer)
+      for (const controller of calls) controller.abort()
+      onHostChanged?.()
+      throw failure('CHAT_SCOPE_RETIRED')
+    }
+  }
+  const applyRequest = (value, requestKey) => {
+    const request = validateChatRequest(value, botId, requestKey)
+    const held = state.pending
+    if (held && held.requestKey !== request.requestKey) return
+    const operationKind = request.operationKind ?? held?.operationKind ?? 'send'
+    if (held?.operationKind && held.operationKind !== operationKind) throw failure('CHAT_IDENTITY_MISMATCH')
+    const pending = request.state === 'succeeded' ? null : { requestKey: request.requestKey,
+      operationKind, input: held?.input ?? request.recoveryInput ?? '', accepted: request.durableInput === true, status: request }
+    const clearDraft = operationKind === 'send' && request.durableInput === true && held && state.draft === held.input
+    persist({ pending, ...(clearDraft ? { draft: '' } : {}), lastRequest: request,
+      ...(request.state === 'succeeded' ? { acknowledgedRequestKey: request.requestKey } : {}) })
+    if (request.state === 'succeeded') nextNonce = nonce()
+  }
+  const loadMessages = async (cursor, older = false) => {
+    const page = validateChatPage(await call('independentChat.messages', { botId, limit: 40, ...(cursor ? { cursor } : {}) }), botId)
+    if (!live) return
+    const seen = new Set()
+    const combined = older ? [...page.items, ...state.items] : [...state.items.filter(row => !page.items.some(next => next.messageId === row.messageId)), ...page.items]
+    publish({ items: combined.filter(row => { if (seen.has(row.messageId)) return false; seen.add(row.messageId); return true }),
+      ...((older || !pageLoaded) ? { nextCursor: exhausted ? null : page.nextCursor } : {}) })
+    pageLoaded = true
+    if (older && page.nextCursor === null) exhausted = true
+  }
+  const refresh = async () => {
+    if (!live || polling || lock) return
+    polling = true
+    const mine = revision
+    try {
+      await assertHost()
+      if (!live || mine !== revision) return
+      const view = await call('independentChat.view', { botId })
+      if (!live || mine !== revision) return
+      if (view?.schemaVersion !== 1 || view.botId !== botId || !['independent', 'integration', null].includes(view.mode) || typeof view.available !== 'boolean') throw failure('CHAT_VIEW_INVALID', '宿主聊天状态无效。')
+      publish({ view, error: '' })
+      if (state.pending) {
+        const requestKey = state.pending.requestKey
+        try {
+          const value = await call('independentChat.inspect', { botId, requestKey })
+          if (!live || mine !== revision) return
+          applyRequest(value, requestKey)
+        } catch (error) {
+          if (live && mine === revision && error?.code === 'INDEPENDENT_CHAT_REQUEST_NOT_FOUND' && state.pending?.requestKey === requestKey) persist({ pending: { ...state.pending, notFound: true } })
+          throw error
+        }
+      } else if (view.pendingRequest || (view.latestRequest && view.latestRequest.requestKey !== state.acknowledgedRequestKey)) {
+        applyRequest(view.pendingRequest ?? view.latestRequest)
+      }
+      if (live && mine === revision) await loadMessages()
+      if (live && mine === revision) publish({ loading: false })
+    } catch (error) { if (live && mine === revision) publish({ loading: false, view: null, error: String(error?.message ?? error) }) }
+    finally {
+      polling = false
+      if (live) { clearTimeout(timer); timer = setTimeout(refresh, pollMs) }
+    }
+  }
+  return Object.freeze({
+    subscribe(listener) { listeners.add(listener); return () => listeners.delete(listener) },
+    getSnapshot: () => state,
+    start() { if (retired || live) return; live = true; void refresh() },
+    dispose() { live = false; retired = true; revision++; clearTimeout(timer); for (const controller of calls) controller.abort(); listeners.clear() },
+    setDraft(text) { if (!retired && typeof text === 'string') persist({ draft: text.slice(0, 64000) }) },
+    async send() {
+      if (!live || lock || state.pending || !state.view?.available || !state.draft.trim()) return
+      if (new TextEncoder().encode(state.draft).length > 64000) { publish({ error: '消息超过 64,000 字节，请缩短后发送。' }); return }
+      lock = true; revision++
+      let requestKey
+      try {
+        await assertHost()
+        if (!live) return
+        requestKey = nextNonce
+        if (!KEY.test(requestKey)) throw failure('CHAT_NONCE_INVALID')
+        const pending = { requestKey, input: state.draft, accepted: false, status: null }
+        // Must complete before the first network send. Double click and Enter
+        // share this synchronous lock and this one durable nonce.
+        if (!persist({ pending, sending: true, error: '' })) return
+        const value = await call('independentChat.send', { botId, requestKey, input: pending.input })
+        if (live) applyRequest(value, requestKey)
+      } catch (error) { if (live) publish({ error: String(error?.message ?? error) }) }
+      finally { lock = false; if (live) { publish({ sending: false }); clearTimeout(timer); timer = setTimeout(refresh, 0) } }
+    },
+    async cancel() {
+      if (!live || lock || !state.pending) return
+      lock = true; revision++
+      const requestKey = state.pending.requestKey
+      try { await assertHost(); if (!live) return; const value = await call('independentChat.cancel', { botId, requestKey }); if (live) applyRequest(value, requestKey) }
+      catch (error) { if (live) publish({ error: String(error?.message ?? error) }) }
+      finally { lock = false; if (live) { clearTimeout(timer); timer = setTimeout(refresh, 0) } }
+    },
+    async newConversation() {
+      if (!live || lock || state.pending || !state.view?.newConversationAvailable || state.storageError) return
+      lock = true; revision++
+      try {
+        await assertHost()
+        if (!live) return
+        const requestKey = nextNonce
+        if (!KEY.test(requestKey)) throw failure('CHAT_NONCE_INVALID')
+        if (!persist({ pending: { requestKey, input: '', operationKind: 'new-conversation', accepted: false, status: null }, sending: true, error: '' })) return
+        const value = await call('independentChat.newConversation', { botId, requestKey })
+        if (live) applyRequest(value, requestKey)
+      } catch (error) { if (live) publish({ error: String(error?.message ?? error) }) }
+      finally { lock = false; if (live) { publish({ sending: false }); clearTimeout(timer); timer = setTimeout(refresh, 0) } }
+    },
+    inspect() { clearTimeout(timer); void refresh() },
+    restore() {
+      const held = state.pending
+      if (!live || lock || !held || held.status?.pending !== false || held.status?.finished !== true) return
+      if (held.operationKind === 'new-conversation') return false
+      const recovered = held.status.recoveryInput ?? held.input
+      if (state.draft && state.draft !== recovered) {
+        publish({ error: '输入框已有未发送文字，请先复制或清空，再恢复原消息。' })
+        return false
+      }
+      // Restore is a human choice. It only fills the composer. The next send
+      // is a new explicit intent, after the old outcome is shown to the owner.
+      persist({ draft: recovered, pending: null, lastRequest: held.status, acknowledgedRequestKey: held.requestKey })
+      nextNonce = nonce()
+    },
+    releaseNotFound() {
+      // An unacknowledged transport request can be explicitly released only
+      // after the authoritative journal answers not-found, never on a timeout.
+      if (state.pending?.notFound === true) {
+        if (state.pending.operationKind === 'new-conversation') return false
+        if (state.draft && state.draft !== state.pending.input) {
+          publish({ error: '输入框已有未发送文字，请先复制或清空，再恢复原消息。' })
+          return false
+        }
+        persist({ draft: state.pending.input, pending: null, acknowledgedRequestKey: state.pending.requestKey }); nextNonce = nonce()
+      }
+    },
+    async older() {
+      if (!live || pageLock || !state.nextCursor) return
+      pageLock = true; publish({ loadingOlder: true })
+      try { await loadMessages(state.nextCursor, true) } catch (error) { if (live) publish({ error: String(error?.message ?? error) }) }
+      finally { pageLock = false; if (live) publish({ loadingOlder: false }) }
+    },
+    reloadMessages() { pageLoaded = false; exhausted = false; publish({ items: [], nextCursor: null }); clearTimeout(timer); void refresh() },
+  })
+}

package/apps/integration-client/independent-chat-entry.jsx

@@ -0,0 +1,61 @@
+import React, { useEffect, useMemo, useRef, useState } from 'react'
+import { UiIcon } from './ui-icons.jsx'
+import { openIndependentChat } from './independent-chat-navigation.mjs'
+
+let nextScope = 0
+export function readWithDeadline(work, controller, ms = 8000) {
+  let timer, abort
+  const expired = new Promise((_, reject) => {
+    abort = () => reject(new Error('当前宿主没有及时回答，请重试连接。'))
+    controller.signal.addEventListener('abort', abort, { once: true })
+    timer = setTimeout(() => controller.abort(), ms)
+  })
+  return Promise.race([Promise.resolve().then(work), expired]).finally(() => { clearTimeout(timer); controller.signal.removeEventListener('abort', abort) })
+}
+
+/** Native navigation remains usable without loading the independent transcript renderer. */
+export function IndependentChatEntry({ productApi, botId, onOpen, openPanel }) {
+  const scope = useMemo(() => ++nextScope, [productApi, botId])
+  return <ChatEntry key={scope} productApi={productApi} botId={botId} onOpen={onOpen} openPanel={openPanel}/>
+}
+function ChatEntry({ productApi, botId, onOpen, openPanel }) {
+  const [independent, setIndependent] = useState(false)
+  useEffect(() => {
+    if (!botId || !productApi?.dispatch) return
+    let live = true, timer, controller
+    const load = async () => {
+      controller = new AbortController()
+      try { const view = await readWithDeadline(() => productApi.dispatch('independentChat.view', { botId }, controller.signal), controller); if (live) setIndependent(view?.botId === botId && view.mode === 'independent') }
+      catch { if (live) setIndependent(false) }
+      finally { if (live) timer = setTimeout(load, 4000) }
+    }
+    void load()
+    return () => { live = false; controller?.abort(); clearTimeout(timer) }
+  }, [productApi, botId])
+  if (!independent) return null
+  return <button className="ic-native-entry" type="button" title="此 Bot 已使用独立运行时，请在独立聊天页继续发送" onClick={() => typeof onOpen === 'function' ? onOpen(botId) : openIndependentChat(productApi, openPanel, botId)}><UiIcon name="bot" size={16}/><span>打开独立聊天</span><UiIcon name="arrow" size={14}/></button>
+}
+
+export function BotConversationLink({ productApi, bot, openSession, onOpenIndependent, available }) {
+  const [error, setError] = useState(''), [busy, setBusy] = useState(false)
+  const current = useRef({ live: false, epoch: 0, controller: null, pending: false })
+  useEffect(() => { const held = current.current; held.live = true; held.epoch++; held.pending = false; setError(''); setBusy(false); return () => { held.live = false; held.epoch++; held.controller?.abort() } }, [productApi, bot.id])
+  const open = async () => {
+    const held = current.current, epoch = held.epoch
+    if (held.pending || !held.live) return
+    held.pending = true
+    const controller = new AbortController(); held.controller = controller
+    setBusy(true); setError('')
+    try {
+      if (!available) { openSession?.(bot.sessionId); return }
+      const view = await readWithDeadline(() => productApi.dispatch('independentChat.view', { botId: bot.id }, controller.signal), controller)
+      if (!held.live || held.epoch !== epoch) return
+      if (view?.botId !== bot.id) throw new Error('宿主返回的 Bot 身份不匹配。')
+      if (view.mode === 'independent') onOpenIndependent?.(bot.id)
+      else if (view.mode === 'integration') openSession?.(bot.sessionId)
+      else throw new Error('宿主未确认当前运行时，请检查连接后重试。')
+    } catch (cause) { if (held.live && held.epoch === epoch) setError(String(cause?.message ?? cause)) }
+    finally { if (held.live && held.epoch === epoch) { held.pending = false; setBusy(false) } }
+  }
+  return <div><button className="bp-button-primary" type="button" disabled={busy} onClick={() => { void open() }}>{busy ? '正在打开…' : '打开私聊'}<UiIcon name="arrow" size={15}/></button>{error && <p className="bp-error" role="alert">{error}</p>}</div>
+}

package/apps/integration-client/independent-chat-navigation.mjs

@@ -0,0 +1,21 @@
+export const INDEPENDENT_CHAT_PANEL = 'bot-product-independentChat'
+const scopes = new WeakMap()
+export function independentChatNavigation(api) {
+  if (scopes.has(api)) return scopes.get(api)
+  let snapshot = null, version = 0
+  const listeners = new Set()
+  const navigation = Object.freeze({
+    subscribe(listener) { listeners.add(listener); return () => listeners.delete(listener) },
+    getSnapshot: () => snapshot,
+    select(botId) {
+      if (typeof botId !== 'string' || !/^[-A-Za-z0-9_.]{1,128}$/.test(botId)) throw new TypeError('CHAT_BOT_REQUIRED')
+      snapshot = Object.freeze({ botId, version: ++version })
+      for (const listener of listeners) listener()
+    },
+  })
+  scopes.set(api, navigation); return navigation
+}
+export function openIndependentChat(api, openPanel, botId) {
+  independentChatNavigation(api).select(botId)
+  return openPanel?.(INDEPENDENT_CHAT_PANEL)
+}

package/apps/integration-client/independent-chat-page.jsx

@@ -0,0 +1,148 @@
+import React, { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react'
+import { ComposerDraftHost } from './composer-draft-host.jsx'
+import { createIndependentChatController } from './independent-chat-controller.mjs'
+import { independentChatNavigation } from './independent-chat-navigation.mjs'
+import { readWithDeadline } from './independent-chat-entry.jsx'
+export { IndependentChatEntry, BotConversationLink } from './independent-chat-entry.jsx'
+import { BotSettingsDialog } from './bot-settings-dialog.jsx'
+import { UiIcon } from './ui-icons.jsx'
+import { botModelStatus } from './bot-model-status.mjs'
+import { requestWorkbenchView } from '../../.dsh-plugin/client/workbench-state.mjs'
+import { IndependentRichMessage } from './independent-chat-rich.jsx'
+import { independentToolRelations } from './independent-chat-rich.mjs'
+import { NativeActivityCardView, useNativeActivity } from './native-activity.jsx'
+
+let nextScope = 0
+export function IndependentChatPage(props) {
+  const scope = useMemo(() => ++nextScope, [props.productApi])
+  return <ChatDirectory key={scope} {...props}/>
+}
+
+function ChatDirectory({ productApi, openPanel, openSession }) {
+  const navigation = useMemo(() => independentChatNavigation(productApi), [productApi])
+  const route = useSyncExternalStore(navigation.subscribe, navigation.getSnapshot, navigation.getSnapshot)
+  const [directory, setDirectory] = useState(null), [error, setError] = useState(''), [attempt, setAttempt] = useState(0)
+  const reconnect = useCallback(() => { setDirectory(null); setAttempt(value => value + 1) }, [])
+  useEffect(() => {
+    let live = true, timer, controller
+    const load = async () => {
+      controller = new AbortController()
+      try {
+        const snapshot = await readWithDeadline(() => productApi.snapshot(controller.signal), controller)
+        if (!live) return
+        if (snapshot?.schemaVersion !== 1 || !Array.isArray(snapshot.bots)) throw new Error('宿主未返回 Bot 联系人。')
+        setDirectory(snapshot); setError('')
+      } catch (cause) { if (live) setError(String(cause?.message ?? cause)) }
+      finally { if (live) timer = setTimeout(load, 4000) }
+    }
+    void load()
+    return () => { live = false; controller?.abort(); clearTimeout(timer) }
+  }, [productApi, attempt])
+  const bots = directory?.bots ?? [], selected = route?.botId ?? directory?.mainBotId ?? bots[0]?.id
+  const bot = bots.find(row => row.id === selected)
+  return <section className="ic-shell" aria-label="独立 Bot 聊天">
+    <aside className="ic-contacts"><div className="ic-contact-title"><UiIcon name="team" size={19}/><strong>Bot 伙伴</strong></div>
+      <nav aria-label="独立聊天联系人">{bots.map(row => <button key={row.id} type="button" aria-current={row.id === selected ? 'page' : undefined} onClick={() => navigation.select(row.id)}><span className="ic-avatar"><UiIcon name="bot" size={21}/></span><span><strong>{row.name || row.id}</strong><small>{row.role || '和你的 Bot 一起工作'}</small></span></button>)}</nav>
+      <button className="ic-team-link" type="button" onClick={() => openPanel?.('bot-product-bindings')}>管理团队<UiIcon name="chevron" size={14}/></button>
+    </aside>
+    <div className="ic-conversation">{error ? <div className="ic-alert" role="alert">无法读取当前宿主联系人：{error}<button type="button" onClick={() => { setDirectory(null); setAttempt(value => value + 1) }}>重试连接</button></div>
+      : !directory ? <p className="ic-placeholder" role="status">正在连接 Bot 伙伴…</p>
+      : !bot ? <p className="ic-placeholder" role="status">当前宿主中没有这个 Bot。请从联系人重新选择。</p>
+      : <ComposerDraftHost productApi={productApi} attempt={attempt}>{({ hostId, status, error: namespaceError }) => status === 'ready'
+        ? <ChatConversation key={`${hostId}:${bot.id}`} productApi={productApi} hostId={hostId} bot={bot} readOnly={directory.readOnly} nativeActivityAvailable={directory.availableActions?.includes('nativeActivity.list') === true} openSession={openSession} openPanel={openPanel} onHostChanged={reconnect}/>
+        : <div className="ic-placeholder" role="status">{status === 'error' ? <>{namespaceError}<button type="button" onClick={() => setAttempt(value => value + 1)}>重试连接</button></> : '正在确认当前宿主…'}</div>}</ComposerDraftHost>}
+    </div>
+  </section>
+}
+
+const requestText = request => {
+  if (request?.operationKind === 'new-conversation') {
+    if (request.state === 'succeeded') return '新对话已开启，旧记录已保留。'
+    if (['accepted', 'running'].includes(request.state)) return '正在开启新对话，核对旧会话的停止状态…'
+    return '新对话结果尚未确认，请核对原操作；旧聊天记录保留。'
+  }
+  if (!request) return '发送结果尚未确认。请核对原请求；不会自动重发。'
+  if (request.state === 'succeeded') return request.cancelRequested ? '回复已提交；之前已请求停止。' : '回复已提交。'
+  if (request.cancelRequested) return request.finished ? '本地回合已结算，已请求停止；工具停止尚未确认。' : '已请求停止，正在核对回合结果；工具停止尚未确认。'
+  if (request.state === 'accepted') return '消息已保存，等待 Bot 回复…'
+  if (request.state === 'running') return 'Bot 正在处理…'
+  if (request.state === 'unknown') return request.pending ? '原宿主的回合可能仍在运行，请核对原请求。' : '回合结果未知，请检查已有消息与工具记录后再决定是否恢复文字。'
+  if (request.state === 'refused') return '宿主拒绝了这次发送，可以恢复文字后修改。'
+  return '本地回合已结算，可以恢复文字；工具停止尚未确认。'
+}
+
+function ChatConversation({ productApi, hostId, bot, readOnly, nativeActivityAvailable, openSession, openPanel, onHostChanged }) {
+  const controller = useMemo(() => createIndependentChatController({ api: productApi, hostId, botId: bot.id, onHostChanged }), [productApi, hostId, bot.id, onHostChanged])
+  const state = useSyncExternalStore(controller.subscribe, controller.getSnapshot, controller.getSnapshot)
+  const [settings, setSettings] = useState(false), [following, setFollowing] = useState(true)
+  const scroll = useRef(null), input = useRef(null), composition = useRef(false), olderPosition = useRef(null)
+  useEffect(() => { controller.start(); return () => controller.dispose() }, [controller])
+  const pending = state.pending, request = pending?.status ?? state.lastRequest
+  const progress = !state.loading && !state.error && state.view?.available && pending?.status?.state === 'running' && !pending.status.cancelRequested ? pending.status.progress : null
+  const contextOperation = pending?.operationKind === 'new-conversation' || request?.operationKind === 'new-conversation'
+  const knownPending = pending && ['accepted', 'running'].includes(pending.status?.state) && !pending.status.cancelRequested
+  const composingNext = knownPending && !contextOperation
+  const showRequest = Boolean(pending || (request && (request.state !== 'succeeded' || request.cancelRequested)))
+  const model = botModelStatus(bot)
+  const toolRelations = useMemo(() => independentToolRelations(state.items), [state.items])
+  const canSend = state.view?.available === true && !state.loading && !readOnly && !pending && !state.sending && !state.storageError
+  const context = state.view?.context
+  // Native tool activity for the context that is actually open. A context change
+  // retires the previous read, so another conversation's records never appear here.
+  const nativeActivity = useNativeActivity({ productApi, botId: bot.id, mode: 'independent', contextId: context?.contextId, enabled: nativeActivityAvailable })
+  const contextBoundary = () => <div className="ic-context-boundary" role="separator" aria-label="新对话，旧聊天记录保留"><span>新对话 · 旧记录保留</span></div>
+  useLayoutEffect(() => {
+    const node = scroll.current
+    if (!node) return
+    if (olderPosition.current !== null && !state.loadingOlder) { node.scrollTop += node.scrollHeight - olderPosition.current; olderPosition.current = null }
+    else if (following) node.scrollTop = node.scrollHeight
+  }, [state.items, state.loadingOlder, progress?.sequence, following, nativeActivity.activity?.revision ?? 0])
+  useLayoutEffect(() => {
+    const node = scroll.current
+    if (!node || typeof ResizeObserver === 'undefined') return
+    const observer = new ResizeObserver(() => {
+      if (following && olderPosition.current === null) node.scrollTop = node.scrollHeight
+    })
+    observer.observe(node)
+    if (node.firstElementChild) observer.observe(node.firstElementChild)
+    return () => observer.disconnect()
+  }, [following])
+  const submit = () => { if (canSend && !composition.current) void controller.send() }
+  return <>
+    <header className="ic-header"><span className="ic-avatar"><UiIcon name="bot" size={22}/></span><div className="ic-heading"><strong>{bot.name || bot.id}</strong><button type="button" className="ic-model" title={`独立聊天 · ${model.title}`} aria-label={`宿主已保存模型：${model.selected ?? '未选择'}，打开模型与工具设置`} data-model-different={model.different ? '' : undefined} onClick={() => setSettings(true)}><UiIcon name="spark" size={12}/><span>宿主已选：{model.selectedLabel ?? '未选择模型'}</span><UiIcon name="chevron" size={10}/></button></div><div className="ic-header-actions">
+      {typeof state.view?.newConversationAvailable === 'boolean' && <button type="button" title="开启新对话，保留旧聊天记录" aria-label="开启新对话" disabled={!canSend || !state.view.newConversationAvailable} onClick={() => void controller.newConversation()}><UiIcon name="plus" size={18}/></button>}
+      {bot.sessionId && <button type="button" title="打开此 Bot 的原生会话" aria-label="打开此 Bot 的原生会话" onClick={() => openSession?.(bot.sessionId)}><UiIcon name="list" size={18}/></button>}
+      <button type="button" title="Bot 设置" aria-label="Bot 设置" onClick={() => setSettings(true)}><UiIcon name="settings" size={18}/></button>
+    </div></header>
+    {readOnly && <div className="ic-alert" role="alert">当前宿主为只读：{String(readOnly)}</div>}
+    {state.view && !state.view.available && <div className="ic-alert" role="status">{state.view.mode === 'integration' ? '这个 Bot 使用原生会话。独立聊天记录保留为只读。' : '当前宿主未完整启用独立聊天，请检查运行时配置。'}{state.view.mode === 'integration' && bot.sessionId && <button type="button" onClick={() => openSession?.(bot.sessionId)}>回到原生会话</button>}</div>}
+    <div ref={scroll} className="ic-transcript" role="log" aria-label={`${bot.name || bot.id} 的独立聊天记录`} aria-live="polite" onScroll={() => { const node = scroll.current; setFollowing(node.scrollHeight - node.scrollTop - node.clientHeight < 90) }}>
+      <div className="ic-message-column">{state.nextCursor && <button type="button" className="ic-load-older" disabled={state.loadingOlder} onClick={() => { olderPosition.current = scroll.current.scrollHeight; void controller.older() }}>{state.loadingOlder ? '正在读取…' : '加载较早消息'}</button>}
+        {state.items.length === 0 && <div className="ic-empty"><span className="ic-avatar ic-avatar-large"><UiIcon name="bot" size={33}/></span><strong>{bot.name || bot.id}</strong><p>{state.loading ? '正在读取聊天记录…' : '告诉我你想做什么，我们一起开始。'}</p></div>}
+        {state.items.map((message, index) => <React.Fragment key={message.messageId}>{index > 0 && message.contextId && message.contextId !== state.items[index - 1].contextId && contextBoundary()}<IndependentRichMessage message={message} botName={bot.name} calls={toolRelations.get(message.messageId)}/></React.Fragment>)}
+        {context?.sequence > 0 && !context.resetPending && state.items.at(-1)?.contextId !== context.contextId && contextBoundary()}
+        <NativeActivityCardView activity={nativeActivity.activity} controller={nativeActivity.controller} announce={false}/>
+        {progress?.text && <article className="ic-streaming" aria-label="正在生成的回复" aria-busy="true"><div className="ic-streaming-caption"><span className="ic-streaming-dot"/>正在生成 · 第 {progress.step} 步 · 尚未完成</div><div className="ic-streaming-text">{progress.text}</div>{progress.truncated && <small>预览已达到显示上限，完整回复会在完成后显示。</small>}</article>}
+      </div>
+    </div>
+    {!following && <button type="button" className="ic-scroll-latest" onClick={() => { setFollowing(true); scroll.current?.scrollTo({ top: scroll.current.scrollHeight, behavior: 'smooth' }) }}>回到最新<UiIcon name="chevron" size={13}/></button>}
+    <div className="ic-composer-area">
+      {(state.error || state.storageError) && <div className="ic-alert" role="alert"><span>{state.storageError || state.error}</span><button type="button" onClick={() => controller.inspect()}>核对原请求</button><button type="button" onClick={() => controller.reloadMessages()}>刷新聊天记录</button></div>}
+      {showRequest && <div className={`ic-request${knownPending ? ' ic-request-working' : ''}`} role="status"><span>{requestText(pending ? { ...pending.status, operationKind: pending.operationKind } : request)}</span>{!knownPending && <small>请求编号：{pending?.requestKey ?? request.requestKey}</small>}
+        {pending?.status?.errorCode && <small>{pending.status.errorCode}</small>}
+        <div className="ic-request-actions">{pending && !knownPending && <button type="button" onClick={() => controller.inspect()}>核对原请求</button>}
+          {!contextOperation && pending?.status?.finished === true && pending.status.pending === false && <button type="button" onClick={() => { controller.restore(); input.current?.focus() }}>恢复文字到输入框</button>}
+          {!contextOperation && pending?.notFound && <button type="button" onClick={() => controller.releaseNotFound()}>宿主无此请求，恢复文字</button>}
+          {!contextOperation && pending?.status?.pending === true && !pending.status.cancelRequested && <button type="button" className="ic-stop" disabled={state.sending} onClick={() => { void controller.cancel() }}><UiIcon name="stop" size={13}/>请求停止</button>}
+        </div></div>}
+      <form className="ic-composer" onSubmit={event => { event.preventDefault(); submit() }}>
+        <label className="ic-sr-only" htmlFor={`independent-message-${bot.id}`}>发消息给 {bot.name || bot.id}</label>
+        <textarea ref={input} id={`independent-message-${bot.id}`} value={state.draft} placeholder={composingNext ? 'Bot 正在回复，可先写下一条…' : pending ? '原请求尚未核对，已暂停新的发送' : '发消息…'} rows={2} disabled={!state.view?.available || Boolean(readOnly)} onChange={event => controller.setDraft(event.target.value)} onCompositionStart={() => { composition.current = true }} onCompositionEnd={() => { composition.current = false }} onKeyDown={event => { if (event.key === 'Enter' && !event.shiftKey && !event.nativeEvent.isComposing && event.nativeEvent.keyCode !== 229 && !composition.current) { event.preventDefault(); submit() } }}/>
+        <div className="ic-composer-footer"><span>文字消息 · Shift + Enter 换行</span><button type="submit" aria-label="发送消息" disabled={!canSend || !state.draft.trim()}><UiIcon name="arrow" size={18}/><span>发送</span></button></div>
+      </form>
+      <p className="ic-capability-note">此入口发送文字；附件、语音与记忆视图请打开原生会话。<button type="button" onClick={() => openPanel?.('bot-product-machines')}>电脑</button></p>
+    </div>
+    {settings && <BotSettingsDialog productApi={productApi} botId={bot.id} onClose={() => setSettings(false)} onOpenTools={typeof openPanel === 'function' ? async () => { requestWorkbenchView('tools'); await openPanel('model-router-galgame'); setSettings(false) } : undefined}/>} 
+  </>
+}
+

package/apps/integration-client/independent-chat-rich.jsx

@@ -0,0 +1,64 @@
+import React, { memo, useEffect, useRef, useState } from 'react'
+import { createPortal } from 'react-dom'
+import { MarkdownText, MarkdownDelegateProvider, writeClipboard } from '@deepseek-ai/dsh-client-ui-primitives'
+import { copyRichText, INDEPENDENT_MARKDOWN_LABELS, richToolArguments } from './independent-chat-rich.mjs'
+
+/**
+ * The public Host renderer owns parsing, GFM, math, safe URLs and highlighting.
+ * An empty nested delegate deliberately replaces enclosing file capabilities:
+ * an authored path never gains an opener or image resolver from another panel.
+ */
+export const IndependentRichMessage = memo(function IndependentRichMessage({ message, botName, calls = [] }) {
+  const text = typeof message.content === 'string' ? message.content : ''
+  const [feedback, setFeedback] = useState(null), [codeFeedback, setCodeFeedback] = useState(null)
+  const body = useRef(null), scope = useRef({ live: false, revision: 0, copying: false })
+  useEffect(() => {
+    const current = scope.current; current.live = true; current.revision++; current.copying = false
+    setFeedback(null); setCodeFeedback(null)
+    return () => { current.live = false; current.revision++; current.copying = false }
+  }, [message.messageId, text])
+  const copy = async (source, codeTarget = null) => {
+    const current = scope.current, revision = current.revision
+    if (!current.live || current.copying) return
+    current.copying = true
+    const focused = document.activeElement
+    const ok = await copyRichText(source, writeClipboard)
+    if (!current.live || current.revision !== revision) return
+    current.copying = false
+    const value = { ok, text: ok ? codeTarget ? '代码已复制' : '消息原文已复制' : '复制失败，请展开消息原文后手动复制。' }
+    if (codeTarget?.isConnected) setCodeFeedback({ ...value, target: codeTarget })
+    else setFeedback(value)
+    // The public helper's execCommand fallback temporarily focuses a textarea.
+    // Return to this message's own control rather than disturbing the composer.
+    if (focused?.isConnected && typeof focused.focus === 'function') focused.focus({ preventScroll: true })
+  }
+  const copyCode = event => {
+    if (!(event.target instanceof Element)) return
+    const button = event.target.closest('button'), block = button?.closest('.md-code-block')
+    if (!block || !body.current?.contains(block)) return
+    // These are public SDK 0.2.1-rc.4's observable code-card hooks. If a future
+    // Host changes them, do not guess from translated button text: the always
+    // present exact-message copy/raw controls still work independently.
+    const banner = button.closest('[data-code-block-banner]'), source = block.querySelector('[data-code-block-content] pre')
+    if (!banner || !source) return
+    event.preventDefault(); event.stopPropagation()
+    void copy(source.textContent ?? '', banner)
+  }
+  const roleLabel = message.role === 'user' ? '你' : message.role === 'assistant' ? botName || 'Bot' : message.role === 'tool' ? message.name || '工具结果' : '上下文记录'
+  return <article className={`ic-message ic-message-${message.role}`} data-message-id={message.messageId}>
+    <div className="ic-message-meta"><strong>{roleLabel}</strong>{message.at != null && <time>{new Date(message.at).toLocaleTimeString('zh-CN', { hour: '2-digit', minute: '2-digit' })}</time>}</div>
+    {message.role === 'tool' ? <details className="ic-rich-tool-result"><summary>工具结果{message.toolCallId ? ` · ${message.toolCallId}` : ' · 未记录调用编号'}</summary><pre>{text}</pre>{message.isError === true && <p className="ic-rich-tool-error">记录为错误结果</p>}</details>
+      : message.role === 'system' ? <details className="ic-rich-context"><summary>查看上下文记录</summary><pre>{text}</pre></details>
+      : text ? <div ref={body} className="ic-bubble ic-rich-body" onClickCapture={copyCode}>
+        <MarkdownDelegateProvider><MarkdownText text={text} labels={INDEPENDENT_MARKDOWN_LABELS} variant="body"/></MarkdownDelegateProvider>
+        {codeFeedback?.target.isConnected && createPortal(<span className="ic-rich-code-feedback" role="status" data-copy-ok={codeFeedback.ok}>{codeFeedback.text}</span>, codeFeedback.target)}
+      </div> : null}
+    {calls.length > 0 && <details className="ic-rich-tool-calls"><summary>工具调用 · {calls.length} 项</summary><p className="ic-rich-tool-note">这里显示已记录的调用与返回；结果记录不代表任务完成或已停止。</p>
+      {calls.map((call, index) => <section key={`${call.id ?? 'unrecorded'}:${index}`} data-tool-call-id={call.id}>
+        <h4>{call.name || '未记录名称'}</h4><dl><dt>调用编号</dt><dd>{call.id || '未记录'}</dd><dt>参数</dt><dd><pre>{richToolArguments(call)}</pre></dd><dt>返回记录</dt><dd>{call.results?.length ? call.results.map(result => <div key={result.messageId} data-tool-result-id={result.messageId}><small>{result.isError === true ? '记录为错误结果' : '已记录返回'} · {result.messageId}</small><pre>{result.content}</pre></div>) : <span>本页尚未记录对应返回；不能据此判断执行结果。</span>}</dd></dl>
+      </section>)}
+    </details>}
+    {message.modelSource && <small className="ic-message-source">{typeof message.modelSource === 'string' ? message.modelSource : `${message.modelSource.provider ?? ''}/${message.modelSource.model ?? ''}`}</small>}
+    <div className="ic-rich-message-actions"><button type="button" aria-label="复制消息原文" onClick={() => { void copy(text) }}>复制原文</button><details className="ic-rich-raw"><summary>消息原文</summary><textarea readOnly aria-label="消息原文（可选择复制）" value={text} spellCheck={false}/></details>{feedback && <span role="status" data-copy-ok={feedback.ok}>{feedback.text}</span>}</div>
+  </article>
+})

package/apps/integration-client/independent-chat-rich.mjs

@@ -0,0 +1,30 @@
+/** Match only the nearest preceding recorded call, including reused ids in later batches. */
+export function independentToolRelations(messages = []) {
+  const owners = new Map(), result = new Map()
+  for (const message of messages) {
+    if (message.role === 'assistant') {
+      const calls = (Array.isArray(message.toolCalls) ? message.toolCalls : message.toolCall ? [message.toolCall] : []).map(call => ({ ...call, results: [] }))
+      result.set(message.messageId, calls)
+      for (const call of calls) if (typeof call.id === 'string' && call.id) owners.set(call.id, call)
+    }
+    const callId = message.toolCallId ?? message.toolCall?.id
+    if (message.role === 'tool' && typeof callId === 'string') owners.get(callId)?.results.push(message)
+  }
+  return result
+}
+
+export function richToolArguments(call) {
+  const value = call && Object.hasOwn(call, 'args') ? call.args : call?.arguments
+  if (value === undefined) return '未记录参数'
+  if (typeof value === 'string') return value
+  try { return JSON.stringify(value, null, 2) ?? '未记录参数' } catch { return '参数无法显示' }
+}
+
+/** Success is established only by the actual clipboard operation's return value. */
+export async function copyRichText(text, writer) {
+  try { return await writer(text) === true } catch { return false }
+}
+
+export const INDEPENDENT_MARKDOWN_LABELS = Object.freeze({
+  code: Object.freeze({ copyLabel: '复制代码', copiedLabel: '代码已复制' }), footnotes: '注释',
+})