@zhin.js/plugin-group-suite 1.1.14 → 1.1.16

package/README.md

@@ -105,6 +105,12 @@ group-suite:
 `null`、空 ID、残缺父容器和额外字段会被拒绝。重复条目不会重复发送欢迎。
 白名单只筛选入站群成员加入事件，不改写原会话投递目标，也不限制签到、词库、统计等能力。
 
+同一群若开启了 Agent 会话欢迎（ADR 0037 切片 A 的 `welcome.enabled`），本插件让路不发，
+由会话欢迎发唯一一条（合并窗口、小时上限、控制面、session-gate 都按会话欢迎走；`mention_only` 不拦欢迎）。
+两边同时开启也不会双发；未装 Agent 或会话未开启时本插件照常发送。
+见[群欢迎指南](https://github.com/zhinjs/zhin/blob/main/docs/solutions/group-welcome.md)「与 Agent 会话欢迎的关系」。
+成员退群时本插件不发送消息。
+
 这不补充平台本身缺少的入站事件或目标：未提供 canonical 群会话的成员加入事件不会发送欢迎，
 也不会推测频道。配置可热更新，校验失败保留旧配置与 generation；没有单独的范围数据库。
 
@@ -128,3 +134,9 @@ pnpm --filter @zhin.js/plugin-group-suite test
 无数据库错误、热更新、配置失败回滚及新进程重启后的持久词库。HTML 渲染使用 stub，另测文本
 降级；统计/签到/教学模型在此 fixture 为内存端口。它不代表真实平台登录、欢迎投递、截图质量或
 生产数据库端到端验收；实机操作需要单独授权。
+
+## 语言
+
+签到、积分、问答管理、关键词管理与消息统计根据当前发送者语言显示中文或英文；统计图卡及统一发送链的文本降级使用同一语言。AI Tool 反馈使用可信调用上下文中的语言。
+
+自定义欢迎语、词库回答、用户昵称和分析得到的内容保持原文；问答模板的日期与时间仅使用当前语言格式化，不改变既有时区。命令路径、别名、权限与统计范围不变。签到提示使用当前环境真实命令前缀和命名空间；无法确定调用头时只提示入口，不猜测命令。

package/commands/checkin/index.js

@@ -4,9 +4,9 @@ import { resolveGroupSuiteConfig } from "../../lib/config.js";
 import { doCheckin } from "../../lib/checkin-lib.js";
 import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
 export default defineCommand({
-    description: '每日签到获得积分',
+    description: '每日签到获得积分', descriptionI18n: { en: "Check in daily to earn points" },
     alias: ['checkin do', '签到'],
-    execute({ config, input, owner, use }) {
-        return doCheckin(input ?? {}, resolveGroupSuiteConfig(config), resolveGroupSuiteRuntime({ owner, use }));
+    execute({ config, input, owner, use, locale }) {
+        return doCheckin({ ...input, locale }, resolveGroupSuiteConfig(config), resolveGroupSuiteRuntime({ owner, use }));
     },
 });

package/commands/checkin/index.ts

@@ -5,9 +5,9 @@ import { doCheckin } from '../../src/checkin-lib.js';
 import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
-  description: '每日签到获得积分',
+  description: '每日签到获得积分', descriptionI18n: { en: "Check in daily to earn points" },
   alias: ['checkin do', '签到'],
-  execute({ config, input, owner, use }) {
-    return doCheckin(input ?? {}, resolveGroupSuiteConfig(config), resolveGroupSuiteRuntime({ owner, use }));
+  execute({ config, input, owner, use, locale }) {
+    return doCheckin({ ...input, locale }, resolveGroupSuiteConfig(config), resolveGroupSuiteRuntime({ owner, use }));
   },
 });

package/commands/forget/index.js

@@ -4,8 +4,8 @@ import { teachForget } from "../../lib/teach-lib.js";
 import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
 export default defineCommand({
     permit: ['group()', 'role(owner,admin,master,trusted)'],
-    description: '忘记问答（删除问答对）',
-    execute({ input, args, owner, use }) {
-        return teachForget(input ?? {}, args.join(' '), resolveGroupSuiteRuntime({ owner, use }));
+    description: '忘记问答（删除问答对）', descriptionI18n: { en: "Delete a learned question and answer pair" },
+    execute({ input, args, owner, use, locale }) {
+        return teachForget({ ...input, locale }, args.join(' '), resolveGroupSuiteRuntime({ owner, use }));
     },
 });

package/commands/forget/index.ts

@@ -6,8 +6,8 @@ import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
   permit: ['group()', 'role(owner,admin,master,trusted)'],
-  description: '忘记问答（删除问答对）',
-  execute({ input, args, owner, use }) {
-    return teachForget(input ?? {}, args.join(' '), resolveGroupSuiteRuntime({ owner, use }));
+  description: '忘记问答（删除问答对）', descriptionI18n: { en: "Delete a learned question and answer pair" },
+  execute({ input, args, owner, use, locale }) {
+    return teachForget({ ...input, locale }, args.join(' '), resolveGroupSuiteRuntime({ owner, use }));
   },
 });

package/commands/keyword-add/[keyword]/index.js

@@ -1,19 +1,20 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { keywordsForCommand } from "../../../lib/keywords.js";
 export default defineCommand({
     permit: ['group()', 'role(owner,admin,master,trusted)'],
-    description: '添加当前群关键词自动回复',
+    description: '添加当前群关键词自动回复', descriptionI18n: { en: "Add a keyword reply in this group" },
     params: { keyword: { type: 'string' } },
     async execute(context) {
         const keyword = String(context.params.keyword ?? '');
         const reply = context.args.join(' ').trim();
         if (!keyword || !reply)
-            return '请提供关键词和回复内容';
+            return t(context.locale, 'keywordRequired');
         const repository = keywordsForCommand(context.input, context);
         if (typeof repository === 'string')
             return repository;
         await repository.update(store => { store.set(keyword, reply); });
-        return `已添加关键词「${keyword}」→「${reply}」`;
+        return t(context.locale, 'keywordAdded', { keyword, reply });
     },
 });

package/commands/keyword-add/[keyword]/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from '../../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import type { Message } from '@zhin.js/core/runtime';
 import type { GroupSuiteConfig } from '../../../src/config.js';
@@ -5,15 +6,15 @@ import { keywordsForCommand } from '../../../src/keywords.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
   permit: ['group()', 'role(owner,admin,master,trusted)'],
-  description: '添加当前群关键词自动回复',
+  description: '添加当前群关键词自动回复', descriptionI18n: { en: "Add a keyword reply in this group" },
   params: { keyword: { type: 'string' } },
   async execute(context) {
     const keyword = String(context.params.keyword ?? '');
     const reply = context.args.join(' ').trim();
-    if (!keyword || !reply) return '请提供关键词和回复内容';
+    if (!keyword || !reply) return t(context.locale, 'keywordRequired');
     const repository = keywordsForCommand(context.input, context);
     if (typeof repository === 'string') return repository;
     await repository.update(store => { store.set(keyword, reply); });
-    return `已添加关键词「${keyword}」→「${reply}」`;
+    return t(context.locale, 'keywordAdded', { keyword, reply });
   },
 });

