@wu529778790/open-im 1.8.3-beta.8 → 1.8.3-beta.9

package/dist/channels/capabilities.js

@@ -2,7 +2,6 @@ const PLATFORM_LABELS = {
     telegram: "Telegram",
     feishu: "Feishu",
     qq: "QQ",
-    wechat: "微信",
     wework: "企业微信",
     dingtalk: "钉钉",
     workbuddy: "WorkBuddy",
@@ -20,10 +19,6 @@ export const CHANNEL_CAPABILITIES = {
         inbound: { text: "native", image: "fallback", file: "fallback", voice: "fallback", video: "fallback" },
         outbound: { streamEdit: "none", streamPush: "none", image: "fallback", card: "fallback", typing: "fallback" },
     },
-    wechat: {
-        inbound: { text: "native", image: "fallback", file: "fallback", voice: "fallback", video: "fallback" },
-        outbound: { streamEdit: "native", streamPush: "fallback", image: "fallback", card: "native", typing: "native" },
-    },
     wework: {
         inbound: { text: "native", image: "fallback", file: "fallback", voice: "fallback", video: "fallback" },
         outbound: { streamEdit: "native", streamPush: "fallback", image: "native", card: "native", typing: "native" },

package/dist/channels/capabilities.test.js

@@ -10,7 +10,7 @@ describe("channel capabilities", () => {
         expect(CHANNEL_CAPABILITIES.qq.inbound.video).toBe("fallback");
         expect(CHANNEL_CAPABILITIES.qq.outbound.streamEdit).toBe("none");
         expect(CHANNEL_CAPABILITIES.qq.outbound.streamPush).toBe("none");
-        expect(CHANNEL_CAPABILITIES.wechat.inbound.image).toBe("fallback");
+        expect(CHANNEL_CAPABILITIES.wework.inbound.image).toBe("fallback");
         expect(CHANNEL_CAPABILITIES.wework.inbound.video).toBe("fallback");
         expect(CHANNEL_CAPABILITIES.wework.outbound.image).toBe("native");
         expect(CHANNEL_CAPABILITIES.dingtalk.inbound.file).toBe("fallback");

package/dist/commands/handler.d.ts

@@ -1,4 +1,4 @@
-import { type Config } from '../config.js';
+import { type Config, type Platform } from '../config.js';
 import type { SessionManager } from '../session/session-manager.js';
 import type { RequestQueue } from '../queue/request-queue.js';
 import type { ThreadContext } from '../shared/types.js';
@@ -18,7 +18,7 @@ export type ClaudeRequestHandler = (userId: string, chatId: string, prompt: stri
 export declare class CommandHandler {
     private deps;
     constructor(deps: CommandHandlerDeps);
-    dispatch(text: string, chatId: string, userId: string, platform: 'dingtalk' | 'feishu' | 'qq' | 'telegram' | 'wechat' | 'wework' | 'workbuddy', handleClaudeRequest: ClaudeRequestHandler): Promise<boolean>;
+    dispatch(text: string, chatId: string, userId: string, platform: Platform, handleClaudeRequest: ClaudeRequestHandler): Promise<boolean>;
     private handleHelp;
     private handleNew;
     private handlePwd;

package/dist/config-web.js

@@ -407,7 +407,6 @@ function createProbeConfig(values) {
         telegramAllowedUserIds: [],
         feishuAllowedUserIds: [],
         qqAllowedUserIds: [],
-        wechatAllowedUserIds: [],
         weworkAllowedUserIds: [],
         dingtalkAllowedUserIds: [],
         workbuddyAllowedUserIds: [],

package/dist/config.d.ts

@@ -1,13 +1,11 @@
 import { type LogLevel } from './logger.js';
-export type Platform = 'dingtalk' | 'feishu' | 'qq' | 'telegram' | 'wechat' | 'wework' | 'workbuddy';
+export type Platform = 'dingtalk' | 'feishu' | 'qq' | 'telegram' | 'wework' | 'workbuddy';
 export type AiCommand = 'claude' | 'codex' | 'codebuddy';
 export interface Config {
     enabledPlatforms: Platform[];
     telegramBotToken?: string;
     feishuAppId?: string;
     feishuAppSecret?: string;
-    /** WorkBuddy 用户 ID（可选，与 platforms.wechat.userId 二选一，环境变量 WECHAT_USER_ID） */
-    wechatUserId?: string;
     weworkCorpId?: string;
     weworkSecret?: string;
     weworkWsUrl?: string;
@@ -20,7 +18,6 @@ export interface Config {
     telegramAllowedUserIds: string[];
     feishuAllowedUserIds: string[];
     qqAllowedUserIds: string[];
-    wechatAllowedUserIds: string[];
     weworkAllowedUserIds: string[];
     dingtalkAllowedUserIds: string[];
     workbuddyAllowedUserIds: string[];
@@ -55,16 +52,6 @@ export interface Config {
             aiCommand?: AiCommand;
             allowedUserIds: string[];
         };
-        wechat?: {
-            enabled: boolean;
-            aiCommand?: AiCommand;
-            userId?: string;
-            allowedUserIds: string[];
-            workbuddyAccessToken?: string;
-            workbuddyRefreshToken?: string;
-            workbuddyBaseUrl?: string;
-            workbuddyHostId?: string;
-        };
         wework?: {
             enabled: boolean;
             aiCommand?: AiCommand;
@@ -206,7 +193,7 @@ export declare function hasClaudeCredentials(): boolean;
 /** 检测是否需要交互式配置（无 token 且无环境变量） */
 export declare function needsSetup(): boolean;
 export declare function loadConfig(): Config;
-/** 获取已配置凭证的平台列表（用于多通道启动时让用户选择），顺序：Telegram、飞书、企业微信、微信 */
+/** 获取已配置凭证的平台列表 */
 export declare function getPlatformsWithCredentials(config: Config): Platform[];
 export declare function resolvePlatformAiCommand(config: Config, platform: Platform): AiCommand;
 export declare function getConfiguredAiCommands(config: Config): AiCommand[];

package/dist/config.js

@@ -191,17 +191,19 @@ export function needsSetup() {
     const tg = file.platforms?.telegram;
     const fs = file.platforms?.feishu;
     const qq = file.platforms?.qq;
-    const wc = file.platforms?.wechat;
     const ww = file.platforms?.wework;
     const dt = file.platforms?.dingtalk;
+    const wb = file.platforms?.workbuddy;
+    // Also check legacy platforms.wechat for migration path
+    const legacyWc = file.platforms?.wechat;
     const hasTelegram = !!tg?.botToken;
     const hasFeishu = !!(fs?.appId && fs?.appSecret);
     const hasQQ = !!(qq?.appId && qq?.secret);
-    const hasWechat = !!(wc?.workbuddyAccessToken && wc?.workbuddyRefreshToken);
-    // 企业微信只需要 corpId 和 secret
     const hasWework = !!(ww?.corpId && ww?.secret);
     const hasDingtalk = !!(dt?.clientId && dt?.clientSecret);
-    return !hasTelegram && !hasFeishu && !hasQQ && !hasWechat && !hasWework && !hasDingtalk;
+    const hasWorkBuddy = !!(wb?.accessToken && wb?.refreshToken && wb?.userId);
+    const hasLegacyWechat = !!(legacyWc?.workbuddyAccessToken && legacyWc?.workbuddyRefreshToken);
+    return !hasTelegram && !hasFeishu && !hasQQ && !hasWework && !hasDingtalk && !hasWorkBuddy && !hasLegacyWechat;
 }
 function parseCommaSeparated(value) {
     return value.split(',').map((s) => s.trim()).filter(Boolean);
@@ -229,10 +231,18 @@ export function loadConfig() {
     const fileTelegram = file.platforms?.telegram;
     const fileFeishu = file.platforms?.feishu;
     const fileQQ = file.platforms?.qq;
-    const fileWechat = file.platforms?.wechat;
     const fileWework = file.platforms?.wework;
     const fileDingtalk = file.platforms?.dingtalk;
-    const fileWorkBuddy = file.platforms?.workbuddy;
+    // Auto-migrate legacy platforms.wechat WorkBuddy credentials → platforms.workbuddy
+    const legacyWechat = file.platforms?.wechat;
+    const fileWorkBuddy = file.platforms?.workbuddy ?? (legacyWechat?.workbuddyAccessToken && legacyWechat?.workbuddyRefreshToken
+        ? {
+            accessToken: legacyWechat.workbuddyAccessToken,
+            refreshToken: legacyWechat.workbuddyRefreshToken,
+            userId: legacyWechat.userId,
+            baseUrl: legacyWechat.workbuddyBaseUrl,
+        }
+        : undefined);
     // 1. 加载各平台凭证（env 优先，其次新结构，最后旧字段）
     const telegramBotToken = process.env.TELEGRAM_BOT_TOKEN ??
         fileTelegram?.botToken ??
@@ -247,16 +257,6 @@ export function loadConfig() {
         fileQQ?.appId;
     const qqSecret = process.env.QQ_BOT_SECRET ??
         fileQQ?.secret;
-    const wechatUserId = process.env.WECHAT_USER_ID ??
-        fileWechat?.userId;
-    const wechatWorkbuddyAccessToken = process.env.WECHAT_WORKBUDDY_ACCESS_TOKEN ??
-        fileWechat?.workbuddyAccessToken;
-    const wechatWorkbuddyRefreshToken = process.env.WECHAT_WORKBUDDY_REFRESH_TOKEN ??
-        fileWechat?.workbuddyRefreshToken;
-    const wechatWorkbuddyBaseUrl = process.env.WECHAT_WORKBUDDY_BASE_URL ??
-        fileWechat?.workbuddyBaseUrl;
-    const wechatWorkbuddyHostId = process.env.WECHAT_WORKBUDDY_HOST_ID ??
-        fileWechat?.workbuddyHostId;
     const weworkCorpId = process.env.WEWORK_CORP_ID ??
         fileWework?.corpId;
     const weworkSecret = process.env.WEWORK_SECRET ??
@@ -287,19 +287,14 @@ export function loadConfig() {
     const telegramEnabledFlag = fileTelegram?.enabled;
     const feishuEnabledFlag = fileFeishu?.enabled;
     const qqEnabledFlag = fileQQ?.enabled;
-    const wechatEnabledFlag = fileWechat?.enabled;
     const weworkEnabledFlag = fileWework?.enabled;
     const dingtalkEnabledFlag = fileDingtalk?.enabled;
     const workbuddyEnabledFlag = fileWorkBuddy?.enabled;
     const telegramEnabled = !!telegramBotToken && (telegramEnabledFlag !== false);
     const feishuEnabled = !!(feishuAppId && feishuAppSecret) && (feishuEnabledFlag !== false);
     const qqEnabled = !!(qqAppId && qqSecret) && (qqEnabledFlag !== false);
-    const hasWechatWorkbuddyCreds = !!(wechatWorkbuddyAccessToken && wechatWorkbuddyRefreshToken);
-    const wechatEnabled = hasWechatWorkbuddyCreds && (wechatEnabledFlag !== false);
-    // 企业微信只需要 corpId (botId) 和 secret
     const weworkEnabled = !!(weworkCorpId && weworkSecret) && (weworkEnabledFlag !== false);
     const dingtalkEnabled = !!(dingtalkClientId && dingtalkClientSecret) && (dingtalkEnabledFlag !== false);
-    // WorkBuddy 需要 OAuth 凭证
     const workbuddyEnabled = !!(workbuddyAccessToken && workbuddyRefreshToken && workbuddyUserId) && (workbuddyEnabledFlag !== false);
     if (telegramEnabled)
         enabledPlatforms.push('telegram');
@@ -307,8 +302,6 @@ export function loadConfig() {
         enabledPlatforms.push('feishu');
     if (qqEnabled)
         enabledPlatforms.push('qq');
-    if (wechatEnabled)
-        enabledPlatforms.push('wechat');
     if (weworkEnabled)
         enabledPlatforms.push('wework');
     if (dingtalkEnabled)
@@ -332,9 +325,6 @@ export function loadConfig() {
     const qqAllowedUserIds = process.env.QQ_ALLOWED_USER_IDS !== undefined
         ? parseCommaSeparated(process.env.QQ_ALLOWED_USER_IDS)
         : fileQQ?.allowedUserIds ?? allowedUserIds;
-    const wechatAllowedUserIds = process.env.WECHAT_ALLOWED_USER_IDS !== undefined
-        ? parseCommaSeparated(process.env.WECHAT_ALLOWED_USER_IDS)
-        : fileWechat?.allowedUserIds ?? allowedUserIds;
     const weworkAllowedUserIds = process.env.WEWORK_ALLOWED_USER_IDS !== undefined
         ? parseCommaSeparated(process.env.WEWORK_ALLOWED_USER_IDS)
         : fileWework?.allowedUserIds ?? allowedUserIds;
@@ -544,27 +534,6 @@ export function loadConfig() {
                 aiCommand: normalizeAiCommand(file.platforms?.qq?.aiCommand, aiCommand),
                 allowedUserIds: qqAllowedUserIds,
             },
-        wechat: wechatEnabled
-            ? {
-                enabled: true,
-                aiCommand: normalizeAiCommand(file.platforms?.wechat?.aiCommand, aiCommand),
-                userId: wechatUserId,
-                allowedUserIds: wechatAllowedUserIds,
-                workbuddyAccessToken: wechatWorkbuddyAccessToken,
-                workbuddyRefreshToken: wechatWorkbuddyRefreshToken,
-                workbuddyBaseUrl: wechatWorkbuddyBaseUrl,
-                workbuddyHostId: wechatWorkbuddyHostId,
-            }
-            : {
-                enabled: false,
-                aiCommand: normalizeAiCommand(file.platforms?.wechat?.aiCommand, aiCommand),
-                userId: wechatUserId,
-                allowedUserIds: wechatAllowedUserIds,
-                workbuddyAccessToken: wechatWorkbuddyAccessToken,
-                workbuddyRefreshToken: wechatWorkbuddyRefreshToken,
-                workbuddyBaseUrl: wechatWorkbuddyBaseUrl,
-                workbuddyHostId: wechatWorkbuddyHostId,
-            },
         wework: weworkEnabled
             ? {
                 enabled: true,
@@ -620,7 +589,6 @@ export function loadConfig() {
         feishuAppSecret: feishuAppSecret ?? '',
         qqAppId: qqAppId ?? '',
         qqSecret: qqSecret ?? '',
-        wechatUserId: wechatUserId,
         weworkCorpId: weworkCorpId ?? '',
         weworkSecret: weworkSecret ?? '',
         weworkWsUrl: weworkWsUrl,
@@ -631,7 +599,6 @@ export function loadConfig() {
         telegramAllowedUserIds,
         feishuAllowedUserIds,
         qqAllowedUserIds,
-        wechatAllowedUserIds,
         weworkAllowedUserIds,
         dingtalkAllowedUserIds,
         workbuddyAllowedUserIds,
@@ -650,7 +617,7 @@ export function loadConfig() {
         platforms,
     };
 }
-/** 获取已配置凭证的平台列表（用于多通道启动时让用户选择），顺序：Telegram、飞书、企业微信、微信 */
+/** 获取已配置凭证的平台列表 */
 export function getPlatformsWithCredentials(config) {
     const r = [];
     if (config.telegramBotToken)
@@ -663,9 +630,9 @@ export function getPlatformsWithCredentials(config) {
         r.push('wework');
     if (config.dingtalkClientId && config.dingtalkClientSecret)
         r.push('dingtalk');
-    const wc = config.platforms.wechat;
-    if (wc?.workbuddyAccessToken && wc?.workbuddyRefreshToken)
-        r.push('wechat');
+    const wb = config.platforms.workbuddy;
+    if (wb?.accessToken && wb?.refreshToken)
+        r.push('workbuddy');
     return r;
 }
 export function resolvePlatformAiCommand(config, platform) {

package/dist/index.js

@@ -15,9 +15,6 @@ import { sendTextReply as sendFeishuTextReply } from "./feishu/message-sender.js
 import { initQQ, stopQQ } from "./qq/client.js";
 import { setupQQHandlers } from "./qq/event-handler.js";
 import { sendTextReply as sendQQTextReply } from "./qq/message-sender.js";
-import { initWeChat, stopWeChat } from "./wechat/client.js";
-import { setupWeChatHandlers } from "./wechat/event-handler.js";
-import { sendTextReply as sendWeChatTextReply } from "./wechat/message-sender.js";
 import { initWeWork, stopWeWork } from "./wework/client.js";
 import { setupWeWorkHandlers } from "./wework/event-handler.js";
 import { sendProactiveTextReply as sendWeWorkTextReply } from "./wework/message-sender.js";
@@ -42,7 +39,6 @@ async function sendLifecycleNotification(platform, message) {
     const telegramChatId = getActiveChatId("telegram");
     const feishuChatId = getActiveChatId("feishu");
     const qqChatId = getActiveChatId("qq");
-    const wechatChatId = getActiveChatId("wechat");
     const weworkChatId = getActiveChatId("wework");
     const sendPromises = [];
     if (platform === "telegram" && telegramChatId) {
@@ -60,11 +56,6 @@ async function sendLifecycleNotification(platform, message) {
             log.debug("Failed to send QQ notification:", err);
         }));
     }
-    if (platform === "wechat" && wechatChatId) {
-        sendPromises.push(sendWeChatTextReply(wechatChatId, message).catch((err) => {
-            log.debug("Failed to send WeChat notification:", err);
-        }));
-    }
     if (platform === "wework" && weworkChatId) {
         sendPromises.push(sendWeWorkTextReply(weworkChatId, message).catch((err) => {
             log.debug("Failed to send WeWork notification:", err);
@@ -173,7 +164,6 @@ export async function main() {
     let telegramHandle = null;
     let feishuHandle = null;
     let qqHandle = null;
-    let wechatHandle = null;
     let weworkHandle = null;
     let dingtalkHandle = null;
     let workbuddyHandle = null;
@@ -210,16 +200,6 @@ export async function main() {
             log.error("Failed to initialize QQ:", err);
         }
     }
-    if (config.enabledPlatforms.includes("wechat")) {
-        try {
-            wechatHandle = setupWeChatHandlers(config, sessionManager);
-            await initWeChat(config, wechatHandle.handleEvent);
-            successfulPlatforms.push("wechat");
-        }
-        catch (err) {
-            log.error("Failed to initialize WeChat:", err);
-        }
-    }
     if (config.enabledPlatforms.includes("wework")) {
         try {
             weworkHandle = setupWeWorkHandlers(config, sessionManager);
@@ -290,8 +270,6 @@ export async function main() {
         stopFeishu();
         qqHandle?.stop();
         await stopQQ();
-        wechatHandle?.stop();
-        stopWeChat();
         weworkHandle?.stop();
         stopWeWork();
         dingtalkHandle?.stop();

package/dist/setup.js

@@ -30,7 +30,7 @@ function getConfiguredPlatforms(existing) {
         { k: "feishu", label: "飞书" },
         { k: "wework", label: "企业微信" },
         { k: "dingtalk", label: "钉钉" },
-        { k: "wechat", label: "微信" },
+        { k: "workbuddy", label: "WorkBuddy (微信)" },
     ];
     return names
         .filter(({ k }) => {
@@ -43,8 +43,8 @@ function getConfiguredPlatforms(existing) {
             return !!(p.appId && p.appSecret);
         if (k === "qq")
             return !!(p.appId && p.secret);
-        if (k === "wechat")
-            return !!(p.workbuddyAccessToken && p.workbuddyRefreshToken);
+        if (k === "workbuddy")
+            return !!(p.accessToken && p.refreshToken);
         if (k === "wework")
             return !!(p.corpId && p.secret);
         if (k === "dingtalk")
@@ -272,8 +272,8 @@ export async function runInteractiveSetup() {
     const hasTg = !!existing?.platforms?.telegram?.botToken;
     const hasFs = !!(existing?.platforms?.feishu?.appId && existing?.platforms?.feishu?.appSecret);
     const hasQq = !!(existing?.platforms?.qq?.appId && existing?.platforms?.qq?.secret);
-    const wc = existing?.platforms?.wechat;
-    const hasWc = !!(wc?.workbuddyAccessToken && wc?.workbuddyRefreshToken);
+    const wc = existing?.platforms?.workbuddy;
+    const hasWc = !!(wc?.accessToken && wc?.refreshToken);
     const hasWw = !!(existing?.platforms?.wework?.corpId && existing?.platforms?.wework?.secret);
     const hasDt = !!(existing?.platforms?.dingtalk?.clientId && existing?.platforms?.dingtalk?.clientSecret);
     // 第一步：选择平台（在选项和提示中显示已配置项）
@@ -307,9 +307,9 @@ export async function runInteractiveSetup() {
                 value: "dingtalk",
             },
             {
-                title: "微信 (WeChat)" +
+                title: "WorkBuddy 微信客服 (WeChat KF)" +
                     (hasWc ? " ✓已配置" : ""),
-                value: "wechat",
+                value: "workbuddy",
             },
             { title: "配置多个平台", value: "multi" },
         ],
@@ -332,7 +332,7 @@ export async function runInteractiveSetup() {
                 { title: "飞书 (Feishu)" + (hasFs ? " ✓已配置" : ""), value: "feishu", selected: hasFs },
                 { title: "企业微信 (WeWork)" + (hasWw ? " ✓已配置" : ""), value: "wework", selected: hasWw },
                 { title: "钉钉 (DingTalk)" + (hasDt ? " ✓已配置" : ""), value: "dingtalk", selected: hasDt },
-                { title: "微信 (WeChat，测试中)" + (hasWc ? " ✓已配置" : ""), value: "wechat", selected: hasWc },
+                { title: "WorkBuddy 微信客服 (WeChat KF)" + (hasWc ? " ✓已配置" : ""), value: "workbuddy", selected: hasWc },
             ],
         }, { onCancel });
         if (!multiResp.platforms || multiResp.platforms.length === 0) {
@@ -420,13 +420,13 @@ export async function runInteractiveSetup() {
             return false;
         }
     }
-    if (selectedPlatforms.includes("wechat")) {
-        const wc = existing?.platforms?.wechat;
-        const hasWbCreds = !!(wc?.workbuddyAccessToken && wc?.workbuddyRefreshToken);
-        const wechatModeResp = await prompts({
+    if (selectedPlatforms.includes("workbuddy")) {
+        const wb = existing?.platforms?.workbuddy;
+        const hasWbCreds = !!(wb?.accessToken && wb?.refreshToken);
+        const wbModeResp = await prompts({
             type: "select",
             name: "mode",
-            message: "微信（WorkBuddy / CodeBuddy OAuth）",
+            message: "WorkBuddy 微信客服（CodeBuddy OAuth）",
             choices: [
                 {
                     title: "在浏览器中完成 CodeBuddy 登录并绑定微信客服（推荐）",
@@ -440,7 +440,7 @@ export async function runInteractiveSetup() {
             ],
             initial: hasWbCreds ? 1 : 0,
         }, { onCancel });
-        if (wechatModeResp.mode === "oauth") {
+        if (wbModeResp.mode === "oauth") {
             console.log("\n正在启动 WorkBuddy OAuth 登录...\n");
             try {
                 const { WorkBuddyOAuth } = await import("./workbuddy/oauth.js");
@@ -461,13 +461,11 @@ export async function runInteractiveSetup() {
                 }
                 const userId = accountInfo?.uid?.toString() ?? "";
                 // Set oauth.userId so buildSessionId() produces the correct sessionId.
-                // Without this, the binding sessionId has an empty userId prefix, which
-                // won't match the sessionId the transport uses at runtime.
                 oauth.userId = userId;
-                config.platforms.wechat = {
+                config.platforms.workbuddy = {
                     enabled: true,
-                    workbuddyAccessToken: tokenResult.accessToken,
-                    workbuddyRefreshToken: tokenResult.refreshToken,
+                    accessToken: tokenResult.accessToken,
+                    refreshToken: tokenResult.refreshToken,
                     userId,
                 };
                 console.log("\n正在获取微信客服绑定链接...");
@@ -493,17 +491,17 @@ export async function runInteractiveSetup() {
             }
             catch (err) {
                 console.error("\n❌ WorkBuddy 登录失败:", err instanceof Error ? err.message : String(err));
-                if (platform === "wechat")
+                if (platform === "workbuddy")
                     return false;
             }
         }
         else if (hasWbCreds) {
-            config.platforms.wechat = {
-                ...wc,
+            config.platforms.workbuddy = {
+                ...wb,
                 enabled: true,
             };
         }
-        else if (platform === "wechat") {
+        else if (platform === "workbuddy") {
             return false;
         }
     }
@@ -579,7 +577,7 @@ export async function runInteractiveSetup() {
     const tgIds = existing?.platforms?.telegram?.allowedUserIds?.join(", ") ?? "";
     const fsIds = existing?.platforms?.feishu?.allowedUserIds?.join(", ") ?? "";
     const qqIds = existing?.platforms?.qq?.allowedUserIds?.join(", ") ?? "";
-    const wcIds = existing?.platforms?.wechat?.allowedUserIds?.join(", ") ?? "";
+    const wcIds = existing?.platforms?.workbuddy?.allowedUserIds?.join(", ") ?? "";
     const wwIds = existing?.platforms?.wework?.allowedUserIds?.join(", ") ?? "";
     const dtIds = existing?.platforms?.dingtalk?.allowedUserIds?.join(", ") ?? "";
     const aiIdx = ["claude", "codex", "codebuddy"].indexOf(existing?.aiCommand ?? "claude");
@@ -608,11 +606,11 @@ export async function runInteractiveSetup() {
             initial: fsIds,
         });
     }
-    if (selectedPlatforms.includes("wechat")) {
+    if (selectedPlatforms.includes("workbuddy")) {
         commonPrompts.push({
             type: "text",
-            name: "wechatAllowedUserIds",
-            message: "微信白名单用户 ID（可选，逗号分隔，留空=所有人可访问）",
+            name: "workbuddyAllowedUserIds",
+            message: "WorkBuddy 白名单用户 ID（可选，逗号分隔，留空=所有人可访问）",
             initial: wcIds,
         });
     }
@@ -743,9 +741,9 @@ export async function runInteractiveSetup() {
     const qqIdsFinal = selectedPlatforms.includes("qq")
         ? parseIds(commonResp.qqAllowedUserIds)
         : parseIds(existing?.platforms?.qq?.allowedUserIds?.join(", "));
-    const wechatIds = selectedPlatforms.includes("wechat")
-        ? parseIds(commonResp.wechatAllowedUserIds)
-        : parseIds(existing?.platforms?.wechat?.allowedUserIds?.join(", "));
+    const workbuddyIds = selectedPlatforms.includes("workbuddy")
+        ? parseIds(commonResp.workbuddyAllowedUserIds)
+        : parseIds(existing?.platforms?.workbuddy?.allowedUserIds?.join(", "));
     const weworkIds = selectedPlatforms.includes("wework")
         ? parseIds(commonResp.weworkAllowedUserIds)
         : parseIds(existing?.platforms?.wework?.allowedUserIds?.join(", "));
@@ -885,32 +883,29 @@ export async function runInteractiveSetup() {
     else {
         outPlatforms.qq = { enabled: false, allowedUserIds: qqIdsFinal };
     }
-    if (selectedPlatforms.includes("wechat")) {
-        const wcConfig = config.platforms?.wechat;
-        const baseWc = base?.platforms?.wechat;
+    if (selectedPlatforms.includes("workbuddy")) {
+        const wbConfig = config.platforms?.workbuddy;
+        const baseWb = base?.platforms?.workbuddy;
         const wbOut = {
             enabled: true,
-            workbuddyAccessToken: wcConfig?.workbuddyAccessToken ?? baseWc?.workbuddyAccessToken,
-            workbuddyRefreshToken: wcConfig?.workbuddyRefreshToken ?? baseWc?.workbuddyRefreshToken,
-            userId: wcConfig?.userId ?? baseWc?.userId ?? "",
-            allowedUserIds: wechatIds,
+            accessToken: wbConfig?.accessToken ?? baseWb?.accessToken,
+            refreshToken: wbConfig?.refreshToken ?? baseWb?.refreshToken,
+            userId: wbConfig?.userId ?? baseWb?.userId ?? "",
+            allowedUserIds: workbuddyIds,
         };
-        const wbBaseUrl = wcConfig?.workbuddyBaseUrl ?? baseWc?.workbuddyBaseUrl;
-        const wbHostId = wcConfig?.workbuddyHostId ?? baseWc?.workbuddyHostId;
+        const wbBaseUrl = wbConfig?.baseUrl ?? baseWb?.baseUrl;
         if (wbBaseUrl)
-            wbOut.workbuddyBaseUrl = wbBaseUrl;
-        if (wbHostId)
-            wbOut.workbuddyHostId = wbHostId;
-        out.platforms.wechat = wbOut;
+            wbOut.baseUrl = wbBaseUrl;
+        out.platforms.workbuddy = wbOut;
     }
-    else if (basePlatforms?.wechat) {
-        outPlatforms.wechat = {
-            ...basePlatforms.wechat,
-            allowedUserIds: wechatIds.length > 0 ? wechatIds : basePlatforms.wechat.allowedUserIds ?? [],
+    else if (basePlatforms?.workbuddy) {
+        outPlatforms.workbuddy = {
+            ...basePlatforms.workbuddy,
+            allowedUserIds: workbuddyIds.length > 0 ? workbuddyIds : basePlatforms.workbuddy.allowedUserIds ?? [],
         };
     }
     else {
-        outPlatforms.wechat = { enabled: false, allowedUserIds: wechatIds };
+        outPlatforms.workbuddy = { enabled: false, allowedUserIds: workbuddyIds };
     }
     if (selectedPlatforms.includes("wework")) {
         outPlatforms.wework = {
@@ -964,10 +959,9 @@ const PLATFORM_LABELS = {
     feishu: "飞书",
     wework: "企业微信",
     dingtalk: "钉钉",
-    wechat: "微信（测试中）",
-    workbuddy: "WorkBuddy",
+    workbuddy: "WorkBuddy 微信客服",
 };
-const ALL_PLATFORMS = ["telegram", "feishu", "qq", "wework", "dingtalk", "wechat", "workbuddy"];
+const ALL_PLATFORMS = ["telegram", "feishu", "qq", "wework", "dingtalk", "workbuddy"];
 /**
  * 启动时让用户选择要启用的平台（无论单通道还是多通道）
  * 显示全部 4 个平台，已配置的预选；若用户选择未配置的，引导运行 init

package/dist/workbuddy/centrifuge-client.js

@@ -145,19 +145,24 @@ export class WorkBuddyCentrifugeClient {
         // WeChat KF messages: send via HTTP COPILOT_RESPONSE
         if (this.config.httpBaseUrl && this.config.httpAccessToken) {
             const message = payload.content?.map((c) => c.text).join('') || payload.error || '';
+            // chatId format: "<wechatUserId>::origin::wechatkfProxy"
+            // Extract user ID for toUser field; keep full chatId for routing.
+            const chatIdFull = payload.session_id;
+            const toUser = chatIdFull.includes('::') ? chatIdFull.split('::')[0] : chatIdFull;
             const httpPayload = {
                 type: 'COPILOT_RESPONSE',
                 msgId: payload.prompt_id,
-                chatId: payload.session_id,
+                chatId: chatIdFull,
+                toUser,
                 success: payload.stop_reason === 'end_turn',
                 message,
                 metadata: {
                     sessionId: this.config.workspaceSessionId || payload.session_id,
-                    requestId: payload.prompt_id,
-                    state: payload.stop_reason === 'end_turn' ? 'completed' : payload.stop_reason,
+                    toUser,
                 },
             };
             const url = `${this.config.httpBaseUrl}/v2/backgroundagent/wecom/local-proxy/receive`;
+            log.debug(`${this.logPrefix} HTTP COPILOT_RESPONSE → ${url} chatId=${payload.session_id} msgLen=${message.length}`);
             fetch(url, {
                 method: 'POST',
                 headers: {
@@ -168,9 +173,12 @@ export class WorkBuddyCentrifugeClient {
                 signal: AbortSignal.timeout(30_000),
             })
                 .then(async (res) => {
+                const body = await res.text().catch(() => '');
                 if (!res.ok) {
-                    const body = await res.text().catch(() => '');
-                    log.error(`${this.logPrefix} HTTP COPILOT_RESPONSE failed: ${res.status} ${body.substring(0, 200)}`);
+                    log.error(`${this.logPrefix} HTTP COPILOT_RESPONSE failed: ${res.status} ${body.substring(0, 300)}`);
+                }
+                else {
+                    log.info(`${this.logPrefix} HTTP COPILOT_RESPONSE ok: ${res.status} ${body.substring(0, 200)}`);
                 }
             })
                 .catch((err) => {

package/dist/workbuddy/client.d.ts

@@ -1,27 +1,15 @@
 /**
- * WorkBuddy Client - Main client for WorkBuddy WeChat integration
+ * WorkBuddy Client - CodeBuddy OAuth + Centrifuge WebSocket for WeChat KF
+ *
+ * Manages the full lifecycle: connect → register WeChat KF channel → heartbeat →
+ * auto-reconnect on drop.
  */
 import type { Config } from '../config.js';
 import { WorkBuddyOAuth } from './oauth.js';
 import { WorkBuddyCentrifugeClient } from './centrifuge-client.js';
 import type { WorkBuddyState } from './types.js';
-/**
- * Get current channel state
- */
 export declare function getChannelState(): WorkBuddyState;
-/**
- * Initialize WorkBuddy client with CodeBuddy OAuth and Centrifuge WebSocket
- */
 export declare function initWorkBuddy(config: Config, eventHandler: (chatId: string, msgId: string, content: string) => Promise<void>, onStateChange?: (state: WorkBuddyState) => void): Promise<void>;
-/**
- * Get Centrifuge client for sending messages
- */
 export declare function getCentrifugeClient(): WorkBuddyCentrifugeClient | null;
-/**
- * Get OAuth client
- */
 export declare function getOAuth(): WorkBuddyOAuth | null;
-/**
- * Stop WorkBuddy client
- */
 export declare function stopWorkBuddy(): void;