@koishi-ce/plugin-inspect 1.0.0 → 1.1.0

package/README.md

@@ -0,0 +1,83 @@
+# @koishi-ce/plugin-inspect
+
+**简体中文** | [English](#english)
+
+消息检查插件，移植自上游 [koishijs/koishi](https://github.com/koishijs/koishi) 的 `plugins/common/inspect`。查看当前会话或所引用消息的元信息，包括平台名、消息 ID、频道 ID、群组 ID、用户 ID 与自身 ID。
+
+## 指令
+
+| 指令 | 权限 | 说明 |
+| --- | --- | --- |
+| `inspect` | 1 | 查看用户、频道或消息的详细信息 |
+
+- `inspect @user`：输出所 @ 的用户 ID。
+- `inspect #channel`：输出所 # 的频道 ID。
+- `inspect`：输出当前会话的元信息；若消息带有引用，则优先展示被引用消息的信息。
+
+## 配置项
+
+本插件无需配置。
+
+## 用法
+
+```bash
+bun add @koishi-ce/plugin-inspect
+```
+
+也可以在控制台的插件市场中直接安装。随后在配置文件中启用：
+
+```yaml
+plugins:
+  inspect: {}
+```
+
+## 备注
+
+- 指令设置了 `captureQuote: false`，引用消息不被消费而是保留在会话对象上，因此能检查被引用消息的元信息。
+- 无法解析的元素会提示「参数无法解析。」。
+
+## 许可证
+
+[MIT](https://github.com/Koishi-CE/koishi/blob/main/LICENSE)。本包是上游 [koishijs/koishi](https://github.com/koishijs/koishi) 的社区再分发，版权归属见 [NOTICE](https://github.com/Koishi-CE/koishi/blob/main/NOTICE)。
+
+---
+
+## English
+
+A message inspection plugin, ported from `plugins/common/inspect` of the upstream [koishijs/koishi](https://github.com/koishijs/koishi) repository. It shows the metadata of the current session or a quoted message: platform, message ID, channel ID, guild ID, user ID and self ID.
+
+## Commands
+
+| Command | Authority | Description |
+| --- | --- | --- |
+| `inspect` | 1 | Inspect detailed information about a user, channel or message |
+
+- `inspect @user`: print the ID of the mentioned user.
+- `inspect #channel`: print the ID of the referenced channel.
+- `inspect`: print the metadata of the current session; a quoted message takes precedence.
+
+## Configuration
+
+None.
+
+## Usage
+
+```bash
+bun add @koishi-ce/plugin-inspect
+```
+
+The plugin can also be installed from the console plugin market, then enabled in the config file:
+
+```yaml
+plugins:
+  inspect: {}
+```
+
+## Notes
+
+- The command sets `captureQuote: false`, so the quote stays on the session object and can be inspected.
+- Unparsable elements report an error.
+
+## License
+
+[MIT](https://github.com/Koishi-CE/koishi/blob/main/LICENSE). This package is a community redistribution of upstream koishijs/koishi; see [NOTICE](https://github.com/Koishi-CE/koishi/blob/main/NOTICE) for attribution.

package/lib/assets/{zh-CN-Dm2KmiOI.yml → zh-CN-BY_5D7hi.yml}

@@ -1,3 +1,6 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands:
   inspect:
     description: 查看用户、频道或消息的详细信息

package/lib/index.d.ts

@@ -1,9 +1,8 @@
 import { Context, Schema } from "@koishi-ce/koishi";
 //#region src/index.d.ts
-declare const name = "inspect";
+export declare const name = "inspect";
 /** 配置项（当前无可用配置） */
-type Config = Record<never, never>;
-declare const Config: Schema<Config>;
-declare function apply(ctx: Context): void;
-//#endregion
-export { Config, apply, name };
+export type Config = Record<never, never>;
+export declare const Config: Schema<Config>;
+export declare function apply(ctx: Context): void;
+//#endregion

package/lib/index.mjs

@@ -1,5 +1,5 @@
 import { Schema, h } from "@koishi-ce/koishi";
-import zhCN from "./assets/zh-CN-Dm2KmiOI.yml";
+import zhCN from "./assets/zh-CN-BY_5D7hi.yml";
 //#region src/index.ts
 /**
 * 消息检查插件（inspect）。

package/locales/de-DE.yml

@@ -1,18 +1,21 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands:
   inspect:
-    description: 查看用户、频道或消息的详细信息
+    description: Details zu Benutzern, Kanälen oder Nachrichten anzeigen
     usage: |-
       inspect @user
       inspect #channel
       inspect
     messages:
-      invalid: 参数无法解析。
-      user: 用户 ID：{id}
-      channel: 频道 ID：{id}
+      invalid: Argumente konnten nicht analysiert werden.
+      user: 'Benutzer-ID: {id}'
+      channel: 'Kanal-ID: {id}'
       message: |-
-        平台名：{platform}
-        消息 ID：{messageId}
-        频道 ID：{channelId}
-        群组 ID：{guildId}
-        用户 ID：{userId}
-        自身 ID：{selfId}
+        Plattformname: {platform}
+        Nachrichten-ID: {messageId}
+        Kanal-ID: {channelId}
+        Gruppen-ID: {guildId}
+        Benutzer-ID: {userId}
+        Eigene ID: {selfId}

package/locales/en-US.yml

@@ -1,3 +1,6 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands:
   inspect:
     description: View details of users, channels or messages

package/locales/fr-FR.yml

@@ -1,18 +1,21 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands:
   inspect:
-    description: 查看用户、频道或消息的详细信息
+    description: Afficher les détails des utilisateurs, canaux ou messages
     usage: |-
       inspect @user
       inspect #channel
       inspect
     messages:
-      invalid: 参数无法解析。
-      user: 用户 ID：{id}
-      channel: 频道 ID：{id}
+      invalid: Impossible d'analyser les arguments.
+      user: "Identifiant de l'utilisateur : {id}"
+      channel: 'Identifiant du canal : {id}'
       message: |-
-        平台名：{platform}
-        消息 ID：{messageId}
-        频道 ID：{channelId}
-        群组 ID：{guildId}
-        用户 ID：{userId}
-        自身 ID：{selfId}
+        Nom de la plateforme : {platform}
+        Identifiant du message : {messageId}
+        Identifiant du canal : {channelId}
+        Identifiant du groupe : {guildId}
+        Identifiant de l'utilisateur : {userId}
+        Identifiant propre : {selfId}

package/locales/ja-JP.yml

@@ -1,18 +1,21 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands:
   inspect:
-    description: 查看用户、频道或消息的详细信息
+    description: ユーザー、チャンネルまたはメッセージの詳細を表示
     usage: |-
       inspect @user
       inspect #channel
       inspect
     messages:
-      invalid: 参数无法解析。
-      user: 用户 ID：{id}
-      channel: 频道 ID：{id}
+      invalid: 引数を解析できませんでした。
+      user: ユーザー ID：{id}
+      channel: チャンネル ID：{id}
       message: |-
-        平台名：{platform}
-        消息 ID：{messageId}
-        频道 ID：{channelId}
-        群组 ID：{guildId}
-        用户 ID：{userId}
+        プラットフォーム名：{platform}
+        メッセージ ID：{messageId}
+        チャンネル ID：{channelId}
+        グループ ID：{guildId}
+        ユーザー ID：{userId}
         自身 ID：{selfId}

package/locales/ru-RU.yml

@@ -1,18 +1,21 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands:
   inspect:
-    description: 查看用户、频道或消息的详细信息
+    description: Просмотреть подробную информацию о пользователях, каналах или сообщениях
     usage: |-
       inspect @user
       inspect #channel
       inspect
     messages:
-      invalid: 参数无法解析。
-      user: 'Идентификатор Пользователя: {id}'
-      channel: Идентификатор Канала:{id}
+      invalid: Не удалось разобрать аргументы.
+      user: 'Идентификатор пользователя: {id}'
+      channel: 'Идентификатор канала: {id}'
       message: |-
-        平台名：{platform}
-        消息 ID：{messageId}
-        频道 ID：{channelId}
-        群组 ID：{guildId}
-        用户 ID：{userId}
-        自身 ID：{selfId}
+        Платформа: {platform}
+        Идентификатор сообщения: {messageId}
+        Идентификатор канала: {channelId}
+        Идентификатор группы: {guildId}
+        Идентификатор пользователя: {userId}
+        Собственный идентификатор: {selfId}

package/locales/zh-CN.yml

@@ -1,3 +1,6 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands:
   inspect:
     description: 查看用户、频道或消息的详细信息

package/locales/zh-TW.yml

@@ -1,3 +1,6 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands:
   inspect:
     description: 查看使用者、頻道或消息的詳細信息

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@koishi-ce/plugin-inspect",
     "description": "Inspect on any user, channel or message",
-    "version": "1.0.0",
+    "version": "1.1.0",
     "type": "module",
     "main": "lib/index.mjs",
     "typings": "lib/index.d.ts",
@@ -49,11 +49,11 @@
         ]
     },
     "peerDependencies": {
-        "koishi": "^4.18.11"
+        "@koishi-ce/koishi": "^1.0.0"
     },
     "devDependencies": {
         "@koishi-ce/plugin-mock": "^1.0.0",
-        "@koishi-ce/koishi": "^1.0.0"
+        "@koishi-ce/koishi": "^1.0.8"
     },
     "exports": {
         ".": {

package/src/index.test.ts

@@ -1,8 +1,16 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 /**
  * inspect 插件测试：验证当前会话、at / sharp 元素参数、
  * 非法参数与引用消息四类输入的元信息输出。
  */
-import { afterAll, beforeAll, describe, it } from "bun:test";
+import {
+	afterAll,
+	beforeAll,
+	describe,
+	it,
+} from "bun:test";
 import { Context } from "@koishi-ce/koishi";
 import mock from "@koishi-ce/plugin-mock";
 import * as inspect from "./index.ts";
@@ -34,9 +42,18 @@ describe("@koishi-ce/plugin-inspect", () => {
 			),
 		);
 
-		await client.shouldReply('inspect <at id="321"/>', "用户 ID：321");
-		await client.shouldReply('inspect <sharp id="654"/>', "频道 ID：654");
-		await client.shouldReply("inspect foobar", "参数无法解析。");
+		await client.shouldReply(
+			'inspect <at id="321"/>',
+			"用户 ID：321",
+		);
+		await client.shouldReply(
+			'inspect <sharp id="654"/>',
+			"频道 ID：654",
+		);
+		await client.shouldReply(
+			"inspect foobar",
+			"参数无法解析。",
+		);
 
 		await client.shouldReply(
 			'<quote id="114514"/> inspect foobar',

package/src/index.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2019-present Shigma and Koishijs contributors.
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 /**
  * 消息检查插件（inspect）。
  *