package/commands/keyword-list/index.js

@@ -1,17 +1,18 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { keywordsForCommand } from "../../lib/keywords.js";
 export default defineCommand({
     permit: ['group()'],
-    description: '查看当前群关键词回复对',
+    description: '查看当前群关键词回复对', descriptionI18n: { en: "List this group's keyword replies" },
     async execute(context) {
         const repository = keywordsForCommand(context.input, context);
         if (typeof repository === 'string')
             return repository;
         const entries = await repository.read();
         if (entries.length === 0)
-            return '当前没有设置任何关键词';
+            return t(context.locale, 'keywordEmpty');
         const lines = entries.map(([k, v], i) => `${i + 1}. 「${k}」→「${v}」`);
-        return `关键词列表（共 ${entries.length} 条）：\n${lines.join('\n')}`;
+        return t(context.locale, 'keywordList', { count: entries.length, lines: lines.join('\n') });
     },
 });

package/commands/keyword-list/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from '../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import type { Message } from '@zhin.js/core/runtime';
 import type { GroupSuiteConfig } from '../../src/config.js';
@@ -5,13 +6,13 @@ import { keywordsForCommand } from '../../src/keywords.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
   permit: ['group()'],
-  description: '查看当前群关键词回复对',
+  description: '查看当前群关键词回复对', descriptionI18n: { en: "List this group's keyword replies" },
   async execute(context) {
     const repository = keywordsForCommand(context.input, context);
     if (typeof repository === 'string') return repository;
     const entries = await repository.read();
-    if (entries.length === 0) return '当前没有设置任何关键词';
+    if (entries.length === 0) return t(context.locale, 'keywordEmpty');
     const lines = entries.map(([k, v], i) => `${i + 1}. 「${k}」→「${v}」`);
-    return `关键词列表（共 ${entries.length} 条）：\n${lines.join('\n')}`;
+    return t(context.locale, 'keywordList', { count: entries.length, lines: lines.join('\n') });
   },
 });

