@mhfire/dsh-im-bridge 0.1.1 → 0.1.3

package/README.en.md

@@ -0,0 +1,82 @@
+[中文](./README.md) | English
+
+# @mhfire/dsh-im-bridge
+
+WeCom AI Bot ⇄ DeepSeek Harness Agent bridge — a **DSH plugin**.
+
+Creates Agents **in-process** inside a dsh profile (no child-process spawn): per-sender durable sessions (the same WeCom user reuses one session with memory), sessions registered with the Web GUI (live view and continue-chat), plus a Settings → Plugins card (`allowFrom` / `agentTimeoutSec` / `startHint`, written to `settings.yaml` with hot reload).
+
+## Install
+
+### Recommended: npm package
+
+```powershell
+dsh plugin --profile web add @mhfire/dsh-im-bridge
+# Or pin a version:
+# dsh plugin --profile web add @mhfire/dsh-im-bridge@0.1.2
+```
+
+In `$DSH_HOME/profiles/web/cordis.patch.yml` (or your profile), supply credentials only (other fields ship as bundle defaults and can be overridden):
+
+```yaml
+- id: im-bridge
+  config:
+    botId: "<your BotID>"
+    secret: "<your Secret>"
+    # optional: workspace / personaFile / … — see Configuration below
+```
+
+Restart dsh to apply (e.g. `dsh web` / `pnpm dsh web`).
+
+### Optional: local development
+
+Install from this repo’s `plugin/` directory or a `file:` path:
+
+```powershell
+dsh plugin --profile web add <package-path>
+```
+
+If `botId` / `secret` are missing, the plugin still loads (does not block `dsh web`); logs warn that WeCom connect is skipped. You can fill credentials in Settings → Plugins; **restart** is required to connect (this release does not hot-start the WebSocket).
+
+## Configuration
+
+The bundle `cordis.patch.yml` supplies defaults for every field except `botId` / `secret`. Full field list:
+
+| Field | Description |
+|---|---|
+| `botId` / `secret` | WeCom AI Bot credentials (`role('secret')`, redacted in UI); when empty, WeCom side is skipped and the host keeps running |
+| `workspace` | Agent working directory (session cwd) |
+| `allowFrom` | Allowed sender userids; empty = allow everyone |
+| `agentTimeoutSec` | Max seconds per task; also drives progress / ETA |
+| `startHint` | Placeholder text when processing starts |
+| `agentPreset` | Agent preset to mount (default `standard`) |
+| `persona` / `personaFile` | Bot persona (system prompt); `personaFile` wins; do not commit secrets |
+| `maxReplyBytes` | Reply size cap in bytes (default 20000) |
+| `deniedMessage` | Reply when the sender is not on `allowFrom` (editable in Settings) |
+| `welcomeMessage` | Welcome text on `enter_chat` (editable in Settings) |
+| `thinking` | Streaming “thinking” animation: `phases` / `spin` / `eggs` / `eggAfterSec` / `intervalMs` / `activityPrefix`; override via profile patch (not the simple Settings card) |
+
+Example `thinking.phases` override:
+
+```yaml
+thinking:
+  intervalMs: 1500
+  phases:
+    - atSec: 0
+      text: '🤔 Understanding your request…'
+```
+
+## Persona
+
+`persona.md` is the bot persona: role and behavior rules, injected as a system prompt each session.
+Copy `persona.example.md` to `persona.md` and edit; supports `{{model}}` / `{{cwd}}`.
+The file may contain credentials and is gitignored — do not commit it.
+
+## Security
+
+- Do not commit secret-bearing files such as `config.json` / `persona.md`
+- Session and tool output may contain adversarial text; the plugin’s safety prompt tells the agent not to treat tool output as instructions
+
+## License
+
+MIT

package/README.md

@@ -1,3 +1,5 @@
+中文 | [English](./README.en.md)
+
 # @mhfire/dsh-im-bridge
 
 企业微信智能机器人 ⇄ DeepSeek Harness Agent 桥接 **DSH 插件**。
@@ -6,28 +8,43 @@
 
 ## 安装
 
