From eff3d9587eba90530512eee37d608e57cdc3ce66 Mon Sep 17 00:00:00 2001
From: Soulter <37870767+Soulter@users.noreply.github.com>
Date: Mon, 14 Sep 2026 20:03:41 +0800
Subject: [PATCH 1/3] feat: recreate bot platforms through QR scanning

---
 .../components/platform/AddNewPlatform.vue    | 50 ++++++++++++++++---
 .../components/platform/PlatformEditor.vue    | 26 +++++++++-
 .../i18n/locales/en-US/features/platform.json |  2 +
 .../i18n/locales/ja-JP/features/platform.json |  2 +
 .../i18n/locales/ru-RU/features/platform.json |  2 +
 .../i18n/locales/zh-CN/features/platform.json |  2 +
 dashboard/src/views/PlatformPage.vue          | 40 +++++++++++++++
 7 files changed, 115 insertions(+), 9 deletions(-)

diff --git a/dashboard/src/components/platform/AddNewPlatform.vue b/dashboard/src/components/platform/AddNewPlatform.vue
index 7bc05e91bf..a5cb6411d3 100644
--- a/dashboard/src/components/platform/AddNewPlatform.vue
+++ b/dashboard/src/components/platform/AddNewPlatform.vue
@@ -9,10 +9,10 @@
       <v-card-title class="text-h3 pa-4 pb-0 pl-6">
         {{
           updatingMode
-            ? `${tm('dialog.edit')} ${updatingPlatformConfig.id} ${tm(
-                'dialog.adapter',
+            ? `${tm("dialog.edit")} ${updatingPlatformConfig.id} ${tm(
+                "dialog.adapter",
               )}`
-            : tm('dialog.addPlatform')
+            : tm("dialog.addPlatform")
         }}
       </v-card-title>
       <v-card-text
@@ -73,7 +73,9 @@
                         activator="parent"
                         :text="
                           tm(
-                            `createDialog.platformTooltips.${platformTemplates[item.raw].type}`,
+                            `createDialog.platformTooltips.${
+                              platformTemplates[item.raw].type
+                            }`,
                           )
                         "
                         location="end"
@@ -734,7 +736,9 @@
 
       <v-card-actions>
         <v-spacer></v-spacer>
-        <v-btn variant="text" @click="closeDialog">{{ tm("dialog.cancel") }}</v-btn>
+        <v-btn variant="text" @click="closeDialog">{{
+          tm("dialog.cancel")
+        }}</v-btn>
         <v-btn
           :disabled="!canSave"
           color="primary"
@@ -850,7 +854,13 @@
 </template>
 
 <script>
-import { botApi, configProfileApi, configRouteApi, fileApi, sessionApi } from "@/api/v1";
+import {
+  botApi,
+  configProfileApi,
+  configRouteApi,
+  fileApi,
+  sessionApi,
+} from "@/api/v1";
 import { useModuleI18n } from "@/i18n/composables";
 import {
   getPlatformIcon,
@@ -894,6 +904,10 @@ export default {
       type: Object,
       default: null,
     },
+    initialScanPlatform: {
+      type: Object,
+      default: null,
+    },
   },
   data() {
     return {
@@ -959,6 +973,7 @@ export default {
         return this.show;
       },
       set(value) {
+        if (!value) this.resetForm();
         this.$emit("update:show", value);
       },
     },
@@ -1588,7 +1603,9 @@ export default {
       }
 
       let suffix = "";
-      const explicitSuffix = this.sanitizePlatformIdPart(data.platform_id_suffix);
+      const explicitSuffix = this.sanitizePlatformIdPart(
+        data.platform_id_suffix,
+      );
       if (explicitSuffix) {
         suffix =
           explicitSuffix.startsWith("_") || explicitSuffix.startsWith("-")
@@ -1944,7 +1961,24 @@ export default {
       this.showConfigSection = true;
     },
 
-    prepareData() {
+    async prepareData() {
+      if (!this.updatingMode && this.initialScanPlatform) {
+        const scanPlatform = this.initialScanPlatform;
+        this.resetForm();
+        await this.$nextTick();
+        this.selectedPlatformType =
+          Object.keys(this.platformTemplates).find(
+            (name) => this.platformTemplates[name].type === scanPlatform.type,
+          ) || null;
+        await this.$nextTick();
+        if (this.selectedPlatformConfig) {
+          this.selectedPlatformConfig.id = scanPlatform.id;
+          this.scanPlatformIdCustomized = true;
+          this.larkCreationMode = "scan";
+          this.dingtalkCreationMode = "scan";
+          this.qqOfficialCreationMode = "scan";
+        }
+      }
       this.getConfigInfoList();
       this.getConfigForPreview(this.selectedAbConfId);
       if (
diff --git a/dashboard/src/components/platform/PlatformEditor.vue b/dashboard/src/components/platform/PlatformEditor.vue
index 580d0f6fed..3c6de101c4 100644
--- a/dashboard/src/components/platform/PlatformEditor.vue
+++ b/dashboard/src/components/platform/PlatformEditor.vue
@@ -15,6 +15,25 @@
       </div>
 
       <div class="bot-editor__actions">
+        <v-btn
+          v-if="
+            [
+              'lark',
+              'dingtalk',
+              'qq_official',
+              'qq_official_webhook',
+              'weixin_oc',
+            ].includes(platform.type)
+          "
+          prepend-icon="mdi-qrcode"
+          variant="text"
+          rounded="xl"
+          :loading="rescanning"
+          :disabled="saving"
+          @click="$emit('rescan')"
+        >
+          {{ tm("workspace.rescan") }}
+        </v-btn>
         <v-btn
           v-if="runtimeStat?.error_count > 0"
           color="error"
@@ -49,7 +68,7 @@
           variant="tonal"
           rounded="xl"
           :loading="saving"
-          :disabled="!canSave"
+          :disabled="!canSave || rescanning"
           @click="save"
         >
           {{ tm("workspace.save") }}
@@ -391,6 +410,10 @@ const props = defineProps({
     type: Boolean,
     default: false,
   },
+  rescanning: {
+    type: Boolean,
+    default: false,
+  },
 });
 
 const emit = defineEmits([
@@ -398,6 +421,7 @@ const emit = defineEmits([
   "show-toast",
   "show-error",
   "show-qr",
+  "rescan",
   "show-webhook",
 ]);
 
diff --git a/dashboard/src/i18n/locales/en-US/features/platform.json b/dashboard/src/i18n/locales/en-US/features/platform.json
index 1790be5259..c9c6cef6fe 100644
--- a/dashboard/src/i18n/locales/en-US/features/platform.json
+++ b/dashboard/src/i18n/locales/en-US/features/platform.json
@@ -5,6 +5,8 @@
   "addAdapter": "Add Adapter",
   "emptyText": "No platform adapters yet, click Add Adapter to create one",
   "workspace": {
+    "rescan": "Scan again",
+    "rescanConfirm": "This will delete platform {id} and open QR code creation for the same platform. Existing connection settings and unsaved changes will be lost. Cancelling creation will not restore the old platform. Continue?",
     "listTitle": "Bots",
     "selectHint": "Select a bot to configure",
     "empty": "No bots yet. Create one to start configuring it.",
diff --git a/dashboard/src/i18n/locales/ja-JP/features/platform.json b/dashboard/src/i18n/locales/ja-JP/features/platform.json
index de8a515009..b4b22401aa 100644
--- a/dashboard/src/i18n/locales/ja-JP/features/platform.json
+++ b/dashboard/src/i18n/locales/ja-JP/features/platform.json
@@ -5,6 +5,8 @@
   "addAdapter": "ボットを作成",
   "emptyText": "プラットフォームアダプターがありません。「ボットを作成」をクリックして追加してください",
   "workspace": {
+    "rescan": "再スキャン",
+    "rescanConfirm": "プラットフォーム {id} を削除し、同じプラットフォームのQRコード作成画面を開きます。接続設定と未保存の変更は失われます。作成をキャンセルしても元に戻りません。続行しますか？",
     "listTitle": "ボット",
     "selectHint": "設定するボットを選択してください",
     "empty": "ボットがありません。作成すると設定を開始できます。",
diff --git a/dashboard/src/i18n/locales/ru-RU/features/platform.json b/dashboard/src/i18n/locales/ru-RU/features/platform.json
index 407f974642..49e0780e9e 100644
--- a/dashboard/src/i18n/locales/ru-RU/features/platform.json
+++ b/dashboard/src/i18n/locales/ru-RU/features/platform.json
@@ -5,6 +5,8 @@
   "addAdapter": "Создать бота",
   "emptyText": "Боты не настроены. Нажмите «Создать бота», чтобы начать.",
   "workspace": {
+    "rescan": "Сканировать заново",
+    "rescanConfirm": "Платформа {id} будет удалена, затем откроется создание той же платформы по QR-коду. Настройки подключения и несохранённые изменения будут потеряны. Отмена создания не восстановит платформу. Продолжить?",
     "listTitle": "Боты",
     "selectHint": "Выберите бота для настройки",
     "empty": "Ботов пока нет. Создайте бота, чтобы начать настройку.",
diff --git a/dashboard/src/i18n/locales/zh-CN/features/platform.json b/dashboard/src/i18n/locales/zh-CN/features/platform.json
index 282871c20c..10f1bbd4bf 100644
--- a/dashboard/src/i18n/locales/zh-CN/features/platform.json
+++ b/dashboard/src/i18n/locales/zh-CN/features/platform.json
@@ -5,6 +5,8 @@
   "addAdapter": "创建机器人",
   "emptyText": "暂无平台适配器，点击 创建机器人 添加",
   "workspace": {
+    "rescan": "重新扫码",
+    "rescanConfirm": "将删除平台 {id}，并打开同一平台的扫码创建界面。现有连接配置和未保存的修改会丢失，取消创建也不会恢复旧平台。确定继续吗？",
     "listTitle": "机器人",
     "selectHint": "选择一个机器人进行配置",
     "empty": "还没有机器人，创建后即可开始配置。",
diff --git a/dashboard/src/views/PlatformPage.vue b/dashboard/src/views/PlatformPage.vue
index 5399a17a31..e52206b391 100644
--- a/dashboard/src/views/PlatformPage.vue
+++ b/dashboard/src/views/PlatformPage.vue
@@ -151,6 +151,8 @@
               :metadata="metadata"
               :runtime-stat="getPlatformStat(selectedPlatform.id)"
               :has-qr-payload="hasQrPayload(selectedPlatform.id)"
+              :rescanning="rescanning"
+              @rescan="rescanPlatform(selectedPlatform)"
               @saved="handlePlatformSaved"
               @show-toast="showToast"
               @show-error="showErrorDetails(selectedPlatform)"
@@ -174,6 +176,12 @@
       :metadata="metadata"
       :config_data="configData"
       :updating-mode="false"
+      :initial-scan-platform="scanPlatform"
+      @update:show="
+        (show) => {
+          if (!show) scanPlatform = null;
+        }
+      "
       @show-toast="showToast"
       @refresh-config="handlePlatformCreated"
     />
@@ -338,6 +346,8 @@ const metadata = ref({});
 const loadingPlatforms = ref(true);
 const selectedPlatformId = ref(null);
 const showAddPlatformDialog = ref(false);
+const scanPlatform = ref(null);
+const rescanning = ref(false);
 const platformStats = ref({});
 const showWebhookDialog = ref(false);
 const currentWebhookUuid = ref("");
@@ -478,6 +488,36 @@ async function deletePlatform(platform) {
   }
 }
 
+async function rescanPlatform(platform) {
+  if (rescanning.value) return;
+  rescanning.value = true;
+  try {
+    if (
+      !(await askForConfirmationDialog(
+        tm("workspace.rescanConfirm", { id: platform.id }),
+        confirmDialog,
+      ))
+    )
+      return;
+
+    const response = await botApi.delete(platform.id);
+    if (response.data.status !== "ok") {
+      throw new Error(response.data.message || tm("status.error"));
+    }
+    configData.value.platform = platforms.value.filter(
+      (item) => item.id !== platform.id,
+    );
+    selectedPlatformId.value = null;
+    scanPlatform.value = { id: platform.id, type: platform.type };
+    showAddPlatformDialog.value = true;
+    await getConfig();
+  } catch (error) {
+    showError(error);
+  } finally {
+    rescanning.value = false;
+  }
+}
+
 function handlePlatformCreated(platformId) {
   getConfig(platformId || null);
   getPlatformStats();

From 01b9db74da330e4ee06581f98f698935d217b440 Mon Sep 17 00:00:00 2001
From: Soulter <37870767+Soulter@users.noreply.github.com>
Date: Mon, 14 Sep 2026 21:11:57 +0800
Subject: [PATCH 2/3] fix: clarify QR rebinding confirmation copy

---
 dashboard/src/i18n/locales/en-US/features/platform.json | 4 ++--
 dashboard/src/i18n/locales/ja-JP/features/platform.json | 4 ++--
 dashboard/src/i18n/locales/ru-RU/features/platform.json | 4 ++--
 dashboard/src/i18n/locales/zh-CN/features/platform.json | 4 ++--
 4 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/dashboard/src/i18n/locales/en-US/features/platform.json b/dashboard/src/i18n/locales/en-US/features/platform.json
index c9c6cef6fe..731074d16f 100644
--- a/dashboard/src/i18n/locales/en-US/features/platform.json
+++ b/dashboard/src/i18n/locales/en-US/features/platform.json
@@ -5,8 +5,8 @@
   "addAdapter": "Add Adapter",
   "emptyText": "No platform adapters yet, click Add Adapter to create one",
   "workspace": {
-    "rescan": "Scan again",
-    "rescanConfirm": "This will delete platform {id} and open QR code creation for the same platform. Existing connection settings and unsaved changes will be lost. Cancelling creation will not restore the old platform. Continue?",
+    "rescan": "Rebind via QR code",
+    "rescanConfirm": "Rebind {id} via QR code? Existing connection settings will be deleted.",
     "listTitle": "Bots",
     "selectHint": "Select a bot to configure",
     "empty": "No bots yet. Create one to start configuring it.",
diff --git a/dashboard/src/i18n/locales/ja-JP/features/platform.json b/dashboard/src/i18n/locales/ja-JP/features/platform.json
index b4b22401aa..9a70d17bbc 100644
--- a/dashboard/src/i18n/locales/ja-JP/features/platform.json
+++ b/dashboard/src/i18n/locales/ja-JP/features/platform.json
@@ -5,8 +5,8 @@
   "addAdapter": "ボットを作成",
   "emptyText": "プラットフォームアダプターがありません。「ボットを作成」をクリックして追加してください",
   "workspace": {
-    "rescan": "再スキャン",
-    "rescanConfirm": "プラットフォーム {id} を削除し、同じプラットフォームのQRコード作成画面を開きます。接続設定と未保存の変更は失われます。作成をキャンセルしても元に戻りません。続行しますか？",
+    "rescan": "QRコードで再連携",
+    "rescanConfirm": "「{id}」をQRコードで再連携しますか？現在の接続設定は削除されます。",
     "listTitle": "ボット",
     "selectHint": "設定するボットを選択してください",
     "empty": "ボットがありません。作成すると設定を開始できます。",
diff --git a/dashboard/src/i18n/locales/ru-RU/features/platform.json b/dashboard/src/i18n/locales/ru-RU/features/platform.json
index 49e0780e9e..d941adadb1 100644
--- a/dashboard/src/i18n/locales/ru-RU/features/platform.json
+++ b/dashboard/src/i18n/locales/ru-RU/features/platform.json
@@ -5,8 +5,8 @@
   "addAdapter": "Создать бота",
   "emptyText": "Боты не настроены. Нажмите «Создать бота», чтобы начать.",
   "workspace": {
-    "rescan": "Сканировать заново",
-    "rescanConfirm": "Платформа {id} будет удалена, затем откроется создание той же платформы по QR-коду. Настройки подключения и несохранённые изменения будут потеряны. Отмена создания не восстановит платформу. Продолжить?",
+    "rescan": "Перепривязать по QR-коду",
+    "rescanConfirm": "Перепривязать {id} по QR-коду? Текущие настройки подключения будут удалены.",
     "listTitle": "Боты",
     "selectHint": "Выберите бота для настройки",
     "empty": "Ботов пока нет. Создайте бота, чтобы начать настройку.",
diff --git a/dashboard/src/i18n/locales/zh-CN/features/platform.json b/dashboard/src/i18n/locales/zh-CN/features/platform.json
index 10f1bbd4bf..3dfe394e57 100644
--- a/dashboard/src/i18n/locales/zh-CN/features/platform.json
+++ b/dashboard/src/i18n/locales/zh-CN/features/platform.json
@@ -5,8 +5,8 @@
   "addAdapter": "创建机器人",
   "emptyText": "暂无平台适配器，点击 创建机器人 添加",
   "workspace": {
-    "rescan": "重新扫码",
-    "rescanConfirm": "将删除平台 {id}，并打开同一平台的扫码创建界面。现有连接配置和未保存的修改会丢失，取消创建也不会恢复旧平台。确定继续吗？",
+    "rescan": "重新扫码绑定",
+    "rescanConfirm": "确定重新扫码绑定「{id}」？现有连接配置将被删除。",
     "listTitle": "机器人",
     "selectHint": "选择一个机器人进行配置",
     "empty": "还没有机器人，创建后即可开始配置。",

From d029fcc5df0837604e329387aa33beeff2557d32 Mon Sep 17 00:00:00 2001
From: Soulter <37870767+Soulter@users.noreply.github.com>
Date: Mon, 14 Sep 2026 21:16:24 +0800
Subject: [PATCH 3/3] fix: use normal scan creation naming when rebinding bots

---
 dashboard/src/components/platform/AddNewPlatform.vue    | 2 --
 dashboard/src/i18n/locales/en-US/features/platform.json | 2 +-
 dashboard/src/i18n/locales/ja-JP/features/platform.json | 2 +-
 dashboard/src/i18n/locales/ru-RU/features/platform.json | 2 +-
 dashboard/src/i18n/locales/zh-CN/features/platform.json | 2 +-
 dashboard/src/views/PlatformPage.vue                    | 4 ++--
 6 files changed, 6 insertions(+), 8 deletions(-)

diff --git a/dashboard/src/components/platform/AddNewPlatform.vue b/dashboard/src/components/platform/AddNewPlatform.vue
index a5cb6411d3..e38fecd0e3 100644
--- a/dashboard/src/components/platform/AddNewPlatform.vue
+++ b/dashboard/src/components/platform/AddNewPlatform.vue
@@ -1972,8 +1972,6 @@ export default {
           ) || null;
         await this.$nextTick();
         if (this.selectedPlatformConfig) {
-          this.selectedPlatformConfig.id = scanPlatform.id;
-          this.scanPlatformIdCustomized = true;
           this.larkCreationMode = "scan";
           this.dingtalkCreationMode = "scan";
           this.qqOfficialCreationMode = "scan";
diff --git a/dashboard/src/i18n/locales/en-US/features/platform.json b/dashboard/src/i18n/locales/en-US/features/platform.json
index 731074d16f..325db7f531 100644
--- a/dashboard/src/i18n/locales/en-US/features/platform.json
+++ b/dashboard/src/i18n/locales/en-US/features/platform.json
@@ -6,7 +6,7 @@
   "emptyText": "No platform adapters yet, click Add Adapter to create one",
   "workspace": {
     "rescan": "Rebind via QR code",
-    "rescanConfirm": "Rebind {id} via QR code? Existing connection settings will be deleted.",
+    "rescanConfirm": "After you click Confirm, existing connection settings will be deleted and the QR code creation page will open automatically.",
     "listTitle": "Bots",
     "selectHint": "Select a bot to configure",
     "empty": "No bots yet. Create one to start configuring it.",
diff --git a/dashboard/src/i18n/locales/ja-JP/features/platform.json b/dashboard/src/i18n/locales/ja-JP/features/platform.json
index 9a70d17bbc..f4ac369a38 100644
--- a/dashboard/src/i18n/locales/ja-JP/features/platform.json
+++ b/dashboard/src/i18n/locales/ja-JP/features/platform.json
@@ -6,7 +6,7 @@
   "emptyText": "プラットフォームアダプターがありません。「ボットを作成」をクリックして追加してください",
   "workspace": {
     "rescan": "QRコードで再連携",
-    "rescanConfirm": "「{id}」をQRコードで再連携しますか？現在の接続設定は削除されます。",
+    "rescanConfirm": "確認をクリックすると、現在の接続設定が削除され、QRコードによる作成画面に自動的に移動します。",
     "listTitle": "ボット",
     "selectHint": "設定するボットを選択してください",
     "empty": "ボットがありません。作成すると設定を開始できます。",
diff --git a/dashboard/src/i18n/locales/ru-RU/features/platform.json b/dashboard/src/i18n/locales/ru-RU/features/platform.json
index d941adadb1..d3ac11d8f6 100644
--- a/dashboard/src/i18n/locales/ru-RU/features/platform.json
+++ b/dashboard/src/i18n/locales/ru-RU/features/platform.json
@@ -6,7 +6,7 @@
   "emptyText": "Боты не настроены. Нажмите «Создать бота», чтобы начать.",
   "workspace": {
     "rescan": "Перепривязать по QR-коду",
-    "rescanConfirm": "Перепривязать {id} по QR-коду? Текущие настройки подключения будут удалены.",
+    "rescanConfirm": "После нажатия «Подтвердить» текущие настройки подключения будут удалены и автоматически откроется страница создания по QR-коду.",
     "listTitle": "Боты",
     "selectHint": "Выберите бота для настройки",
     "empty": "Ботов пока нет. Создайте бота, чтобы начать настройку.",
diff --git a/dashboard/src/i18n/locales/zh-CN/features/platform.json b/dashboard/src/i18n/locales/zh-CN/features/platform.json
index 3dfe394e57..271ee4a99f 100644
--- a/dashboard/src/i18n/locales/zh-CN/features/platform.json
+++ b/dashboard/src/i18n/locales/zh-CN/features/platform.json
@@ -6,7 +6,7 @@
   "emptyText": "暂无平台适配器，点击 创建机器人 添加",
   "workspace": {
     "rescan": "重新扫码绑定",
-    "rescanConfirm": "确定重新扫码绑定「{id}」？现有连接配置将被删除。",
+    "rescanConfirm": "点击确定后，现有连接配置将被删除，并自动跳转到扫码创建页面。",
     "listTitle": "机器人",
     "selectHint": "选择一个机器人进行配置",
     "empty": "还没有机器人，创建后即可开始配置。",
diff --git a/dashboard/src/views/PlatformPage.vue b/dashboard/src/views/PlatformPage.vue
index e52206b391..6311c04cbb 100644
--- a/dashboard/src/views/PlatformPage.vue
+++ b/dashboard/src/views/PlatformPage.vue
@@ -494,7 +494,7 @@ async function rescanPlatform(platform) {
   try {
     if (
       !(await askForConfirmationDialog(
-        tm("workspace.rescanConfirm", { id: platform.id }),
+        tm("workspace.rescanConfirm"),
         confirmDialog,
       ))
     )
@@ -508,7 +508,7 @@ async function rescanPlatform(platform) {
       (item) => item.id !== platform.id,
     );
     selectedPlatformId.value = null;
-    scanPlatform.value = { id: platform.id, type: platform.type };
+    scanPlatform.value = { type: platform.type };
     showAddPlatformDialog.value = true;
     await getConfig();
   } catch (error) {