package/commands/keyword-remove/[keyword]/index.js

@@ -1,20 +1,21 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { keywordsForCommand } from "../../../lib/keywords.js";
 export default defineCommand({
     permit: ['group()', 'role(owner,admin,master,trusted)'],
-    description: '删除当前群关键词自动回复',
+    description: '删除当前群关键词自动回复', descriptionI18n: { en: "Delete a keyword reply in this group" },
     params: { keyword: { type: 'string' } },
     async execute(context) {
         const keyword = String(context.params.keyword ?? '');
         if (!keyword)
-            return '请提供要删除的关键词';
+            return t(context.locale, 'keywordRemoveRequired');
         const repository = keywordsForCommand(context.input, context);
         if (typeof repository === 'string')
             return repository;
         if (!(await repository.read()).some(([entry]) => entry === keyword))
-            return `关键词「${keyword}」不存在`;
+            return t(context.locale, 'keywordMissing', { keyword });
         await repository.update(store => { store.delete(keyword); });
-        return `已删除关键词「${keyword}」`;
+        return t(context.locale, 'keywordRemoved', { keyword });
     },
 });

package/commands/keyword-remove/[keyword]/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from '../../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import type { Message } from '@zhin.js/core/runtime';
 import type { GroupSuiteConfig } from '../../../src/config.js';
@@ -5,15 +6,15 @@ import { keywordsForCommand } from '../../../src/keywords.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
   permit: ['group()', 'role(owner,admin,master,trusted)'],
-  description: '删除当前群关键词自动回复',
+  description: '删除当前群关键词自动回复', descriptionI18n: { en: "Delete a keyword reply in this group" },
   params: { keyword: { type: 'string' } },
   async execute(context) {
     const keyword = String(context.params.keyword ?? '');
-    if (!keyword) return '请提供要删除的关键词';
+    if (!keyword) return t(context.locale, 'keywordRemoveRequired');
     const repository = keywordsForCommand(context.input, context);
     if (typeof repository === 'string') return repository;
-    if (!(await repository.read()).some(([entry]) => entry === keyword)) return `关键词「${keyword}」不存在`;
+    if (!(await repository.read()).some(([entry]) => entry === keyword)) return t(context.locale, 'keywordMissing', { keyword });
     await repository.update(store => { store.delete(keyword); });
-    return `已删除关键词「${keyword}」`;
+    return t(context.locale, 'keywordRemoved', { keyword });
   },
 });

package/commands/mypoints/index.js

