dsh-qqchat 0.2.0

package/client-src/settings.cts

@@ -0,0 +1,216 @@
+import { h, useCallback, useEffect, useState, call, Button, Input, Menu, Modal, dateTime } from './shared.cjs'
+import type { Account, GroupReceiveMode, KnownMember, PluginLog, ReplyFormat, Rpc, Settings } from './shared.cjs'
+
+interface QQSettingsCache {
+  account: Account | null
+  settings: Settings | null
+  members: KnownMember[]
+}
+
+let qqSettingsCache: QQSettingsCache | undefined
+
+export function QQSettings({ rpc }: { rpc: Rpc }) {
+  const [account, setAccount] = useState<Account | null>(() => qqSettingsCache?.account || null)
+  const [settings, setSettings] = useState<Settings | null>(() => qqSettingsCache?.settings || null)
+  const [members, setMembers] = useState<KnownMember[]>(() => qqSettingsCache?.members || [])
+  const [loading, setLoading] = useState(() => qqSettingsCache === undefined)
+  const [auth, setAuth] = useState<{ taskId: string; qrDataUrl: string } | null>(null)
+  const [logs, setLogs] = useState<PluginLog[] | null>(null)
+  const [busy, setBusy] = useState(false)
+  const [error, setError] = useState('')
+  const [groupReplyMenuOpen, setGroupReplyMenuOpen] = useState(false)
+  const [directReplyMenuOpen, setDirectReplyMenuOpen] = useState(false)
+  const [ownerMenuOpen, setOwnerMenuOpen] = useState(false)
+
+  const refresh = useCallback(async () => {
+    try {
+      const [status, prefs] = await Promise.all([
+        call<{ accounts: Account[] }>(rpc, 'status'),
+        call<{ settings: Settings; members: KnownMember[] }>(rpc, 'settings/get'),
+      ])
+      const next = {
+        account: status.accounts.find(item => item.enabled) || null,
+        settings: prefs.settings,
+        members: prefs.members || [],
+      }
+      qqSettingsCache = next
+      setAccount(next.account)
+      setSettings(next.settings)
+      setMembers(next.members)
+      setError('')
+    } catch (err) { setError(err instanceof Error ? err.message : String(err)) } finally { setLoading(false) }
+  }, [rpc])
+
+  useEffect(() => { void refresh() }, [refresh])
+  useEffect(() => {
+    if (!auth) return
+    let stopped = false
+    let timer: ReturnType<typeof setTimeout> | undefined
+    const poll = async () => {
+      if (stopped) return
+      try {
+        const state = await call<{ status: string; reason?: string }>(rpc, 'auth/poll', { taskId: auth.taskId })
+        if (state.status === 'success') { setAuth(null); await refresh(); return }
+        if (state.status === 'fail' || state.status === 'expired') { setError(state.reason || '二维码已失效'); setAuth(null); return }
+      } catch (err) {
+        if (!stopped) { setError(err instanceof Error ? err.message : String(err)); setAuth(null) }
+        return
+      }
+      if (!stopped) timer = setTimeout(() => void poll(), 3000)
+    }
+    timer = setTimeout(() => void poll(), 3000)
+    return () => { stopped = true; if (timer) clearTimeout(timer) }
+  }, [auth, rpc, refresh])
+
+  const patch = useCallback(async (value: Partial<Settings>) => {
+    if (!settings) return
+    const optimistic = { ...settings, ...value }
+    setSettings(optimistic)
+    try {
+      const result = await call<{ settings: Settings }>(rpc, 'settings/update', { patch: value })
+      setSettings(result.settings)
+      if (qqSettingsCache) qqSettingsCache = { ...qqSettingsCache, settings: result.settings }
+      setError('')
+    } catch (err) { setSettings(settings); setError(err instanceof Error ? err.message : String(err)) }
+  }, [rpc, settings])
+
+  const startAuth = async () => {
+    setBusy(true)
+    try { setAuth(await call<{ taskId: string; qrDataUrl: string }>(rpc, 'auth/start')); setError('') } catch (err) { setError(err instanceof Error ? err.message : String(err)) } finally { setBusy(false) }
+  }
+  const disconnect = async () => {
+    if (!account) return
+    setBusy(true)
+    try {
+      await call(rpc, 'account/disconnect', { accountId: account.id })
+      setAccount(null)
+      if (qqSettingsCache) qqSettingsCache = { ...qqSettingsCache, account: null }
+      setAuth(null)
+      setError('已取消连接，可以重新扫码绑定 Bot。')
+    } catch (err) { setError(err instanceof Error ? err.message : String(err)) } finally { setBusy(false) }
+  }
+  const openLogs = async () => {
+    try { setLogs((await call<{ logs: PluginLog[] }>(rpc, 'logs/list', { limit: 300 })).logs) } catch (err) { setError(err instanceof Error ? err.message : String(err)) }
+  }
+
+  const ownerPicker = h(Menu, {
+    open: ownerMenuOpen,
+    onClose: () => setOwnerMenuOpen(false),
+    selectedId: settings?.ownerUserId,
+    onSelect: (id: string) => { setOwnerMenuOpen(false); void patch({ ownerUserId: id }) },
+    anchor: h(Button, { size: 'sm', variant: 'outline', onClick: () => setOwnerMenuOpen(!ownerMenuOpen) }, '选择用户'),
+    align: 'end',
+    items: [{ id: '', label: '不设置 Owner' }, ...members.map(member => ({ id: member.platformUserId, label: member.displayName || 'QQ 群友' }))],
+  })
+  const formatLabel = (value: ReplyFormat | undefined) => value === 'markdown' ? 'Markdown' : value === 'compat' ? '纯文本兼容' : '智能兼容'
+  const formatItems = [{ id: 'smart', label: '智能兼容' }, { id: 'markdown', label: 'Markdown' }, { id: 'compat', label: '纯文本兼容' }]
+  const groupReplyPicker = h(Menu, {
+    open: groupReplyMenuOpen,
+    onClose: () => setGroupReplyMenuOpen(false),
+    selectedId: settings?.groupReplyFormat,
+    onSelect: (id: string) => { setGroupReplyMenuOpen(false); void patch({ groupReplyFormat: id as ReplyFormat }) },
+    anchor: h(Button, { size: 'sm', variant: 'outline', onClick: () => setGroupReplyMenuOpen(!groupReplyMenuOpen) }, formatLabel(settings?.groupReplyFormat)),
+    items: formatItems,
+    align: 'end',
+  })
+  const directReplyPicker = h(Menu, {
+    open: directReplyMenuOpen,
+    onClose: () => setDirectReplyMenuOpen(false),
+    selectedId: settings?.directReplyFormat,
+    onSelect: (id: string) => { setDirectReplyMenuOpen(false); void patch({ directReplyFormat: id as ReplyFormat }) },
+    anchor: h(Button, { size: 'sm', variant: 'outline', onClick: () => setDirectReplyMenuOpen(!directReplyMenuOpen) }, formatLabel(settings?.directReplyFormat)),
+    items: formatItems,
+    align: 'end',
+  })
+
+  const head = h('div', { className: 'qqsHead' },
+    h('div', null, h('div', { className: 'qqsTitle' }, 'QQ Chat'), h('div', { className: 'qqMuted' }, 'QQ Bot 接收、兼容与权限设置')),
+    h('div', { className: 'qqStatus' }, loading ? '加载中…' : account ? (account.gatewayStatus === 'online' ? '已连接' : '已授权') : '未连接', account && h(Button, { size: 'sm', variant: 'outline', disabled: busy, onClick: () => void disconnect() }, '取消连接')))
+
+  if (loading) return h('div', { className: 'qqs' }, head, h('div', { className: 'qqMuted' }, '正在读取 QQ Chat 设置…'))
+  if (!account) return h('div', { className: 'qqs' }, head, error && h('div', { className: 'qqError' }, error), h('div', { className: 'qqConnect' }, h('div', { className: 'qqsTitle' }, auth ? '使用 QQ 扫码授权' : '连接 QQ Bot'), h('div', { className: 'qqMuted' }, '扫码和凭据解密都在 DSH Host 侧完成。'), auth && h('div', { className: 'qqQr' }, h('img', { src: auth.qrDataUrl, alt: 'QQ 授权二维码' })), h(Button, { variant: 'primary', disabled: busy, onClick: () => void startAuth() }, auth ? '重新生成二维码' : '扫码连接')))
+  if (!settings) return h('div', { className: 'qqs' }, head, h('div', { className: 'qqMuted' }, '正在读取设置…'))
+
+  const receiveButtons = h('div', { className: 'qqChoiceButtons' },
+    ...(['auto', 'mention', 'silent'] as const).map(mode => h(Button, {
+      key: mode,
+      size: 'sm',
+      variant: settings.groupReceiveMode === mode ? 'primary' : 'outline',
+      onClick: () => void patch({ groupReceiveMode: mode }),
+    }, mode === 'auto' ? '自动回应' : mode === 'mention' ? '@回复' : '静默记录')))
+
+  const receiveGroup = h('div', { className: 'qqSettingsGroup' },
+    h('h3', null, '消息接收'),
+    h('div', { className: 'qqSetting' },
+      h('div', null, h('div', { className: 'qqSettingTitle' }, '群聊接收方式'), h('div', { className: 'qqSettingHelp' }, '自动回应：每条群消息都会触发 Agent；@回复：所有消息都记录，但只有 @Bot 才唤醒 Agent；静默记录：只记录群聊与记忆，不主动回应。')),
+      h('div', { className: 'qqControl' }, receiveButtons)),
+    h('div', { className: 'qqSetting' },
+      h('div', null, h('div', { className: 'qqSettingTitle' }, '群聊消息兼容格式'), h('div', { className: 'qqSettingHelp' }, '仅控制发送到 QQ 群聊时使用的消息格式。')),
+      h('div', { className: 'qqControl' }, groupReplyPicker)),
+    h('div', { className: 'qqSetting' },
+      h('div', null, h('div', { className: 'qqSettingTitle' }, '私聊消息兼容格式'), h('div', { className: 'qqSettingHelp' }, '仅控制发送到 QQ 私聊时使用的消息格式。')),
+      h('div', { className: 'qqControl' }, directReplyPicker)),
+    h('div', { className: 'qqSetting' },
+      h('label', { className: 'qqCheckRow' },
+        h('input', {
+          type: 'checkbox',
+          checked: settings.directStreamingEnabled && settings.directReplyFormat !== 'compat',
+          disabled: settings.directReplyFormat === 'compat',
+          onChange: (event: import('react').ChangeEvent<HTMLInputElement>) => void patch({ directStreamingEnabled: event.target.checked }),
+        }),
+        h('span', null,
+          h('div', { className: 'qqSettingTitle' }, '私聊流式回复'),
+          h('div', { className: 'qqSettingHelp' }, settings.directReplyFormat === 'compat'
+            ? '纯文本兼容模式不支持流式传输，已自动关闭。'
+            : settings.directStreamingEnabled
+            ? '使用 QQ 官方流式接口逐步更新私聊回复；部分 QQ 客户端可能看不到流式效果。'
+            : '使用普通一次性消息发送，兼容性更好。'))))
+  )
+  const memoryGroup = h('div', { className: 'qqSettingsGroup' },
+    h('h3', null, '记忆系统'),
+    h('div', { className: 'qqSetting' },
+      h('div', null,
+        h('div', { className: 'qqSettingTitle' }, '启用记忆系统'),
+        h('div', { className: 'qqSettingHelp' }, '记忆会注入每轮 Agent 上下文，并在空闲时整理近期消息；这可能降低上下文缓存命中率并增加输入 token。关闭后停止记忆注入和后台整理，但不会删除已有记忆。')),
+      h('div', { className: 'qqControl' }, h(Button, { size: 'sm', variant: settings.memoryEnabled ? 'primary' : 'outline', onClick: () => void patch({ memoryEnabled: !settings.memoryEnabled }) }, settings.memoryEnabled ? '已启用' : '已关闭'))))
+  const ownerSetting = !settings.groupMembersCanUseTools
+    ? h('div', { className: 'qqSetting' },
+      h('div', null,
+        h('div', { className: 'qqSettingTitle' }, 'Owner stable ID'),
+        h('div', { className: 'qqSettingHelp' }, '使用 stable sender ID，不根据昵称判断。')),
+      h('div', { className: 'qqControl' },
+        h(Input, {
+          value: settings.ownerUserId,
+          placeholder: '粘贴 stable ID',
+          onChange: (event: import('react').ChangeEvent<HTMLInputElement>) => setSettings({ ...settings, ownerUserId: event.target.value }),
+          onBlur: (event: import('react').FocusEvent<HTMLInputElement>) => void patch({ ownerUserId: event.currentTarget.value }),
+        }),
+        ownerPicker))
+    : null
+  const toolsGroup = h('div', { className: 'qqSettingsGroup' },
+    h('h3', null, '工具权限'),
+    h('div', { className: 'qqSetting' },
+      h('label', { className: 'qqCheckRow' },
+        h('input', { type: 'checkbox', checked: settings.groupMembersCanUseTools, onChange: (event: import('react').ChangeEvent<HTMLInputElement>) => void patch({ groupMembersCanUseTools: event.target.checked }) }),
+        h('span', null,
+          h('div', { className: 'qqSettingTitle' }, '群成员可用工具'),
+          h('div', { className: 'qqSettingHelp' }, settings.groupMembersCanUseTools ? '群友触发的 Agent 回合可以使用当前 preset 的全部工具。' : '关闭后只有 Owner 触发的群聊回合可以执行工具；其他群友仍可正常聊天，但工具调用会被拒绝。')))),
+    ownerSetting)
+  const mediaGroup = h('div', { className: 'qqSettingsGroup' },
+    h('h3', null, '媒体与文件权限'),
+    h('div', { className: 'qqSetting' },
+      h('label', { className: 'qqCheckRow' },
+        h('input', { type: 'checkbox', checked: settings.groupMembersCanReceiveMedia, onChange: (event: import('react').ChangeEvent<HTMLInputElement>) => void patch({ groupMembersCanReceiveMedia: event.target.checked }) }),
+        h('span', null,
+          h('div', { className: 'qqSettingTitle' }, '接收群成员媒体/文件'),
+          h('div', { className: 'qqSettingHelp' }, settings.groupMembersCanReceiveMedia ? '下载并在会话中显示群成员发送的图片、文件、音频和视频。' : '群成员发送的媒体不会下载、存储或注入会话；Owner 和私聊不受影响。')))),
+    h('div', { className: 'qqSetting' },
+      h('label', { className: 'qqCheckRow' },
+        h('input', { type: 'checkbox', checked: settings.groupMembersCanReadMedia, onChange: (event: import('react').ChangeEvent<HTMLInputElement>) => void patch({ groupMembersCanReadMedia: event.target.checked }) }),
+        h('span', null,
+          h('div', { className: 'qqSettingTitle' }, '允许群成员读取媒体/文件'),
+          h('div', { className: 'qqSettingHelp' }, settings.groupMembersCanReadMedia ? '群成员触发的回合可以调用 QQChat 媒体工具读取当前消息附件。' : '群成员仍可看到已接收的媒体，但不能调用媒体工具读取内容；Owner 和私聊不受影响。')))))
+  const diagnosticsGroup = h('div', { className: 'qqSettingsGroup' }, h('h3', null, '诊断'), h('div', { className: 'qqSetting' }, h('div', null, h('div', { className: 'qqSettingTitle' }, '插件日志'), h('div', { className: 'qqSettingHelp' }, account.gatewayLastError ? `最近网关错误：${account.gatewayLastError}` : '查看 QQ Gateway、授权、Agent bridge 与消息发送的最近日志。')), h(Button, { size: 'sm', variant: 'outline', onClick: () => void openLogs() }, '查看日志')))
+  return h('div', { className: 'qqs' }, head, error && h('div', { className: 'qqError' }, error), receiveGroup, memoryGroup, mediaGroup, toolsGroup, diagnosticsGroup,
+    logs && h(Modal, { title: 'QQ Chat 日志', onClose: () => setLogs(null) }, logs.length ? logs.map(log => h('div', { key: log.id, className: `qqLog ${log.level}` }, h('span', { className: 'qqLogMeta' }, `${dateTime(log.time)} [${log.level}]`), log.message)) : h('div', { className: 'qqMuted' }, '暂无日志。')))
+}

