@mhfire/dsh-im-bridge 0.1.0 → 0.1.2

package/README.md

@@ -23,11 +23,13 @@ dsh plugin --profile web add <本包路径>
 
 重启 dsh 进程即可使用。
 
+未配置 `botId` / `secret` 时插件仍会加载（不阻塞 `dsh web`），日志会提示跳过企微连线；Settings → 插件配置页仍可填写，保存后**重启**进程才会连接（本版本不做热启连）。
+
 ## 配置项
 
 | 字段 | 说明 |
 |---|---|
-| `botId` / `secret` | 企业微信智能机器人凭证（`role('secret')`，UI 自动脱敏） |
+| `botId` / `secret` | 企业微信智能机器人凭证（`role('secret')`，UI 自动脱敏）；缺省时跳过企微侧，不阻塞主进程 |
 | `workspace` | Agent 工作目录（会话 cwd） |
 | `allowFrom` | 允许的发送者 userid 白名单；空 = 允许所有人 |
 | `agentTimeoutSec` | 单任务最长执行时间（秒），动画进度条/剩余估算的基准 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mhfire/dsh-im-bridge",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "企业微信智能机器人 ⇄ DeepSeek Harness Agent 桥接插件：进程内创建 Agent(per-sender 持久会话)，会话在 GUI 实时可见；含 Settings 插件配置卡片",
   "license": "MIT",
   "repository": {

package/src/index.js

@@ -27,10 +27,10 @@ export const name = 'im-bridge'
 /** 依赖的核心服务 */
 export const inject = ['agents', 'sessions', 'agentDefaultModel']
 
-/** 插件配置(zod): 敏感项由 profile 层 patch 提供 */
+/** 插件配置(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 白名单; 空 = 允许所有人 */
@@ -90,75 +90,86 @@ 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 覆盖字段(热生效) ──
-  const settings = ctx.get('settings')
+  // 规范做法(与 @deepseek-ai/dsh-settings 的 installSettingsSection 一致):
+  // 用 ctx.inject(['settings'], cb) 延迟到 settings 服务可用时再注册,
+  // 避免 apply 时 settings 尚未挂载导致命名空间缺失(GUI 卡片显示"命名空间不可用")。
+  // 缺凭证时仍注册, 便于在 Settings 补齐后再重启启用企微。
   let scope
-  if (settings !== undefined) {
-    scope = settings.register('im-bridge', Config, { base: { ...config } })
-  }
+  ctx.inject(['settings'], (sctx) => {
+    scope = sctx.settings.register('im-bridge', Config, { base: { ...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
+      for (const st of senders.values()) {
+        if (st.sessionId === session.id) st.lastActivity = `🛠️ 正在执行 ${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)
@@ -193,7 +204,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] 认证成功, 等待消息...'))
@@ -206,7 +217,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'), '无权访问本服务', true).catch(() => {})
         return
       }
       console.log(`[im-bridge] 收到 from=${sender}: ${content.slice(0, 100)}`)

package/src/wecom.js

@@ -2,7 +2,7 @@
  * wecom.js — 企业微信交互封装: 流式动画(v3) + 最终简报 + 发送助手。
  * 逻辑移植自旧版 im-bridge/bridge.js, 改为纯 ESM 供插件使用。
  */
-import AiBot from '@wecom/aibot-node-sdk'
+import { generateReqId } from '@wecom/aibot-node-sdk'
 
 /** 毫秒 → 人类可读时长(如 "9 分 47 秒") */
 export function fmtDuration(ms) {
@@ -86,6 +86,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)
   }
 }