@@ -3,9 +3,9 @@ import { defineCommand } from 'zhin.js/command';
 import { myPoints } from "../../lib/checkin-lib.js";
 import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
 export default defineCommand({
-    description: '查看个人积分与签到信息',
+    description: '查看个人积分与签到信息', descriptionI18n: { en: "View your points and daily check-in" },
     alias: ['checkin streak'],
-    execute({ input, owner, use }) {
-        return myPoints(input ?? {}, resolveGroupSuiteRuntime({ owner, use }));
+    execute({ input, owner, use, locale, formatCommand }) {
+        return myPoints({ ...input, locale }, resolveGroupSuiteRuntime({ owner, use }), formatCommand?.('checkin'));
     },
 });

package/commands/mypoints/index.ts

@@ -5,9 +5,9 @@ import { myPoints } from '../../src/checkin-lib.js';
 import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
-  description: '查看个人积分与签到信息',
+  description: '查看个人积分与签到信息', descriptionI18n: { en: "View your points and daily check-in" },
   alias: ['checkin streak'],
-  execute({ input, owner, use }) {
-    return myPoints(input ?? {}, resolveGroupSuiteRuntime({ owner, use }));
+  execute({ input, owner, use, locale, formatCommand }) {
+    return myPoints({ ...input, locale }, resolveGroupSuiteRuntime({ owner, use }), formatCommand?.('checkin'));
   },
 });

package/commands/mystats/index.js

@@ -3,8 +3,8 @@ import { defineCommand } from 'zhin.js/command';
 import { myStatsText } from "../../lib/stats-lib.js";
 import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
 export default defineCommand({
-    description: '查看个人消息统计',
-    execute({ input, owner, use }) {
-        return myStatsText(input ?? {}, resolveGroupSuiteRuntime({ owner, use }));
+    description: '查看个人消息统计', descriptionI18n: { en: "View your message statistics" },
+    execute({ input, owner, use, locale, formatCommand }) {
+        return myStatsText({ ...input, locale }, resolveGroupSuiteRuntime({ owner, use }));
     },
 });

package/commands/mystats/index.ts

@@ -5,8 +5,8 @@ import { myStatsText } from '../../src/stats-lib.js';
 import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
-  description: '查看个人消息统计',
-  execute({ input, owner, use }) {
-    return myStatsText(input ?? {}, resolveGroupSuiteRuntime({ owner, use }));
+  description: '查看个人消息统计', descriptionI18n: { en: "View your message statistics" },
+  execute({ input, owner, use, locale, formatCommand }) {
+    return myStatsText({ ...input, locale }, resolveGroupSuiteRuntime({ owner, use }));
   },
 });

package/commands/rank/index.js

@@ -4,9 +4,9 @@ import { resolveGroupSuiteConfig } from "../../lib/config.js";
 import { pointsRank } from "../../lib/checkin-lib.js";
 import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
 export default defineCommand({
-    description: '查看积分排行榜',
+    description: '查看积分排行榜', descriptionI18n: { en: "View the points leaderboard" },
     alias: ['checkin rank'],
-    execute({ config, input, owner, use }) {
-        return pointsRank(input ?? {}, resolveGroupSuiteConfig(config), resolveGroupSuiteRuntime({ owner, use }));
+    execute({ config, input, owner, use, locale }) {
+        return pointsRank({ ...input, locale }, resolveGroupSuiteConfig(config), resolveGroupSuiteRuntime({ owner, use }));
     },
 });

package/commands/rank/index.ts

@@ -5,9 +5,9 @@ import { pointsRank } from '../../src/checkin-lib.js';
 import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
-  description: '查看积分排行榜',
+  description: '查看积分排行榜', descriptionI18n: { en: "View the points leaderboard" },
   alias: ['checkin rank'],
-  execute({ config, input, owner, use }) {
-    return pointsRank(input ?? {}, resolveGroupSuiteConfig(config), resolveGroupSuiteRuntime({ owner, use }));
+  execute({ config, input, owner, use, locale }) {
+    return pointsRank({ ...input, locale }, resolveGroupSuiteConfig(config), resolveGroupSuiteRuntime({ owner, use }));
   },
 });

package/commands/stats/index.js

