@dcrays/dcgchat-test 0.3.25 → 0.3.27

package/README.md

@@ -0,0 +1,83 @@
+# OpenClaw 书灵墨宝 插件
+
+连接 OpenClaw 与 书灵墨宝 产品的通道插件。
+
+## 架构
+
+```
+┌──────────┐      WebSocket       ┌──────────────┐      WebSocket      ┌─────────────────────┐
+│ Web 前端 │  ←───────────────→   │  公司后端服务  │  ←───────────────→  │ OpenClaw（工作电脑） │
+└──────────┘                      └──────────────┘   (OpenClaw 主动连)   └─────────────────────┘
+```
+
+- OpenClaw 插件**主动连接**后端的 WebSocket 服务（不需要公网 IP）
+- 后端收到用户消息后转发给 OpenClaw，OpenClaw 回复后发回后端
+
+## 快速开始
+
+### 1. 安装插件
+
+```bash
+pnpm openclaw plugins install -l /path/to/openclaw-dcgchat
+```
+
+### 2. 配置
+
+```bash
+openclaw config set channels.dcgchat.enabled true
+openclaw config set channels.dcgchat.wsUrl "ws://your-backend:8080/openclaw/ws"
+```
+
+### 3. 启动
+
+```bash
+pnpm openclaw gateway
+```
+
+## 消息协议（MVP）
+
+### 下行：后端 → OpenClaw（用户消息）
+
+```json
+{ "type": "message", "userId": "user_001", "text": "你好" }
+```
+
+### 上行：OpenClaw → 后端（Agent 回复）
+
+```json
+{ "type": "reply", "userId": "user_001", "text": "你好！有什么可以帮你的？" }
+```
+
+## 配置项
+
+| 配置键 | 类型 | 说明 |
+|--------|------|------|
+| `channels.dcgchat.enabled` | boolean | 是否启用 |
+| `channels.dcgchat.wsUrl` | string | 后端 WebSocket 地址 |
+
+## 开发
+
+```bash
+# 安装依赖
+pnpm install
+
+# 类型检查
+pnpm typecheck
+```
+
+## 文件结构
+
+- `index.ts` - 插件入口
+- `src/channel.ts` - ChannelPlugin 定义
+- `src/runtime.ts` - 插件 runtime
+- `src/types.ts` - 类型定义
+- `src/monitor.ts` - WebSocket 连接与断线重连
+- `src/bot.ts` - 消息处理与 Agent 调用
+
+## 后续迭代
+
+- [ ] Token 认证
+- [ ] 流式输出
+- [ ] Typing 指示
+- [ ] messageId 去重
+- [ ] 错误消息类型

package/index.ts

@@ -3,11 +3,12 @@ import { emptyPluginConfigSchema } from 'openclaw/plugin-sdk'
 import { dcgchatPlugin } from './src/channel.js'
 import { setDcgchatRuntime, setWorkspaceDir } from './src/utils/global.js'
 import { monitoringToolMessage } from './src/tool.js'
+import { channelInfo, ENV } from './src/utils/constant.js'
 import { setOpenClawConfig } from './src/utils/global.js'
 import { startDcgchatGatewaySocket } from './src/gateway/socket.js'
 
 const plugin = {
-  id: "dcgchat-test",
+  id: channelInfo[ENV],
   name: '书灵墨宝',
   description: '连接 OpenClaw 与 书灵墨宝 产品（WebSocket）',
   configSchema: emptyPluginConfigSchema(),

package/openclaw.plugin.json

@@ -1,11 +1,9 @@
 {
   "id": "dcgchat-test",
-  "channels": [
-    "dcgchat-test"
-  ],
+  "channels": ["dcgchat-test"],
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
     "properties": {}
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcrays/dcgchat-test",
-  "version": "0.3.25",
+  "version": "0.3.27",
   "type": "module",
   "description": "OpenClaw channel plugin for 书灵墨宝 (WebSocket)",
   "main": "index.ts",
@@ -16,6 +16,12 @@
     "websocket",
     "ai"
   ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build:production": "npx tsx scripts/build.ts production",
+    "build:prod": "npx tsx scripts/build.ts production",
+    "build:test": "npx tsx scripts/build.ts test"
+  },
   "dependencies": {
     "ali-oss": "file:src/libs/ali-oss-6.23.0.tgz",
     "axios": "file:src/libs/axios-1.13.6.tgz",
@@ -31,15 +37,18 @@
       "id": "dcgchat-test",
       "label": "书灵墨宝",
       "selectionLabel": "书灵墨宝",
-      "docsPath": "/channels/dcgchat-test",
+      "docsPath": "/channels/dcgchat",
       "docsLabel": "dcgchat-test",
       "blurb": "连接 OpenClaw 与 书灵墨宝 产品",
       "order": 80
     },
     "install": {
       "npmSpec": "@dcrays/dcgchat-test",
-      "localPath": "extensions/dcgchat-test",
+      "localPath": "extensions/dcgchat",
       "defaultChoice": "npm"
     }
+  },
+  "devDependencies": {
+    "openclaw": "^2026.3.13"
   }
 }

