dsh-qqchat 0.2.5 → 0.2.6

package/README.en.md

@@ -6,8 +6,8 @@
 
 <p>
   <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="MIT License"></a>
-  <img src="https://img.shields.io/badge/DSH-0.1.1--rc.2-6f42c1.svg" alt="DSH 0.1.1-rc.2">
-  <img src="https://img.shields.io/badge/QQChat-0.2.3-2ea44f.svg" alt="QQChat 0.2.3">
+  <img src="https://img.shields.io/badge/DSH-0.1.6--alpha.1-6f42c1.svg" alt="DSH 0.1.6-alpha.1">
+  <img src="https://img.shields.io/badge/QQChat-0.2.6-2ea44f.svg" alt="QQChat 0.2.6">
   <img src="https://img.shields.io/badge/TypeScript-5.x-3178c6.svg" alt="TypeScript">
 </p>
 
@@ -18,7 +18,7 @@
 
 <p><em>Chat in QQ, then view the complete Session, memory and tool activity in DSH Web.</em></p>
 
-<p>This release is verified against DSH <code>0.1.1-rc.2</code>. Install the plugin as-is; no DSH source patch or rebuild is required.</p>
+<p>This release is verified against DSH <code>0.1.6-alpha.1</code>. Install the plugin as-is; no DSH source patch or rebuild is required.</p>
 
 `dsh-qqchat` is an official QQ Bot plugin for [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness). It maps QQ groups and direct chats to ordinary DSH Sessions and uses DSH's native Conversation, Agent, command and tool surfaces.
 
@@ -126,7 +126,8 @@ npx @deepseek-ai/dsh plugin --profile qqchat add @deepseek-ai/dsh-web-app dsh-qq
 npx @deepseek-ai/dsh --profile qqchat
 ```
 
-Git installs build TypeScript through `prepare`. For local development:
+Git installs use the committed `lib/` runtime artifacts, so they do not need to run
+an install-time build. For local development:
 
 ```bash
 git clone git@github.com:Coffeiz/dsh-qqchat.git

package/README.md

@@ -6,8 +6,8 @@
 
 <p>
   <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="MIT License"></a>
-  <img src="https://img.shields.io/badge/DSH-0.1.1--rc.2-6f42c1.svg" alt="DSH 0.1.1-rc.2">
-  <img src="https://img.shields.io/badge/QQChat-0.2.3-2ea44f.svg" alt="QQChat 0.2.3">
+  <img src="https://img.shields.io/badge/DSH-0.1.6--alpha.1-6f42c1.svg" alt="DSH 0.1.6-alpha.1">
+  <img src="https://img.shields.io/badge/QQChat-0.2.6-2ea44f.svg" alt="QQChat 0.2.6">
   <img src="https://img.shields.io/badge/TypeScript-5.x-3178c6.svg" alt="TypeScript">
 </p>
 
@@ -19,7 +19,7 @@
 
 <p><em>dsh-qqchat 是 DeepSeek Harness（DSH）的 QQ Bot 插件，支持 QQ 群聊、私聊、会话隔离、记忆系统和 DSH 原生命令。</em></p>
 
-<p>当前版本基于 DSH <code>0.1.1-rc.2</code> 验证，安装插件即可使用，无需修改或重新构建 DSH。</p>
+<p>当前版本基于 DSH <code>0.1.6-alpha.1</code> 验证，安装插件即可使用，无需修改或重新构建 DSH。</p>
 
 > 本项目是一个 Vibe Coding 项目，代码质量和工程完整性可能需要改进。如果你发现问题或有更好的实现建议，欢迎提交 [Issue](https://github.com/Coffeiz/dsh-qqchat/issues) 或 [Pull Request](https://github.com/Coffeiz/dsh-qqchat/pulls)。
 

package/client-src/plugin.cts

@@ -3,12 +3,12 @@ import type { Ctx } from './shared.cjs'
 import { QQSettings } from './settings.cjs'
 import { QQSessionUtility, QQTranscriptNode, createQQMessageDefinition } from './workspace.cjs'
 
-exports.inject = ['slots', 'connection', 'conversationEvents'] as const
+exports.inject = ['slots', 'connection', 'uiConversation'] 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.uiConversation.events.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))
   ctx.slots.inject('conversation.chat.node', () => ctx.slots.register({ name: 'conversation.chat.node', key: 'qqchat-message' }, QQTranscriptNode))

package/client-src/shared.cts

@@ -29,11 +29,11 @@ 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 UiConversation { events: { register(definition: Record<string, unknown>): unknown } }
 export interface Ctx {
   connection: { rpc: Rpc }
   sessions: SessionsService
-  conversationEvents: ConversationEvents
+  uiConversation: UiConversation
   effect(fn: () => (() => void) | void, label: string): unknown
   slots: SlotRegistry
 }

