hotcat-bot-qq 0.1.8 → 0.1.10

package/README.md

@@ -1,53 +1,54 @@
-# HotCat Bot
-
-基于 [node-napcat-ts](https://github.com/HkTeamX/node-napcat-ts) 的 TypeScript QQ 机器人框架。
-
-<p align="center">
-  <img src="logo.png" width="120" alt="HotCat Bot Logo">
-</p>
-
-## 安装
-
-```bash
-npm add hotcat-bot-qq
-# or
-pnpm add hotcat-bot-qq
-# or
-bun add hotcat-bot-qq
-```
-
-## 快速开始
-
-```ts
-import { BotClient } from './botClient'
-import { Message } from './message'
-
-const bot = new BotClient({
-    baseUrl: 'ws://localhost:8082/onebot/v11/ws/',
-    accessToken: 'your-access-token',
-})
-await bot.start()
-
-bot.event.message.onGroupMessage(async (bot, event) => {
-    await bot.api.sendGroupMessage(event.group_id,
-        Message.reply(event.message_id),
-        Message.text('pong!')
-    )
-})
-```
-
-## 特性
-
-- **类型安全** — 完整的 TypeScript 类型推导，封装 napcat 全部 API
-- **消息段构建** — `Message` 类支持文本、图片、表情、文件等所有消息类型
-- **事件系统** — `BotEvent` 按类别分组暴露 message/messageSent/request/notice 事件
-- **定时任务** — `BotScheduler` 支持 cron 表达式、固定间隔、指定时间
-- **插件系统** — 继承 `PluginBase` 即可开发插件，支持热重载、目录监听自动加载，`scan` + `watch` 零配置接入
-
-## 文档
-
-完整文档 → [框架开发文档](https://hotcat-bot-qq.docs.chcat1320.top)
-
-## 协议
-
-MIT © CHCAT1320
+# HotCat Bot
+
+基于 [node-napcat-ts](https://github.com/HkTeamX/node-napcat-ts) 的 TypeScript QQ 机器人框架。
+
+<p align="center">
+  <img src="logo.png" width="120" alt="HotCat Bot Logo">
+</p>
+
+## 安装
+
+```bash
+npm add hotcat-bot-qq
+# or
+pnpm add hotcat-bot-qq
+# or
+bun add hotcat-bot-qq
+```
+
+## 快速开始
+
+```ts
+import { BotClient } from './botClient'
+import { Message } from './message'
+
+const bot = new BotClient({
+    baseUrl: 'ws://localhost:8082/onebot/v11/ws/',
+    accessToken: 'your-access-token',
+})
+await bot.start()
+
+bot.event.message.onGroupMessage(async (bot, event) => {
+    await bot.api.sendGroupMessage(event.group_id,
+        Message.reply(event.message_id),
+        Message.text('pong!')
+    )
+})
+```
+
+## 特性
+
+- **类型安全** — 完整的 TypeScript 类型推导，封装 napcat 全部 API
+- **消息段构建** — `Message` 类支持文本、图片、表情、文件等所有消息类型
+- **事件系统** — `BotEvent` 按类别分组暴露 message/messageSent/request/notice 事件
+- **定时任务** — `BotScheduler` 支持 cron 表达式、固定间隔、指定时间
+- **插件系统** — 继承 `PluginBase` 即可开发插件，支持热重载、目录监听自动加载，`scan` + `watch` 零配置接入
+
+## 文档
+
+完整文档 → [框架开发文档](https://hotcat-bot-qq.docs.chcat1320.top)
+
+交流群638144340
+## 协议
+
+MIT © CHCAT1320

package/dist/botApi.js

@@ -1,5 +1,5 @@
 import { NCWebsocket } from 'node-napcat-ts';
-import { BotConsole } from './botConsole';
+import { BotConsole } from './botConsole.js';
 export class BotApi {
     get client() { return this._client; }
     set client(c) { this._client = c; }

package/dist/botClient.d.ts

@@ -35,4 +35,5 @@ export declare class BotClient {
      */
     start(): Promise<void>;
     private seedDefaultPlugin;
+    private syncPluginFiles;
 }

package/dist/botClient.js

@@ -1,9 +1,9 @@
-import { BotApi } from './botApi';
-import { BotConsole } from './botConsole';
-import { BotEvent } from './botEvent';
-import { BotScheduler } from './botScheduler';
-import { existsSync, mkdirSync, cpSync } from 'fs';
-import { join, dirname } from 'path';
+import { BotApi } from './botApi.js';
+import { BotConsole } from './botConsole.js';
+import { BotEvent } from './botEvent.js';
+import { BotScheduler } from './botScheduler.js';
+import { existsSync, mkdirSync, cpSync, readdirSync, readFileSync, statSync, lstatSync } from 'fs';
+import { join, dirname, relative } from 'path';
 import { fileURLToPath } from 'url';
 /**
  * Bot 客户端，封装连接、启动流程及 bot 自身信息。
@@ -65,7 +65,7 @@ export class BotClient {
      */
     async start() {
         await this.api.connect();
-        const { BotPluginSystem } = await import('./botPlugin');
+        const { BotPluginSystem } = await import('./botPlugin.js');
         this.plugin = new BotPluginSystem(this.api, this);
         this.api.napcat.on('meta_event.lifecycle.connect', () => {
             new BotConsole('system', 'napcat服务器连接成功').log();
@@ -84,15 +84,60 @@ export class BotClient {
         this.plugin.watch('./plugins');
     }
     seedDefaultPlugin() {
-        const dest = join(process.cwd(), 'plugins', 'hotCatPlugin');
-        if (existsSync(dest))
-            return;
         const selfDir = dirname(fileURLToPath(import.meta.url));
         const src = join(selfDir, '..', 'plugins', 'hotCatPlugin');
         if (!existsSync(src))
             return;
+        const dest = join(process.cwd(), 'plugins', 'hotCatPlugin');
         mkdirSync(join(process.cwd(), 'plugins'), { recursive: true });
-        cpSync(src, dest, { recursive: true });
-        new BotConsole('system', '默认插件 hotCatPlugin 已创建').log();
+        if (!existsSync(dest)) {
+            cpSync(src, dest, { recursive: true });
+            new BotConsole('system', '默认插件 hotCatPlugin 已创建').log();
+            return;
+        }
+        const updated = this.syncPluginFiles(src, dest);
+        if (updated.length > 0) {
+            new BotConsole('system', `默认插件 hotCatPlugin 已更新: ${updated.join(', ')}`).log();
+        }
+    }
+    syncPluginFiles(src, dest) {
+        const updated = [];
+        const walkDir = (dir) => {
+            const entries = readdirSync(dir);
+            const files = [];
+            for (const entry of entries) {
+                const full = join(dir, entry);
+                if (lstatSync(full).isDirectory()) {
+                    files.push(...walkDir(full));
+                }
+                else {
+                    files.push(full);
+                }
+            }
+            return files;
+        };
+        const srcFiles = walkDir(src);
+        for (const file of srcFiles) {
+            const rel = relative(src, file);
+            const target = join(dest, rel);
+            if (!existsSync(target)) {
+                mkdirSync(dirname(target), { recursive: true });
+                cpSync(file, target);
+                updated.push(rel);
+                continue;
+            }
+            if (statSync(file).size !== statSync(target).size) {
+                cpSync(file, target);
+                updated.push(rel);
+                continue;
+            }
+            const srcContent = readFileSync(file);
+            const destContent = readFileSync(target);
+            if (!srcContent.equals(destContent)) {
+                cpSync(file, target);
+                updated.push(rel);
+            }
+        }
+        return updated;
     }
 }

package/dist/botEvent.js

@@ -1,4 +1,4 @@
-import { BotConsole } from './botConsole';
+import { BotConsole } from './botConsole.js';
 /**
  * 接收到的事件处理（别人发的消息）。
  */

package/dist/botPlugin.js

@@ -1,6 +1,7 @@
-import { BotConsole } from './botConsole';
+import { BotConsole } from './botConsole.js';
 import * as fs from 'fs';
 import * as path from 'path';
+import { pathToFileURL } from 'url';
 /**
  * 插件管理器，通过 `bot.plugin.xxx()` 访问。
  *
@@ -150,7 +151,9 @@ export class BotPluginSystem {
             if (!indexPath)
                 continue;
             try {
-                const mod = await import(path.resolve(indexPath));
+                // Node 的 ESM 加载器不接受裸 Windows 绝对路径（ERR_UNSUPPORTED_ESM_URL_SCHEME），
+                // 必须转成 file:// URL；Bun 两者都接受。
+                const mod = await import(pathToFileURL(path.resolve(indexPath)).href);
                 const ctor = mod[name.charAt(0).toUpperCase() + name.slice(1) + 'Plugin'] || mod.default || Object.values(mod).find((v) => typeof v === 'function' && v.create);
                 if (!ctor || typeof ctor.create !== 'function') {
                     new BotConsole('error', `插件目录 "${name}" 未导出符合规范的插件类`).log();
@@ -236,7 +239,7 @@ export class BotPluginSystem {
         if (!indexPath)
             return;
         try {
-            const mod = await import(indexPath);
+            const mod = await import(pathToFileURL(path.resolve(indexPath)).href);
             const ctor = mod[name.charAt(0).toUpperCase() + name.slice(1) + 'Plugin'] || mod.default || Object.values(mod).find((v) => typeof v === 'function' && v.create);
             if (!ctor || typeof ctor.create !== 'function')
                 return;

package/dist/index.js

@@ -1,8 +1,8 @@
-export { BotClient } from './botClient';
-export { BotApi } from './botApi';
-export { BotEvent, MessageEvent, MessageSent, RequestEvent, NoticeEvent } from './botEvent';
-export { BotScheduler } from './botScheduler';
-export { BotPluginSystem } from './botPlugin';
-export { BotConsole, colors, parseCQ, formatMessage } from './botConsole';
-export { Message } from './message';
-export { PluginBase } from './plugin';
+export { BotClient } from './botClient.js';
+export { BotApi } from './botApi.js';
+export { BotEvent, MessageEvent, MessageSent, RequestEvent, NoticeEvent } from './botEvent.js';
+export { BotScheduler } from './botScheduler.js';
+export { BotPluginSystem } from './botPlugin.js';
+export { BotConsole, colors, parseCQ, formatMessage } from './botConsole.js';
+export { Message } from './message.js';
+export { PluginBase } from './plugin.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hotcat-bot-qq",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "基于 node-napcat-ts 的 TypeScript QQ 机器人框架",
   "type": "module",
   "main": "dist/index.js",
@@ -51,7 +51,7 @@
     "logo.png"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
+    "build": "tsc -p tsconfig.build.json && node scripts/fix-dist-extensions.mjs",
     "build:plugin": "tsc --outDir plugins/hotCatPlugin --rootDir plugins/hotCatPlugin --module ESNext --target ES2020 --moduleResolution bundler --declaration --skipLibCheck plugins/hotCatPlugin/index.ts",
     "prepublishOnly": "bun run build && bun run build:plugin",
     "docs:dev": "vitepress dev docs",

package/plugins/hotCatPlugin/index.js

@@ -14,7 +14,12 @@ export class HotCatPlugin extends PluginBase {
                 await this.api.sendGroupMessage(event.group_id, Message.reply(event.message_id), Message.text(`HotCat 信息\n` +
                     `版本：${this.meta.version}\n` +
                     `平台：${platform} ${arch}\n` +
-                    `运行时间：${uptime}`));
+                    `运行时间：${uptime}\n` +
+                    `Github: https://github.com/CHCAT1320/hotCat-bot-qq\n` +
+                    `开发文档: https://hotcat-bot-qq.docs.chcat1320.top\n` +
+                    `交流群: 638144340\n` +
+                    `管理员QQ: 1095216448\n` +
+                    `基于 MIT 许可发布 版权所有 © 2026 CHCAT1320`));
             }
         };
     }
@@ -45,7 +50,7 @@ export class HotCatPlugin extends PluginBase {
 }
 HotCatPlugin.meta = {
     name: 'hotCatPlugin',
-    version: '0.1.8',
+    version: '0.1.10',
     description: 'HotCat 默认插件（#hotCat 指令查询 bot 状态）',
     author: 'CHCAT1320',
 };

package/plugins/hotCatPlugin/index.ts

@@ -7,7 +7,7 @@ import * as os from 'os'
 export class HotCatPlugin extends PluginBase {
     static meta = {
         name: 'hotCatPlugin',
-        version: '0.1.8',
+        version: '0.1.10',
         description: 'HotCat 默认插件（#hotCat 指令查询 bot 状态）',
         author: 'CHCAT1320',
     }
@@ -41,7 +41,12 @@ export class HotCatPlugin extends PluginBase {
                     `HotCat 信息\n` +
                     `版本：${this.meta.version}\n` +
                     `平台：${platform} ${arch}\n` +
-                    `运行时间：${uptime}`
+                    `运行时间：${uptime}\n` + 
+                    `Github: https://github.com/CHCAT1320/hotCat-bot-qq\n` + 
+                    `开发文档: https://hotcat-bot-qq.docs.chcat1320.top\n` + 
+                    `交流群: 638144340\n` + 
+                    `管理员QQ: 1095216448\n` + 
+                    `基于 MIT 许可发布 版权所有 © 2026 CHCAT1320`
                 )
             )
         }