dsh-qqchat 0.2.3 → 0.2.4

package/README.en.md

@@ -220,7 +220,7 @@ QQ Sessions use DSH's native Agent Preset mechanism. The preset configured for t
 ## Notes
 
 - An official QQ Bot is required; personal QQ account login is not supported.
-- `0.2.1` is still being refined; test with a dedicated Bot and group first.
+- `0.2.2` is still being refined; test with a dedicated Bot and group first.
 - Rich media, full QQ emoji handling and some complex message formats may require compatibility mode.
 - Uninstalling the plugin does not automatically delete saved chat or memory data.
 

package/README.md

@@ -202,7 +202,7 @@ QQ Session 使用 DSH 原生的 Agent Preset 机制。插件配置中的 preset
 ## 注意事项
 
 - 需要 QQ 官方 Bot，不支持个人 QQ 账号登录。
-- `0.2.1` 仍在持续完善，建议先在测试 Bot 和测试群中使用。
+- `0.2.2` 仍在持续完善，建议先在测试 Bot 和测试群中使用。
 - 富媒体、完整 QQ 表情和部分复杂消息格式可能需要使用兼容模式。
 - 卸载插件不会自动删除已经保存的聊天和记忆数据。
 

package/client-src/plugin.cts

@@ -1,4 +1,4 @@
-import { installStyles, setQQRpc } from './shared.cjs'
+import { installQQSettingsIcon, installStyles, setQQRpc } from './shared.cjs'
 import type { Ctx } from './shared.cjs'
 import { QQSettings } from './settings.cjs'
 import { QQSessionUtility, QQTranscriptNode, createQQMessageDefinition } from './workspace.cjs'
