@neomei/opencode-qiwei 0.1.0

package/README.md

@@ -0,0 +1,38 @@
+# opencode-qiwei
+
+OpenCode 企业微信桥接 — 让 OpenCode 接入企业微信
+
+基于企业微信智能机器人 WebSocket 长连接通道，提供：
+- 消息收发（文本、图片、语音、文件）
+- 流式回复（Markdown 渲染）
+- 模板卡片交互（按钮、投票、选择）
+- 自动权限批准
+
+## 安装
+
+```bash
+npm install -g @neomei/opencode-qiwei
+```
+
+## 配置
+
+```json
+// ~/.config/opencode/qiwei.json
+{
+  "botId": "your-bot-id",
+  "corpSecret": "your-secret",
+  "agentId": 1000001,
+  "token": "your-token",
+  "encodingAESKey": "your-43-char-aes-key",
+  "opencodeUrl": "http://localhost:19876",
+  "streaming": true,
+  "showProcess": "tools",
+  "autoApprove": true
+}
+```
+
+## 使用
+
+```bash
+opencode-qiwei start
+```

package/bin/opencode-qiwei

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+/**
+ * opencode-qiwei CLI — 企业微信桥接命令行工具
+ */
+
+import { startStandalone } from '../dist/standalone.js';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { createInterface } from 'readline';
+
+const QIWEI_CONFIG = join(homedir(), '.config', 'opencode', 'qiwei.json');
+
+async function runSetup() {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  const ask = (q) => new Promise(r => rl.question(q, r));
+
+  console.log('\n📋 企业微信智能机器人配置向导\n');
+  console.log('请在企业微信管理后台获取以下信息：');
+  console.log('  应用管理 → 智能机器人 → 接收消息\n');
+
+  const botId = await ask('机器人 ID (botId): ');
+  const secret = await ask('机器人 Secret: ');
+
+  rl.close();
+
+  const config = {
+    botId: botId.trim(),
+    secret: secret.trim(),
+    corpId: 'placeholder',
+    corpSecret: 'placeholder',
+    agentId: 1000001,
+    token: 'placeholder-token',
+    encodingAESKey: 'placeholder-aes-key-43-characters-here',
+    opencodeUrl: 'http://localhost:19876',
+    streaming: true,
+    requireMention: true,
+    groupPolicy: 'open',
+    showProcess: 'tools',
+    autoApprove: true,
+  };
+
+  mkdirSync(join(homedir(), '.config', 'opencode'), { recursive: true });
+  writeFileSync(QIWEI_CONFIG, JSON.stringify(config, null, 2));
+  console.log(`\n✅ 配置已保存到 ${QIWEI_CONFIG}`);
+  console.log('现在可以运行 opencode-qiwei start 启动桥接\n');
+}
+
+async function runDoctor() {
+  console.log('\n🔍 opencode-qiwei 连接预检\n');
+
+  if (!existsSync(QIWEI_CONFIG)) {
+    console.log('❌ 配置文件不存在');
+    console.log('   运行 opencode-qiwei setup 创建配置\n');
+    process.exit(1);
+  }
+
+  const config = JSON.parse(readFileSync(QIWEI_CONFIG, 'utf-8'));
+
+  console.log(`✅ 配置文件: ${QIWEI_CONFIG}`);
+  console.log(`   botId: ${config.botId}`);
+  console.log(`   OpenCode: ${config.opencodeUrl}`);
+
+  try {
+    const res = await fetch(config.opencodeUrl);
+    console.log(`✅ OpenCode 可达 (${res.status})`);
+  } catch {
+    console.log('❌ OpenCode 不可达');
+  }
+
+  try {
+    await import('@wecom/aibot-node-sdk');
+    console.log('✅ 企业微信 SDK 已加载');
+  } catch (e) {
+    console.log(`❌ SDK 加载失败: ${e.message}`);
+  }
+
+  console.log('');
+}
+
+async function main() {
+  const cmd = process.argv[2] || 'start';
+
+  try {
+    if (cmd === 'setup') return await runSetup();
+    if (cmd === 'doctor') return await runDoctor();
+    if (cmd === 'status') { console.log('opencode-qiwei v0.1.0'); return; }
+    if (cmd === 'start') return await startStandalone();
+    console.log('用法: opencode-qiwei <start|setup|doctor|status>');
+  } catch (err) {
+    console.error('错误:', err.message);
+    process.exit(1);
+  }
+}
+
+main();

