@zhin.js/plugin-answers 0.0.0-stage → 0.0.2

package/lib/index.js

@@ -0,0 +1,9 @@
+export { BOOK_ANSWERS } from './book-data.js';
+export { BOOK_USAGE, MAX_QUESTION_LENGTH, calendarDay, normalizeQuestion, pickBookAnswer, replyBook } from './book.js';
+export { DEFAULT_ANSWERS_CONFIG, answersConfig, resolveAnswersConfig } from './config.js';
+export { DRIVING_QUESTIONS } from './driving-quiz-data.js';
+export { FUN_QUESTIONS } from './fun-quiz-data.js';
+export { MAX_PENDING_QUIZZES, QuizService, formatJudgement, formatQuestion, parseQuizLetter, pickQuestion, quizKey, } from './quiz.js';
+export { QUIZ_LETTERS } from './quiz-types.js';
+export { quizServiceToken } from './runtime.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,SAAS,EAAsB,MAAM,WAAW,CAAC;AAC3I,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,oBAAoB,EAAsB,MAAM,aAAa,CAAC;AAC9G,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,cAAc,EACd,eAAe,EACf,YAAY,EACZ,OAAO,GAKR,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAsC,MAAM,iBAAiB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/lib/quiz-types.d.ts

@@ -0,0 +1,14 @@
+export type QuizLetter = 'A' | 'B' | 'C' | 'D';
+export interface QuizQuestion {
+    /** 题库内唯一、稳定的题号，用于测试与去重。 */
+    readonly id: string;
+    readonly category: string;
+    readonly question: string;
+    /** 2–4 个选项，按 A/B/C/D 顺序排列，不含字母前缀。 */
+    readonly options: readonly string[];
+    readonly answer: QuizLetter;
+    /** 作答后展示的解析。 */
+    readonly explanation: string;
+}
+export declare const QUIZ_LETTERS: readonly QuizLetter[];
+//# sourceMappingURL=quiz-types.d.ts.map

package/lib/quiz-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quiz-types.d.ts","sourceRoot":"","sources":["../src/quiz-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,gBAAgB;IAChB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAAyB,CAAC"}

package/lib/quiz-types.js

@@ -0,0 +1,2 @@
+export const QUIZ_LETTERS = ['A', 'B', 'C', 'D'];
+//# sourceMappingURL=quiz-types.js.map

package/lib/quiz-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quiz-types.js","sourceRoot":"","sources":["../src/quiz-types.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,YAAY,GAA0B,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC"}

package/lib/quiz.d.ts

@@ -0,0 +1,52 @@
+import { type QuizLetter, type QuizQuestion } from './quiz-types.js';
+export type QuizKind = 'fun' | 'driving';
+/** Structural subset of the Runtime / Command message used to scope pending questions. */
+export interface QuizConversationInput {
+    readonly conversation?: {
+        readonly endpoint?: {
+            readonly id?: string;
+            readonly adapter?: string;
+        };
+        readonly kind?: string;
+        readonly id?: string;
+        readonly threadId?: string;
+    };
+    readonly sender?: {
+        readonly id?: string;
+    } | string;
+}
+export interface PendingQuiz {
+    readonly kind: QuizKind;
+    readonly question: QuizQuestion;
+    readonly expiresAt: number;
+}
+export interface QuizJudgement {
+    readonly correct: boolean;
+    readonly chosen: QuizLetter;
+    readonly pending: PendingQuiz;
+}
+/** Upper bound on simultaneously pending questions; the oldest one is dropped first. */
+export declare const MAX_PENDING_QUIZZES = 1000;
+/**
+ * 题目只按「同一会话 + 同一发送者」隔离：A 出的题不能由 B 回答，
+ * 同一用户在两个群里的题互不影响。返回 undefined 表示缺少可信身份，不出题。
+ */
+export declare function quizKey(input: QuizConversationInput | undefined): string | undefined;
+/** 只接受单个选项字母（大小写、全角均可），其余文本一律放行给后续中间件。 */
+export declare function parseQuizLetter(raw: string | undefined): QuizLetter | undefined;
+export declare function pickQuestion(bank: readonly QuizQuestion[], exceptId?: string): QuizQuestion;
+export declare function formatQuestion(kind: QuizKind, question: QuizQuestion, timeoutSeconds: number): string;
+export declare function formatJudgement(judgement: QuizJudgement): string;
+/** Generation-owned, in-memory only: pending questions vanish on reload, which is acceptable for a party game. */
+export declare class QuizService {
+    #private;
+    ask(key: string, kind: QuizKind, bank: readonly QuizQuestion[], timeoutSeconds: number, now?: number): QuizQuestion;
+    peek(key: string, now?: number): PendingQuiz | undefined;
+    /** Judge and consume the pending question; letters beyond the option count are ignored (undefined). */
+    answer(key: string, letter: QuizLetter, now?: number): QuizJudgement | undefined;
+    cancel(key: string): boolean;
+    sweep(now?: number): void;
+    get size(): number;
+    dispose(): void;
+}
+//# sourceMappingURL=quiz.d.ts.map

