@kotori-bot/kotori-plugin-core 1.5.0 → 1.5.1

package/lib/index.d.ts

@@ -1,3 +1,8 @@
-import { type Context } from 'kotori-bot';
+import { type Context, Tsu } from 'kotori-bot';
 export declare const lang: string[];
-export declare function main(ctx: Context): void;
+export declare const config: import("kotori-bot").ObjectParser<{
+    alias: import("kotori-bot").Parser<string | undefined>;
+    keywords: import("kotori-bot").Parser<string[]>;
+    content: import("kotori-bot").Parser<string | undefined>;
+}>;
+export declare function main(ctx: Context, cfg: Tsu.infer<typeof config>): void;

package/lib/index.js

@@ -1,11 +1,11 @@
 /**
 * @Package @kotori-bot/kotori-plugin-core
-* @Version 1.4.5
+* @Version 1.5.0
 * @Author Hotaru <me@hotaru.icu>
 * @Copyright 2024-2025 Hotaru. All rights reserved.
-* @License BAN-ZHINESE-USING
+* @License GPL-3.0
 * @Link https://github.com/kotorijs/kotori
-* @Date 2025/8/4 17:28:54
+* @Date 2026/2/14 15:08:34
 */
 "use strict";
 var __defProp = Object.defineProperty;
@@ -27,14 +27,30 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var index_exports = {};
 __export(index_exports, {
+  config: () => config,
   lang: () => lang,
   main: () => main
 });
 module.exports = __toCommonJS(index_exports);
 var import_kotori_bot = require("kotori-bot");
 const lang = [__dirname, "../locales"];
