@dcrays/dcgchat 0.3.29 → 0.3.30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcrays/dcgchat",
-  "version": "0.3.29",
+  "version": "0.3.30",
   "type": "module",
   "description": "OpenClaw channel plugin for 书灵墨宝 (WebSocket)",
   "main": "index.ts",
@@ -42,4 +42,4 @@
       "defaultChoice": "npm"
     }
   }
-}
+}

package/src/bot.ts

@@ -166,7 +166,7 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
   const effectiveAgentId = embeddedAgentId ?? route.agentId
   const effectiveSessionKey = getSessionKey(msg.content, account.accountId)
 
-  setParamsMessage(effectiveSessionKey, {
+  const mergedParams = {
     userId: msg._userId,
     botToken: msg.content.bot_token,
     sessionId: conversationId,
@@ -177,7 +177,11 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
     agentId: msg.content.agent_id ?? '',
     sessionKey: effectiveSessionKey,
     real_mobook
-  })
+  }
+  setParamsMessage(effectiveSessionKey, mergedParams)
+  // 与 OpenClaw 会话投递里仍可能出现的 ctx.to=SenderId（userId）对齐，便于 getOutboundMsgParams 命中
+  console.log('🚀 ~ handleDcgchatMessage ~ mergedParams:', mergedParams)
+  setParamsMessage(userId, mergedParams)
   const outboundCtx = getEffectiveMsgParams(effectiveSessionKey)
   const agentEntry =
     effectiveAgentId && effectiveAgentId !== 'main' ? config.agents?.list?.find((a) => a.id === effectiveAgentId) : undefined
@@ -443,6 +447,13 @@ 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",
+          to: effectiveSessionKey,
+          accountId: route.accountId
+        },
         onRecordError: (err) => {
           dcgLogger(` session record error: ${String(err)}`, 'error')
         }

package/src/channel.ts

@@ -5,7 +5,7 @@ import { ossUpload } from './request/oss.js'
 import { addSentMediaKey, getCronMessageId, getOpenClawConfig, hasSentMediaKey } from './utils/global.js'
 import { isWsOpen, mergeDefaultParams, mergeSessionParams, sendFinal, wsSendRaw } from './transport.js'
 import { dcgLogger, setLogger } from './utils/log.js'
-import { getOutboundMsgParams } from './utils/params.js'
+import { getOutboundMsgParams, getParamsMessage } from './utils/params.js'
 import { startDcgchatGatewaySocket } from './gateway/socket.js'
 
 export type DcgchatMediaSendOptions = {
@@ -101,11 +101,17 @@ export const dcgchatPlugin: ChannelPlugin<ResolvedDcgchatAccount> = {
         enabled: { type: 'boolean' },
         wsUrl: { type: 'string' },
         botToken: { type: 'string' },
-        userId: { type: 'string' },
+        userId: { type: 'string', description: 'WebSocket 连接参数 _userId，与 message 工具的 target（effectiveSessionKey）无关' },
         appId: { type: 'string' },
         domainId: { type: 'string' },
         capabilities: { type: 'array', items: { type: 'string' } }
       }
+    },
+    uiHints: {
+      userId: {
+        label: 'WS 连接 _userId',
+        help: '仅用于拼接网关 WebSocket URL 的查询参数，不是 Agent 发消息时的 target。发消息请使用 effectiveSessionKey（与入站上下文 SessionKey 相同，格式如 agent:main:mobook:direct:…）。'
+      }
     }
   },
   config: {
@@ -138,9 +144,15 @@ export const dcgchatPlugin: ChannelPlugin<ResolvedDcgchatAccount> = {
     normalizeTarget: (raw) => raw?.trim() || undefined,
     targetResolver: {
       looksLikeId: (raw) => Boolean(raw?.trim()),
-      hint: 'effectiveSessionKey'
+      hint: 'effectiveSessionKey（与 SessionKey 一致；勿填配置里的 WS userId）'
     }
   },
+  agentPrompt: {
+    messageToolHints: () => [
+      '书灵墨宝：message 工具的 target 必须填 effectiveSessionKey（与当前会话 SessionKey / OriginatingTo 相同），形如 agent:main:mobook:direct:<agent_id>:<session_id>；不要填 channels.dcgchat.userId 或纯数字 userId。',
+      'OpenClaw 自带的 target 字段说明里仍可能出现 “user id”，在本频道请忽略该字样，一律按 effectiveSessionKey 理解。'
+    ]
+  },
   outbound: {
     deliveryMode: 'direct',
     textChunkLimit: 4000,
@@ -176,17 +188,29 @@ export const dcgchatPlugin: ChannelPlugin<ResolvedDcgchatAccount> = {
       }
     },
     sendMedia: async (ctx) => {
+      const isCron = ctx.to.indexOf('dcg-cron:') >= 0
       const to = ctx.to.replace('dcg-cron:', '')
-      const msgCtx = getOutboundMsgParams(to)
+      const outboundCtx = getOutboundMsgParams(to)
+      const msgCtx = getParamsMessage(to) ?? outboundCtx
       const cronMsgId = getCronMessageId(to)
-      const isCron = ctx.to.indexOf('dcg-cron:') >= 0
-      const messageId = !!cronMsgId ? cronMsgId : isCron ? `${Date.now()}` : msgCtx?.messageId
+      const fallbackMessageId = `${Date.now()}`
+      const messageId = cronMsgId || (isCron ? fallbackMessageId : msgCtx?.messageId || fallbackMessageId)
+
+      if (!outboundCtx?.sessionId) {
+        dcgLogger(`channel sendMedia to ${ctx.to} -> sessionId not found`, 'error')
+        return {
+          channel: "dcgchat",
+          messageId,
+          chatId: to || ''
+        }
+      }
+
       dcgLogger(`channel sendMedia to ${ctx.to}`)
-      await sendDcgchatMedia({ sessionKey: to ?? '', mediaUrl: ctx.mediaUrl ?? '' })
+      await sendDcgchatMedia({ sessionKey: to || '', mediaUrl: ctx.mediaUrl || '' })
       return {
         channel: "dcgchat",
-        messageId: `${messageId}`,
-        chatId: to
+        messageId,
+        chatId: to || ''
       }
     }
   },