@zhin.js/adapter-wechat-mp 1.1.14 → 1.1.16

package/CHANGELOG.md

@@ -1,5 +1,56 @@
 # @zhin.js/adapter-wechat-mp
 
+## 1.1.16
+
+### Patch Changes
+
+- 53bc6a0: 适配器配置标签、端点命令和工具反馈支持中英文；复用当前操作语言，保持协议值、用户内容、身份、权限与发送链路不变。Sandbox 展示使用项目语言，QQ 绑定与交互状态保留完整会话身份。
+- 9cade30: 修复国际化调用链遗漏：Agent 审批、管理命令和错误反馈采用可信语言及实际命令前缀；游戏快捷帮助、工具反馈、平台默认卡片和后台通知贯通语言。协议即时回复复用受运行代约束的个人语言查询，业务验证支持不改变审批身份的双语展示元数据。
+
+  AI 正文、进度与耗尽摘要统一优先遵从用户明确语言要求，再跟随实际输入；个人／项目语言仅作兜底，固定界面文案继续使用配置语言，不增加翻译调用。
+
+  GitHub 工作区为 Git clone/pull/fetch/ls-remote 显式分隔选项与位置参数，保留仓库和分支校验；顺序写入 Bot 名称和邮箱，避免竞争同一配置文件锁。
+
+- dcd4982: Upgrade runtime dependencies to clear security advisories: `undici` (6.29.1 / 8.12.2+), `axios` 1.20.0, and `@modelcontextprotocol/sdk` 1.32.0+ (bringing patched `hono`, `body-parser`, `proxy-addr`, `follow-redirects` and `ip-address` through the lockfile).
+- Updated dependencies [334e92d]
+- Updated dependencies [f3b7c9f]
+- Updated dependencies [658a5fb]
+- Updated dependencies [144a17b]
+- Updated dependencies [18296cf]
+- Updated dependencies [08e64de]
+- Updated dependencies [9cade30]
+- Updated dependencies [53bc6a0]
+- Updated dependencies [7595136]
+- Updated dependencies [66b6404]
+- Updated dependencies [adb4af2]
+- Updated dependencies [69f9ef6]
+- Updated dependencies [17d1301]
+  - @zhin.js/adapter@1.1.23
+  - @zhin.js/host-http@1.1.10
+  - @zhin.js/core@1.1.51
+  - @zhin.js/skill@1.1.10
+  - @zhin.js/im-contract@1.1.7
+  - @zhin.js/feature-kit@1.1.9
+
+## 1.1.15
+
+### Patch Changes
+
+- Updated dependencies [f98025b]
+- Updated dependencies [66ec1a5]
+- Updated dependencies [7d68df6]
+- Updated dependencies [bf0fa9f]
+- Updated dependencies [3326db3]
+- Updated dependencies [e91235e]
+- Updated dependencies [6da2bad]
+- Updated dependencies [3781f1c]
+  - @zhin.js/core@1.1.50
+  - @zhin.js/adapter@1.1.22
+  - @zhin.js/im-contract@1.1.6
+  - @zhin.js/host-http@1.1.9
+  - @zhin.js/feature-kit@1.1.8
+  - @zhin.js/skill@1.1.9
+
 ## 1.1.14
 
 ### Patch Changes

package/commands/wechat-mp/endpoint/definition.js

