@zhin.js/plugin-answers 0.0.14 → 0.0.15

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

@@ -53,10 +53,21 @@ import { pickBookAnswer, FUN_QUESTIONS, QuizService } from '@zhin.js/plugin-answ
 const answer = pickBookAnswer({ question: '今天出门吗', senderId: 'alice', dailyStable: true, timezone: 'Asia/Shanghai' });
 ```
 
+## 分层配置（ADR 0050 / 0055）
+
+支持全部四个层级：
+
+- 适配器、账号层可以覆盖所有字段（写在 `answers.overrides`）。
+- 会话层可以改 `dailyStable`、`quizTimeoutSeconds`、`enableDrivingQuiz`（`conversationFields`）；`timezone` 只到账号层。
+- 开启 `features.selfService.enabled` 后，群里的 `admin` 可以用 `功能 设置 answers quizTimeoutSeconds 60` 或 `功能 设置 answers enableDrivingQuiz false` 调整本群（`selfServiceFields`），用 `功能 关闭 answers` 关闭本群。
+- 命令按消息所在会话读取有效配置，改动原地生效，不重载插件。
+
 ## English
 
 Fun, platform-agnostic chat toys with **original** content: `答案之书 <question>` (book of answers, optional per-day stable answers), `好无聊` (multiple-choice trivia) and `科目一` (traffic-rule quiz written from the public PRC Road Traffic Safety Law and its implementing regulations; entertainment only). Only the asker can answer, by replying a single letter in the same conversation before the timeout.
 
+Layered configuration: all fields can be overridden per adapter / account; `dailyStable`, `quizTimeoutSeconds` and `enableDrivingQuiz` also per conversation. Group admins may change `quizTimeoutSeconds` and `enableDrivingQuiz` in chat (`feature set answers …`) once `features.selfService.enabled` is on.
+
 ## 许可
 
 MIT

package/commands//345/245/275/346/227/240/350/201/212/index.js

@@ -1,19 +1,19 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { messages } from "../../lib/messages.js";
 import { defineCommand } from 'zhin.js/command';
-import { resolveAnswersConfig } from "../../lib/config.js";
 import { FUN_QUESTIONS } from "../../lib/fun-quiz-data.js";
 import { formatQuestion, quizKey } from "../../lib/quiz.js";
-import { quizServiceToken } from "../../lib/runtime.js";
+import { answersSettingsFor, quizServiceToken } from "../../lib/runtime.js";
 export default defineCommand({
     preferredAliasI18n: { en: 'boring' },
     description: '好无聊？来一道原创趣味选择题，直接回复字母作答', descriptionI18n: { en: "Try an original trivia question; reply with an option letter" },
     alias: ['boring'],
-    execute({ input, use, config, locale }) {
+    execute(context) {
+        const { input, use, locale } = context;
         const key = quizKey(input);
         if (!key)
             return messages(locale, 'conversation');
-        const settings = resolveAnswersConfig(config);
+        const settings = answersSettingsFor(context);
         const question = use(quizServiceToken).ask({ key: key, kind: 'fun', bank: FUN_QUESTIONS, timeoutSeconds: settings.quizTimeoutSeconds, now: Date.now(), locale: locale });
         return formatQuestion('fun', question, settings.quizTimeoutSeconds, locale);
     },

package/commands//345/245/275/346/227/240/350/201/212/index.ts

@@ -1,18 +1,19 @@
 import { messages } from '../../src/messages.js';
 import { defineCommand } from 'zhin.js/command';
-import { resolveAnswersConfig, type AnswersConfig } from '../../src/config.js';
+import type { AnswersConfig } from '../../src/config.js';
 import { FUN_QUESTIONS } from '../../src/fun-quiz-data.js';
 import { formatQuestion, quizKey } from '../../src/quiz.js';
-import { quizServiceToken } from '../../src/runtime.js';
+import { answersSettingsFor, quizServiceToken } from '../../src/runtime.js';
 
 export default defineCommand<AnswersConfig>({
   preferredAliasI18n: { en: 'boring' },
   description: '好无聊？来一道原创趣味选择题，直接回复字母作答', descriptionI18n: { en: "Try an original trivia question; reply with an option letter" },
   alias: ['boring'],
-  execute({ input, use, config, locale }) {
+  execute(context) {
+    const { input, use, locale } = context;
     const key = quizKey(input);
     if (!key) return messages(locale, 'conversation');
-    const settings = resolveAnswersConfig(config);
+    const settings = answersSettingsFor(context);
     const question = use(quizServiceToken).ask({ key: key, kind: 'fun', bank: FUN_QUESTIONS, timeoutSeconds: settings.quizTimeoutSeconds, now: Date.now(), locale: locale });
     return formatQuestion('fun', question, settings.quizTimeoutSeconds, locale);
   },

package/commands//347/247/221/347/233/256/344/270/200/index.js

@@ -1,16 +1,16 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { messages } from "../../lib/messages.js";
 import { defineCommand } from 'zhin.js/command';
-import { resolveAnswersConfig } from "../../lib/config.js";
 import { DRIVING_QUESTIONS } from "../../lib/driving-quiz-data.js";
 import { formatQuestion, quizKey } from "../../lib/quiz.js";
-import { quizServiceToken } from "../../lib/runtime.js";
+import { answersSettingsFor, quizServiceToken } from "../../lib/runtime.js";
 export default defineCommand({
     alias: ['driving-quiz'],
     preferredAliasI18n: { en: 'driving-quiz' },
     description: '科目一交规小测（原创题面，依据公开法规整理，仅供娱乐参考）', descriptionI18n: { en: "Chinese driving theory quiz with original questions; for entertainment and reference only" },
-    execute({ input, use, config, locale }) {
-        const settings = resolveAnswersConfig(config);
+    execute(context) {
+        const { input, use, locale } = context;
+        const settings = answersSettingsFor(context);
         if (!settings.enableDrivingQuiz)
             return messages(locale, 'disabled');
         const key = quizKey(input);

package/commands//347/247/221/347/233/256/344/270/200/index.ts

@@ -1,16 +1,17 @@
 import { messages } from '../../src/messages.js';
 import { defineCommand } from 'zhin.js/command';
-import { resolveAnswersConfig, type AnswersConfig } from '../../src/config.js';
+import type { AnswersConfig } from '../../src/config.js';
 import { DRIVING_QUESTIONS } from '../../src/driving-quiz-data.js';
 import { formatQuestion, quizKey } from '../../src/quiz.js';
-import { quizServiceToken } from '../../src/runtime.js';
+import { answersSettingsFor, quizServiceToken } from '../../src/runtime.js';
 
 export default defineCommand<AnswersConfig>({
   alias: ['driving-quiz'],
   preferredAliasI18n: { en: 'driving-quiz' },
   description: '科目一交规小测（原创题面，依据公开法规整理，仅供娱乐参考）', descriptionI18n: { en: "Chinese driving theory quiz with original questions; for entertainment and reference only" },
-  execute({ input, use, config, locale }) {
-    const settings = resolveAnswersConfig(config);
+  execute(context) {
+    const { input, use, locale } = context;
+    const settings = answersSettingsFor(context);
     if (!settings.enableDrivingQuiz) return messages(locale, 'disabled');
     const key = quizKey(input);
     if (!key) return messages(locale, 'conversation');

package/commands//347/255/224/346/241/210/344/271/213/344/271/246/index.js

@@ -1,17 +1,18 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { defineCommand } from 'zhin.js/command';
 import { bookUsage, MAX_QUESTION_LENGTH, pickBookAnswer, replyBook } from "../../lib/book.js";
-import { resolveAnswersConfig } from "../../lib/config.js";
+import { answersSettingsFor } from "../../lib/runtime.js";
 export default defineCommand({
     preferredAliasI18n: { en: 'answerbook' },
     description: '答案之书：心里默念问题，翻开一页得到答案', descriptionI18n: { en: "Book of Answers: think of a question and turn a page" },
     alias: ['answerbook'],
     params: { question: { type: 'text', optional: true, max: MAX_QUESTION_LENGTH, description: '你想问的问题', descriptionI18n: { en: "Your question" } } },
-    execute({ params, input, config, locale, formatCommand }) {
+    execute(context) {
+        const { params, input, locale, formatCommand } = context;
         const question = typeof params.question === 'string' ? params.question.trim() : '';
         if (!question)
             return bookUsage(locale, formatCommand('答案之书'));
-        const settings = resolveAnswersConfig(config);
+        const settings = answersSettingsFor(context);
         const answer = pickBookAnswer({
             question,
             senderId: input?.sender?.id ?? 'anonymous',

package/commands//347/255/224/346/241/210/344/271/213/344/271/246/index.ts

@@ -1,16 +1,18 @@
 import { defineCommand } from 'zhin.js/command';
 import { bookUsage, MAX_QUESTION_LENGTH, pickBookAnswer, replyBook } from '../../src/book.js';
-import { resolveAnswersConfig, type AnswersConfig } from '../../src/config.js';
+import type { AnswersConfig } from '../../src/config.js';
+import { answersSettingsFor } from '../../src/runtime.js';
 
 export default defineCommand<AnswersConfig>({
   preferredAliasI18n: { en: 'answerbook' },
   description: '答案之书：心里默念问题，翻开一页得到答案', descriptionI18n: { en: "Book of Answers: think of a question and turn a page" },
   alias: ['answerbook'],
   params: { question: { type: 'text', optional: true, max: MAX_QUESTION_LENGTH, description: '你想问的问题', descriptionI18n: { en: "Your question" } } },
-  execute({ params, input, config, locale, formatCommand }) {
+  execute(context) {
+    const { params, input, locale, formatCommand } = context;
     const question = typeof params.question === 'string' ? params.question.trim() : '';
     if (!question) return bookUsage(locale, formatCommand('答案之书'));
-    const settings = resolveAnswersConfig(config);
+    const settings = answersSettingsFor(context);
     const answer = pickBookAnswer({
       question,
       senderId: input?.sender?.id ?? 'anonymous',

package/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,eAAO,MAAM,sBAAsB;;;;;EAKjC,CAAC;AAEH,gIAAgI;AAChI,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;CAKxB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC;AAEhE,uGAAuG;AACvG,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,SAAS,GAAG,aAAa,CAE9F"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,eAAO,MAAM,sBAAsB;;;;;EAKjC,CAAC;AAEH,gIAAgI;AAChI,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;CASxB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC;AAEhE,uGAAuG;AACvG,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,SAAS,GAAG,aAAa,CAE9F"}

package/lib/config.js

@@ -11,6 +11,10 @@ export const answersConfig = Schema.object({
     timezone: Schema.string().default(DEFAULT_ANSWERS_CONFIG.timezone).description('dailyStable 判断「同一天」所用的 IANA 时区').i18n({ "en": { "description": "IANA timezone used by dailyStable to determine the day." } }).effect('reload'),
     quizTimeoutSeconds: Schema.number().min(15).max(600).step(1).default(DEFAULT_ANSWERS_CONFIG.quizTimeoutSeconds).description('出题后等待作答的秒数，超时题目作废').i18n({ "en": { "description": "Seconds to wait for a quiz answer; the question expires afterward." } }).effect('reload'),
     enableDrivingQuiz: Schema.boolean().default(DEFAULT_ANSWERS_CONFIG.enableDrivingQuiz).description('启用「科目一」交规小测（原创题面，仅供娱乐参考）').i18n({ "en": { "description": "Enable the original driving-theory quiz, for entertainment and reference only." } }).effect('reload'),
+}).featureLevels(['global', 'adapter', 'endpoint', 'conversation'], {
+    // ADR 0055: quiz fields can differ per group in the Console (timezone per adapter / account only); group admins may tune the quiz in chat.
+    conversationFields: ['dailyStable', 'quizTimeoutSeconds', 'enableDrivingQuiz'],
+    selfServiceFields: ['quizTimeoutSeconds', 'enableDrivingQuiz'],
 });
 /** Missing fields fall back to defaults so commands stay usable when Runtime passes a partial view. */
 export function resolveAnswersConfig(config) {

package/lib/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,CAAC;IAClD,WAAW,EAAE,KAAK;IAClB,QAAQ,EAAE,eAAe;IACzB,kBAAkB,EAAE,GAAG;IACvB,iBAAiB,EAAE,IAAI;CACxB,CAAC,CAAC;AAEH,gIAAgI;AAChI,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,EAAC,aAAa,EAAE,qGAAqG,EAAC,EAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACxQ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,gCAAgC,CAAC,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,EAAC,aAAa,EAAE,yDAAyD,EAAC,EAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC1N,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,kBAAkB,CAAC,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,EAAC,aAAa,EAAE,oEAAoE,EAAC,EAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACrQ,iBAAiB,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,CAAC,WAAW,CAAC,0BAA0B,CAAC,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,EAAC,aAAa,EAAE,gFAAgF,EAAC,EAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;CAC/P,CAAC,CAAC;AAIH,uGAAuG;AACvG,MAAM,UAAU,oBAAoB,CAAC,MAA0C;IAC7E,OAAO,EAAE,GAAG,sBAAsB,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAmB,CAAC;AAC3E,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,CAAC;IAClD,WAAW,EAAE,KAAK;IAClB,QAAQ,EAAE,eAAe;IACzB,kBAAkB,EAAE,GAAG;IACvB,iBAAiB,EAAE,IAAI;CACxB,CAAC,CAAC;AAEH,gIAAgI;AAChI,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,EAAC,aAAa,EAAE,qGAAqG,EAAC,EAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACxQ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,gCAAgC,CAAC,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,EAAC,aAAa,EAAE,yDAAyD,EAAC,EAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC1N,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,kBAAkB,CAAC,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,EAAC,aAAa,EAAE,oEAAoE,EAAC,EAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACrQ,iBAAiB,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,CAAC,WAAW,CAAC,0BAA0B,CAAC,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,EAAC,aAAa,EAAE,gFAAgF,EAAC,EAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;CAC/P,CAAC,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,CAAC,EAAE;IAClE,2IAA2I;IAC3I,kBAAkB,EAAE,CAAC,aAAa,EAAE,oBAAoB,EAAE,mBAAmB,CAAC;IAC9E,iBAAiB,EAAE,CAAC,oBAAoB,EAAE,mBAAmB,CAAC;CAC/D,CAAC,CAAC;AAIH,uGAAuG;AACvG,MAAM,UAAU,oBAAoB,CAAC,MAA0C;IAC7E,OAAO,EAAE,GAAG,sBAAsB,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAmB,CAAC;AAC3E,CAAC"}

package/lib/runtime.d.ts

@@ -1,5 +1,18 @@
 import type { QuizService } from './quiz.js';
+import { type AnswersConfig } from './config.js';
 /** Owner-scoped quiz state consumed by discovered commands and middleware. */
 export declare const quizServiceStore: import("zhin.js").PluginStore<QuizService, unknown>;
 export declare const quizServiceToken: import("zhin.js").PluginStore<QuizService, unknown>;
+/** Effective configuration per message (ADR 0050 / 0055): global < adapter < endpoint < conversation. */
+export interface AnswersConfigResolver {
+    configFor(message: unknown): Readonly<Partial<AnswersConfig>>;
+}
+export declare const answersConfigStore: import("zhin.js").PluginStore<AnswersConfigResolver, unknown>;
+/** Settings for one command call: the conversation's effective config when the resolver is provided, else the global view. */
+export declare function answersSettingsFor(context: {
+    readonly config?: Partial<AnswersConfig>;
+    readonly input?: unknown;
+    readonly has?: (token: typeof answersConfigStore) => boolean;
+    readonly use: (token: typeof answersConfigStore) => AnswersConfigResolver;
+}): AnswersConfig;
 //# sourceMappingURL=runtime.d.ts.map

package/lib/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,qDAA4G,CAAC;AAC1I,eAAO,MAAM,gBAAgB,qDAAmB,CAAC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEvE,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,qDAA4G,CAAC;AAC1I,eAAO,MAAM,gBAAgB,qDAAmB,CAAC;AAEjD,yGAAyG;AACzG,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;CAC/D;AACD,eAAO,MAAM,kBAAkB,+DAAmH,CAAC;AAEnJ,8HAA8H;AAC9H,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,kBAAkB,KAAK,OAAO,CAAC;IAC7D,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,OAAO,kBAAkB,KAAK,qBAAqB,CAAC;CAC3E,GAAG,aAAa,CAGhB"}

package/lib/runtime.js

@@ -1,5 +1,12 @@
 import { definePluginStore } from 'zhin.js';
+import { resolveAnswersConfig } from './config.js';
 /** Owner-scoped quiz state consumed by discovered commands and middleware. */
 export const quizServiceStore = definePluginStore('zhin.answers.quiz', 'Pending quiz questions per conversation and sender');
 export const quizServiceToken = quizServiceStore;
+export const answersConfigStore = definePluginStore('zhin.answers.config', 'Layered answers configuration for one message');
+/** Settings for one command call: the conversation's effective config when the resolver is provided, else the global view. */
+export function answersSettingsFor(context) {
+    const resolver = context.input !== undefined && context.has?.(answersConfigStore) ? context.use(answersConfigStore) : undefined;
+    return resolveAnswersConfig({ ...(context.config ?? {}), ...(resolver?.configFor(context.input) ?? {}) });
+}
 //# sourceMappingURL=runtime.js.map

package/lib/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAG5C,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,iBAAiB,CAAc,mBAAmB,EAAE,oDAAoD,CAAC,CAAC;AAC1I,MAAM,CAAC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,EAAE,oBAAoB,EAAsB,MAAM,aAAa,CAAC;AAEvE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,iBAAiB,CAAc,mBAAmB,EAAE,oDAAoD,CAAC,CAAC;AAC1I,MAAM,CAAC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAMjD,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAwB,qBAAqB,EAAE,+CAA+C,CAAC,CAAC;AAEnJ,8HAA8H;AAC9H,MAAM,UAAU,kBAAkB,CAAC,OAKlC;IACC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChI,OAAO,oBAAoB,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;AAC5G,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/plugin-answers",
-  "version": "0.0.14",
+  "version": "0.0.15",
   "description": "Zhin.js 答案之书、趣味选择题与交规小测（原创内容，Plugin Runtime）",
   "type": "module",
   "main": "./lib/index.js",
@@ -37,12 +37,13 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@zhin.js/core": "1.1.60"
+    "@zhin.js/core": "1.2.0"
   },
   "devDependencies": {
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
-    "zhin.js": "1.1.25"
+    "@zhin.js/testing": "1.0.10",
+    "zhin.js": "1.1.26"
   },
   "repository": {
     "type": "git",
@@ -75,9 +76,9 @@
     "plugins": []
   },
   "peerDependencies": {
-    "@zhin.js/command": "^1.1.17",
-    "@zhin.js/middleware": "^1.1.16",
-    "zhin.js": "^1.1.25"
+    "@zhin.js/command": "^1.2.0",
+    "@zhin.js/middleware": "^1.1.17",
+    "zhin.js": "^1.1.26"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {
@@ -90,6 +91,6 @@
   "scripts": {
     "build": "tsc",
     "clean": "rimraf lib",
-    "test": "NODE_OPTIONS=--experimental-strip-types vitest run --root ../../.. plugins/utils/answers/tests"
+    "test": "vitest run --root ../../.. plugins/utils/answers/tests"
   }
 }

package/plugin.js

@@ -1,7 +1,7 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { definePlugin } from 'zhin.js';
 import { QuizService } from "./lib/quiz.js";
-import { quizServiceStore } from "./lib/runtime.js";
+import { answersConfigStore, quizServiceStore } from "./lib/runtime.js";
 /**
  * Plugin Runtime:
  * - `commands/` 提供 答案之书 / 好无聊 / 科目一；
@@ -15,5 +15,9 @@ export default definePlugin({
     },
     setup(context) {
         quizServiceStore.provide(context, new QuizService());
+        // ADR 0050 / 0055: quiz settings may differ per adapter / account / conversation (in place, no reload).
+        answersConfigStore.provide(context, {
+            configFor: message => context.configFor(message),
+        });
     },
 });

package/schema.json

@@ -57,5 +57,22 @@
         "effect": "reload"
       }
     }
+  },
+  "x-zhin-config": {
+    "levels": [
+      "global",
+      "adapter",
+      "endpoint",
+      "conversation"
+    ],
+    "conversationFields": [
+      "dailyStable",
+      "quizTimeoutSeconds",
+      "enableDrivingQuiz"
+    ],
+    "selfServiceFields": [
+      "quizTimeoutSeconds",
+      "enableDrivingQuiz"
+    ]
   }
 }

package/src/config.ts

@@ -13,6 +13,10 @@ export const answersConfig = Schema.object({
   timezone: Schema.string().default(DEFAULT_ANSWERS_CONFIG.timezone).description('dailyStable 判断「同一天」所用的 IANA 时区').i18n({"en": {"description": "IANA timezone used by dailyStable to determine the day."}}).effect('reload'),
   quizTimeoutSeconds: Schema.number().min(15).max(600).step(1).default(DEFAULT_ANSWERS_CONFIG.quizTimeoutSeconds).description('出题后等待作答的秒数，超时题目作废').i18n({"en": {"description": "Seconds to wait for a quiz answer; the question expires afterward."}}).effect('reload'),
   enableDrivingQuiz: Schema.boolean().default(DEFAULT_ANSWERS_CONFIG.enableDrivingQuiz).description('启用「科目一」交规小测（原创题面，仅供娱乐参考）').i18n({"en": {"description": "Enable the original driving-theory quiz, for entertainment and reference only."}}).effect('reload'),
+}).featureLevels(['global', 'adapter', 'endpoint', 'conversation'], {
+  // ADR 0055: quiz fields can differ per group in the Console (timezone per adapter / account only); group admins may tune the quiz in chat.
+  conversationFields: ['dailyStable', 'quizTimeoutSeconds', 'enableDrivingQuiz'],
+  selfServiceFields: ['quizTimeoutSeconds', 'enableDrivingQuiz'],
 });
 
 export type AnswersConfig = Schema.Output<typeof answersConfig>;

package/src/runtime.ts

@@ -1,6 +1,24 @@
 import { definePluginStore } from 'zhin.js';
 import type { QuizService } from './quiz.js';
+import { resolveAnswersConfig, type AnswersConfig } from './config.js';
 
 /** Owner-scoped quiz state consumed by discovered commands and middleware. */
 export const quizServiceStore = definePluginStore<QuizService>('zhin.answers.quiz', 'Pending quiz questions per conversation and sender');
 export const quizServiceToken = quizServiceStore;
+
+/** Effective configuration per message (ADR 0050 / 0055): global < adapter < endpoint < conversation. */
+export interface AnswersConfigResolver {
+  configFor(message: unknown): Readonly<Partial<AnswersConfig>>;
+}
+export const answersConfigStore = definePluginStore<AnswersConfigResolver>('zhin.answers.config', 'Layered answers configuration for one message');
+
+/** Settings for one command call: the conversation's effective config when the resolver is provided, else the global view. */
+export function answersSettingsFor(context: {
+  readonly config?: Partial<AnswersConfig>;
+  readonly input?: unknown;
+  readonly has?: (token: typeof answersConfigStore) => boolean;
+  readonly use: (token: typeof answersConfigStore) => AnswersConfigResolver;
+}): AnswersConfig {
+  const resolver = context.input !== undefined && context.has?.(answersConfigStore) ? context.use(answersConfigStore) : undefined;
+  return resolveAnswersConfig({ ...(context.config ?? {}), ...(resolver?.configFor(context.input) ?? {}) });
+}