@befly-addon/admin 1.0.2

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,179 @@
+# Admin 管理后台插件
+
+## 功能说明
+
+提供管理后台的基础功能,包括:
+
+- 管理员注册
+- 管理员登录(支持邮箱和手机号两种方式)
+- 发送短信验证码
+- 获取用户信息
+- 退出登录
+
+## API 接口
+
+所有接口路由前缀: `/api/admin/`
+
+### 1. 注册接口
+
+**路由**: `POST /api/admin/register`
+
+**请求参数**:
+
+```json
+{
+    "name": "管理员姓名",
+    "email": "admin@example.com",
+    "password": "密码(至少6位)"
+}
+```
+
+**响应**:
+
+```json
+{
+    "code": 0,
+    "msg": "注册成功",
+    "data": {
+        "id": 1,
+        "name": "管理员姓名",
+        "email": "admin@example.com"
+    }
+}
+```
+
+### 2. 登录接口
+
+**路由**: `POST /api/admin/login`
+
+**邮箱登录**:
+
+```json
+{
+    "email": "admin@example.com",
+    "password": "密码"
+}
+```
+
+**手机号登录**:
+
+```json
+{
+    "phone": "13800138000",
+    "code": "验证码"
+}
+```
+
+**响应**:
+
+```json
+{
+    "code": 0,
+    "msg": "登录成功",
+    "data": {
+        "token": "JWT Token",
+        "userInfo": {
+            "id": 1,
+            "name": "管理员姓名",
+            "email": "admin@example.com",
+            "role": "admin",
+            "status": 1
+        }
+    }
+}
+```
+
+### 3. 发送短信验证码
+
+**路由**: `POST /api/admin/sendSmsCode`
+
+**请求参数**:
+
+```json
+{
+    "phone": "13800138000"
+}
+```
+
+**响应**:
+
+```json
+{
+    "code": 0,
+    "msg": "验证码已发送",
+    "data": {
+        "code": "123456" // 仅开发环境返回
+    }
+}
+```
+
+### 4. 获取用户信息
+
+**路由**: `GET /api/admin/userInfo`
+
+**请求头**:
+
+```
+Authorization: Bearer {token}
+```
+
+**响应**:
+
+```json
+{
+    "code": 0,
+    "msg": "获取成功",
+    "data": {
+        "id": 1,
+        "name": "管理员姓名",
+        "email": "admin@example.com",
+        "role": "admin",
+        "status": 1
+    }
+}
+```
+
+### 5. 退出登录
+
+**路由**: `POST /api/admin/logout`
+
+**请求头**:
+
+```
+Authorization: Bearer {token}
+```
+
+**响应**:
+
+```json
+{
+    "code": 0,
+    "msg": "退出成功",
+    "data": null
+}
+```
+
+## 数据库表
+
+### admin_admin 表
+
+| 字段            | 类型                 | 说明                |
+| --------------- | -------------------- | ------------------- |
+| id              | int                  | 主键 ID             |
+| name            | varchar(50)          | 姓名                |
+| email           | varchar(100)         | 邮箱                |
+| phone           | varchar(20)          | 手机号              |
+| password        | varchar(255)         | 密码(加密)          |
+| role            | enum('admin','user') | 角色                |
+| status          | tinyint(1)           | 状态(1-启用 0-禁用) |
+| last_login_time | datetime             | 最后登录时间        |
+| last_login_ip   | varchar(50)          | 最后登录 IP         |
+| created_at      | datetime             | 创建时间            |
+| updated_at      | datetime             | 更新时间            |
+
+## 注意事项
+
+1. 短信验证码功能需要配置短信服务提供商
+2. 建议在生产环境配置 Redis 来存储验证码和 token 黑名单
+3. 密码使用 bcrypt 加密存储
+4. Token 有效期默认为 7 天

package/addon.config.json