package/dist/core/config.d.ts

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+import type { WecomConfig } from './types.js';
+declare const WecomConfigSchema: z.ZodObject<{
+    botId: z.ZodString;
+    secret: z.ZodString;
+    corpId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    corpSecret: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    agentId: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    token: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    encodingAESKey: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    opencodeUrl: z.ZodDefault<z.ZodString>;
+    streaming: z.ZodDefault<z.ZodBoolean>;
+    requireMention: z.ZodDefault<z.ZodBoolean>;
+    groupPolicy: z.ZodDefault<z.ZodEnum<["open", "allowlist", "disabled"]>>;
+    allowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    showProcess: z.ZodDefault<z.ZodEnum<["none", "tools", "thinking", "full"]>>;
+    autoApprove: z.ZodDefault<z.ZodBoolean>;
+    scene: z.ZodOptional<z.ZodNumber>;
+    plugVersion: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    botId: string;
+    secret: string;
+    corpId: string;
+    corpSecret: string;
+    agentId: number;
+    token: string;
+    encodingAESKey: string;
+    opencodeUrl: string;
+    streaming: boolean;
+    requireMention: boolean;
+    groupPolicy: "open" | "allowlist" | "disabled";
+    showProcess: "none" | "tools" | "thinking" | "full";
+    autoApprove: boolean;
+    allowlist?: string[] | undefined;
+    scene?: number | undefined;
+    plugVersion?: string | undefined;
+}, {
+    botId: string;
+    secret: string;
+    allowlist?: string[] | undefined;
+    corpId?: string | undefined;
+    corpSecret?: string | undefined;
+    agentId?: number | undefined;
+    token?: string | undefined;
+    encodingAESKey?: string | undefined;
+    opencodeUrl?: string | undefined;
+    streaming?: boolean | undefined;
+    requireMention?: boolean | undefined;
+    groupPolicy?: "open" | "allowlist" | "disabled" | undefined;
+    showProcess?: "none" | "tools" | "thinking" | "full" | undefined;
+    autoApprove?: boolean | undefined;
+    scene?: number | undefined;
+    plugVersion?: string | undefined;
+}>;
+export declare class ConfigManager {
+    private configPath;
+    constructor(configPath?: string);
+    load(): WecomConfig;
+    save(config: WecomConfig): void;
+}
+export { WecomConfigSchema };
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBrB,CAAC;AAIH,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,CAAC,EAAE,MAAM;IAI/B,IAAI,IAAI,WAAW;IAUnB,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;CAKhC;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/core/config.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+const WecomConfigSchema = z.object({
+    botId: z.string().min(1),
+    secret: z.string().min(1),
+    corpId: z.string().optional().default(''),
+    corpSecret: z.string().optional().default(''),
+    agentId: z.number().int().positive().optional().default(1000001),
+    token: z.string().optional().default(''),
+    encodingAESKey: z.string().optional().default(''),
+    opencodeUrl: z.string().url().default('http://localhost:19876'),
+    streaming: z.boolean().default(true),
+    requireMention: z.boolean().default(true),
+    groupPolicy: z.enum(['open', 'allowlist', 'disabled']).default('allowlist'),
+    allowlist: z.array(z.string()).optional(),
+    showProcess: z.enum(['none', 'tools', 'thinking', 'full']).default('tools'),
+    autoApprove: z.boolean().default(false),
+    scene: z.number().int().optional(),
+    plugVersion: z.string().optional(),
+});
+const DEFAULT_CONFIG_PATH = join(homedir(), '.config', 'opencode', 'qiwei.json');
+export class ConfigManager {
+    configPath;
+    constructor(configPath) {
+        this.configPath = configPath || DEFAULT_CONFIG_PATH;
+    }
+    load() {
+        const dir = dirname(this.configPath);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        if (!existsSync(this.configPath)) {
+            throw new Error(`配置文件不存在: ${this.configPath}\n请先配置企业微信凭证`);
+        }
+        const raw = JSON.parse(readFileSync(this.configPath, 'utf-8'));
+        return WecomConfigSchema.parse(raw);
+    }
+    save(config) {
+        const dir = dirname(this.configPath);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        writeFileSync(this.configPath, JSON.stringify(config, null, 2));
+    }
+}
+export { WecomConfigSchema };
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"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"}

