kokkoro-plugin-hitokoto 2.0.0 → 3.0.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020-2023 Yuki
+Copyright (c) 2020 Yuki
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -0,0 +1,27 @@
+# kokkoro-plugin-hitokoto
+
+ヒトコト
+
+## 安装
+
+```shell
+bun add kokkoro-plugin-hitokoto
+```
+
+## 指令
+
+发送「/一言」，插件默认会从一言接口随机返回一条动画或漫画语句。
+
+## 快捷方式
+
+也可以发送「来点骚话」触发，群聊需要开启「获取群内全部消息」权限。
+
+## 环境变量
+
+如需修改语句类型，请在项目根目录创建 `.env` 文件，并通过 `HITOKOTO_TYPES` 设置一言接口的 `c` 参数。多个类型使用逗号分隔，默认值为 `a,b`。
+
+```ini
+HITOKOTO_TYPES=c,d
+```
+
+类型取值参阅[一言接口文档](https://developer.hitokoto.cn/sentence/#请求参数)。修改 `.env` 后需要重新启动项目。

package/package.json

@@ -1,23 +1,28 @@
 {
   "name": "kokkoro-plugin-hitokoto",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "description": "ヒトコト",
-  "type": "module",
-  "main": "lib/index.js",
-  "typings": "lib/index.d.ts",
   "keywords": [
     "bot",
     "kokkoro",
     "hitokoto",
     "qq"
   ],
-  "author": "Yuki <admin@yuki.sh>",
-  "license": "MIT",
-  "dependencies": {
-    "@kokkoro/core": "^3.0.1"
+  "bugs": "https://github.com/kokkorojs/kokkoro/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kokkorojs/kokkoro.git",
+    "directory": "plugins/hitokoto"
   },
-  "scripts": {
-    "build": "tsc && tsc-alias",
-    "build:watch": "tsc && (concurrently \"tsc -w\" \"tsc-alias -w\")"
+  "license": "MIT",
+  "author": "Yuki <admin@yuki.sh>",
+  "type": "module",
+  "exports": "./src/index.ts",
+  "files": [
+    "src"
+  ],
+  "peerDependencies": {
+    "@kokkoro/core": "^3.1.3",
+    "typescript": "^6.0.3"
   }
-}
+}

package/src/index.ts

@@ -1,42 +1,62 @@
-import { Metadata, useCommand } from '@kokkoro/core';
+import { useCommand } from '@kokkoro/core';
 
-interface Hitokoto {
-  // 一言标识
-  id: string;
-  // 一言正文 编码方式 unicode 使用 utf-8
-  hitokoto: string;
-  // 类型
-  type: string;
-  // 一言的出处
-  from: string;
-  // 一言的作者
-  from_who: string;
-  // 添加者
-  creator: string;
-  // 添加者用户标识
-  creator_uid: string;
-  // 审核员标识
-  reviewer: string;
-  // 一言唯一标识；可以链接到 https://hitokoto.cn?uuid=[uuid] (opens new window)查看这个一言的完整信息
-  uuid: string;
-  // 提交方式
-  commit_from: string;
-  // 添加时间
-  created_at: string;
-  // 句子长度
-  length: number;
+type SentenceType =
+  | 'a' // 动画
+  | 'b' // 漫画
+  | 'c' // 游戏
+  | 'd' // 文学
+  | 'e' // 原创
+  | 'f' // 来自网络
+  | 'g' // 其他
+  | 'h' // 影视
+  | 'i' // 诗词
+  | 'j' // 网易云
+  | 'k' // 哲学
+  | 'l'; // 抖机灵
+
+interface Sentence {
+  /** 一言标识 */
+  readonly id: number;
+  /** 一言正文。编码方式 unicode。使用 utf-8。 */
+  readonly hitokoto: string;
+  /** 类型。请参考第三节参数的表格 */
+  readonly type: SentenceType;
+  /** 一言的出处 */
+  readonly from: string;
+  /** 一言的作者 */
+  readonly from_who: string | null;
+  /** 添加者 */
+  readonly creator: string;
+  /** 添加者用户标识 */
+  readonly creator_uid: number;
+  /** 审核员标识 */
+  readonly reviewer: number;
+  /** 一言唯一标识，可以链接到 https://hitokoto.cn?uuid=[uuid] 查看这个一言的完整信息 */
+  readonly uuid: string;
+  /** 提交方式 */
+  readonly commit_from: string;
+  /** 添加时间 */
+  readonly created_at: string;
+  /** 句子长度 */
+  readonly length: number;
 }
-export const metadata: Metadata = {
-  name: 'hitokoto',
-  description: '一言语句',
-};
 
-export default function Hitokoto() {
-  useCommand('/来点骚话', async (_, bot) => {
-    const { data } = await bot.request.get<Hitokoto>('https://v1.hitokoto.cn?c=a&c=b');
-    const { hitokoto, from } = data;
-    const message = `『${hitokoto}』——「${from}」`;
+const { HITOKOTO_TYPES = 'a,b' } = import.meta.env;
+const HITOKOTO_API = new URL('https://v1.hitokoto.cn');
 
-    return message;
-  });
+for (const type of HITOKOTO_TYPES.split(',')) {
+  HITOKOTO_API.searchParams.append('c', type);
 }
+
+export default () => {
+  useCommand('/一言', async () => {
+    const response = await fetch(HITOKOTO_API);
+
+    if (!response.ok) {
+      throw new Error(`接口请求失败，状态码 ${response.status}`);
+    }
+    const { hitokoto, from } = <Sentence>await response.json();
+
+    return `『${hitokoto}』——「${from}」`;
+  }).shortcut('来点骚话');
+};

package/lib/index.js

@@ -1,13 +0,0 @@
-import { useCommand } from '@kokkoro/core';
-export const metadata = {
-    name: 'hitokoto',
-    description: '一言语句',
-};
-export default function Hitokoto() {
-    useCommand('/来点骚话', async (_, bot) => {
-        const { data } = await bot.request.get('https://v1.hitokoto.cn?c=a&c=b');
-        const { hitokoto, from } = data;
-        const message = `『${hitokoto}』——「${from}」`;
-        return message;
-    });
-}

package/tsconfig.json

@@ -1,13 +0,0 @@
-{
-  "extends": "../../tsconfig.base",
-  "compilerOptions": {
-    "rootDir": "src",
-    "baseUrl": ".",
-    "paths": {
-      "@/*": ["src/*"]
-    },
-    "outDir": "lib",
-    "declaration": false
-  },
-  "include": ["src"]
-}