@@ -0,0 +1,13 @@
+{
+    "name": "admin",
+    "title": "管理后台",
+    "version": "1.0.0",
+    "description": "提供管理后台的基础功能，包括管理员注册、登录、用户信息管理等",
+    "author": {
+        "name": "Befly Team"
+    },
+    "keywords": ["admin", "backend", "management"],
+    "entry": "index.ts",
+    "enabled": true,
+    "license": "MIT"
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+    "name": "@befly-addon/admin",
+    "version": "1.0.2",
+    "description": "Befly Admin Addon - 管理后台功能组件",
+    "type": "module",
+    "private": false,
+    "publishConfig": {
+        "access": "public",
+        "registry": "https://registry.npmjs.org"
+    },
+    "main": "addon.config.json",
+    "files": [
+        "addon.config.json",
+        "apis",
+        "checks",
+        "config",
+        "plugins",
+        "scripts",
+        "tables",
+        "types",
+        "util.ts",
+        "README.md"
+    ],
+    "keywords": [
+        "befly",
+        "addon",
+        "admin",
+        "rbac",
+        "auth",
+        "typescript"
+    ],
+    "author": "chenbimo",
+    "license": "Apache-2.0",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/chenbimo/befly.git",
+        "directory": "packages/addon-admin"
+    },
+    "peerDependencies": {
+        "befly": "^3.0.0"
+    },
+    "gitHead": "66e103e5effbb89dd6de894972766fa1a03d564e"
+}

package/tables/admin.json

@@ -0,0 +1,14 @@
+{
+    "name": "姓名|string|2|50|null|0|null",
+    "nickname": "昵称|string|2|50|null|0|null",
+    "email": "邮箱|string|5|100|null|1|^[\\w.-]+@[\\w.-]+\\.\\w+$",
+    "phone": "手机号|string|11|11|null|0|^1[3-9]\\d{9}$",
+    "username": "用户名|string|3|30|null|0|^[a-zA-Z0-9_]+$",
+    "password": "密码|string|6|500|null|0|null",
+    "avatar": "头像|string|0|500|null|0|null",
+    "roleId": "角色ID|number|1|999999999999999|null|1|null",
+    "roleCode": "角色编码|string|2|50|null|0|^[a-zA-Z0-9_]+$",
+    "roleType": "角色类型|string|4|5|user|1|^(admin|user)$",
+    "lastLoginTime": "最后登录时间|number|0|null|0|0|null",
+    "lastLoginIp": "最后登录IP|string|0|50|null|0|null"
+}

package/tables/api.json

@@ -0,0 +1,8 @@
+{
+    "name": "接口名称|string|2|100|null|1|null",
+    "path": "接口路径|string|1|200|null|1|null",
+    "method": "请求方法|string|3|10|POST|1|^(GET|POST|PUT|DELETE|PATCH)$",
+    "description": "接口描述|string|0|500|null|0|null",
+    "addonName": "所属插件|string|0|50|null|0|null",
+    "addonTitle": "插件标题|string|0|100|null|0|null"
+}

package/tables/dict.json

@@ -0,0 +1,8 @@
+{
+    "name": "字典名称|string|2|50|null|1|null",
+    "code": "字典代码|string|2|50|null|1|^[a-zA-Z0-9_]+$",
+    "value": "字典值|string|0|200|null|1|null",
+    "sort": "排序|number|0|9999|0|0|null",
+    "pid": "父级ID|number|0|999999999999999|0|1|null",
+    "description": "描述|string|0|200|null|0|null"
+}

package/tables/menu.json

@@ -0,0 +1,8 @@
+{
+    "name": "菜单名称|string|2|50|null|1|null",
+    "path": "路由路径|string|1|200|null|1|null",
+    "icon": "图标名称|string|0|50|null|0|null",
+    "sort": "排序|number|0|9999|0|0|null",
+    "pid": "父级ID|number|0|999999999999999|0|1|null",
+    "type": "菜单类型|number|1|2|1|1|^(1|2)$"
+}

package/tables/role.json

@@ -0,0 +1,8 @@
+{
+    "name": "角色名称|string|2|50|null|1|null",
+    "code": "角色编码|string|2|50|null|1|^[a-zA-Z0-9_]+$",
+    "description": "角色描述|string|0|200|null|0|null",
+    "menus": "菜单权限|array_text|null|null|null|0|null",
+    "apis": "接口权限|array_text|null|null|null|0|null",
+    "sort": "排序|number|0|9999|0|0|null"
+}

package/types/index.ts

