@zhin.js/game-kit 2.0.1 → 2.0.2

package/lib/help-card.js

@@ -1,129 +0,0 @@
-import { Card, CardCanvas, CardHeader, DEFAULT_CARD_THEME, h, KvRow, Section, TopicItem, } from '@zhin.js/satori';
-import { slashCommandPrefix } from './game-commands.js';
-import { collectSupplementaryCommandHelp, formatHubOpenCommandLines, } from './command-help.js';
-export const HELP_CARD_CANVAS = DEFAULT_CARD_THEME.canvas;
-export const HELP_CARD_WIDTH = 560;
-function cardShell(inner) {
-    return h(CardCanvas, {
-        width: HELP_CARD_WIDTH,
-        backgroundColor: HELP_CARD_CANVAS,
-        children: h(Card, { children: inner }),
-    });
-}
-function gameTopicSummary(game) {
-    const quick = game.quickStart ?? '开始';
-    const cmd = `${slashCommandPrefix(game.commandPrefix.replace(/^\//, ''))} ${quick}`;
-    const alias = game.aliases?.length ? ` · ${game.aliases.join(' / ')}` : '';
-    return `${cmd}${alias} — ${game.description}`;
-}
-function commandTopicSummary(cmd) {
-    const [label = '', detail = ''] = cmd.helpInfo.desc;
-    return detail || label || cmd.pattern;
-}
-export function buildBotHelpHtml(input) {
-    const { games, commands, channelType } = input;
-    const hubLines = formatHubOpenCommandLines(commands);
-    const other = commands?.length
-        ? collectSupplementaryCommandHelp(commands, games)
-        : [];
-    const parts = [];
-    parts.push(h(CardHeader, {
-        title: '游戏大厅',
-        subtitle: games.length
-            ? `已注册 ${games.length} 款游戏 · 发送 /游戏 打开按钮大厅`
-            : '暂无已注册游戏',
-        badge: '🎮',
-    }));
-    if (hubLines.length) {
-        parts.push(h(Section, {
-            title: '入口',
-            children: hubLines.map((line) => {
-                const sep = line.indexOf(' — ');
-                const pattern = sep >= 0 ? line.slice(0, sep) : line;
-                const desc = sep >= 0 ? line.slice(sep + 3) : '';
-                return h(KvRow, { label: pattern, value: desc, labelWidth: 72 });
-            }),
-        }));
-    }
-    if (games.length) {
-        parts.push(h(Section, {
-            title: '游戏列表',
-            children: games.map((g, i) => h(TopicItem, {
-                index: i + 1,
-                title: `${g.icon} ${g.title}`,
-                summary: gameTopicSummary(g),
-            })),
-        }));
-    }
-    else {
-        parts.push(h(Section, {
-            title: '提示',
-            children: h(TopicItem, {
-                index: 1,
-                title: '安装任意游戏插件',
-                summary: 'registerGame 后会自动挂载大厅命令',
-            }),
-        }));
-    }
-    if (other.length) {
-        parts.push(h(Section, {
-            title: '其他命令',
-            children: other.map((cmd, i) => h(TopicItem, {
-                index: i + 1,
-                title: cmd.pattern,
-                summary: commandTopicSummary(cmd),
-            })),
-        }));
-    }
-    if (channelType === 'group') {
-        parts.push(h(Section, {
-            title: 'QQ 群用法',
-            children: [
-                h(TopicItem, {
-                    index: 1,
-                    title: '公域群需 @ 机器人',
-                    summary: '发送命令或直接点击消息按钮',
-                }),
-                h(TopicItem, {
-                    index: 2,
-                    title: '/游戏 打开大厅',
-                    summary: '同群成员均可点击按钮参与',
-                }),
-            ],
-        }));
-    }
-    return cardShell(parts.join(''));
-}
-export function buildHubHelpHtml(games, commands) {
-    const hubLines = formatHubOpenCommandLines(commands);
-    const parts = [
-        h(CardHeader, {
-            title: '游戏大厅帮助',
-            subtitle: games.length ? `${games.length} 款游戏可选` : '暂无游戏',
-            badge: '🎮',
-        }),
-    ];
-    if (hubLines.length) {
-        parts.push(h(Section, {
-            title: '入口',
-            children: hubLines.map((line) => {
-                const sep = line.indexOf(' — ');
-                const pattern = sep >= 0 ? line.slice(0, sep) : line;
-                const desc = sep >= 0 ? line.slice(sep + 3) : '';
-                return h(KvRow, { label: pattern, value: desc, labelWidth: 72 });
-            }),
-        }));
-    }
-    if (games.length) {
-        parts.push(h(Section, {
-            title: '游戏',
-            children: games.map((g, i) => h(TopicItem, {
-                index: i + 1,
-                title: `${g.icon} ${g.title}`,
-                summary: gameTopicSummary(g),
-            })),
-        }));
-    }
-    return cardShell(parts.join(''));
-}
-//# sourceMappingURL=help-card.js.map

