@dcrays/dcgchat 0.2.34 → 0.3.18

package/src/tool.ts

@@ -1,7 +1,10 @@
 import type { OpenClawPluginApi } from 'openclaw/plugin-sdk'
-import { getMsgParams, getMsgStatus, getWsConnection } from './utils/global.js'
+import { getMsgStatus } from './utils/global.js'
 import { dcgLogger } from './utils/log.js'
-import { isWsOpen, sendFinal, sendText } from './transport.js'
+import { sendFinal, sendText, wsSendRaw } from './transport.js'
+import { getCurrentSessionKey, getEffectiveMsgParams } from './utils/params.js'
+import { channelInfo, ENV } from './utils/constant.js'
+import { cronToolCall } from './cronToolCall.js'
 
 let toolCallId = ''
 let toolName = ''
@@ -30,8 +33,10 @@ type PluginHookName =
   | 'subagent_ended'
   | 'gateway_start'
   | 'gateway_stop'
+
+// message_received 没有 sessionKey 前置到bot中执行
 const eventList = [
-  { event: 'message_received', message: '' },
+  // { event: 'message_received', message: '' },
   // {event: 'before_model_resolve', message: ''},
   // {event: 'before_prompt_build', message: '正在查阅背景资料，构建思考逻辑'},
   // {event: 'before_agent_start', message: '书灵墨宝已就位，准备开始执行任务'},
@@ -49,80 +54,78 @@ const eventList = [
   { event: 'after_tool_call', message: '' }
 ]
 
-function sendToolCallMessage(text: string, toolCallId: string, isCover: number) {
-  const ws = getWsConnection()
-  const params = getMsgParams()
-  if (isWsOpen()) {
-    ws?.send(
-      JSON.stringify({
-        messageType: 'openclaw_bot_chat',
-        _userId: params?.userId,
-        source: 'client',
-        is_finish: -1,
-        content: {
-          is_finish: -1,
-          bot_token: params?.token,
-          domain_id: params?.domainId,
-          app_id: params?.appId,
-          bot_id: params?.botId,
-          agent_id: params?.agentId,
-          tool_call_id: toolCallId,
-          is_cover: isCover,
-          thinking_content: text,
-          response: '',
-          session_id: params?.sessionId,
-          message_id: params?.messageId || Date.now().toString()
-        }
-      })
-    )
-  }
+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: ''
+  })
+}
+
+/**
+ * 深拷贝 params 并注入 bestEffort: true
+ */
+interface CronDelivery {
+  mode?: string
+  channel?: string
+  to?: string
+  bestEffort?: boolean
+  [key: string]: unknown
 }
 
 export function monitoringToolMessage(api: OpenClawPluginApi) {
   for (const item of eventList) {
-    api.on(item.event as PluginHookName, (event: any) => {
-      const status = getMsgStatus()
-      if (status === 'running') {
-        dcgLogger(`工具调用结果： ~ event:${item.event}`)
-        if (['after_tool_call', 'before_tool_call'].includes(item.event)) {
-          const { result: _result, ...rest } = event
-          const text = JSON.stringify({
-            type: item.event,
-            specialIdentification: 'dcgchat_tool_call_special_identification',
-            callId: event.toolCallId || event.runId || Date.now().toString(),
-            ...rest,
-            status: item.event === 'after_tool_call' ? 'finished' : 'running'
-          })
-          sendToolCallMessage(text, event.toolCallId || event.runId || Date.now().toString(), item.event === 'after_tool_call' ? 1 : 0)
-        } else if (item.event) {
-          if (item.event === 'llm_output') {
-            if (event.lastAssistant?.errorMessage === '429-账户额度耗尽') {
-              const params = getMsgParams()
-              const message = '您的积分已消耗完，您可以通过充值积分来继续使用'
-              const ctx = {
-                userId: params.userId,
-                botToken: params.token,
-                domainId: params.domainId,
-                appId: params.appId,
-                botId: params.botId,
-                agentId: params.agentId,
-                sessionId: params.sessionId,
-                messageId: params.messageId
+    api.on(item.event as PluginHookName, (event: any, args: any) => {
+      const sk = args?.sessionKey as string
+      if (sk) {
+        const status = getMsgStatus(sk)
+        if (status === 'running') {
+          if (['after_tool_call', 'before_tool_call'].includes(item.event)) {
+            const { result: _result, ...rest } = event
+            dcgLogger(`工具调用结果： ~ event:${item.event} ~ params:${JSON.stringify(rest)}`)
+
+            if (item.event === 'before_tool_call') {
+              return cronToolCall(rest, sk)
+            }
+            const text = JSON.stringify({
+              type: item.event,
+              specialIdentification: 'dcgchat_tool_call_special_identification',
+              callId: event.toolCallId || event.runId || Date.now().toString(),
+              ...rest,
+              status: item.event === 'after_tool_call' ? 'finished' : 'running'
+            })
+            sendToolCallMessage(
+              sk,
+              text,
+              event.toolCallId || event.runId || Date.now().toString(),
+              item.event === 'after_tool_call' ? 1 : 0
+            )
+          } else if (item.event) {
+            const msgCtx = getEffectiveMsgParams(sk)
+            if (item.event === 'llm_output') {
+              if (event.lastAssistant?.errorMessage === '1003-额度不足请充值') {
+                const message = '您的积分已消耗完，您可以通过充值积分来继续使用'
+                sendText(message, msgCtx, { message_tags: { insufficient_balance: 1 }, is_finish: -1 })
+                sendFinal(msgCtx, '积分不足')
+                return
               }
-              sendText(ctx, message, { message_tags: { insufficient_balance: 1 }, is_finish: -1 })
-              sendFinal(ctx)
-              return
             }
+            const text = JSON.stringify({
+              type: item.event,
+              specialIdentification: 'dcgchat_tool_call_special_identification',
+              toolName: '',
+              callId: event.runId || Date.now().toString(),
+              params: item.message
+            })
+            sendToolCallMessage(sk, text, event.runId || Date.now().toString(), 0)
+            dcgLogger(`工具调用结果： ~ event:${item.event} ${status}`)
           }
-          const text = JSON.stringify({
-            type: item.event,
-            specialIdentification: 'dcgchat_tool_call_special_identification',
-            toolName: '',
-            callId: event.runId || Date.now().toString(),
-            params: item.message
-          })
-          sendToolCallMessage(text, event.runId || Date.now().toString(), 0)
         }
+      } else {
+        dcgLogger(`工具调用结果： ~ event:${item.event} ~ 没有sessionKey 为执行`)
       }
     })
   }

package/src/transport.ts

@@ -1,19 +1,22 @@
 import { getWsConnection } from './utils/global.js'
 import { dcgLogger } from './utils/log.js'
+import type { IMsgParams } from './types.js'
+import { getEffectiveMsgParams, getParamsDefaults } from './utils/params.js'
 
-export type DcgchatMsgContext = {
-  userId: number
-  botToken: string
-  domainId?: string
-  appId?: string
-  botId?: string
-  agentId?: string
-  sessionId: string
-  messageId: string
+/** 用 sessionKey 从 map 取参，再合并 overrides（channel 出站、媒体等） */
+export function mergeSessionParams(sessionKey: string, overrides?: Partial<IMsgParams>): IMsgParams {
+  const base = getEffectiveMsgParams(sessionKey)
+  if (!overrides) return base
+  return { ...base, ...overrides }
+}
+export function mergeDefaultParams(overrides?: Partial<IMsgParams>): IMsgParams {
+  const base = getParamsDefaults()
+  if (!overrides) return base
+  return { ...base, ...overrides }
 }
 
-export function createMsgContext(msg: {
-  _userId: number
+export type InboundMsgForContext = {
+  _userId: number | string
   content: {
     bot_token: string
     domain_id?: string
@@ -23,86 +26,176 @@ export function createMsgContext(msg: {
     session_id: string
     message_id: string
   }
-}): DcgchatMsgContext {
+}
+
+export type OpenclawBotChatEnvelope = {
+  messageType: 'openclaw_bot_chat'
+  _userId: number | undefined
+  source: 'client'
+  content: Record<string, unknown>
+}
+
+function isInboundWire(arg: unknown): arg is InboundMsgForContext {
+  return Boolean(arg && typeof arg === 'object' && '_userId' in arg && 'content' in arg)
+}
+
+/** 下行 WebSocket 帧 → 内部上下文（字段缺省用 channel 配置补） */
+function inboundToCtx(msg: InboundMsgForContext, d: IMsgParams): IMsgParams {
+  const c = msg.content
   return {
-    userId: msg._userId,
-    botToken: msg.content.bot_token,
-    domainId: msg.content.domain_id,
-    appId: msg.content.app_id,
-    botId: msg.content.bot_id,
-    agentId: msg.content.agent_id,
-    sessionId: msg.content.session_id,
-    messageId: msg.content.message_id
+    userId: Number(msg._userId ?? d.userId),
+    botToken: c.bot_token ?? d.botToken,
+    domainId: String(c.domain_id ?? d.domainId),
+    appId: String(c.app_id ?? d.appId),
+    botId: c.bot_id,
+    agentId: c.agent_id,
+    sessionId: c.session_id,
+    messageId: c.message_id
   }
 }
 
-function buildContent(ctx: DcgchatMsgContext, extra: Record<string, unknown>) {
+/** 上行：与配置合并缺省后再 `...ctx` 覆盖（原 wsSendRaw） */
+function mergeOutboundWithDefaults(ctx: IMsgParams, d: IMsgParams): IMsgParams {
+  return {
+    userId: Number(ctx.userId ?? d.userId),
+    botToken: ctx.botToken ?? d.botToken,
+    domainId: String(ctx.domainId ?? d.domainId),
+    appId: String(ctx.appId ?? d.appId),
+    ...ctx
+  }
+}
+
+/**
+ * 组装完整 wire `content` 对象：先写会话/机器人基础字段（回落到 d），再合并调用方传入的 payload。
+ * `content` 在使用处构造（如 response、state、files），同名键可覆盖基础字段。
+ */
+export function buildWireContent(base: IMsgParams, d: IMsgParams, content: Record<string, unknown>): Record<string, unknown> {
+  const resolvedBotToken = base.botToken ?? d.botToken
+  const domain = base.domainId ?? d.domainId
+  const app = base.appId ?? d.appId
   return {
-    bot_token: ctx.botToken,
-    domain_id: ctx.domainId,
-    app_id: ctx.appId,
-    bot_id: ctx.botId,
-    agent_id: ctx.agentId,
-    session_id: ctx.sessionId,
-    message_id: ctx.messageId || Date.now().toString(),
-    ...extra
+    bot_token: base.botToken || resolvedBotToken,
+    domain_id: base.domainId || domain,
+    app_id: base.appId || app,
+    bot_id: base.botId,
+    agent_id: base.agentId,
+    session_id: base.sessionId,
+    message_id: base.messageId || Date.now().toString(),
+    ...content
   }
 }
 
-function buildEnvelope(ctx: DcgchatMsgContext, extra: Record<string, unknown>) {
+/** 上行：在已合并的 ctx 上套 openclaw_bot_chat 信封（messageType / _userId / source + content） */
+function buildOutboundOpenclawBotChatEnvelope(
+  ctx: IMsgParams,
+  content: Record<string, unknown>,
+  opts?: { mergeChannelDefaults?: boolean }
+): OpenclawBotChatEnvelope {
+  const d = getParamsDefaults()
+  const base = opts?.mergeChannelDefaults ? mergeOutboundWithDefaults(ctx, d) : ctx
   return {
-    messageType: 'openclaw_bot_chat' as const,
-    _userId: ctx.userId,
-    source: 'client' as const,
-    content: buildContent(ctx, extra)
+    messageType: 'openclaw_bot_chat',
+    _userId: base.userId,
+    source: 'client',
+    content: buildWireContent(base, d, content)
   }
 }
 
+/**
+ * 下行解析为 DcgchatMsgContext，或上行组装 openclaw_bot_chat 信封。
+ * 上行时 `content` 由调用方传入；基础参数来自 `ctx` 与 `getParamsDefaults()`（可选 mergeChannelDefaults，同原 wsSendRaw）。
+ */
+export function buildOpenclawBotChat(msg: InboundMsgForContext): IMsgParams
+export function buildOpenclawBotChat(
+  ctx: IMsgParams,
+  content: Record<string, unknown>,
+  opts?: { mergeChannelDefaults?: boolean }
+): OpenclawBotChatEnvelope
+export function buildOpenclawBotChat(
+  arg1: InboundMsgForContext | IMsgParams,
+  arg2?: Record<string, unknown>,
+  opts?: { mergeChannelDefaults?: boolean }
+): IMsgParams | OpenclawBotChatEnvelope {
+  const d = getParamsDefaults()
+
+  if (arg2 === undefined && isInboundWire(arg1)) {
+    return inboundToCtx(arg1, d)
+  }
+
+  const ctx = arg1 as IMsgParams
+  return buildOutboundOpenclawBotChatEnvelope(ctx, arg2 ?? {}, opts)
+}
+
 export function isWsOpen(): boolean {
   const isOpen = getWsConnection()?.readyState === WebSocket.OPEN
   if (!isOpen) {
-    dcgLogger(`socket not ready ${getWsConnection()?.readyState}`, 'error')
+    dcgLogger(`server socket not ready ${getWsConnection()?.readyState}`, 'error')
   }
   return isOpen
 }
 
 /**
- * Content is stringified separately (double-encoded) to match the
- * dcgchat wire protocol used by the chat stream path.
+ * 聊天流路径：content 单独 JSON.stringify（双重编码），符合 dcgchat 协议。
+ * `ctx` 须由调用方用 getEffectiveMsgParams(sessionKey) 等解析好；`content` 为完整业务 payload。
  */
-export function wsSend(ctx: DcgchatMsgContext, extra: Record<string, unknown>): boolean {
+export function wsSend(ctx: IMsgParams, content: Record<string, unknown>): boolean {
   const ws = getWsConnection()
   if (ws?.readyState !== WebSocket.OPEN) return false
-  const envelope = buildEnvelope(ctx, extra)
+  const envelope = buildOpenclawBotChat(ctx, content)
   ws.send(JSON.stringify({ ...envelope, content: JSON.stringify(envelope.content) }))
   return true
 }
 
 /**
- * Content stays as a nested object (single-encoded).
- * Matches the legacy wire format used by media and outbound-pipeline messages.
+ * 媒体 / channel 出站：content 保持嵌套对象（单次编码）。
+ * `ctx` 须由调用方解析（如需合并覆盖可先 mergeSessionParams）。
  */
-export function wsSendRaw(ctx: DcgchatMsgContext, extra: Record<string, unknown>): boolean {
+export function wsSendRaw(ctx: IMsgParams, content: Record<string, unknown>): boolean {
   const ws = getWsConnection()
   if (isWsOpen()) {
-    ws?.send(JSON.stringify(buildEnvelope(ctx, extra)))
+    ws?.send(JSON.stringify(buildOpenclawBotChat(ctx, content, { mergeChannelDefaults: true })))
   }
   return true
 }
 
-export function sendChunk(ctx: DcgchatMsgContext, text: string): boolean {
-  return wsSend(ctx, { response: text, state: 'chunk' })
+export function sendChunk(text: string, ctx: IMsgParams, chunkIdx: number): boolean {
+  return wsSend(ctx, { response: text, state: 'chunk', chunk_idx: chunkIdx })
 }
 
-export function sendFinal(ctx: DcgchatMsgContext): boolean {
-  dcgLogger(` message handling complete state: final`)
+export function sendFinal(ctx: IMsgParams, tag?: string): boolean {
+  dcgLogger(` message handling complete state: final tag:${tag}`)
   return wsSend(ctx, { response: '', state: 'final' })
 }
 
-export function sendText(ctx: DcgchatMsgContext, text: string, event?: Record<string, unknown>): boolean {
+export function sendText(text: string, ctx: IMsgParams, event?: Record<string, unknown>): boolean {
   return wsSend(ctx, { response: text, ...event })
 }
 
-export function sendError(ctx: DcgchatMsgContext, errorMsg: string): boolean {
+export function sendError(errorMsg: string, ctx: IMsgParams): boolean {
   return wsSend(ctx, { response: `[错误] ${errorMsg}`, state: 'final' })
 }
+
+export function sendEventMessage(url: string, sessionKey: string) {
+  const ctx = getEffectiveMsgParams(sessionKey)
+  const ws = getWsConnection()
+  if (isWsOpen()) {
+    ws?.send(
+      JSON.stringify({
+        messageType: 'openclaw_bot_event',
+        source: 'client',
+        content: {
+          event_type: 'cron',
+          operation_type: 'install',
+          bot_token: ctx.botToken,
+          domain_id: ctx.domainId,
+          app_id: ctx.appId,
+          oss_url: url,
+          bot_id: ctx.botId,
+          agent_id: ctx.agentId,
+          session_id: ctx.sessionId,
+          message_id: ctx.messageId || Date.now().toString()
+        }
+      })
+    )
+  }
+}

package/src/types.ts

@@ -44,6 +44,7 @@ export type InboundMessage = {
     bot_id?: string
     agent_id?: string
     session_id: string
+    real_mobook: string | number
     message_id: string
     text: string
     files?: {
@@ -115,12 +116,16 @@ export interface IStsTokenReq {
 }
 
 export interface IMsgParams {
-  userId: number
-  token: string
-  sessionId: string
-  messageId: string
-  domainId: string
-  appId: string
-  botId: string
-  agentId: string
+  userId?: number
+  botToken?: string
+  sessionId?: string
+  messageId?: string
+  domainId?: string
+  appId?: string
+  botId?: string
+  agentId?: string
+  /** 与 OpenClaw 路由一致，用于 map 与异步链路（工具 / HTTP / cron）对齐当前会话 */
+  sessionKey?: string
+  real_mobook?: string | number
+  is_finish?: number
 }

package/src/utils/constant.ts

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

package/src/utils/global.ts

@@ -24,7 +24,6 @@ export function getOpenClawConfig(): OpenClawConfig | null {
 
 import type { OpenClawConfig, PluginRuntime } from 'openclaw/plugin-sdk'
 import { dcgLogger } from './log.js'
-import { IMsgParams } from '../types.js'
 import { channelInfo, ENV } from './constant.js'
 
 const path = require('path')
@@ -69,20 +68,22 @@ export function getDcgchatRuntime(): PluginRuntime {
   return runtime as PluginRuntime
 }
 
-let msgParams = {} as IMsgParams
-export function setMsgParams(params: any) {
-  msgParams = params
-}
-export function getMsgParams() {
-  return msgParams
-}
+export type MsgSessionStatus = 'running' | 'finished' | ''
 
-let msgStatus: 'running' | 'finished' | '' = ''
-export function setMsgStatus(status: 'running' | 'finished' | '') {
-  msgStatus = status
+const msgStatusBySessionKey = new Map<string, MsgSessionStatus>()
+
+export function setMsgStatus(sessionKey: string, status: MsgSessionStatus) {
+  if (!sessionKey?.trim()) return
+  if (status === '') {
+    msgStatusBySessionKey.delete(sessionKey)
+  } else {
+    msgStatusBySessionKey.set(sessionKey, status)
+  }
 }
-export function getMsgStatus() {
-  return msgStatus
+
+export function getMsgStatus(sessionKey: string): MsgSessionStatus {
+  if (!sessionKey?.trim()) return ''
+  return msgStatusBySessionKey.get(sessionKey) ?? ''
 }
 
 const getMediaKey = (url: string) => url.split(/[\\/]/).pop() ?? url
@@ -115,3 +116,30 @@ export function clearSentMediaKeys(messageId?: string) {
     sentMediaKeysBySession.clear()
   }
 }
+
+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",
+    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) {
+  cronMessageIdMap.set(sk, messageId)
+}
+
+export function getCronMessageId(sk: string): string {
+  return cronMessageIdMap.get(sk) ?? ''
+}
+
+export function removeCronMessageId(sk: string) {
+  cronMessageIdMap.delete(sk)
+}

package/src/utils/params.ts

@@ -0,0 +1,67 @@
+import { channelInfo, ENV } from './constant.js'
+import { getOpenClawConfig } from './global.js'
+import type { DcgchatConfig, IMsgParams } from '../types.js'
+
+/**
+ * map key 是 session_key，value 为该会话下已 merge 后的消息参数。
+ */
+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"] as DcgchatConfig | undefined) ?? {}
+  return {
+    userId: Number(ch.userId ?? 0),
+    botToken: ch.botToken ?? '',
+    sessionId: '',
+    messageId: '',
+    domainId: String(ch.domainId ?? '1000'),
+    appId: String(ch.appId ?? '100'),
+    botId: '',
+    agentId: '',
+    sessionKey: ''
+  }
+}
+
+export function resolveParamsMessage(params: Partial<IMsgParams>): IMsgParams {
+  const defaults = getParamsDefaults()
+  return {
+    userId: Number(params.userId ?? defaults.userId),
+    botToken: params.botToken ?? defaults.botToken,
+    sessionId: params.sessionId ?? defaults.sessionId,
+    messageId: params.messageId ?? defaults.messageId,
+    domainId: String(params.domainId ?? defaults.domainId),
+    appId: String(params.appId ?? defaults.appId),
+    botId: params.botId ?? defaults.botId,
+    agentId: params.agentId ?? defaults.agentId,
+    sessionKey: params.sessionKey ?? defaults.sessionKey
+  }
+}
+
+/**
+ * 统一取值入口：显式 sessionKey，或回落到当前会话；再与配置缺省 merge，保证字段完整。
+ */
+export function getEffectiveMsgParams(sessionKey?: string): IMsgParams {
+  const key = sessionKey ?? currentSessionKey
+  const stored = key ? paramsMessageMap.get(key) : undefined
+  return stored ? resolveParamsMessage(stored) : getParamsDefaults()
+}
+
+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 }))
+}
+
+export function getParamsMessage(sessionKey: string): IMsgParams | undefined {
+  return paramsMessageMap.get(sessionKey)
+}
+
+export function getCurrentSessionKey(): string | null {
+  return currentSessionKey
+}

package/src/utils/searchFile.ts

@@ -94,11 +94,9 @@ function stripMobookNoise(s: string) {
 }
 
 /**
- * 从文本中扫描 `/mobook/` 片段，按最长后缀匹配合法扩展名（兜底，不依赖 FILE_NAME 字符集）
+ * 从文本中扫描 `.../mobook/...` 或 `...\mobook\...` 片段，按最长后缀匹配合法扩展名（兜底）
  */
-function collectMobookPathsByScan(text: string, result: Set<string>): void {
-  const lower = text.toLowerCase()
-  const needle = '/mobook/'
+function collectMobookPathsAfterNeedle(text: string, lower: string, needle: string, result: Set<string>): void {
   let from = 0
   while (from < text.length) {
     const i = lower.indexOf(needle, from)
@@ -136,8 +134,16 @@ function collectMobookPathsByScan(text: string, result: Set<string>): void {
   }
 }
 
+function collectMobookPathsByScan(text: string, result: Set<string>): void {
+  const lower = text.toLowerCase()
+  collectMobookPathsAfterNeedle(text, lower, '/mobook/', result)
+  collectMobookPathsAfterNeedle(text, lower, '\\mobook\\', result)
+}
+
 export function extractMobookFiles(text = '') {
   if (typeof text !== 'string' || !text.trim()) return []
+  // 全角冒号（中文输入常见）→ 半角，便于匹配 c：\mobook\
+  text = text.replace(/\uFF1A/g, ':')
   const result = new Set<string>()
   // ✅ 扩展名（必须长扩展名优先，见 EXT_SORTED_FOR_REGEX）
   const EXT = `(${EXT_SORTED_FOR_REGEX.join('|')})`
@@ -157,6 +163,14 @@ export function extractMobookFiles(text = '') {
     ;(text.match(fullPathReg) || []).forEach((p) => {
       result.add(normalizePath(p))
     })
+    // 2️⃣b Windows 实际保存路径：C:\mobook\xxx、c:/mobook/xxx、\mobook\xxx（模型常写反斜杠，原先无法识别）
+    const winMobookReg = new RegExp(`(?:[a-zA-Z]:)?[/\\\\]mobook[/\\\\]${FILE_NAME}\\.${EXT}`, 'gi')
+    ;(text.match(winMobookReg) || []).forEach((full) => {
+      const name = full.replace(/^(?:[a-zA-Z]:)?[/\\\\]mobook[/\\\\]/i, '').trim()
+      if (isValidFileName(name)) {
+        result.add(normalizePath(`/mobook/${name}`))
+      }
+    })
     // 3️⃣ mobook下的 xxx.xxx
     const inlineReg = new RegExp(`mobook下的\\s*(${FILE_NAME}\\.${EXT})`, 'gi')
     ;(text.match(inlineReg) || []).forEach((item) => {