@zhin.js/plugin-group-suite 1.1.24 → 1.1.26

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 凉菜
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -36,10 +36,18 @@ group-suite:
   rankSize: 10
   teachMaxPerGroup: 200
   teachCooldownMs: 3000
-  teachAllowRegex: true
+  teachAllowRegex: false # 默认关闭；见下方“正则问答”
   teachPageSize: 10
 ```
 
+### 正则问答
+
+`teachAllowRegex` 默认 `false`：正则规则会对每条入站消息执行，开启前请确认群成员可信。开启后：
+
+- `teach-regex` 只接受结构安全的表达式。带量词的分组内部不能再有量词或 `|`（如 `(\w+\s?)+`、`(a|aa)+`、`(.*a){10}` 会被拒绝，可改用字符类 `[ab]+`），不支持反向引用与环视，一条表达式最多 3 个 `*` / `+` / `{n,m}`。
+- 正则规则只对不超过 200 个字符的消息尝试匹配；精确问答不受此限制。
+- 关闭后已保存的正则规则保留但不再触发；旧版本存下的不安全表达式在匹配时会被跳过。
+
 约束以 [schema.json](./schema.json) 为准。启用关键词回复时默认要求 Database Host 的原子
 状态服务；没有该服务会启动失败并提示原因。演示环境可显式设置 `ephemeralKeywords: true`，
 此时词库只活在当前插件实例，插件重载或进程重启后会丢失。
@@ -57,6 +65,15 @@ group-suite:
 它是 best-effort 计数，并非持久 outbox：停止、插件重载或崩溃时尚未落库的批次可能丢失。
 退休 generation 的清理不额外写数据库，也不绕过代级准入。
 
+## 分层配置（ADR 0050 / 0055）
+
+支持全部四个层级：
+
+- 适配器、账号、会话层可以覆盖 `welcomeMessage`、`basePointsMin`、`basePointsMax`、`streakBonus`、`streakCap`、`rankSize`、`teachMaxPerGroup`、`teachCooldownMs`、`teachPageSize`。
+- `keywordReply`、`ephemeralKeywords`（决定存储方式）、`welcomeConversations`、`teachAllowRegex`（正则安全）只能在全局层修改。
+- 开启 `features.selfService.enabled` 后，群里的 `admin` 可以用 `功能 设置 group-suite welcomeMessage "欢迎 {name}"` 改本群欢迎语，也可以改 `rankSize`、`teachCooldownMs`、`teachPageSize`（`selfServiceFields`）；积分与问答上限只能在 Console 改。
+- 命令、中间件与入群欢迎都按所在会话读取有效配置，改动原地生效。推荐用会话层开关（`功能 关闭 group-suite`）代替 `welcomeConversations` 这类按群名单。
+
 ## 使用与权限
 
 未配置命名空间时直接使用表内指令名；如果实例设 `commandNamespace: suite`，使用

package/commands/checkin/index.js

@@ -1,12 +1,12 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { defineCommand } from 'zhin.js/command';
-import { resolveGroupSuiteConfig } from "../../lib/config.js";
+import { groupSuiteConfigFor } from "../../lib/config.js";
 import { doCheckin } from "../../lib/checkin-lib.js";
 import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
 export default defineCommand({
     description: '每日签到获得积分', descriptionI18n: { en: "Check in daily to earn points" },
     alias: ['checkin do', '签到'],
-    execute({ config, input, owner, use, locale }) {
-        return doCheckin({ ...input, locale }, resolveGroupSuiteConfig(config), resolveGroupSuiteRuntime({ owner, use }));
+    execute({ config, input, owner, use, has, locale }) {
+        return doCheckin({ ...input, locale }, groupSuiteConfigFor({ config, has, use }, input), resolveGroupSuiteRuntime({ owner, use }));
     },
 });

package/commands/checkin/index.ts

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

package/commands/forget/index.js

@@ -3,7 +3,7 @@ import { defineCommand } from 'zhin.js/command';
 import { teachForget } from "../../lib/teach-lib.js";
 import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
 export default defineCommand({
-    permit: ['group()', 'role(owner,admin,master,trusted)'],
+    permit: ['group()', 'trusted'],
     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

@@ -5,7 +5,7 @@ import { teachForget } from '../../src/teach-lib.js';
 import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
-  permit: ['group()', 'role(owner,admin,master,trusted)'],
+  permit: ['group()', 'trusted'],
   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

@@ -3,7 +3,7 @@ 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)'],
+    permit: ['group()', 'trusted'],
     description: '添加当前群关键词自动回复', descriptionI18n: { en: "Add a keyword reply in this group" },
     params: { keyword: { type: 'string' } },
     async execute(context) {

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

@@ -5,7 +5,7 @@ import type { GroupSuiteConfig } from '../../../src/config.js';
 import { keywordsForCommand } from '../../../src/keywords.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
-  permit: ['group()', 'role(owner,admin,master,trusted)'],
+  permit: ['group()', 'trusted'],
   description: '添加当前群关键词自动回复', descriptionI18n: { en: "Add a keyword reply in this group" },
   params: { keyword: { type: 'string' } },
   async execute(context) {

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

@@ -3,7 +3,7 @@ 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)'],
+    permit: ['group()', 'trusted'],
     description: '删除当前群关键词自动回复', descriptionI18n: { en: "Delete a keyword reply in this group" },
     params: { keyword: { type: 'string' } },
     async execute(context) {

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

@@ -5,7 +5,7 @@ import type { GroupSuiteConfig } from '../../../src/config.js';
 import { keywordsForCommand } from '../../../src/keywords.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
-  permit: ['group()', 'role(owner,admin,master,trusted)'],
+  permit: ['group()', 'trusted'],
   description: '删除当前群关键词自动回复', descriptionI18n: { en: "Delete a keyword reply in this group" },
   params: { keyword: { type: 'string' } },
   async execute(context) {

package/commands/rank/index.js

@@ -1,12 +1,12 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { defineCommand } from 'zhin.js/command';
-import { resolveGroupSuiteConfig } from "../../lib/config.js";
+import { groupSuiteConfigFor } from "../../lib/config.js";
 import { pointsRank } from "../../lib/checkin-lib.js";
 import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
 export default defineCommand({
     description: '查看积分排行榜', descriptionI18n: { en: "View the points leaderboard" },
     alias: ['checkin rank'],
-    execute({ config, input, owner, use, locale }) {
-        return pointsRank({ ...input, locale }, resolveGroupSuiteConfig(config), resolveGroupSuiteRuntime({ owner, use }));
+    execute({ config, input, owner, use, has, locale }) {
+        return pointsRank({ ...input, locale }, groupSuiteConfigFor({ config, has, use }, input), resolveGroupSuiteRuntime({ owner, use }));
     },
 });

package/commands/rank/index.ts

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

package/commands/stats/index.js

@@ -1,15 +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 { groupSuiteConfigFor } 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: '查看今日消息统计', descriptionI18n: { en: "View today's message statistics" },
-    execute({ config, input, owner, use, locale }) {
+    execute({ config, input, owner, use, has, 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 }));
+        return statsRankText({ ...input, locale }, groupSuiteConfigFor({ config, has, use }, input), todayStr(), title, resolveGroupSuiteRuntime({ owner, use }));
     },
 });

package/commands/stats/index.ts

@@ -1,19 +1,19 @@
 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';
+import { groupSuiteConfigFor, type GroupSuiteConfig } from '../../src/config.js';
 import { todayStr } from '../../src/shared-runtime.js';
 import { resolveGroupId, statsRankText } from '../../src/stats-lib.js';
 import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
   description: '查看今日消息统计', descriptionI18n: { en: "View today's message statistics" },
-  execute({ config, input, owner, use, locale }) {
+  execute({ config, input, owner, use, has, locale }) {
     const groupId = resolveGroupId({ ...input, locale });
     const title = groupId ? t(locale, 'statsTodayGroup') : t(locale, 'statsTodayAll');
     return statsRankText(
       { ...input, locale },
-      resolveGroupSuiteConfig(config),
+      groupSuiteConfigFor({ config, has, use }, input),
       todayStr(),
       title,
       resolveGroupSuiteRuntime({ owner, use }),

package/commands/stats-card/index.js

@@ -2,7 +2,7 @@
 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";
+import { groupSuiteConfigFor } from "../../lib/config.js";
 import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
 import { flushStatsBuffer, queryStats, resolveGroupId } from "../../lib/stats-lib.js";
 import { buildStatsRankReportData } from "../../lib/stats-data.js";
@@ -17,7 +17,7 @@ export default defineCommand({
         const runtime = resolveGroupSuiteRuntime(context);
         await flushStatsBuffer(runtime);
         const stats = await queryStats(resolveGroupId(context.input), todayStr(), runtime);
-        const data = buildStatsRankReportData(stats, t(context.locale, 'statsTodayGroup'), resolveGroupSuiteConfig(context.config).rankSize, resolveSender(context.input).id);
+        const data = buildStatsRankReportData(stats, t(context.locale, 'statsTodayGroup'), groupSuiteConfigFor(context, context.input).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

@@ -2,7 +2,7 @@ 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';
-import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../../src/config.js';
+import { groupSuiteConfigFor, type GroupSuiteConfig } from '../../src/config.js';
 import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
 import { flushStatsBuffer, queryStats, resolveGroupId } from '../../src/stats-lib.js';
 import { buildStatsRankReportData } from '../../src/stats-data.js';
@@ -18,7 +18,7 @@ export default defineCommand<GroupSuiteConfig, SendContent, Message>({
     await flushStatsBuffer(runtime);
     const stats = await queryStats(resolveGroupId(context.input), todayStr(), runtime);
     const data = buildStatsRankReportData(stats, t(context.locale, 'statsTodayGroup'),
-      resolveGroupSuiteConfig(context.config).rankSize, resolveSender(context.input).id);
+      groupSuiteConfigFor(context, context.input).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-rank/index.js

@@ -1,14 +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 { groupSuiteConfigFor } from "../../lib/config.js";
 import { monthStartStr, resolveGroupId, statsRankText } from "../../lib/stats-lib.js";
 import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
 export default defineCommand({
     description: '查看本月话唠排行', descriptionI18n: { en: "View this month's most active members" },
-    execute({ config, input, owner, use, locale }) {
+    execute({ config, input, owner, use, has, 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 }));
+        return statsRankText({ ...input, locale }, groupSuiteConfigFor({ config, has, use }, input), monthStartStr(), title, resolveGroupSuiteRuntime({ owner, use }));
     },
 });

package/commands/stats-rank/index.ts

@@ -1,18 +1,18 @@
 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';
+import { groupSuiteConfigFor, type GroupSuiteConfig } from '../../src/config.js';
 import { monthStartStr, resolveGroupId, statsRankText } from '../../src/stats-lib.js';
 import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
   description: '查看本月话唠排行', descriptionI18n: { en: "View this month's most active members" },
-  execute({ config, input, owner, use, locale }) {
+  execute({ config, input, owner, use, has, locale }) {
     const groupId = resolveGroupId({ ...input, locale });
     const title = groupId ? t(locale, 'statsMonthGroup') : t(locale, 'statsMonthAll');
     return statsRankText(
       { ...input, locale },
-      resolveGroupSuiteConfig(config),
+      groupSuiteConfigFor({ config, has, use }, input),
       monthStartStr(),
       title,
       resolveGroupSuiteRuntime({ owner, use }),

package/commands/stats-week/index.js

@@ -1,14 +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 { groupSuiteConfigFor } from "../../lib/config.js";
 import { resolveGroupId, statsRankText, weekStartStr } from "../../lib/stats-lib.js";
 import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
 export default defineCommand({
     description: '查看本周消息统计', descriptionI18n: { en: "View this week's message statistics" },
-    execute({ config, input, owner, use, locale }) {
+    execute({ config, input, owner, use, has, 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 }));
+        return statsRankText({ ...input, locale }, groupSuiteConfigFor({ config, has, use }, input), weekStartStr(), title, resolveGroupSuiteRuntime({ owner, use }));
     },
 });

package/commands/stats-week/index.ts

@@ -1,18 +1,18 @@
 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';
+import { groupSuiteConfigFor, type GroupSuiteConfig } from '../../src/config.js';
 import { resolveGroupId, statsRankText, weekStartStr } from '../../src/stats-lib.js';
 import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
   description: '查看本周消息统计', descriptionI18n: { en: "View this week's message statistics" },
-  execute({ config, input, owner, use, locale }) {
+  execute({ config, input, owner, use, has, locale }) {
     const groupId = resolveGroupId({ ...input, locale });
     const title = groupId ? t(locale, 'statsWeekGroup') : t(locale, 'statsWeekAll');
     return statsRankText(
       { ...input, locale },
-      resolveGroupSuiteConfig(config),
+      groupSuiteConfigFor({ config, has, use }, input),
       weekStartStr(),
       title,
       resolveGroupSuiteRuntime({ owner, use }),

package/commands/teach/index.js

@@ -1,12 +1,12 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { defineCommand } from 'zhin.js/command';
-import { resolveGroupSuiteConfig } from "../../lib/config.js";
+import { groupSuiteConfigFor } from "../../lib/config.js";
 import { teachAdd } from "../../lib/teach-lib.js";
 import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
 export default defineCommand({
-    permit: ['group()', 'role(owner,admin,master,trusted)'],
+    permit: ['group()', 'trusted'],
     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 }));
+    execute({ config, input, args, owner, use, has, locale }) {
+        return teachAdd({ ...input, locale }, groupSuiteConfigFor({ config, has, use }, input), args.join(' '), false, resolveGroupSuiteRuntime({ owner, use }));
     },
 });

package/commands/teach/index.ts

@@ -1,13 +1,13 @@
 import { defineCommand } from 'zhin.js/command';
 import type { Message } from '@zhin.js/core/runtime';
-import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../../src/config.js';
+import { groupSuiteConfigFor, type GroupSuiteConfig } from '../../src/config.js';
 import { teachAdd } from '../../src/teach-lib.js';
 import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
-  permit: ['group()', 'role(owner,admin,master,trusted)'],
+  permit: ['group()', 'trusted'],
   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 }));
+  execute({ config, input, args, owner, use, has, locale }) {
+    return teachAdd({ ...input, locale }, groupSuiteConfigFor({ config, has, use }, input), args.join(' '), false, resolveGroupSuiteRuntime({ owner, use }));
   },
 });

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

@@ -1,13 +1,13 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { defineCommand } from 'zhin.js/command';
-import { resolveGroupSuiteConfig } from "../../../lib/config.js";
+import { groupSuiteConfigFor } from "../../../lib/config.js";
 import { teachList } from "../../../lib/teach-lib.js";
 import { resolveGroupSuiteRuntime } from "../../../lib/runtime-state.js";
 export default defineCommand({
     description: '查看问答列表', descriptionI18n: { en: "List learned questions and answers" },
     params: { page: { type: 'number', default: 1 } },
-    execute({ config, input, params, owner, use, locale }) {
+    execute({ config, input, params, owner, use, has, locale }) {
         const page = Number(params.page ?? 1);
-        return teachList({ ...input, locale }, resolveGroupSuiteConfig(config), page, resolveGroupSuiteRuntime({ owner, use }));
+        return teachList({ ...input, locale }, groupSuiteConfigFor({ config, has, use }, input), page, resolveGroupSuiteRuntime({ owner, use }));
     },
 });

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

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

package/commands/teach-regex/index.js

@@ -1,12 +1,12 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { defineCommand } from 'zhin.js/command';
-import { resolveGroupSuiteConfig } from "../../lib/config.js";
+import { groupSuiteConfigFor } from "../../lib/config.js";
 import { teachAdd } from "../../lib/teach-lib.js";
 import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
 export default defineCommand({
-    permit: ['group()', 'role(owner,admin,master,trusted)'],
+    permit: ['group()', 'trusted'],
     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 }));
+    execute({ config, input, args, owner, use, has, locale }) {
+        return teachAdd({ ...input, locale }, groupSuiteConfigFor({ config, has, use }, input), args.join(' '), true, resolveGroupSuiteRuntime({ owner, use }));
     },
 });

package/commands/teach-regex/index.ts

@@ -1,13 +1,13 @@
 import { defineCommand } from 'zhin.js/command';
 import type { Message } from '@zhin.js/core/runtime';
-import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../../src/config.js';
+import { groupSuiteConfigFor, type GroupSuiteConfig } from '../../src/config.js';
 import { teachAdd } from '../../src/teach-lib.js';
 import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
-  permit: ['group()', 'role(owner,admin,master,trusted)'],
+  permit: ['group()', 'trusted'],
   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 }));
+  execute({ config, input, args, owner, use, has, locale }) {
+    return teachAdd({ ...input, locale }, groupSuiteConfigFor({ config, has, use }, input), args.join(' '), true, resolveGroupSuiteRuntime({ owner, use }));
   },
 });

package/handlers/welcome/index.js

@@ -2,13 +2,13 @@
 import { defineHandler } from 'zhin.js/handler';
 import { hasResource } from 'zhin.js';
 import { memberWelcomeOwnerToken, outboundMessageToken } from '@zhin.js/core/runtime';
-import { resolveGroupSuiteConfig } from "../../lib/config.js";
+import { groupSuiteConfigFor } from "../../lib/config.js";
 import { welcomeConversationAllowed } from "../../lib/welcome-scope.js";
 /** Canonical notice input only; no SDK-specific callbacks or direct platform sends. */
 export default defineHandler({
     event: 'notice.receive',
     async handle({ payload: notice }) {
-        const config = resolveGroupSuiteConfig(this.config);
+        const config = groupSuiteConfigFor(this, notice);
         const text = config.welcomeMessage;
         if (!text || notice.name !== 'notice.group.member_increase'
             || notice.conversation?.kind !== 'group' || !notice.target?.id)

package/handlers/welcome/index.ts

@@ -1,14 +1,14 @@
 import { defineHandler } from 'zhin.js/handler';
 import { hasResource } from 'zhin.js';
 import { memberWelcomeOwnerToken, outboundMessageToken } from '@zhin.js/core/runtime';
-import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../../src/config.js';
+import { groupSuiteConfigFor } from '../../src/config.js';
 import { welcomeConversationAllowed } from '../../src/welcome-scope.js';
 
 /** Canonical notice input only; no SDK-specific callbacks or direct platform sends. */
 export default defineHandler({
   event: 'notice.receive',
   async handle({ payload: notice }) {
-    const config = resolveGroupSuiteConfig(this.config as Partial<GroupSuiteConfig>);
+    const config = groupSuiteConfigFor(this as Parameters<typeof groupSuiteConfigFor>[0], notice);
     const text = config.welcomeMessage;
     if (!text || notice.name !== 'notice.group.member_increase'
       || notice.conversation?.kind !== 'group' || !notice.target?.id) return;

package/lib/config.d.ts

@@ -1,4 +1,4 @@
-import type { DeliveryTarget } from 'zhin.js';
+import { type DeliveryTarget } from 'zhin.js';
 export interface GroupSuiteConfig {
     keywordReply: boolean;
     /** Explicitly volatile keywords for demos without a persistent Database Host. */
@@ -19,4 +19,18 @@ export interface GroupSuiteConfig {
 }
 export declare const DEFAULT_GROUP_SUITE_CONFIG: GroupSuiteConfig;
 export declare function resolveGroupSuiteConfig(raw: Partial<GroupSuiteConfig> | undefined): GroupSuiteConfig;
+/** Effective configuration per message / notice (ADR 0050 / 0055): global < adapter < endpoint < conversation. */
+export interface GroupSuiteConfigResolver {
+    configFor(target: unknown): Readonly<Partial<GroupSuiteConfig>>;
+}
+export declare const groupSuiteConfigStore: import("zhin.js").PluginStore<GroupSuiteConfigResolver, unknown>;
+/**
+ * Settings for one capability call: the conversation's effective config when the resolver is
+ * provided (Plugin setup), else the global view. `target` is the message or notice being handled.
+ */
+export declare function groupSuiteConfigFor(context: {
+    readonly config?: Partial<GroupSuiteConfig>;
+    readonly has?: (token: typeof groupSuiteConfigStore) => boolean;
+    readonly use: (token: typeof groupSuiteConfigStore) => GroupSuiteConfigResolver;
+}, target: unknown): GroupSuiteConfig;
 //# sourceMappingURL=config.d.ts.map

package/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9C,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,iFAAiF;IACjF,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sFAAsF;IACtF,cAAc,EAAE,MAAM,CAAC;IACvB,wFAAwF;IACxF,oBAAoB,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,0BAA0B,EAAE,gBAaxC,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,SAAS,GACzC,gBAAgB,CAQlB"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAGjE,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,iFAAiF;IACjF,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sFAAsF;IACtF,cAAc,EAAE,MAAM,CAAC;IACvB,wFAAwF;IACxF,oBAAoB,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,0BAA0B,EAAE,gBAaxC,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,SAAS,GACzC,gBAAgB,CAQlB;AAED,kHAAkH;AAClH,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;CACjE;AACD,eAAO,MAAM,qBAAqB,kEACoD,CAAC;AAEvF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC5C,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,qBAAqB,KAAK,OAAO,CAAC;IAChE,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,OAAO,qBAAqB,KAAK,wBAAwB,CAAC;CACjF,EAAE,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAGpC"}

package/lib/config.js

@@ -1,3 +1,4 @@
+import { definePluginStore } from 'zhin.js';
 import { normalizeWelcomeConversations } from './welcome-scope.js';
 export const DEFAULT_GROUP_SUITE_CONFIG = {
     keywordReply: false,
@@ -10,7 +11,7 @@ export const DEFAULT_GROUP_SUITE_CONFIG = {
     rankSize: 10,
     teachMaxPerGroup: 200,
     teachCooldownMs: 3000,
-    teachAllowRegex: true,
+    teachAllowRegex: false,
     teachPageSize: 10,
 };
 export function resolveGroupSuiteConfig(raw) {
@@ -22,4 +23,13 @@ export function resolveGroupSuiteConfig(raw) {
         }),
     };
 }
+export const groupSuiteConfigStore = definePluginStore('zhin.group-suite.config', 'Layered group-suite configuration for one conversation');
+/**
+ * Settings for one capability call: the conversation's effective config when the resolver is
+ * provided (Plugin setup), else the global view. `target` is the message or notice being handled.
+ */
+export function groupSuiteConfigFor(context, target) {
+    const resolver = target !== undefined && context.has?.(groupSuiteConfigStore) ? context.use(groupSuiteConfigStore) : undefined;
+    return resolveGroupSuiteConfig({ ...(context.config ?? {}), ...(resolver?.configFor(target) ?? {}) });
+}
 //# sourceMappingURL=config.js.map

package/lib/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AAqBnE,MAAM,CAAC,MAAM,0BAA0B,GAAqB;IAC1D,YAAY,EAAE,KAAK;IACnB,iBAAiB,EAAE,KAAK;IACxB,cAAc,EAAE,EAAE;IAClB,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,EAAE;IACb,QAAQ,EAAE,EAAE;IACZ,gBAAgB,EAAE,GAAG;IACrB,eAAe,EAAE,IAAI;IACrB,eAAe,EAAE,IAAI;IACrB,aAAa,EAAE,EAAE;CAClB,CAAC;AAEF,MAAM,UAAU,uBAAuB,CACrC,GAA0C;IAE1C,OAAO;QACL,GAAG,0BAA0B;QAC7B,GAAG,GAAG;QACN,GAAG,CAAC,GAAG,EAAE,oBAAoB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACjD,oBAAoB,EAAE,6BAA6B,CAAC,GAAG,CAAC,oBAAoB,CAAC;SAC9E,CAAC;KACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAuB,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AAqBnE,MAAM,CAAC,MAAM,0BAA0B,GAAqB;IAC1D,YAAY,EAAE,KAAK;IACnB,iBAAiB,EAAE,KAAK;IACxB,cAAc,EAAE,EAAE;IAClB,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,EAAE;IACb,QAAQ,EAAE,EAAE;IACZ,gBAAgB,EAAE,GAAG;IACrB,eAAe,EAAE,IAAI;IACrB,eAAe,EAAE,KAAK;IACtB,aAAa,EAAE,EAAE;CAClB,CAAC;AAEF,MAAM,UAAU,uBAAuB,CACrC,GAA0C;IAE1C,OAAO;QACL,GAAG,0BAA0B;QAC7B,GAAG,GAAG;QACN,GAAG,CAAC,GAAG,EAAE,oBAAoB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACjD,oBAAoB,EAAE,6BAA6B,CAAC,GAAG,CAAC,oBAAoB,CAAC;SAC9E,CAAC;KACH,CAAC;AACJ,CAAC;AAMD,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,CACpD,yBAAyB,EAAE,wDAAwD,CAAC,CAAC;AAEvF;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAInC,EAAE,MAAe;IAChB,MAAM,QAAQ,GAAG,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/H,OAAO,uBAAuB,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;AACxG,CAAC"}

package/lib/teach-lib.d.ts

@@ -2,6 +2,18 @@ import type { ConversationInput } from './conversation-scope.js';
 import type { GroupSuiteConfig } from './config.js';
 import type { GroupSuiteRuntime } from './runtime-state.js';
 export declare const TEACH_USAGE_HINT = "\u683C\u5F0F\uFF1A\u5173\u952E\u8BCD \u56DE\u7B54\uFF0C\u6216 \u95EE\u9898|\u7B54\u6848";
+/** Regex rules are only tried against messages up to this length. */
+export declare const TEACH_REGEX_MAX_CONTENT = 200;
+/**
+ * Conservative structural check for user-taught patterns, which run against every inbound
+ * message. It refuses the shapes that backtrack super-linearly:
+ * - a repeated group whose body contains a quantifier or an alternation
+ *   (`(\w+\s?)+`, `(a|aa)+`, `(.*a){10}`);
+ * - backreferences and lookarounds;
+ * - more than a few repeat operators in one pattern (`.*.*.*.*x`).
+ * A character class (`[ab]+`) is the accepted way to repeat a set of alternatives.
+ */
+export declare function isSafeRegex(pattern: string): boolean;
 export declare function parseTeachPair(raw: string): {
     question: string;
     answer: string;

package/lib/teach-lib.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"teach-lib.d.ts","sourceRoot":"","sources":["../src/teach-lib.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAOpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,eAAO,MAAM,gBAAgB,4FAAsB,CAAC;AAapD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAevF;AAmCD,KAAK,YAAY,GAAG,iBAAiB,CAAC;AA8BtC,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,MAAM,EACf,KAAK,qBAAQ,EACb,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAqEjB;AAED,wBAAsB,SAAS,CAC7B,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,gBAAgB,EACrB,IAAI,oBAAI,EACR,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAED,wDAAwD;AACxD,wBAAsB,aAAa,CACjC,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6CxB"}
+{"version":3,"file":"teach-lib.d.ts","sourceRoot":"","sources":["../src/teach-lib.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAOpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,eAAO,MAAM,gBAAgB,4FAAsB,CAAC;AAEpD,qEAAqE;AACrE,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAI3C;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CA0CpD;AAsBD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAevF;AAmCD,KAAK,YAAY,GAAG,iBAAiB,CAAC;AA8BtC,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,MAAM,EACf,KAAK,qBAAQ,EACb,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAqEjB;AAED,wBAAsB,SAAS,CAC7B,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,gBAAgB,EACrB,IAAI,oBAAI,EACR,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAED,wDAAwD;AACxD,wBAAsB,aAAa,CACjC,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyCxB"}