+### 推荐：从 npm 安装
+
 ```powershell
-dsh plugin --profile web add <本包路径>
+dsh plugin --profile web add @mhfire/dsh-im-bridge
+# 或钉版本：
+# dsh plugin --profile web add @mhfire/dsh-im-bridge@0.1.2
 ```
 
-在 profile 的 `cordis.patch.yml` 中配置：
+在 `$DSH_HOME/profiles/web/cordis.patch.yml`（或对应 profile）中补密钥即可（其余项已有 bundle 默认，可按需覆盖）：
 
 ```yaml
 - id: im-bridge
   config:
     botId: "<你的 BotID>"
     secret: "<你的 Secret>"
-    workspace: "<Agent 工作目录>"
-    personaFile: "<绝对路径>/persona.md"
+    # 可选：workspace / personaFile 等，见下方配置项
 ```
 
-重启 dsh 进程即可使用。
+重启 dsh 进程即可使用（例如 `dsh web` / `pnpm dsh web`）。
+
+### 备选：本地开发
+
+从本仓库 `plugin/` 目录或 `file:` 路径安装：
+
+```powershell
+dsh plugin --profile web add <本包路径>
+```
+
+未配置 `botId` / `secret` 时插件仍会加载（不阻塞 `dsh web`），日志会提示跳过企微连线；Settings → 插件配置页仍可填写，保存后**重启**进程才会连接（本版本不做热启连）。
 
 ## 配置项
 
+bundle 的 `cordis.patch.yml` 已为除 `botId` / `secret` 外的字段提供默认值；下表为完整说明。
+
 | 字段 | 说明 |
 |---|---|
-| `botId` / `secret` | 企业微信智能机器人凭证（`role('secret')`，UI 自动脱敏） |
+| `botId` / `secret` | 企业微信智能机器人凭证（`role('secret')`，UI 自动脱敏）；缺省时跳过企微侧，不阻塞主进程 |
 | `workspace` | Agent 工作目录（会话 cwd） |
 | `allowFrom` | 允许的发送者 userid 白名单；空 = 允许所有人 |
 | `agentTimeoutSec` | 单任务最长执行时间（秒），动画进度条/剩余估算的基准 |
@@ -35,6 +52,19 @@ dsh plugin --profile web add <本包路径>
 | `agentPreset` | Agent 加入的 preset（默认 `standard`） |
 | `persona` / `personaFile` | 机器人「人设」（系统提示词）；`personaFile` 优先，含敏感信息请勿入库 |
 | `maxReplyBytes` | 回复上限（字节，默认 20000） |
+| `deniedMessage` | 非白名单用户的拒绝文案（Settings 可编） |
+| `welcomeMessage` | 进入会话欢迎语（Settings 可编） |
+| `thinking` | 流式思考动画：`phases` / `spin` / `eggs` / `eggAfterSec` / `intervalMs` / `activityPrefix`；结构请在 profile patch 覆盖，简易卡片不编辑 |
+
+`thinking.phases` 示例（profile 覆盖时可只改文案）：
+
+```yaml
+thinking:
+  intervalMs: 1500
+  phases:
+    - atSec: 0
+      text: '🤔 正在理解你的需求…'
+```
 
 ## 人设（persona）
 

package/cordis.patch.yml

@@ -1,6 +1,47 @@
-# dsh-im-bridge bundle patch: 声明插件行。
-# 密钥(botId/secret)等敏感配置由 profile 层($DSH_HOME/profiles/web/cordis.patch.yml)覆盖,
-# 不要写在这里。
+# dsh-im-bridge bundle patch: 插入插件行并给出非密钥默认配置。
+# botId/secret 由 profile 层 ($DSH_HOME/profiles/<name>/cordis.patch.yml) 或 Settings 覆盖。
 - insert:
     - id: im-bridge
       name: '@mhfire/dsh-im-bridge'
