@koishi-ce/plugin-broadcast 1.0.0 → 1.1.0

package/README.md

@@ -0,0 +1,83 @@
+# @koishi-ce/plugin-broadcast
+
+**简体中文** | [English](#english)
+
+全体广播插件，移植自上游 [koishijs/koishi](https://github.com/koishijs/koishi) 的 `plugins/common/broadcast`。向机器人所在的全部频道一次性推送广播消息。
+
+## 指令
+
+| 指令 | 权限 | 说明 |
+| --- | --- | --- |
+| `broadcast <message:text>` | 4 | 全服广播 |
+
+- `-f, --forced`：无视 silent 标签进行广播。
+- `-o, --only`：仅向当前账号负责的群进行广播。
+
+## 配置项
+
+本插件无需配置。
+
+## 用法
+
+```bash
+bun add @koishi-ce/plugin-broadcast
+```
+
+也可以在控制台的插件市场中直接安装。随后在配置文件中启用：
+
+```yaml
+plugins:
+  broadcast: {}
+```
+
+## 备注
+
+- 依赖数据库服务，读取内置 `channel` 表的 assignee 与 flag 字段，不新建表。
+- 默认跳过标记为静默（silent）的频道，`-f` 可强制发送到这些频道。
+- `-o` 只向当前平台、当前 bot 被指派（assignee）的频道发送。
+
+## 许可证
+
+[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 global broadcast plugin, ported from `plugins/common/broadcast` of the upstream [koishijs/koishi](https://github.com/koishijs/koishi) repository. It pushes a message to all channels the bots have joined.
+
+## Commands
+
+| Command | Authority | Description |
+| --- | --- | --- |
+| `broadcast <message:text>` | 4 | Broadcast to all channels |
+
+- `-f, --forced`: broadcast even to channels marked as silent.
+- `-o, --only`: broadcast only to the channels assigned to the current account.
+
+## Configuration
+
+None.
+
+## Usage
+
+```bash
+bun add @koishi-ce/plugin-broadcast
+```
+
+The plugin can also be installed from the console plugin market, then enabled in the config file:
+
+```yaml
+plugins:
+  broadcast: {}
+```
+
+## Notes
+
+- Requires the database service (reads the assignee and flag fields of the built-in `channel` table; no new tables).
+- Silent channels are skipped by default; `-f` forces delivery to them.
+- `-o` sends only to the channels assigned to the current platform and bot.
+
+## 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-Bnc3gtS6.yml → zh-CN-JWl0QM2R.yml}

@@ -1,3 +1,6 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands:
   broadcast:
     description: 全服广播

package/lib/index.d.ts

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

package/lib/index.mjs

@@ -1,5 +1,5 @@
 import { Channel, Schema } from "@koishi-ce/koishi";
-import zhCN from "./assets/zh-CN-Bnc3gtS6.yml";
+import zhCN from "./assets/zh-CN-JWl0QM2R.yml";
 //#region src/index.ts
 /**
 * 全体广播插件（broadcast）。

package/locales/de-DE.yml

@@ -1,8 +1,11 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands:
   broadcast:
-    description: 全服广播
+    description: Broadcast an alle Kanäle
     options:
-      forced: 无视 silent 标签进行广播
-      only: 仅向当前账号负责的群进行广播
+      forced: Broadcast unter Umgehung des silent-Tags
+      only: Broadcast nur an die vom aktuellen Konto betreuten Gruppen
     messages:
-      expect-text: 请输入要发送的文本。
+      expect-text: Bitte geben Sie den zu sendenden Text ein.

package/locales/en-US.yml

@@ -1,8 +1,11 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands:
   broadcast:
-    description: 全服广播
+    description: Broadcast to all channels
     options:
-      forced: 无视 silent 标签进行广播
-      only: 仅向当前账号负责的群进行广播
+      forced: Broadcast ignoring the silent flag
+      only: Broadcast only to groups served by the current account
     messages:
       expect-text: Please type to send

package/locales/fr-FR.yml

@@ -1,8 +1,11 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands:
   broadcast:
-    description: 全服广播
+    description: Diffuser sur tous les canaux
     options:
-      forced: 无视 silent 标签进行广播
-      only: 仅向当前账号负责的群进行广播
+      forced: Diffuser en ignorant le marqueur silent
+      only: Ne diffuser que vers les groupes gérés par le compte actuel
     messages:
-      expect-text: 请输入要发送的文本。
+      expect-text: Veuillez saisir le texte à envoyer.

package/locales/ja-JP.yml

@@ -1,8 +1,11 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands:
   broadcast:
-    description: 全服广播
+    description: サーバー全体にブロードキャスト
     options:
-      forced: 无视 silent 标签进行广播
-      only: 仅向当前账号负责的群进行广播
+      forced: silent タグを無視してブロードキャストする
+      only: 現在のアカウントが担当するグループのみにブロードキャストする
     messages:
-      expect-text: 请输入要发送的文本。
+      expect-text: 送信するテキストを入力してください。

package/locales/ru-RU.yml

@@ -1,8 +1,11 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands:
   broadcast:
-    description: 全服广播
+    description: Рассылка по всем каналам
     options:
-      forced: 无视 silent 标签进行广播
-      only: 仅向当前账号负责的群进行广播
+      forced: Рассылка с игнорированием метки silent
+      only: Рассылка только в группы, обслуживаемые текущим аккаунтом
     messages:
-      expect-text: 请输入要发送的文本。
+      expect-text: Пожалуйста, введите текст для отправки.

package/locales/zh-CN.yml

@@ -1,3 +1,6 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands:
   broadcast:
     description: 全服广播

package/locales/zh-TW.yml

@@ -1,3 +1,6 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands:
   broadcast:
     description: 全服廣播

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@koishi-ce/plugin-broadcast",
     "description": "Broadcast messages in Koishi",
-    "version": "1.0.0",
+    "version": "1.1.0",
     "type": "module",
     "main": "lib/index.mjs",
     "typings": "lib/index.d.ts",
@@ -47,13 +47,12 @@
         ]
     },
     "peerDependencies": {
-        "koishi": "^4.18.11"
+        "@koishi-ce/koishi": "^1.0.0"
     },
     "devDependencies": {
+        "@koishi-ce/koishi": "^1.0.8",
         "@koishi-ce/plugin-mock": "^1.0.0",
-        "@minatojs/driver-memory": "^3.7.0",
-        "@koishi-ce/koishi": "^1.0.0",
-        "minato": "^3.7.0"
+        "@koishijs/plugin-database-memory": "^3.7.0"
     },
     "exports": {
         ".": {

package/src/index.test.ts

@@ -1,12 +1,25 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 /**
  * broadcast 插件测试：用两个 mock bot 验证全局广播、
  * 仅本 bot 广播（-o）与静默频道过滤（-f）的目标频道集合。
  */
-import { beforeAll, describe, expect, it, jest } from "bun:test";
+import {
+	beforeAll,
+	describe,
+	expect,
+	it,
+	jest,
+} from "bun:test";
 import { App, type Bot, Channel } from "@koishi-ce/koishi";
 import * as broadcast from "@koishi-ce/plugin-broadcast";
 import mock from "@koishi-ce/plugin-mock";
-import memory from "@minatojs/driver-memory";
+import * as memoryModule from "@koishijs/plugin-database-memory";
+
+// CJS 实现配 ESM 声明，Bun 互操作视图多包一层 default，穿透取真实驱动
+const memory =
+	memoryModule.default as unknown as typeof memoryModule.default.default;
 
 const app = new App({
 	delay: { broadcast: 0 },
@@ -24,7 +37,9 @@ beforeAll(async () => {
 	await app.mock.initUser("123", 4);
 	await app.mock.initChannel("111", "114");
 	await app.mock.initChannel("222", "514");
-	await app.mock.initChannel("333", "514", { flag: Channel.Flag.silent });
+	await app.mock.initChannel("333", "514", {
+		flag: Channel.Flag.silent,
+	});
 	await app.mock.initChannel("444", "810");
 });
 
@@ -32,13 +47,22 @@ describe("@koishi-ce/plugin-broadcast", () => {
 	// 拦截各 bot 的 sendMessage，断言广播命中了正确的频道且静默频道被正确跳过或强制发送
 	it("basic support", async () => {
 		// 在拦截前验证缺参数提示（此时回复链路完整，消息能送达 mock 客户端）
-		await client.shouldReply("broadcast", "请输入要发送的文本。");
+		await client.shouldReply(
+			"broadcast",
+			"请输入要发送的文本。",
+		);
 
 		// 替换 sendMessage 为仅记录参数的 mock；返回空 ID 列表以维持 bot.broadcast 的展开推送
-		const send1 = (app.bots.find((bot) => bot.selfId === "514")!.sendMessage =
-			jest.fn<Bot["sendMessage"]>(async () => []));
-		const send2 = (app.bots.find((bot) => bot.selfId === "114")!.sendMessage =
-			jest.fn<Bot["sendMessage"]>(async () => []));
+		const send1 = (app.bots.find(
+			(bot) => bot.selfId === "514",
+		)!.sendMessage = jest.fn<Bot["sendMessage"]>(
+			async () => [],
+		));
+		const send2 = (app.bots.find(
+			(bot) => bot.selfId === "114",
+		)!.sendMessage = jest.fn<Bot["sendMessage"]>(
+			async () => [],
+		));
 
 		await client.shouldNotReply("broadcast foo");
 		// 全局广播：两个 bot 各发送被指派的频道，静默频道 333 被跳过

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.
+
 /**
  * 全体广播插件（broadcast）。
  *
@@ -6,7 +10,11 @@
  * 选项：`-f` 强制发送到静默频道；`-o` 仅发送到当前 bot 被指派的频道。
  * 依赖数据库（channel 表的 assignee / flag 字段）。
  */
-import { Channel, type Context, Schema } from "@koishi-ce/koishi";
+import {
+	Channel,
+	type Context,
+	Schema,
+} from "@koishi-ce/koishi";
 import zhCN from "../locales/zh-CN.yml";
 
 /** 配置项（当前无可用配置） */
@@ -28,18 +36,26 @@ export function apply(ctx: Context) {
 			if (!message) return session.text(".expect-text");
 			if (!options.only) {
 				// 非仅本 bot 模式：交给全局广播（覆盖所有 bot 的指派频道）
-				await ctx.broadcast(message, Boolean(options.forced));
+				await ctx.broadcast(
+					message,
+					Boolean(options.forced),
+				);
 				return;
 			}
 
 			// -o 模式：只取当前平台、当前 bot 被指派的频道；非强制时需 flag 字段用于过滤静默频道
 			const fields: ("id" | "flag")[] = ["id"];
 			if (!options.forced) fields.push("flag");
-			let channels = await ctx.database.getAssignedChannels(fields, {
-				[session.platform]: [session.selfId],
-			});
+			let channels = await ctx.database.getAssignedChannels(
+				fields,
+				{
+					[session.platform]: [session.selfId],
+				},
+			);
 			if (!options.forced) {
-				channels = channels.filter((g) => !(g.flag & Channel.Flag.silent));
+				channels = channels.filter(
+					(g) => !(g.flag & Channel.Flag.silent),
+				);
 			}
 			await session.bot.broadcast(
 				channels.map((channel) => channel.id),