package/lib/help-card.js.map

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

package/src/command-help.ts

@@ -1,117 +0,0 @@
-import type { Message, MessageCommand, Plugin } from '@zhin.js/core';
-import type { RegisteredGame } from './game-hub-feature.js';
-
-export interface CommandHelpSource {
-  pattern: string;
-  helpInfo: {
-    desc: string[];
-    usage?: string[];
-    examples?: string[];
-  };
-}
-
-export function commandToHelpSource(cmd: Pick<MessageCommand, 'pattern' | 'helpInfo'>): CommandHelpSource {
-  return { pattern: cmd.pattern, helpInfo: cmd.helpInfo };
-}
-
-/** 按 MessageCommand.permit 与当前消息上下文过滤（与 handle 一致） */
-export async function filterHelpCommands(
-  commands: readonly MessageCommand[],
-  message: Message,
-  plugin: Plugin,
-): Promise<CommandHelpSource[]> {
-  const out: CommandHelpSource[] = [];
-  for (const cmd of commands) {
-    if (await cmd.checkPermits(message, plugin)) {
-      out.push(commandToHelpSource(cmd));
-    }
-  }
-  return out;
-}
-
-function commandLeadingToken(pattern: string): string {
-  return pattern.split(/\s/)[0] ?? '';
-}
-
-function normalizeToken(token: string): string {
-  return token.replace(/^\//, '').toLowerCase();
-}
-
-/** 不在「其他命令」中重复展示的 pattern（大厅入口 / 帮助自身） */
-const HELP_EXCLUDE_EXACT = new Set([
-  '/帮助',
-  '/help',
-  '帮助',
-  '/游戏 帮助',
-  '/游戏',
-  '/game',
-  '游戏',
-  'game',
-]);
-
-function isHubListedGameCommand(pattern: string, games: readonly RegisteredGame[]): boolean {
-  const lead = normalizeToken(commandLeadingToken(pattern));
-  return games.some((g) => normalizeToken(g.commandPrefix) === lead);
-}
-
-function comparePatterns(a: string, b: string): number {
-  const leadDiff = commandLeadingToken(b).length - commandLeadingToken(a).length;
-  if (leadDiff !== 0) return leadDiff;
-  return b.length - a.length;
-}
-
-function formatPatternDisplay(pattern: string): string {
-  return `\`${pattern}\``;
-}
-
-function formatCommandHelpLine(cmd: CommandHelpSource): string {
-  const [label = '', detail = ''] = cmd.helpInfo.desc;
-  const display = formatPatternDisplay(cmd.pattern);
-  const summary = detail || label || cmd.pattern;
-  if (label && label !== commandLeadingToken(cmd.pattern) && !cmd.pattern.startsWith(label)) {
-    return `• ${display}（${label}）— ${summary}`;
-  }
-  return `• ${display} — ${summary}`;
-}
-
-/** 从 command 服务收集应在 /帮助 中展示的命令（去重、排除已在游戏大厅列出的项） */
-export function collectSupplementaryCommandHelp(
-  commands: readonly CommandHelpSource[],
-  games: readonly RegisteredGame[],
-): CommandHelpSource[] {
-  const seen = new Set<string>();
-  const out: CommandHelpSource[] = [];
-  for (const cmd of [...commands].sort((a, b) => comparePatterns(a.pattern, b.pattern))) {
-    if (HELP_EXCLUDE_EXACT.has(cmd.pattern)) continue;
-    if (isHubListedGameCommand(cmd.pattern, games)) continue;
-    if (seen.has(cmd.pattern)) continue;
-    seen.add(cmd.pattern);
-    out.push(cmd);
-  }
-  return out;
-}
-
-export function formatSupplementaryCommandsHelp(
-  commands: readonly CommandHelpSource[],
-  games: readonly RegisteredGame[],
-): string {
-  const items = collectSupplementaryCommandHelp(commands, games);
-  if (!items.length) return '';
-  const lines = items.map(formatCommandHelpLine);
-  return ['**其他命令**', '', ...lines].join('\n');
-}
-
-/** 大厅入口行：从已注册命令的 .desc() 生成 */
-export function formatHubOpenCommandLines(
-  commands: readonly CommandHelpSource[] | undefined,
-): string[] {
-  if (!commands?.length) return [];
-  const lines: string[] = [];
-  for (const pattern of ['/游戏', '/game'] as const) {
-    const cmd = commands.find((c) => c.pattern === pattern);
-    if (!cmd) continue;
-    const desc = cmd.helpInfo.desc[0] ?? cmd.helpInfo.desc[1] ?? '';
-    if (desc) lines.push(`${pattern} — ${desc}`);
-  }
-  return lines;
-}

package/src/game-commands.ts

@@ -1,4 +0,0 @@
-/** 展示用：`/猜拳` */
-export function slashCommandPrefix(name: string): string {
-  return name.startsWith('/') ? name : `/${name}`;
-}

package/src/game-hub-feature.ts

@@ -1,154 +0,0 @@
-import { Feature, getPlugin, type FeatureJSON, type Message, type Plugin, type PluginLike, type DatabaseFeature } from '@zhin.js/core';
-import { mountGameHubUi, markGameHubUiMounted } from './game-hub-mount.js';
-import { registerGameRecordModels, initGameRecordDatabase } from './game-records.js';
-
-export interface GameHubContext {
-  plugin: Plugin;
-  message: Message;
-}
-
-export interface GameMenuAction {
-  id: string;
-  label: string;
-  style?: 'primary' | 'danger' | 'secondary';
-  groupOnly?: boolean;
-  privateOnly?: boolean;
-}
-
-export interface RegisteredGame {
-  id: string;
-  title: string;
-  icon: string;
-  description: string;
-  commandPrefix: string;
-  quickStart?: string;
-  aliases?: string[];
-  menus: GameMenuAction[];
-  runAction: (actionId: string, ctx: GameHubContext) => Promise<string | undefined | void>;
-}
-
-export interface GameHubContextExtensions {
-  registerGame(game: RegisteredGame): () => void;
-}
-
-declare module '@zhin.js/core' {
-  namespace Plugin {
-    interface Extensions extends GameHubContextExtensions {}
-    interface Contexts {
-      game: GameHubFeature;
-    }
-  }
-}
-
-let activeFeature: GameHubFeature | null = null;
-
-function setActiveFeature(feature: GameHubFeature | null): void {
-  activeFeature = feature;
-}
-
-export class GameHubFeature extends Feature<RegisteredGame> {
-  readonly name = 'game' as const;
-  readonly icon = 'Gamepad2';
-  readonly desc = '游戏';
-
-  private readonly byId = new Map<string, RegisteredGame>();
-  private hubDisposers: (() => void)[] = [];
-
-  register(game: RegisteredGame, pluginName: string): () => void {
-    const prev = this.byId.get(game.id);
-    if (prev) {
-      this.remove(prev);
-    }
-    this.byId.set(game.id, game);
-    return this.add(game, pluginName);
-  }
-
-  getGame(id: string): RegisteredGame | undefined {
-    return this.byId.get(id);
-  }
-
-  override remove(item: RegisteredGame, pluginName?: string): boolean {
-    this.byId.delete(item.id);
-    return super.remove(item, pluginName);
-  }
-
-  toJSON(pluginName?: string): FeatureJSON {
-    const list = pluginName ? this.getByPlugin(pluginName) : [...this.items];
-    return {
-      name: this.name,
-      icon: this.icon,
-      desc: this.desc,
-      count: list.length,
-      items: list.map((g) => ({
-        name: g.id,
-        desc: g.title,
-        usage: `${g.commandPrefix} ${g.quickStart ?? '开始'}`,
-      })),
-    };
-  }
-
-  get extensions() {
-    return {
-      registerGame: (game: RegisteredGame) => {
-        const plugin = getPlugin();
-        ensureGameHubService(plugin);
-        const dispose = this.register(game, plugin.name);
-        plugin.recordFeatureContribution(this.name, game.id);
-        plugin.onDispose(dispose);
-        return dispose;
-      },
-    };
-  }
-
-  mounted(plugin: PluginLike): void {
-    setActiveFeature(this);
-    const root = plugin as Plugin;
-    const host = root.root ?? root;
-    registerGameRecordModels(host);
-    if (host.contextIsReady('database')) {
-      initGameRecordDatabase(host.inject('database') as DatabaseFeature);
-    } else {
-      host.useContext('database', (dbFeature: DatabaseFeature) => {
-        initGameRecordDatabase(dbFeature);
-      });
-    }
-    this.hubDisposers = mountGameHubUi(host);
-    markGameHubUiMounted();
-  }
-
-  dispose(): void {
-    for (const d of this.hubDisposers) d();
-    this.hubDisposers = [];
-    if (activeFeature === this) {
-      setActiveFeature(null);
-    }
-  }
-}
-
-/**
- * 在 root 上注册 `game` 服务（幂等）。游戏插件初始化时调用一次即可。
- */
-export function ensureGameHubService(plugin: Plugin): GameHubFeature {
-  const root = plugin.root;
-  if (root.contextIsReady('game')) {
-    return root.inject('game') as GameHubFeature;
-  }
-
-  const feature = new GameHubFeature();
-  root.provide(feature);
-  setActiveFeature(feature);
-
-  if (root.started && feature.mounted) {
-    feature.mounted(root);
-  }
-
-  return root.inject('game') as GameHubFeature;
-}
-
-export function getRegisteredGames(): readonly RegisteredGame[] {
-  return activeFeature?.items ?? [];
-}
-
-export function getRegisteredGame(id: string): RegisteredGame | undefined {
-  return activeFeature?.getGame(id);
-}

package/src/game-hub-flow.ts

@@ -1,114 +0,0 @@
-import type { Message, Plugin } from '@zhin.js/core';
-import { parseChoicePayload } from './choice-keyboard.js';
-import {
-  buildGameHubMenu,
-  buildMainHubMenu,
-  formatHubEmptyMessage,
-  HUB_PREFIX,
-  hubActionChoiceId,
-  hubGameChoiceId,
-  parseHubChoiceId,
-} from './game-hub-menu.js';
-import { getRegisteredGame, getRegisteredGames } from './game-hub-feature.js';
-import {
-  createHubScope,
-  getHubContext,
-  rememberHubMenu,
-  type HubMenuChoice,
-} from './game-hub-menu-context.js';
-
-function mainMenuChoices(): HubMenuChoice[] {
-  return getRegisteredGames().map((g) => ({
-    id: hubGameChoiceId(g.id),
-    label: `${g.icon} ${g.title}`,
-  }));
-}
-
-function gameMenuChoices(gameId: string, channelType: string): HubMenuChoice[] {
-  const game = getRegisteredGame(gameId);
-  if (!game) return [];
-  const isGroup = channelType !== 'private';
-  const menus = game.menus.filter((m) => {
-    if (m.groupOnly && !isGroup) return false;
-    if (m.privateOnly && isGroup) return false;
-    return true;
-  });
-  return [
-    ...menus.map((m) => ({
-      id: hubActionChoiceId(game.id, m.id),
-      label: m.label,
-    })),
-    { id: 'back', label: '↩️ 返回大厅' },
-  ];
-}
-
-export function openMainMenu(message: Message): ReturnType<typeof buildMainHubMenu> | string {
-  const games = getRegisteredGames();
-  if (!games.length) {
-    return formatHubEmptyMessage();
-  }
-  const scopeId = createHubScope(message);
-  const choices = mainMenuChoices();
-  rememberHubMenu(message, scopeId, choices);
-  return buildMainHubMenu(scopeId, games, message.$channel.type);
-}
-
-export async function handleHubChoice(
-  plugin: Plugin,
-  message: Message,
-  scopeId: string,
-  choiceId: string,
-): Promise<boolean> {
-  const ctx = getHubContext(scopeId);
-  if (!ctx) {
-    await message.$reply?.('菜单已过期，请重新发送「游戏」。');
-    return true;
-  }
-  const ch = `${message.$adapter}-${message.$endpoint}-${message.$channel.type}:${message.$channel.id}`;
-  if (ctx.channelKey !== ch) {
-    await message.$reply?.('请在本频道使用游戏大厅。');
-    return true;
-  }
-
-  const parsed = parseHubChoiceId(choiceId);
-  if (!parsed) return false;
-
-  // 大厅导航（选游戏 / 返回）：同频道任何人都可点；具体开局由 runAction 用当前点击者 message
-  if (parsed.kind === 'back') {
-    const games = getRegisteredGames();
-    const choices = mainMenuChoices();
-    rememberHubMenu(message, scopeId, choices);
-    await message.$reply?.(buildMainHubMenu(scopeId, games, message.$channel.type));
-    return true;
-  }
-
-  if (parsed.kind === 'game') {
-    const game = getRegisteredGame(parsed.gameId);
-    if (!game) {
-      await message.$reply?.('该游戏未安装。');
-      return true;
-    }
-    const choices = gameMenuChoices(parsed.gameId, message.$channel.type);
-    rememberHubMenu(message, scopeId, choices);
-    await message.$reply?.(
-      buildGameHubMenu(scopeId, game, message.$channel.type),
-    );
-    return true;
-  }
-
-  const game = getRegisteredGame(parsed.gameId);
-  if (!game) {
-    await message.$reply?.('该游戏未安装。');
-    return true;
-  }
-
-  const result = await game.runAction(parsed.actionId, { plugin, message });
-  if (typeof result === 'string') await message.$reply?.(result);
-  return true;
-}
-
-export function parseHubPayload(payload: string): { scopeId: string; choiceId: string } | null {
-  const parsed = parseChoicePayload(payload, HUB_PREFIX);
-  if (!parsed) return null;
-  return { scopeId: parsed.sessionId, choiceId: parsed.choiceId };
-}

package/src/game-hub-menu-context.ts

@@ -1,94 +0,0 @@
-import type { Message } from '@zhin.js/core';
-import { channelKey } from './board-sender.js';
-import { generateCompactId } from './random.js';
-
-export interface HubMenuContext {
-  channelKey: string;
-  /** 打开菜单的用户（仅记录，大厅导航不限制点击者） */
-  openerId: string;
-  message: Message;
-  expiresAt: number;
-}
-
-export interface HubMenuChoice {
-  id: string;
-  label: string;
-  disabled?: boolean;
-}
-
-export interface LastHubMenu {
-  scopeId: string;
-  choices: HubMenuChoice[];
-  expiresAt: number;
-}
-
-const TTL_MS = 60 * 60 * 1000;
-const contexts = new Map<string, HubMenuContext>();
-const lastMenus = new Map<string, LastHubMenu>();
-
-/** 大厅 fallback 按频道共享，任意成员可回复数字或点按钮 */
-function hubMenuKey(message: Message): string {
-  return channelKey(message);
-}
-
-export function createHubScope(message: Message): string {
-  const scopeId = generateCompactId('h');
-  contexts.set(scopeId, {
-    channelKey: channelKey(message),
-    openerId: message.$sender.id,
-    message,
-    expiresAt: Date.now() + TTL_MS,
-  });
-  pruneExpired();
-  return scopeId;
-}
-
-export function rememberHubMenu(
-  message: Message,
-  scopeId: string,
-  choices: HubMenuChoice[],
-): void {
-  lastMenus.set(hubMenuKey(message), {
-    scopeId,
-    choices,
-    expiresAt: Date.now() + TTL_MS,
-  });
-  pruneExpired();
-}
-
-export function getLastHubMenu(message: Message): LastHubMenu | null {
-  pruneExpired();
-  const key = hubMenuKey(message);
-  const last = lastMenus.get(key);
-  if (!last || last.expiresAt < Date.now()) {
-    lastMenus.delete(key);
-    return null;
-  }
-  return last;
-}
-
-export function getHubContext(scopeId: string): HubMenuContext | null {
-  pruneExpired();
-  const ctx = contexts.get(scopeId);
-  if (!ctx || ctx.expiresAt < Date.now()) {
-    contexts.delete(scopeId);
-    return null;
-  }
-  return ctx;
-}
-
-function pruneExpired(): void {
-  const now = Date.now();
-  for (const [id, ctx] of contexts) {
-    if (ctx.expiresAt < now) contexts.delete(id);
-  }
-  for (const [key, menu] of lastMenus) {
-    if (menu.expiresAt < now) lastMenus.delete(key);
-  }
-}
-
-/** 测试专用：清空菜单上下文 */
-export function resetHubMenuContextForTests(): void {
-  contexts.clear();
-  lastMenus.clear();
-}