dsh-qqchat 0.2.4 → 0.2.6

package/lib/types.d.ts

@@ -54,6 +54,7 @@ export interface StoredAttachmentSummary {
 }
 export interface QQChatRuntimeSettings {
     memoryEnabled: boolean;
+    memoryMemberBatchEnabled: boolean;
     groupReceiveMode: GroupReceiveMode;
     groupReplyFormat: ReplyFormat;
     directReplyFormat: ReplyFormat;
@@ -65,6 +66,7 @@ export interface QQChatRuntimeSettings {
 }
 export interface QQChatRuntimeSettingsPatch {
     memoryEnabled?: boolean;
+    memoryMemberBatchEnabled?: boolean;
     groupReceiveMode?: GroupReceiveMode;
     groupReplyFormat?: ReplyFormat;
     directReplyFormat?: ReplyFormat;
@@ -384,6 +386,16 @@ export interface ModelRoute {
     model: string;
     sessionId?: string;
 }
+export type ReflectionScopeType = 'group' | 'member' | 'private';
+export type ReflectionTaskType = 'group' | 'member-batch' | 'private-owner';
+export interface ReflectionTaskInput {
+    scopeType: ReflectionScopeType;
+    scopeKey: number;
+    taskType: ReflectionTaskType;
+    startMessageId: number;
+    endMessageId: number;
+    idempotencyKey: string;
+}
 export interface PendingReply {
     text: string;
     onTextDelta?: (delta: string) => void;
@@ -402,6 +414,20 @@ export interface ReflectionMemberUpdate {
     memory?: unknown;
     nicknames?: unknown;
 }
+export interface ReflectionMemberBatchUpdate {
+    senderId?: unknown;
+    profile_add?: unknown;
+    profile_remove?: unknown;
+    pattern_add?: unknown;
+    pattern_remove?: unknown;
+    summary?: unknown;
+    daily?: unknown;
+    memory?: unknown;
+    nicknames?: unknown;
+}
+export interface MemberBatchReflectionPayload {
+    members?: ReflectionMemberBatchUpdate[];
+}
 export interface ReflectionPayload {
     group?: ReflectionGroupUpdate;
     members?: ReflectionMemberUpdate[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-qqchat",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "DeepSeek Harness 的 QQ 私聊/群聊插件，支持扫码授权、原生 Session、群记忆与工具权限。",
   "type": "module",
   "license": "MIT",
@@ -20,6 +20,7 @@
   "files": [
     "lib",
     "src",
+    "prompts",
     "client-src",
     "cordis.patch.yml",
     "README.md",
@@ -38,26 +39,25 @@
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "tsx --test tests/*.test.ts",
     "check": "npm run typecheck && npm test && npm run build",
-    "prepublishOnly": "npm run check",
-    "prepare": "npm run build"
+    "prepublishOnly": "npm run check"
   },
   "dependencies": {
     "qrcode": "^1.5.4"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-attachment": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-agent": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-commands": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-tools": "^0.1.1-rc.2"
+    "@deepseek-ai/dsh-attachment": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-agent": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-commands": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-modules": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-llm": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-tools": "^0.1.6-alpha.1"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-client-connection": {
@@ -66,7 +66,7 @@
     "@deepseek-ai/dsh-client-ui-settings": {
       "optional": true
     },
-    "@deepseek-ai/dsh-client-runtime": {
+    "@deepseek-ai/dsh-client-modules": {
       "optional": true
     },
     "@deepseek-ai/dsh-client-ui-conversation": {
@@ -74,11 +74,12 @@
     }
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-attachment": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-agent-default-model": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-commands": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-attachment": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-agent-default-model": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-commands": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-modules": "^0.1.6-alpha.1",
     "@types/node": "^22.18.0",
     "@types/qrcode": "^1.5.5",
     "@types/react": "^19.1.0",
@@ -93,7 +94,7 @@
       "platform": "web",
       "inject": [
         "@deepseek-ai/dsh-client-connection",
-        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-modules",
         "@deepseek-ai/dsh-client-ui-conversation",
         "@deepseek-ai/dsh-client-ui-settings"
       ]
@@ -101,7 +102,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+ssh://git@github.com/Coffeiz/dsh-qqchat.git"
+    "url": "https://github.com/Coffeiz/dsh-qqchat"
   },
   "keywords": [
     "deepseek-harness",

package/prompts/group-compression.md

@@ -0,0 +1,5 @@
+你负责维护 QQ 群长期记忆主档。把近期 daily 记录合并进已有 memory，合并重复、修正明确矛盾，但保留有价值的历史、日期、事件背景和变化过程；不要因为旧或细而删除历史，不评判、不推测，不能清空已有长期记忆。
+
+严格只输出 JSON，不要 Markdown、解释或额外文字：
+
+{"memory":"更新后的长期记忆全文；不能清空"}

package/prompts/group-reflection.md

@@ -0,0 +1,39 @@
+你负责维护当前 QQ 群的公开长期记忆。你会收到当前群信息、已有群记忆和一批完整消息。这是群组反思，不是当前发言人的个人总结，也不是成员画像任务。
+
+## 一、群组记忆边界
+
+只记录当前群公开且明确的内容：
+
+- 群名称、用途和性质；
+- 群内明确确认的规则、协作约定和长期沟通偏好；
+- 明确公开的长期项目、共同决定、分工、关系和持续讨论；
+- 当前群正在进行的事项和近期状态。
+
+不要记录：
+
+- 单个成员的个人资料、兴趣、性格、经历或私聊内容；
+- 根据昵称、语气、@、引用或他人评价推断身份；
+- 一次性闲聊、玩笑、临时情绪和短期安排；
+- 没有明确依据的猜测；
+- 原始 senderId、groupId、openid 等内部 ID；
+- 群外信息。
+
+## 二、主体和证据判断
+
+先判断一条消息描述的是群体、某个成员、引用中的人，还是不明确的第三方，再判断是否属于群记忆。消息发送者不等于语义主体。引用和转述中的个人事实不能因为出现在群里就变成群事实；只有明确的群体决定、公开协作或群内共同事件才可以记录。
+
+“可能、应该、感觉、听说、好像、我觉得”不能作为确定事实。涉及时间时使用消息时间换算出的绝对日期，不使用“今天、明天、最近”等相对时间。
+
+## 三、字段规则
+
+- profile：稳定、公开、未来仍有参考价值的群事实；本批没有变化时保持原内容，不要清空或重写。
+- summary：不超过 150 字的当前群状态，回答“现在群里在做什么”；没有变化时沿用已有内容。
+- daily：本批值得留档的近期群事件、决定和讨论进展，一条一个事实；一次性内容不要写入 profile。
+- memory：真正长期有用的群项目、关系、约定和背景；不要复制完整聊天记录，也不要写个人属性。
+- 与 existing 冲突时，只有消息明确推翻旧内容才修正；不能因为新消息暂时没提到旧事实就删除。
+
+输出必须是严格 JSON，不要 Markdown、解释或额外文字。只修改 group，不要输出 members，也不要为 BOT 创建成员记忆。
+
+输出结构：
+
+{"group":{"profile":{},"summary":"","daily":"","memory":["..."]}}

package/prompts/member-batch-reflection.md

@@ -0,0 +1,39 @@
+你负责维护本批 QQ 群消息中多个成员的个人长期记忆。你会收到已有成员记忆、完整群消息和成员列表。这是成员批量反思，不是当前发言人的单人总结，也不是群组总结。
+
+## 一、先判断“是谁的”，再判断“是什么”
+
+对每条候选信息按以下顺序判断：
+
+1. 语义主体是发送者本人、其他群成员、群外的人、引用中的人，还是无法明确？
+2. 主体明确后，它是稳定个人资料、可复用行为模式、近期状态、高价值个人事件，还是只属于群组事件？
+
+只有主体能明确落到本批真实出现的 senderId，且内容描述该成员本人时，才允许写入该成员对象。消息发送者不等于语义主体，宁可漏记，也不要错记。
+
+## 二、允许输出的成员
+
+members 中只能包含 messages 里真实作为发送者出现、元数据提供 senderId、且确实有可记录个人信息的成员。不得因为某人被昵称提到、被 @、出现在引用中、被代词指代或被他人描述，就猜造其 senderId。没有可记内容的成员可以省略。senderId 是唯一身份依据，displayName 只用于理解和展示。
+
+## 三、主体归属规则
+
+- “我喜欢爵士”可以记为发送者本人的偏好。
+- “我觉得小明喜欢爵士”描述小明，不能记为发送者喜欢爵士。
+- “我和小明一起排查问题”可以记录发送者自己的协作模式，不能据此记录小明的能力或偏好。
+- 引用、转述、第三方评价和“他说/听说/好像/我觉得他”等模糊表达不能直接升级为个人记忆。
+- 只有被描述成员随后明确确认，才可以记录该成员自己的事实。
+- 群规、群角色、公共决定、群项目和群体关系属于 group，不写入成员记忆。
+- 不要为 BOT 创建成员记忆，也不要把 BOT 的消息当作任何成员的事实证据。
+
+## 四、字段和证据门槛
+
+- profile_add/profile_remove：稳定且未来有用的个人资料。type 只能是 name、address、pronoun、background、preference、note；涉及阶段性内容（最近、刚刚、目前、本周、暂时）不要放入 profile。
+- pattern_add/pattern_remove：重复且可复用、可观察的行为或决策模式。不能因为一次消息或一件事就推断稳定人格。
+- summary：不超过 120 字的近期状态，可以准确描述该成员参与的互动；没有变化时沿用 existing，不要写成流水账。
+- memory：高价值、可长期回看的个人事件，包含必要的时间、背景、行动和结果；其他人的属性和群组信息不能写入。
+- daily：本批重要但阶段性的个人事实，使用绝对日期；没有就返回空字符串。
+- 只返回本批新增或明确修正，不要回显已有内容。旧内容只有被明确推翻时才放入 remove 数组。
+
+严格只输出 JSON，不要 Markdown、解释或额外文字。
+
+输出结构：
+
+{"members":[{"senderId":"本批消息中真实出现的可靠 ID","profile_add":[{"type":"name|address|pronoun|background|preference|note","text":"只描述该成员本人","ts":0}],"profile_remove":[{"text":"被明确推翻的旧资料"}],"pattern_add":[],"pattern_remove":[],"summary":"不超过120字","daily":"绝对日期的近期事实","memory":"高价值个人事件"}]}

package/prompts/member-compression.md

@@ -0,0 +1,5 @@
+你负责维护 QQ 成员长期记忆主档。把近期 daily 记录合并进已有 memory，结合 profile 和 pattern，保留有价值的历史、日期、项目背景和变化过程；不要重复抄写 profile/pattern，不评判、不推测，不能清空已有长期记忆，也不要把群组信息或其他人的属性写入当前成员记忆。
+
+严格只输出 JSON，不要 Markdown、解释或额外文字：
+
+{"memory":"更新后的长期记忆全文；不能清空"}

package/prompts/private-reflection.md

@@ -0,0 +1,32 @@
+你负责维护当前 QQ 私聊对象的长期记忆。你会收到已有记忆和一批按时间排列的私聊消息，只针对这个 senderId，不针对 BOT，也不针对其他被提到的人。
+
+## 一、事实边界和主体判断
+
+输入中的 direction 是硬性事实边界：
+
+- direction=inbound 的消息是用户自己的表达，才可能产生用户事实；
+- direction=outbound 的 BOT 消息只是对话上下文，不能证明用户拥有某个偏好、身份、经历或状态；
+- 引用、转述、第三方描述、代词、玩笑、反问和“听说/好像/我觉得他”等内容，主体不明确时宁可不记；
+- senderId 是唯一身份依据，不能根据昵称、语气、最近发言或模型推断补全身份。
+
+## 二、记忆字段
+
+- profile：当前用户稳定的身份、背景、地址、称呼和长期偏好。阶段性内容（最近、刚刚、目前、本周、暂时）不要写入。
+- pattern：当前用户重复出现且可复用的行为或决策模式；一次行为不能直接推断稳定人格。
+- summary：不超过 120 字的近期状态或关注点；没有变化时原样沿用 existing，不要清空或改成流水账。
+- daily：本轮重要但阶段性的事实，一句话即可，涉及时间必须使用绝对日期。
+- memory：高价值、可长期回看的用户个人事件，保留必要时间、背景、行动和结果，不复制聊天原文。
+
+## 三、增量和安全规则
+
+- profile_add/profile_remove、pattern_add/pattern_remove 只包含本轮新增或明确修正，不要回显已有内容。
+- 只有被当前用户明确推翻的旧资料或模式才进入 remove 数组。
+- 不要把 BOT 的建议、观点或回复写成用户事实。
+- 不要把其他人的个人信息、群组规则或群体事件写入当前用户记忆。
+- 不确定时宁可漏记；existing 是已有事实，应克制更新而不是无条件推翻。
+
+严格只输出 JSON，不要 Markdown、解释或额外文字。
+
+输出结构：
+
+{"profile_add":[{"type":"name|address|pronoun|background|preference|note","text":"只描述当前私聊对象","ts":0}],"profile_remove":[{"text":"被明确推翻的旧资料"}],"pattern_add":[],"pattern_remove":[],"summary":"不超过120字的当前状态","daily":"绝对日期的阶段性事实","memory":"高价值个人事件"}

package/src/config.ts

@@ -10,10 +10,10 @@ const DEFAULT_CONFIG = Object.freeze({
   groupReadEnabled: true,
   replyFormat: 'smart' as ReplyFormat,
   recentGroupMessages: 40,
-  reflectionIdleMs: 120_000,
+  reflectionIdleMs: 900_000,
   reflectionBatchSize: 20,
   reflectionMaxMessages: 80,
-  memoryMaxTokens: 1400,
+  memoryMaxTokens: 4096,
   memoryCompressionMaxTokens: 15000,
 })
 
@@ -50,6 +50,7 @@ export function defaultRuntimeSettings(config: QQChatConfig): QQChatRuntimeSetti
     : config.groupRequiresAt ? 'mention' : 'auto'
   return {
     memoryEnabled: true,
+    memoryMemberBatchEnabled: true,
     groupReceiveMode,
     groupReplyFormat: 'compat',
     directReplyFormat: config.replyFormat,

package/src/index.ts

@@ -20,7 +20,7 @@ import type { LoggerLike, QQChatConfigInput } from './types.js'
 const qqChatSessionEventRegistrations = await registerQQChatSessionEventType()
 
 export const name = 'dsh-qqchat'
-export const inject = ['connection', 'agents', 'agentDefaultModel', 'commands', 'llm', 'tools', 'workspaceRegistry'] as const
+export const inject = ['connection', 'agents', 'agentDefaultModel', 'commands', 'llm', 'tools', 'webServer', 'workspaceRegistry'] as const
 
 export function apply(ctx: Context, inputConfig: QQChatConfigInput = {}): void {
   const config = resolveConfig(inputConfig)
@@ -38,10 +38,9 @@ export function apply(ctx: Context, inputConfig: QQChatConfigInput = {}): void {
   const bridge = new DshQQBridge(ctx, db, memory, config, logger)
   const runtime = new QQChatRuntime(ctx, db, api, auth, memory, bridge, config, logger, media)
 
-  ctx.connection.rpc.handle('/qqchat', createQQChatRpc(runtime), { authority: 'loopback' })
+  ctx.connection.rpc.handle('/qqchat', createQQChatRpc(runtime))
   ctx.effect(() => {
     void (async () => {
-      await bridge.ensureWorkspaceMembership()
       await runtime.start()
     })().catch(error => logger.error?.(error))
     return () => runtime.stop()

package/src/session/agent-bridge.ts

@@ -3,7 +3,7 @@ import { createRequire } from 'node:module'
 import type { Context } from '@deepseek-ai/cordis'
 import { installModelSelection } from '@deepseek-ai/dsh-agent'
 import type { AgentHandle, AgentOptions, AgentSetup, ModelSelectionRef } from '@deepseek-ai/dsh-agent'
-import { resolveSessionPreset } from '@deepseek-ai/dsh-agent-presets'
+import { agentPresetProjectionDefinition } from '@deepseek-ai/dsh-agent-presets'
 import { createUserMessage } from '@deepseek-ai/dsh-llm'
 import type { ContentBlock } from '@deepseek-ai/dsh-llm'
 import type { CommandInvocation, CommandRuntime, CommandResult } from '@deepseek-ai/dsh-commands'
@@ -39,16 +39,17 @@ interface AgentPreset { id: string }
 interface AgentPresetService { resolve(id?: string): Promise<AgentPreset>; list(): Promise<AgentPreset[]>; mount(ctx: Context, id: string): Promise<unknown>; recompose(ctx: Context, id: string): Promise<AgentPreset> }
 interface SessionPersistenceService { inspect(id: SessionId): Promise<{ meta: Session['header']; events: readonly SessionEvent[] }> }
 interface SessionTitleService { get(session: Session): unknown; rename(session: Session, title: string): unknown }
-interface WorkspaceEntity { attachSession(sessionId: SessionId): Promise<void> }
 interface WorkspaceRegistryService {
   archivedSessionIds: readonly string[]
-  create(path: string, title?: string): Promise<WorkspaceEntity>
+  resolveByPath(path: string): Promise<{ attachSession(sessionId: import('@deepseek-ai/dsh-session').SessionId): Promise<void> } | undefined>
 }
 interface Composition { presetId?: string; setup?: AgentSetup }
 interface ActiveActor { chatType: ChatType; senderId: string }
 
 export function resolveQQSessionPreset(header: Session['header'], events: readonly SessionEvent[]): string | undefined {
-  return resolveSessionPreset({ header, events })
+  let current = agentPresetProjectionDefinition.init(header)
+  for (const event of events) current = agentPresetProjectionDefinition.apply(current, event)
+  return current || undefined
 }
 
 const MEDIA_TOOL_NAMES = new Set(['qqchat_describe_image', 'qqchat_read_file', 'qqchat_media_info'])
@@ -66,8 +67,8 @@ export class DshQQBridge {
   private readonly activeAttachments = new Map<string, Set<string>>()
   private readonly activeMediaReadable = new Map<string, boolean>()
   private readonly memorySnapshots = new Map<string, MemorySnapshotState>()
-  private qqWorkspace?: Promise<WorkspaceEntity | undefined>
   private readonly disposeEvent: () => void
+  private readonly disposeAssistantStream: () => void
   private readonly disposeToolGate: () => void
   private readonly disposeCommands: () => void
   private readonly disposeImageTool: () => void
@@ -81,6 +82,10 @@ export class DshQQBridge {
     private readonly logger: LoggerLike = console,
   ) {
     this.disposeEvent = ctx.on('session/event', (session, event) => this.onSessionEvent(session, event))
+    this.disposeAssistantStream = ctx.on('agent/assistant-stream', ({ agent, frame }) => {
+      if (frame.type !== 'chunk' || frame.chunk.type !== 'text-delta' || !frame.chunk.text) return
+      this.pending.get(String(agent.id))?.onTextDelta?.(frame.chunk.text)
+    })
     this.disposeToolGate = ctx.on('tools/pre-execute', async (exec, next): Promise<PreToolDecision> => {
       const agent = exec.agent
       if (!agent) return next()
@@ -103,8 +108,19 @@ export class DshQQBridge {
     this.disposeCommands = this.registerCommands()
   }
 
+  async attachMappedSessionsToWorkspace(): Promise<void> {
+    const sessionIds = [
+      ...this.db.listGroups().map(row => row.dsh_session_id),
+      ...this.db.listDirectChats().map(row => row.dsh_session_id),
+    ]
+    for (const sessionId of sessionIds) {
+      if (sessionId) await this.attachToWorkspace(sessionId)
+    }
+  }
+
   async dispose(): Promise<void> {
     this.disposeEvent()
+    this.disposeAssistantStream()
     this.disposeToolGate()
     this.disposeImageTool()
     this.disposeMediaTools()
@@ -127,16 +143,6 @@ export class DshQQBridge {
     return sessionId
   }
 
-  async ensureWorkspaceMembership(): Promise<void> {
-    const sessionIds = [
-      ...this.db.listGroups().map(row => row.dsh_session_id),
-      ...this.db.listDirectChats().map(row => row.dsh_session_id),
-    ]
-    for (const sessionId of sessionIds) {
-      if (sessionId) await this.attachToQQWorkspace(sessionId)
-    }
-  }
-
   async recordTranscript(event: QQChatDisplayEvent, row: GroupRow | MemberRow, createSession = false): Promise<string | undefined> {
     const existing = this.db.getChatSession(event.chatType, Number(row.id))
     if (!existing && !createSession) return undefined
@@ -248,12 +254,6 @@ export class DshQQBridge {
       if (text.trim()) pending.text = text
       return
     }
-    if (event.type === 'assistant/chunk') {
-      const pending = this.pending.get(id)
-      const chunk = event.data.chunk
-      if (pending?.onTextDelta && chunk.type === 'text-delta' && chunk.text) pending.onTextDelta(chunk.text)
-      return
-    }
     if (event.type === 'request/header') {
       const { config } = event.data.header
       if (config.provider && config.model) this.routes.set(id, { provider: config.provider, model: config.model })
@@ -284,7 +284,7 @@ export class DshQQBridge {
   }
 
   private restoreMemorySnapshot(session: Session): MemorySnapshotState | undefined {
-    return restoreMemorySnapshotState(session.events as unknown as Parameters<typeof restoreMemorySnapshotState>[0], DSH_RUNTIME_CONTEXT_SOURCE)
+    return restoreMemorySnapshotState(session.snapshotEvents() as unknown as Parameters<typeof restoreMemorySnapshotState>[0], DSH_RUNTIME_CONTEXT_SOURCE)
   }
 
   private async ensureAgent(chatType: ChatType, row: GroupRow | MemberRow): Promise<{ agent: AgentHandle['agent']; sessionId: string }> {
@@ -305,16 +305,16 @@ export class DshQQBridge {
       if (live) {
         this.ensureSelection(live)
         this.ensureTitle(live.session, chatType, row)
+        await this.attachToWorkspace(sessionId)
         this.rememberRoute(chatType, row, live, sessionId)
-        await this.attachToQQWorkspace(sessionId)
         return { agent: live, sessionId }
       }
       const resumed = await this.tryResume(sessionId)
       if (resumed) {
         this.ensureSelection(resumed.agent)
         this.ensureTitle(resumed.agent.session, chatType, row)
+        await this.attachToWorkspace(sessionId)
         this.rememberRoute(chatType, row, resumed.agent, sessionId)
-        await this.attachToQQWorkspace(sessionId)
         return { agent: resumed.agent, sessionId }
       }
     }
@@ -332,36 +332,28 @@ export class DshQQBridge {
     this.handles.set(sessionId, handle)
     this.ensureSelection(handle.agent)
     this.db.setChatSession(chatType, Number(row.id), sessionId)
+    await this.attachToWorkspace(sessionId)
     this.ensureTitle(handle.agent.session, chatType, row)
     this.rememberRoute(chatType, row, handle.agent, sessionId)
-    await this.attachToQQWorkspace(sessionId)
     return { agent: handle.agent, sessionId }
   }
 
-  /** Keep all QQ sessions together in one DSH Workspace using the host API. */
-  private async attachToQQWorkspace(sessionId: string): Promise<void> {
+  private isArchived(sessionId: string): boolean {
+    const registry = (this.ctx as unknown as { workspaceRegistry?: WorkspaceRegistryService }).workspaceRegistry
+    return registry?.archivedSessionIds.includes(sessionId) ?? false
+  }
+
+  private async attachToWorkspace(sessionId: string): Promise<void> {
     const registry = (this.ctx as unknown as { workspaceRegistry?: WorkspaceRegistryService }).workspaceRegistry
     if (!registry) return
-    if (!this.qqWorkspace) {
-      this.qqWorkspace = registry.create(process.cwd(), 'QQ Chat').catch(error => {
-        this.logger.warn?.(`[dsh-qqchat] QQ Workspace 创建失败，将保留在未分组: ${error instanceof Error ? error.message : String(error)}`)
-        return undefined
-      })
-    }
-    const workspace = await this.qqWorkspace
-    if (!workspace) return
     try {
-      await workspace.attachSession(SessionId(sessionId))
+      const workspace = await registry.resolveByPath(process.cwd())
+      await workspace?.attachSession(SessionId(sessionId))
     } catch (error) {
-      this.logger.warn?.(`[dsh-qqchat] QQ session ${sessionId} 加入 Workspace 失败，将保留在未分组: ${error instanceof Error ? error.message : String(error)}`)
+      this.logger.warn?.(`[dsh-qqchat] QQ session ${sessionId} 未能挂载到当前工作区: ${error instanceof Error ? error.message : String(error)}`)
     }
   }
 
-  private isArchived(sessionId: string): boolean {
-    const registry = (this.ctx as unknown as { workspaceRegistry?: WorkspaceRegistryService }).workspaceRegistry
-    return registry?.archivedSessionIds.includes(sessionId) ?? false
-  }
-
   private rememberRoute(chatType: ChatType, row: GroupRow | MemberRow, agent: AgentHandle['agent'], sessionId: string): void {
     const provider = agent.options.provider || this.config.provider
     const model = agent.options.model || this.config.model
@@ -371,7 +363,7 @@ export class DshQQBridge {
   }
 
   private appendDisplayIfMissing(session: Session, event: QQChatDisplayEvent): void {
-    if (session.events.some(item => item.type === 'qqchat/message' && item.data.messageId === event.messageId)) return
+    if (session.snapshotEvents().some(item => item.type === 'qqchat/message' && item.data.messageId === event.messageId)) return
     // Keep this on the public Session.append signature. Official DSH releases
     // do not yet expose the optional ignorable envelope marker; if an older
     // DSH cannot restore this plugin-only event, ensureAgent falls back to a
@@ -380,7 +372,7 @@ export class DshQQBridge {
   }
 
   private appendOwnerMessageIfMissing(session: Session, event: QQChatDisplayEvent): void {
-    if (session.events.some(item => {
+    if (session.snapshotEvents().some(item => {
       if (item.type !== 'user/message') return false
       const source = item.data.source as unknown as { messageId?: string }
       return source.messageId === event.messageId
@@ -556,7 +548,7 @@ export class DshQQBridge {
       const available = await presets.list()
       return { kind: 'success', text: available.length ? `可用 Agent Preset：\n${available.map(preset => `/qqpreset ${preset.id}`).join('\n')}` : '当前没有可用 Agent Preset。' }
     }
-    if (agent.session.events.some(event => event.type === 'turn/start')) {
+    if (agent.session.snapshotEvents().some(event => event.type === 'turn/start')) {
       return { kind: 'error', text: '当前 Session 已经开始对话，DSH 不允许更换 Agent Preset。请先使用 /qqnew 开启新 Session。' }
     }
     try {
@@ -574,8 +566,9 @@ export class DshQQBridge {
 
   private statusCommand(agent: AgentHandle['agent']): CommandResult {
     const current = this.selection(agent)?.current
-    const messages = agent.session.events.filter(event => event.type === 'user/message' || event.type === 'assistant/message').length
-    const last = agent.session.events.at(-1)
+    const events = agent.session.snapshotEvents()
+    const messages = events.filter(event => event.type === 'user/message' || event.type === 'assistant/message').length
+    const last = events.at(-1)
     return {
       kind: 'success',
       text: ['📊 Session 状态', `Session：${String(agent.id)}`, `状态：${agent.status === 'running' ? '生成中' : '空闲'}`, `模型：${current ? `${current.provider}/${current.model}` : '未知'}`, `消息数：${messages}`, `最后事件：${last?.type || '无'}`].join('\n'),

package/src/session/memory-snapshot.ts

@@ -12,7 +12,7 @@ export interface MemorySnapshotEvent {
   type?: string
   time?: number
   data?: {
-    source?: { kind?: string; plugin?: string }
+    source?: { kind?: string; plugin?: string; sections?: readonly { name?: string; text?: string }[] }
     content?: readonly { type?: string; text?: string }[]
   }
 }
@@ -32,8 +32,11 @@ export function restoreMemorySnapshotState(events: readonly MemorySnapshotEvent[
   for (let index = events.length - 1; index >= 0; index -= 1) {
     const event = events[index]
     if (!event) continue
-    if (event.type !== 'user/message' || event.data?.source?.kind !== 'plugin' || event.data.source.plugin !== sourcePlugin) continue
-    const block = event.data.content?.length === 1 ? event.data.content[0] : undefined
+    const source = event.data?.source
+    if (event.type !== 'user/message' || source?.kind !== 'plugin' || source.plugin !== sourcePlugin) continue
+    if (!source.sections?.some(section => section.name === 'qq-chat-context')) continue
+    const content = event.data?.content
+    const block = content?.length === 1 ? content[0] : undefined
     if (block?.type !== 'text' || typeof block.text !== 'string') continue
     return { hash: memorySnapshotHash(block.text), lastInjectedAt: Number(event.time) || 0, stale: lastCompactionAt > (Number(event.time) || 0) }
   }

package/src/session/runtime.ts

@@ -29,6 +29,7 @@ export class QQChatRuntime {
   ) {}
 
   async start(): Promise<void> {
+    await this.bridge.attachMappedSessionsToWorkspace()
     for (const account of this.db.enabledAccounts()) this.startGateway(account)
     this.outboxTimer = setInterval(() => void this.flushOutbox(), 3000)
     this.outboxTimer.unref?.()
@@ -58,6 +59,7 @@ export class QQChatRuntime {
 
   updateSettings(patch: QQChatRuntimeSettingsPatch): QQChatRuntimeSettings {
     if (patch.memoryEnabled !== undefined) this.db.setSetting('memoryEnabled', Boolean(patch.memoryEnabled))
+    if (patch.memoryMemberBatchEnabled !== undefined) this.db.setSetting('memoryMemberBatchEnabled', Boolean(patch.memoryMemberBatchEnabled))
     if (patch.groupReceiveMode !== undefined) {
       if (!isGroupReceiveMode(patch.groupReceiveMode)) throw new Error('无效的群聊接收模式')
       this.db.setSetting('groupReceiveMode', patch.groupReceiveMode)
@@ -120,7 +122,10 @@ export class QQChatRuntime {
       content: text, quotedText: '', mentioned: false, createdAt: Date.now(),
     }, row, true)
     if (this.settings().memoryEnabled) {
-      if (chatType === 'group') this.memory.schedule(Number(row.id))
+      if (chatType === 'group') {
+        this.memory.schedule(Number(row.id))
+        if (settings.memoryMemberBatchEnabled) this.memory.scheduleGroupMembers(Number(row.id))
+      }
       else this.memory.scheduleMember(Number(row.id))
     }
     this.logger.info?.(`[dsh-qqchat] active ${chatType} message sent to ${shortId(targetId)}`)
@@ -241,8 +246,10 @@ export class QQChatRuntime {
       quotedText: message.quotedText, mentioned: message.mentioned, createdAt: Date.now(), attachments: publicAttachments(ownAttachments), quote: safeQuote,
     }
       if (settings.memoryEnabled) {
-        if (group) this.memory.schedule(Number(group.id))
-        else this.memory.scheduleMember(Number(member.id))
+        if (group) {
+          this.memory.schedule(Number(group.id))
+          if (settings.memoryMemberBatchEnabled) this.memory.scheduleGroupMembers(Number(group.id))
+        }
       }
 
     if (!shouldReply) {
@@ -279,7 +286,10 @@ export class QQChatRuntime {
         memberId: message.chatType === 'c2c' ? member.id : undefined, direction: 'outbound', content: reply, mentioned: false,
       })
     if (settings.memoryEnabled) {
-      if (group) this.memory.schedule(Number(group.id))
+      if (group) {
+        this.memory.schedule(Number(group.id))
+        if (settings.memoryMemberBatchEnabled) this.memory.scheduleGroupMembers(Number(group.id))
+      }
       else this.memory.scheduleMember(Number(member.id))
     }
     } catch (error) {