@dcrays/dcgchat-test 0.3.35 → 0.3.37

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcrays/dcgchat-test",
-  "version": "0.3.35",
+  "version": "0.3.37",
   "type": "module",
   "description": "OpenClaw channel plugin for 书灵墨宝 (WebSocket)",
   "main": "index.ts",

package/src/agent.ts

@@ -0,0 +1,204 @@
+import axios from 'axios'
+/** @ts-ignore */
+import unzipper from 'unzipper'
+import { pipeline } from 'stream/promises'
+import fs from 'fs'
+import path from 'path'
+import { getWorkspaceDir } from './utils/global.js'
+import { getWsConnection } from './utils/global.js'
+import { dcgLogger } from './utils/log.js'
+import { isWsOpen } from './transport.js'
+import { sendMessageToGateway } from './gateway/socket.js'
+import { decodeZipEntryPath } from './utils/zipPath.js'
+
+type IAgentParams = {
+  url: string
+  agent_code: string
+  agent_name: string
+  agent_description: string
+}
+
+function sendEvent(msgContent: Record<string, any>) {
+  const ws = getWsConnection()
+  if (isWsOpen()) {
+    ws?.send(
+      JSON.stringify({
+        messageType: 'openclaw_bot_event',
+        source: 'client',
+        content: msgContent
+      })
+    )
+    dcgLogger(`agent安装: ${JSON.stringify(msgContent)}`)
+  }
+}
+
+interface ICreateAgentParams {
+  code: string
+  workspace: string
+  name?: string
+  description?: string
+  msgContent?: Record<string, any>
+}
+
+/** 若 workspace-${code}/agent 存在，则复制到 agents/${code}/agent */
+function copyAgentsFiles(code: string) {
+  const workspacePath = getWorkspaceDir()
+  if (!workspacePath) return
+  const workspaceDir = path.join(workspacePath, '../', `workspace-${code}`)
+  const agentDir = path.join(workspacePath, '../', `agents/${code}`)
+  const sourceAgent = path.join(workspaceDir, 'agent')
+  try {
+    if (!fs.existsSync(sourceAgent)) return
+    if (!fs.statSync(sourceAgent).isDirectory()) return
+    fs.mkdirSync(agentDir, { recursive: true })
+    const dest = path.join(agentDir, 'agent')
+    if (fs.existsSync(dest)) {
+      fs.rmSync(dest, { recursive: true, force: true })
+    }
+    fs.cpSync(sourceAgent, dest, { recursive: true })
+  } catch (err: unknown) {
+    dcgLogger(`copyAgentsFiles failed: ${String(err)}`, 'error')
+  }
+}
+
+export async function onCreateAgent(params: Record<string, any>) {
+  const { code, name, description } = params
+  try {
+    await sendMessageToGateway(JSON.stringify({ method: 'agents.create', params: { name: code, workspace: code } }))
+  } catch (err: unknown) {
+    dcgLogger(`agents.create failed: ${String(err)}`, 'error')
+  }
+  // Update config.name to the user-supplied display name (may contain CJK, spaces, etc.)
+  try {
+    await sendMessageToGateway(JSON.stringify({ method: 'agents.update', params: { name: name, agentId: code } }))
+  } catch (err: unknown) {
+    dcgLogger(`agents.update failed: ${String(err)}`, 'error')
+  }
+  if (description?.trim()) {
+    try {
+      await sendMessageToGateway(
+        JSON.stringify({
+          method: 'agents.files.set',
+          params: { agentId: code, name: 'IDENTITY.md', content: description.trim() }
+        })
+      )
+    } catch {
+      // Non-fatal
+    }
+  }
+  if (name?.trim()) {
+    try {
+      await sendMessageToGateway(
+        JSON.stringify({
+          method: 'agents.files.set',
+          params: { agentId: code, name: 'USER.md', content: name.trim() }
+        })
+      )
+    } catch {
+      // Non-fatal
+    }
+  }
+  copyAgentsFiles(code)
+  sendEvent({ ...params, status: 'ok' })
+}
+
+export async function createAgent(msgContent: Record<string, any>) {
+  const { url, code } = msgContent
+  if (!url || !code) {
+    dcgLogger(`createAgent failed empty url&code: ${JSON.stringify(msgContent)}`, 'error')
+    sendEvent({ ...msgContent, status: 'fail' })
+    return
+  }
+  const workspacePath = getWorkspaceDir()
+  const workspaceDir = path.join(workspacePath, '../', `workspace-${code}`)
+
+  // 如果目标目录已存在，先删除
+  if (fs.existsSync(workspaceDir)) {
+    fs.rmSync(workspaceDir, { recursive: true, force: true })
+  }
+
+  try {
+    // 下载 zip 文件
+    const response = await axios({
+      method: 'get',
+      url,
+      responseType: 'stream'
+    })
+    // 创建目标目录
+    fs.mkdirSync(workspaceDir, { recursive: true })
+    // 解压文件到目标目录，跳过顶层文件夹
+    await new Promise((resolve, reject) => {
+      const tasks: Promise<void>[] = []
+      let rootDir: string | null = null
+      let hasError = false
+
+      response.data
+        .pipe(unzipper.Parse())
+        .on('entry', (entry: any) => {
+          if (hasError) {
+            entry.autodrain()
+            return
+          }
+          try {
+            const flags = entry.props?.flags ?? 0
+            const entryPath = decodeZipEntryPath(entry.props?.pathBuffer, flags, entry.path)
+            const pathParts = entryPath.split('/')
+
+            // 检测根目录
+            if (!rootDir && pathParts.length > 1) {
+              rootDir = pathParts[0]
+            }
+            let newPath = entryPath
+            // 移除顶层文件夹
+            if (rootDir && entryPath.startsWith(rootDir + '/')) {
+              newPath = entryPath.slice(rootDir.length + 1)
+            }
+
+            if (!newPath) {
+              entry.autodrain()
+              return
+            }
+
+            const targetPath = path.join(workspacePath, newPath)
+
+            if (entry.type === 'Directory') {
+              fs.mkdirSync(targetPath, { recursive: true })
+              entry.autodrain()
+            } else {
+              const parentDir = path.dirname(targetPath)
+              fs.mkdirSync(parentDir, { recursive: true })
+              const writeStream = fs.createWriteStream(targetPath)
+              const task = pipeline(entry, writeStream).catch((err) => {
+                hasError = true
+                throw new Error(`解压文件失败 ${entryPath}: ${err.message}`)
+              })
+              tasks.push(task)
+            }
+          } catch (err) {
+            hasError = true
+            entry.autodrain()
+            reject(new Error(`处理entry失败: ${err}`))
+          }
+        })
+        .on('close', async () => {
+          try {
+            await Promise.all(tasks)
+            resolve(null)
+          } catch (err) {
+            reject(err)
+          }
+        })
+        .on('error', (err: { message: any }) => {
+          hasError = true
+          reject(new Error(`解压流错误: ${err.message}`))
+        })
+    })
+    await onCreateAgent(msgContent)
+  } catch (error) {
+    // 如果安装失败，清理目录
+    if (fs.existsSync(workspaceDir)) {
+      fs.rmSync(workspaceDir, { recursive: true, force: true })
+    }
+    sendEvent({ ...msgContent, status: 'fail' })
+  }
+}