package/dist/core/group-policy.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 群聊策略处理
+ */
+export declare class GroupPolicy {
+    /**
+     * 检查是否需要 @ 机器人才回复
+     * 企微文本消息中，@ 机器人会以 @机器人名 的形式出现在内容开头
+     * 群聊消息中如果不 @ 机器人，则不回复
+     */
+    static shouldReply(text: string, chatType: 'single' | 'group', requireMention: boolean, botName?: string): boolean;
+}
+//# sourceMappingURL=group-policy.d.ts.map

package/dist/core/group-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-policy.d.ts","sourceRoot":"","sources":["../../src/core/group-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,WAAW;IACtB;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,GAAG,OAAO,EAC5B,cAAc,EAAE,OAAO,EACvB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO;CAeX"}

package/dist/core/group-policy.js

@@ -0,0 +1,26 @@
+/**
+ * 群聊策略处理
+ */
+export class GroupPolicy {
+    /**
+     * 检查是否需要 @ 机器人才回复
+     * 企微文本消息中，@ 机器人会以 @机器人名 的形式出现在内容开头
+     * 群聊消息中如果不 @ 机器人，则不回复
+     */
+    static shouldReply(text, chatType, requireMention, botName) {
+        // 单聊永远回复
+        if (chatType === 'single')
+            return true;
+        // 群聊：不需要 @ 则直接回复
+        if (!requireMention)
+            return true;
+        // 群聊需要 @ — 检查是否 @ 了机器人
+        if (botName && text.includes(`@${botName}`))
+            return true;
+        // 通用 @ 检测
+        if (text.startsWith('@') || text.includes('@'))
+            return true;
+        return false;
+    }
+}
+//# sourceMappingURL=group-policy.js.map

package/dist/core/group-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-policy.js","sourceRoot":"","sources":["../../src/core/group-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,WAAW;IACtB;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAChB,IAAY,EACZ,QAA4B,EAC5B,cAAuB,EACvB,OAAgB;QAEhB,SAAS;QACT,IAAI,QAAQ,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAEvC,iBAAiB;QACjB,IAAI,CAAC,cAAc;YAAE,OAAO,IAAI,CAAC;QAEjC,uBAAuB;QACvB,IAAI,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,OAAO,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC;QAEzD,UAAU;QACV,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAE5D,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/core/logger.d.ts