-function main(ctx) {
+const config = import_kotori_bot.Tsu.Object({
+  alias: import_kotori_bot.Tsu.String().optional().describe("Menu command alias"),
+  keywords: import_kotori_bot.Tsu.Array(import_kotori_bot.Tsu.String()).default(["\u83DC\u5355", "\u529F\u80FD"]).describe("Menu command shortcuts"),
+  content: import_kotori_bot.Tsu.String().optional().describe("Custom menu command content")
+});
+function main(ctx, cfg) {
   ctx.on("before_command", (data) => {
+    if (data.command.meta.options.some((val) => val.realname === "help" || val.name === "H")) return;
+    if ([" -ihelp", " -H", " -h"].some((val) => data.raw.includes(val))) {
+      data.cancel();
+      ctx.emit(
+        "on_message",
+        Object.assign(data.session, {
+          message: /* @__PURE__ */ kotoriHTs("text", null, `${data.session.api.adapter.config.commandPrefix}help ${data.command.meta.root}`)
+        })
+      );
+    }
     const quick = data.session.quick.bind(data.session);
     if (!(data.result instanceof import_kotori_bot.CommandError)) {
       const { scope, access } = data.command.meta;
@@ -73,6 +89,10 @@ function main(ctx) {
       default:
     }
   });
+  if (cfg.content) {
+    const cmd = ctx.command("menu - core.descr.menu").shortcut(cfg.keywords).action((_, session) => session.format(String(cfg.content), { at: session.userId }));
+    if (cfg.alias) cmd.alias(cfg.alias);
+  }
   ctx.on("command", ({ result, session }) => {
     if (!(result instanceof import_kotori_bot.CommandError)) return;
     const { value } = result;
@@ -124,15 +144,11 @@ function main(ctx) {
       default:
     }
   });
-  ctx.filter({
-    test: import_kotori_bot.FilterTestList.USER_ID,
-    operator: "==",
-    value: "114514"
-  }).command("core - core.descr.core").action((_, session) => {
-    const { config, baseDir, options } = session.api.adapter.ctx;
+  ctx.command("core - core.descr.core").action((_, session) => {
+    const { config: config2, baseDir, options } = session.api.adapter.ctx;
     const botsLength = Array.from(ctx[import_kotori_bot.Symbols.bot].values()).map((set) => Array.from(set.values()).length).reduce((a, b) => a + b, 0);
     return session.format("core.msg.core", {
-      lang: config.global.lang,
+      lang: config2.global.lang,
       root: baseDir.root,
       mode: options.mode,
       modules: ctx[import_kotori_bot.Symbols.modules] ? ctx[import_kotori_bot.Symbols.modules].size : 0,
@@ -144,10 +160,10 @@ function main(ctx) {
     });
   });
   ctx.command("bot - core.descr.bot").action((_, session) => {
-    const { identity, platform, selfId, config, status } = session.api.adapter;
+    const { identity, platform, selfId, config: config2, status } = session.api.adapter;
     return session.format("core.msg.bot", {
       identity,
-      lang: config.lang,
+      lang: config2.lang,
       platform,
       self_id: selfId,
       create_time: session.i18n.time(status.createTime),
@@ -161,9 +177,9 @@ function main(ctx) {
     (_, session) => session.format("core.msg.bots", {
       list: Array.from(ctx[import_kotori_bot.Symbols.bot].values()).map(
         (bots) => Array.from(bots.values()).map(
-          ({ adapter: { identity, platform, config, status } }) => session.format("core.msg.bots.list", {
+          ({ adapter: { identity, platform, config: config2, status } }) => session.format("core.msg.bots.list", {
             identity,
-            lang: config.lang,
+            lang: config2.lang,
             platform,
             status: status.value
           })
@@ -218,9 +234,66 @@ function main(ctx) {
     await session.quick("core.msg.restart");
     setTimeout(() => process.exit(233), 1);
   });
+  ctx.command("help [...command] - core.descr.help").action((data, session) => {
+    const args = data.args.join(" ");
+    const filterResult = [];
+    for (const command of ctx[import_kotori_bot.Symbols.command]) {
+      if (command.meta.hide) continue;
+      if (!command.meta.root.startsWith(args) && !command.meta.alias.some((alias) => alias.startsWith(args))) continue;
+      filterResult.push(command.meta);
+    }
+    if (filterResult.length === 0) return "core.msg.descr.fail";
+    let commands = "";
+    const short = filterResult.length === 1;
+    for (const cmd of filterResult) {
+      const alias = cmd.alias.length > 0 ? session.format("core.template.alias", {
+        content: cmd.alias.join(session.i18n.locale("core.template.alias.delimiter"))
+      }) : "";
+      let args2 = "";
+      let options = "";
+      const handle = (values) => {
+        for (const value of values) {
+          let defaultValue = "";
+          if ("rest" in value) {
+            const valueType = typeof value.default;
+            if (valueType === "string" || valueType === "number") {
+              defaultValue = session.format("core.template.default", { content: value.default });
+            } else if (valueType === "boolean") {
+              defaultValue = session.format("core.template.default", { content: value.default ? "true" : "false" });
+            }
+            args2 += session.format(`core.template.arg.${value.optional ? "optional" : "required"}`, {
+              name: value.rest ? `...${value.name}` : value.name,
+              type: value.type === "string" ? "" : session.format("core.template.arg.type", { content: value.type }),
+              default: defaultValue
+            });
+          }
+          if (!("realname" in value) || !("description" in value)) return;
+          options += session.format("core.template.option", {
+            name: value.name,
+            realname: value.realname,
+            type: value.type === "string" ? "" : session.format("core.template.arg.type", { content: value.type }),
+            description: value.description ? session.format("core.template.description", { content: session.i18n.locale(value.description) }) : ""
+          });
+        }
+      };
+      handle(cmd.args);
+      if (short) handle(cmd.options);
+      if (options) options = session.format("core.template.options", { content: options });
+      commands += session.format(`core.msg.descr.command${short ? "2" : ""}`, {
+        root: `${session.api.adapter.config.commandPrefix}${cmd.root}`,
+        args: args2,
+        description: cmd.description ? session.format("core.template.description", { content: session.i18n.locale(cmd.description) }) : "",
+        options,
+        help: cmd.help && short ? session.format("core.template.help", { content: session.i18n.locale(cmd.help) }) : "",
+        alias: short ? alias : ""
+      });
+    }
+    return short ? commands : session.format("core.msg.help", { content: commands });
+  });
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  config,
   lang,
   main
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kotori-bot/kotori-plugin-core",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "core plugin",
   "main": "lib/index.js",
   "keywords": [
@@ -17,7 +17,7 @@
   ],
   "author": "Hotaru <me@hotaru.icu>",
   "peerDependencies": {
-    "kotori-bot": "^1.7.1"
+    "kotori-bot": "^1.7.3"
   },
   "kotori": {
     "meta": {