package/cordis.patch.yml

@@ -5,3 +5,8 @@
       name: dsh-qqchat
       config:
         dataDir: !!js dshHomePath('plugins/dsh-qqchat')
+
+# DSH 0.1.6's Connection RPC registry owns route lifetimes on the
+# connection fiber, so that fiber must also receive the Web server service.
+- id: connection
+  inject: [webRuntime, webServer]

package/docs/ARCHITECTURE.en.md

@@ -339,7 +339,7 @@ client-src/*.cts
 tests/*.test.ts
 ```
 
-The Host is built with `tsc`. The Client is compiled to temporary CJS and then wrapped by `scripts/wrap-client.mjs` as a DSH Client factory. `lib/` is generated output rather than source truth.
+The Host is built with `tsc`. The Client is compiled to temporary CJS and then wrapped by `scripts/wrap-client.mjs` as a DSH Client factory. `lib/` is generated release output committed with fixed revisions so DSH Store can find the runtime entry without executing third-party install scripts; source remains the implementation truth.
 
 ## Development and security documentation
 

package/docs/ARCHITECTURE.md

@@ -401,7 +401,8 @@ tests/*.test.ts
 
 Host 使用 `tsc`；Client 编译到临时 CJS 后由 `scripts/wrap-client.mjs` 包装成 DSH Client factory。
 
-`lib/` 是生成物，不作为源码真相。
+`lib/` 是由源码生成的发布产物，并随固定 Commit 提交，以便 DSH Store 无需执行
+第三方安装脚本即可找到运行入口；源码仍是实现真相。
 
 ## 开发与安全文档
 

package/docs/DEVELOPMENT.md

@@ -60,7 +60,9 @@ client-src/*.cts      -> 临时 CJS       Client
 临时 CJS              -> lib/client.js  DSH ModuleLoader factory
 ```
 
-`lib/` 和临时 Client 构建目录是生成物，不是源码真相。
+`lib/` 是由构建生成的发布产物，同时提交到仓库以支持 DSH Store 从固定 Commit
+直接安装；修改源码后发布前必须重新构建并检查 `lib/` 的变更。临时 Client
+构建目录仍是本地生成物，不提交。
 
 ## 启动 DSH Web
 

package/docs/STREAMING.md

@@ -11,7 +11,7 @@
 推荐采用以下结构：
 
 ```text
-DSH assistant/chunk
+DSH `agent/assistant-stream` 的 chunk frame
   -> StreamingWriter
   -> 累计完整文本
   -> 节流定时器
@@ -118,7 +118,7 @@ interface StreamingWriterState {
 
 ### 2. 累计全文，不累计分片
 
-DSH 的 `assistant/chunk` 通常是增量文本：
+DSH 的 `agent/assistant-stream` chunk frame 通常携带增量文本：
 
 ```text
 "你好"

package/lib/client.js

@@ -6,12 +6,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const shared_cjs_1 = require("./shared.cjs");
 const settings_cjs_1 = require("./settings.cjs");
 const workspace_cjs_1 = require("./workspace.cjs");
-exports.inject = ['slots', 'connection', 'conversationEvents'];
+exports.inject = ['slots', 'connection', 'uiConversation'];
 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.uiConversation.events.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));
     ctx.slots.inject('conversation.session.header.utilities', () => ctx.slots.register({ name: 'conversation.session.header.utilities', id: 'qqchat-memory', order: 30, inject: () => ({ rpc: ctx.connection.rpc }) }, workspace_cjs_1.QQSessionUtility));

package/lib/index.d.ts

@@ -1,14 +1,14 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { QQChatConfigInput } from './types.js';
 export declare const name = "dsh-qqchat";
-export declare const inject: readonly ["connection", "agents", "agentDefaultModel", "commands", "llm", "tools", "workspaceRegistry"];
+export declare const inject: readonly ["connection", "agents", "agentDefaultModel", "commands", "llm", "tools", "webServer", "workspaceRegistry"];
 export declare function apply(ctx: Context, inputConfig?: QQChatConfigInput): void;
 export type { QQChatConfig, QQChatConfigInput } from './types.js';
 export { QQChatDatabase } from './storage/db.js';
 export { normalizeQQDispatch } from './gateway/normalize.js';
 declare const _default: {
     name: string;
-    inject: readonly ["connection", "agents", "agentDefaultModel", "commands", "llm", "tools", "workspaceRegistry"];
+    inject: readonly ["connection", "agents", "agentDefaultModel", "commands", "llm", "tools", "webServer", "workspaceRegistry"];
     apply: typeof apply;
 };
 export default _default;

package/lib/index.js

@@ -13,7 +13,7 @@ import { QQChatRuntime } from './session/runtime.js';
 import { registerQQChatSessionEventType } from './session/registration.js';
 const qqChatSessionEventRegistrations = await registerQQChatSessionEventType();
 export const name = 'dsh-qqchat';
-export const inject = ['connection', 'agents', 'agentDefaultModel', 'commands', 'llm', 'tools', 'workspaceRegistry'];
+export const inject = ['connection', 'agents', 'agentDefaultModel', 'commands', 'llm', 'tools', 'webServer', 'workspaceRegistry'];
 export function apply(ctx, inputConfig = {}) {
     const config = resolveConfig(inputConfig);
     mkdirSync(config.dataDir, { recursive: true, mode: 0o700 });
@@ -29,7 +29,7 @@ export function apply(ctx, inputConfig = {}) {
     const media = new QQMediaStore(db, ctx, logger);
     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 runtime.start();

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

@@ -23,11 +23,13 @@ export declare class DshQQBridge {
     private readonly activeMediaReadable;
     private readonly memorySnapshots;
     private readonly disposeEvent;
+    private readonly disposeAssistantStream;
     private readonly disposeToolGate;
     private readonly disposeCommands;
     private readonly disposeImageTool;
     private readonly disposeMediaTools;
     constructor(ctx: Context, db: QQChatDatabase, memory: MemoryEngine, config: QQChatConfig, logger?: LoggerLike);
+    attachMappedSessionsToWorkspace(): Promise<void>;
     dispose(): Promise<void>;
     ensureChatSession(chatType: ChatType, row: GroupRow | MemberRow): Promise<string>;
     recordTranscript(event: QQChatDisplayEvent, row: GroupRow | MemberRow, createSession?: boolean): Promise<string | undefined>;
@@ -37,6 +39,7 @@ export declare class DshQQBridge {
     private restoreMemorySnapshot;
     private ensureAgent;
     private isArchived;
+    private attachToWorkspace;
     private rememberRoute;
     private appendDisplayIfMissing;
     private appendOwnerMessageIfMissing;

package/lib/session/agent-bridge.js

@@ -1,7 +1,7 @@
 import { randomUUID } from 'node:crypto';
 import { createRequire } from 'node:module';
 import { installModelSelection } 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 { SessionId } from '@deepseek-ai/dsh-session';
 import '../shared/augmentations.js';
@@ -12,7 +12,10 @@ import { dispatchQQCommand, qqCommandText, slashCommandName } from '../commands/
 import { MEMORY_SNAPSHOT_TTL_MS, memorySnapshotHash, restoreMemorySnapshotState, shouldRefreshMemorySnapshot } from './memory-snapshot.js';
 const DSH_RUNTIME_CONTEXT_SOURCE = '@deepseek-ai/dsh-system-prompt';
 export function resolveQQSessionPreset(header, events) {
-    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']);
 const packageMetadata = createRequire(import.meta.url)('../../package.json');
@@ -34,6 +37,7 @@ export class DshQQBridge {
     activeMediaReadable = new Map();
     memorySnapshots = new Map();
     disposeEvent;
+    disposeAssistantStream;
     disposeToolGate;
     disposeCommands;
     disposeImageTool;
@@ -45,6 +49,11 @@ export class DshQQBridge {
         this.config = config;
         this.logger = logger;
         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) => {
             const agent = exec.agent;
             if (!agent)
@@ -71,8 +80,19 @@ export class DshQQBridge {
         this.disposeMediaTools = registerQQMediaTools(ctx, db, canReadMedia);
         this.disposeCommands = this.registerCommands();
     }
+    async attachMappedSessionsToWorkspace() {
+        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() {
         this.disposeEvent();
+        this.disposeAssistantStream();
         this.disposeToolGate();
         this.disposeImageTool();
         this.disposeMediaTools();
@@ -212,13 +232,6 @@ export class DshQQBridge {
                 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)
@@ -250,7 +263,7 @@ export class DshQQBridge {
         this.memorySnapshots.set(sessionId, previous);
     }
     restoreMemorySnapshot(session) {
-        return restoreMemorySnapshotState(session.events, DSH_RUNTIME_CONTEXT_SOURCE);
+        return restoreMemorySnapshotState(session.snapshotEvents(), DSH_RUNTIME_CONTEXT_SOURCE);
     }
     async ensureAgent(chatType, row) {
         let sessionId = this.db.getChatSession(chatType, Number(row.id));
@@ -273,6 +286,7 @@ export class DshQQBridge {
             if (live) {
                 this.ensureSelection(live);
                 this.ensureTitle(live.session, chatType, row);
+                await this.attachToWorkspace(sessionId);
                 this.rememberRoute(chatType, row, live, sessionId);
                 return { agent: live, sessionId };
             }
@@ -280,6 +294,7 @@ export class DshQQBridge {
             if (resumed) {
                 this.ensureSelection(resumed.agent);
                 this.ensureTitle(resumed.agent.session, chatType, row);
+                await this.attachToWorkspace(sessionId);
                 this.rememberRoute(chatType, row, resumed.agent, sessionId);
                 return { agent: resumed.agent, sessionId };
             }
@@ -297,6 +312,7 @@ 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);
         return { agent: handle.agent, sessionId };
@@ -305,6 +321,18 @@ export class DshQQBridge {
         const registry = this.ctx.workspaceRegistry;
         return registry?.archivedSessionIds.includes(sessionId) ?? false;
     }
+    async attachToWorkspace(sessionId) {
+        const registry = this.ctx.workspaceRegistry;
+        if (!registry)
+            return;
+        try {
+            const workspace = await registry.resolveByPath(process.cwd());
+            await workspace?.attachSession(SessionId(sessionId));
+        }
+        catch (error) {
+            this.logger.warn?.(`[dsh-qqchat] QQ session ${sessionId} 未能挂载到当前工作区: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
     rememberRoute(chatType, row, agent, sessionId) {
         const provider = agent.options.provider || this.config.provider;
         const model = agent.options.model || this.config.model;
@@ -316,7 +344,7 @@ export class DshQQBridge {
             this.memory.setMemberRoute(Number(row.id), provider, model, sessionId);
     }
     appendDisplayIfMissing(session, event) {
-        if (session.events.some(item => item.type === 'qqchat/message' && item.data.messageId === event.messageId))
+        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
@@ -325,7 +353,7 @@ export class DshQQBridge {
         session.append('qqchat/message', displayEventPayload(event));
     }
     appendOwnerMessageIfMissing(session, event) {
-        if (session.events.some(item => {
+        if (session.snapshotEvents().some(item => {
             if (item.type !== 'user/message')
                 return false;
             const source = item.data.source;
@@ -506,7 +534,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 {
@@ -524,8 +552,9 @@ export class DshQQBridge {
     }
     statusCommand(agent) {
         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/lib/session/runtime.js

@@ -28,6 +28,7 @@ export class QQChatRuntime {
         this.media = media;
     }
     async start() {
+        await this.bridge.attachMappedSessionsToWorkspace();
         for (const account of this.db.enabledAccounts())
             this.startGateway(account);
         this.outboxTimer = setInterval(() => void this.flushOutbox(), 3000);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-qqchat",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "DeepSeek Harness 的 QQ 私聊/群聊插件，支持扫码授权、原生 Session、群记忆与工具权限。",
   "type": "module",
   "license": "MIT",
@@ -39,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": {
@@ -67,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": {
@@ -75,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",
@@ -94,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"
       ]
@@ -102,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/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,7 +38,7 @@ 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 runtime.start()

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'
@@ -41,12 +41,15 @@ interface SessionPersistenceService { inspect(id: SessionId): Promise<{ meta: Se
 interface SessionTitleService { get(session: Session): unknown; rename(session: Session, title: string): unknown }
 interface WorkspaceRegistryService {
   archivedSessionIds: readonly string[]
+  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'])
@@ -65,6 +68,7 @@ export class DshQQBridge {
   private readonly activeMediaReadable = new Map<string, boolean>()
   private readonly memorySnapshots = new Map<string, MemorySnapshotState>()
   private readonly disposeEvent: () => void
+  private readonly disposeAssistantStream: () => void
   private readonly disposeToolGate: () => void
   private readonly disposeCommands: () => void
   private readonly disposeImageTool: () => void
@@ -78,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()
@@ -100,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()
@@ -235,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 })
@@ -271,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 }> {
@@ -292,6 +305,7 @@ export class DshQQBridge {
       if (live) {
         this.ensureSelection(live)
         this.ensureTitle(live.session, chatType, row)
+        await this.attachToWorkspace(sessionId)
         this.rememberRoute(chatType, row, live, sessionId)
         return { agent: live, sessionId }
       }
@@ -299,6 +313,7 @@ export class DshQQBridge {
       if (resumed) {
         this.ensureSelection(resumed.agent)
         this.ensureTitle(resumed.agent.session, chatType, row)
+        await this.attachToWorkspace(sessionId)
         this.rememberRoute(chatType, row, resumed.agent, sessionId)
         return { agent: resumed.agent, sessionId }
       }
@@ -317,6 +332,7 @@ 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)
     return { agent: handle.agent, sessionId }
@@ -327,6 +343,17 @@ export class DshQQBridge {
     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
+    try {
+      const workspace = await registry.resolveByPath(process.cwd())
+      await workspace?.attachSession(SessionId(sessionId))
+    } catch (error) {
+      this.logger.warn?.(`[dsh-qqchat] QQ session ${sessionId} 未能挂载到当前工作区: ${error instanceof Error ? error.message : String(error)}`)
+    }
+  }
+
   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
@@ -336,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
@@ -345,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
@@ -521,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 {
@@ -539,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/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?.()