@koishi-ce/plugin-bind 1.0.0 → 1.1.0

package/README.md

@@ -0,0 +1,93 @@
+# @koishi-ce/plugin-bind
+
+**简体中文** | [English](#english)
+
+跨平台账号绑定插件，移植自上游 [koishijs/koishi](https://github.com/koishijs/koishi) 的 `plugins/common/bind`。通过一次性令牌把不同平台的账号归入同一个用户，实现用户数据的跨平台互通。
+
+## 指令
+
+| 指令 | 权限 | 说明 |
+| --- | --- | --- |
+| `bind` | 0 | 绑定到账号，`-r, --remove` 解除当前平台账号的绑定 |
+
+绑定流程：
+
+- 在目标平台（用户数据将被覆盖的一侧）执行 `bind`，获取一枚一次性令牌，默认形如 `koishi/123456`（前缀 `koishi/` 加 6 位数字），5 分钟内有效。
+- 切换到原始平台（保留用户数据的一侧）向机器人发送令牌：私聊场景一步完成绑定；群聊场景会获得第二枚令牌，需回到目标平台再次发送令牌完成绑定。
+- `bind -r` 解除当前平台账号的绑定。
+
+## 配置项
+
+| 字段 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| `tokenPrefix` | string | `koishi/` | 令牌前缀（未注册进控制台 schema，仅手工配置生效） |
+| `generateToken` | function | 内置随机生成 | 自定义令牌生成函数（控制台中隐藏） |
+
+## 用法
+
+```bash
+bun add @koishi-ce/plugin-bind
+```
+
+也可以在控制台的插件市场中直接安装。随后在配置文件中启用：
+
+```yaml
+plugins:
+  bind: {}
+```
+
+## 备注
+
+- 依赖数据库服务，使用内置 `binding` 表与 `user` 表。
+- 通过前置中间件拦截令牌文本驱动绑定流程；令牌一次性使用，在同一账号重复输入会提示前往对侧平台。
+- 消费第一步令牌的账号（原始平台一侧）必须是已注册账号（authority 大于 0），未注册账号不能完成绑定。
+- 解绑时，从其他用户迁移而来的账号会恢复其原初绑定；最后一个原初绑定不允许解绑，避免用户失去账号入口。
+
+## 许可证
+
+[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 cross-platform account binding plugin, ported from `plugins/common/bind` of the upstream [koishijs/koishi](https://github.com/koishijs/koishi) repository. It merges accounts from different platforms into a single user via one-time tokens.
+
+## Commands
+
+| Command | Authority | Description |
+| --- | --- | --- |
+| `bind` | 0 | Bind to an account; `-r, --remove` unbinds the current platform account |
+
+Binding flow: run `bind` on the target platform (the side whose user data will be overwritten) to get a one-time token (by default `koishi/` plus 6 digits, valid for 5 minutes), then send the token to the bot on the original platform (the side whose data is kept). In direct chat the binding completes in one step; in groups a second token is issued and must be sent back on the target platform.
+
+## Configuration
+
+| Field | Type | Default | Description |
+| --- | --- | --- | --- |
+| `tokenPrefix` | string | `koishi/` | Token prefix (not registered in the console schema; manual configuration only) |
+| `generateToken` | function | built-in generator | Custom token generator (hidden in the console) |
+
+## Usage
+
+```bash
+bun add @koishi-ce/plugin-bind
+```
+
+The plugin can also be installed from the console plugin market, then enabled in the config file:
+
+```yaml
+plugins:
+  bind: {}
+```
+
+## Notes
+
+- Requires the database service (built-in `binding` and `user` tables).
+- A leading middleware intercepts token texts; tokens are single-use, and re-entering one on the same account prompts to use the other platform.
+- The account consuming the first token must be registered (authority greater than 0).
+- Unbinding restores migrated accounts to their original binding; the last original binding cannot be removed.
+
+## 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/{en-US-C0a1paCV.yml → en-US-B8YOKuiF.yml}

@@ -1,3 +1,6 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands.bind:
   description: Bind to account
   options:
@@ -13,6 +16,8 @@ commands.bind:
       Please use your account to send the following text to the bot on the target platform within 5 minutes:
       {0}
       Note: The current platform is your original platform, the user data here will overwrite the data from the target platform.
+    self-1: Please go to the original platform and send the text.
+    self-2: Please go to the target platform and send the text.
     success: Account binding has been successful!
     remove-success: Your account has been successfully unbundled!
     remove-original: 'Cannot disconnect: This is your original account.'

package/lib/assets/{zh-CN-kAS4medd.yml → zh-CN-DbUUJqH1.yml}

@@ -1,3 +1,6 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands.bind:
   description: 绑定到账号
   options:

package/lib/index.d.ts

@@ -1,15 +1,14 @@
 import { Context, Schema } from "@koishi-ce/koishi";
 //#region src/index.d.ts
 /** 配置项 */
-interface Config {
+export interface Config {
   /** 令牌前缀，默认 `koishi/` */
   tokenPrefix?: string;
   /** 自定义令牌生成器（测试中可注入确定性实现） */
   generateToken?: () => string;
 }
-declare const name = "bind";
-declare const inject: string[];
-declare const Config: Schema<Config>;
-declare function apply(ctx: Context, config?: Config): void;
-//#endregion
-export { Config, apply, inject, name };
+export declare const name = "bind";
+export declare const inject: string[];
+export declare const Config: Schema<Config>;
+export declare function apply(ctx: Context, config?: Config): void;
+//#endregion

package/lib/index.mjs

@@ -1,6 +1,6 @@
 import { Schema, Time } from "@koishi-ce/koishi";
-import enUS from "./assets/en-US-C0a1paCV.yml";
-import zhCN from "./assets/zh-CN-kAS4medd.yml";
+import enUS from "./assets/en-US-B8YOKuiF.yml";
+import zhCN from "./assets/zh-CN-DbUUJqH1.yml";
 //#region src/index.ts
 const name = "bind";
 const inject = ["database"];

package/locales/de-DE.yml

@@ -1,18 +1,23 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands.bind:
-  description: 绑定到账号
+  description: An Konto binden
   options:
-    remove: 解除绑定
+    remove: Bindung aufheben
   messages:
     generated-1: |-
-      Bind 指令可用于在多个平台间绑定用户数据。绑定过程中，原始平台的用户数据将完全保留，而目标平台的用户数据将被原始平台的数据所覆盖。
-      请确认当前平台是你的目标平台，并在 5 分钟内使用你的账号在原始平台内向机器人发送以下文本：
+      Der Befehl „Bind“ kann verwendet werden, um Benutzerdaten über mehrere Plattformen hinweg zu binden. Während des Bindungsvorgangs werden die Benutzerdaten der ursprünglichen Plattform vollständig erhalten, während die Benutzerdaten der Ziel-Plattform mit den Daten der ursprünglichen Plattform überschrieben werden.
+      Bitte stellen Sie sicher, dass die aktuelle Plattform Ihre Ziel-Plattform ist, und senden Sie innerhalb von 5 Minuten mit Ihrem Konto den folgenden Text an den Bot auf der ursprünglichen Plattform:
       {0}
-      绑定完成后，你可以随时使用「bind -r」来解除绑定状态。
+      Nach Abschluss der Bindung können Sie den Status jederzeit mit „bind -r“ wieder aufheben.
     generated-2: |-
-      令牌核验成功！下面将进行第二步操作。
-      请在 5 分钟内使用你的账号在目标平台内向机器人发送以下文本：
+      Token erfolgreich verifiziert! Nun folgt der zweite Schritt.
+      Bitte senden Sie innerhalb von 5 Minuten mit Ihrem Konto den folgenden Text an den Bot auf der Ziel-Plattform:
       {0}
-      注意：当前平台是你的原始平台，这里的用户数据将覆盖目标平台的数据。
-    success: 账号绑定成功！
-    remove-success: 账号解绑成功！
-    remove-original: 无法解除绑定：这是你的原始账号。
+      Hinweis: Die aktuelle Plattform ist Ihre ursprüngliche Plattform. Die Benutzerdaten hier überschreiben die Daten der Ziel-Plattform.
+    self-1: Bitte geben Sie den Text auf der ursprünglichen Plattform ein.
+    self-2: Bitte geben Sie den Text auf der Ziel-Plattform ein.
+    success: Das Konto wurde erfolgreich gebunden!
+    remove-success: Die Bindung des Kontos wurde erfolgreich aufgehoben!
+    remove-original: 'Bindung kann nicht aufgehoben werden: Dies ist Ihr ursprüngliches Konto.'

package/locales/en-US.yml

@@ -1,3 +1,6 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands.bind:
   description: Bind to account
   options:
@@ -13,6 +16,8 @@ commands.bind:
       Please use your account to send the following text to the bot on the target platform within 5 minutes:
       {0}
       Note: The current platform is your original platform, the user data here will overwrite the data from the target platform.
+    self-1: Please go to the original platform and send the text.
+    self-2: Please go to the target platform and send the text.
     success: Account binding has been successful!
     remove-success: Your account has been successfully unbundled!
     remove-original: 'Cannot disconnect: This is your original account.'

package/locales/fr-FR.yml

@@ -1,18 +1,23 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands.bind:
-  description: 绑定到账号
+  description: Lier au compte
   options:
-    remove: 解除绑定
+    remove: Délier
   messages:
     generated-1: |-
-      Bind 指令可用于在多个平台间绑定用户数据。绑定过程中，原始平台的用户数据将完全保留，而目标平台的用户数据将被原始平台的数据所覆盖。
-      请确认当前平台是你的目标平台，并在 5 分钟内使用你的账号在原始平台内向机器人发送以下文本：
+      La commande Bind permet de lier les données utilisateur entre plusieurs plateformes. Pendant le processus de liaison, les données utilisateur de la plateforme d'origine sont entièrement conservées, tandis que celles de la plateforme cible sont remplacées par celles de la plateforme d'origine.
+      Veuillez vérifier que la plateforme actuelle est votre plateforme cible, puis envoyez avec votre compte le texte suivant au bot sur la plateforme d'origine dans les 5 minutes :
       {0}
-      绑定完成后，你可以随时使用「bind -r」来解除绑定状态。
+      Une fois la liaison terminée, vous pouvez à tout moment utiliser « bind -r » pour la délier.
     generated-2: |-
-      令牌核验成功！下面将进行第二步操作。
-      请在 5 分钟内使用你的账号在目标平台内向机器人发送以下文本：
+      Jeton vérifié avec succès ! La deuxième étape va maintenant être effectuée.
+      Veuillez envoyer avec votre compte le texte suivant au bot sur la plateforme cible dans les 5 minutes :
       {0}
-      注意：当前平台是你的原始平台，这里的用户数据将覆盖目标平台的数据。
-    success: 账号绑定成功！
-    remove-success: 账号解绑成功！
-    remove-original: 无法解除绑定：这是你的原始账号。
+      Remarque : la plateforme actuelle est votre plateforme d'origine. Les données utilisateur présentes ici remplaceront celles de la plateforme cible.
+    self-1: Veuillez saisir le texte sur la plateforme d'origine.
+    self-2: Veuillez saisir le texte sur la plateforme cible.
+    success: Le compte a été lié avec succès !
+    remove-success: Le compte a été délié avec succès !
+    remove-original: "Impossible de délier : il s'agit de votre compte d'origine."

package/locales/ja-JP.yml

@@ -1,18 +1,23 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands.bind:
-  description: 绑定到账号
+  description: アカウントにバインド
   options:
-    remove: 解除绑定
+    remove: バインド解除
   messages:
     generated-1: |-
-      Bind 指令可用于在多个平台间绑定用户数据。绑定过程中，原始平台的用户数据将完全保留，而目标平台的用户数据将被原始平台的数据所覆盖。
-      请确认当前平台是你的目标平台，并在 5 分钟内使用你的账号在原始平台内向机器人发送以下文本：
+      Bind コマンドは、複数のプラットフォーム間でユーザーデータをバインドするために使用できます。バインド中、元のプラットフォームのユーザーデータは完全に保持され、ターゲットプラットフォームのユーザーデータは元のプラットフォームのデータで上書きされます。
+      現在のプラットフォームがターゲットプラットフォームであることを確認し、5 分以内に元のプラットフォームでアカウントを使用してボットに以下のテキストを送信してください：
       {0}
-      绑定完成后，你可以随时使用「bind -r」来解除绑定状态。
+      バインドが完了したら、いつでも「bind -r」でバインドを解除できます。
     generated-2: |-
-      令牌核验成功！下面将进行第二步操作。
-      请在 5 分钟内使用你的账号在目标平台内向机器人发送以下文本：
+      トークンの検証に成功しました！次に第 2 ステップの操作を行います。
+      5 分以内にターゲットプラットフォームでアカウントを使用して、ボットに以下のテキストを送信してください：
       {0}
-      注意：当前平台是你的原始平台，这里的用户数据将覆盖目标平台的数据。
-    success: 账号绑定成功！
-    remove-success: 账号解绑成功！
-    remove-original: 无法解除绑定：这是你的原始账号。
+      注意：現在のプラットフォームは元のプラットフォームです。ここのユーザーデータはターゲットプラットフォームのデータを上書きします。
+    self-1: 元のプラットフォームでテキストを送信してください。
+    self-2: ターゲットプラットフォームでテキストを送信してください。
+    success: アカウントのバインドに成功しました！
+    remove-success: アカウントのバインドを解除しました！
+    remove-original: バインドを解除できません：これは元のアカウントです。

package/locales/ru-RU.yml

@@ -1,18 +1,23 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands.bind:
-  description: 绑定到账号
+  description: Привязать к аккаунту
   options:
-    remove: 解除绑定
+    remove: Отвязать
   messages:
     generated-1: |-
-      Bind 指令可用于在多个平台间绑定用户数据。绑定过程中，原始平台的用户数据将完全保留，而目标平台的用户数据将被原始平台的数据所覆盖。
-      请确认当前平台是你的目标平台，并在 5 分钟内使用你的账号在原始平台内向机器人发送以下文本：
+      Команда Bind позволяет связать данные пользователя между несколькими платформами. Во время привязки данные пользователя исходной платформы полностью сохраняются, а данные пользователя целевой платформы перезаписываются данными исходной платформы.
+      Убедитесь, что текущая платформа является целевой, и в течение 5 минут отправьте со своего аккаунта следующий текст боту на исходной платформе:
       {0}
-      绑定完成后，你可以随时使用「bind -r」来解除绑定状态。
+      После завершения привязки вы можете в любой момент отменить её с помощью «bind -r».
     generated-2: |-
-      令牌核验成功！下面将进行第二步操作。
-      请在 5 分钟内使用你的账号在目标平台内向机器人发送以下文本：
+      Токен успешно проверен! Далее будет выполнен второй шаг.
+      В течение 5 минут отправьте со своего аккаунта следующий текст боту на целевой платформе:
       {0}
-      注意：当前平台是你的原始平台，这里的用户数据将覆盖目标平台的数据。
-    success: 账号绑定成功！
-    remove-success: 账号解绑成功！
-    remove-original: 无法解除绑定：这是你的原始账号。
+      Обратите внимание: текущая платформа является исходной. Данные пользователя здесь перезапишут данные целевой платформы.
+    self-1: Пожалуйста, отправьте текст на исходной платформе.
+    self-2: Пожалуйста, отправьте текст на целевой платформе.
+    success: Аккаунт успешно привязан!
+    remove-success: Аккаунт успешно отвязан!
+    remove-original: 'Не удалось отвязать: это ваш исходный аккаунт.'

package/locales/zh-CN.yml

@@ -1,3 +1,6 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands.bind:
   description: 绑定到账号
   options:

package/locales/zh-TW.yml

@@ -1,3 +1,6 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+
 commands.bind:
   description: 綁定到賬號
   options:
@@ -13,6 +16,8 @@ commands.bind:
       請在 5 分鐘內使用你的賬號在目標平台內向機器人發送以下文本：
       {0}
       注意：當前平台是你的原始平台，這裡的使用者數據將覆蓋目標平台的數據。
+    self-1: 請前往原始平台輸入。
+    self-2: 請前往目標平台輸入。
     success: 帳號綁定成功！
     remove-success: 賬號解綁成功！
     remove-original: 無法解除綁定：這是你的原始賬號。

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@koishi-ce/plugin-bind",
     "description": "Bind User Accounts Across Platforms in Koishi",
-    "version": "1.0.0",
+    "version": "1.1.0",
     "type": "module",
     "main": "lib/index.mjs",
     "typings": "lib/index.d.ts",
@@ -48,13 +48,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/extra.test.ts

@@ -0,0 +1,146 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2026-present Koishi-CE contributors.
+
+/**
+ * bind 插件补充用例（bun:test 断言）：
+ * 私聊令牌一步完成绑定、原初绑定不止一个时解绑另建新用户承接、
+ * 以及未注入生成器时走默认随机数字令牌路径。
+ */
+import {
+	afterAll,
+	beforeAll,
+	describe,
+	expect,
+	it,
+	jest,
+} from "bun:test";
+import { Context } from "@koishi-ce/koishi";
+import * as bind from "@koishi-ce/plugin-bind";
+import mock from "@koishi-ce/plugin-mock";
+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 Context();
+
+let counter = 0;
+
+app.plugin(bind, {
+	generateToken: () =>
+		`koishi/${(++counter).toString().padStart(6, "0")}`,
+});
+
+app.plugin(mock);
+app.plugin(memory);
+
+// 群聊客户端（绑定发起方）与私聊客户端（令牌签发方）
+const group = app.mock.client("123", "321");
+const direct = app.mock.client("456");
+
+// 副应用：不注入 generateToken，验证默认随机令牌生成器
+const appPlain = new Context();
+
+appPlain.plugin(bind);
+appPlain.plugin(mock);
+appPlain.plugin(memory);
+
+const plain = appPlain.mock.client("111");
+
+beforeAll(async () => {
+	await app.start();
+	await app.mock.initUser("123", 1);
+	await app.mock.initUser("456", 1);
+	await appPlain.start();
+	await appPlain.mock.initUser("111", 1);
+});
+
+afterAll(async () => {
+	await app.stop();
+	await appPlain.stop();
+});
+
+/** 从机器人文案中提取 koishi/ 前缀的六位数字令牌 */
+function extractToken(message: string | undefined) {
+	const token = message?.match(/koishi\/\d{6}/)?.[0];
+	expect(token).toBeTypeOf("string");
+	return token as string;
+}
+
+describe("@koishi-ce/plugin-bind 补充用例", () => {
+	it("私聊签发的令牌可一步完成绑定", async () => {
+		const replies = await direct.receive("bind");
+		const token = extractToken(replies[0]);
+		const [reply] = await group.receive(token);
+		expect(reply).toBe("账号绑定成功！");
+		// 私聊账号应并入群聊账号所属的内部用户
+		const [groupBinding] = await app.database.get(
+			"binding",
+			{ pid: "123" },
+		);
+		const [directBinding] = await app.database.get(
+			"binding",
+			{ pid: "456" },
+		);
+		// 前置 receive 已保证两条绑定存在，非空断言仅消除索引访问的 undefined 分支
+		expect(directBinding!.aid).toBe(groupBinding!.aid);
+	});
+
+	it("原初绑定不止一个时解绑会另建新用户承接", async () => {
+		// 预置第二条原初绑定，使当前用户名下有两条 aid === bid 的记录
+		const [self] = await app.database.get("binding", {
+			pid: "123",
+		});
+		await app.database.create("binding", {
+			platform: "mock",
+			pid: "789",
+			aid: self!.aid,
+			bid: self!.aid,
+		});
+		const usersBefore = await app.database.get("user", {});
+		const [reply] = await group.receive("bind -r");
+		expect(reply).toBe("账号解绑成功！");
+		// 当前平台账号被划入新建用户名下，而非删除绑定记录
+		const usersAfter = await app.database.get("user", {});
+		expect(usersAfter.length).toBe(usersBefore.length + 1);
+		const [moved] = await app.database.get("binding", {
+			pid: "123",
+		});
+		expect(moved!.aid).not.toBe(self!.aid);
+		const [newcomer] = await app.database.get("user", {
+			id: moved!.aid,
+		});
+		expect(newcomer).toBeDefined();
+	});
+
+	it("第二步令牌签发者的绑定被删除时静默忽略", async () => {
+		// 群聊第一步：签发 phase 1 令牌
+		const [first] = await group.receive("bind");
+		const token1 = extractToken(first);
+		// 私聊第二步：核验成功并签发 phase -1 令牌
+		const [second] = await direct.receive(token1);
+		const token2 = extractToken(second);
+		// 模拟签发者账号的绑定入口被删除，令牌失效后无任何回复
+		await app.database.remove("binding", { pid: "456" });
+		const replies = await group.receive(token2);
+		expect(replies).toEqual([]);
+	});
+
+	it("令牌超过 5 分钟后自动过期失效", async () => {
+		jest.useFakeTimers();
+		const replies = await group.receive("bind");
+		const token = extractToken(replies[0]);
+		// 推进 5 分钟：过期回调删除令牌，此后该文本不再触发绑定流程
+		jest.advanceTimersByTime(5 * 60_000);
+		const again = await group.receive(token);
+		expect(again).toEqual([]);
+		jest.useRealTimers();
+	});
+
+	it("未注入生成器时使用默认随机数字令牌", async () => {
+		const replies = await plain.receive("bind");
+		expect(replies[0]).toMatch(/koishi\/\d{6}/);
+	});
+});

package/src/index.test.ts

@@ -1,19 +1,32 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 /**
  * bind 插件测试：用两个 mock 客户端模拟跨平台用户，
  * 验证两步令牌绑定流程与解绑（含原初账号保护）。
  */
-import { afterAll, beforeAll, describe, it } from "bun:test";
+import {
+	afterAll,
+	beforeAll,
+	describe,
+	it,
+} from "bun:test";
 import { Context } from "@koishi-ce/koishi";
 import * as bind from "@koishi-ce/plugin-bind";
 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 Context();
 
 let counter = 0;
 
 app.plugin(bind, {
-	generateToken: () => `koishi/${(++counter).toString().padStart(6, "0")}`,
+	generateToken: () =>
+		`koishi/${(++counter).toString().padStart(6, "0")}`,
 });
 
 app.plugin(mock);
@@ -41,20 +54,38 @@ describe("@koishi-ce/plugin-bind", () => {
 		await client1.shouldReply("name", "foo");
 		await client2.shouldReply("name", "bar");
 		await client1.shouldReply("bind", /^koishi\/000001$/m);
-		await client1.shouldReply("koishi/000001", "请前往原始平台输入。");
-		await client2.shouldReply("koishi/000001", /^koishi\/000002$/m);
-		await client2.shouldReply("koishi/000002", "请前往目标平台输入。");
-		await client1.shouldReply("koishi/000002", "账号绑定成功！");
+		await client1.shouldReply(
+			"koishi/000001",
+			"请前往原始平台输入。",
+		);
+		await client2.shouldReply(
+			"koishi/000001",
+			/^koishi\/000002$/m,
+		);
+		await client2.shouldReply(
+			"koishi/000002",
+			"请前往目标平台输入。",
+		);
+		await client1.shouldReply(
+			"koishi/000002",
+			"账号绑定成功！",
+		);
 		await client1.shouldReply("name", "bar");
 		await client2.shouldReply("name", "bar");
 	});
 
 	// 解绑：原初账号受保护不可解绑；迁移绑定的账号解绑后各回各的昵称
 	it("remove binding", async () => {
-		await client2.shouldReply("bind -r", "无法解除绑定：这是你的原始账号。");
+		await client2.shouldReply(
+			"bind -r",
+			"无法解除绑定：这是你的原始账号。",
+		);
 		await client1.shouldReply("bind -r", "账号解绑成功！");
 		await client1.shouldReply("name", "foo");
 		await client2.shouldReply("name", "bar");
-		await client1.shouldReply("bind -r", "无法解除绑定：这是你的原始账号。");
+		await client1.shouldReply(
+			"bind -r",
+			"无法解除绑定：这是你的原始账号。",
+		);
 	});
 });

package/src/index.ts

@@ -1,12 +1,21 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2019-present Shigma and Koishijs contributors.
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 /**
  * 账号绑定插件（bind）。
  *
- * 提供跨平台账号绑定：在源平台执行 `bind` 获取一次性令牌，
- * 前往目标平台发送令牌完成绑定（群聊需要两步互发令牌，私聊一步到位）。
+ * 提供跨平台账号绑定：在目标平台（用户数据将被覆盖的一侧）执行 `bind`
+ * 获取一次性令牌，前往原始平台（保留用户数据的一侧）发送令牌完成绑定
+ * （群聊需要两步互发令牌，私聊一步到位）。
  * 指令：`bind`（`-r` 解除当前平台账号的绑定）。
  * 依赖数据库（binding / user 表），令牌默认 5 分钟过期。
  */
-import type { Context, Dict, Session } from "@koishi-ce/koishi";
+import type {
+	Context,
+	Dict,
+	Session,
+} from "@koishi-ce/koishi";
 import { Schema, Time } from "@koishi-ce/koishi";
 import enUS from "../locales/en-US.yml";
 import zhCN from "../locales/zh-CN.yml";
@@ -43,11 +52,17 @@ export function apply(ctx: Context, config: Config = {}) {
 	ctx.i18n.define("en-US", enUS);
 
 	// 令牌 phase 含义：1 = 群聊第一步（源平台签发）；0 = 私聊（一步完成）；-1 = 群聊第二步（目标平台签发）
-	type TokenData = [platform: string, id: string, phase: number];
+	type TokenData = [
+		platform: string,
+		id: string,
+		phase: number,
+	];
 	const tokens: Dict<TokenData> = Object.create(null);
 
 	const { tokenPrefix: prefix = "koishi/" } = config;
-	const { generateToken = () => `${prefix}${randomDigits(6)}` } = config;
+	const {
+		generateToken = () => `${prefix}${randomDigits(6)}`,
+	} = config;
 
 	/** 为当前会话用户签发一次性令牌并记录 phase，5 分钟后自动过期 */
 	function generate(session: Session, phase: number) {
@@ -55,13 +70,24 @@ export function apply(ctx: Context, config: Config = {}) {
 		if (!userId) return;
 		const token = generateToken();
 		tokens[token] = [session.platform, userId, phase];
-		ctx.setTimeout(() => delete tokens[token], 5 * Time.minute);
+		ctx.setTimeout(
+			() => delete tokens[token],
+			5 * Time.minute,
+		);
 		return token;
 	}
 
 	/** 将平台账号（platform + pid）绑定到指定用户（aid）名下 */
-	async function bind(aid: number, platform: string, pid: string) {
-		await ctx.database.set("binding", { platform, pid }, { aid });
+	async function bind(
+		aid: number,
+		platform: string,
+		pid: string,
+	) {
+		await ctx.database.set(
+			"binding",
+			{ platform, pid },
+			{ aid },
+		);
 	}
 
 	ctx
@@ -77,7 +103,8 @@ export function apply(ctx: Context, config: Config = {}) {
 					aid: user.id,
 				});
 				const binding = bindings.find(
-					(item) => item.platform === platform && item.pid === pid,
+					(item) =>
+						item.platform === platform && item.pid === pid,
 				);
 				if (!binding) return;
 				if (binding.aid !== binding.bid) {
@@ -85,7 +112,8 @@ export function apply(ctx: Context, config: Config = {}) {
 					await bind(binding.bid, platform, pid);
 					return session.text(".remove-success");
 				} else if (
-					bindings.filter((item) => item.aid === item.bid).length === 1
+					bindings.filter((item) => item.aid === item.bid)
+						.length === 1
 				) {
 					// 原初绑定只剩最后一个时不允许解绑，否则用户将失去入口
 					return session.text(".remove-original");
@@ -94,7 +122,9 @@ export function apply(ctx: Context, config: Config = {}) {
 					const authority = await session.resolve(
 						ctx.root.config.autoAuthorize,
 					);
-					const user = await ctx.database.create("user", { authority });
+					const user = await ctx.database.create("user", {
+						authority,
+					});
 					await bind(user.id, platform, pid);
 					return session.text(".remove-success");
 				}
@@ -113,7 +143,10 @@ export function apply(ctx: Context, config: Config = {}) {
 		const { userId } = session;
 		if (!userId) return next();
 		// 令牌在同一账号上被重复使用：提示不要在同一平台输入
-		if (data[0] === session.platform && data[1] === session.userId) {
+		if (
+			data[0] === session.platform &&
+			data[1] === session.userId
+		) {
 			return session.text(
 				`commands.bind.messages.self-${data[2] < 0 ? "2" : "1"}`,
 			);
@@ -131,20 +164,27 @@ export function apply(ctx: Context, config: Config = {}) {
 			return session.text("commands.bind.messages.success");
 		} else {
 			// 第一步令牌 / 私聊令牌：以当前用户为主体，把令牌签发账号并入自己
-			const user = await ctx.database.getUser(session.platform, userId, [
-				"id",
-				"authority",
-			]);
+			const user = await ctx.database.getUser(
+				session.platform,
+				userId,
+				["id", "authority"],
+			);
 			// 未注册（无 authority）的账号无权拉人绑定
-			if (!user.authority) return session.text("internal.low-authority");
+			if (!user.authority)
+				return session.text("internal.low-authority");
 			if (data[2]) {
 				// 群聊第一步：签发第二枚令牌，请对方回原平台输入
 				const token = generate(session, -1);
-				return session.text("commands.bind.messages.generated-2", [token]);
+				return session.text(
+					"commands.bind.messages.generated-2",
+					[token],
+				);
 			} else {
 				// 私聊一步：直接把令牌签发账号并入当前用户
 				await bind(user.id, data[0], data[1]);
-				return session.text("commands.bind.messages.success");
+				return session.text(
+					"commands.bind.messages.success",
+				);
 			}
 		}
 	}, true);