@@ -7,6 +7,7 @@ exports.inject = ['slots', 'connection', 'conversationEvents'] as const
 exports.apply = function apply(ctx: Ctx) {
   setQQRpc(ctx.connection.rpc)
   ctx.effect(installStyles, 'dsh-qqchat: client styles')
+  ctx.effect(installQQSettingsIcon, 'dsh-qqchat: QQ settings icon')
   ctx.conversationEvents.register(createQQMessageDefinition())
 
   ctx.slots.inject('settings.section', () => ctx.slots.register({ name: 'settings.section', id: 'qqchat', order: 35, label: () => 'QQ Chat', inject: () => ({ rpc: ctx.connection.rpc }) }, QQSettings))

package/client-src/shared.cts

@@ -55,6 +55,47 @@ export interface SidebarActionProps { wide: boolean; rpc: Rpc; sessions: Session
 export const CHANNEL = '/qqchat'
 const STYLE_ID = 'dsh-qqchat/client-ui-v2'
 
+const QQ_ICON_PATH = 'M17.5359 12.5144L16.8402 10.7175C16.8408 10.6968 16.8494 10.3429 16.8494 10.1604C16.8494 7.08792 15.448 4.0003 12.0012 4C8.55459 4.0003 7.15292 7.08792 7.15292 10.1604C7.15292 10.3429 7.16151 10.6968 7.16209 10.7175L6.4667 12.5144C6.27608 13.0285 6.08776 13.564 5.94988 14.0232C5.29262 16.2126 5.50559 17.1186 5.66783 17.139C6.01581 17.1823 7.02221 15.4908 7.02221 15.4908C7.02221 16.4704 7.5095 17.7487 8.56405 18.6719C8.16963 18.7976 7.68635 18.9911 7.37564 19.2284C7.09645 19.442 7.13142 19.6594 7.18158 19.7473C7.40258 20.1329 10.9713 19.9935 12.0017 19.8733C13.0319 19.9935 16.6009 20.1329 16.8216 19.7473C16.872 19.6594 16.9067 19.442 16.6275 19.2284C16.3168 18.9911 15.8333 18.7976 15.4386 18.6716C16.4928 17.7487 16.9801 16.4704 16.9801 15.4908C16.9801 15.4908 17.9868 17.1823 18.3348 17.139C18.4967 17.1186 18.7131 16.2108 18.0524 14.0232C17.9125 13.56 17.7265 13.0285 17.5359 12.5144ZM18.5574 20.7407C18.1843 21.3926 17.7237 21.6334 17.1187 21.7981C16.8792 21.8633 16.621 21.9056 16.325 21.936C15.8844 21.9814 15.3392 22.001 14.712 22C13.786 21.9985 12.693 21.9491 12.0017 21.884C11.3103 21.9491 10.2173 21.9985 9.29129 22C8.66414 22.001 8.11889 21.9814 7.67832 21.936C7.38236 21.9056 7.12409 21.8633 6.88467 21.7981C6.27994 21.6335 5.81954 21.393 5.44496 20.7393C5.15165 20.2258 5.07747 19.6406 5.20612 19.0866C4.61376 18.9546 4.20483 18.6045 3.92733 18.1757C3.77911 17.9466 3.68408 17.7127 3.61845 17.4663C3.53001 17.1344 3.49486 16.7666 3.50184 16.3601C3.51532 15.5749 3.68902 14.5984 4.03435 13.4481C4.17427 12.9821 4.3614 12.4396 4.6015 11.7926L5.15467 10.3632C5.1536 10.287 5.15292 10.2154 5.15292 10.1604C5.15292 5.6047 7.58875 2.00038 12.0013 2C16.4138 2.00038 18.8494 5.60454 18.8494 10.1604C18.8494 10.2154 18.8487 10.2869 18.8477 10.3631L19.401 11.7923L19.4112 11.8191C19.636 12.4254 19.8242 12.9722 19.967 13.445C20.3145 14.5956 20.4889 15.5735 20.5018 16.361C20.5085 16.768 20.4728 17.1365 20.3837 17.4689C20.3178 17.7148 20.2228 17.9483 20.0746 18.1768C19.7976 18.6041 19.3905 18.9532 18.7974 19.0862C18.9266 19.6411 18.8523 20.2274 18.5574 20.7407Z'
+
+/** Temporarily replaces DSH's fallback settings glyph for the QQ Chat row. */
+export function installQQSettingsIcon(): () => void {
+  const originals = new Map<HTMLButtonElement, SVGElement>()
+  const apply = () => {
+    for (const button of Array.from(document.querySelectorAll('button'))) {
+      const label = button.querySelector('span[class$="_navLabel"]')
+      if (label?.textContent?.trim() !== 'QQ Chat') continue
+      if (button.querySelector('[data-dsh-qqchat-icon]')) continue
+      const icon = button.querySelector('svg[class$="_navIcon"]')
+      if (!icon) continue
+      originals.set(button, icon.cloneNode(true) as SVGElement)
+      icon.remove()
+      const replacement = document.createElementNS('http://www.w3.org/2000/svg', 'svg')
+      replacement.setAttribute('width', '16')
+      replacement.setAttribute('height', '16')
+      replacement.setAttribute('viewBox', '0 0 24 24')
+      replacement.setAttribute('fill', 'currentColor')
+      replacement.setAttribute('aria-hidden', 'true')
+      replacement.setAttribute('data-dsh-qqchat-icon', 'true')
+      replacement.classList.add('dsh-qqchat-nav-icon')
+      const path = document.createElementNS('http://www.w3.org/2000/svg', 'path')
+      path.setAttribute('d', QQ_ICON_PATH)
+      replacement.append(path)
+      button.insertBefore(replacement, label)
+    }
+  }
+  const observer = new MutationObserver(apply)
+  observer.observe(document.body, { childList: true, subtree: true })
+  apply()
+  return () => {
+    observer.disconnect()
+    for (const [button, original] of originals) {
+      const replacement = button.querySelector('[data-dsh-qqchat-icon]')
+      if (replacement) replacement.replaceWith(original)
+    }
+    originals.clear()
+  }
+}
+
 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)}

package/lib/client.js

