@zhin.js/adapter-kook 3.0.0 → 4.0.0

package/lib/types.d.ts

@@ -17,6 +17,9 @@ export interface KookSenderInfo {
     roles?: number[];
     isGuildOwner?: boolean;
     isAdmin?: boolean;
+    /** 归一化平台身份（供 platform checker） */
+    role?: string;
+    permissions?: string[];
 }
 export interface KookTypingIndicatorConfig {
     enabled?: boolean;
@@ -35,7 +38,7 @@ export interface KookTypingIndicatorConfig {
         message?: string;
     };
 }
-export interface KookBotConfig {
+export interface KookEndpointConfig {
     context: "kook";
     name: string;
     token: string;

package/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEzB,oBAAY,cAAc;IACxB,MAAM,IAAI;IACV,KAAK,IAAI;IACT,KAAK,IAAI;IACT,YAAY,IAAI;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE;QACd,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;QAClD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,6CAA6C;IAC7C,WAAW,CAAC,EAAE;QACZ,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;QAClD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,kCAAkC;IAClC,eAAe,CAAC,EAAE,yBAAyB,CAAC;CAC7C;AAED,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG,mBAAmB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEzB,oBAAY,cAAc;IACxB,MAAM,IAAI;IACV,KAAK,IAAI;IACT,KAAK,IAAI;IACT,YAAY,IAAI;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE;QACd,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;QAClD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,6CAA6C;IAC7C,WAAW,CAAC,EAAE;QACZ,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;QAClD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,kCAAkC;IAClC,eAAe,CAAC,EAAE,yBAAyB,CAAC;CAC7C;AAED,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-kook",
-  "version": "3.0.0",
+  "version": "4.0.0",
   "description": "Zhin.js adapter for KOOK (开黑啦)",
   "type": "module",
   "main": "./lib/index.js",
@@ -40,18 +40,21 @@
     "@types/react-dom": "^19.2.3",
     "lucide-react": "^1.17.0",
     "typescript": "^6.0.3",
-    "@zhin.js/cli": "1.0.88",
-    "@zhin.js/host-api": "1.0.0",
+    "@zhin.js/cli": "1.0.89",
+    "@zhin.js/client": "2.0.3",
     "@zhin.js/contract": "1.0.1",
-    "zhin.js": "2.0.0"
+    "@zhin.js/host-api": "2.0.0",
+    "@zhin.js/host-router": "2.0.0",
+    "@zhin.js/logger": "0.1.71",
+    "zhin.js": "3.0.0"
   },
   "peerDependencies": {
-    "@zhin.js/client": "2.0.2",
-    "@zhin.js/host-api": "1.0.0",
+    "@zhin.js/client": "2.0.3",
+    "@zhin.js/host-api": "2.0.0",
     "@zhin.js/contract": "1.0.1",
-    "@zhin.js/host-router": "1.0.0",
-    "@zhin.js/logger": "0.1.70",
-    "zhin.js": "2.0.0"
+    "@zhin.js/host-router": "2.0.0",
+    "@zhin.js/logger": "0.1.71",
+    "zhin.js": "3.0.0"
   },
   "peerDependenciesMeta": {
     "@zhin.js/client": {

package/skills/kook/PERMITS.md

@@ -0,0 +1,23 @@
+# KOOK Platform Permits
+
+## 入站字段
+
+| 字段 | 来源 | 取值 |
+|------|------|------|
+| `$sender.role` | `permission` / `isAdmin` / `isGuildOwner` | `owner` · `admin` · `channel_admin` · `member` |
+| `$sender.permissions` | 归一化 + `roles[]` | `guild_owner` · `guild_admin` · `channel_admin` · `manage_roles` · `role:{id}` |
+
+KOOK `permission`：1=成员，2=管理员，4=频道主，5=频道管理员（子频道场景为 `channel_admin`）。
+
+## Permit 词汇表
+
+| `platform(kook,…)` | 含义 |
+|--------------------|------|
+| `guild_owner` | 服务器主 |
+| `guild_admin` | 服务器/频道管理员 |
+| `channel_admin` | 子频道管理员 |
+| `manage_roles` | 可管理身份组 |
+
+## 工厂映射
+
+`group_admin` → `guild_admin` · `group_owner` → `guild_owner`

package/src/adapter.ts

@@ -2,48 +2,50 @@
  * KOOK 适配器
  */
 import { formatCompact, Adapter, Plugin } from 'zhin.js';
-import { KookBot } from "./bot.js";
-import type { KookBotConfig } from "./types.js";
+import { KookEndpoint } from "./endpoint.js";
+import type { KookEndpointConfig } from "./types.js";
+
+export class KookAdapter extends Adapter<KookEndpoint> {
+  static override readonly capabilities = ['inbound', 'outbound'] as const;
 
-export class KookAdapter extends Adapter<KookBot> {
   constructor(plugin: Plugin) {
     super(plugin, "kook", []);
   }
 
-  createBot(config: KookBotConfig): KookBot {
-    return new KookBot(this, config);
+  createEndpoint(config: KookEndpointConfig): KookEndpoint {
+    return new KookEndpoint(this, config);
   }
 
   // ── IGroupManagement 标准群管方法 ──────────────────────────────────
 
-  async kickMember(botId: string, sceneId: string, userId: string) {
-    const bot = this.bots.get(botId);
-    if (!bot) throw new Error(`Bot ${botId} 不存在`);
-    return bot.kickUser(sceneId, userId);
+  async kickMember(endpointId: string, sceneId: string, userId: string) {
+    const endpoint = this.endpoints.get(endpointId);
+    if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
+    return endpoint.kickUser(sceneId, userId);
   }
 
-  async banMember(botId: string, sceneId: string, userId: string, reason?: string) {
-    const bot = this.bots.get(botId);
-    if (!bot) throw new Error(`Bot ${botId} 不存在`);
-    return bot.addToBlacklist(sceneId, userId, reason);
+  async banMember(endpointId: string, sceneId: string, userId: string, reason?: string) {
+    const endpoint = this.endpoints.get(endpointId);
+    if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
+    return endpoint.addToBlacklist(sceneId, userId, reason);
   }
 
-  async unbanMember(botId: string, sceneId: string, userId: string) {
-    const bot = this.bots.get(botId);
-    if (!bot) throw new Error(`Bot ${botId} 不存在`);
-    return bot.removeFromBlacklist(sceneId, userId);
+  async unbanMember(endpointId: string, sceneId: string, userId: string) {
+    const endpoint = this.endpoints.get(endpointId);
+    if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
+    return endpoint.removeFromBlacklist(sceneId, userId);
   }
 
-  async setMemberNickname(botId: string, sceneId: string, userId: string, nickname: string) {
-    const bot = this.bots.get(botId);
-    if (!bot) throw new Error(`Bot ${botId} 不存在`);
-    return bot.setNickname(sceneId, userId, nickname);
+  async setMemberNickname(endpointId: string, sceneId: string, userId: string, nickname: string) {
+    const endpoint = this.endpoints.get(endpointId);
+    if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
+    return endpoint.setNickname(sceneId, userId, nickname);
   }
 
-  async listMembers(botId: string, sceneId: string) {
-    const bot = this.bots.get(botId);
-    if (!bot) throw new Error(`Bot ${botId} 不存在`);
-    const members = await bot.getGuildMembers(sceneId);
+  async listMembers(endpointId: string, sceneId: string) {
+    const endpoint = this.endpoints.get(endpointId);
+    if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
+    const members = await endpoint.getGuildMembers(sceneId);
     return {
       members: members.map(m => ({
         id: m.id, username: m.username,

package/src/{bot.ts → endpoint.ts}

@@ -1,5 +1,5 @@
 /**
- * KOOK Bot 实现
+ * KOOK Endpoint 实现
  */
 import {
   Client,
@@ -14,7 +14,7 @@ import {
 import { EventEmitter } from "node:events";
 import path from "path";
 import {
-  Bot,
+  Endpoint,
   Message,
   SendOptions,
   SendContent,
@@ -22,10 +22,11 @@ import {
   segment,
   MessageType,
 } from "zhin.js";
-import type { KookBotConfig, KookSenderInfo, KookRawMessage } from "./types.js";
+import type { KookEndpointConfig, KookSenderInfo, KookRawMessage } from "./types.js";
 import { KookPermission } from "./types.js";
 import type { KookAdapter } from "./adapter.js";
 import { InboundMessageDeduper } from "./kook-inbound.js";
+import { normalizeKookSenderForPermit } from "./platform-permit.js";
 import {
   enrichKookGatewayForPlugins,
   formatKookNotice,
@@ -55,9 +56,9 @@ import { materializeOutboundMedia } from "./outbound-media.js";
 import { uploadKookAsset } from "./kook-asset-upload.js";
 import { convertToKookSendable } from "./outbound-sendable.js";
 
-export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage> {
+export class KookEndpoint extends Client implements Endpoint<KookEndpointConfig, KookRawMessage> {
   $connected: boolean = false;
-  /** KOOK 平台 user_id，用于 @ 触发匹配（resolveBotAtIds） */
+  /** KOOK 平台 user_id，用于 @ 触发匹配（resolveEndpointAtIds） */
   $platformUserId?: string;
   adapter: KookAdapter;
   private readonly inboundDeduper = new InboundMessageDeduper();
@@ -73,7 +74,7 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
     return this.adapter.plugin.logger;
   }
 
-  constructor(adapter: KookAdapter, public $config: KookBotConfig) {
+  constructor(adapter: KookAdapter, public $config: KookEndpointConfig) {
     super({
       token: $config.token,
       mode: "websocket", // KOOK 默认使用 WebSocket 模式
@@ -119,7 +120,6 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
     payload: unknown,
   ): void {
     this.adapter.emit(event, payload as never);
-    void this.adapter.plugin.dispatch(event, payload as never);
   }
 
   /**
@@ -160,18 +160,18 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
     // 监听连接事件
     this.on("connect" as any, () => {
       this.$connected = true;
-      this.pluginLogger.info(`KOOK Bot ${this.$id} 已连接`);
+      this.pluginLogger.info(`KOOK Endpoint ${this.$id} 已连接`);
     });
 
     // 监听断开事件
     this.on("disconnect" as any, () => {
       this.$connected = false;
-      this.pluginLogger.warn(`KOOK Bot ${this.$id} 已断开`);
+      this.pluginLogger.warn(`KOOK Endpoint ${this.$id} 已断开`);
     });
 
     // 监听错误事件
     this.on("error" as any, (error: Error) => {
-      this.pluginLogger.error(`KOOK Bot ${this.$id} 错误:`, error);
+      this.pluginLogger.error(`KOOK Endpoint ${this.$id} 错误:`, error);
     });
   }
 
@@ -202,7 +202,7 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
     const message: Message<KookRawMessage> = Message.from(msg, {
       $id: msg.message_id.toString(),
       $adapter: "kook" as const,
-      $bot: this.$id,
+      $endpoint: this.$id,
       
       $sender: senderInfo,
       
@@ -243,7 +243,7 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
         return await this.adapter.sendMessage({
           ...message.$channel,
           context: "kook",
-          bot: this.$id,
+          endpoint: this.$id,
           content: finalContent,
         });
       },
@@ -297,6 +297,9 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
       }
     }
 
+    const normalized = normalizeKookSenderForPermit(senderInfo, msg.message_type === "channel");
+    senderInfo.role = normalized.role;
+    senderInfo.permissions = normalized.permissions;
     return senderInfo;
   }
 
@@ -311,10 +314,10 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
     try {
       const guild = this.pickGuild(guildId);
       const result = await guild.kick(userId);
-      this.pluginLogger.info(`KOOK Bot ${this.$id} 踢出用户 ${userId} 从服务器 ${guildId}`);
+      this.pluginLogger.info(`KOOK Endpoint ${this.$id} 踢出用户 ${userId} 从服务器 ${guildId}`);
       return result;
     } catch (error) {
-      this.pluginLogger.error(`KOOK Bot ${this.$id} 踢出用户失败:`, error);
+      this.pluginLogger.error(`KOOK Endpoint ${this.$id} 踢出用户失败:`, error);
       throw error;
     }
   }
@@ -330,10 +333,10 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
     try {
       const member = this.pickGuildMember(guildId, userId);
       const result = await member.addToBlackList(remark, delMsgDays);
-      this.pluginLogger.info(`KOOK Bot ${this.$id} 将用户 ${userId} 加入黑名单（服务器 ${guildId}）`);
+      this.pluginLogger.info(`KOOK Endpoint ${this.$id} 将用户 ${userId} 加入黑名单（服务器 ${guildId}）`);
       return result;
     } catch (error) {
-      this.pluginLogger.error(`KOOK Bot ${this.$id} 加入黑名单失败:`, error);
+      this.pluginLogger.error(`KOOK Endpoint ${this.$id} 加入黑名单失败:`, error);
       throw error;
     }
   }
@@ -347,10 +350,10 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
     try {
       const member = this.pickGuildMember(guildId, userId);
       const result = await member.removeFromBlackList();
-      this.pluginLogger.info(`KOOK Bot ${this.$id} 将用户 ${userId} 从黑名单移除（服务器 ${guildId}）`);
+      this.pluginLogger.info(`KOOK Endpoint ${this.$id} 将用户 ${userId} 从黑名单移除（服务器 ${guildId}）`);
       return result;
     } catch (error) {
-      this.pluginLogger.error(`KOOK Bot ${this.$id} 移除黑名单失败:`, error);
+      this.pluginLogger.error(`KOOK Endpoint ${this.$id} 移除黑名单失败:`, error);
       throw error;
     }
   }
@@ -365,10 +368,10 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
     try {
       const member = this.pickGuildMember(guildId, userId);
       const result = await member.grant(roleId);
-      this.pluginLogger.info(`KOOK Bot ${this.$id} 授予用户 ${userId} 角色 ${roleId}（服务器 ${guildId}）`);
+      this.pluginLogger.info(`KOOK Endpoint ${this.$id} 授予用户 ${userId} 角色 ${roleId}（服务器 ${guildId}）`);
       return result;
     } catch (error) {
-      this.pluginLogger.error(`KOOK Bot ${this.$id} 授予角色失败:`, error);
+      this.pluginLogger.error(`KOOK Endpoint ${this.$id} 授予角色失败:`, error);
       throw error;
     }
   }
@@ -383,10 +386,10 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
     try {
       const member = this.pickGuildMember(guildId, userId);
       const result = await member.revoke(roleId);
-      this.pluginLogger.info(`KOOK Bot ${this.$id} 撤销用户 ${userId} 角色 ${roleId}（服务器 ${guildId}）`);
+      this.pluginLogger.info(`KOOK Endpoint ${this.$id} 撤销用户 ${userId} 角色 ${roleId}（服务器 ${guildId}）`);
       return result;
     } catch (error) {
-      this.pluginLogger.error(`KOOK Bot ${this.$id} 撤销角色失败:`, error);
+      this.pluginLogger.error(`KOOK Endpoint ${this.$id} 撤销角色失败:`, error);
       throw error;
     }
   }
@@ -401,10 +404,10 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
     try {
       const member = this.pickGuildMember(guildId, userId);
       const result = await member.setNickname(nickname);
-      this.pluginLogger.info(`KOOK Bot ${this.$id} 设置用户 ${userId} 昵称为 "${nickname}"（服务器 ${guildId}）`);
+      this.pluginLogger.info(`KOOK Endpoint ${this.$id} 设置用户 ${userId} 昵称为 "${nickname}"（服务器 ${guildId}）`);
       return result;
     } catch (error) {
-      this.pluginLogger.error(`KOOK Bot ${this.$id} 设置昵称失败:`, error);
+      this.pluginLogger.error(`KOOK Endpoint ${this.$id} 设置昵称失败:`, error);
       throw error;
     }
   }
@@ -418,7 +421,7 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
       const guild = this.pickGuild(guildId);
       return await guild.getRoleList();
     } catch (error) {
-      this.pluginLogger.error(`KOOK Bot ${this.$id} 获取角色列表失败:`, error);
+      this.pluginLogger.error(`KOOK Endpoint ${this.$id} 获取角色列表失败:`, error);
       throw error;
     }
   }
@@ -432,10 +435,10 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
     try {
       const guild = this.pickGuild(guildId);
       const role = await guild.createRole(name);
-      this.pluginLogger.info(`KOOK Bot ${this.$id} 创建角色 "${name}"（服务器 ${guildId}）`);
+      this.pluginLogger.info(`KOOK Endpoint ${this.$id} 创建角色 "${name}"（服务器 ${guildId}）`);
       return role;
     } catch (error) {
-      this.pluginLogger.error(`KOOK Bot ${this.$id} 创建角色失败:`, error);
+      this.pluginLogger.error(`KOOK Endpoint ${this.$id} 创建角色失败:`, error);
       throw error;
     }
   }
@@ -449,10 +452,10 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
     try {
       const guild = this.pickGuild(guildId);
       const result = await guild.deleteRole(roleId);
-      this.pluginLogger.info(`KOOK Bot ${this.$id} 删除角色 ${roleId}（服务器 ${guildId}）`);
+      this.pluginLogger.info(`KOOK Endpoint ${this.$id} 删除角色 ${roleId}（服务器 ${guildId}）`);
       return result;
     } catch (error) {
-      this.pluginLogger.error(`KOOK Bot ${this.$id} 删除角色失败:`, error);
+      this.pluginLogger.error(`KOOK Endpoint ${this.$id} 删除角色失败:`, error);
       throw error;
     }
   }
@@ -466,7 +469,7 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
     try {
       return await this.getGuildUserList(guildId, channelId);
     } catch (error) {
-      this.pluginLogger.error(`KOOK Bot ${this.$id} 获取成员列表失败:`, error);
+      this.pluginLogger.error(`KOOK Endpoint ${this.$id} 获取成员列表失败:`, error);
       throw error;
     }
   }
@@ -650,11 +653,11 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
         this.$platformUserId = String(selfId);
       }
       this.pluginLogger.info(
-        `KOOK Bot ${this.$id} 连接成功`
+        `KOOK Endpoint ${this.$id} 连接成功`
         + (this.$platformUserId ? ` (platform_user_id=${this.$platformUserId})` : ''),
       );
     } catch (error) {
-      this.pluginLogger.error(`KOOK Bot ${this.$id} 连接失败:`, error);
+      this.pluginLogger.error(`KOOK Endpoint ${this.$id} 连接失败:`, error);
       throw error;
     }
   }
@@ -670,9 +673,9 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
       (this as unknown as import('node:events').EventEmitter).removeAllListeners();
       await this.disconnect();
       this.$connected = false;
-      this.pluginLogger.info(`KOOK Bot ${this.$id} 已断开连接`);
+      this.pluginLogger.info(`KOOK Endpoint ${this.$id} 已断开连接`);
     } catch (error) {
-      this.pluginLogger.error(`KOOK Bot ${this.$id} 断开连接失败:`, error);
+      this.pluginLogger.error(`KOOK Endpoint ${this.$id} 断开连接失败:`, error);
       throw error;
     }
   }
@@ -708,7 +711,7 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
       const route = routeFromSendType(type);
       return encodeKookMsgRef(route, String(result?.msg_id ?? ''));
     } catch (error) {
-      this.pluginLogger.error(`KOOK Bot ${this.$id} 发送消息失败:`, error);
+      this.pluginLogger.error(`KOOK Endpoint ${this.$id} 发送消息失败:`, error);
       throw error;
     }
   }
@@ -725,10 +728,10 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
     try {
       await this.deleteKookMsg(msgId, routeHint);
       this.pluginLogger.debug(
-        `KOOK Bot ${this.$id} 撤回消息 (${routeHint ?? 'auto'}): ${msgId}`,
+        `KOOK Endpoint ${this.$id} 撤回消息 (${routeHint ?? 'auto'}): ${msgId}`,
       );
     } catch (error) {
-      this.pluginLogger.error(`KOOK Bot ${this.$id} 撤回消息失败:`, error);
+      this.pluginLogger.error(`KOOK Endpoint ${this.$id} 撤回消息失败:`, error);
       throw error;
     }
   }
@@ -772,7 +775,7 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
     return encodeKookReactionId(route, msgId, emoji);
   }
 
-  /** 移除本 Bot 在消息上的表情回应 */
+  /** 移除本 Endpoint 在消息上的表情回应 */
   async $removeReaction(messageId: string, reactionId: string): Promise<void> {
     const { route, emoji } = parseKookReactionId(reactionId);
     await this.mutateMsgReaction(plainKookMsgId(messageId), emoji, 'delete', route);
@@ -796,21 +799,21 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
         ) as { code?: number };
         if (isKookApiSuccess(result)) {
           this.pluginLogger.debug(
-            `KOOK Bot ${this.$id} ${action} reaction (${route}) on ${msgId}`,
+            `KOOK Endpoint ${this.$id} ${action} reaction (${route}) on ${msgId}`,
           );
           return route;
         }
         if (action === 'delete' && shouldStopDeleteAfterResponse(result, routes.length)) {
           const label = isKookApiGoneResult(result) ? 'already gone' : 'done';
           this.pluginLogger.debug(
-            `KOOK Bot ${this.$id} delete reaction ${label} (${route}) on ${msgId}`,
+            `KOOK Endpoint ${this.$id} delete reaction ${label} (${route}) on ${msgId}`,
           );
           return route;
         }
       } catch (err) {
         if (action === 'delete' && isKookMsgGoneError(err)) {
           this.pluginLogger.debug(
-            `KOOK Bot ${this.$id} delete reaction already gone (${route}) on ${msgId}`,
+            `KOOK Endpoint ${this.$id} delete reaction already gone (${route}) on ${msgId}`,
           );
           return route;
         }
@@ -820,7 +823,7 @@ export class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage
 
     if (action === 'delete') {
       this.pluginLogger.debug(
-        `KOOK Bot ${this.$id} delete reaction noop on ${msgId}`,
+        `KOOK Endpoint ${this.$id} delete reaction noop on ${msgId}`,
       );
       return routeHint ?? 'channel';
     }