kokkoro-plugin-kfc 3.0.0 → 3.0.2

package/README.md

@@ -1,6 +1,6 @@
 # kokkoro-plugin-kfc
 
-vivo 50
+肯德基网络梗，随机获取一条疯狂星期四文案。
 
 ## 安装
 
@@ -10,8 +10,33 @@ bun add kokkoro-plugin-kfc
 
 ## 指令
 
+```text
+/疯狂星期四
+```
+
 发送「/疯狂星期四」，插件会随机返回一条疯狂星期四文案。
 
 ## 快捷方式
 
-消息中出现「周四」「星期四」「木曜日」「肯德基」「KFC」「V我50」「微我五十」「vivo50」或「Thursday」等常见说法时，也会触发插件。
+消息中包含以下任意一类关键词时，插件也会随机返回一条疯狂星期四文案。
+
+- 付款梗，例如「V我50」、「微我五十」或「vivo50」
+- 肯德基，例如「肯德基」或「KFC」
+- 星期四，例如「周四」、「星期四」、「木曜日」或「Thursday」
+
+北京时间每周四，消息中出现「麦当劳」、「金拱门」、「华莱士」、「汉堡王」、「德克士」或「塔斯汀」时，也会随机返回一条疯狂星期四文案。
+
+> [!WARNING]
+> 快捷方式会在整段消息中查找关键词，因此链接地址中包含 `v50` 或 `kfc` 时也可能触发插件。该问题将在后续版本中优化。
+
+群聊需要开启「获取群内全部消息」权限。
+
+## API
+
+其他插件可以从 `service` 入口导入 `fetchCrazyThursday()`。该函数返回疯狂星期四接口的完整响应：
+
+```typescript
+import { fetchCrazyThursday } from 'kokkoro-plugin-kfc/service';
+
+const result = await fetchCrazyThursday();
+```

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "kokkoro-plugin-kfc",
-  "version": "3.0.0",
-  "description": "vivo 50",
+  "version": "3.0.2",
+  "description": "肯德基网络梗，随机获取一条疯狂星期四文案。",
   "keywords": [
     "bot",
     "kokkoro",
@@ -17,12 +17,15 @@
   "license": "MIT",
   "author": "Yuki <admin@yuki.sh>",
   "type": "module",
-  "exports": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./service": "./src/service.ts"
+  },
   "files": [
     "src"
   ],
   "peerDependencies": {
-    "@kokkoro/core": "^3.1.3",
+    "@kokkoro/core": "^3.1.4",
     "typescript": "^6.0.3"
   }
 }

package/src/index.ts

@@ -1,25 +1,39 @@
-import { useCommand } from '@kokkoro/core';
+import { useCommand, useLogger } from '@kokkoro/core';
 
-interface CrazyThursday {
-  readonly success: boolean;
-  readonly message: string;
-  readonly text: string;
-}
+import { fetchCrazyThursday, KFC_API } from './service';
+
+const logger = useLogger();
+
+const PAYMENT = /(?:vivo|[v微]\s*(?:我|me)?)\s*(?:50|五十)/i;
+const KFC = /(?:肯德基|kfc)/i;
+const THURSDAY = /(?:周四|星期四|木曜日|thursday)/i;
+const BURGER_BRANDS = /(?:麦当劳|金拱门|华莱士|汉堡王|德克士|塔斯汀)/i;
+
+const KEYWORDS = [PAYMENT, KFC, THURSDAY];
+const SHORTCUT = new RegExp([...KEYWORDS, BURGER_BRANDS].map(pattern => pattern.source).join('|'), 'i');
+const WEEKDAY_FORMAT = new Intl.DateTimeFormat('en-US', {
+  timeZone: 'Asia/Shanghai',
+  weekday: 'long',
+});
 
-const KFC_API = new URL('https://kfc.yuki.sh');
+function shouldTrigger(content: string) {
+  if (KEYWORDS.some(pattern => pattern.test(content))) {
+    return true;
+  }
+  return WEEKDAY_FORMAT.format(new Date()) === 'Thursday' && BURGER_BRANDS.test(content);
+}
 
 export default () => {
-  useCommand('/疯狂星期四', async () => {
-    const response = await fetch(KFC_API);
+  useCommand('/疯狂星期四', async context => {
+    if (shouldTrigger(context.content)) {
+      logger.debug('发送疯狂星期四请求', { method: 'GET', url: KFC_API });
 
-    if (!response.ok) {
-      throw new Error(`接口请求失败，状态码 ${response.status}`);
-    }
-    const { success, message, text } = <CrazyThursday>await response.json();
+      const result = await fetchCrazyThursday();
 
-    return success ? text : message;
-  })
-    .shortcut(/(?:vivo|[v微]\s*(?:我|me)?)\s*(?:50|五十)/i)
-    .shortcut(/(?:肯德基|kfc)/i)
-    .shortcut(/(?:周四|星期四|木曜日|thursday)/i);
+      logger.debug('收到疯狂星期四响应', result);
+      logger.info('已获取疯狂星期四文案');
+
+      return result.success ? result.text : result.message;
+    }
+  }).shortcut(SHORTCUT);
 };

package/src/service.ts

@@ -0,0 +1,17 @@
+export interface CrazyThursday {
+  readonly success: boolean;
+  readonly message: string;
+  readonly text: string;
+}
+
+export const KFC_API = 'https://kfc.yuki.sh';
+
+/** 请求随机的疯狂星期四文案，并返回完整的接口响应。 */
+export async function fetchCrazyThursday(): Promise<CrazyThursday> {
+  const response = await fetch(KFC_API);
+
+  if (!response.ok) {
+    throw new Error(`接口请求失败，状态码 ${response.status}`);
+  }
+  return <CrazyThursday>await response.json();
+}