@@ -10,6 +10,7 @@ exports.inject = ['slots', 'connection', 'conversationEvents'];
 exports.apply = function apply(ctx) {
     (0, shared_cjs_1.setQQRpc)(ctx.connection.rpc);
     ctx.effect(shared_cjs_1.installStyles, 'dsh-qqchat: client styles');
+    ctx.effect(shared_cjs_1.installQQSettingsIcon, 'dsh-qqchat: QQ settings icon');
     ctx.conversationEvents.register((0, workspace_cjs_1.createQQMessageDefinition)());
     ctx.slots.inject('settings.section', () => ctx.slots.register({ name: 'settings.section', id: 'qqchat', order: 35, label: () => 'QQ Chat', inject: () => ({ rpc: ctx.connection.rpc }) }, settings_cjs_1.QQSettings));
     ctx.slots.inject('conversation.chat.node', () => ctx.slots.register({ name: 'conversation.chat.node', key: 'qqchat-message' }, workspace_cjs_1.QQTranscriptNode));
@@ -249,6 +250,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.dateTime = exports.time = exports.initials = exports.short = exports.CHANNEL = exports.h = exports.useSyncExternalStore = exports.useState = exports.useMemo = exports.useEffect = exports.useCallback = exports.Menu = exports.Input = exports.Button = exports.React = void 0;
 exports.setQQRpc = setQQRpc;
 exports.getQQRpc = getQQRpc;
+exports.installQQSettingsIcon = installQQSettingsIcon;
 exports.installStyles = installStyles;
 exports.call = call;
 exports.Modal = Modal;
@@ -265,6 +267,49 @@ function setQQRpc(rpc) { qqRpc = rpc; }
 function getQQRpc() { return qqRpc; }
 exports.CHANNEL = '/qqchat';
 const STYLE_ID = 'dsh-qqchat/client-ui-v2';
+const QQ_ICON_PATH = 'M17.5359 12.5144L16.8402 10.7175C16.8408 10.6968 16.8494 10.3429 16.8494 10.1604C16.8494 7.08792 15.448 4.0003 12.0012 4C8.55459 4.0003 7.15292 7.08792 7.15292 10.1604C7.15292 10.3429 7.16151 10.6968 7.16209 10.7175L6.4667 12.5144C6.27608 13.0285 6.08776 13.564 5.94988 14.0232C5.29262 16.2126 5.50559 17.1186 5.66783 17.139C6.01581 17.1823 7.02221 15.4908 7.02221 15.4908C7.02221 16.4704 7.5095 17.7487 8.56405 18.6719C8.16963 18.7976 7.68635 18.9911 7.37564 19.2284C7.09645 19.442 7.13142 19.6594 7.18158 19.7473C7.40258 20.1329 10.9713 19.9935 12.0017 19.8733C13.0319 19.9935 16.6009 20.1329 16.8216 19.7473C16.872 19.6594 16.9067 19.442 16.6275 19.2284C16.3168 18.9911 15.8333 18.7976 15.4386 18.6716C16.4928 17.7487 16.9801 16.4704 16.9801 15.4908C16.9801 15.4908 17.9868 17.1823 18.3348 17.139C18.4967 17.1186 18.7131 16.2108 18.0524 14.0232C17.9125 13.56 17.7265 13.0285 17.5359 12.5144ZM18.5574 20.7407C18.1843 21.3926 17.7237 21.6334 17.1187 21.7981C16.8792 21.8633 16.621 21.9056 16.325 21.936C15.8844 21.9814 15.3392 22.001 14.712 22C13.786 21.9985 12.693 21.9491 12.0017 21.884C11.3103 21.9491 10.2173 21.9985 9.29129 22C8.66414 22.001 8.11889 21.9814 7.67832 21.936C7.38236 21.9056 7.12409 21.8633 6.88467 21.7981C6.27994 21.6335 5.81954 21.393 5.44496 20.7393C5.15165 20.2258 5.07747 19.6406 5.20612 19.0866C4.61376 18.9546 4.20483 18.6045 3.92733 18.1757C3.77911 17.9466 3.68408 17.7127 3.61845 17.4663C3.53001 17.1344 3.49486 16.7666 3.50184 16.3601C3.51532 15.5749 3.68902 14.5984 4.03435 13.4481C4.17427 12.9821 4.3614 12.4396 4.6015 11.7926L5.15467 10.3632C5.1536 10.287 5.15292 10.2154 5.15292 10.1604C5.15292 5.6047 7.58875 2.00038 12.0013 2C16.4138 2.00038 18.8494 5.60454 18.8494 10.1604C18.8494 10.2154 18.8487 10.2869 18.8477 10.3631L19.401 11.7923L19.4112 11.8191C19.636 12.4254 19.8242 12.9722 19.967 13.445C20.3145 14.5956 20.4889 15.5735 20.5018 16.361C20.5085 16.768 20.4728 17.1365 20.3837 17.4689C20.3178 17.7148 20.2228 17.9483 20.0746 18.1768C19.7976 18.6041 19.3905 18.9532 18.7974 19.0862C18.9266 19.6411 18.8523 20.2274 18.5574 20.7407Z';
+/** Temporarily replaces DSH's fallback settings glyph for the QQ Chat row. */
+function installQQSettingsIcon() {
+    const originals = new Map();
+    const apply = () => {
+        for (const button of Array.from(document.querySelectorAll('button'))) {
+            const label = button.querySelector('span[class$="_navLabel"]');
+            if (label?.textContent?.trim() !== 'QQ Chat')
+                continue;
+            if (button.querySelector('[data-dsh-qqchat-icon]'))
+                continue;
+            const icon = button.querySelector('svg[class$="_navIcon"]');
+            if (!icon)
+                continue;
+            originals.set(button, icon.cloneNode(true));
+            icon.remove();
+            const replacement = document.createElementNS('http://www.w3.org/2000/svg', 'svg');
+            replacement.setAttribute('width', '16');
+            replacement.setAttribute('height', '16');
+            replacement.setAttribute('viewBox', '0 0 24 24');
+            replacement.setAttribute('fill', 'currentColor');
+            replacement.setAttribute('aria-hidden', 'true');
+            replacement.setAttribute('data-dsh-qqchat-icon', 'true');
+            replacement.classList.add('dsh-qqchat-nav-icon');
+            const path = document.createElementNS('http://www.w3.org/2000/svg', 'path');
+            path.setAttribute('d', QQ_ICON_PATH);
+            replacement.append(path);
+            button.insertBefore(replacement, label);
+        }
+    };
+    const observer = new MutationObserver(apply);
+    observer.observe(document.body, { childList: true, subtree: true });
+    apply();
+    return () => {
+        observer.disconnect();
+        for (const [button, original] of originals) {
+            const replacement = button.querySelector('[data-dsh-qqchat-icon]');
+            if (replacement)
+                replacement.replaceWith(original);
+        }
+        originals.clear();
+    };
+}
 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)}

