befly 3.9.40 → 3.10.1

package/docs/reference/logger.md

@@ -98,8 +98,8 @@ Logger.info("用户登录成功");
 Logger.info({ userId: 123 }, "用户登录成功");
 
 // 警告日志
-Logger.warn("配置项已弃用");
-Logger.warn({ config: "oldOption" }, "配置项已弃用");
+Logger.warn("配置项不合法");
+Logger.warn({ config: "oldOption" }, "配置项不合法");
 
 // 错误日志
 Logger.error("数据库连接失败");
@@ -393,7 +393,7 @@ Logger.debug({ sql: query, params: params }, "SQL 查询");
 Logger.info({ userId: 123 }, "用户登录成功");
 
 // warn: 潜在问题，但不影响功能
-Logger.warn({ config: "deprecated" }, "配置项已弃用");
+Logger.warn({ config: "invalidOption" }, "配置项不合法");
 
 // error: 操作失败
 Logger.error({ err: error }, "数据库连接失败");

package/docs/reference/sync.md

@@ -1,16 +1,16 @@
-# Sync 同步命令
+# Sync 同步流程
 
 > 数据库结构、API路由、菜单配置、开发账户同步
 
 ## 目录
 
 - [概述](#概述)
-- [syncAll 全量同步](#syncall-全量同步)
-- [syncDb 数据库同步](#syncdb-数据库同步)
+- [强约束清单](#强约束清单)
+- [syncTable 数据库同步](#synctable-数据库同步)
 - [syncApi 接口同步](#syncapi-接口同步)
 - [syncMenu 菜单同步](#syncmenu-菜单同步)
 - [syncDev 开发账户同步](#syncdev-开发账户同步)
-- [命令行使用](#命令行使用)
+- [syncCache 缓存同步](#synccache-缓存同步)
 - [表名规则](#表名规则)
 - [注意事项](#注意事项)
 - [FAQ](#faq)
@@ -21,103 +21,62 @@
 
 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` |
+| `syncCache` | 同步缓存          | Redis（apis/menu/role-permissions）     |
 
-**执行顺序**：`checkApp` → `syncDb` → `syncApi` → `syncMenu` → `syncDev`
+**执行顺序**：`syncTable` → `syncApi` → `syncMenu` → `syncDev` → `syncCache`
 
 ---
 
-## syncAll 全量同步
+## 强约束清单
 
-一键执行所有同步命令：
+- **API routePath 必须是 pathname**：`syncApi` 写入数据库的 `routePath` 仅允许 `url.pathname`（例如 `/api/user/login`），禁止出现 method 前缀（`POST/api/...`、`POST /api/...`）。
+- **角色权限 apis 仅允许 pathname 字符串数组**：`syncDev` 写入角色表的 `apis` 必须是 pathname 字符串数组（严格模式不允许 numeric id）。
+- **权限缓存 Set member 仅允许 pathname**：角色接口权限缓存的 Set 成员为 pathname，与 method 无关。
+- **Redis prefix 不允许包含冒号**：配置 `redis.prefix` 不要包含 `:`（系统会自动拼接分隔符）。例如写 `befly`，不要写 `befly:`。
 
-```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.cache / 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 +115,17 @@ befly sync:db --dry-run
 
 ### 基本用法
 
-```bash
-# 同步 API 路由
-befly sync:api
+通常无需单独调用：服务启动流程会按顺序执行 `syncTable` → `syncApi` → `syncMenu` → `syncDev` → `syncCache`。
 
-# 预览模式
-befly sync:api --plan
-```
+如需在代码中手动调用：
 
-### 命令选项
+```typescript
+import { syncApi } from "../sync/syncApi.js";
+import { scanSources } from "../utils/scanSources.js";
 
-| 选项     | 类型    | 默认值 | 说明                   |
-| -------- | ------- | ------ | ---------------------- |
-| `--plan` | boolean | false  | 预览模式，显示变更计划 |
+const sources = await scanSources();
+await syncApi(ctx, sources.apis as any);
+```
 
 ### 同步逻辑
 
@@ -194,20 +151,15 @@ befly sync:api --plan
 └─────────────────────────────────────────────────────┘
 ```
 
-### API 信息提取
+### 存储字段（重要）
 
-从 API 文件中提取以下信息：
+`syncApi` 会把扫描到的 API 信息同步到 `addon_admin_api` 表，核心字段为：
 
-```typescript
-interface ApiInfo {
-    name: string; // 接口名称（name 属性）
-    path: string; // 路由路径（由文件路径生成）
-    method: string; // 请求方法（method 属性，默认 POST）
-    description: string; // 接口描述（desc 属性）
-    addonName: string; // 所属 Addon 名称
-    addonTitle: string; // Addon 标题
-}
-```
+- `routePath`：只存 `url.pathname`（例如 `/api/user/login`），与 method 无关
+- `name`：接口名称
+- `addonName`：所属 addon（无 addon 时为空字符串）
+
+> 注意：`routePath` 必须是 pathname（以 `/` 开头），不允许写成 `POST /api/...` 或 `POST/api/...`。
 
 ### 统计信息
 
@@ -228,19 +180,19 @@ interface SyncApiStats {
 
 ### 基本用法
 
-```bash
-# 同步菜单
-befly sync:menu
+同 `syncApi`，通常由启动流程统一触发。
 
-# 预览模式
-befly sync:menu --plan
-```
+如需手动调用，需要先对菜单配置做校验/过滤（例如 disableMenus）：
 
-### 命令选项
+```typescript
+import { checkMenu } from "../checks/checkMenu.js";
+import { syncMenu } from "../sync/syncMenu.js";
+import { scanSources } from "../utils/scanSources.js";
 
-| 选项     | 类型    | 默认值 | 说明                   |
-| -------- | ------- | ------ | ---------------------- |
-| `--plan` | boolean | false  | 预览模式，显示变更计划 |
+const sources = await scanSources();
+const checkedMenus = await checkMenu(sources.addons, { disableMenus: ctx.config.disableMenus || [] });
+await syncMenu(ctx, checkedMenus);
+```
 
 ### 菜单配置文件
 
@@ -325,104 +277,80 @@ interface SyncMenuStats {
 
 ### 基本用法
 
-```bash
-# 同步开发账户
-befly sync:dev
-
-# 预览模式
-befly sync:dev --plan
-```
-
-### 命令选项
-
-| 选项     | 类型    | 默认值 | 说明                   |
-| -------- | ------- | ------ | ---------------------- |
-| `--plan` | boolean | false  | 预览模式，显示变更计划 |
+同 `syncApi`，通常由启动流程统一触发。
 
 ### 同步逻辑
 
 ```
 ┌─────────────────────────────────────────────────────┐
-│                   syncDev                           │
+│ syncDev │
 ├─────────────────────────────────────────────────────┤
-│  1. 创建/更新开发角色：                              │
-│     - 角色名称：开发者                              │
-│     - 角色标识：dev                                 │
-│     - 权限：所有菜单 + 所有 API                     │
-│         ↓                                           │
-│  2. 获取所有菜单 ID 列表                            │
-│         ↓                                           │
-│  3. 获取所有 API ID 列表                            │
-│         ↓                                           │
-│  4. 更新角色权限：                                   │
-│     - menus: 所有菜单 ID                           │
-│     - apis: 所有 API ID                            │
-│         ↓                                           │
-│  5. 创建/更新开发管理员：                            │
-│     - 用户名：dev                                   │
-│     - 密码：从配置读取                              │
-│     - 角色：开发者角色                              │
+│ 1. 创建/更新开发角色： │
+│ - 角色名称：开发者 │
+│ - 角色标识：dev │
+│ - 权限：所有菜单 + 所有 API │
+│ ↓ │
+│ 2. 获取所有菜单 path 列表 │
+│ ↓ │
+│ 3. 获取所有 API routePath 列表 │
+│ ↓ │
+│ 4. 更新角色权限： │
+│ - menus: 所有菜单 path（字符串数组） │
+│ - apis: 所有 API routePath（pathname 字符串数组）│
+│ ↓ │
+│ 5. 创建/更新开发管理员： │
+│ - 用户名：dev │
+│ - 密码：从配置读取 │
+│ - 角色：开发者角色 │
 └─────────────────────────────────────────────────────┘
 ```
 
 ### 配置说明
 
-开发账户配置在 `befly.config.ts` 或环境配置文件中：
+开发账户配置在 `befly.config.ts` 或环境配置文件中（仅当 `devPassword` 有值时才会创建 dev 账号）：
 
-```typescript
-// befly.config.ts
-export default {
-    dev: {
-        username: "dev", // 开发账户用户名
-        password: "dev123456" // 开发账户密码
-    }
-};
+```json
+{
+    "devEmail": "dev@qq.com",
+    "devPassword": "beflydev123456"
+}
 ```
 
-**注意**：此命令仅用于开发环境，生产环境应通过正式流程创建管理员。
+> 注意：`syncDev` 会把 `menus/apis` 写入角色表，并且 `apis` 必须是 pathname 字符串数组（严格模式下不允许 numeric id）。
 
 ---
 
-## 命令行使用
+## syncCache 缓存同步
 
-### CLI 命令列表
+同步缓存（统一收敛到启动流程末尾执行）：
 
-```bash
-# 全量同步
-befly sync
+- `cacheApis()`：缓存接口列表
+- `cacheMenus()`：缓存菜单列表
+- `rebuildRoleApiPermissions()`：重建角色接口权限 Set（member 为 pathname，与 method 无关）
 
-# 单独执行
-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 { 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 });
+import { syncTable } from "./sync/syncTable.js";
+import { syncApi } from "./sync/syncApi.js";
+import { syncCache } from "./sync/syncCache.js";
+import { syncDev } from "./sync/syncDev.js";
+import { syncMenu } from "./sync/syncMenu.js";
+import { scanSources } from "./utils/scanSources.js";
+import { checkMenu } from "./checks/checkMenu.js";
+
+// 启动前/启动中手动触发同步
+// ctx：BeflyContext（需已具备 ctx.db / ctx.redis / ctx.cache / ctx.config）
+const sources = await scanSources();
+const checkedMenus = await checkMenu(sources.addons, { disableMenus: ctx.config.disableMenus || [] });
+
+await syncTable(ctx, sources.tables);
+await syncApi(ctx, sources.apis as any);
+await syncMenu(ctx, checkedMenus);
+await syncDev(ctx, { devEmail: ctx.config.devEmail, devPassword: ctx.config.devPassword });
+await syncCache(ctx);
 ```
 
 ---
@@ -464,29 +392,27 @@ addons/demo/tables/article.json   → addon_demo_article
 
 ### 1. 执行顺序
 
-**必须按顺序执行**：`syncDb` → `syncApi` → `syncMenu` → `syncDev`
+**必须按顺序执行**：`syncTable` → `syncApi` → `syncMenu` → `syncDev` → `syncCache`
 
-- `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
 // 自动清理以下缓存键
@@ -495,21 +421,10 @@ CacheKeys.tableColumns(tableName); // table:columns:{tableName}
 
 ### 4. 连接管理
 
-Sync 命令会自动管理数据库和 Redis 连接：
+`sync*` 函数本身不会负责建立连接/加载插件：
 
-- 执行前建立连接
-- 执行后关闭连接
-- 出错时正确清理资源
-
-### 5. 预览模式
-
-使用 `--dry-run` 或 `--plan` 参数可以预览变更而不实际执行：
-
-```bash
-befly sync:db --dry-run   # 预览数据库结构变更
-befly sync:api --plan     # 预览 API 变更
-befly sync:menu --plan    # 预览菜单变更
-```
+- 你需要在调用前确保 `Connect.connect(...)` 已执行，并且 `Db/Redis/cache` 插件已注入到 `ctx`。
+- 服务启动流程已内置这套顺序（见 `packages/core/main.ts`）。
 
 ---
 
@@ -517,7 +432,7 @@ befly sync:menu --plan    # 预览菜单变更
 
 ### Q: sync 命令报错 "表不存在" 怎么办？
 
-A: 确保先执行 `befly sync:db` 创建表结构，再执行其他 sync 命令。或直接使用 `befly sync` 执行全量同步。
+A: 确保 `syncTable()` 已先执行（服务启动时会自动执行）。`syncApi/syncMenu/syncDev` 依赖对应的表结构存在。
 
 ### Q: 为什么修改了表定义但数据库没变化？
 
@@ -526,17 +441,11 @@ A: 检查以下几点：
 1. JSON 文件语法是否正确
 2. 字段定义格式是否正确
 3. 是否保存了文件
-4. 尝试使用 `--dry-run` 查看预期变更
-
-### Q: 如何删除数据库中不需要的列？
+4. 确认表定义文件与配置已保存
 
-A: 使用 `--force` 参数：
-
-```bash
-befly sync:db --force
-```
+### Q: 如何处理“字段长度收缩”这类危险变更？
 
-**警告**：这会删除表定义中不存在的列及其数据，请先备份。
+A: `syncTable()` 会跳过长度收缩并告警；请手动评估并处理（例如先清理/截断数据，再手动执行 DDL），再重新启动服务或再次调用 `syncTable()`。
 
 ### Q: Addon 表名太长怎么办？
 
@@ -550,34 +459,20 @@ A: Addon 表名格式为 `addon_{addonName}_{tableName}`，建议：
 
 A:
 
-1. 检查错误日志确定失败原因
-2. 修复问题后重新执行 sync 命令
-3. sync 命令是幂等的，可以安全地多次执行
+1. 检查错误日志确定失败原因（例如表不存在、字段变更被跳过等）
+2. sync 命令是幂等的，可以安全地多次执行
 
 ### Q: 如何只同步某个 Addon 的表？
 
-A: 目前不支持按 Addon 筛选，可以使用 `--table` 参数同步单个表：
-
-```bash
-befly sync:db --table addon_admin_role
-```
+A: 当前不支持按 Addon 或单表筛选；会同步项目与所有 Addon 的表定义。
 
 ### Q: 开发账户密码在哪里配置？
 
-A: 在配置文件中设置：
-
-```typescript
-// befly.config.ts
-export default {
-    dev: {
-        username: "dev",
-        password: "your_password"
-    }
-};
-```
-
-或使用环境变量：
+A: 在配置文件中设置（仅当 `devPassword` 有值时才会创建 dev 账号）：
 
-```bash
-DEV_PASSWORD=your_password befly sync:dev
+```json
+{
+    "devEmail": "dev@qq.com",
+    "devPassword": "beflydev123456"
+}
 ```

package/docs/reference/table.md

@@ -37,7 +37,7 @@
         - [字段名规范](#字段名规范)
         - [类型联动校验](#类型联动校验)
     - [数据库同步](#数据库同步)
-        - [同步命令](#同步命令)
+        - [触发方式](#触发方式)
         - [同步流程](#同步流程)
         - [变更检测](#变更检测)
         - [安全机制](#安全机制)
@@ -429,13 +429,13 @@ interface FieldDefinition {
 
 以下字段由系统自动创建和管理，**不能**在表定义中使用：
 
-| 字段名       | 类型      | 说明                     |
-| ------------ | --------- | ------------------------ |
-| `id`         | `BIGINT`  | 主键 ID，自增            |
-| `created_at` | `BIGINT`  | 创建时间戳（毫秒）       |
-| `updated_at` | `BIGINT`  | 更新时间戳（毫秒）       |
-| `deleted_at` | `BIGINT`  | 删除时间戳（软删除标记） |
-| `state`      | `TINYINT` | 状态字段                 |
+| 字段名       | 类型     | 说明                     |
+| ------------ | -------- | ------------------------ |
+| `id`         | `BIGINT` | 主键 ID，自增            |
+| `created_at` | `BIGINT` | 创建时间戳（毫秒）       |
+| `updated_at` | `BIGINT` | 更新时间戳（毫秒）       |
+| `deleted_at` | `BIGINT` | 删除时间戳（软删除标记） |
+| `state`      | `BIGINT` | 状态字段                 |
 
 **系统自动创建的索引：**
 
@@ -510,20 +510,19 @@ interface FieldDefinition {
 
 ## 数据库同步
 
-### 同步命令
+### 触发方式
 
-```bash
-# 同步所有表
-bun run sync:db
+服务启动时会在**主进程**自动执行 `syncTable()`。
 
-# 同步指定表
-bun run sync:db --table=user
+如需在代码中手动触发：
 
-# 计划模式（仅输出 SQL，不执行）
-bun run sync:db --plan
+```typescript
+import { syncTable } from "../../sync/syncTable.js";
+import { scanSources } from "../../utils/scanSources.js";
 
-# 强制模式（执行危险变更，如字段长度收缩）
-bun run sync:db --force
+// ctx：BeflyContext（需已具备 ctx.db / ctx.redis / ctx.config）
+const sources = await scanSources();
+await syncTable(ctx, sources.tables);
 ```
 
 ### 同步流程
@@ -556,22 +555,21 @@ bun run sync:db --force
 
 同步时检测以下变更：
 
-| 变更类型 | 说明                         | 自动执行   |
-| -------- | ---------------------------- | ---------- |
-| 长度扩展 | VARCHAR 长度增加             | ✓          |
-| 长度收缩 | VARCHAR 长度减少             | 需 --force |
-| 类型宽化 | INT → BIGINT, VARCHAR → TEXT | ✓          |
-| 类型变更 | 其他类型变更                 | ✗ 禁止     |
-| 默认值   | 默认值变更                   | ✓          |
-| 注释     | 字段注释变更                 | ✓          |
-| 索引     | 添加/删除索引                | ✓          |
+| 变更类型 | 说明                         | 自动执行             |
+| -------- | ---------------------------- | -------------------- |
+| 长度扩展 | VARCHAR 长度增加             | ✓                    |
+| 长度收缩 | VARCHAR 长度减少             | ✗ 跳过（需手动处理） |
+| 类型宽化 | INT → BIGINT, VARCHAR → TEXT | ✓                    |
+| 类型变更 | 其他类型变更                 | ✗ 禁止               |
+| 默认值   | 默认值变更                   | ✓                    |
+| 注释     | 字段注释变更                 | ✓                    |
+| 索引     | 添加/删除索引                | ✓                    |
 
 ### 安全机制
 
-1. **禁止危险类型变更**：不允许从 `BIGINT` 改为 `VARCHAR` 等不兼容变更
+1. **禁止危险类型变更**：不允许从 `BIGINT` 改为 `VARCHAR` 等高风险变更
 2. **长度收缩保护**：默认跳过长度收缩，避免数据截断
-3. **计划模式**：`--plan` 仅输出 SQL 不执行，用于审查
-4. **保留字段保护**：不允许定义系统保留字段
+3. **保留字段保护**：不允许定义系统保留字段
 
 ---
 

package/hooks/auth.ts

@@ -2,8 +2,8 @@ import type { Hook } from "../types/hook.js";
 
 import { setCtxUser } from "../lib/asyncContext.js";
 
-const hook: Hook = {
-    order: 3,
+export default {
+    deps: ["cors"],
     handler: async (befly, ctx) => {
         const authHeader = ctx.req.headers.get("authorization");
 
@@ -22,5 +22,4 @@ const hook: Hook = {
             ctx.user = {};
         }
     }
-};
-export default hook;
+} satisfies Hook;