package/client-src/shared.cts

@@ -0,0 +1,104 @@
+export const React: typeof import('react') = require('react')
+const dshPrimitives = require('@deepseek-ai/dsh-client-ui-primitives') as {
+  Button: import('react').ComponentType<any>
+  Input: import('react').ComponentType<any>
+  Menu: import('react').ComponentType<any>
+  Modal: import('react').ComponentType<any>
+}
+const { Button: DshButton, Input: DshInput, Menu: DshMenu, Modal: DshModal } = dshPrimitives
+export const Button = DshButton as unknown as import('react').ComponentType<any>
+export const Input = DshInput as unknown as import('react').ComponentType<any>
+export const Menu = DshMenu as unknown as import('react').ComponentType<any>
+export const { useCallback, useEffect, useMemo, useState, useSyncExternalStore } = React
+export const h = React.createElement
+
+let qqRpc: Rpc | undefined
+export function setQQRpc(rpc: Rpc): void { qqRpc = rpc }
+export function getQQRpc(): Rpc | undefined { return qqRpc }
+
+export type ChatType = 'c2c' | 'group'
+export type GroupReceiveMode = 'auto' | 'mention' | 'silent'
+export type ReplyFormat = 'smart' | 'markdown' | 'compat'
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error'
+export type RpcResult<T> = { ok: true; value: T } | { ok: false; error?: { message?: string } }
+export interface Rpc { call(channel: string, endpoint: string, payload: unknown): Promise<RpcResult<unknown>> }
+export interface SessionListSnapshot { byId: Record<string, unknown>; current?: string }
+export interface Observable<T> { getSnapshot(): T; subscribe(listener: () => void): () => void }
+export interface SessionsService { list: Observable<SessionListSnapshot>; open(id: string): void }
+export interface SlotRegistry {
+  inject(name: string, fn: () => unknown): unknown
+  register<P>(options: Record<string, unknown>, component: import('react').ComponentType<P>): unknown
+}
+export interface ConversationEvents { register(definition: Record<string, unknown>): unknown }
+export interface Ctx {
+  connection: { rpc: Rpc }
+  sessions: SessionsService
+  conversationEvents: ConversationEvents
+  effect(fn: () => (() => void) | void, label: string): unknown
+  slots: SlotRegistry
+}
+export interface Account { id: number; appId: string; enabled: boolean; gatewayStatus: string; gatewayLastError?: string | null }
+export interface Settings { memoryEnabled: boolean; groupReceiveMode: GroupReceiveMode; groupReplyFormat: ReplyFormat; directReplyFormat: ReplyFormat; directStreamingEnabled: boolean; groupMembersCanUseTools: boolean; groupMembersCanReceiveMedia: boolean; groupMembersCanReadMedia: boolean; ownerUserId: string }
+export interface KnownMember { id: number; platformUserId: string; displayName: string; lastSeenAt: number }
+export interface ChatItem { chatType: ChatType; rowId: number; platformId: string; displayName: string; dshSessionId: string | null; lastMessageAt: number | null; messageCount: number }
+export interface Memory { profile: string; summary: string; daily: string; memory: string; pattern: string }
+export interface ChatMember { id: number; platformUserId: string; displayName: string; aliases: string[]; nicknames: string[]; messageCount: number; memory: Memory }
+export interface ChatInfo { chatType: ChatType; rowId: number; title: string; platformId: string; memory: Memory; members: ChatMember[] }
+export interface PluginLog { id: number; time: number; level: LogLevel; message: string }
+export interface QQAttachmentData { id: string; kind: string; filename: string; contentType?: string; sizeBytes: number; quoted?: boolean; imageRef?: Record<string, unknown> }
+export interface QQQuoteData { messageId?: string; senderId?: string; senderName?: string; text: string; attachments?: QQAttachmentData[] }
+export interface QQEventData { messageId: string; chatType: ChatType; chatId: string; direction: 'inbound' | 'outbound'; senderId: string; senderName: string; isOwner?: boolean; content: string; quotedText: string; mentioned: boolean; createdAt: number; sessionId?: string; attachments?: QQAttachmentData[]; quote?: QQQuoteData | null }
+export interface QQNode { data: QQEventData }
+export interface SessionUtilityProps { sessionId: string }
+export interface SidebarActionProps { wide: boolean; rpc: Rpc; sessions: SessionsService }
+
+export const CHANNEL = '/qqchat'
+const STYLE_ID = 'dsh-qqchat/client-ui-v2'
+
+const css = `
+.qqs{display:flex;flex-direction:column;gap:18px;color:var(--dsw-alias-label-primary);font:inherit}.qqs *{box-sizing:border-box}
+.qqsHead{display:flex;align-items:center;justify-content:space-between;gap:12px}.qqsBrand{display:flex;align-items:center;gap:10px}.qqsLogo{width:34px;height:34px;border-radius:10px;display:grid;place-items:center;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1);font-weight:700}.qqsTitle{font-size:15px;font-weight:620}.qqMuted{font-size:12px;color:var(--dsw-alias-label-secondary);line-height:1.55}.qqStatus{display:flex;align-items:center;gap:7px;font-size:12px;color:var(--dsw-alias-label-secondary)}.qqDot{width:7px;height:7px;border-radius:50%;background:var(--dsw-alias-state-warn-primary)}.qqDot.online{background:var(--dsw-alias-state-success-primary)}
+.qqCard{border:1px solid var(--dsw-alias-border-l1);border-radius:12px;background:var(--dsw-alias-bg-layer-1);overflow:hidden}.qqCardHead{padding:12px 14px;border-bottom:1px solid var(--dsw-alias-border-l1);font-size:13px;font-weight:600}.qqSetting{display:flex;align-items:flex-start;justify-content:space-between;gap:18px;padding:13px 14px;border-bottom:1px solid var(--dsw-alias-border-l1)}.qqSetting:last-child{border-bottom:0}.qqSettingTitle{font-size:13px}.qqSettingHelp{font-size:11px;color:var(--dsw-alias-label-secondary);margin-top:4px;line-height:1.5;max-width:470px}.qqControl{min-width:190px;display:flex;justify-content:flex-end;align-items:center;gap:8px}.qqSelect,.qqInput{font:inherit;font-size:12px;color:inherit;background:var(--dsw-alias-bg-base);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:7px 9px;outline:none}.qqInput{width:250px}.qqSelect{min-width:180px}.qqSwitch{position:relative;width:38px;height:22px;border:0;border-radius:999px;background:var(--dsw-alias-bg-overlay);cursor:pointer}.qqSwitch.on{background:var(--dsw-alias-brand-primary)}.qqSwitch:after{content:'';position:absolute;width:16px;height:16px;border-radius:50%;top:3px;left:3px;background:var(--dsw-alias-bg-base);transition:transform .15s}.qqSwitch.on:after{transform:translateX(16px)}
+.qqSegment{display:flex;padding:2px;border:1px solid var(--dsw-alias-border-l1);border-radius:9px;background:var(--dsw-alias-bg-base)}.qqSegment button{font:inherit;font-size:11px;border:0;background:transparent;color:var(--dsw-alias-label-secondary);padding:6px 9px;border-radius:6px;cursor:pointer;white-space:nowrap}.qqSegment button.active{background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary)}
+.qqBtn{font:inherit;font-size:12px;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);color:inherit;border-radius:8px;padding:7px 11px;cursor:pointer}.qqBtn:hover{background:var(--dsw-alias-bg-layer-2)}.qqBtn.primary{background:var(--dsw-alias-brand-primary);color:var(--dsw-alias-bg-base);border-color:transparent}.qqBtn:disabled{opacity:.45;cursor:default}.qqError{font-size:12px;color:var(--dsw-alias-state-error-primary)}
+.qqConnect{padding:24px;display:flex;flex-direction:column;align-items:center;gap:14px;text-align:center}.qqQr{padding:14px;background:#fff;border-radius:14px}.qqQr img{display:block;width:210px;height:210px}
+.qqModalMask{position:fixed;inset:0;z-index:10000;background:#0007;display:grid;place-items:center;padding:24px}.qqModal{width:min(720px,calc(100vw - 40px));max-height:min(760px,calc(100vh - 40px));display:flex;flex-direction:column;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);border-radius:14px;box-shadow:0 16px 60px #0007;overflow:hidden}.qqModalHead{display:flex;align-items:center;justify-content:space-between;gap:12px;padding:13px 15px;border-bottom:1px solid var(--dsw-alias-border-l1)}.qqModalTitle{font-size:14px;font-weight:620}.qqModalBody{overflow:auto;padding:14px}.qqClose{border:0;background:transparent;color:inherit;font-size:18px;cursor:pointer}
+.qqLog{font:11px/1.55 ui-monospace,SFMono-Regular,Menlo,monospace;padding:7px 0;border-bottom:1px solid var(--dsw-alias-border-l1);white-space:pre-wrap;word-break:break-word}.qqLogMeta{opacity:.65;margin-right:8px}.qqLog.warn{color:var(--dsw-alias-state-warn-primary)}.qqLog.error{color:var(--dsw-alias-state-error-primary)}
+.qqFootButton{border:0;background:transparent;color:var(--dsw-alias-label-secondary);height:36px;border-radius:8px;display:flex;align-items:center;justify-content:center;gap:8px;padding:0 10px;cursor:pointer;font:inherit;font-size:12px}.qqFootButton:hover{background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary)}.qqFootIcon{width:20px;height:20px;border-radius:6px;display:grid;place-items:center;font-size:10px;font-weight:700;border:1px solid var(--dsw-alias-border-l2)}
+.qqChatToolbar{display:flex;gap:8px;margin-bottom:12px}.qqSearch{flex:1;font:inherit;background:var(--dsw-alias-bg-base);color:inherit;border:1px solid var(--dsw-alias-border-l2);border-radius:9px;padding:8px 10px}.qqChatSection{margin:14px 0 6px;font-size:11px;color:var(--dsw-alias-label-secondary)}.qqChatRow{width:100%;display:flex;align-items:center;gap:10px;padding:10px;border:0;background:transparent;color:inherit;border-radius:9px;text-align:left;cursor:pointer}.qqChatRow:hover{background:var(--dsw-alias-bg-layer-2)}.qqAvatar{width:34px;height:34px;border-radius:50%;display:grid;place-items:center;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1);font-size:11px;font-weight:650;flex:0 0 auto}.qqGrow{min-width:0;flex:1}.qqEllipsis{white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.qqBadge{font-size:10px;padding:2px 5px;border-radius:5px;background:var(--dsw-alias-bg-overlay);color:var(--dsw-alias-label-secondary)}
+.qqTranscript{display:flex;gap:9px;align-items:flex-start;margin:14px 0}.qqTranscript.out{flex-direction:row-reverse}.qqTranscriptBody{max-width:min(78%,680px)}.qqTranscript.out .qqTranscriptBody{text-align:right}.qqTranscriptMeta{font-size:11px;color:var(--dsw-alias-label-secondary);margin:0 3px 5px}.qqBubble{display:inline-block;text-align:left;white-space:pre-wrap;word-break:break-word;font-size:13px;line-height:1.55;padding:9px 11px;border-radius:5px 13px 13px 13px;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1)}.qqTranscript.out .qqBubble{border-radius:13px 5px 13px 13px;background:var(--dsw-static-deepseek-50,var(--dsw-alias-bg-layer-2))}.qqQuote{max-width:100%;margin:0 0 7px;padding:7px 10px 8px;border:1px solid var(--dsw-alias-border-l1);border-left:3px solid var(--dsw-alias-brand-primary);border-radius:8px;background:color-mix(in srgb,var(--dsw-alias-bg-layer-2) 72%,transparent);color:var(--dsw-alias-label-secondary);text-align:left;white-space:normal;word-break:break-word;overflow:hidden}.qqQuoteLabel{margin-bottom:3px;font-size:10px;line-height:14px;font-weight:650;color:var(--dsw-alias-brand-primary);letter-spacing:.02em}.qqQuoteText{font-size:12px;line-height:1.5;white-space:pre-wrap;display:-webkit-box;-webkit-line-clamp:8;-webkit-box-orient:vertical;overflow:hidden}.qqTranscript.out .qqQuote{border-left:1px solid var(--dsw-alias-border-l1);border-right:3px solid var(--dsw-alias-brand-primary)}
+.qqHeaderButton{font:inherit;font-size:11px;border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-secondary);border-radius:7px;padding:5px 8px;cursor:pointer}
+.qqMemoryGrid{display:grid;grid-template-columns:1fr 1fr;gap:10px}.qqMemoryCard{border:1px solid var(--dsw-alias-border-l1);border-radius:9px;overflow:hidden}.qqMemoryCard h4{font-size:11px;margin:0;padding:8px 9px;border-bottom:1px solid var(--dsw-alias-border-l1)}.qqMemoryDoc{padding:9px;font-size:11px;line-height:1.55;color:var(--dsw-alias-label-secondary);white-space:pre-wrap;word-break:break-word;max-height:180px;overflow:auto}.qqMemberList{margin-top:12px}.qqMemberRow{display:flex;align-items:center;gap:8px;padding:8px;border-bottom:1px solid var(--dsw-alias-border-l1);font-size:12px}.qqMemberId{font:10px ui-monospace,SFMono-Regular,Menlo,monospace;color:var(--dsw-alias-label-secondary)}
+@media(max-width:720px){.qqSetting{flex-direction:column}.qqControl{width:100%;justify-content:flex-start}.qqMemoryGrid{grid-template-columns:1fr}.qqInput{width:100%}}
+
+/* QQChat contributes layout only; controls, dialogs and selection surfaces are
+   DSH primitives. Message colors use the host token system directly. */
+.qqs{display:block;width:100%;min-width:0}.qqsHead{width:100%}.qqSettingsGroup{display:block;width:100%;min-width:0;margin-top:22px}.qqSettingsGroup h3{margin:0 0 8px;font-size:13px;font-weight:600;color:var(--dsw-alias-label-primary)}.qqSettingsGroup .qqSetting{display:flex;width:100%;min-width:0;flex:0 0 auto;padding:12px 0;border-bottom:1px solid var(--dsw-alias-border-l1)}.qqSettingsGroup .qqSetting:last-child{border-bottom:0}.qqSetting>div:first-child{flex:1 1 auto;min-width:0}.qqControl{flex:0 0 auto}.qqChoiceButtons{display:flex;flex-wrap:wrap;justify-content:flex-end;gap:6px}.qqSettingsGroup select{font:inherit;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:5px 8px}.qqCheckRow{display:flex;align-items:flex-start;gap:10px;cursor:pointer}.qqCheckRow input{flex:none;width:16px;height:16px;margin:2px 0 0;accent-color:var(--dsw-alias-button-primary-fill);cursor:pointer}.qqConnect{display:flex;flex-direction:column;align-items:center;gap:14px;padding:24px 0;text-align:center}.qqTranscript{margin:16px 0}.qqTranscriptBody{max-width:min(78%,680px)}.qqBubble{border:0;border-radius:18px;padding:9px 13px;background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary)}.qqTranscript.out .qqBubble{border-radius:18px;background:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground)}.qqTranscriptMeta{margin:0 4px 4px;font-size:12px;color:var(--dsw-alias-label-secondary)}.qqQuote{border-color:var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1)}
+.qqWideModal{width:min(760px,calc(100vw - 48px));max-height:calc(100vh - 48px);min-height:0;overflow:hidden}.qqModalContent{min-height:0;overflow:auto}.qqModalContent .qqMemoryGrid{min-width:0}.qqModalContent .qqLog{overflow-wrap:anywhere;word-break:break-word}
+`.concat('.qqQuoteSender{margin-top:4px;font-size:10px;color:var(--dsw-alias-label-secondary)}.qqMediaList{display:flex;flex-wrap:wrap;gap:6px;margin-top:7px}.qqMediaCard{display:flex;align-items:center;gap:6px;max-width:100%;padding:6px 8px;border:1px solid var(--dsw-alias-border-l1);border-radius:8px;background:var(--dsw-alias-bg-layer-1);font-size:11px}.qqMediaKind{color:var(--dsw-alias-brand-primary);font-weight:650}.qqMediaPreview{width:42px;height:42px;object-fit:cover;border-radius:6px}.qqMediaName{max-width:220px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.qqMediaSize,.qqMediaQuoted{color:var(--dsw-alias-label-secondary)}')
+
+const qqThemeOverrides = '.qqTranscript.out .qqBubble{background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary)}'
+
+export function installStyles(): () => void {
+  if (typeof document === 'undefined' || document.querySelector(`style[data-plugin-css="${STYLE_ID}"]`)) return () => {}
+  const node = document.createElement('style')
+  node.dataset.pluginCss = STYLE_ID
+  node.textContent = css + qqThemeOverrides
+  document.head.appendChild(node)
+  return () => node.remove()
+}
+
+export async function call<T>(rpc: Rpc, endpoint: string, payload: unknown = {}): Promise<T> {
+  const result = await rpc.call(CHANNEL, endpoint, payload) as RpcResult<T>
+  if (!result.ok) throw new Error(result.error?.message || 'QQ Chat 请求失败')
+  return result.value
+}
+
+export const short = (value: string) => value.length > 10 ? `…${value.slice(-10)}` : value
+export const initials = (value: string) => String(value || '?').trim().slice(0, 2).toUpperCase()
+export const time = (value: number) => value ? new Date(value).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' }) : ''
+export const dateTime = (value: number) => value ? new Date(value).toLocaleString() : ''
+
+export function Modal({ title, onClose, children }: { title: string; onClose(): void; children?: import('react').ReactNode }) {
+  return h(DshModal, { open: true, title, onClose, closeLabel: '关闭', className: 'qqWideModal', contentClassName: 'qqModalContent' }, children)
+}