package/lib/quiz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quiz.d.ts","sourceRoot":"","sources":["../src/quiz.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEnF,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;AAEzC,0FAA0F;AAC1F,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE;QACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACxE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;CACrD;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC/B;AAED,wFAAwF;AACxF,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,qBAAqB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAMpF;AAED,0CAA0C;AAC1C,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAI/E;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,YAAY,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,CAO3F;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAMrG;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAMhE;AAED,kHAAkH;AAClH,qBAAa,WAAW;;IAKtB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,YAAY,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,YAAY;IAavH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,WAAW,GAAG,SAAS;IAU5D,uGAAuG;IACvG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,SAAa,GAAG,aAAa,GAAG,SAAS;IASpF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,KAAK,CAAC,GAAG,SAAa,GAAG,IAAI;IAI7B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,IAAI,IAAI;CAShB"}

package/lib/quiz.js

@@ -0,0 +1,111 @@
+import { randomInt } from 'node:crypto';
+import { QUIZ_LETTERS } from './quiz-types.js';
+/** Upper bound on simultaneously pending questions; the oldest one is dropped first. */
+export const MAX_PENDING_QUIZZES = 1000;
+/**
+ * 题目只按「同一会话 + 同一发送者」隔离：A 出的题不能由 B 回答，
+ * 同一用户在两个群里的题互不影响。返回 undefined 表示缺少可信身份，不出题。
+ */
+export function quizKey(input) {
+    const conversation = input?.conversation;
+    const sender = typeof input?.sender === 'string' ? input.sender : input?.sender?.id;
+    if (!conversation?.id || !conversation.kind || !sender)
+        return undefined;
+    return JSON.stringify(['answers-quiz-v1', conversation.endpoint?.adapter ?? null, conversation.endpoint?.id ?? null,
+        conversation.kind, conversation.id, conversation.threadId ?? null, sender]);
+}
+/** 只接受单个选项字母（大小写、全角均可），其余文本一律放行给后续中间件。 */
+export function parseQuizLetter(raw) {
+    const text = (raw ?? '').trim().replace(/[Ａ-Ｄａ-ｄ]/gu, (char) => String.fromCharCode(char.charCodeAt(0) - 0xfee0));
+    if (!/^[A-Da-d]$/u.test(text))
+        return undefined;
+    return text.toUpperCase();
+}
+export function pickQuestion(bank, exceptId) {
+    if (bank.length === 0)
+        throw new Error('题库为空');
+    if (bank.length === 1)
+        return bank[0];
+    let question = bank[randomInt(bank.length)];
+    // 避免同一人连续两次抽到同一道题。
+    if (question.id === exceptId)
+        question = bank[(bank.indexOf(question) + 1 + randomInt(bank.length - 1)) % bank.length];
+    return question;
+}
+export function formatQuestion(kind, question, timeoutSeconds) {
+    const head = kind === 'fun' ? '😴 好无聊？请听题！' : '🚗 科目一小测，请听题！';
+    const options = question.options.map((option, index) => `${QUIZ_LETTERS[index]}. ${option}`);
+    const letters = QUIZ_LETTERS.slice(0, question.options.length).join('/');
+    return [`${head}【${question.category}】`, '', question.question, '', ...options, '',
+        `直接回复 ${letters} 作答，${timeoutSeconds} 秒内有效。`].join('\n');
+}
+export function formatJudgement(judgement) {
+    const { question, kind } = judgement.pending;
+    const answerText = `${question.answer}. ${question.options[QUIZ_LETTERS.indexOf(question.answer)]}`;
+    const verdict = judgement.correct ? '✅ 答对了！' : `❌ 答错了，正确答案是 ${answerText}`;
+    const footer = kind === 'driving' ? '\n（原创题面，依据公开法规整理，仅供娱乐参考，以现行规定为准）' : '';
+    return `${verdict}\n💡 ${question.explanation}${footer}`;
+}
+/** Generation-owned, in-memory only: pending questions vanish on reload, which is acceptable for a party game. */
+export class QuizService {
+    #pending = new Map();
+    #lastQuestion = new Map();
+    #disposed = false;
+    ask(key, kind, bank, timeoutSeconds, now = Date.now()) {
+        this.#assertLive();
+        this.sweep(now);
+        const question = pickQuestion(bank, this.#lastQuestion.get(key));
+        this.#pending.delete(key);
+        this.#pending.set(key, { kind, question, expiresAt: now + timeoutSeconds * 1000 });
+        this.#lastQuestion.delete(key);
+        this.#lastQuestion.set(key, question.id);
+        while (this.#pending.size > MAX_PENDING_QUIZZES)
+            this.#pending.delete(this.#pending.keys().next().value);
+        while (this.#lastQuestion.size > MAX_PENDING_QUIZZES)
+            this.#lastQuestion.delete(this.#lastQuestion.keys().next().value);
+        return question;
+    }
+    peek(key, now = Date.now()) {
+        const pending = this.#pending.get(key);
+        if (!pending)
+            return undefined;
+        if (pending.expiresAt <= now) {
+            this.#pending.delete(key);
+            return undefined;
+        }
+        return pending;
+    }
+    /** Judge and consume the pending question; letters beyond the option count are ignored (undefined). */
+    answer(key, letter, now = Date.now()) {
+        if (this.#disposed)
+            return undefined;
+        const pending = this.peek(key, now);
+        if (!pending)
+            return undefined;
+        if (QUIZ_LETTERS.indexOf(letter) >= pending.question.options.length)
+            return undefined;
+        this.#pending.delete(key);
+        return { correct: letter === pending.question.answer, chosen: letter, pending };
+    }
+    cancel(key) {
+        return this.#pending.delete(key);
+    }
+    sweep(now = Date.now()) {
+        for (const [key, pending] of this.#pending)
+            if (pending.expiresAt <= now)
+                this.#pending.delete(key);
+    }
+    get size() {
+        return this.#pending.size;
+    }
+    dispose() {
+        this.#disposed = true;
+        this.#pending.clear();
+        this.#lastQuestion.clear();
+    }
+    #assertLive() {
+        if (this.#disposed)
+            throw new Error('答题服务属于已停止的插件实例');
+    }
+}
+//# sourceMappingURL=quiz.js.map

package/lib/quiz.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quiz.js","sourceRoot":"","sources":["../src/quiz.ts"],"names":[],"mappings":"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"}

package/lib/runtime.d.ts

@@ -0,0 +1,4 @@
+import type { QuizService } from './quiz.js';
+/** Owner-scoped quiz state consumed by discovered commands and middleware. */
+export declare const quizServiceToken: import("zhin.js").Token<QuizService>;
+//# sourceMappingURL=runtime.d.ts.map

package/lib/runtime.d.ts.map

@@ -0,0 +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,sCAAsG,CAAC"}

package/lib/runtime.js

@@ -0,0 +1,4 @@
+import { createToken } from 'zhin.js';
+/** Owner-scoped quiz state consumed by discovered commands and middleware. */
+export const quizServiceToken = createToken('zhin.answers.quiz', 'Pending quiz questions per conversation and sender');
+//# sourceMappingURL=runtime.js.map

package/lib/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAc,mBAAmB,EAAE,oDAAoD,CAAC,CAAC"}

package/middlewares/quiz-answer/index.js

@@ -0,0 +1,21 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineMiddleware } from 'zhin.js/middleware';
+import { formatJudgement, parseQuizLetter, quizKey } from "../../lib/quiz.js";
+import { quizServiceToken } from "../../lib/runtime.js";
+/**
+ * 只在「发送者本人在本会话有未过期题目」且消息恰好是一个选项字母时接管；
+ * 其他消息（包括别人回复的字母）全部交给后续中间件，避免劫持普通聊天。
+ */
+export default defineMiddleware({
+    target: 'inbound',
+    async handle(context, next) {
+        const letter = parseQuizLetter(context.input.content);
+        const key = letter ? quizKey(context.input) : undefined;
+        const judgement = letter && key ? context.use(quizServiceToken).answer(key, letter) : undefined;
+        if (!judgement) {
+            await next();
+            return;
+        }
+        await context.input.$reply(formatJudgement(judgement));
+    },
+});

package/middlewares/quiz-answer/index.ts

@@ -0,0 +1,22 @@
+import { defineMiddleware } from 'zhin.js/middleware';
+import type { Message } from '@zhin.js/core/runtime';
+import { formatJudgement, parseQuizLetter, quizKey } from '../../src/quiz.js';
+import { quizServiceToken } from '../../src/runtime.js';
+
+/**
+ * 只在「发送者本人在本会话有未过期题目」且消息恰好是一个选项字母时接管；
+ * 其他消息（包括别人回复的字母）全部交给后续中间件，避免劫持普通聊天。
+ */
+export default defineMiddleware<Message>({
+  target: 'inbound',
+  async handle(context, next) {
+    const letter = parseQuizLetter(context.input.content);
+    const key = letter ? quizKey(context.input) : undefined;
+    const judgement = letter && key ? context.use(quizServiceToken).answer(key, letter) : undefined;
+    if (!judgement) {
+      await next();
+      return;
+    }
+    await context.input.$reply(formatJudgement(judgement));
+  },
+});

package/package.json

@@ -1,6 +1,95 @@
 {
   "name": "@zhin.js/plugin-answers",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.2",
+  "description": "Zhin.js 答案之书、趣味选择题与交规小测（原创内容，Plugin Runtime）",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "plugin.js",
+    "schema.json",
+    "commands",
+    "middlewares",
+    "src",
+    "lib",
+    "README.md"
+  ],
+  "keywords": [
+    "zhin",
+    "zhin.js",
+    "bot",
+    "plugin",
+    "fun",
+    "quiz",
+    "answers"
+  ],
+  "author": {
+    "name": "lc-cn",
+    "email": "admin@liucl.cn",
+    "url": "https://github.com/lc-cn"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@zhin.js/core": "1.1.48"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10",
+    "zhin.js": "1.1.13"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zhinjs/zhin.git",
+    "directory": "plugins/utils/answers"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "zhin": {
+    "protocol": 1,
+    "type": "plugin",
+    "entry": "./plugin.js",
+    "engine": "^1.0.0",
+    "runtime": "trusted",
+    "features": [
+      {
+        "package": "@zhin.js/command",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/middleware",
+        "api": "^1.0.0"
+      }
+    ],
+    "plugins": []
+  },
+  "peerDependencies": {
+    "@zhin.js/command": "^1.1.9",
+    "@zhin.js/middleware": "^1.1.8",
+    "zhin.js": "^1.1.13"
+  },
+  "peerDependenciesMeta": {
+    "@zhin.js/command": {
+      "optional": true
+    },
+    "@zhin.js/middleware": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf lib",
+    "test": "NODE_OPTIONS=--experimental-strip-types vitest run --root ../../.. plugins/utils/answers/tests"
+  }
 }

package/plugin.js

@@ -0,0 +1,21 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { definePlugin } from 'zhin.js';
+import { QuizService } from "./lib/quiz.js";
+import { quizServiceToken } from "./lib/runtime.js";
+/**
+ * Plugin Runtime:
+ * - `commands/` 提供 答案之书 / 好无聊 / 科目一；
+ * - `middlewares/quiz-answer` 只接管「有待答题目的同一发送者」回复的单个选项字母；
+ * - 题目状态仅在内存中保存，随插件代际销毁。
+ */
+export default definePlugin({
+    name: 'answers',
+    metadata: {
+        displayName: '答案之书',
+    },
+    setup(context) {
+        const service = new QuizService();
+        context.resources.provide(quizServiceToken, service);
+        return () => service.dispose();
+    },
+});

package/schema.json

@@ -0,0 +1,41 @@
+{
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "dailyStable": {
+      "type": "boolean",
+      "description": "同一用户同一天问同一个问题时，答案之书给出相同答案",
+      "default": false,
+      "x-zhin-config": {
+        "effect": "reload"
+      }
+    },
+    "timezone": {
+      "type": "string",
+      "description": "dailyStable 判断「同一天」所用的 IANA 时区",
+      "default": "Asia/Shanghai",
+      "x-zhin-config": {
+        "effect": "reload"
+      }
+    },
+    "quizTimeoutSeconds": {
+      "type": "number",
+      "description": "出题后等待作答的秒数，超时题目作废",
+      "default": 120,
+      "minimum": 15,
+      "maximum": 600,
+      "multipleOf": 1,
+      "x-zhin-config": {
+        "effect": "reload"
+      }
+    },
+    "enableDrivingQuiz": {
+      "type": "boolean",
+      "description": "启用「科目一」交规小测（原创题面，仅供娱乐参考）",
+      "default": true,
+      "x-zhin-config": {
+        "effect": "reload"
+      }
+    }
+  }
+}

package/src/book-data.ts

@@ -0,0 +1,86 @@
+/**
+ * 答案之书的回答。全部为本仓库原创短句（MIT），不来自任何第三方题库或书籍。
+ * 措辞刻意保持含糊、积极或俏皮，避免给出医疗、法律、投资等具体建议。
+ */
+export const BOOK_ANSWERS: readonly string[] = Object.freeze([
+  '可以，但别急着今天就做完。',
+  '先睡一觉，明早再看，答案会更清楚。',
+  '是的，而且比你想的更顺利。',
+  '不是现在。',
+  '换个角度，问题就变小了。',
+  '去做吧，最坏也不过是多一个故事。',
+  '答案藏在你第一反应里。',
+  '再等一等，时机还没熟。',
+  '值得一试。',
+  '别勉强，放过自己也是一种选择。',
+  '问问最了解你的那个人。',
+  '这件事比你想的简单。',
+  '这件事比你想的复杂，慢慢来。',
+  '先把手头的小事做好。',
+  '会的。',
+  '大概率不会，但不妨碍你努力。',
+  '把它写下来，你就知道了。',
+  '你心里已经有答案了。',
+  '保持好奇，别急着下结论。',
+  '随缘，但别躺平。',
+  '先吃点好的再决定。',
+  '这一次，听从直觉。',
+  '这一次，相信数据。',
+  '请把期待值调低一点点。',
+  '请把期待值调高一点点。',
+  '机会就在下一个路口。',
+  '不必向所有人解释。',
+  '答案是肯定的，只是需要一点耐心。',
+  '答案是否定的，但下一扇门已经开了。',
+  '先迈出一小步。',
+  '别回头，往前看。',
+  '回头看看，你漏掉了什么。',
+  '换一种问法再问一次。',
+  '今天不适合做重大决定。',
+  '今天很适合开始。',
+  '交给时间。',
+  '少想，多做。',
+  '多想，少做。',
+  '你需要的是休息，不是答案。',
+  '和朋友聊聊，会有新思路。',
+  '小心细节。',
+  '别和自己较劲。',
+  '是时候做出改变了。',
+  '保持现状也很好。',
+  '你会为这个决定感到高兴。',
+  '先把预算算清楚。',
+  '相信过程。',
+  '未来的你会感谢现在的坚持。',
+  '答案会在不经意间出现。',
+  '这不是你一个人的问题。',
+  '放轻松，事情没那么糟。',
+  '大胆一点。',
+  '谨慎一点。',
+  '把选择权留给自己。',
+  '先问问钱包的意见。',
+  '去散个步，回来就懂了。',
+  '别被别人的节奏打乱。',
+  '耐心是这道题的解法。',
+  '是的，但要付出代价。',
+  '不，但你会学到东西。',
+  '它比看起来更重要。',
+  '它没有看起来那么重要。',
+  '答案在路上，请查收。',
+  '先喝杯水。',
+  '用你最擅长的方式去做。',
+  '试着去请教一个陌生人。',
+  '这是个好问题，值得认真对待。',
+  '这个问题，三天后再问。',
+  '不要让恐惧替你做决定。',
+  '不要让冲动替你做决定。',
+  '星星说：可以。',
+  '星星说：再想想。',
+  '一切都会好起来的。',
+  '你比你想象的更有能力。',
+  '慢慢来，比较快。',
+  '把注意力放在能控制的事情上。',
+  '先完成，再完美。',
+  '有时候，不做也是一种答案。',
+  '今天的运气站在你这边。',
+  '书页被风吹乱了，请稍后再问。',
+]);

package/src/book.ts

@@ -0,0 +1,48 @@
+import { createHash, randomInt } from 'node:crypto';
+import { BOOK_ANSWERS } from './book-data.js';
+
+export const BOOK_USAGE = [
+  '📖 答案之书',
+  '用法：答案之书 <问题>',
+  '例如：答案之书 今天要不要出去走走',
+  '心里默念问题后发送，书会翻开一页给你答案。',
+].join('\n');
+
+export const MAX_QUESTION_LENGTH = 200;
+
+export interface BookPickInput {
+  readonly question: string;
+  readonly senderId: string;
+  /** 为 true 时，同一用户同一天的同一问题得到相同答案。 */
+  readonly dailyStable: boolean;
+  readonly timezone: string;
+  readonly now?: number;
+}
+
+/** 规范化问题：去掉空白与常见标点，避免「？」和「?」得到不同答案。 */
+export function normalizeQuestion(question: string): string {
+  return question.trim().toLowerCase().replace(/[\s\p{P}]+/gu, '');
+}
+
+/** 给定时区下的日历日期（YYYY-MM-DD）；时区无效时退回 UTC。 */
+export function calendarDay(now: number, timezone: string): string {
+  try {
+    return new Intl.DateTimeFormat('en-CA', { timeZone: timezone, year: 'numeric', month: '2-digit', day: '2-digit' }).format(now);
+  } catch {
+    return new Date(now).toISOString().slice(0, 10);
+  }
+}
+
+export function pickBookAnswer(input: BookPickInput, answers: readonly string[] = BOOK_ANSWERS): string {
+  if (answers.length === 0) throw new Error('答案之书为空');
+  if (!input.dailyStable) return answers[randomInt(answers.length)]!;
+  const day = calendarDay(input.now ?? Date.now(), input.timezone);
+  const digest = createHash('sha256')
+    .update(JSON.stringify(['answers-book-v1', day, input.senderId, normalizeQuestion(input.question)]))
+    .digest();
+  return answers[digest.readUInt32BE(0) % answers.length]!;
+}
+
+export function replyBook(question: string, answer: string): string {
+  return `📖 你问：${question}\n✨ 答案之书：${answer}`;
+}

package/src/config.ts

@@ -0,0 +1,23 @@
+import { Schema } from 'zhin.js';
+
+export const DEFAULT_ANSWERS_CONFIG = Object.freeze({
+  dailyStable: false,
+  timezone: 'Asia/Shanghai',
+  quizTimeoutSeconds: 120,
+  enableDrivingQuiz: true,
+});
+
+/** Authoring declaration; scripts/sync-plugin-config-schemas.mjs generates the packaged schema.json for Runtime and Console. */
+export const answersConfig = Schema.object({
+  dailyStable: Schema.boolean().default(DEFAULT_ANSWERS_CONFIG.dailyStable).description('同一用户同一天问同一个问题时，答案之书给出相同答案').effect('reload'),
+  timezone: Schema.string().default(DEFAULT_ANSWERS_CONFIG.timezone).description('dailyStable 判断「同一天」所用的 IANA 时区').effect('reload'),
+  quizTimeoutSeconds: Schema.number().min(15).max(600).step(1).default(DEFAULT_ANSWERS_CONFIG.quizTimeoutSeconds).description('出题后等待作答的秒数，超时题目作废').effect('reload'),
+  enableDrivingQuiz: Schema.boolean().default(DEFAULT_ANSWERS_CONFIG.enableDrivingQuiz).description('启用「科目一」交规小测（原创题面，仅供娱乐参考）').effect('reload'),
+});
+
+export type AnswersConfig = Schema.Output<typeof answersConfig>;
+
+/** Missing fields fall back to defaults so commands stay usable when Runtime passes a partial view. */
+export function resolveAnswersConfig(config: Partial<AnswersConfig> | undefined): AnswersConfig {
+  return { ...DEFAULT_ANSWERS_CONFIG, ...(config ?? {}) } as AnswersConfig;
+}