@@ -1,14 +1,15 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { resolveGroupSuiteConfig } from "../../lib/config.js";
 import { todayStr } from "../../lib/shared-runtime.js";
 import { resolveGroupId, statsRankText } from "../../lib/stats-lib.js";
 import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
 export default defineCommand({
-    description: '查看今日消息统计',
-    execute({ config, input, owner, use }) {
-        const groupId = resolveGroupId(input ?? {});
-        const title = groupId ? '今日本群消息统计' : '今日全局消息统计';
-        return statsRankText(input ?? {}, resolveGroupSuiteConfig(config), todayStr(), title, resolveGroupSuiteRuntime({ owner, use }));
+    description: '查看今日消息统计', descriptionI18n: { en: "View today's message statistics" },
+    execute({ config, input, owner, use, locale }) {
+        const groupId = resolveGroupId({ ...input, locale });
+        const title = groupId ? t(locale, 'statsTodayGroup') : t(locale, 'statsTodayAll');
+        return statsRankText({ ...input, locale }, resolveGroupSuiteConfig(config), todayStr(), title, resolveGroupSuiteRuntime({ owner, use }));
     },
 });

package/commands/stats/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from '../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import type { Message } from '@zhin.js/core/runtime';
 import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../../src/config.js';
@@ -6,12 +7,12 @@ import { resolveGroupId, statsRankText } from '../../src/stats-lib.js';
 import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
-  description: '查看今日消息统计',
-  execute({ config, input, owner, use }) {
-    const groupId = resolveGroupId(input ?? {});
-    const title = groupId ? '今日本群消息统计' : '今日全局消息统计';
+  description: '查看今日消息统计', descriptionI18n: { en: "View today's message statistics" },
+  execute({ config, input, owner, use, locale }) {
+    const groupId = resolveGroupId({ ...input, locale });
+    const title = groupId ? t(locale, 'statsTodayGroup') : t(locale, 'statsTodayAll');
     return statsRankText(
-      input ?? {},
+      { ...input, locale },
       resolveGroupSuiteConfig(config),
       todayStr(),
       title,

package/commands/stats-card/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { segment } from 'zhin.js';
 import { resolveGroupSuiteConfig } from "../../lib/config.js";
@@ -8,7 +9,7 @@ import { buildStatsRankReportData } from "../../lib/stats-data.js";
 import { buildStatsRankHtml, STATS_REPORT_CANVAS } from "../../lib/stats-card.js";
 import { todayStr, resolveSender } from "../../lib/shared-runtime.js";
 export default defineCommand({
-    description: '查看今日群消息统计卡片（不支持图片时显示文本）',
+    description: '查看今日群消息统计卡片（不支持图片时显示文本）', descriptionI18n: { en: "View today's group statistics card, with a text fallback" },
     permit: ['group()'],
     async execute(context) {
         if (!context.input)
@@ -16,8 +17,8 @@ export default defineCommand({
         const runtime = resolveGroupSuiteRuntime(context);
         await flushStatsBuffer(runtime);
         const stats = await queryStats(resolveGroupId(context.input), todayStr(), runtime);
-        const data = buildStatsRankReportData(stats, '今日本群消息统计', resolveGroupSuiteConfig(context.config).rankSize, resolveSender(context.input).id);
-        return segment.html({ html: await buildStatsRankHtml(data), width: 540,
+        const data = buildStatsRankReportData(stats, t(context.locale, 'statsTodayGroup'), resolveGroupSuiteConfig(context.config).rankSize, resolveSender(context.input).id);
+        return segment.html({ html: await buildStatsRankHtml(data, context.locale), width: 540,
             backgroundColor: STATS_REPORT_CANVAS, fileName: 'group-stats.png' });
     },
 });

package/commands/stats-card/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from '../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import { segment } from 'zhin.js';
 import type { Message, SendContent } from '@zhin.js/core/runtime';
@@ -9,16 +10,16 @@ import { buildStatsRankHtml, STATS_REPORT_CANVAS } from '../../src/stats-card.js
 import { todayStr, resolveSender } from '../../src/shared-runtime.js';
 
 export default defineCommand<GroupSuiteConfig, SendContent, Message>({
-  description: '查看今日群消息统计卡片（不支持图片时显示文本）',
+  description: '查看今日群消息统计卡片（不支持图片时显示文本）', descriptionI18n: { en: "View today's group statistics card, with a text fallback" },
   permit: ['group()'],
   async execute(context) {
     if (!context.input) throw new Error('Group statistics require an incoming message');
     const runtime = resolveGroupSuiteRuntime(context);
     await flushStatsBuffer(runtime);
     const stats = await queryStats(resolveGroupId(context.input), todayStr(), runtime);
-    const data = buildStatsRankReportData(stats, '今日本群消息统计',
+    const data = buildStatsRankReportData(stats, t(context.locale, 'statsTodayGroup'),
       resolveGroupSuiteConfig(context.config).rankSize, resolveSender(context.input).id);
-    return segment.html({ html: await buildStatsRankHtml(data), width: 540,
+    return segment.html({ html: await buildStatsRankHtml(data, context.locale), width: 540,
       backgroundColor: STATS_REPORT_CANVAS, fileName: 'group-stats.png' });
   },
 });

package/commands/stats-rank/index.js

@@ -1,13 +1,14 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { resolveGroupSuiteConfig } from "../../lib/config.js";
 import { monthStartStr, resolveGroupId, statsRankText } from "../../lib/stats-lib.js";
 import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
 export default defineCommand({
-    description: '查看本月话唠排行',
-    execute({ config, input, owner, use }) {
-        const groupId = resolveGroupId(input ?? {});
-        const title = groupId ? '本月话唠排行' : '全局话唠排行';
-        return statsRankText(input ?? {}, resolveGroupSuiteConfig(config), monthStartStr(), title, resolveGroupSuiteRuntime({ owner, use }));
+    description: '查看本月话唠排行', descriptionI18n: { en: "View this month's most active members" },
+    execute({ config, input, owner, use, locale }) {
+        const groupId = resolveGroupId({ ...input, locale });
+        const title = groupId ? t(locale, 'statsMonthGroup') : t(locale, 'statsMonthAll');
+        return statsRankText({ ...input, locale }, resolveGroupSuiteConfig(config), monthStartStr(), title, resolveGroupSuiteRuntime({ owner, use }));
     },
 });

package/commands/stats-rank/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from '../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import type { Message } from '@zhin.js/core/runtime';
 import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../../src/config.js';
@@ -5,12 +6,12 @@ import { monthStartStr, resolveGroupId, statsRankText } from '../../src/stats-li
 import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
-  description: '查看本月话唠排行',
-  execute({ config, input, owner, use }) {
-    const groupId = resolveGroupId(input ?? {});
-    const title = groupId ? '本月话唠排行' : '全局话唠排行';
+  description: '查看本月话唠排行', descriptionI18n: { en: "View this month's most active members" },
+  execute({ config, input, owner, use, locale }) {
+    const groupId = resolveGroupId({ ...input, locale });
+    const title = groupId ? t(locale, 'statsMonthGroup') : t(locale, 'statsMonthAll');
     return statsRankText(
-      input ?? {},
+      { ...input, locale },
       resolveGroupSuiteConfig(config),
       monthStartStr(),
       title,

package/commands/stats-week/index.js

@@ -1,13 +1,14 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { resolveGroupSuiteConfig } from "../../lib/config.js";
 import { resolveGroupId, statsRankText, weekStartStr } from "../../lib/stats-lib.js";
 import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
 export default defineCommand({
-    description: '查看本周消息统计',
-    execute({ config, input, owner, use }) {
-        const groupId = resolveGroupId(input ?? {});
-        const title = groupId ? '本周本群消息统计' : '本周全局消息统计';
-        return statsRankText(input ?? {}, resolveGroupSuiteConfig(config), weekStartStr(), title, resolveGroupSuiteRuntime({ owner, use }));
+    description: '查看本周消息统计', descriptionI18n: { en: "View this week's message statistics" },
+    execute({ config, input, owner, use, locale }) {
+        const groupId = resolveGroupId({ ...input, locale });
+        const title = groupId ? t(locale, 'statsWeekGroup') : t(locale, 'statsWeekAll');
+        return statsRankText({ ...input, locale }, resolveGroupSuiteConfig(config), weekStartStr(), title, resolveGroupSuiteRuntime({ owner, use }));
     },
 });

package/commands/stats-week/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from '../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import type { Message } from '@zhin.js/core/runtime';
 import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../../src/config.js';
@@ -5,12 +6,12 @@ import { resolveGroupId, statsRankText, weekStartStr } from '../../src/stats-lib
 import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
-  description: '查看本周消息统计',
-  execute({ config, input, owner, use }) {
-    const groupId = resolveGroupId(input ?? {});
-    const title = groupId ? '本周本群消息统计' : '本周全局消息统计';
+  description: '查看本周消息统计', descriptionI18n: { en: "View this week's message statistics" },
+  execute({ config, input, owner, use, locale }) {
+    const groupId = resolveGroupId({ ...input, locale });
+    const title = groupId ? t(locale, 'statsWeekGroup') : t(locale, 'statsWeekAll');
     return statsRankText(
-      input ?? {},
+      { ...input, locale },
       resolveGroupSuiteConfig(config),
       weekStartStr(),
       title,

package/commands/teach/index.js

@@ -5,8 +5,8 @@ import { teachAdd } from "../../lib/teach-lib.js";
 import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
 export default defineCommand({
     permit: ['group()', 'role(owner,admin,master,trusted)'],
-    description: '教我问答（teach 问题 回答 或 问题|答案）',
-    execute({ config, input, args, owner, use }) {
-        return teachAdd(input ?? {}, resolveGroupSuiteConfig(config), args.join(' '), false, resolveGroupSuiteRuntime({ owner, use }));
+    description: '教我问答（teach 问题 回答 或 问题|答案）', descriptionI18n: { en: "Teach a question and answer pair" },
+    execute({ config, input, args, owner, use, locale }) {
+        return teachAdd({ ...input, locale }, resolveGroupSuiteConfig(config), args.join(' '), false, resolveGroupSuiteRuntime({ owner, use }));
     },
 });

package/commands/teach/index.ts

@@ -6,8 +6,8 @@ import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
   permit: ['group()', 'role(owner,admin,master,trusted)'],
-  description: '教我问答（teach 问题 回答 或 问题|答案）',
-  execute({ config, input, args, owner, use }) {
-    return teachAdd(input ?? {}, resolveGroupSuiteConfig(config), args.join(' '), false, resolveGroupSuiteRuntime({ owner, use }));
+  description: '教我问答（teach 问题 回答 或 问题|答案）', descriptionI18n: { en: "Teach a question and answer pair" },
+  execute({ config, input, args, owner, use, locale }) {
+    return teachAdd({ ...input, locale }, resolveGroupSuiteConfig(config), args.join(' '), false, resolveGroupSuiteRuntime({ owner, use }));
   },
 });

package/commands/teach-list/[[page]]/index.js

@@ -4,10 +4,10 @@ import { resolveGroupSuiteConfig } from "../../../lib/config.js";
 import { teachList } from "../../../lib/teach-lib.js";
 import { resolveGroupSuiteRuntime } from "../../../lib/runtime-state.js";
 export default defineCommand({
-    description: '查看问答列表',
+    description: '查看问答列表', descriptionI18n: { en: "List learned questions and answers" },
     params: { page: { type: 'number', default: 1 } },
-    execute({ config, input, params, owner, use }) {
+    execute({ config, input, params, owner, use, locale }) {
         const page = Number(params.page ?? 1);
-        return teachList(input ?? {}, resolveGroupSuiteConfig(config), page, resolveGroupSuiteRuntime({ owner, use }));
+        return teachList({ ...input, locale }, resolveGroupSuiteConfig(config), page, resolveGroupSuiteRuntime({ owner, use }));
     },
 });

package/commands/teach-list/[[page]]/index.ts

@@ -5,10 +5,10 @@ import { teachList } from '../../../src/teach-lib.js';
 import { resolveGroupSuiteRuntime } from '../../../src/runtime-state.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
-  description: '查看问答列表',
+  description: '查看问答列表', descriptionI18n: { en: "List learned questions and answers" },
   params: { page: { type: 'number', default: 1 } },
-  execute({ config, input, params, owner, use }) {
+  execute({ config, input, params, owner, use, locale }) {
     const page = Number(params.page ?? 1);
-    return teachList(input ?? {}, resolveGroupSuiteConfig(config), page, resolveGroupSuiteRuntime({ owner, use }));
+    return teachList({ ...input, locale }, resolveGroupSuiteConfig(config), page, resolveGroupSuiteRuntime({ owner, use }));
   },
 });

package/commands/teach-regex/index.js

@@ -5,8 +5,8 @@ import { teachAdd } from "../../lib/teach-lib.js";
 import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
 export default defineCommand({
     permit: ['group()', 'role(owner,admin,master,trusted)'],
-    description: '教我正则问答',
-    execute({ config, input, args, owner, use }) {
-        return teachAdd(input ?? {}, resolveGroupSuiteConfig(config), args.join(' '), true, resolveGroupSuiteRuntime({ owner, use }));
+    description: '教我正则问答', descriptionI18n: { en: "Teach a regular-expression question and answer pair" },
+    execute({ config, input, args, owner, use, locale }) {
+        return teachAdd({ ...input, locale }, resolveGroupSuiteConfig(config), args.join(' '), true, resolveGroupSuiteRuntime({ owner, use }));
     },
 });

package/commands/teach-regex/index.ts

@@ -6,8 +6,8 @@ import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
   permit: ['group()', 'role(owner,admin,master,trusted)'],
-  description: '教我正则问答',
-  execute({ config, input, args, owner, use }) {
-    return teachAdd(input ?? {}, resolveGroupSuiteConfig(config), args.join(' '), true, resolveGroupSuiteRuntime({ owner, use }));
+  description: '教我正则问答', descriptionI18n: { en: "Teach a regular-expression question and answer pair" },
+  execute({ config, input, args, owner, use, locale }) {
+    return teachAdd({ ...input, locale }, resolveGroupSuiteConfig(config), args.join(' '), true, resolveGroupSuiteRuntime({ owner, use }));
   },
 });

package/handlers/welcome/index.js

@@ -1,6 +1,7 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { defineHandler } from 'zhin.js/handler';
-import { outboundMessageToken } from '@zhin.js/core/runtime';
+import { hasResource } from 'zhin.js';
+import { memberWelcomeOwnerToken, outboundMessageToken } from '@zhin.js/core/runtime';
 import { resolveGroupSuiteConfig } from "../../lib/config.js";
 import { welcomeConversationAllowed } from "../../lib/welcome-scope.js";
 /** Canonical notice input only; no SDK-specific callbacks or direct platform sends. */
@@ -14,6 +15,13 @@ export default defineHandler({
             return;
         if (!welcomeConversationAllowed(config.welcomeConversations, notice.conversation))
             return;
+        // #1012 A9 option 2: once the Agent session welcome (session-ops `welcome.enabled`) owns this
+        // conversation, MemberLifecycle sends the single welcome with its own gates; this plugin stays silent.
+        if (hasResource(this, memberWelcomeOwnerToken)) {
+            const owner = this.use(memberWelcomeOwnerToken);
+            if (owner.ownsWelcome(notice.conversation))
+                return;
+        }
         const content = text.replaceAll('{name}', notice.target.name ?? notice.target.id)
             .replaceAll('{id}', notice.target.id);
         const result = await this.use(outboundMessageToken).send({