@dcrays/dcgchat 0.3.28 → 0.3.30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcrays/dcgchat",
-  "version": "0.3.28",
+  "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 = {
@@ -43,14 +43,14 @@ export async function sendDcgchatMedia(opts: DcgchatMediaSendOptions): Promise<v
       message_tags: { source: 'file' },
       files: [{ url, name: fileName }]
     })
-    dcgLogger(`dcgchat: sendMedia to user ${msgCtx.userId}, file=${fileName}`)
+    dcgLogger(`dcgchat: sendMedia session=${opts.sessionKey}, file=${fileName}`)
   } catch (error) {
     wsSendRaw(msgCtx, {
       response: opts.text ?? '',
       message_tags: { source: 'file' },
       files: [{ url: opts.mediaUrl ?? '', name: fileName }]
     })
-    dcgLogger(`dcgchat: error sendMedia to user ${msgCtx.userId}: ${String(error)}`, 'error')
+    dcgLogger(`dcgchat: error sendMedia session=${opts.sessionKey}: ${String(error)}`, 'error')
   }
 }
 
@@ -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: 'userId'
+      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: msgCtx.userId?.toString()
+        messageId,
+        chatId: to || ''
       }
     }
   },

package/src/utils/params.ts

@@ -47,8 +47,8 @@ export function getEffectiveMsgParams(sessionKey?: string): IMsgParams {
 }
 
 /**
- * Agent `message` 工具常把 `target` 设为用户 ID（如 "150"），而 `setParamsMessage` 使用的 key 是
- * `effectiveSessionKey`（如 `agent:main:mobook:direct:...`）。若按 preferredKey 查不到 map，
+ * Agent `message` 工具的 `target` 应为 `effectiveSessionKey`（如 `agent:main:mobook:direct:...`）。
+ * `setParamsMessage` 使用的 key 与此一致。若按 preferredKey 查不到 map，
  * 则回落到当前会话 `currentSessionKey`，避免拿到空 `messageId` / `sessionId` 导致无文件卡片、WS 上下文错误。
  */
 export function getOutboundMsgParams(preferredKey: string): IMsgParams {