package/client-src/workspace.cts

@@ -0,0 +1,164 @@
+import { React, h, useEffect, useState, call, getQQRpc, Modal, Button, time } from './shared.cjs'
+import type { ChatInfo, ChatMember, QQAttachmentData, QQEventData, QQNode, Rpc, SessionUtilityProps } from './shared.cjs'
+
+function formatBytes(value: number): string {
+  if (!value || value < 1024) return `${value || 0} B`
+  if (value < 1024 * 1024) return `${(value / 1024).toFixed(1)} KB`
+  return `${(value / 1024 / 1024).toFixed(1)} MB`
+}
+
+function AttachmentCards({ attachments, sessionId }: { attachments?: QQAttachmentData[]; sessionId?: string }) {
+  if (!attachments?.length) return null
+  const rpc = getQQRpc()
+  const [previews, setPreviews] = useState<Record<string, string>>({})
+  useEffect(() => {
+    if (!rpc || !sessionId) return
+    let cancelled = false
+    void Promise.all(attachments.filter(item => item.kind === 'image').map(async item => {
+      try {
+        const result = await call<{ dataUrl?: string }>(rpc, 'attachment/read', { sessionId, attachmentId: item.id })
+        return result.dataUrl ? [item.id, result.dataUrl] as const : null
+      } catch { return null }
+    })).then(items => {
+      if (cancelled) return
+      setPreviews(current => ({ ...current, ...Object.fromEntries(items.filter((item): item is readonly [string, string] => Boolean(item))) }))
+    })
+    return () => { cancelled = true }
+  }, [attachments, rpc, sessionId])
+  return h('div', { className: 'qqMediaList' }, ...attachments.map(attachment =>
+    h('div', { className: 'qqMediaCard', key: `${attachment.id}:${attachment.quoted ? 'quote' : 'own'}` },
+      h('span', { className: 'qqMediaKind' }, attachment.kind === 'image' ? '图片' : attachment.kind === 'video' ? '视频' : attachment.kind === 'voice' || attachment.kind === 'audio' ? '语音' : '文件'),
+      previews[attachment.id] ? h('img', { className: 'qqMediaPreview', src: previews[attachment.id], alt: attachment.filename }) : null,
+      h('span', { className: 'qqMediaName' }, attachment.filename),
+      h('span', { className: 'qqMediaSize' }, formatBytes(attachment.sizeBytes)),
+      attachment.quoted ? h('span', { className: 'qqMediaQuoted' }, '引用') : null)))
+}
+
+export function QQTranscriptNode({ node }: { node: QQNode }) {
+  const data = node.data
+  const outbound = data.direction === 'outbound' || data.isOwner === true
+  const hasQuote = Boolean(data.quote) || Boolean(data.quotedText)
+  const quoteText = data.quote?.text || data.quotedText || ''
+  return h('div', { className: `qqTranscript${outbound ? ' out' : ''}` },
+    h('div', { className: 'qqTranscriptBody' },
+      !data.isOwner && h('div', { className: 'qqTranscriptMeta' }, data.senderName || (outbound ? 'Owner' : 'QQ 用户'), ' · ', time(data.createdAt)),
+      hasQuote && h('div', { className: 'qqQuote', title: quoteText },
+        h('div', { className: 'qqQuoteLabel' }, '引用消息'),
+        quoteText ? h('div', { className: 'qqQuoteText' }, quoteText) : null,
+        data.quote?.senderName ? h('div', { className: 'qqQuoteSender' }, data.quote.senderName) : null,
+        h(AttachmentCards, { attachments: data.quote?.attachments, sessionId: data.sessionId })),
+      h('div', { className: 'qqBubble' }, data.content),
+      h(AttachmentCards, { attachments: data.attachments, sessionId: data.sessionId })))
+}
+
+export function MemoryCard({ title, value }: { title: string; value: string }) {
+  return h('section', { className: 'qqMemoryCard' },
+    h('h4', null, title),
+    h('div', { className: 'qqMemoryDoc' }, value || '还没有形成这部分记忆。'))
+}
+
+function MemberMemory({ member, onBack }: { member: ChatMember; onBack(): void }) {
+  return h(React.Fragment, null,
+    h('div', { style: { display: 'flex', alignItems: 'center', gap: 10, marginBottom: 12 } },
+      h(Button, { size: 'sm', variant: 'outline', onClick: onBack }, '返回群记忆'),
+      h('div', { className: 'qqGrow' },
+        h('div', { className: 'qqsTitle' }, member.displayName || '群友'),
+        h('div', { className: 'qqMemberId' }, member.platformUserId))),
+    h('div', { className: 'qqMemoryGrid' },
+      h(MemoryCard, { title: '成员画像 · profile', value: member.memory.profile }),
+      h(MemoryCard, { title: '行为模式 · pattern', value: member.memory.pattern }),
+      h(MemoryCard, { title: '成员摘要 · summary', value: member.memory.summary }),
+      h(MemoryCard, { title: '成员长期记忆 · memory', value: member.memory.memory })))
+}
+
+export function QQSessionUtility({ sessionId, rpc }: SessionUtilityProps & { rpc: Rpc }) {
+  const [info, setInfo] = useState<ChatInfo | null>(null)
+  const [open, setOpen] = useState(false)
+  const [selectedMember, setSelectedMember] = useState<ChatMember | null>(null)
+  const isQQSession = String(sessionId).startsWith('qqchat-')
+  if (!isQQSession) return null
+
+  const show = async () => {
+    try {
+      setInfo(await call<ChatInfo>(rpc, 'chat/info', { sessionId }))
+      setSelectedMember(null)
+      setOpen(true)
+    } catch {
+      // Host may still be reconciling a just-created Session.
+    }
+  }
+
+  const memoryBody = info
+    ? selectedMember
+      ? h(MemberMemory, { member: selectedMember, onBack: () => setSelectedMember(null) })
+      : h(React.Fragment, null,
+          h('div', { className: 'qqMemoryGrid' },
+            h(MemoryCard, { title: '画像 · profile', value: info.memory.profile }),
+            h(MemoryCard, { title: '摘要 · summary', value: info.memory.summary }),
+            info.chatType === 'group'
+              ? h(MemoryCard, { title: '长期记忆 · memory', value: info.memory.memory })
+              : h(MemoryCard, { title: '行为模式 · pattern', value: info.memory.pattern }),
+            info.chatType === 'group'
+              ? h(MemoryCard, { title: '近期沉淀 · daily', value: info.memory.daily })
+              : null),
+          info.chatType === 'group'
+            ? h('div', { className: 'qqMemberList' },
+                h('div', { className: 'qqChatSection' }, `群友 · ${info.members.length} · 点击查看成员记忆`),
+                ...info.members.map(member => h('button', {
+                  type: 'button',
+                  key: member.id,
+                  className: 'qqMemberRow',
+                  onClick: () => setSelectedMember(member),
+                  style: { width: '100%', border: 0, background: 'transparent', color: 'inherit', textAlign: 'left', cursor: 'pointer' },
+                },
+        h('div', { className: 'qqGrow' },
+          h('div', null, member.displayName || '群友'),
+          member.aliases?.length ? h('div', { className: 'qqMemberId' }, `历史昵称：${member.aliases.join('、')}`) : null,
+          member.nicknames?.length ? h('div', { className: 'qqMemberId' }, `群内称呼：${member.nicknames.join('、')}`) : null),
+                h('span', { className: 'qqBadge' }, '查看记忆'))))
+            : null)
+    : null
+
+  return h(React.Fragment, null,
+    h(Button, { size: 'sm', variant: 'outline', onClick: () => void show() }, 'QQ 记忆'),
+    open && info
+      ? h(Modal, {
+          title: selectedMember
+            ? `${selectedMember.displayName || '群友'} · 成员记忆`
+            : info.chatType === 'group' ? `${info.title} · 群记忆` : `${info.title} · 用户记忆`,
+          onClose: () => { setOpen(false); setSelectedMember(null) },
+        }, memoryBody)
+      : null)
+}
+
+export function createQQMessageDefinition(): Record<string, unknown> {
+  return {
+    kind: 'qqchat-message',
+    target: 'chat',
+    match: (event: { type?: string; data?: QQEventData }) => event.type === 'qqchat/message' && event.data
+      ? { id: event.data.messageId, role: 'start' }
+      : null,
+    start: (_context: unknown, match: { event: { data: QQEventData } }) => match.event.data,
+    update: (context: { state?: QQEventData }) => context.state,
+    buildViewNode: (context: {
+      key: string
+      id: string
+      state?: QQEventData
+      start?: { event: { seq: number }; location?: unknown }
+      matches?: Array<{ event: { seq: number }; location?: unknown }>
+    }) => {
+      if (!context.state) return null
+      const first = context.start ?? context.matches?.[0]
+      return {
+        key: context.key,
+        kind: 'qqchat-message',
+        id: context.id,
+        target: 'chat',
+        anchorSeq: first?.event.seq ?? 0,
+        location: first?.location ?? { kind: 'unresolved' },
+        visibility: 'visible',
+        data: context.state,
+      }
+    },
+  }
+}

package/cordis.patch.yml

@@ -0,0 +1,7 @@
+# dsh-qqchat is a profile bundle: installing it through `dsh plugin` appends
+# this patch after the selected profile's shipped bundles.
+- insert:
+    - id: dsh-qqchat
+      name: dsh-qqchat
+      config:
+        dataDir: !!js dshHomePath('plugins/dsh-qqchat')