package/lib/index.js

@@ -31,7 +31,10 @@ export function apply(ctx, inputConfig = {}) {
     const runtime = new QQChatRuntime(ctx, db, api, auth, memory, bridge, config, logger, media);
     ctx.connection.rpc.handle('/qqchat', createQQChatRpc(runtime), { authority: 'loopback' });
     ctx.effect(() => {
-        void runtime.start().catch(error => logger.error?.(error));
+        void (async () => {
+            await bridge.ensureWorkspaceMembership();
+            await runtime.start();
+        })().catch(error => logger.error?.(error));
         return () => runtime.stop();
     }, 'dsh-qqchat runtime');
 }

package/lib/session/agent-bridge.d.ts

@@ -22,6 +22,7 @@ export declare class DshQQBridge {
     private readonly activeAttachments;
     private readonly activeMediaReadable;
     private readonly memorySnapshots;
+    private qqWorkspace?;
     private readonly disposeEvent;
     private readonly disposeToolGate;
     private readonly disposeCommands;
@@ -30,12 +31,15 @@ export declare class DshQQBridge {
     constructor(ctx: Context, db: QQChatDatabase, memory: MemoryEngine, config: QQChatConfig, logger?: LoggerLike);
     dispose(): Promise<void>;
     ensureChatSession(chatType: ChatType, row: GroupRow | MemberRow): Promise<string>;
+    ensureWorkspaceMembership(): Promise<void>;
     recordTranscript(event: QQChatDisplayEvent, row: GroupRow | MemberRow, createSession?: boolean): Promise<string | undefined>;
     reply(message: QQNormalizedMessage, group: GroupRow | undefined, member: MemberRow, attachments?: StoredAttachmentSummary[], onTextDelta?: (delta: string) => void, isOwner?: boolean): Promise<string>;
     private onSessionEvent;
     private injectMemorySnapshot;
     private restoreMemorySnapshot;
     private ensureAgent;
+    /** Keep all QQ sessions together in one DSH Workspace using the host API. */
+    private attachToQQWorkspace;
     private isArchived;
     private rememberRoute;
     private appendDisplayIfMissing;

package/lib/session/agent-bridge.js

@@ -33,6 +33,7 @@ export class DshQQBridge {
     activeAttachments = new Map();
     activeMediaReadable = new Map();
     memorySnapshots = new Map();
+    qqWorkspace;
     disposeEvent;
     disposeToolGate;
     disposeCommands;
@@ -97,6 +98,16 @@ export class DshQQBridge {
         const { sessionId } = await this.ensureAgent(chatType, row);
         return sessionId;
     }
+    async ensureWorkspaceMembership() {
+        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, row, createSession = false) {
         const existing = this.db.getChatSession(event.chatType, Number(row.id));
         if (!existing && !createSession)
@@ -274,6 +285,7 @@ export class DshQQBridge {
                 this.ensureSelection(live);
                 this.ensureTitle(live.session, chatType, row);
                 this.rememberRoute(chatType, row, live, sessionId);
+                await this.attachToQQWorkspace(sessionId);
                 return { agent: live, sessionId };
             }
             const resumed = await this.tryResume(sessionId);
@@ -281,6 +293,7 @@ export class DshQQBridge {
                 this.ensureSelection(resumed.agent);
                 this.ensureTitle(resumed.agent.session, chatType, row);
                 this.rememberRoute(chatType, row, resumed.agent, sessionId);
+                await this.attachToQQWorkspace(sessionId);
                 return { agent: resumed.agent, sessionId };
             }
         }
@@ -299,8 +312,30 @@ export class DshQQBridge {
         this.db.setChatSession(chatType, Number(row.id), 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. */
+    async attachToQQWorkspace(sessionId) {
+        const registry = this.ctx.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));
+        }
+        catch (error) {
+            this.logger.warn?.(`[dsh-qqchat] QQ session ${sessionId} 加入 Workspace 失败，将保留在未分组: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
     isArchived(sessionId) {
         const registry = this.ctx.workspaceRegistry;
         return registry?.archivedSessionIds.includes(sessionId) ?? false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-qqchat",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "DeepSeek Harness 的 QQ 私聊/群聊插件，支持扫码授权、原生 Session、群记忆与工具权限。",
   "type": "module",
   "license": "MIT",

package/src/index.ts

@@ -40,7 +40,10 @@ export function apply(ctx: Context, inputConfig: QQChatConfigInput = {}): void {
 
   ctx.connection.rpc.handle('/qqchat', createQQChatRpc(runtime), { authority: 'loopback' })
   ctx.effect(() => {
-    void runtime.start().catch(error => logger.error?.(error))
+    void (async () => {
+      await bridge.ensureWorkspaceMembership()
+      await runtime.start()
+    })().catch(error => logger.error?.(error))
     return () => runtime.stop()
   }, 'dsh-qqchat runtime')
 }

package/src/session/agent-bridge.ts

@@ -39,7 +39,11 @@ 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 WorkspaceRegistryService { archivedSessionIds: readonly string[] }
+interface WorkspaceEntity { attachSession(sessionId: SessionId): Promise<void> }
+interface WorkspaceRegistryService {
+  archivedSessionIds: readonly string[]
+  create(path: string, title?: string): Promise<WorkspaceEntity>
+}
 interface Composition { presetId?: string; setup?: AgentSetup }
 interface ActiveActor { chatType: ChatType; senderId: string }
 
@@ -62,6 +66,7 @@ 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 disposeToolGate: () => void
   private readonly disposeCommands: () => void
@@ -122,6 +127,16 @@ 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
@@ -291,6 +306,7 @@ export class DshQQBridge {
         this.ensureSelection(live)
         this.ensureTitle(live.session, chatType, row)
         this.rememberRoute(chatType, row, live, sessionId)
+        await this.attachToQQWorkspace(sessionId)
         return { agent: live, sessionId }
       }
       const resumed = await this.tryResume(sessionId)
@@ -298,6 +314,7 @@ export class DshQQBridge {
         this.ensureSelection(resumed.agent)
         this.ensureTitle(resumed.agent.session, chatType, row)
         this.rememberRoute(chatType, row, resumed.agent, sessionId)
+        await this.attachToQQWorkspace(sessionId)
         return { agent: resumed.agent, sessionId }
       }
     }
@@ -317,9 +334,29 @@ export class DshQQBridge {
     this.db.setChatSession(chatType, Number(row.id), 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> {
+    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))
+    } catch (error) {
+      this.logger.warn?.(`[dsh-qqchat] QQ session ${sessionId} 加入 Workspace 失败，将保留在未分组: ${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