package/src/bot.ts

@@ -1,8 +1,8 @@
 import path from 'node:path'
 import fs from 'node:fs'
 import os from 'node:os'
-import type { ReplyPayload } from 'openclaw/plugin-sdk'
-import { createReplyPrefixContext } from 'openclaw/plugin-sdk'
+import type { PluginRuntime, ReplyPayload } from 'openclaw/plugin-sdk'
+import { createPluginRuntimeStore, createReplyPrefixContext, createTypingCallbacks } from 'openclaw/plugin-sdk'
 import type { InboundMessage } from './types.js'
 import {
   clearSentMediaKeys,
@@ -18,8 +18,9 @@ import { extractMobookFiles } from './utils/searchFile.js'
 import { sendChunk, sendFinal, sendText as sendTextMsg, sendError, wsSendRaw, sendText } from './transport.js'
 import { dcgLogger } from './utils/log.js'
 import { channelInfo, systemCommand, interruptCommand, ENV, ignoreToolCommand } from './utils/constant.js'
-import { sendMessageToGateway } from './gateway/socket.js'
-import { getEffectiveMsgParams, setParamsMessage } from './utils/params.js'
+import { sendGatewayRpc } from './gateway/socket.js'
+import { clearParamsMessage, getEffectiveMsgParams, setParamsMessage } from './utils/params.js'
+import { getChildSessionKeysTrackedForRequester, resetSubagentStateForRequesterSession, waitUntilSubagentsIdle } from './tool.js'
 
 type MediaInfo = {
   path: string
@@ -44,13 +45,6 @@ const sessionStreamSuppressed = new Set<string>()
 /** 各 sessionKey 当前轮回复的流式分片序号（仅统计实际下发的文本 chunk）；每轮非打断消息开始时置 0 */
 const streamChunkIdxBySessionKey = new Map<string, number>()
 
-/** Active LLM generation abort controllers, keyed by conversationId */
-// const activeGenerations = new Map<string, AbortController>()
-
-/**
- * Extract agentId from conversation_id formatted as "agentId::suffix".
- * Returns null if the conversation_id does not contain the "::" separator.
- */
 export function extractAgentIdFromConversationId(conversationId: string): string | null {
   const idx = conversationId.indexOf('::')
   if (idx <= 0) return null
@@ -132,7 +126,14 @@ function resolveReplyMediaList(payload: ReplyPayload): string[] {
   if (payload.mediaUrls?.length) return payload.mediaUrls.filter(Boolean)
   return payload.mediaUrl ? [payload.mediaUrl] : []
 }
-
+const typingCallbacks = createTypingCallbacks({
+  start: async () => {
+    console.log('typing start')
+  },
+  onStartError: (err) => {
+    console.log('typing start error', err)
+  }
+})
 /**
  * 处理一条用户消息，调用 Agent 并返回回复
  */
@@ -151,7 +152,6 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
   const core = getDcgchatRuntime()
 
   const conversationId = msg.content.session_id?.trim()
-  const agentId = msg.content.agent_id?.trim()
   const real_mobook = msg.content.real_mobook?.toString().trim()
 
   const route = core.channel.routing.resolveAgentRoute({
@@ -179,10 +179,6 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
     real_mobook
   }
   setParamsMessage(effectiveSessionKey, mergedParams)
-  // 与 OpenClaw 会话投递里仍可能出现的 ctx.to=SenderId（userId）对齐，便于 getOutboundMsgParams 命中
-  dcgLogger(
-    `target normalize: rawTarget=${userId}, normalizedTarget=${effectiveSessionKey}, conversationId=${conversationId ?? ''}, messageId=${msg.content.message_id}`
-  )
   setParamsMessage(userId, mergedParams)
   dcgLogger(`target alias bound: aliasTarget=${userId} -> sessionKey=${effectiveSessionKey}`)
   const outboundCtx = getEffectiveMsgParams(effectiveSessionKey)
@@ -190,29 +186,15 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
     effectiveAgentId && effectiveAgentId !== 'main' ? config.agents?.list?.find((a) => a.id === effectiveAgentId) : undefined
   const agentDisplayName = agentEntry?.name ?? (effectiveAgentId && effectiveAgentId !== 'main' ? effectiveAgentId : undefined)
 
-  const safeSendFinal = (tag: string) => {
-    if (finalSent) return
-    finalSent = true
-    sendFinal(outboundCtx, tag)
-    setMsgStatus(effectiveSessionKey, 'finished')
-  }
-
   const text = msg.content.text?.trim()
 
   if (!text) {
     sendTextMsg('你需要我帮你做什么呢？', outboundCtx)
-    safeSendFinal('not text')
+    sendFinal(outboundCtx, 'not text')
     return
   }
 
   try {
-    // Abort any existing generation for this conversation, then start a new one
-    // const existingCtrl = activeGenerations.get(conversationId)
-    // if (existingCtrl) existingCtrl.abort()
-    // const genCtrl = new AbortController()
-    // const genSignal = genCtrl.signal
-    // activeGenerations.set(conversationId, genCtrl)
-
     // 处理用户上传的文件
     const files = msg.content.files ?? []
     let mediaPayload: Record<string, unknown> = {}
@@ -250,11 +232,10 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
       CommandAuthorized: true,
       OriginatingChannel: "dcgchat-test",
       OriginatingTo: effectiveSessionKey,
+      Target: effectiveSessionKey,
+      SourceTarget: effectiveSessionKey,
       ...mediaPayload
     })
-  dcgLogger(
-    `inbound context target: rawTarget=${userId}, normalizedTarget=${effectiveSessionKey}, ctx.To=${String(ctxPayload.To ?? '')}, ctx.SessionKey=${String(ctxPayload.SessionKey ?? '')}, ctx.OriginatingTo=${String(ctxPayload.OriginatingTo ?? '')}`
-  )
 
     const sentMediaKeys = new Set<string>()
     const getMediaKey = (url: string) => url.split(/[\\/]/).pop() ?? url
@@ -267,7 +248,7 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
       accountId: account.accountId
     })
 
-    const { dispatcher, replyOptions, markDispatchIdle, markRunComplete } = core.channel.reply.createReplyDispatcherWithTyping({
+    const { dispatcher, replyOptions, markDispatchIdle } = core.channel.reply.createReplyDispatcherWithTyping({
       responsePrefix: prefixContext.responsePrefix,
       responsePrefixContextProvider: prefixContext.responsePrefixContextProvider,
       humanDelay: core.channel.reply.resolveHumanDelayConfig(config, route.agentId),
@@ -283,7 +264,8 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
         }
       },
       onError: (err: unknown, info: { kind: string }) => {
-        safeSendFinal('error')
+        setMsgStatus(effectiveSessionKey, 'finished')
+        sendFinal(outboundCtx, 'error')
         dcgLogger(`${info.kind} reply failed: ${String(err)}`, 'error')
         activeRunIdBySessionKey.delete(effectiveSessionKey)
         streamChunkIdxBySessionKey.delete(effectiveSessionKey)
@@ -293,7 +275,9 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
         }
         dcgLogger(`${info.kind} reply failed: ${String(err)}`, 'error')
       },
-      onIdle: () => {}
+      onIdle: () => {
+        typingCallbacks.onIdle?.()
+      }
     })
 
     try {
@@ -303,42 +287,78 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
       }
 
       if (systemCommand.includes(text?.trim())) {
-        dcgLogger(`dispatching /new`)
-        await core.channel.reply.dispatchReplyFromConfig({
-          ctx: ctxPayload,
-          cfg: config,
+        dcgLogger(`dispatching ${text?.trim()}`)
+        await core.channel.reply.withReplyDispatcher({
           dispatcher,
-          replyOptions: {
-            ...replyOptions,
-            onModelSelected: prefixContext.onModelSelected,
-            onAgentRunStart: (runId) => {
-              activeRunIdBySessionKey.set(effectiveSessionKey, runId)
-            }
-          }
+          onSettled: () => markDispatchIdle(),
+          run: () =>
+            core.channel.reply.dispatchReplyFromConfig({
+              ctx: ctxPayload,
+              cfg: config,
+              dispatcher,
+              replyOptions: {
+                ...replyOptions,
+                onModelSelected: prefixContext.onModelSelected,
+                onAgentRunStart: (runId) => {
+                  activeRunIdBySessionKey.set(effectiveSessionKey, runId)
+                }
+              }
+            })
         })
       } else if (interruptCommand.includes(text?.trim())) {
         dcgLogger(`interrupt command: ${text}`)
-        safeSendFinal('abort')
+        sendFinal(outboundCtx, 'abort')
         sendText('会话已终止', outboundCtx)
         sessionStreamSuppressed.add(effectiveSessionKey)
-        const runId = activeRunIdBySessionKey.get(effectiveSessionKey)
-        sendMessageToGateway(
-          JSON.stringify({
-            method: 'chat.abort',
-            params: {
-              sessionKey: effectiveSessionKey,
-              ...(runId ? { runId } : {})
-            }
+
+        const abortOneSession = async (sessionKey: string) => {
+          try {
+            await sendGatewayRpc({ method: 'chat.abort', params: { sessionKey } })
+          } catch (e) {
+            dcgLogger(`chat.abort ${sessionKey}: ${String(e)}`, 'error')
+          }
+        }
+
+        const keysToAbort = new Set<string>(getChildSessionKeysTrackedForRequester(effectiveSessionKey))
+        try {
+          const listed = await sendGatewayRpc<{ sessions?: Array<{ key?: string }> }>({
+            method: 'sessions.list',
+            params: { spawnedBy: effectiveSessionKey, limit: 256 }
           })
-        )
-        if (runId) activeRunIdBySessionKey.delete(effectiveSessionKey)
-        safeSendFinal('stop')
+          for (const s of listed?.sessions ?? []) {
+            const k = typeof s?.key === 'string' ? s.key.trim() : ''
+            if (k) keysToAbort.add(k)
+          }
+        } catch (e) {
+          dcgLogger(`sessions.list spawnedBy: ${String(e)}`, 'error')
+        }
+        for (const sk of keysToAbort) {
+          await abortOneSession(sk)
+        }
+        await abortOneSession(effectiveSessionKey)
+
+        try {
+          await sendGatewayRpc({
+            method: 'sessions.reset',
+            params: { key: effectiveSessionKey, reason: 'reset' }
+          })
+        } catch (e) {
+          dcgLogger(`sessions.reset: ${String(e)}`, 'error')
+        }
+
+        activeRunIdBySessionKey.delete(effectiveSessionKey)
+        streamChunkIdxBySessionKey.delete(effectiveSessionKey)
+        resetSubagentStateForRequesterSession(effectiveSessionKey)
+        setMsgStatus(effectiveSessionKey, 'finished')
+        clearSentMediaKeys(msg.content.message_id)
+        clearParamsMessage(effectiveSessionKey)
+        clearParamsMessage(userId)
+
+        sendFinal(outboundCtx, 'stop')
         return
       } else {
-        dcgLogger(`dispatching to agent (session=${route.sessionKey})`)
         const params = getEffectiveMsgParams(effectiveSessionKey)
         if (!ignoreToolCommand.includes(text?.trim())) {
-          // message_received 没有 sessionKey 前置到bot中执行
           wsSendRaw(params, {
             is_finish: -1,
             tool_call_id: Date.now().toString(),
@@ -353,70 +373,58 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
             response: ''
           })
         }
-        await core.channel.reply.dispatchReplyFromConfig({
-          ctx: ctxPayload,
-          cfg: config,
+        await core.channel.reply.withReplyDispatcher({
           dispatcher,
-          replyOptions: {
-            ...replyOptions,
-            // abortSignal: genSignal,
-            onModelSelected: prefixContext.onModelSelected,
-            onAgentRunStart: (runId) => {
-              activeRunIdBySessionKey.set(effectiveSessionKey, runId)
-            },
-            onPartialReply: async (payload: ReplyPayload) => {
-              if (sessionStreamSuppressed.has(effectiveSessionKey)) return
-
-              // Accumulate full text
-              if (payload.text) {
-                completeText = payload.text
-              }
-              // --- Streaming text chunks ---
-              if (payload.text) {
-                const delta = payload.text.startsWith(completeText.slice(0, streamedTextLen))
-                  ? payload.text.slice(streamedTextLen)
-                  : payload.text
-                if (delta.trim()) {
-                  const prev = streamChunkIdxBySessionKey.get(effectiveSessionKey) ?? 0
-                  streamChunkIdxBySessionKey.set(effectiveSessionKey, prev + 1)
-                  sendChunk(delta, outboundCtx, prev)
-                  dcgLogger(`[stream]: chunkIdx=${prev} len=${delta.length} user=${msg._userId} ${delta.slice(0, 100)}`)
+          onSettled: () => markDispatchIdle(),
+          run: () =>
+            core.channel.reply.dispatchReplyFromConfig({
+              ctx: ctxPayload,
+              cfg: config,
+              dispatcher,
+              replyOptions: {
+                ...replyOptions,
+                onModelSelected: prefixContext.onModelSelected,
+                onAgentRunStart: (runId) => {
+                  activeRunIdBySessionKey.set(effectiveSessionKey, runId)
+                },
+                onPartialReply: async (payload: ReplyPayload) => {
+                  if (sessionStreamSuppressed.has(effectiveSessionKey)) return
+
+                  if (payload.text) {
+                    completeText = payload.text
+                  }
+                  // --- Streaming text chunks ---
+                  if (payload.text) {
+                    const delta = payload.text.startsWith(completeText.slice(0, streamedTextLen))
+                      ? payload.text.slice(streamedTextLen)
+                      : payload.text
+                    if (delta.trim()) {
+                      const prev = streamChunkIdxBySessionKey.get(effectiveSessionKey) ?? 0
+                      streamChunkIdxBySessionKey.set(effectiveSessionKey, prev + 1)
+                      sendChunk(delta, outboundCtx, prev)
+                      dcgLogger(`[stream]: chunkIdx=${prev} len=${delta.length} user=${msg._userId} ${delta.slice(0, 100)}`)
+                    }
+                    streamedTextLen = payload.text.length
+                  } else {
+                    dcgLogger(`onPartialReply no text: ${JSON.stringify(payload)}`, 'error')
+                  }
+                  // --- Media from payload ---
+                  const mediaList = resolveReplyMediaList(payload)
+                  for (const mediaUrl of mediaList) {
+                    const key = getMediaKey(mediaUrl)
+                    if (sentMediaKeys.has(key)) continue
+                    sentMediaKeys.add(key)
+                    await sendDcgchatMedia({ sessionKey: effectiveSessionKey, mediaUrl, text: '' })
+                  }
                 }
-                streamedTextLen = payload.text.length
-              }
-              // --- Media from payload ---
-              const mediaList = resolveReplyMediaList(payload)
-              for (const mediaUrl of mediaList) {
-                const key = getMediaKey(mediaUrl)
-                if (sentMediaKeys.has(key)) continue
-                sentMediaKeys.add(key)
-                await sendDcgchatMedia({ sessionKey: effectiveSessionKey, mediaUrl, text: '' })
               }
-            }
-          }
+            })
         })
       }
     } catch (err: unknown) {
-      // if (genSignal.aborted) {
-      //   wasAborted = true
-      //   dcgLogger(` generation aborted for conversationId=${conversationId}`)
-      // } else if (err instanceof Error && err.name === 'AbortError') {
-      //   wasAborted = true
-      //   dcgLogger(` generation aborted for conversationId=${conversationId}`)
-      // } else {
-      //   dcgLogger(` dispatchReplyFromConfig error: ${String(err)}`, 'error')
-      // }
-    } finally {
-      // if (activeGenerations.get(conversationId) === genCtrl) {
-      //   activeGenerations.delete(conversationId)
-      // }
-    }
-    try {
-      markRunComplete()
-      markDispatchIdle()
-    } catch (err) {
-      dcgLogger(` markRunComplete||markRunComplete error: ${String(err)}`, 'error')
+      dcgLogger(` dispatchReplyFromConfig error: ${String(err)}`, 'error')
     }
+
     if (![...systemCommand, ...interruptCommand].includes(text?.trim())) {
       if (sessionStreamSuppressed.has(effectiveSessionKey)) {
         sessionStreamSuppressed.delete(effectiveSessionKey)
@@ -443,11 +451,10 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
         }
       }
     }
-    safeSendFinal('end')
     clearSentMediaKeys(msg.content.message_id)
-
-    // Record session metadata
     const storePath = core.channel.session.resolveStorePath(config.session?.store)
+    await waitUntilSubagentsIdle(effectiveSessionKey, { timeoutMs: 600_000 })
+    sendFinal(outboundCtx, 'end')
     dcgLogger(
       `record session route: rawTarget=${userId}, normalizedTarget=${effectiveSessionKey}, updateLastRoute.to=${effectiveSessionKey}, accountId=${route.accountId}`
     )
@@ -456,7 +463,6 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
         storePath,
         sessionKey: effectiveSessionKey,
         ctx: ctxPayload,
-        // 与 Telegram/Discord 等一致：写入 deliveryContext.to，否则投递可能回退为 From（userId），channel sendMedia 里 ctx.to 会变成数字 userId
         updateLastRoute: {
           sessionKey: effectiveSessionKey,
           channel: "dcgchat-test",
@@ -473,7 +479,5 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
   } catch (err) {
     dcgLogger(` handle message failed: ${String(err)}`, 'error')
     sendError(err instanceof Error ? err.message : String(err), outboundCtx)
-  } finally {
-    safeSendFinal('finally')
   }
 }

package/src/channel.ts

@@ -1,8 +1,15 @@
-import type { ChannelPlugin, OpenClawConfig } from 'openclaw/plugin-sdk'
-import { DEFAULT_ACCOUNT_ID } from 'openclaw/plugin-sdk'
+import type { ChannelPlugin, OpenClawConfig, PluginRuntime } from 'openclaw/plugin-sdk'
+import { createPluginRuntimeStore, DEFAULT_ACCOUNT_ID } from 'openclaw/plugin-sdk'
 import type { ResolvedDcgchatAccount, DcgchatConfig } from './types.js'
 import { ossUpload } from './request/oss.js'
-import { addSentMediaKey, getCronMessageId, getInfoBySessionKey, getOpenClawConfig, hasSentMediaKey } from './utils/global.js'
+import {
+  addSentMediaKey,
+  getCronMessageId,
+  getDcgchatRuntime,
+  getInfoBySessionKey,
+  getOpenClawConfig,
+  hasSentMediaKey
+} from './utils/global.js'
 import { isWsOpen, mergeDefaultParams, mergeSessionParams, sendFinal, wsSendRaw } from './transport.js'
 import { dcgLogger, setLogger } from './utils/log.js'
 import { getOutboundMsgParams, getParamsMessage } from './utils/params.js'
@@ -116,7 +123,7 @@ export const dcgchatPlugin: ChannelPlugin<ResolvedDcgchatAccount> = {
     uiHints: {
       userId: {
         label: 'WS 连接 _userId',
-        help: '仅用于拼接网关 WebSocket URL 的查询参数，不是 Agent 发消息时的 target。发消息请使用 effectiveSessionKey（与入站上下文 SessionKey 相同，格式如 agent:main:mobook:direct:…）。'
+        help: '仅用于拼接网关 WebSocket URL 的查询参数，不是 Agent 发消息时的 target。发消息请使用 effectiveSessionKey（与入站上下文 SessionKey 相同，格式如 agent:main:mobook:direct:<agent_id>:<session_id>）。'
       }
     }
   },
@@ -155,8 +162,9 @@ export const dcgchatPlugin: ChannelPlugin<ResolvedDcgchatAccount> = {
   },
   agentPrompt: {
     messageToolHints: () => [
-      '书灵墨宝：message 工具的 target 必须填 effectiveSessionKey（与当前会话 SessionKey / OriginatingTo 相同），形如 agent:main:mobook:direct:<agent_id>:<session_id>；不要填 channels.dcgchat.userId 或纯数字 userId。',
-      'OpenClaw 自带的 target 字段说明里仍可能出现 “user id”，在本频道请忽略该字样，一律按 effectiveSessionKey 理解。'
+      '生成文件后，**尽可能不要**把文件路径、地址直接告诉用户。',
+      '生成文件后，把文件名告诉用户。',
+      '生成文件后，必须调用 message 工具发送文件，不可以直接在文本回复里包含文件路径、文件名、地址。'
     ]
   },
   outbound: {
@@ -167,6 +175,7 @@ export const dcgchatPlugin: ChannelPlugin<ResolvedDcgchatAccount> = {
       }
       return { ok: true, to: to }
     },
+    chunker: (text, limit) => getDcgchatRuntime().channel.text.chunkMarkdownText(text, limit),
     textChunkLimit: 4000,
     sendText: async (ctx) => {
       dcgLogger(`channel sendText to ${ctx.to} `)

package/src/gateway/index.ts

@@ -3,8 +3,8 @@ import { WebSocket } from 'ws'
 import crypto from 'crypto'
 import { deriveDeviceIdFromPublicKey, publicKeyRawBase64UrlFromPem, buildDeviceAuthPayloadV3, signDevicePayload } from './security.js'
 import { dcgLogger } from '../utils/log.js'
-import { finishedDcgchatCron, sendDcgchatCron } from '../cron.js'
 import { getWorkspaceDir } from '../utils/global.js'
+import { handleGatewayEventMessage } from '../utils/gatewayMsgHanlder.js'
 
 export interface GatewayEvent {
   type: string
@@ -358,31 +358,7 @@ export class GatewayConnection {
     }
 
     if (msg.type === 'event') {
-      try {
-        // 定时任务相关事件
-        if (msg.event === 'cron') {
-          dcgLogger(`[Gateway] 收到事件: ${JSON.stringify(msg)}`)
-          if (msg.payload?.action === 'added') {
-            sendDcgchatCron(msg.payload?.jobId)
-          }
-          if (msg.payload?.action === 'updated') {
-            sendDcgchatCron(msg.payload?.jobId as string)
-          }
-          if (msg.payload?.action === 'removed') {
-            sendDcgchatCron(msg.payload?.jobId as string)
-          }
-          if (msg.payload?.action === 'finished') {
-            finishedDcgchatCron(msg.payload?.jobId as string)
-          }
-        }
-      } catch (error) {
-        dcgLogger(`[Gateway] 处理事件失败: ${error}`, 'error')
-      }
-      const event: GatewayEvent = {
-        type: msg.event as string,
-        payload: msg.payload as Record<string, unknown> | undefined,
-        seq: msg.seq as number | undefined
-      }
+      const event = handleGatewayEventMessage(msg)
       this.eventHandlers.forEach((h) => h(event))
     }
   }

package/src/monitor.ts

@@ -1,15 +1,10 @@
 import type { ClawdbotConfig, RuntimeEnv } from 'openclaw/plugin-sdk'
 import WebSocket from 'ws'
-import { handleDcgchatMessage } from './bot.js'
 import { resolveAccount } from './channel.js'
-import { setWsConnection, getOpenClawConfig, setMsgStatus, getSessionKey } from './utils/global.js'
-import type { InboundMessage } from './types.js'
-import { installSkill, uninstallSkill } from './skill.js'
+import { setWsConnection, getOpenClawConfig } from './utils/global.js'
 import { dcgLogger } from './utils/log.js'
-import { onDisabledCronJob, onEnabledCronJob, onRemoveCronJob, onRunCronJob } from './cron.js'
-import { ignoreToolCommand } from './utils/constant.js'
 import { isWsOpen } from './transport.js'
-import { onRemoveSession } from './session.js'
+import { handleParsedWsMessage } from './utils/wsMessageHandler.js'
 
 export type MonitorDcgchatOpts = {
   config?: ClawdbotConfig
@@ -129,50 +124,7 @@ export async function monitorDcgchatProvider(opts: MonitorDcgchatOpts): Promise<
         return
       }
 
-      if (parsed.messageType == 'openclaw_bot_chat') {
-        const msg = parsed as unknown as InboundMessage
-        // 与 monitor 原逻辑一致：工具类指令不进入 running，避免误触工具链监控
-        const effectiveSessionKey = getSessionKey(msg.content, account.accountId)
-        if (!ignoreToolCommand.includes(msg.content.text?.trim() ?? '')) {
-          setMsgStatus(effectiveSessionKey, 'running')
-        } else {
-          setMsgStatus(effectiveSessionKey, 'finished')
-        }
-        await handleDcgchatMessage(msg, account.accountId)
-      } else if (parsed.messageType == 'openclaw_bot_event') {
-        const { event_type, operation_type } = parsed.content ? parsed.content : ({} as Record<string, any>)
-        if (event_type === 'skill') {
-          const { skill_url, skill_code, skill_id, bot_token, websocket_trace_id } = parsed.content
-          const content = { event_type, operation_type, skill_url, skill_code, skill_id, bot_token, websocket_trace_id }
-          if (operation_type === 'install' || operation_type === 'enable' || operation_type === 'update') {
-            installSkill({ path: skill_url, code: skill_code }, content)
-          } else if (operation_type === 'remove' || operation_type === 'disable') {
-            uninstallSkill({ code: skill_code }, content)
-          } else {
-            dcgLogger(`openclaw_bot_event unknown event_type: ${event_type}, ${data.toString()}`)
-          }
-        } else if (event_type === 'cron') {
-          const { job_id, message_id } = parsed.content
-          if (operation_type === 'remove') {
-            await onRemoveCronJob(job_id)
-          } else if (operation_type === 'enable') {
-            await onEnabledCronJob(job_id)
-          } else if (operation_type === 'disable') {
-            await onDisabledCronJob(job_id)
-          } else if (operation_type === 'run') {
-            await onRunCronJob(job_id, message_id)
-          }
-        } else if (event_type === 'session') {
-          const { agent_id, session_id, agent_clone_code } = parsed.content
-          if (operation_type === 'remove') {
-            await onRemoveSession({ agent_id, session_id, agent_clone_code, account_id: accountId })
-          }
-        } else {
-          dcgLogger(`openclaw_bot_event unknown operation_type: ${operation_type}, ${data.toString()}`)
-        }
-      } else {
-        dcgLogger(`ignoring unknown messageType: ${parsed.messageType}`, 'error')
-      }
+      await handleParsedWsMessage(parsed, payloadStr, account.accountId)
     })
 
     ws.on('close', (code, reason) => {

package/src/skill.ts

@@ -9,6 +9,7 @@ import { getWsConnection } from './utils/global.js'
 import { dcgLogger } from './utils/log.js'
 import { isWsOpen } from './transport.js'
 import { sendMessageToGateway } from './gateway/socket.js'
+import { decodeZipEntryPath } from './utils/zipPath.js'
 
 type ISkillParams = {
   path: string
@@ -69,13 +70,7 @@ export async function installSkill(params: ISkillParams, msgContent: Record<stri
           }
           try {
             const flags = entry.props?.flags ?? 0
-            const isUtf8 = (flags & 0x800) !== 0
-            let entryPath: string
-            if (!isUtf8 && entry.props?.pathBuffer) {
-              entryPath = new TextDecoder('gbk').decode(entry.props.pathBuffer)
-            } else {
-              entryPath = entry.path
-            }
+            const entryPath = decodeZipEntryPath(entry.props?.pathBuffer, flags, entry.path)
             const pathParts = entryPath.split('/')
 
             // 检测根目录

package/src/tool.ts

@@ -2,7 +2,7 @@ import type { OpenClawPluginApi } from 'openclaw/plugin-sdk'
 import { getMsgStatus } from './utils/global.js'
 import { dcgLogger } from './utils/log.js'
 import { sendFinal, sendText, wsSendRaw } from './transport.js'
-import { getEffectiveMsgParams } from './utils/params.js'
+import { getEffectiveMsgParams, deleteSessionKeyBySubAgentRunId, setSessionKeyBySubAgentRunId } from './utils/params.js'
 import { cronToolCall } from './cronToolCall.js'
 
 type PluginHookName =
@@ -68,10 +68,244 @@ interface CronDelivery {
   [key: string]: unknown
 }
 
+// --- Subagent 活跃跟踪（按主会话 requesterSessionKey）---
+
+/** 主会话 sessionKey -> 仍活跃的子 agent runId */
+const activeSubagentRunIdsByRequester = new Map<string, Set<string>>()
+/** 子会话 childSessionKey -> 主会话 requesterSessionKey */
+const requesterByChildSessionKey = new Map<string, string>()
+/** 子会话 childSessionKey -> spawn 时的 runId（ended 事件可能不带 runId） */
+const runIdByChildSessionKey = new Map<string, string>()
+/** 主会话 -> 等待「子 agent 全部结束」的回调 */
+const subagentIdleWaiters = new Map<string, Set<() => void>>()
+
+function getOrCreateRunIdSet(requesterSessionKey: string): Set<string> {
+  let set = activeSubagentRunIdsByRequester.get(requesterSessionKey)
+  if (!set) {
+    set = new Set()
+    activeSubagentRunIdsByRequester.set(requesterSessionKey, set)
+  }
+  return set
+}
+
+function flushSubagentIdleWaiters(requesterSessionKey: string): void {
+  const set = activeSubagentRunIdsByRequester.get(requesterSessionKey)
+  if (set && set.size > 0) return
+  activeSubagentRunIdsByRequester.delete(requesterSessionKey)
+  const waiters = subagentIdleWaiters.get(requesterSessionKey)
+  if (!waiters?.size) return
+  subagentIdleWaiters.delete(requesterSessionKey)
+  for (const w of waiters) {
+    try {
+      w()
+    } catch (e) {
+      dcgLogger(`subagent idle waiter error: ${String(e)}`, 'error')
+    }
+  }
+}
+
+function registerSubagentSpawn(requesterSessionKey: string, runId: string, childSessionKey: string): void {
+  const req = requesterSessionKey.trim()
+  const rid = runId.trim()
+  const child = childSessionKey.trim()
+  if (!req || !rid || !child) {
+    dcgLogger(`subagent track spawn skipped: missing key req=${req} runId=${rid} child=${child}`)
+    return
+  }
+  getOrCreateRunIdSet(req).add(rid)
+  requesterByChildSessionKey.set(child, req)
+  runIdByChildSessionKey.set(child, rid)
+  dcgLogger(`subagent track spawn: requester=${req} runId=${rid} child=${child} active=${getOrCreateRunIdSet(req).size}`)
+}
+
+function registerSubagentEnd(
+  ctx: { requesterSessionKey?: string; sessionKey?: string },
+  targetSessionKey: string,
+  runId?: string
+): void {
+  const child = targetSessionKey.trim()
+  if (!child) return
+  const req = ctx.requesterSessionKey?.trim() || requesterByChildSessionKey.get(child) || ctx.sessionKey?.trim() || ''
+  const resolvedRunId = (runId?.trim() || runIdByChildSessionKey.get(child) || '').trim()
+  deleteSessionKeyBySubAgentRunId(resolvedRunId)
+  if (!req) {
+    dcgLogger(`subagent track end: no requester for child=${child} runId=${resolvedRunId}`)
+    requesterByChildSessionKey.delete(child)
+    runIdByChildSessionKey.delete(child)
+    return
+  }
+  const set = activeSubagentRunIdsByRequester.get(req)
+  if (set && resolvedRunId) {
+    set.delete(resolvedRunId)
+  }
+  requesterByChildSessionKey.delete(child)
+  runIdByChildSessionKey.delete(child)
+  dcgLogger(`subagent track end: requester=${req} runId=${resolvedRunId || 'n/a'} remaining=${set?.size ?? 0}`)
+  if (set && set.size === 0) {
+    activeSubagentRunIdsByRequester.delete(req)
+  }
+  flushSubagentIdleWaiters(req)
+}
+
+/** 当前跟踪到的、挂在该主会话下的子会话 sessionKey（供 /stop 时逐个 chat.abort） */
+export function getChildSessionKeysTrackedForRequester(requesterSessionKey: string): string[] {
+  const req = requesterSessionKey.trim()
+  if (!req) return []
+  const out: string[] = []
+  for (const [child, parent] of requesterByChildSessionKey.entries()) {
+    if (parent === req) out.push(child)
+  }
+  return out
+}
+
+/**
+ * 打断后清空本地子 agent 跟踪（runId、父子映射、子 runId→sessionKey），并唤醒 waitUntilSubagentsIdle，避免永久挂起。
+ */
+export function resetSubagentStateForRequesterSession(requesterSessionKey: string): void {
+  const req = requesterSessionKey.trim()
+  if (!req) return
+
+  const runIdSet = activeSubagentRunIdsByRequester.get(req)
+  if (runIdSet) {
+    for (const rid of runIdSet) {
+      deleteSessionKeyBySubAgentRunId(rid)
+    }
+  }
+
+  for (const [child, parent] of [...requesterByChildSessionKey.entries()]) {
+    if (parent === req) {
+      requesterByChildSessionKey.delete(child)
+      runIdByChildSessionKey.delete(child)
+    }
+  }
+
+  activeSubagentRunIdsByRequester.delete(req)
+
+  const waiters = subagentIdleWaiters.get(req)
+  if (!waiters?.size) return
+  subagentIdleWaiters.delete(req)
+  for (const w of waiters) {
+    try {
+      w()
+    } catch (e) {
+      dcgLogger(`subagent idle waiter error: ${String(e)}`, 'error')
+    }
+  }
+}
+
+/** 当前主会话下仍在跑的子 agent 数量（按 spawn 时 runId 去重） */
+export function getActiveSubagentCount(sessionKey: string): number {
+  const sk = sessionKey?.trim()
+  if (!sk) return 0
+  return activeSubagentRunIdsByRequester.get(sk)?.size ?? 0
+}
+
+/**
+ * 等到指定主会话下已跟踪的子 agent 全部结束（spawn 失败等路径也会触发 subagent_ended，一般会配对清理）。
+ * 注意：须在收到 `subagent_spawned` 之后才会计入；仅 spawning 未 spawned 的不会阻塞。
+ */
+export function waitUntilSubagentsIdle(sessionKey: string, opts?: { timeoutMs?: number; signal?: AbortSignal }): Promise<void> {
+  console.log('🚀 ~ waitUntilSubagentsIdle ~ sessionKey:', sessionKey)
+  const sk = sessionKey?.trim()
+  if (!sk) return Promise.resolve()
+
+  if (getActiveSubagentCount(sk) === 0) return Promise.resolve()
+
+  return new Promise<void>((resolve, reject) => {
+    let settled = false
+    const finish = (fn: () => void) => {
+      if (settled) return
+      settled = true
+      if (timeoutId) clearTimeout(timeoutId)
+      opts?.signal?.removeEventListener('abort', onAbort)
+      removeWaiter()
+      fn()
+    }
+
+    const removeWaiter = () => {
+      const bucket = subagentIdleWaiters.get(sk)
+      if (!bucket) return
+      bucket.delete(onIdle)
+      if (bucket.size === 0) subagentIdleWaiters.delete(sk)
+    }
+
+    const onIdle = () => finish(() => resolve())
+
+    const onAbort = () => {
+      const reason = opts?.signal?.reason
+      finish(() => reject(reason instanceof Error ? reason : new Error(String(reason ?? 'Aborted'))))
+    }
+
+    let timeoutId: ReturnType<typeof setTimeout> | undefined
+    if (opts?.timeoutMs != null && opts.timeoutMs > 0) {
+      timeoutId = setTimeout(
+        () => finish(() => reject(new Error(`waitUntilSubagentsIdle timeout ${opts.timeoutMs}ms`))),
+        opts.timeoutMs
+      )
+    }
+
+    if (opts?.signal) {
+      if (opts.signal.aborted) {
+        onAbort()
+        return
+      }
+      opts.signal.addEventListener('abort', onAbort, { once: true })
+    }
+
+    let set = subagentIdleWaiters.get(sk)
+    if (!set) {
+      set = new Set()
+      subagentIdleWaiters.set(sk, set)
+    }
+    set.add(onIdle)
+
+    if (getActiveSubagentCount(sk) === 0) {
+      onIdle()
+    }
+  })
+}
+
+function resolveHookSessionKey(
+  eventName: string,
+  args: { sessionKey?: string; requesterSessionKey?: string; runId?: string }
+): string {
+  if (
+    eventName === 'subagent_spawned' ||
+    eventName === 'subagent_ended' ||
+    eventName === 'subagent_spawning' ||
+    eventName === 'subagent_delivery_target'
+  ) {
+    if (args?.runId && args?.requesterSessionKey) setSessionKeyBySubAgentRunId(args?.runId, args?.requesterSessionKey)
+    return (args?.requesterSessionKey || args?.sessionKey || '').trim()
+  }
+  return (args?.sessionKey || '').trim()
+}
+
+function trackSubagentLifecycle(eventName: string, event: any, args: any): void {
+  if (eventName === 'subagent_spawned') {
+    const runId = typeof event?.runId === 'string' ? event.runId : ''
+    const childSessionKey = typeof event?.childSessionKey === 'string' ? event.childSessionKey : ''
+    const requester =
+      typeof args?.requesterSessionKey === 'string'
+        ? args.requesterSessionKey
+        : typeof args?.sessionKey === 'string'
+          ? args.sessionKey
+          : ''
+    registerSubagentSpawn(requester, runId, childSessionKey)
+    return
+  }
+  if (eventName === 'subagent_ended') {
+    const targetSessionKey = typeof event?.targetSessionKey === 'string' ? event.targetSessionKey : ''
+    const runId = typeof event?.runId === 'string' ? event.runId : undefined
+    registerSubagentEnd(args ?? {}, targetSessionKey, runId)
+  }
+}
+
 export function monitoringToolMessage(api: OpenClawPluginApi) {
   for (const item of eventList) {
     api.on(item.event as PluginHookName, (event: any, args: any) => {
-      const sk = args?.sessionKey as string
+      trackSubagentLifecycle(item.event, event, args)
+      const sk = resolveHookSessionKey(item.event, args ?? {})
       if (sk) {
         const status = getMsgStatus(sk)
         if (status === 'running') {

package/src/types.ts

@@ -39,6 +39,7 @@ export type InboundMessage = {
   // content: string;
   content: {
     bot_token: string
+    agent_clone_code?: string
     domain_id?: string
     app_id?: string
     bot_id?: string

package/src/utils/constant.ts

@@ -2,6 +2,6 @@ export const ENV: 'production' | 'test' | 'develop' = 'test'
 
 
 export const systemCommand = ['/new', '/status']
-export const interruptCommand = ['chat.stop']
+export const interruptCommand = ['/stop']
 
-export const ignoreToolCommand = ['/search', '/abort', '/stop', '/queue interrupt', ...systemCommand, ...interruptCommand]
+export const ignoreToolCommand = ['/search', '/abort', '/queue interrupt', ...systemCommand, ...interruptCommand]

package/src/utils/gatewayMsgHanlder.ts

@@ -0,0 +1,43 @@
+import type { GatewayEvent } from '../gateway/index.js'
+import { finishedDcgchatCron, sendDcgchatCron } from '../cron.js'
+import { dcgLogger } from './log.js'
+import { getEffectiveMsgParams, getSessionKeyBySubAgentRunId } from './params.js'
+import { sendChunk } from '../transport.js'
+
+/**
+ * 处理网关 event 帧的副作用（agent 流式输出、cron 同步），并构造供上层分发的 GatewayEvent。
+ */
+export function handleGatewayEventMessage(msg: { event?: string; payload?: Record<string, unknown>; seq?: number }): GatewayEvent {
+  try {
+    if (msg.event === 'agent') {
+      dcgLogger(`[Gateway] 收到agent事件: ${JSON.stringify(msg).slice(0, 100)}`)
+      const pl = msg.payload as { runId: string; data?: { delta?: unknown } }
+      const sessionKey = getSessionKeyBySubAgentRunId(pl.runId)
+      const outboundCtx = getEffectiveMsgParams(sessionKey)
+      if (outboundCtx.sessionId && pl.data?.delta) sendChunk(pl.data.delta as string, outboundCtx, 0)
+    }
+    if (msg.event === 'cron') {
+      const p = msg.payload
+      dcgLogger(`[Gateway] 收到定时任务事件: ${JSON.stringify(p)}`)
+      if (p?.action === 'added') {
+        sendDcgchatCron(p?.jobId as string)
+      }
+      if (p?.action === 'updated') {
+        sendDcgchatCron(p?.jobId as string)
+      }
+      if (p?.action === 'removed') {
+        sendDcgchatCron(p?.jobId as string)
+      }
+      if (p?.action === 'finished') {
+        finishedDcgchatCron(p?.jobId as string)
+      }
+    }
+  } catch (error) {
+    dcgLogger(`[Gateway] 处理事件失败: ${error}`, 'error')
+  }
+  return {
+    type: msg.event as string,
+    payload: msg.payload,
+    seq: msg.seq as number | undefined
+  }
+}

package/src/utils/global.ts

@@ -22,7 +22,7 @@ export function getOpenClawConfig(): OpenClawConfig | null {
   return config
 }
 
-import type { OpenClawConfig, PluginRuntime } from 'openclaw/plugin-sdk'
+import { createPluginRuntimeStore, type OpenClawConfig, type PluginRuntime } from 'openclaw/plugin-sdk'
 import { dcgLogger } from './log.js'
 import { channelInfo, ENV } from './constant.js'
 
@@ -42,7 +42,6 @@ function getWorkspacePath() {
   return null
 }
 
-let runtime: PluginRuntime | null = null
 let workspaceDir: string = getWorkspacePath()
 
 export function setWorkspaceDir(dir?: string) {
@@ -56,17 +55,10 @@ export function getWorkspaceDir(): string {
   }
   return workspaceDir
 }
-
-export function setDcgchatRuntime(next: PluginRuntime) {
-  runtime = next
-}
-
-export function getDcgchatRuntime(): PluginRuntime {
-  if (!runtime) {
-    dcgLogger?.('runtime not initialized', 'error')
-  }
-  return runtime as PluginRuntime
-}
+const { setRuntime: setDcgchatRuntime, getRuntime: getDcgchatRuntime } = createPluginRuntimeStore<PluginRuntime>(
+  `${"dcgchat-test"} runtime not initialized`
+)
+export { setDcgchatRuntime, getDcgchatRuntime }
 
 export type MsgSessionStatus = 'running' | 'finished' | ''
 
@@ -117,19 +109,6 @@ export function clearSentMediaKeys(messageId?: string) {
   }
 }
 
-export const getSessionKey = (content: any, accountId?: string) => {
-  const { real_mobook, agent_id, conversation_id, session_id } = content
-  const core = getDcgchatRuntime()
-
-  const route = core.channel.routing.resolveAgentRoute({
-    cfg: getOpenClawConfig() as OpenClawConfig,
-    channel: "dcgchat-test",
-    accountId: accountId || 'default',
-    peer: { kind: 'direct', id: session_id }
-  })
-  return real_mobook == '1' ? route.sessionKey : `agent:main:mobook:direct:${agent_id}:${session_id}`.toLowerCase()
-}
-
 const cronMessageIdMap = new Map<string, string>()
 
 export function setCronMessageId(sk: string, messageId: string) {
@@ -144,6 +123,21 @@ export function removeCronMessageId(sk: string) {
   cronMessageIdMap.delete(sk)
 }
 
+export const getSessionKey = (content: any, accountId: string) => {
+  const { real_mobook, agent_id, agent_clone_code, session_id } = content
+  const core = getDcgchatRuntime()
+
+  const anentCode = agent_clone_code || 'main'
+
+  const route = core.channel.routing.resolveAgentRoute({
+    cfg: getOpenClawConfig() as OpenClawConfig,
+    channel: "dcgchat-test",
+    accountId: accountId || 'default',
+    peer: { kind: 'direct', id: session_id }
+  })
+  return real_mobook == '1' ? route.sessionKey : `agent:${anentCode}:mobook:direct:${agent_id}:${session_id}`.toLowerCase()
+}
+
 export function getInfoBySessionKey(sk: string): { sessionId: string; agentId: string } {
   const sessionInfo = sk.split(':')
   return { sessionId: sessionInfo.at(-1) ?? '', agentId: sessionInfo.at(-2) ?? '' }

package/src/utils/params.ts

@@ -69,3 +69,21 @@ export function setParamsMessage(sessionKey: string, params: Partial<IMsgParams>
 export function getParamsMessage(sessionKey: string): IMsgParams | undefined {
   return paramsMessageMap.get(sessionKey)
 }
+
+export function clearParamsMessage(sessionKey: string): void {
+  const k = sessionKey?.trim()
+  if (!k) return
+  paramsMessageMap.delete(k)
+}
+
+// sessionKey 对应的 子agent的runId
+const subagentRunIdMap = new Map<string, string>()
+export function getSessionKeyBySubAgentRunId(runId: string): string | undefined {
+  return subagentRunIdMap.get(runId)
+}
+export function setSessionKeyBySubAgentRunId(runId: string, sessionKey: string) {
+  subagentRunIdMap.set(runId, sessionKey)
+}
+export function deleteSessionKeyBySubAgentRunId(runId: string) {
+  subagentRunIdMap.delete(runId)
+}

package/src/utils/wsMessageHandler.ts

@@ -0,0 +1,64 @@
+import { handleDcgchatMessage } from '../bot.js'
+import { setMsgStatus, getSessionKey } from './global.js'
+import type { InboundMessage } from '../types.js'
+import { installSkill, uninstallSkill } from '../skill.js'
+import { dcgLogger } from './log.js'
+import { onDisabledCronJob, onEnabledCronJob, onRemoveCronJob, onRunCronJob } from '../cron.js'
+import { ignoreToolCommand } from './constant.js'
+import { createAgent } from '../agent.js'
+
+export type ParsedWsPayload = {
+  messageType?: string
+  content: any
+}
+
+/**
+ * 处理 WebSocket 已解析 JSON 且 content 已二次 parse 后的业务消息（openclaw_bot_chat / openclaw_bot_event）。
+ */
+export async function handleParsedWsMessage(parsed: ParsedWsPayload, rawPayload: string, accountId: string): Promise<void> {
+  if (parsed.messageType == 'openclaw_bot_chat') {
+    const msg = parsed as unknown as InboundMessage
+    // 与 monitor 原逻辑一致：工具类指令不进入 running，避免误触工具链监控
+    const effectiveSessionKey = getSessionKey(msg.content, accountId)
+    if (!ignoreToolCommand.includes(msg.content.text?.trim() ?? '')) {
+      setMsgStatus(effectiveSessionKey, 'running')
+    } else {
+      setMsgStatus(effectiveSessionKey, 'finished')
+    }
+    await handleDcgchatMessage(msg, accountId)
+  } else if (parsed.messageType == 'openclaw_bot_event') {
+    const { event_type, operation_type } = parsed.content ? parsed.content : ({} as Record<string, any>)
+    if (event_type === 'skill') {
+      const { skill_url, skill_code, skill_id, bot_token, websocket_trace_id } = parsed.content
+      const content = { event_type, operation_type, skill_url, skill_code, skill_id, bot_token, websocket_trace_id }
+      if (operation_type === 'install' || operation_type === 'enable' || operation_type === 'update') {
+        installSkill({ path: skill_url, code: skill_code }, content)
+      } else if (operation_type === 'remove' || operation_type === 'disable') {
+        uninstallSkill({ code: skill_code }, content)
+      } else {
+        dcgLogger(`openclaw_bot_event unknown event_type: ${event_type}, ${rawPayload}`)
+      }
+    } else if (event_type === 'agent') {
+      if (operation_type === 'install') {
+        createAgent(parsed.content)
+      } else {
+        dcgLogger(`openclaw_bot_event unknown event_type: ${event_type}, ${rawPayload}`)
+      }
+    } else if (event_type === 'cron') {
+      const { job_id, message_id } = parsed.content
+      if (operation_type === 'remove') {
+        await onRemoveCronJob(job_id)
+      } else if (operation_type === 'enable') {
+        await onEnabledCronJob(job_id)
+      } else if (operation_type === 'disable') {
+        await onDisabledCronJob(job_id)
+      } else if (operation_type === 'run') {
+        await onRunCronJob(job_id, message_id)
+      }
+    } else {
+      dcgLogger(`openclaw_bot_event unknown operation_type: ${operation_type}, ${rawPayload}`)
+    }
+  } else {
+    dcgLogger(`ignoring unknown messageType: ${parsed.messageType}`, 'error')
+  }
+}

package/src/utils/zipPath.ts

@@ -0,0 +1,24 @@
+/**
+ * ZIP 文件名编码：规范要求 UTF-8 时设置 0x800；很多工具未设标志但仍写 UTF-8 字节。
+ * 无标志时若一律按 GBK 解码，会得到「鍥句功…」类乱码。先严格 UTF-8，失败再 GBK（兼容 Windows 中文 ZIP）。
+ */
+export function decodeZipEntryPath(
+  pathBuffer: Buffer | Uint8Array | undefined,
+  flags: number,
+  fallbackPath: string
+): string {
+  if ((flags & 0x800) !== 0) {
+    if (pathBuffer) {
+      return new TextDecoder('utf-8').decode(pathBuffer)
+    }
+    return fallbackPath
+  }
+  if (pathBuffer && pathBuffer.length > 0) {
+    try {
+      return new TextDecoder('utf-8', { fatal: true }).decode(pathBuffer)
+    } catch {
+      return new TextDecoder('gbk').decode(pathBuffer)
+    }
+  }
+  return fallbackPath
+}