+      config:
+        workspace: !!js process.cwd()
+        allowFrom: []
+        startHint: '🧠 正在思考...'
+        agentTimeoutSec: 600
+        agentPreset: standard
+        persona: ''
+        personaFile: ''
+        maxReplyBytes: 20000
+        deniedMessage: '无权访问本服务'
+        welcomeMessage: '👋 办公助手已就绪。直接发消息即可，例如查文件、整理文档、查资料或处理日常事务。'
+        thinking:
+          eggAfterSec: 240
+          intervalMs: 1500
+          activityPrefix: '🛠️ 正在执行 '
+          spin:
+            - '🧠'
+            - '💭'
+            - '✨'
+            - '🔎'
+            - '⚡'
+          eggs:
+            - '📎 顺手把要点整理好了，稍后一起给你'
+            - '📶 网络有点忙，让它慢慢跑'
+            - '🎯 结果快出来了，坚持一下'
+            - '🗂️ 资料较多，正在汇总中'
+            - '🌙 别盯着了，完成会自动通知你'
+          phases:
+            - atSec: 0
+              text: '🤔 正在理解你的需求…'
+            - atSec: 8
+              text: '📋 正在整理任务清单'
+            - atSec: 25
+              text: '🔍 正在查找相关资料'
+            - atSec: 55
+              text: '✍️ 正在处理文档/数据'
+            - atSec: 120
+              text: '🧠 正在思考最佳方案…'
+            - atSec: 240
+              text: '⏳ 任务较繁琐，请稍候…'
+            - atSec: 420
+              text: '☕ 快好了，正在收尾…'

package/lib/client.js