@@ -0,0 +1,44 @@
+/**
+ * Admin 相关的类型定义
+ */
+
+// 管理员信息
+export interface Admin {
+    id: number;
+    name: string;
+    email: string;
+    phone?: string;
+    password: string;
+    role: 'admin' | 'user';
+    state: 0 | 1 | 2; // 0=删除, 1=正常, 2=禁用
+    last_login_time?: string;
+    last_login_ip?: string;
+    created_at?: string;
+    updated_at?: string;
+}
+
+// 登录请求
+export interface LoginRequest {
+    email?: string;
+    password?: string;
+    phone?: string;
+    code?: string;
+}
+
+// 登录响应
+export interface LoginResponse {
+    token: string;
+    userInfo: Omit<Admin, 'password'>;
+}
+
+// 注册请求
+export interface RegisterRequest {
+    name: string;
+    email: string;
+    password: string;
+}
+
+// 发送验证码请求
+export interface SendSmsCodeRequest {
+    phone: string;
+}

package/util.ts

@@ -0,0 +1,224 @@
+/**
+ * Admin 插件通用工具函数
+ */
+
+import { Logger } from 'befly';
+import type { BeflyContext } from 'befly/types/befly';
+import { readdirSync, statSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+
+/**
+ * 递归扫描目录下的所有 .ts 文件
+ * @param dir - 目录路径
+ * @param fileList - 文件列表
+ * @returns 文件路径数组
+ */
+export function scanTsFiles(dir: string, fileList: string[] = []): string[] {
+    try {
+        const files = readdirSync(dir);
+
+        for (const file of files) {
+            const filePath = path.join(dir, file);
+            const stat = statSync(filePath);
+
+            if (stat.isDirectory()) {
+                // 递归扫描子目录
+                scanTsFiles(filePath, fileList);
+            } else if (file.endsWith('.ts') && !file.endsWith('.d.ts')) {
+                fileList.push(filePath);
+            }
+        }
+    } catch (error: any) {
+        Logger.warn(`扫描目录失败: ${dir}`, error.message);
+    }
+
+    return fileList;
+}
+
+/**
+ * 检查数据表是否存在
+ * @param helper - DbHelper 实例
+ * @param tableName - 表名
+ * @returns 是否存在
+ */
+export async function checkTableExists(helper: any, tableName: string): Promise<boolean> {
+    Logger.info('=== 检查数据表 ===');
+    const exists = await helper.tableExists(tableName);
+
+    if (!exists) {
+        Logger.error(`❌ 表 ${tableName} 不存在，请先运行 befly syncDb 同步数据库`);
+        return false;
+    }
+
+    Logger.info(`✅ 表 ${tableName} 存在`);
+    return true;
+}
+
+/**
+ * 删除数据库中不存在于配置的记录
+ * @param helper - DbHelper 实例
+ * @param tableName - 表名
+ * @param configPaths - 配置中的路径集合
+ * @param pathField - 路径字段名（默认为 'path'）
+ * @returns 删除数量
+ */
+export async function deleteObsoleteRecords(helper: any, tableName: string, configPaths: Set<string>, pathField: string = 'path'): Promise<number> {
+    Logger.info(`\n=== 删除配置中不存在的记录 ===`);
+
+    const allRecords = await helper.getAll({
+        table: tableName,
+        fields: ['id', pathField, 'name']
+    });
+
+    let deletedCount = 0;
+    for (const record of allRecords) {
+        if (record[pathField] && !configPaths.has(record[pathField])) {
+            await helper.delData({
+                table: tableName,
+                where: { id: record.id }
+            });
+            deletedCount++;
+            Logger.info(`  └ 删除记录: ${record.name} (ID: ${record.id}, ${pathField}: ${record[pathField]})`);
+        }
+    }
+
+    if (deletedCount === 0) {
+        Logger.info('  ✅ 无需删除的记录');
+    }
+
+    return deletedCount;
+}
+
+/**
+ * 输出同步统计信息
+ * @param stats - 统计对象
+ * @param deletedCount - 删除数量
+ * @param resourceName - 资源名称（如：菜单、接口）
+ */
+export function logSyncStats(stats: { created: number; updated: number }, deletedCount: number, resourceName: string = '记录'): void {
+    Logger.info(`\n=== ${resourceName}同步完成 ===`);
+    Logger.info(`新增${resourceName}: ${stats.created} 个`);
+    Logger.info(`更新${resourceName}: ${stats.updated} 个`);
+    Logger.info(`删除${resourceName}: ${deletedCount} 个`);
+}
+
+/**
+ * 缓存角色权限到 Redis Set（增量更新）
+ * @param befly - Befly 上下文
+ * @param roleCode - 角色代码
+ * @param apiIds - 接口 ID 数组（逗号分隔的字符串）
+ */
+export async function cacheRolePermissions(befly: BeflyContext, roleCode: string, apiIds: string): Promise<void> {
+    try {
+        if (!apiIds) {
+            // 如果没有权限，删除缓存
+            await befly.redis.del(`role:apis:${roleCode}`);
+            Logger.debug(`已删除角色 ${roleCode} 的权限缓存（无权限）`);
+            return;
+        }
+
+        // 解析接口 ID 列表
+        const apiIdArray = apiIds
+            .split(',')
+            .map((id: string) => parseInt(id.trim()))
+            .filter((id: number) => !isNaN(id));
+
+        if (apiIdArray.length === 0) {
+            await befly.redis.del(`role:apis:${roleCode}`);
+            Logger.debug(`已删除角色 ${roleCode} 的权限缓存（ID 列表为空）`);
+            return;
+        }
+
+        // 查询所有接口
+        const allApis = await befly.db.getAll({
+            table: 'addon_admin_api',
+            fields: ['id', 'path', 'method']
+        });
+
+        // 根据 ID 过滤出接口路径
+        const roleApiPaths = allApis.filter((api: any) => apiIdArray.includes(api.id)).map((api: any) => `${api.method}${api.path}`);
+
+        if (roleApiPaths.length === 0) {
+            await befly.redis.del(`role:apis:${roleCode}`);
+            Logger.debug(`已删除角色 ${roleCode} 的权限缓存（无匹配接口）`);
+            return;
+        }
+
+        // 使用 Redis Set 缓存（先删除再添加，确保数据一致性）
+        const redisKey = `role:apis:${roleCode}`;
+        await befly.redis.del(redisKey);
+        const result = await befly.redis.sadd(redisKey, roleApiPaths);
+
+        Logger.debug(`已缓存角色 ${roleCode} 的权限: ${result} 个接口`);
+    } catch (error: any) {
+        Logger.warn(`缓存角色 ${roleCode} 权限失败:`, error?.message || '未知错误');
+    }
+}
+
+/**
+ * 删除角色权限缓存
+ * @param befly - Befly 上下文
+ * @param roleCode - 角色代码
+ */
+export async function deleteRolePermissions(befly: BeflyContext, roleCode: string): Promise<void> {
+    try {
+        await befly.redis.del(`role:apis:${roleCode}`);
+        Logger.debug(`已删除角色 ${roleCode} 的权限缓存`);
+    } catch (error: any) {
+        Logger.warn(`删除角色 ${roleCode} 权限缓存失败:`, error?.message || '未知错误');
+    }
+}
+
+/**
+ * 获取插件列表
+ * @returns 插件列表
+ */
+export function getAddonList(): Array<{ name: string; title: string; version: string; description: string; enabled: boolean }> {
+    const addonList: Array<{ name: string; title: string; version: string; description: string; enabled: boolean }> = [];
+
+    // 获取 addons 目录路径
+    const addonsDir = path.join(process.cwd(), 'addons');
+
+    try {
+        const addonNames = readdirSync(addonsDir);
+
+        for (const addonName of addonNames) {
+            const addonPath = path.join(addonsDir, addonName);
+            const stat = statSync(addonPath);
+
+            // 只处理目录
+            if (!stat.isDirectory()) {
+                continue;
+            }
+
+            // 读取插件配置文件
+            const configPath = path.join(addonPath, 'addon.config.json');
+
+            try {
+                const configContent = readFileSync(configPath, 'utf-8');
+                const config = JSON.parse(configContent);
+
+                addonList.push({
+                    name: config.name || addonName,
+                    title: config.title || addonName,
+                    version: config.version || '1.0.0',
+                    description: config.description || '',
+                    enabled: true
+                });
+            } catch (error) {
+                // 配置文件不存在或解析失败，使用默认值
+                addonList.push({
+                    name: addonName,
+                    title: addonName,
+                    version: '1.0.0',
+                    description: '',
+                    enabled: true
+                });
+            }
+        }
+    } catch (error: any) {
+        Logger.warn(`扫描插件目录失败:`, error?.message || '未知错误');
+    }
+
+    return addonList;
+}