befly 3.9.40 → 3.10.0

package/docs/plugins/plugin.md

@@ -72,7 +72,7 @@ import type { Plugin } from "befly/types/plugin";
 
 const plugin: Plugin = {
     // 依赖的插件列表（可选）
-    after: ["logger", "db"],
+    deps: ["logger", "db"],
 
     // 初始化函数（必填）
     handler: (befly) => {
@@ -96,10 +96,10 @@ interface Plugin {
     name?: string;
 
     /** 依赖的插件列表（在这些插件之后执行） */
-    after?: string[];
+    deps: string[];
 
     /** 插件初始化函数 */
-    handler?: (context: BeflyContext) => any | Promise<any>;
+    handler: (context: BeflyContext) => any | Promise<any>;
 
     /** 插件描述（可选） */
     description?: string;
@@ -171,12 +171,12 @@ interface Plugin {
 
 ### 依赖排序
 
-使用 `after` 属性声明依赖关系：
+使用 `deps` 属性声明依赖关系：
 
 ```typescript
 // redis.ts - 依赖 logger
 const plugin: Plugin = {
-    after: ["logger"], // 在 logger 插件之后初始化
+    deps: ["logger"], // 在 logger 插件之后初始化
     handler: () => {
         /* ... */
     }
@@ -199,7 +199,7 @@ const plugin: Plugin = {
 ```typescript
 // 插件源码
 const loggerPlugin: Plugin = {
-    after: [],
+    deps: [],
     async handler(): Promise<typeof Logger> {
         if (beflyConfig.logger) {
             Logger.configure(beflyConfig.logger);
@@ -250,10 +250,11 @@ const redisConfig = befly.config.redis;
 ```typescript
 // 插件源码
 const dbPlugin: Plugin = {
-    after: ["logger"],
+    deps: ["logger", "redis"],
     async handler(befly: BeflyContext): Promise<DbHelper> {
-        const sql = await Connect.connectSql();
-        return new DbHelper(befly, sql);
+        // 连接由启动期统一完成；插件仅消费已连接实例
+        const sql = Connect.getSql();
+        return new DbHelper({ redis: befly.redis, sql: sql, dialect: new MySqlDialect() });
     }
 };
 ```
@@ -285,9 +286,10 @@ await befly.db.delData({ table: "user", where: { id: 1 } });
 ```typescript
 // 插件源码
 const redisPlugin: Plugin = {
-    after: ["logger"],
+    deps: ["logger"],
     async handler(): Promise<RedisHelper | Record<string, never>> {
-        await Connect.connectRedis();
+        // 连接由启动期统一完成；插件仅校验连接存在
+        Connect.getRedis();
         return new RedisHelper(redisConfig.prefix);
     }
 };
@@ -384,9 +386,9 @@ const decrypted = befly.cipher.decrypt(encrypted);
 ```typescript
 // 插件源码
 const cachePlugin: Plugin = {
-    after: [],
+    deps: ["logger", "redis", "db"],
     async handler(befly: BeflyContext): Promise<CacheHelper> {
-        return new CacheHelper(befly);
+        return new CacheHelper({ db: befly.db, redis: befly.redis });
     }
 };
 ```
@@ -473,7 +475,7 @@ import type { Plugin } from "befly/types/plugin";
 import type { BeflyContext } from "befly/types/befly";
 
 const plugin: Plugin = {
-    after: ["db", "redis"], // 依赖数据库和 Redis
+    deps: ["db", "redis"], // 依赖数据库和 Redis
     handler: (befly: BeflyContext) => {
         return {
             async getUser(id: number) {
@@ -513,7 +515,7 @@ import type { Plugin } from "befly/types/plugin";
 import { Client } from "@elastic/elasticsearch";
 
 const plugin: Plugin = {
-    after: ["logger", "config"],
+    deps: ["logger", "config"],
     async handler(befly) {
         const config = befly.config.elasticsearch || {};
 
@@ -580,7 +582,7 @@ class SmsHelper {
 }
 
 const plugin: Plugin = {
-    after: ["logger", "config"],
+    deps: ["logger", "config"],
     handler: (befly: BeflyContext) => {
         const smsConfig = befly.config.sms || {};
         return new SmsHelper(befly, smsConfig);
@@ -688,7 +690,7 @@ class EmailHelper {
  * 邮件插件
  */
 const emailPlugin: Plugin = {
-    after: ["db", "logger", "config"],
+    deps: ["db", "logger", "config"],
     async handler(befly: BeflyContext): Promise<EmailHelper> {
         const emailConfig = befly.config?.addons?.admin?.email || {};
         return new EmailHelper(befly, emailConfig);
@@ -801,7 +803,7 @@ class WechatPayHelper {
 }
 
 const plugin: Plugin = {
-    after: ["logger", "config"],
+    deps: ["logger", "config"],
     handler: (befly: BeflyContext) => {
         return new WechatPayHelper(befly);
     }
@@ -851,7 +853,7 @@ const plugin: Plugin = {
 ```typescript
 // ✅ 推荐：明确声明所有依赖
 const plugin: Plugin = {
-    after: ["logger", "db", "redis"], // 声明所有使用的插件
+    deps: ["logger", "db", "redis"], // 声明所有使用的插件
     handler: (befly) => {
         /* ... */
     }
@@ -929,7 +931,7 @@ class DatabasePool {
 插件按以下顺序加载：
 
 1. 核心插件 → Addon 插件 → 项目插件
-2. 同一类型内根据 `after` 依赖关系排序
+2. 同一类型内根据 `deps` 依赖关系排序
 3. 无依赖的插件按文件名字母顺序
 
 ### Q2: 如何在插件中访问其他插件？
@@ -938,7 +940,7 @@ class DatabasePool {
 
 ```typescript
 const plugin: Plugin = {
-    after: ["db"], // 声明依赖
+    deps: ["db"], // 声明依赖
     handler: (befly) => {
         return {
             async getUser(id: number) {

package/docs/quickstart.md

@@ -208,15 +208,24 @@ CREATE DATABASE my_api CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
 
 ## 同步数据库
 
-### 运行同步命令
+### 自动同步
 
-```bash
-# 全量同步（表结构 + API + 菜单 + 开发账户）
-bun befly sync
+服务启动时会在**主进程**自动执行同步流程：
+
+1. `syncTable()`：同步表结构
+2. `syncData()`：固定顺序执行 `syncApi` → `syncMenu` → `syncDev`
 
-# 或单独同步
-bun befly sync:db      # 只同步表结构
-bun befly sync:api     # 只同步 API 路由
+如需手动触发，可在代码中调用（一般不建议在请求路径中调用）：
+
+```typescript
+import { syncData } from "../sync/syncData.js";
+import { syncTable } from "../sync/syncTable.js";
+import { scanSources } from "../utils/scanSources.js";
+
+// ctx：BeflyContext（需已具备 ctx.db / ctx.redis / ctx.config）
+const sources = await scanSources();
+await syncTable(ctx, sources.tables);
+await syncData();
 ```
 
 ### 验证同步结果
@@ -299,8 +308,6 @@ curl -X POST http://localhost:3000/api/user/login \
 ```bash
 # 开发
 bun run dev          # 启动开发服务
-bun befly sync       # 同步数据库
-bun befly sync:db    # 只同步表结构
 
 # 生产
 bun run build        # 构建

package/docs/reference/addon.md

@@ -467,7 +467,18 @@ A: 在配置文件中设置：
 
 ### Q: Addon 的表如何迁移？
 
-A: 使用 `befly sync:db` 命令，会自动同步所有 Addon 的表定义。
+A: 服务启动时（主进程）会自动执行 `syncTable()`，会同步项目与所有 Addon 的表定义。
+
+如需手动触发：
+
+```typescript
+import { syncTable } from "../../sync/syncTable.js";
+import { scanSources } from "../../utils/scanSources.js";
+
+// ctx：BeflyContext（需已具备 ctx.db / ctx.redis / ctx.config）
+const sources = await scanSources();
+await syncTable(ctx, sources.tables);
+```
 
 ### Q: 如何在 Addon 中访问项目配置？
 

package/docs/reference/config.md

@@ -207,14 +207,14 @@ befly.development.json 或 befly.production.json（环境配置）
 
 ### Redis 配置 (redis)
 
-| 配置项     | 类型   | 默认值          | 说明             |
-| ---------- | ------ | --------------- | ---------------- |
-| `host`     | string | `'127.0.0.1'`   | Redis 主机       |
-| `port`     | number | `6379`          | Redis 端口       |
-| `username` | string | `''`            | Redis 用户名     |
-| `password` | string | `''`            | Redis 密码       |
-| `db`       | number | `0`             | Redis 数据库索引 |
-| `prefix`   | string | `'befly_demo:'` | Redis Key 前缀   |
+| 配置项     | 类型   | 默认值         | 说明                                                   |
+| ---------- | ------ | -------------- | ------------------------------------------------------ |
+| `host`     | string | `'127.0.0.1'`  | Redis 主机                                             |
+| `port`     | number | `6379`         | Redis 端口                                             |
+| `username` | string | `''`           | Redis 用户名                                           |
+| `password` | string | `''`           | Redis 密码                                             |
+| `db`       | number | `0`            | Redis 数据库索引                                       |
+| `prefix`   | string | `'befly_demo'` | Redis Key 前缀（不允许包含 `:`，分隔符由系统自动拼接） |
 
 ```json
 {
@@ -223,7 +223,7 @@ befly.development.json 或 befly.production.json（环境配置）
         "port": 6379,
         "password": "redis_password",
         "db": 1,
-        "prefix": "myapp:"
+        "prefix": "myapp"
     }
 }
 ```
@@ -295,13 +295,11 @@ befly.development.json 或 befly.production.json（环境配置）
 | ---------------- | -------- | ------ | -------------- |
 | `disableHooks`   | string[] | `[]`   | 禁用的钩子列表 |
 | `disablePlugins` | string[] | `[]`   | 禁用的插件列表 |
-| `hiddenMenus`    | string[] | `[]`   | 隐藏的菜单路径 |
 
 ```json
 {
     "disableHooks": ["requestLogger"],
-    "disablePlugins": ["redis"],
-    "hiddenMenus": ["/admin/debug", "/admin/test"]
+    "disablePlugins": ["redis"]
 }
 ```
 
@@ -464,30 +462,15 @@ export default {
 ### 在插件中访问
 
 ```typescript
-import { beflyConfig } from "../befly.config.js";
-
 const plugin: Plugin = {
-    handler: () => {
-        const port = beflyConfig.appPort;
-        const dbConfig = beflyConfig.db;
+    handler: (context) => {
+        const port = context.config.appPort;
+        const dbConfig = context.config.db;
         // ...
     }
 };
 ```
 
-### 直接导入（仅 Befly 源码/单仓内）
-
-> 说明：`befly` 包的 `exports` 仅暴露 `befly`、`befly/lib/*`、`befly/utils/*`、`befly/types/*`。
-> 因此不支持 `befly/befly.config` 这种子路径导入。
-
-如果你在 Befly 源码/单仓内开发（例如编写内置插件/命令），可以使用相对路径导入：
-
-```typescript
-import { beflyConfig } from "../befly.config.js";
-
-console.log(beflyConfig.appName);
-```
-
 ---
 
 ## 最佳实践

package/docs/reference/sync.md

@@ -1,16 +1,14 @@
-# Sync 同步命令
+# Sync 同步流程
 
 > 数据库结构、API路由、菜单配置、开发账户同步
 
 ## 目录
 
 - [概述](#概述)
-- [syncAll 全量同步](#syncall-全量同步)
-- [syncDb 数据库同步](#syncdb-数据库同步)
+- [syncTable 数据库同步](#synctable-数据库同步)
 - [syncApi 接口同步](#syncapi-接口同步)
 - [syncMenu 菜单同步](#syncmenu-菜单同步)
 - [syncDev 开发账户同步](#syncdev-开发账户同步)
-- [命令行使用](#命令行使用)
 - [表名规则](#表名规则)
 - [注意事项](#注意事项)
 - [FAQ](#faq)
@@ -21,103 +19,52 @@
 
 Sync 同步系统用于将代码定义同步到数据库，包括：
 
-| 命令       | 功能              | 目标表                                  |
-| ---------- | ----------------- | --------------------------------------- |
-| `syncDb`   | 同步表结构定义    | 所有业务表                              |
-| `syncApi`  | 同步 API 路由信息 | `addon_admin_api`                       |
-| `syncMenu` | 同步菜单配置      | `addon_admin_menu`                      |
-| `syncDev`  | 创建开发者账户    | `addon_admin_role`, `addon_admin_admin` |
-| `syncAll`  | 依次执行以上全部  | -                                       |
+| 命令        | 功能              | 目标表                                  |
+| ----------- | ----------------- | --------------------------------------- |
+| `syncTable` | 同步表结构定义    | 所有业务表                              |
+| `syncApi`   | 同步 API 路由信息 | `addon_admin_api`                       |
+| `syncMenu`  | 同步菜单配置      | `addon_admin_menu`                      |
+| `syncDev`   | 创建开发者账户    | `addon_admin_role`, `addon_admin_admin` |
 
-**执行顺序**：`checkApp` → `syncDb` → `syncApi` → `syncMenu` → `syncDev`
+**执行顺序**：`syncTable` → `syncApi` → `syncMenu` → `syncDev`
 
----
-
-## syncAll 全量同步
-
-一键执行所有同步命令：
-
-```bash
-# 执行全量同步
-befly sync
-
-# 等同于依次执行：
-# 1. checkApp - 检查应用配置
-# 2. syncDb   - 同步数据库表结构
-# 3. syncApi  - 同步 API 路由
-# 4. syncMenu - 同步菜单配置
-# 5. syncDev  - 同步开发账户
-```
-
-**执行流程**：
-
-```
-┌──────────────────────────────────────────────────┐
-│                  syncAll                         │
-├──────────────────────────────────────────────────┤
-│  1. checkApp()      检查应用配置是否完整          │
-│         ↓                                        │
-│  2. syncDbCommand() 同步数据库表结构              │
-│         ↓                                        │
-│  3. syncApiCommand() 同步 API 路由到数据库        │
-│         ↓                                        │
-│  4. syncMenuCommand() 同步菜单配置到数据库        │
-│         ↓                                        │
-│  5. syncDevCommand() 创建/更新开发者账户          │
-└──────────────────────────────────────────────────┘
-```
+> 说明：当前版本不提供 CLI 同步命令；同步逻辑在服务启动时由主进程自动执行（见 `packages/core/main.ts`）。
 
 ---
 
-## syncDb 数据库同步
+## syncTable 数据库同步
 
 将 `tables/*.json` 表定义同步到数据库结构。
 
 ### 基本用法
 
-```bash
-# 同步所有表
-befly sync:db
-
-# 只同步指定表
-befly sync:db --table user
+默认会在服务启动时自动执行（仅主进程）。如需在代码中手动执行：
 
-# 强制模式（允许破坏性操作）
-befly sync:db --force
+```typescript
+import { syncTable } from "../sync/syncTable.js";
+import { scanSources } from "../utils/scanSources.js";
 
-# 预览模式（仅显示变更，不执行）
-befly sync:db --dry-run
+// ctx：BeflyContext（需已具备 ctx.db / ctx.redis / ctx.config）
+const sources = await scanSources();
+await syncTable(ctx, sources.tables);
 ```
 
 ### 命令选项
 
-| 选项        | 类型    | 默认值 | 说明                 |
-| ----------- | ------- | ------ | -------------------- |
-| `--table`   | string  | -      | 只同步指定表         |
-| `--force`   | boolean | false  | 强制模式，允许删除列 |
-| `--dry-run` | boolean | false  | 预览模式，不实际执行 |
+无
 
 ### 同步逻辑
 
 ```
 ┌─────────────────────────────────────────────────────┐
-│                    syncDb                           │
+│                  syncTable                          │
 ├─────────────────────────────────────────────────────┤
-│  1. 设置数据库类型 (setDbType)                       │
-│  2. 检查表定义完整性 (checkTable)                    │
-│  3. 连接数据库 (Connect.connectSql)                 │
-│  4. 确保版本表存在 (ensureDbVersion)                 │
-│         ↓                                           │
-│  5. 扫描表定义文件：                                 │
-│     - 项目表：tpl/tables/*.json                     │
-│     - Addon 表：addons/*/tables/*.json              │
-│         ↓                                           │
-│  6. 对每个表：                                       │
+│  1. 校验 ctx.db / ctx.redis / ctx.config             │
+│  2. 检查数据库版本 (ensureDbVersion)                 │
+│  3. 同步传入的表定义列表（通常来自 scanSources）      │
 │     ├── 表存在？→ modifyTable (修改)                │
 │     └── 表不存在？→ createTable (新建)              │
-│         ↓                                           │
-│  7. 清理 Redis 缓存 (tableColumns)                  │
-│  8. 关闭数据库连接                                   │
+│  4. 清理 Redis 缓存 (tableColumns)                  │
 └─────────────────────────────────────────────────────┘
 ```
 
@@ -156,19 +103,15 @@ befly sync:db --dry-run
 
 ### 基本用法
 
-```bash
-# 同步 API 路由
-befly sync:api
+通常无需单独调用：`syncData()` 会按顺序执行 `syncApi` → `syncMenu` → `syncDev`。
 
-# 预览模式
-befly sync:api --plan
-```
+如需在代码中手动触发整套数据同步：
 
-### 命令选项
+```typescript
+import { syncData } from "../sync/syncData.js";
 
-| 选项     | 类型    | 默认值 | 说明                   |
-| -------- | ------- | ------ | ---------------------- |
-| `--plan` | boolean | false  | 预览模式，显示变更计划 |
+await syncData();
+```
 
 ### 同步逻辑
 
@@ -228,19 +171,7 @@ interface SyncApiStats {
 
 ### 基本用法
 
-```bash
-# 同步菜单
-befly sync:menu
-
-# 预览模式
-befly sync:menu --plan
-```
-
-### 命令选项
-
-| 选项     | 类型    | 默认值 | 说明                   |
-| -------- | ------- | ------ | ---------------------- |
-| `--plan` | boolean | false  | 预览模式，显示变更计划 |
+同 `syncApi`，通常由 `syncData()` 统一触发。
 
 ### 菜单配置文件
 
@@ -325,19 +256,7 @@ interface SyncMenuStats {
 
 ### 基本用法
 
-```bash
-# 同步开发账户
-befly sync:dev
-
-# 预览模式
-befly sync:dev --plan
-```
-
-### 命令选项
-
-| 选项     | 类型    | 默认值 | 说明                   |
-| -------- | ------- | ------ | ---------------------- |
-| `--plan` | boolean | false  | 预览模式，显示变更计划 |
+同 `syncApi`，通常由 `syncData()` 统一触发。
 
 ### 同步逻辑
 
@@ -379,50 +298,24 @@ export default {
 };
 ```
 
-**注意**：此命令仅用于开发环境，生产环境应通过正式流程创建管理员。
+await syncTable(ctx, sources.tables);
 
 ---
 
-## 命令行使用
-
-### CLI 命令列表
+## 代码调用
 
-```bash
-# 全量同步
-befly sync
-
-# 单独执行
-befly sync:db              # 同步数据库结构
-befly sync:api             # 同步 API 路由
-befly sync:menu            # 同步菜单配置
-befly sync:dev             # 同步开发账户
-
-# 带参数
-befly sync:db --table user     # 只同步 user 表
-befly sync:db --force          # 强制模式
-befly sync:db --dry-run        # 预览模式
-befly sync:api --plan          # 预览 API 变更
-befly sync:menu --plan         # 预览菜单变更
-befly sync:dev --plan          # 预览开发账户变更
-```
+```typescript
+import { syncTable } from "./sync/syncTable.js";
+import { scanSources } from "./utils/scanSources.js";
+import { syncData } from "./sync/syncData";
 
-### 代码调用
+// 启动前/启动中手动触发同步
+// ctx：BeflyContext（需已具备 ctx.db / ctx.redis / ctx.config）
+const sources = await scanSources();
+await syncTable(ctx, sources.tables);
+await syncData();
 
-```typescript
-import { syncAllCommand } from "./sync/syncAll";
-import { syncDbCommand } from "./sync/syncDb";
-import { syncApiCommand } from "./sync/syncApi";
-import { syncMenuCommand } from "./sync/syncMenu";
-import { syncDevCommand } from "./sync/syncDev";
-
-// 全量同步
-await syncAllCommand();
-
-// 单独调用
-await syncDbCommand({ table: "user" });
-await syncApiCommand({ plan: true });
-await syncMenuCommand({ plan: true });
-await syncDevCommand({ plan: true });
+// 说明：syncData 内部会固定顺序执行：syncApi → syncMenu → syncDev
 ```
 
 ---
@@ -464,29 +357,27 @@ addons/demo/tables/article.json   → addon_demo_article
 
 ### 1. 执行顺序
 
-**必须按顺序执行**：`syncDb` → `syncApi` → `syncMenu` → `syncDev`
+**必须按顺序执行**：`syncTable` → `syncApi` → `syncMenu` → `syncDev`
 
-- `syncApi` 依赖 `addon_admin_api` 表（由 `syncDb` 创建）
-- `syncMenu` 依赖 `addon_admin_menu` 表（由 `syncDb` 创建）
+- `syncApi` 依赖 `addon_admin_api` 表（由 `syncTable` 创建）
+- `syncMenu` 依赖 `addon_admin_menu` 表（由 `syncTable` 创建）
 - `syncDev` 依赖角色表和权限数据（由前面命令创建）
 
 ### 2. 破坏性操作
 
-默认模式下，`syncDb` **不会删除列**，只会：
+默认模式下，`syncTable` **不会删除列**，只会：
 
 - 新增缺失的列
 - 修改现有列的类型/默认值
 
-使用 `--force` 参数允许删除列：
+此外，`syncTable` **不会执行长度收缩等可能导致数据截断的危险变更**：
 
-```bash
-# 谨慎使用！会删除数据库中存在但定义中不存在的列
-befly sync:db --force
-```
+- 例如：`VARCHAR(200)` → `VARCHAR(50)`
+- 这类变更会被跳过，并输出告警；需要手动评估并处理
 
 ### 3. 缓存清理
 
-`syncDb` 执行后会自动清理 Redis 中的表结构缓存：
+`syncTable` 执行后会自动清理 Redis 中的表结构缓存：
 
 ```typescript
 // 自动清理以下缓存键
@@ -501,23 +392,13 @@ Sync 命令会自动管理数据库和 Redis 连接：
 - 执行后关闭连接
 - 出错时正确清理资源
 
-### 5. 预览模式
-
-使用 `--dry-run` 或 `--plan` 参数可以预览变更而不实际执行：
-
-```bash
-befly sync:db --dry-run   # 预览数据库结构变更
-befly sync:api --plan     # 预览 API 变更
-befly sync:menu --plan    # 预览菜单变更
-```
-
 ---
 
 ## FAQ
 
 ### Q: sync 命令报错 "表不存在" 怎么办？
 
-A: 确保先执行 `befly sync:db` 创建表结构，再执行其他 sync 命令。或直接使用 `befly sync` 执行全量同步。
+A: 确保 `syncTable()` 已先执行（服务启动时会自动执行）。`syncApi/syncMenu/syncDev` 依赖对应的表结构存在。
 
 ### Q: 为什么修改了表定义但数据库没变化？
 
@@ -526,17 +407,11 @@ A: 检查以下几点：
 1. JSON 文件语法是否正确
 2. 字段定义格式是否正确
 3. 是否保存了文件
-4. 尝试使用 `--dry-run` 查看预期变更
-
-### Q: 如何删除数据库中不需要的列？
+4. 确认表定义文件与配置已保存
 
-A: 使用 `--force` 参数：
+### Q: 如何处理“字段长度收缩”这类危险变更？
 
-```bash
-befly sync:db --force
-```
-
-**警告**：这会删除表定义中不存在的列及其数据，请先备份。
+A: `syncTable()` 会跳过长度收缩并告警；请手动评估并处理（例如先清理/截断数据，再手动执行 DDL），再重新启动服务或再次调用 `syncTable()`。
 
 ### Q: Addon 表名太长怎么办？
 
@@ -551,16 +426,13 @@ A: Addon 表名格式为 `addon_{addonName}_{tableName}`，建议：
 A:
 
 1. 检查错误日志确定失败原因
-2. 修复问题后重新执行 sync 命令
-3. sync 命令是幂等的，可以安全地多次执行
+   A: `syncTable()` 会跳过长度收缩并告警；请手动评估并处理（例如先清理/截断数据，再手动执行 DDL），再重新启动服务或再次调用 `syncTable()`。
+2. sync 命令是幂等的，可以安全地多次执行
 
 ### Q: 如何只同步某个 Addon 的表？
 
-A: 目前不支持按 Addon 筛选，可以使用 `--table` 参数同步单个表：
-
-```bash
-befly sync:db --table addon_admin_role
-```
+await syncTable(ctx, sources.tables);
+A: 当前不支持按 Addon 或单表筛选；会同步项目与所有 Addon 的表定义。
 
 ### Q: 开发账户密码在哪里配置？
 
@@ -576,8 +448,5 @@ export default {
 };
 ```
 
-或使用环境变量：
-
-```bash
-DEV_PASSWORD=your_password befly sync:dev
-```
+（不再提供 CLI 参数/命令；按配置文件机制设置即可。）
+await syncTable(ctx, sources.tables);