@@ -18,6 +18,8 @@ var FIELDS = [
   { field: 'allowFrom', label: '允许的发送者 userid（逗号分隔，空 = 所有人）', kind: 'text' },
   { field: 'agentTimeoutSec', label: '单任务超时（秒）', kind: 'number' },
   { field: 'startHint', label: '开始处理时的占位提示', kind: 'text' },
+  { field: 'deniedMessage', label: '非白名单拒绝文案', kind: 'text' },
+  { field: 'welcomeMessage', label: '进入会话欢迎语', kind: 'text' },
 ];
 
 function fmt(f, v) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mhfire/dsh-im-bridge",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "企业微信智能机器人 ⇄ DeepSeek Harness Agent 桥接插件：进程内创建 Agent(per-sender 持久会话)，会话在 GUI 实时可见；含 Settings 插件配置卡片",
   "license": "MIT",
   "repository": {
@@ -19,7 +19,8 @@
     "src",
     "lib",
     "cordis.patch.yml",
-    "persona.example.md"
+    "persona.example.md",
+    "README.en.md"
   ],
   "dsh": {
     "bundle": {

package/src/index.js

@@ -19,7 +19,7 @@ import z from '@deepseek-ai/schemastery'
 import { createUserMessage } from '@deepseek-ai/dsh-llm'
 import { SessionId } from '@deepseek-ai/dsh-session'
 import { installModelSelection } from '@deepseek-ai/dsh-agent'
-import { startThinking, sendFinal, truncate, footerOf, fmtDuration } from './wecom.js'
+import { startThinking, sendFinal, truncate, footerOf, fmtDuration, DEFAULT_THINKING } from './wecom.js'
 
 /** 稳定插件名 */
 export const name = 'im-bridge'
@@ -27,10 +27,24 @@ export const name = 'im-bridge'
 /** 依赖的核心服务 */
 export const inject = ['agents', 'sessions', 'agentDefaultModel']
 
-/** 插件配置(zod): 敏感项由 profile 层 patch 提供 */
+const ThinkingPhase = z.object({
+  atSec: z.number(),
+  text: z.string(),
+})
+
+const ThinkingConfig = z.object({
+  phases: z.array(ThinkingPhase).default(DEFAULT_THINKING.phases),
+  spin: z.array(String).default(DEFAULT_THINKING.spin),
+  eggs: z.array(String).default(DEFAULT_THINKING.eggs),
+  eggAfterSec: z.number().default(DEFAULT_THINKING.eggAfterSec),
+  intervalMs: z.number().default(DEFAULT_THINKING.intervalMs),
+  activityPrefix: z.string().default(DEFAULT_THINKING.activityPrefix),
+})
+
+/** 插件配置(zod): 敏感项由 profile 层 patch 或 Settings 提供；缺省时跳过企微连线，不阻塞主进程 */
 export const Config = z.object({
-  botId: z.string().required().role('secret'),
-  secret: z.string().required().role('secret'),
+  botId: z.string().default('').role('secret'),
+  secret: z.string().default('').role('secret'),
   /** Agent 的工作目录(会话 cwd) */
   workspace: z.string().default(process.cwd()),
   /** 允许的发送者 userid 白名单; 空 = 允许所有人 */
@@ -47,6 +61,12 @@ export const Config = z.object({
   personaFile: z.string().default(''),
   /** 回复上限(字节) */
   maxReplyBytes: z.number().default(20000),
+  /** 流式思考动画素材(阶段/表情/彩蛋等); 可在 profile patch 覆盖 */
+  thinking: ThinkingConfig.default(DEFAULT_THINKING),
+  /** 非白名单用户的拒绝文案 */
+  deniedMessage: z.string().default('无权访问本服务'),
+  /** 用户进入会话时的欢迎语 */
+  welcomeMessage: z.string().default('👋 办公助手已就绪。直接发消息即可，例如查文件、整理文档、查资料或处理日常事务。'),
 })
 
 /** 收集一次 turn 内最后一条 assistant 文本与结束原因 */
@@ -90,14 +110,11 @@ export function apply(ctx, config) {
     throw new Error('im-bridge: 需要 agents/sessions/agentDefaultModel 服务')
   }
 
-  // per-sender 持久会话状态: sender -> { agent, sessionId, queue, lastActivity }
-  const senders = new Map()
-  const persona = resolvePersona(config)
-
   // ── 设置命名空间: 用户可在 GUI 插件配置页 / settings.yaml 覆盖字段(热生效) ──
   // 规范做法(与 @deepseek-ai/dsh-settings 的 installSettingsSection 一致):
   // 用 ctx.inject(['settings'], cb) 延迟到 settings 服务可用时再注册,
   // 避免 apply 时 settings 尚未挂载导致命名空间缺失(GUI 卡片显示"命名空间不可用")。
+  // 缺凭证时仍注册, 便于在 Settings 补齐后再重启启用企微。
   let scope
   ctx.inject(['settings'], (sctx) => {
     scope = sctx.settings.register('im-bridge', Config, { base: { ...config } })
@@ -105,66 +122,83 @@ export function apply(ctx, config) {
   /** 有效配置: 默认值 → cordis patch(base) → 用户 settings.yaml, 热更新 */
   const cfg = () => scope?.value ?? config
 
-  /** 创建(或复用)某发送者的 Agent(会话/上下文持久于进程内) */
-  async function ensureAgent(sender) {
-    let st = senders.get(sender)
-    if (st !== undefined && st.agent !== undefined) return st
-    const sessionId = SessionId(`session-${randomUUID()}`)
-    const selection = defaultModel.currentSelection()
-    // 有 preset roster 的部署(如 web profile)必须在 setup 里 mount,
-    // 否则 agent 看不到任何工具(模型只能编造工具调用)。
-    const presets = ctx.get('agentPresets')
-    let resolvedId = cfg().agentPreset
-    if (presets !== undefined) {
-      resolvedId = (await presets.resolve(cfg().agentPreset)).id
+  // ── 企微 WebSocket: 延迟到 loader settle 后启动, 不占启动关键路径 ──
+  void (async () => {
+    await ctx.get('loader')?.await()
+    const { botId, secret } = cfg()
+    if (!botId || !secret) {
+      console.warn(
+        '[im-bridge] 跳过启动: 缺少 botId/secret。请在 profile cordis.patch.yml 或 Settings → 插件配置中填写后重启。',
+      )
+      return
     }
-    const { agent } = await agents.create({
-      sessionId,
-      meta: { cwd: cfg().workspace, agentPreset: resolvedId },
-      agentOptions: { provider: selection.provider, model: selection.model },
-      setup: async (agentCtx) => {
-        const selected = { current: selection, assembled: undefined }
-        installModelSelection(agentCtx, selected)
-        if (presets !== undefined) await presets.mount(agentCtx, resolvedId)
-        if (persona !== '') {
-          agentCtx.inject(['systemPrompt'], (promptCtx) => {
-            promptCtx.systemPrompt.section({
-              name: 'deployment:persona', // 同名 scoped section 覆盖部署 persona(仅本 agent)
-              order: 0,
-              text: persona,
-            })
-          })
-        }
-      },
-    })
-    st = { agent, sessionId, queue: Promise.resolve(), lastActivity: '' }
-    senders.set(sender, st)
-    console.log(`[im-bridge] 为 ${sender} 创建会话 ${sessionId}`)
-    return st
-  }
 
-  // 会话事件 → 真实活动状态(工具调用名), 让动画显示"正在做什么"
-  ctx.on('session/event', (session, event) => {
-    if (event.type !== 'tool/call') return
-    for (const st of senders.values()) {
-      if (st.sessionId === session.id) st.lastActivity = `🛠️ 正在执行 ${event.data.name}`
+    // per-sender 持久会话状态: sender -> { agent, sessionId, queue, lastActivity }
+    const senders = new Map()
+    const persona = resolvePersona(cfg())
+
+    /** 创建(或复用)某发送者的 Agent(会话/上下文持久于进程内) */
+    async function ensureAgent(sender) {
+      let st = senders.get(sender)
+      if (st !== undefined && st.agent !== undefined) return st
+      const sessionId = SessionId(`session-${randomUUID()}`)
+      const selection = defaultModel.currentSelection()
+      // 有 preset roster 的部署(如 web profile)必须在 setup 里 mount,
+      // 否则 agent 看不到任何工具(模型只能编造工具调用)。
+      const presets = ctx.get('agentPresets')
+      let resolvedId = cfg().agentPreset
+      if (presets !== undefined) {
+        resolvedId = (await presets.resolve(cfg().agentPreset)).id
+      }
+      const { agent } = await agents.create({
+        sessionId,
+        meta: { cwd: cfg().workspace, agentPreset: resolvedId },
+        agentOptions: { provider: selection.provider, model: selection.model },
+        setup: async (agentCtx) => {
+          const selected = { current: selection, assembled: undefined }
+          installModelSelection(agentCtx, selected)
+          if (presets !== undefined) await presets.mount(agentCtx, resolvedId)
+          if (persona !== '') {
+            agentCtx.inject(['systemPrompt'], (promptCtx) => {
+              promptCtx.systemPrompt.section({
+                name: 'deployment:persona', // 同名 scoped section 覆盖部署 persona(仅本 agent)
+                order: 0,
+                text: persona,
+              })
+            })
+          }
+        },
+      })
+      st = { agent, sessionId, queue: Promise.resolve(), lastActivity: '' }
+      senders.set(sender, st)
+      console.log(`[im-bridge] 为 ${sender} 创建会话 ${sessionId}`)
+      return st
     }
-  })
 
-  // ── 企微 WebSocket: 延迟到 loader settle 后启动, 不占启动关键路径 ──
-  void (async () => {
-    await ctx.get('loader')?.await()
-    const { default: AiBot } = await import('@wecom/aibot-node-sdk')
+    // 会话事件 → 真实活动状态(工具调用名), 让动画显示"正在做什么"
+    ctx.on('session/event', (session, event) => {
+      if (event.type !== 'tool/call') return
+      const prefix = cfg().thinking?.activityPrefix ?? DEFAULT_THINKING.activityPrefix
+      for (const st of senders.values()) {
+        if (st.sessionId === session.id) st.lastActivity = `${prefix}${event.data.name}`
+      }
+    })
+
+    const { default: AiBot, generateReqId } = await import('@wecom/aibot-node-sdk')
 
     /** 处理一条消息: 动画 → followup → 汇总 → 简报 */
     async function handle(frame, sender, content) {
       const st = await ensureAgent(sender)
       const startedAt = Date.now()
-      const streamId = AiBot.generateReqId('stream')
+      const streamId = generateReqId('stream')
       let stopThinking = null
       try {
         await ws.replyStream(frame, streamId, cfg().startHint, false)
-        stopThinking = startThinking(ws, frame, streamId, startedAt, cfg().agentTimeoutSec, () => st.lastActivity || '')
+        stopThinking = startThinking(
+          ws, frame, streamId, startedAt, cfg().agentTimeoutSec,
+          () => st.lastActivity || '',
+          cfg().thinking,
+        )
       } catch (e) {
         console.error(`[im-bridge] 占位回复失败: ${e.message}`)
       }
@@ -195,7 +229,7 @@ export function apply(ctx, config) {
       }
     }
 
-    const ws = new AiBot.WSClient({ botId: cfg().botId, secret: cfg().secret })
+    const ws = new AiBot.WSClient({ botId, secret })
 
     ws.on('connected', () => console.log('[im-bridge] WebSocket 已连接'))
     ws.on('authenticated', () => console.log('[im-bridge] 认证成功, 等待消息...'))
@@ -208,7 +242,7 @@ export function apply(ctx, config) {
       if (!content) return
       const sender = frame.body?.sender?.userid || frame.body?.from?.userid || frame.body?.userid || 'unknown'
       if (cfg().allowFrom.length > 0 && !cfg().allowFrom.includes(sender)) {
-        ws.replyStream(frame, AiBot.generateReqId('stream'), '无权访问本服务', true).catch(() => {})
+        ws.replyStream(frame, generateReqId('stream'), cfg().deniedMessage, true).catch(() => {})
         return
       }
       console.log(`[im-bridge] 收到 from=${sender}: ${content.slice(0, 100)}`)
@@ -224,7 +258,7 @@ export function apply(ctx, config) {
       console.log(`[im-bridge] 用户 ${sender} 进入会话`)
       ws.replyWelcome(frame, {
         msgtype: 'text',
-        text: { content: '👋 云PC 诊断助手已就绪。直接发消息即可让我诊断设备/服务状态。' },
+        text: { content: cfg().welcomeMessage },
       }).catch((e) => console.error(`[im-bridge] 欢迎语失败: ${e.message}`))
     })
 

package/src/wecom.js

@@ -2,7 +2,31 @@
  * wecom.js — 企业微信交互封装: 流式动画(v3) + 最终简报 + 发送助手。
  * 逻辑移植自旧版 im-bridge/bridge.js, 改为纯 ESM 供插件使用。
  */
-import AiBot from '@wecom/aibot-node-sdk'
+import { generateReqId } from '@wecom/aibot-node-sdk'
+
+/** 流式思考动画的默认素材(可被 Config.thinking / cordis patch 覆盖) */
+export const DEFAULT_THINKING = {
+  phases: [
+    { atSec: 0, text: '🤔 正在理解你的需求…' },
+    { atSec: 8, text: '📋 正在整理任务清单' },
+    { atSec: 25, text: '🔍 正在查找相关资料' },
+    { atSec: 55, text: '✍️ 正在处理文档/数据' },
+    { atSec: 120, text: '🧠 正在思考最佳方案…' },
+    { atSec: 240, text: '⏳ 任务较繁琐，请稍候…' },
+    { atSec: 420, text: '☕ 快好了，正在收尾…' },
+  ],
+  spin: ['🧠', '💭', '✨', '🔎', '⚡'],
+  eggs: [
+    '📎 顺手把要点整理好了，稍后一起给你',
+    '📶 网络有点忙，让它慢慢跑',
+    '🎯 结果快出来了，坚持一下',
+    '🗂️ 资料较多，正在汇总中',
+    '🌙 别盯着了，完成会自动通知你',
+  ],
+  eggAfterSec: 240,
+  intervalMs: 1500,
+  activityPrefix: '🛠️ 正在执行 ',
+}
 
 /** 毫秒 → 人类可读时长(如 "9 分 47 秒") */
 export function fmtDuration(ms) {
@@ -37,46 +61,42 @@ export function truncate(text, max) {
 }
 
 /**
- * 流式动画 v3(办公助手人设): 阶段化人格台词 + 旋转表情 + 进度条 + 已用时/剩余估算 + 长任务彩蛋。
- * 每 1.5s 更新一次同一条流式消息(共用 streamId), 直到 agent 完成。返回停止函数。
- * @param {() => string} [activity] - 可选: 返回当前真实活动描述(如 "📋 正在执行 <操作>"), 覆盖阶段台词。
+ * 流式动画 v3: 阶段化台词 + 旋转表情 + 进度条 + 已用时/剩余估算 + 长任务彩蛋。
+ * 每 intervalMs 更新一次同一条流式消息(共用 streamId), 直到 agent 完成。返回停止函数。
+ * @param {() => string} [activity] - 可选: 返回当前真实活动描述, 覆盖阶段台词。
+ * @param {typeof DEFAULT_THINKING} [thinking] - 动画素材; 缺省用 {@link DEFAULT_THINKING}。
  */
-export function startThinking(ws, frame, streamId, startedAt, timeoutSec, activity) {
-  const PHASES = [
-    [0, '🤔 正在理解你的需求…'],
-    [8, '📋 正在整理任务清单'],
-    [25, '🔍 正在查找相关资料'],
-    [55, '✍️ 正在处理文档/数据'],
-    [120, '🧠 正在思考最佳方案…'],
-    [240, '⏳ 任务较繁琐，请稍候…'],
-    [420, '☕ 快好了，正在收尾…'],
-  ]
-  const SPIN = ['🧠', '💭', '✨', '🔎', '⚡']
-  const EGGS = [
-    '📎 顺手把要点整理好了，稍后一起给你',
-    '📶 网络有点忙，让它慢慢跑',
-    '🎯 结果快出来了，坚持一下',
-    '🗂️ 资料较多，正在汇总中',
-    '🌙 别盯着了，完成会自动通知你',
-  ]
+export function startThinking(ws, frame, streamId, startedAt, timeoutSec, activity, thinking) {
+  const t = { ...DEFAULT_THINKING, ...(thinking || {}) }
+  const phases = Array.isArray(t.phases) && t.phases.length > 0 ? t.phases : DEFAULT_THINKING.phases
+  const spin = Array.isArray(t.spin) && t.spin.length > 0 ? t.spin : DEFAULT_THINKING.spin
+  const eggs = Array.isArray(t.eggs) && t.eggs.length > 0 ? t.eggs : DEFAULT_THINKING.eggs
+  const eggAfterSec = Number.isFinite(t.eggAfterSec) ? t.eggAfterSec : DEFAULT_THINKING.eggAfterSec
+  const intervalMs = Number.isFinite(t.intervalMs) && t.intervalMs > 0 ? t.intervalMs : DEFAULT_THINKING.intervalMs
   const total = Number.isFinite(timeoutSec) && timeoutSec > 0 ? timeoutSec : 600
   let i = 0
   const timer = setInterval(() => {
     const secs = Math.floor((Date.now() - startedAt) / 1000)
     const live = activity ? activity() : ''
-    let stage = PHASES[0][1]
-    if (!live) for (const [t, s] of PHASES) if (secs >= t) stage = s
+    let stage = phases[0].text
+    if (!live) {
+      for (const p of phases) {
+        if (secs >= p.atSec) stage = p.text
+      }
+    }
     const pct = Math.min(Math.floor((secs / total) * 100), 99)
     const filled = '█'.repeat(Math.floor(pct / 10))
     const bar = secs < 3 ? '' : `\n${filled}${'░'.repeat(10 - filled.length)} ${String(pct).padStart(2)}%`
     const remain = Math.max(total - secs, 0)
     const remainTxt = secs < 3 ? '' : ` · 预计还剩 ${Math.floor(remain / 60)}分${remain % 60}秒`
-    const egg = secs >= 240 ? `\n${EGGS[Math.floor(secs / 60) % EGGS.length]}` : ''
-    const emoji = SPIN[i % SPIN.length]
+    const egg = secs >= eggAfterSec && eggs.length > 0
+      ? `\n${eggs[Math.floor(secs / 60) % eggs.length]}`
+      : ''
+    const emoji = spin[i % spin.length]
     i++
     const status = live || stage
     ws.replyStream(frame, streamId, `${emoji} ${status}   ⏱ ${secs} 秒${remainTxt}${bar}${egg}`, false).catch(() => {})
-  }, 1500)
+  }, intervalMs)
   return () => clearInterval(timer)
 }
 
@@ -86,6 +106,6 @@ export async function sendFinal(ws, frame, streamId, content) {
     await ws.replyStream(frame, streamId, content, true)
   } catch (e) {
     console.error(`[im-bridge] 原流最终回复失败(${e.message}), 尝试新流...`)
-    await ws.replyStream(frame, AiBot.generateReqId('stream'), content, true)
+    await ws.replyStream(frame, generateReqId('stream'), content, true)
   }
 }