@@ -0,0 +1,8 @@
+/** 轻量日志工具 */
+export declare function createLogger(module: string): {
+    info(msg: string, data?: any): void;
+    warn(msg: string, data?: any): void;
+    error(msg: string, data?: any): void;
+    debug(msg: string, data?: any): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM;cAG7B,MAAM,SAAS,GAAG;cAGlB,MAAM,SAAS,GAAG;eAGjB,MAAM,SAAS,GAAG;eAGlB,MAAM,SAAS,GAAG;EAIhC"}

package/dist/core/logger.js

@@ -0,0 +1,20 @@
+/** 轻量日志工具 */
+export function createLogger(module) {
+    const prefix = `[${module}]`;
+    return {
+        info(msg, data) {
+            console.log(`${prefix} ${msg}`, data ? JSON.stringify(data).slice(0, 200) : '');
+        },
+        warn(msg, data) {
+            console.warn(`${prefix} ⚠️  ${msg}`, data ? JSON.stringify(data).slice(0, 200) : '');
+        },
+        error(msg, data) {
+            console.error(`${prefix} ❌ ${msg}`, data ? JSON.stringify(data).slice(0, 200) : '');
+        },
+        debug(msg, data) {
+            if (process.env.DEBUG)
+                console.log(`${prefix} 🔍 ${msg}`, data ? JSON.stringify(data).slice(0, 200) : '');
+        },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,MAAM,GAAG,IAAI,MAAM,GAAG,CAAC;IAC7B,OAAO;QACL,IAAI,CAAC,GAAW,EAAE,IAAU;YAC1B,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,IAAI,CAAC,GAAW,EAAE,IAAU;YAC1B,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,QAAQ,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACvF,CAAC;QACD,KAAK,CAAC,GAAW,EAAE,IAAU;YAC3B,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,MAAM,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtF,CAAC;QACD,KAAK,CAAC,GAAW,EAAE,IAAU;YAC3B,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK;gBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,OAAO,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5G,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/media-handler.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 企微媒体文件处理
+ * 下载并解密企微发送的图片/文件/语音/视频
+ */
+import type { WSClient } from '@wecom/aibot-node-sdk';
+export interface DownloadedMedia {
+    buffer: Buffer;
+    filename: string;
+    mimeType: string;
+}
+export declare class MediaHandler {
+    /**
+     * 从企微消息中下载并解密文件
+     * @param url - 加密的文件 URL（5分钟有效）
+     * @param aesKey - Base64 编码的 AES 解密密钥
+     */
+    static download(wsClient: WSClient, url: string, aesKey?: string): Promise<DownloadedMedia | null>;
+    /** 上传文件获取 media_id（用于主动发送） */
+    static upload(wsClient: WSClient, fileBuffer: Buffer, type: 'image' | 'file' | 'voice' | 'video', filename: string): Promise<string | null>;
+    private static guessMimeType;
+}
+//# sourceMappingURL=media-handler.d.ts.map

package/dist/core/media-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-handler.d.ts","sourceRoot":"","sources":["../../src/core/media-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAKtD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,YAAY;IACvB;;;;OAIG;WACU,QAAQ,CACnB,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAclC,8BAA8B;WACjB,MAAM,CACjB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,EAC1C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAUzB,OAAO,CAAC,MAAM,CAAC,aAAa;CAY7B"}

package/dist/core/media-handler.js

@@ -0,0 +1,51 @@
+/**
+ * 企微媒体文件处理
+ * 下载并解密企微发送的图片/文件/语音/视频
+ */
+import { createLogger } from './logger.js';
+const log = createLogger('MediaHandler');
+export class MediaHandler {
+    /**
+     * 从企微消息中下载并解密文件
+     * @param url - 加密的文件 URL（5分钟有效）
+     * @param aesKey - Base64 编码的 AES 解密密钥
+     */
+    static async download(wsClient, url, aesKey) {
+        try {
+            const result = await wsClient.downloadFile(url, aesKey);
+            return {
+                buffer: result.buffer,
+                filename: result.filename || 'download',
+                mimeType: MediaHandler.guessMimeType(result.filename || ''),
+            };
+        }
+        catch (err) {
+            log.error('文件下载失败', { err });
+            return null;
+        }
+    }
+    /** 上传文件获取 media_id（用于主动发送） */
+    static async upload(wsClient, fileBuffer, type, filename) {
+        try {
+            const result = await wsClient.uploadMedia(fileBuffer, { type, filename });
+            return result.media_id;
+        }
+        catch (err) {
+            log.error('文件上传失败', { err });
+            return null;
+        }
+    }
+    static guessMimeType(filename) {
+        const ext = filename.split('.').pop()?.toLowerCase() || '';
+        const map = {
+            jpg: 'image/jpeg', jpeg: 'image/jpeg', png: 'image/png',
+            gif: 'image/gif', webp: 'image/webp', bmp: 'image/bmp',
+            mp4: 'video/mp4', mov: 'video/quicktime',
+            mp3: 'audio/mpeg', wav: 'audio/wav', amr: 'audio/amr',
+            pdf: 'application/pdf', doc: 'application/msword',
+            docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+        };
+        return map[ext] || 'application/octet-stream';
+    }
+}
+//# sourceMappingURL=media-handler.js.map

package/dist/core/media-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-handler.js","sourceRoot":"","sources":["../../src/core/media-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,GAAG,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;AAQzC,MAAM,OAAO,YAAY;IACvB;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ,CACnB,QAAkB,EAClB,GAAW,EACX,MAAe;QAEf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACxD,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,UAAU;gBACvC,QAAQ,EAAE,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;aAC5D,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,QAAkB,EAClB,UAAkB,EAClB,IAA0C,EAC1C,QAAgB;QAEhB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC1E,OAAO,MAAM,CAAC,QAAQ,CAAC;QACzB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,aAAa,CAAC,QAAgB;QAC3C,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAC3D,MAAM,GAAG,GAA2B;YAClC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,WAAW;YACvD,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,WAAW;YACtD,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,iBAAiB;YACxC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW;YACrD,GAAG,EAAE,iBAAiB,EAAE,GAAG,EAAE,oBAAoB;YACjD,IAAI,EAAE,yEAAyE;SAChF,CAAC;QACF,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAC;IAChD,CAAC;CACF"}

package/dist/core/message-handler.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 消息处理器 — 企微消息 ↔ OpenCode 流式回复
+ */
+import type { WsFrame, TextMessage, ImageMessage, MixedMessage, WSClient } from '@wecom/aibot-node-sdk';
+import type { WecomConfig } from './types.js';
+import { SessionManager } from './session-manager.js';
+import { OpenCodeClient } from '../opencode/client.js';
+export declare class MessageHandler {
+    private config;
+    private sessionManager;
+    private wsClient;
+    private opencode;
+    /** 挂起的流式回调：sessionId → { frame, streamId, lastContent } */
+    private streams;
+    constructor(config: WecomConfig, sessionManager: SessionManager, wsClient: WSClient, opencode: OpenCodeClient);
+    /** 处理文本消息 */
+    handleMessage(frame: WsFrame<TextMessage>): Promise<void>;
+    /**
+     * 尝试将用户消息解析为挂起交互的回复。
+     * 返回 true 表示已处理。
+     */
+    private handleInteractionReply;
+    /** 通知用户有挂起的交互（由 EventHandler 调用） */
+    notifyPending(chatId: string, message: string): Promise<void>;
+    /** 流式推送文本增量到企微 */
+    pushStreamDelta(sessionId: string, delta: string): Promise<void>;
+    /** 流式结束 */
+    finishStream(sessionId: string): Promise<void>;
+    /** 处理图片消息 */
+    handleImageMessage(frame: WsFrame<ImageMessage>): Promise<void>;
+    /** 处理图文混排消息 */
+    handleMixedMessage(frame: WsFrame<MixedMessage>): Promise<void>;
+    /** 进入会话事件 */
+    handleEnterChat(frame: WsFrame<any>): Promise<void>;
+    /** 模板卡片事件 */
+    handleCardEvent(frame: WsFrame<any>): Promise<void>;
+}
+//# sourceMappingURL=message-handler.d.ts.map

package/dist/core/message-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-handler.d.ts","sourceRoot":"","sources":["../../src/core/message-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACxG,OAAO,KAAK,EAAE,WAAW,EAAsB,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAKvD,qBAAa,cAAc;IAKvB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,QAAQ;IAPlB,2DAA2D;IAC3D,OAAO,CAAC,OAAO,CAAqF;gBAG1F,MAAM,EAAE,WAAW,EACnB,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,cAAc;IAGlC,aAAa;IACP,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC;IAgE/C;;;OAGG;YACW,sBAAsB;IAoGpC,oCAAoC;IAC9B,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBnE,kBAAkB;IACZ,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAkBtD,WAAW;IACL,YAAY,CAAC,SAAS,EAAE,MAAM;IAiBpC,aAAa;IACP,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC;IASrD,eAAe;IACT,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC;IAOrD,aAAa;IACP,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC;IAWzC,aAAa;IACP,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC;CAI1C"}