package/src/bot.ts

@@ -147,7 +147,7 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
 
   const route = core.channel.routing.resolveAgentRoute({
     cfg: config,
-    channel: "dcgchat-test",
+    channel: channelInfo[ENV],
     accountId: account.accountId,
     peer: { kind: 'direct', id: conversationId }
   })
@@ -226,13 +226,13 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
       ChatType: 'direct',
       SenderName: agentDisplayName,
       SenderId: userId,
-      Provider: "dcgchat-test",
-      Surface: "dcgchat-test",
+      Provider: channelInfo[ENV],
+      Surface: channelInfo[ENV],
       MessageSid: msg.content.message_id,
       Timestamp: Date.now(),
       WasMentioned: true,
       CommandAuthorized: true,
-      OriginatingChannel: "dcgchat-test",
+      OriginatingChannel: channelInfo[ENV],
       OriginatingTo: effectiveSessionKey,
       ...mediaPayload
     })
@@ -244,7 +244,7 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
     const prefixContext = createReplyPrefixContext({
       cfg: config,
       agentId: effectiveAgentId ?? '',
-      channel: "dcgchat-test",
+      channel: channelInfo[ENV],
       accountId: account.accountId
     })
 
@@ -402,7 +402,9 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
       if (sessionStreamSuppressed.has(effectiveSessionKey)) {
         sessionStreamSuppressed.delete(effectiveSessionKey)
       } else {
-        for (const file of extractMobookFiles(completeText)) {
+        const files = extractMobookFiles(completeText)
+        dcgLogger(`检索到文件：${JSON.stringify(files)}`)
+        for (const file of files) {
           const resolved = getFilePathByFile(file)
           if (!resolved) continue
           try {

package/src/channel.ts

@@ -4,19 +4,20 @@ import type { ResolvedDcgchatAccount, DcgchatConfig } from './types.js'
 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 { channelInfo, ENV } from './utils/constant.js'
 import { dcgLogger, setLogger } from './utils/log.js'
-import { getEffectiveMsgParams, getCurrentSessionKey } from './utils/params.js'
+import { getOutboundMsgParams } from './utils/params.js'
 import { startDcgchatGatewaySocket } from './gateway/socket.js'
 
 export type DcgchatMediaSendOptions = {
-  /** 与 setParamsMessage / map 一致，用于 getEffectiveMsgParams */
+  /** 与 setParamsMessage / map 一致，用于 getOutboundMsgParams */
   sessionKey: string
   mediaUrl?: string
   text?: string
 }
 
 export async function sendDcgchatMedia(opts: DcgchatMediaSendOptions): Promise<void> {
-  const msgCtx = getEffectiveMsgParams(opts.sessionKey)
+  const msgCtx = getOutboundMsgParams(opts.sessionKey ?? '')
   if (!isWsOpen()) {
     dcgLogger(`outbound media skipped -> ws not open: ${opts.mediaUrl ?? ''}`)
     return
@@ -35,7 +36,7 @@ export async function sendDcgchatMedia(opts: DcgchatMediaSendOptions): Promise<v
   const fileName = mediaUrl?.split(/[\\/]/).pop() || ''
 
   try {
-    const botToken = msgCtx.botToken ?? getOpenClawConfig()?.channels?.["dcgchat-test"]?.botToken ?? ''
+    const botToken = msgCtx.botToken ?? getOpenClawConfig()?.channels?.[channelInfo[ENV]]?.botToken ?? ''
     const url = opts.mediaUrl ? await ossUpload(opts.mediaUrl, botToken, 1) : ''
     wsSendRaw(msgCtx, {
       response: opts.text ?? '',
@@ -55,7 +56,7 @@ export async function sendDcgchatMedia(opts: DcgchatMediaSendOptions): Promise<v
 
 export function resolveAccount(cfg: OpenClawConfig, accountId?: string | null): ResolvedDcgchatAccount {
   const id = accountId ?? DEFAULT_ACCOUNT_ID
-  const raw = (cfg.channels?.["dcgchat-test"] as DcgchatConfig | undefined) ?? {}
+  const raw = (cfg.channels?.[channelInfo[ENV]] as DcgchatConfig | undefined) ?? {}
   return {
     accountId: id,
     enabled: raw.enabled !== false,
@@ -69,13 +70,13 @@ export function resolveAccount(cfg: OpenClawConfig, accountId?: string | null):
 }
 
 export const dcgchatPlugin: ChannelPlugin<ResolvedDcgchatAccount> = {
-  id: "dcgchat-test",
+  id: channelInfo[ENV],
   meta: {
-    id: "dcgchat-test",
+    id: channelInfo[ENV],
     label: '书灵墨宝',
     selectionLabel: '书灵墨宝',
     docsPath: '/channels/dcgchat',
-    docsLabel: "dcgchat-test",
+    docsLabel: channelInfo[ENV],
     blurb: '连接 OpenClaw 与 书灵墨宝 产品',
     order: 80
   },
@@ -116,7 +117,7 @@ export const dcgchatPlugin: ChannelPlugin<ResolvedDcgchatAccount> = {
       channels: {
         ...cfg.channels,
         dcgchat: {
-          ...(cfg.channels?.["dcgchat-test"] as Record<string, unknown> | undefined),
+          ...(cfg.channels?.[channelInfo[ENV]] as Record<string, unknown> | undefined),
           enabled
         }
       }
@@ -147,7 +148,7 @@ export const dcgchatPlugin: ChannelPlugin<ResolvedDcgchatAccount> = {
       const isCron = ctx.to.indexOf('dcg-cron:') >= 0
       const to = ctx.to.replace('dcg-cron:', '')
       dcgLogger(`channel sendText to ${ctx.to} `)
-      const outboundCtx = getEffectiveMsgParams(to)
+      const outboundCtx = getOutboundMsgParams(to)
       const cronMsgId = getCronMessageId(to)
       const messageId = !!cronMsgId ? cronMsgId : isCron ? `${Date.now()}` : outboundCtx?.messageId
       if (isWsOpen()) {
@@ -169,21 +170,21 @@ export const dcgchatPlugin: ChannelPlugin<ResolvedDcgchatAccount> = {
         }
       }
       return {
-        channel: "dcgchat-test",
+        channel: channelInfo[ENV],
         messageId: `${messageId}`,
         chatId: to
       }
     },
     sendMedia: async (ctx) => {
       const to = ctx.to.replace('dcg-cron:', '')
-      const msgCtx = getEffectiveMsgParams(to)
+      const msgCtx = getOutboundMsgParams(to)
       const cronMsgId = getCronMessageId(to)
       const isCron = ctx.to.indexOf('dcg-cron:') >= 0
       const messageId = !!cronMsgId ? cronMsgId : isCron ? `${Date.now()}` : msgCtx?.messageId
       dcgLogger(`channel sendMedia to ${ctx.to}`)
       await sendDcgchatMedia({ sessionKey: to ?? '', mediaUrl: ctx.mediaUrl ?? '' })
       return {
-        channel: "dcgchat-test",
+        channel: channelInfo[ENV],
         messageId: `${messageId}`,
         chatId: msgCtx.userId?.toString()
       }

package/src/cron.ts

@@ -2,18 +2,11 @@ import path from 'node:path'
 import fs from 'node:fs'
 import type { IMsgParams } from './types.js'
 import { isWsOpen, mergeDefaultParams, sendEventMessage, sendFinal } from './transport.js'
-import {
-  getCronMessageId,
-  getWorkspaceDir,
-  getWsConnection,
-  removeCronMessageId,
-  setCronMessageId,
-  setMsgStatus
-} from './utils/global.js'
+import { getCronMessageId, getWorkspaceDir, getWsConnection, removeCronMessageId, setCronMessageId } from './utils/global.js'
 import { ossUpload } from './request/oss.js'
 import { dcgLogger } from './utils/log.js'
 import { sendMessageToGateway } from './gateway/socket.js'
-import { getCurrentSessionKey, getEffectiveMsgParams } from './utils/params.js'
+import { getEffectiveMsgParams } from './utils/params.js'
 
 export function getCronJobsPath(): string {
   const workspaceDir = getWorkspaceDir()
@@ -89,12 +82,15 @@ function flushCronUploadQueue(): void {
  * 将 jobs.json 同步到 OSS 并推送事件。30s 内多次调用合并为一次上传；定时触发后清空待处理项，避免重复执行。
  * @param msgCtx 可选；省略时使用当前会话 getEffectiveMsgParams(sessionKey) 快照
  */
-export function sendDcgchatCron(): void {
-  const ctx = msgParamsToCtx(getEffectiveMsgParams(getCurrentSessionKey() ?? ''))
+export function sendDcgchatCron(jobId: string): void {
+  const jobPath = getCronJobsPath()
+  const { sessionKey } = readCronJob(jobPath, jobId) || {}
+  const ctx = msgParamsToCtx(getEffectiveMsgParams(sessionKey))
   if (!ctx) {
     dcgLogger('sendDcgchatCron: no message context (missing token / params)', 'error')
     return
   }
+  dcgLogger(`sessionKey: ${sessionKey}, jobId: ${jobId}`)
   pendingCronUploadCtx = ctx
   if (cronUploadFlushTimer !== null) {
     clearTimeout(cronUploadFlushTimer)

package/src/cronToolCall.ts

@@ -127,7 +127,7 @@ function injectBestEffort(params: Record<string, unknown>, sk: string): Record<s
     ;(newParams.delivery as CronDelivery).bestEffort = true
     ;(newParams.delivery as CronDelivery).to = `dcg-cron:${sk}`
     ;(newParams.delivery as CronDelivery).accountId = agentId
-    ;(newParams.delivery as CronDelivery).channel = "dcgchat-test"
+    ;(newParams.delivery as CronDelivery).channel = channelInfo[ENV]
     newParams.sessionKey = sk
     return newParams
   }
@@ -138,7 +138,7 @@ function injectBestEffort(params: Record<string, unknown>, sk: string): Record<s
     ;(job.delivery as CronDelivery).bestEffort = true
     ;(newParams.delivery as CronDelivery).to = `dcg-cron:${sk}`
     ;(newParams.delivery as CronDelivery).accountId = agentId
-    ;(newParams.delivery as CronDelivery).channel = "dcgchat-test"
+    ;(newParams.delivery as CronDelivery).channel = channelInfo[ENV]
     newParams.sessionKey = sk
     return newParams
   }
@@ -176,7 +176,7 @@ export function cronToolCall(event: { toolName: any; params: any; toolCallId: an
     if (params.command.indexOf('cron create') > -1 || params.command.indexOf('cron add') > -1) {
       const newParams = JSON.parse(JSON.stringify(params)) as Record<string, unknown>
       newParams.command =
-        params.command.replace('--json', '') + `  --session-key ${sk}  --channel ${"dcgchat-test"}  --to dcg-cron:${sk} --json`
+        params.command.replace('--json', '') + `  --session-key ${sk}  --channel ${channelInfo[ENV]}  --to dcg-cron:${sk} --json`
       return { params: newParams }
     } else {
       return params

package/src/request/request.ts

@@ -3,7 +3,7 @@ import axios from 'axios'
 import md5 from 'md5'
 import type { IResponse } from '../types.js'
 import { getUserTokenCache } from './userInfo.js'
-import { getCurrentSessionKey, getEffectiveMsgParams } from '../utils/params.js'
+import { getEffectiveMsgParams } from '../utils/params.js'
 import { ENV } from '../utils/constant.js'
 import { dcgLogger } from '../utils/log.js'
 
@@ -39,9 +39,7 @@ function toCurl(config: {
 }): string {
   const base = config.baseURL ?? ''
   const path = config.url ?? ''
-  const url = path.startsWith('http')
-    ? path
-    : `${base.replace(/\/$/, '')}/${path.replace(/^\//, '')}`
+  const url = path.startsWith('http') ? path : `${base.replace(/\/$/, '')}/${path.replace(/^\//, '')}`
   const method = (config.method ?? 'GET').toUpperCase()
   const headers = config.headers ?? {}
   const parts = ['curl', '-X', method, `'${url}'`]
@@ -82,9 +80,7 @@ export function getSignature(
     sortedKeys
       .map((key) => {
         const val = map[key as keyof typeof map]
-        return val === undefined
-          ? ''
-          : `${key}${typeof val === 'object' ? JSON.stringify(val) : val}`
+        return val === undefined ? '' : `${key}${typeof val === 'object' ? JSON.stringify(val) : val}`
       })
       .join('') + signKey[ENV]
   // 4. MD5 加密并转大写
@@ -130,9 +126,7 @@ axiosInstance.interceptors.request.use(
       if (cachedToken) {
         config.headers = config.headers || {}
         config.headers.authorization = cachedToken
-        dcgLogger(
-          `[request] auto-injected userToken from cache for botToken=${botToken.slice(0, 10)}...`
-        )
+        dcgLogger(`[request] auto-injected userToken from cache for botToken=${botToken.slice(0, 10)}...`)
       }
     }
 
@@ -172,7 +166,7 @@ export function post<T = Record<string, unknown>, R = unknown>(
     botToken?: string
   }
 ): Promise<IResponse<R>> {
-  const params = getEffectiveMsgParams(getCurrentSessionKey() ?? '') || {}
+  const params = getEffectiveMsgParams() || { appId: 100 }
   const config: any = {
     method: 'POST',
     url,

package/src/tool.ts

@@ -2,12 +2,9 @@ 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 { getCurrentSessionKey, getEffectiveMsgParams } from './utils/params.js'
-import { channelInfo, ENV } from './utils/constant.js'
+import { getEffectiveMsgParams } from './utils/params.js'
 import { cronToolCall } from './cronToolCall.js'
 
-let toolCallId = ''
-let toolName = ''
 type PluginHookName =
   | 'before_model_resolve'
   | 'before_prompt_build'
@@ -56,13 +53,8 @@ const eventList = [
 
 function sendToolCallMessage(sk: string, text: string, toolCallId: string, isCover: number) {
   const params = getEffectiveMsgParams(sk)
-  wsSendRaw(params, {
-    is_finish: -1,
-    tool_call_id: toolCallId,
-    is_cover: isCover,
-    thinking_content: text,
-    response: ''
-  })
+  const content = { is_finish: -1, tool_call_id: toolCallId, is_cover: isCover, thinking_content: text, response: '' }
+  wsSendRaw(params, content, false)
 }
 
 /**

package/src/transport.ts

@@ -150,12 +150,13 @@ export function wsSend(ctx: IMsgParams, content: Record<string, unknown>): boole
  * 媒体 / channel 出站：content 保持嵌套对象（单次编码）。
  * `ctx` 须由调用方解析（如需合并覆盖可先 mergeSessionParams）。
  */
-export function wsSendRaw(ctx: IMsgParams, content: Record<string, unknown>): boolean {
+export function wsSendRaw(ctx: IMsgParams, content: Record<string, unknown>, isLog = true): boolean {
   const ws = getWsConnection()
   if (isWsOpen()) {
     ws?.send(JSON.stringify(buildOpenclawBotChat(ctx, content, { mergeChannelDefaults: true })))
-
-    dcgLogger('已发送：' + JSON.stringify(buildOpenclawBotChat(ctx, content, { mergeChannelDefaults: true })))
+    if (isLog) {
+      dcgLogger('已发送：' + JSON.stringify(buildOpenclawBotChat(ctx, content, { mergeChannelDefaults: true })))
+    }
   }
   return true
 }
@@ -195,7 +196,7 @@ export function sendEventMessage(url: string, sessionKey: string) {
           bot_id: ctx.botId,
           agent_id: ctx.agentId,
           session_id: ctx.sessionId,
-          message_id: ctx.messageId || Date.now().toString()
+          message_id: Date.now().toString()
         }
       })
     )

package/src/utils/constant.ts

@@ -1,5 +1,9 @@
 export const ENV: 'production' | 'test' | 'develop' = 'test'
 
+export const channelInfo: Record<string, string> = {
+  production: 'dcgchat',
+  test: 'dcgchat-test'
+}
 
 export const systemCommand = ['/new', '/status']
 export const interruptCommand = ['chat.stop']

package/src/utils/global.ts

@@ -33,7 +33,7 @@ const os = require('os')
 function getWorkspacePath() {
   const workspacePath = path.join(
     os.homedir(),
-    config?.channels?.["dcgchat-test"]?.appId == 110 ? '.mobook' : '.openclaw',
+    config?.channels?.[channelInfo[ENV]]?.appId == 110 ? '.mobook' : '.openclaw',
     'workspace'
   )
   if (fs.existsSync(workspacePath)) {
@@ -123,7 +123,7 @@ export const getSessionKey = (content: any, accountId: string) => {
 
   const route = core.channel.routing.resolveAgentRoute({
     cfg: getOpenClawConfig() as OpenClawConfig,
-    channel: "dcgchat-test",
+    channel: channelInfo[ENV],
     accountId: accountId || 'default',
     peer: { kind: 'direct', id: session_id }
   })

package/src/utils/log.ts

@@ -1,4 +1,5 @@
 import { RuntimeEnv } from 'openclaw/plugin-sdk'
+import { channelInfo, ENV } from './constant.js'
 
 let logger: RuntimeEnv | null = null
 
@@ -10,6 +11,6 @@ export function dcgLogger(message: string, type: 'log' | 'error' = 'log'): void
   if (logger) {
     logger[type](`书灵墨宝🚀 ~ [${new Date().toISOString()}] ${message}`)
   } else {
-    console[type](`书灵墨宝🚀 ~ ${new Date().toISOString()} [${"dcgchat-test"}]: ${message}`)
+    console[type](`书灵墨宝🚀 ~ ${new Date().toISOString()} [${channelInfo[ENV]}]: ${message}`)
   }
 }

package/src/utils/params.ts

@@ -7,12 +7,9 @@ import type { DcgchatConfig, IMsgParams } from '../types.js'
  */
 const paramsMessageMap = new Map<string, IMsgParams>()
 
-/** 最近一次 setParamsMessage 的 key，供不传参的 getEffectiveMsgParams() 使用 */
-let currentSessionKey: string | null = null
-
 /** 从 OpenClaw 配置读取当前 channel 的基础参数（唯一来源，供 transport / resolve 等复用） */
 export function getParamsDefaults(): IMsgParams {
-  const ch = (getOpenClawConfig()?.channels?.["dcgchat-test"] as DcgchatConfig | undefined) ?? {}
+  const ch = (getOpenClawConfig()?.channels?.['dcgchat'] as DcgchatConfig | undefined) ?? {}
   return {
     userId: Number(ch.userId ?? 0),
     botToken: ch.botToken ?? '',
@@ -45,14 +42,25 @@ export function resolveParamsMessage(params: Partial<IMsgParams>): IMsgParams {
  * 统一取值入口：显式 sessionKey，或回落到当前会话；再与配置缺省 merge，保证字段完整。
  */
 export function getEffectiveMsgParams(sessionKey?: string): IMsgParams {
-  const key = sessionKey ?? currentSessionKey
-  const stored = key ? paramsMessageMap.get(key) : undefined
+  const stored = sessionKey ? paramsMessageMap.get(sessionKey) : undefined
   return stored ? resolveParamsMessage(stored) : getParamsDefaults()
 }
 
+/**
+ * Agent `message` 工具常把 `target` 设为用户 ID（如 "150"），而 `setParamsMessage` 使用的 key 是
+ * `effectiveSessionKey`（如 `agent:main:mobook:direct:...`）。若按 preferredKey 查不到 map，
+ * 则回落到当前会话 `currentSessionKey`，避免拿到空 `messageId` / `sessionId` 导致无文件卡片、WS 上下文错误。
+ */
+export function getOutboundMsgParams(preferredKey: string): IMsgParams {
+  const k = preferredKey?.trim()
+  if (k && paramsMessageMap.has(k)) {
+    return getEffectiveMsgParams(k)
+  }
+  return getEffectiveMsgParams()
+}
+
 export function setParamsMessage(sessionKey: string, params: Partial<IMsgParams>) {
   if (!sessionKey) return
-  currentSessionKey = sessionKey
   const previous = paramsMessageMap.get(sessionKey)
   const base = previous ? resolveParamsMessage(previous) : getParamsDefaults()
   paramsMessageMap.set(sessionKey, resolveParamsMessage({ ...base, ...params, sessionKey }))
@@ -61,7 +69,3 @@ export function setParamsMessage(sessionKey: string, params: Partial<IMsgParams>
 export function getParamsMessage(sessionKey: string): IMsgParams | undefined {
   return paramsMessageMap.get(sessionKey)
 }
-
-export function getCurrentSessionKey(): string | null {
-  return currentSessionKey
-}

package/src/utils/searchFile.ts

@@ -90,8 +90,8 @@ const EXT_SORTED_FOR_REGEX = [...EXT_LIST].sort((a, b) => b.length - a.length)
 
 /** 正则交替串（长扩展名优先） */
 const EXT_ALT = `(${EXT_SORTED_FOR_REGEX.join('|')})`
-/** 文件名片段：中文、常见符号、非贪婪 */
-const FILE_NAME_CLASS = `[\\w\\u4e00-\\u9fa5：:《》()（）\\-\\s]+?`
+/** 文件名片段：中文、常见符号、含 `#`、路径 `/`（多段 /mobook/...）、非贪婪 */
+const FILE_NAME_CLASS = `[\\w\\u4e00-\\u9fa5：:《》()（）\\-\\s#/]+?`
 
 /** 预编译，避免 extractMobookFiles 每次调用重复构建正则 */
 const RX_EXTRACT = {
@@ -124,8 +124,17 @@ function toMobookReferencedBasename(p: string): string {
   return parts.length ? parts[parts.length - 1]! : s
 }
 
+/**
+ * 去掉误带入的 Markdown 列表前缀（`- 」「* 」「• 」后须有空格）。
+ * loose 等规则里 FILE_NAME 含 `-`/空白，会把「- 西游记_1.png (…」整段捕获成文件名。
+ * 不要求空格会误伤真实文件名如 `-report.pdf`。
+ */
+function stripMarkdownListPrefixFromBasename(name: string): string {
+  return name.replace(/^[-*•]\s+/, '')
+}
+
 function addMobookMentionedFile(result: Set<string>, raw: string) {
-  const base = toMobookReferencedBasename(raw)
+  const base = stripMarkdownListPrefixFromBasename(toMobookReferencedBasename(raw))
   if (base && isValidFileName(base)) result.add(base)
 }
 
@@ -163,7 +172,9 @@ function collectMobookPathsAfterNeedle(text: string, lower: string, needle: stri
     }
     const base = raw.slice(0, -(matchedExt.length + 1))
     const fileName = `${base}.${matchedExt}`
-    if (isValidFileName(fileName)) {
+    // 可能是 mobook 下多级路径；整段含 / 会被 isValidFileName 误判为非法，只校验最后一段（与 addMobookMentionedFile 最终取的 basename 一致）
+    const leaf = path.basename(fileName.replace(/\\/g, '/'))
+    if (isValidFileName(leaf)) {
       addMobookMentionedFile(result, fileName)
     }
     from = start + 1
@@ -273,12 +284,22 @@ function findMobookFileByBasename(mobookRoot: string, basename: string): string
   return undefined
 }
 
-function getMobookRoot(): string | undefined {
+/** Windows 默认 `C:\mobook`；类 Unix（含 Linux/macOS）为 `~/mobook`。原先 Linux 返回 undefined，会导致只认工作区 mobook、无法回落到用户目录。 */
+function getMobookRoot(): string {
   if (process.platform === 'win32') return path.join('C:\\', 'mobook')
-  if (process.platform === 'darwin') return path.join(os.homedir(), 'mobook')
-  return undefined
+  return path.join(os.homedir(), 'mobook')
 }
 
+/**
+ * 按「文件名或 /mobook/ 相对路径」解析磁盘上的真实路径。
+ *
+ * 仍可能找不到的情况：
+ * - 文件不在候选路径（工作区根、工作区/mobook、用户 mobook）下，或路径写错。
+ * - Windows 下 mobook 不在 `C:\\mobook`（仅尝试该盘符下的 mobook + 上述候选）。
+ * - 递归查找超出深度/目录数上限（见 MOBOOK_FIND_*）。
+ * - 多子目录下存在同名文件：按深度优先先命中哪一个即返回哪一个。
+ * - Linux 等大小写敏感文件系统：模型输出的文件名大小写与磁盘不一致会失败。
+ */
 export function getFilePathByFile(file: string) {
   const ws = getWorkspaceDir()
   const candidates: string[] = [file]