@@ -10,10 +10,10 @@ export const wechatMpEndpointCommands = createEndpointCommands({
     adapterKey: 'wechat-mp',
     adapterDisplayName: 'WeChat MP',
     fields: [
-        { key: 'appId', required: true, env: true, description: '公众号 AppID' },
-        { key: 'appSecret', required: true, env: true, description: '公众号 AppSecret' },
-        { key: 'token', required: true, env: true, description: '服务器配置 token' },
-        { key: 'encodingAESKey', env: true, description: '消息加解密 key' },
+        { key: 'appId', required: true, env: true, description: '公众号 AppID', descriptionI18n: { en: "WeChat Official Account app ID" } },
+        { key: 'appSecret', required: true, env: true, description: '公众号 AppSecret', descriptionI18n: { en: "WeChat Official Account app secret" } },
+        { key: 'token', required: true, env: true, description: '服务器配置 token', descriptionI18n: { en: "Server configuration token" } },
+        { key: 'encodingAESKey', env: true, description: '消息加解密 key', descriptionI18n: { en: "Message encryption key" } },
     ],
     running: (use) => use(wechatMpRuntimeStateToken).endpoints.values(),
     describeEntry: (entry) => `appId: ${String(entry.appId)}`,

package/commands/wechat-mp/endpoint/definition.ts

@@ -10,10 +10,10 @@ export const wechatMpEndpointCommands = createEndpointCommands({
   adapterKey: 'wechat-mp',
   adapterDisplayName: 'WeChat MP',
   fields: [
-    { key: 'appId', required: true, env: true, description: '公众号 AppID' },
-    { key: 'appSecret', required: true, env: true, description: '公众号 AppSecret' },
-    { key: 'token', required: true, env: true, description: '服务器配置 token' },
-    { key: 'encodingAESKey', env: true, description: '消息加解密 key' },
+    { key: 'appId', required: true, env: true, description: '公众号 AppID', descriptionI18n: { en: "WeChat Official Account app ID" } },
+    { key: 'appSecret', required: true, env: true, description: '公众号 AppSecret', descriptionI18n: { en: "WeChat Official Account app secret" } },
+    { key: 'token', required: true, env: true, description: '服务器配置 token', descriptionI18n: { en: "Server configuration token" } },
+    { key: 'encodingAESKey', env: true, description: '消息加解密 key', descriptionI18n: { en: "Message encryption key" } },
   ],
   running: (use) => use(wechatMpRuntimeStateToken).endpoints.values(),
   describeEntry: (entry) => `appId: ${String(entry.appId)}`,

package/lib/protocol.d.ts

@@ -1,7 +1,4 @@
-/**
- * WeChat Official Account (MP) protocol helpers — no legacy Adapter/Endpoint.
- * Canonicalization is owned by gateway/core before endpoint.send.
- */
+import { type Locale } from 'zhin.js/i18n';
 import type { IncomingMessage } from 'node:http';
 import type { ConversationRef } from '@zhin.js/im-contract';
 /** One endpoint config after AdapterIndex expands `plugins.<instanceKey>.endpoints`. */
@@ -111,10 +108,7 @@ export declare function wechatMpInboundConversation(endpointKey: string, msg: We
 export declare function formatInboundId(msg: WeChatMessage): string;
 /** Build inbound text for OutboundMessageService.receive. */
 export declare function formatInboundContent(msg: WeChatMessage): string;
-/**
- * Built-in passive XML for subscribe etc. Empty string = fall through to gateway.
- */
-export declare function resolveEventPassiveReply(msg: WeChatMessage): string;
+export declare function resolveEventPassiveReply(msg: WeChatMessage, locale?: Locale): string;
 /**
  * Wire-encode an already-rendered outbound payload into客服消息 JSON body.
  */

package/lib/protocol.js

@@ -1,3 +1,4 @@
+import { createMessages } from 'zhin.js/i18n';
 /**
  * WeChat Official Account (MP) protocol helpers — no legacy Adapter/Endpoint.
  * Canonicalization is owned by gateway/core before endpoint.send.
@@ -220,11 +221,14 @@ export function formatInboundContent(msg) {
 /**
  * Built-in passive XML for subscribe etc. Empty string = fall through to gateway.
  */
-export function resolveEventPassiveReply(msg) {
+const passiveMessages = createMessages({
+    subscribed: { 'zh-CN': '感谢关注！', en: 'Thank you for following!' },
+});
+export function resolveEventPassiveReply(msg, locale) {
     if (msg.MsgType !== 'event')
         return '';
     if (msg.Event === 'subscribe') {
-        return buildTextReply(msg, '感谢关注！');
+        return buildTextReply(msg, passiveMessages(locale, 'subscribed'));
     }
     return '';
 }

package/lib/webhook.d.ts

@@ -2,6 +2,7 @@
  * WeChat MP webhook HTTP: URL verification + inbound message handling.
  */
 import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { Locale } from 'zhin.js/i18n';
 import type { HttpHost, HttpRouteRegistration } from '@zhin.js/host-http';
 import type { CapabilityId } from 'zhin.js';
 import { type ResolvedWeChatMpConfig, type WeChatMessage } from './protocol.js';
@@ -10,6 +11,7 @@ export interface WeChatMpWebhookHandler {
     readonly isOpen: boolean;
     readonly id: CapabilityId;
     admit(msg: WeChatMessage): void | Promise<unknown>;
+    resolveLocale?(senderId: string): Promise<Locale | undefined>;
     /** MsgId 去重缓存（可选；实现见 WeChatMpEndpoint）。 */
     getCachedReply?(msgId: string): string | undefined;
     cacheReply?(msgId: string, replyXML: string): void;

package/lib/webhook.js

@@ -101,7 +101,10 @@ export async function handleWeChatMpMessage(request, response, url, handler) {
                 return;
             }
         }
-        let replyXML = resolveEventPassiveReply(wechatMessage);
+        const locale = wechatMessage.MsgType === 'event' && wechatMessage.Event === 'subscribe'
+            ? await handler.resolveLocale?.(wechatMessage.FromUserName)
+            : undefined;
+        let replyXML = resolveEventPassiveReply(wechatMessage, locale);
         if (!replyXML && handler.isOpen) {
             if (config.replyMode === 'passive') {
                 replyXML = await collectPassiveReply(handler, wechatMessage);

package/package.json

@@ -1,27 +1,27 @@
 {
   "name": "@zhin.js/adapter-wechat-mp",
-  "version": "1.1.14",
+  "version": "1.1.16",
   "type": "module",
   "description": "Zhin.js WeChat Official Account adapter for Plugin Runtime (HTTP webhook)",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
   "dependencies": {
-    "axios": "^1.19.0",
+    "axios": "^1.20.0",
     "xml2js": "^0.6.2",
-    "@zhin.js/adapter": "1.1.21",
-    "@zhin.js/core": "1.1.49",
-    "@zhin.js/feature-kit": "1.1.7",
-    "@zhin.js/host-http": "1.1.8",
-    "@zhin.js/im-contract": "1.1.5",
+    "@zhin.js/adapter": "1.1.23",
+    "@zhin.js/core": "1.1.51",
+    "@zhin.js/feature-kit": "1.1.9",
+    "@zhin.js/host-http": "1.1.10",
+    "@zhin.js/im-contract": "1.1.7",
     "@zhin.js/logger": "1.1.2",
-    "@zhin.js/skill": "1.1.8"
+    "@zhin.js/skill": "1.1.10"
   },
   "peerDependencies": {
-    "@zhin.js/adapter": "^1.1.21",
-    "@zhin.js/command": "^1.1.9",
-    "@zhin.js/core": "^1.1.49",
-    "@zhin.js/host-http": "^1.1.8",
-    "zhin.js": "^1.1.14"
+    "@zhin.js/adapter": "^1.1.23",
+    "@zhin.js/command": "^1.1.11",
+    "@zhin.js/core": "^1.1.51",
+    "@zhin.js/host-http": "^1.1.10",
+    "zhin.js": "^1.1.16"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {
@@ -36,7 +36,7 @@
     "@types/xml2js": "^0.4.14",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
-    "zhin.js": "1.1.14"
+    "zhin.js": "1.1.16"
   },
   "keywords": [
     "zhin",

package/schema.json

@@ -37,7 +37,12 @@
         "string",
         "number"
       ],
-      "description": "框架 master（WeChat OpenID；AI/工具权限、endpoint 管理）。endpoints[i].master 可逐项覆盖"
+      "description": "框架 master（WeChat OpenID；AI/工具权限、endpoint 管理）。endpoints[i].master 可逐项覆盖",
+      "x-i18n": {
+        "en": {
+          "description": "Framework masters (WeChat OpenID; AI/tool permissions and endpoint management). endpoints[i].master can override this value."
+        }
+      }
     },
     "trusted": {
       "type": "array",
@@ -48,7 +53,12 @@
         ],
         "description": "Trusted WeChat OpenID"
       },
-      "description": "框架 trusted 用户列表（弱于 master）。endpoints[i].trusted 可逐项追加"
+      "description": "框架 trusted 用户列表（弱于 master）。endpoints[i].trusted 可逐项追加",
+      "x-i18n": {
+        "en": {
+          "description": "Framework trusted users, below master authority. endpoints[i].trusted can add users."
+        }
+      }
     },
     "endpoints": {
       "type": "array",
@@ -63,7 +73,12 @@
               "string",
               "number"
             ],
-            "description": "本 endpoint 的框架 master（WeChat OpenID）；覆盖顶层 master"
+            "description": "本 endpoint 的框架 master（WeChat OpenID）；覆盖顶层 master",
+            "x-i18n": {
+              "en": {
+                "description": "Framework masters for this endpoint (WeChat OpenID), overriding the top-level master list."
+              }
+            }
           },
           "trusted": {
             "type": "array",
@@ -74,7 +89,12 @@
               ],
               "description": "Trusted WeChat OpenID"
             },
-            "description": "本 endpoint 的 trusted 列表"
+            "description": "本 endpoint 的 trusted 列表",
+            "x-i18n": {
+              "en": {
+                "description": "Trusted users for this endpoint."
+              }
+            }
           },
           "appId": {
             "type": "string",
@@ -130,12 +150,22 @@
           "appSecret",
           "token"
         ]
+      },
+      "x-i18n": {
+        "en": {
+          "description": "Multiple accounts: mount multiple endpoints in one plugin instance. Each entry uses the top-level fields; id is required and other fields override defaults."
+        }
       }
     },
     "commandPrefix": {
       "type": "string",
       "default": "",
-      "description": "命令前缀（默认 '' 无前缀，任意文本按命令匹配；如 '/' 要求 / 开头）。endpoints[i] 可逐项覆盖"
+      "description": "命令前缀（默认 '' 无前缀，任意文本按命令匹配；如 '/' 要求 / 开头）。endpoints[i] 可逐项覆盖",
+      "x-i18n": {
+        "en": {
+          "description": "Command prefix. The default empty string allows unprefixed commands; '/' requires a leading slash. Each endpoints[i] can override it."
+        }
+      }
     }
   },
   "required": [

package/src/protocol.ts

@@ -1,3 +1,4 @@
+import { createMessages, type Locale } from 'zhin.js/i18n';
 /**
  * WeChat Official Account (MP) protocol helpers — no legacy Adapter/Endpoint.
  * Canonicalization is owned by gateway/core before endpoint.send.
@@ -366,10 +367,14 @@ export function formatInboundContent(msg: WeChatMessage): string {
 /**
  * Built-in passive XML for subscribe etc. Empty string = fall through to gateway.
  */
-export function resolveEventPassiveReply(msg: WeChatMessage): string {
+const passiveMessages = createMessages({
+  subscribed: { 'zh-CN': '感谢关注！', en: 'Thank you for following!' },
+});
+
+export function resolveEventPassiveReply(msg: WeChatMessage, locale?: Locale): string {
   if (msg.MsgType !== 'event') return '';
   if (msg.Event === 'subscribe') {
-    return buildTextReply(msg, '感谢关注！');
+    return buildTextReply(msg, passiveMessages(locale, 'subscribed'));
   }
   return '';
 }

package/src/webhook.ts

@@ -2,6 +2,7 @@
  * WeChat MP webhook HTTP: URL verification + inbound message handling.
  */
 import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { Locale } from 'zhin.js/i18n';
 import type { HttpHost, HttpRouteRegistration } from '@zhin.js/host-http';
 import { formatCompact, getLogger } from '@zhin.js/logger';
 import type { CapabilityId } from 'zhin.js';
@@ -36,6 +37,7 @@ export interface WeChatMpWebhookHandler {
   readonly isOpen: boolean;
   readonly id: CapabilityId;
   admit(msg: WeChatMessage): void | Promise<unknown>;
+  resolveLocale?(senderId: string): Promise<Locale | undefined>;
   /** MsgId 去重缓存（可选；实现见 WeChatMpEndpoint）。 */
   getCachedReply?(msgId: string): string | undefined;
   cacheReply?(msgId: string, replyXML: string): void;
@@ -172,7 +174,10 @@ export async function handleWeChatMpMessage(
       }
     }
 
-    let replyXML = resolveEventPassiveReply(wechatMessage);
+    const locale = wechatMessage.MsgType === 'event' && wechatMessage.Event === 'subscribe'
+      ? await handler.resolveLocale?.(wechatMessage.FromUserName)
+      : undefined;
+    let replyXML = resolveEventPassiveReply(wechatMessage, locale);
 
     if (!replyXML && handler.isOpen) {
       if (config.replyMode === 'passive') {