@sfmc-bds/db-server 0.1.0 → 0.2.0-beta.1

package/dist/domain/schema.js

@@ -1,462 +1,516 @@
-/**
- * domain/schema.ts — 数据库 schema 初始化(唯一真源)
- *
- * 所有 CREATE TABLE / CREATE INDEX 语句集中于此。
- * 调用方式:initSchema(db) — 在 openDatabase 之后、createQuery 之前执行。
- *
- * 事务描述:
- *   - 无业务 Tx(本文件只做 DDL,不涉及业务事务)
- *
- * 业务域(按文件内 db.exec 块编号):
- *   (1) 世界备份        (2) 玩家备份    (3) 计分板
- *   (4) 玩家行为日志    (5) 聊天频道    (6) 聊天消息
- *   (7) 红包            (8) 合作社主体/成员/邀请/账户
- *   (9) 合作社商店项/商店组 (10) 合作社账变流水/审计
- *   (11) 领地主体/成员/权限 (12) 领地邀请/审计/请求幂等
- *   (13) 玩家指令用量   (14) 价格指数
- *   (15) 每日任务/统计  (16) 经济账户/流水/幂等
- *
- *   完整表名以 `sfmc_` 前缀,具体见下方每个 db.exec 块。
- *
- * 备注: ALTER / DROP 不在此处;如需迁移请新建 tools/migrate-*.ts,
- *       保持本文件只做"全新初始化"。
- */
-export function initSchema(db) {
-    // (1 世界备份数据
-    db.exec(/* sql */ `
+function initSchema(db) {
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_world (
-      allow_cheats INTEGER NOT NULL DEFAULT 0, -- 允许作弊的选项
-      game_rules TEXT NOT NULL DEFAULT '', -- 世界规则(json)
-      seed TEXT DEFAULT '', -- 种子
-      default_spawn_location TEXT NOT NULL DEFAULT '', -- 默认出生点
-      difficulty TEXT NOT NULL DEFAULT '', -- 难度
-      day INTEGER NOT NULL DEFAULT 0, -- 游戏天数（世界）
-      ticking_areas_count INTEGER DEFAULT 0, -- 常加载区域数量
-      absolute_time INTEGER NOT NULL DEFAULT 0, -- 游戏内时间（当前）
-      structures_from_addon TEXT DEFAULT '', -- 来自模组的结构（在对应行为包内）
-      structures_from_world TEXT DEFAULT '', -- 来自世界的结构 包含保存在内存与磁盘中的
-      dynamic_property_total_byte_count INTEGER DEFAULT 0, -- 动态数据（世界）字节数
-      moon_phase INTEGER NOT NULL DEFAULT 0, -- 月相（当前）
-      updated_at TEXT NOT NULL DEFAULT '' -- 更新时间戳
-    )`);
-    // (2 玩家备份数据
-    db.exec(/* sql */ `
+      allow_cheats INTEGER NOT NULL DEFAULT 0, -- \u5141\u8BB8\u4F5C\u5F0A\u7684\u9009\u9879
+      game_rules TEXT NOT NULL DEFAULT '', -- \u4E16\u754C\u89C4\u5219(json)
+      seed TEXT DEFAULT '', -- \u79CD\u5B50
+      default_spawn_location TEXT NOT NULL DEFAULT '', -- \u9ED8\u8BA4\u51FA\u751F\u70B9
+      difficulty TEXT NOT NULL DEFAULT '', -- \u96BE\u5EA6
+      day INTEGER NOT NULL DEFAULT 0, -- \u6E38\u620F\u5929\u6570\uFF08\u4E16\u754C\uFF09
+      ticking_areas_count INTEGER DEFAULT 0, -- \u5E38\u52A0\u8F7D\u533A\u57DF\u6570\u91CF
+      absolute_time INTEGER NOT NULL DEFAULT 0, -- \u6E38\u620F\u5185\u65F6\u95F4\uFF08\u5F53\u524D\uFF09
+      structures_from_addon TEXT DEFAULT '', -- \u6765\u81EA\u6A21\u7EC4\u7684\u7ED3\u6784\uFF08\u5728\u5BF9\u5E94\u884C\u4E3A\u5305\u5185\uFF09
+      structures_from_world TEXT DEFAULT '', -- \u6765\u81EA\u4E16\u754C\u7684\u7ED3\u6784 \u5305\u542B\u4FDD\u5B58\u5728\u5185\u5B58\u4E0E\u78C1\u76D8\u4E2D\u7684
+      dynamic_property_total_byte_count INTEGER DEFAULT 0, -- \u52A8\u6001\u6570\u636E\uFF08\u4E16\u754C\uFF09\u5B57\u8282\u6570
+      moon_phase INTEGER NOT NULL DEFAULT 0, -- \u6708\u76F8\uFF08\u5F53\u524D\uFF09
+      updated_at TEXT NOT NULL DEFAULT '' -- \u66F4\u65B0\u65F6\u95F4\u6233
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_players (
-      id TEXT NOT NULL, -- 实体id标识符
-      name TEXT NOT NULL, -- 名称
-      permission INTEGER DEFAULT 0, -- 权限等级（0=访客,1=成员,2=OP,3=管理员）TODO: 暂未适配自定义脚本权限
-      client_system_info_local TEXT DEFAULT '', -- 客户端系统信息->本地化语言
-      client_system_info_maxRenderDistance INTEGER DEFAULT 0, -- 客户端系统信息->最大渲染距离
-      client_system_info_memoryTier_level TEXT DEFAULT '', -- 客户端信息->内存等级 详细请查看官方文档
-      client_system_info_PlatformType TEXT DEFAULT '', -- 客户端系统信息->平台类型
-      graphicsMode TEXT DEFAULT '', -- 图形模式
-      dynamicPropertyTotalByteCount INTEGER DEFAULT 0, -- 动态属性总字节数
-      ping INTEGER DEFAULT 0, -- 延迟（ms）
-      spawnPoint TEXT DEFAULT '', -- 出生点坐标
-      tags TEXT DEFAULT '', -- 玩家标签
-      level INTEGER DEFAULT 0, -- 等级
-      totalXp INTEGER DEFAULT 0, -- 总经验值
-      afk_step INTEGER DEFAULT 0, -- AFK累计步数
-      afk_last_location TEXT DEFAULT '', -- AFK最后位置
-      onlinetime_session INTEGER DEFAULT 0, -- 在线时间->本次会话（秒）
-      onlinetime_today INTEGER DEFAULT 0, -- 在线时间->今日（秒）
-      onlinetime_month INTEGER DEFAULT 0, -- 在线时间->本月（秒）
-      onlinetime_total INTEGER DEFAULT 0, -- 在线时间->累计（秒）
-      onlinetime_last_date INTEGER DEFAULT 0, -- 在线时间->上次记录日期
-      onlinetime_last_month INTEGER DEFAULT 0, -- 在线时间->上次记录月份
-      active_channel TEXT NOT NULL DEFAULT '', -- 当前活跃聊天频道
-      subscribed_channels TEXT DEFAULT '', -- 订阅的频道列表
-      updated_at INTEGER NOT NULL, -- 玩家数据更新时间戳
-      PRIMARY KEY (id, name) -- 联合主键：实体id+名称
-    )`);
-    // 玩家表索引：按id查、按name查
-    db.exec(/* sql */ `
+      id TEXT NOT NULL, -- \u5B9E\u4F53id\u6807\u8BC6\u7B26
+      name TEXT NOT NULL, -- \u540D\u79F0
+      permission INTEGER DEFAULT 0, -- \u6743\u9650\u7B49\u7EA7\uFF080=\u8BBF\u5BA2,1=\u6210\u5458,2=OP,3=\u7BA1\u7406\u5458\uFF09TODO: \u6682\u672A\u9002\u914D\u81EA\u5B9A\u4E49\u811A\u672C\u6743\u9650
+      client_system_info_local TEXT DEFAULT '', -- \u5BA2\u6237\u7AEF\u7CFB\u7EDF\u4FE1\u606F->\u672C\u5730\u5316\u8BED\u8A00
+      client_system_info_maxRenderDistance INTEGER DEFAULT 0, -- \u5BA2\u6237\u7AEF\u7CFB\u7EDF\u4FE1\u606F->\u6700\u5927\u6E32\u67D3\u8DDD\u79BB
+      client_system_info_memoryTier_level TEXT DEFAULT '', -- \u5BA2\u6237\u7AEF\u4FE1\u606F->\u5185\u5B58\u7B49\u7EA7 \u8BE6\u7EC6\u8BF7\u67E5\u770B\u5B98\u65B9\u6587\u6863
+      client_system_info_PlatformType TEXT DEFAULT '', -- \u5BA2\u6237\u7AEF\u7CFB\u7EDF\u4FE1\u606F->\u5E73\u53F0\u7C7B\u578B
+      graphicsMode TEXT DEFAULT '', -- \u56FE\u5F62\u6A21\u5F0F
+      dynamicPropertyTotalByteCount INTEGER DEFAULT 0, -- \u52A8\u6001\u5C5E\u6027\u603B\u5B57\u8282\u6570
+      ping INTEGER DEFAULT 0, -- \u5EF6\u8FDF\uFF08ms\uFF09
+      spawnPoint TEXT DEFAULT '', -- \u51FA\u751F\u70B9\u5750\u6807
+      tags TEXT DEFAULT '', -- \u73A9\u5BB6\u6807\u7B7E
+      level INTEGER DEFAULT 0, -- \u7B49\u7EA7
+      totalXp INTEGER DEFAULT 0, -- \u603B\u7ECF\u9A8C\u503C
+      afk_step INTEGER DEFAULT 0, -- AFK\u7D2F\u8BA1\u6B65\u6570
+      afk_last_location TEXT DEFAULT '', -- AFK\u6700\u540E\u4F4D\u7F6E
+      onlinetime_session INTEGER DEFAULT 0, -- \u5728\u7EBF\u65F6\u95F4->\u672C\u6B21\u4F1A\u8BDD\uFF08\u79D2\uFF09
+      onlinetime_today INTEGER DEFAULT 0, -- \u5728\u7EBF\u65F6\u95F4->\u4ECA\u65E5\uFF08\u79D2\uFF09
+      onlinetime_month INTEGER DEFAULT 0, -- \u5728\u7EBF\u65F6\u95F4->\u672C\u6708\uFF08\u79D2\uFF09
+      onlinetime_total INTEGER DEFAULT 0, -- \u5728\u7EBF\u65F6\u95F4->\u7D2F\u8BA1\uFF08\u79D2\uFF09
+      onlinetime_last_date INTEGER DEFAULT 0, -- \u5728\u7EBF\u65F6\u95F4->\u4E0A\u6B21\u8BB0\u5F55\u65E5\u671F
+      onlinetime_last_month INTEGER DEFAULT 0, -- \u5728\u7EBF\u65F6\u95F4->\u4E0A\u6B21\u8BB0\u5F55\u6708\u4EFD
+      active_channel TEXT NOT NULL DEFAULT '', -- \u5F53\u524D\u6D3B\u8DC3\u804A\u5929\u9891\u9053
+      subscribed_channels TEXT DEFAULT '', -- \u8BA2\u9605\u7684\u9891\u9053\u5217\u8868
+      updated_at INTEGER NOT NULL, -- \u73A9\u5BB6\u6570\u636E\u66F4\u65B0\u65F6\u95F4\u6233
+      PRIMARY KEY (id, name) -- \u8054\u5408\u4E3B\u952E\uFF1A\u5B9E\u4F53id+\u540D\u79F0
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE INDEX IF NOT EXISTS idx_players_id ON sfmc_players(id);
-    CREATE INDEX IF NOT EXISTS idx_players_name ON sfmc_players(name)`);
-    // (3 计分板数据
-    db.exec(/* sql */ `
+    CREATE INDEX IF NOT EXISTS idx_players_name ON sfmc_players(name)`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_scoreboards (
-      objective_id TEXT NOT NULL, -- 计分板目标id（主键）
-      objective_display TEXT NOT NULL DEFAULT '', -- 计分板显示名称
-      participants TEXT DEFAULT '', -- 参与者列表（json）
-      updated_at INTEGER NOT NULL, -- 更新时间戳
-      PRIMARY KEY (objective_id) -- 主键
-    )`);
-    // (4 玩家行为日志
-    db.exec(/* sql */ `
+      objective_id TEXT NOT NULL, -- \u8BA1\u5206\u677F\u76EE\u6807id\uFF08\u4E3B\u952E\uFF09
+      objective_display TEXT NOT NULL DEFAULT '', -- \u8BA1\u5206\u677F\u663E\u793A\u540D\u79F0
+      participants TEXT DEFAULT '', -- \u53C2\u4E0E\u8005\u5217\u8868\uFF08json\uFF09
+      updated_at INTEGER NOT NULL, -- \u66F4\u65B0\u65F6\u95F4\u6233
+      PRIMARY KEY (objective_id) -- \u4E3B\u952E
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_activities (
-      id TEXT PRIMARY KEY, -- 唯一id
-      timestamp INTEGER NOT NULL, -- 事件发生时间戳
-      dimension TEXT NOT NULL DEFAULT '', -- 维度（overworld/nether/end）
-      source_type TEXT NOT NULL, -- 事件源类型（如player、entity、block等）
-      source_id TEXT DEFAULT '', -- 事件源实体/方块id
-      source_name TEXT NOT NULL DEFAULT '', -- 事件源名称
-      source_x REAL, -- 事件源x坐标
-      source_y REAL, -- 事件源y坐标
-      source_z REAL, -- 事件源z坐标
-      event_type TEXT NOT NULL, -- 事件类型（如chat、command、death、join等）
-      target_type TEXT DEFAULT '', -- 目标类型
-      target_id TEXT DEFAULT '', -- 目标实体id
-      target_name TEXT NOT NULL DEFAULT '', -- 目标名称
-      target_x REAL, -- 目标x坐标
-      target_y REAL, -- 目标y坐标
-      target_z REAL, -- 目标z坐标
-      detail TEXT DEFAULT '{}', -- 事件详细信息（json）
-      created_at INTEGER NOT NULL -- 记录创建时间戳
-    )`);
-    // 活动表索引：按源id查、按事件类型查、按目标id查
-    db.exec(/* sql */ `
+      id TEXT PRIMARY KEY, -- \u552F\u4E00id
+      timestamp INTEGER NOT NULL, -- \u4E8B\u4EF6\u53D1\u751F\u65F6\u95F4\u6233
+      dimension TEXT NOT NULL DEFAULT '', -- \u7EF4\u5EA6\uFF08overworld/nether/end\uFF09
+      source_type TEXT NOT NULL, -- \u4E8B\u4EF6\u6E90\u7C7B\u578B\uFF08\u5982player\u3001entity\u3001block\u7B49\uFF09
+      source_id TEXT DEFAULT '', -- \u4E8B\u4EF6\u6E90\u5B9E\u4F53/\u65B9\u5757id
+      source_name TEXT NOT NULL DEFAULT '', -- \u4E8B\u4EF6\u6E90\u540D\u79F0
+      source_x REAL, -- \u4E8B\u4EF6\u6E90x\u5750\u6807
+      source_y REAL, -- \u4E8B\u4EF6\u6E90y\u5750\u6807
+      source_z REAL, -- \u4E8B\u4EF6\u6E90z\u5750\u6807
+      event_type TEXT NOT NULL, -- \u4E8B\u4EF6\u7C7B\u578B\uFF08\u5982chat\u3001command\u3001death\u3001join\u7B49\uFF09
+      target_type TEXT DEFAULT '', -- \u76EE\u6807\u7C7B\u578B
+      target_id TEXT DEFAULT '', -- \u76EE\u6807\u5B9E\u4F53id
+      target_name TEXT NOT NULL DEFAULT '', -- \u76EE\u6807\u540D\u79F0
+      target_x REAL, -- \u76EE\u6807x\u5750\u6807
+      target_y REAL, -- \u76EE\u6807y\u5750\u6807
+      target_z REAL, -- \u76EE\u6807z\u5750\u6807
+      detail TEXT DEFAULT '{}', -- \u4E8B\u4EF6\u8BE6\u7EC6\u4FE1\u606F\uFF08json\uFF09
+      created_at INTEGER NOT NULL -- \u8BB0\u5F55\u521B\u5EFA\u65F6\u95F4\u6233
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE INDEX IF NOT EXISTS idx_sfmc_act_source ON sfmc_activities(source_id, timestamp);
     CREATE INDEX IF NOT EXISTS idx_sfmc_act_event ON sfmc_activities(event_type, timestamp);
-    CREATE INDEX IF NOT EXISTS idx_sfmc_act_target ON sfmc_activities(target_id, timestamp)`);
-    // (5 聊天频道配置
-    db.exec(/* sql */ `
+    CREATE INDEX IF NOT EXISTS idx_sfmc_act_target ON sfmc_activities(target_id, timestamp)`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_chat_channels (
-      id TEXT NOT NULL, -- 频道唯一id
-      name TEXT NOT NULL, -- 频道名称
-      type TEXT NOT NULL, -- 频道类型
-      prefix TEXT NOT NULL, -- 频道前缀符号
-      owner_id TEXT DEFAULT '', -- 频道所有者玩家id
-      created_at INTEGER NOT NULL, -- 频道创建时间戳
-      config_allow_chat INTEGER NOT NULL DEFAULT 1, -- 配置->是否允许聊天
-      config_slow_mode INTEGER NOT NULL DEFAULT 0, -- 配置->慢模式间隔（秒）
-      config_is_broadcast INTEGER NOT NULL DEFAULT 0, -- 配置->是否为广播频道
-      updated_at INTEGER NOT NULL, -- 频道配置更新时间戳
-      PRIMARY KEY (id, name) -- 联合主键
-    )`);
-    // 频道表索引：按id查、按name+创建时间查
-    db.exec(/* sql */ `
+      id TEXT NOT NULL, -- \u9891\u9053\u552F\u4E00id
+      name TEXT NOT NULL, -- \u9891\u9053\u540D\u79F0
+      type TEXT NOT NULL, -- \u9891\u9053\u7C7B\u578B
+      prefix TEXT NOT NULL, -- \u9891\u9053\u524D\u7F00\u7B26\u53F7
+      owner_id TEXT DEFAULT '', -- \u9891\u9053\u6240\u6709\u8005\u73A9\u5BB6id
+      created_at INTEGER NOT NULL, -- \u9891\u9053\u521B\u5EFA\u65F6\u95F4\u6233
+      config_allow_chat INTEGER NOT NULL DEFAULT 1, -- \u914D\u7F6E->\u662F\u5426\u5141\u8BB8\u804A\u5929
+      config_slow_mode INTEGER NOT NULL DEFAULT 0, -- \u914D\u7F6E->\u6162\u6A21\u5F0F\u95F4\u9694\uFF08\u79D2\uFF09
+      config_is_broadcast INTEGER NOT NULL DEFAULT 0, -- \u914D\u7F6E->\u662F\u5426\u4E3A\u5E7F\u64AD\u9891\u9053
+      updated_at INTEGER NOT NULL, -- \u9891\u9053\u914D\u7F6E\u66F4\u65B0\u65F6\u95F4\u6233
+      PRIMARY KEY (id, name) -- \u8054\u5408\u4E3B\u952E
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE INDEX IF NOT EXISTS idx_channels_id ON sfmc_chat_channels(id);
-    CREATE INDEX IF NOT EXISTS idx_channels_name ON sfmc_chat_channels(name, created_at ASC)`);
-    // (6 聊天消息记录
-    db.exec(/* sql */ `
+    CREATE INDEX IF NOT EXISTS idx_channels_name ON sfmc_chat_channels(name, created_at ASC)`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_chat_messages (
-      id TEXT PRIMARY KEY, -- 消息唯一id
-      channel_id TEXT NOT NULL, -- 所属频道id
-      from_id TEXT NOT NULL, -- 发送者玩家id
-      from_name TEXT NOT NULL, -- 发送者名称
-      type TEXT NOT NULL DEFAULT 'text', -- 消息类型
-      content TEXT NOT NULL, -- 消息内容
-      attachment TEXT, -- 附件信息
-      show_timestamp INTEGER NOT NULL DEFAULT 0, -- 是否在消息列表显示时间戳
-      created_at INTEGER NOT NULL -- 消息发送时间戳
-    )`);
-    // 消息表索引：按频道+时间查
-    db.exec(/* sql */ `
-    CREATE INDEX IF NOT EXISTS idx_messages_channel ON sfmc_chat_messages(channel_id, created_at ASC)`);
-    // (7 聊天红包记录
-    db.exec(/* sql */ `
+      id TEXT PRIMARY KEY, -- \u6D88\u606F\u552F\u4E00id
+      channel_id TEXT NOT NULL, -- \u6240\u5C5E\u9891\u9053id
+      from_id TEXT NOT NULL, -- \u53D1\u9001\u8005\u73A9\u5BB6id
+      from_name TEXT NOT NULL, -- \u53D1\u9001\u8005\u540D\u79F0
+      type TEXT NOT NULL DEFAULT 'text', -- \u6D88\u606F\u7C7B\u578B
+      content TEXT NOT NULL, -- \u6D88\u606F\u5185\u5BB9
+      attachment TEXT, -- \u9644\u4EF6\u4FE1\u606F
+      show_timestamp INTEGER NOT NULL DEFAULT 0, -- \u662F\u5426\u5728\u6D88\u606F\u5217\u8868\u663E\u793A\u65F6\u95F4\u6233
+      created_at INTEGER NOT NULL -- \u6D88\u606F\u53D1\u9001\u65F6\u95F4\u6233
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
+    CREATE INDEX IF NOT EXISTS idx_messages_channel ON sfmc_chat_messages(channel_id, created_at ASC)`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_chat_redpackets (
-      id TEXT PRIMARY KEY, -- 红包唯一id
-      sender_id TEXT NOT NULL, -- 发红包玩家id
-      sender_name TEXT NOT NULL, -- 发红包玩家名称
-      total_amount REAL NOT NULL, -- 红包总金额
-      remaining_amount REAL NOT NULL, -- 剩余金额
-      total_count INTEGER NOT NULL, -- 红包总个数
-      remaining_count INTEGER NOT NULL, -- 剩余个数
-      receivers TEXT NOT NULL DEFAULT '[]', -- 已领取玩家列表（json）
-      target_type TEXT NOT NULL, -- 红包目标类型（all/channel/player等）
-      target_id TEXT NOT NULL, -- 红包目标id
-      created_at INTEGER NOT NULL, -- 红包创建时间戳
-      expires_at INTEGER NOT NULL -- 红包过期时间戳
-    )`);
-    // 红包表索引：按id查
-    db.exec(/* sql */ `
-    CREATE INDEX IF NOT EXISTS idx_redpackets_id ON sfmc_chat_redpackets(id)`);
-    // (8 合作社核心表
-    db.exec(/* sql */ `
+      id TEXT PRIMARY KEY, -- \u7EA2\u5305\u552F\u4E00id
+      sender_id TEXT NOT NULL, -- \u53D1\u7EA2\u5305\u73A9\u5BB6id
+      sender_name TEXT NOT NULL, -- \u53D1\u7EA2\u5305\u73A9\u5BB6\u540D\u79F0
+      total_amount REAL NOT NULL, -- \u7EA2\u5305\u603B\u91D1\u989D
+      remaining_amount REAL NOT NULL, -- \u5269\u4F59\u91D1\u989D
+      total_count INTEGER NOT NULL, -- \u7EA2\u5305\u603B\u4E2A\u6570
+      remaining_count INTEGER NOT NULL, -- \u5269\u4F59\u4E2A\u6570
+      receivers TEXT NOT NULL DEFAULT '[]', -- \u5DF2\u9886\u53D6\u73A9\u5BB6\u5217\u8868\uFF08json\uFF09
+      target_type TEXT NOT NULL, -- \u7EA2\u5305\u76EE\u6807\u7C7B\u578B\uFF08all/channel/player\u7B49\uFF09
+      target_id TEXT NOT NULL, -- \u7EA2\u5305\u76EE\u6807id
+      created_at INTEGER NOT NULL, -- \u7EA2\u5305\u521B\u5EFA\u65F6\u95F4\u6233
+      expires_at INTEGER NOT NULL -- \u7EA2\u5305\u8FC7\u671F\u65F6\u95F4\u6233
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
+    CREATE INDEX IF NOT EXISTS idx_redpackets_id ON sfmc_chat_redpackets(id)`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_coops (
-      cid TEXT PRIMARY KEY, -- 合作社唯一id
-      name TEXT NOT NULL, -- 合作社名称
-      owner_player_id TEXT NOT NULL, -- 社长玩家id
-      owner_name_snapshot TEXT NOT NULL DEFAULT '', -- 社长名称快照
-      status TEXT NOT NULL DEFAULT 'active', -- 状态（active/inactive/dissolved）
-      notice TEXT DEFAULT '', -- 合作社公告
-      created_at INTEGER NOT NULL, -- 创建时间戳
-      updated_at INTEGER NOT NULL, -- 更新时间戳
-      fee_bps INTEGER NOT NULL DEFAULT 500, -- 税率（基点，500=5%）
-      version INTEGER NOT NULL DEFAULT 1 -- 乐观锁版本号
-    )`);
-    // 合作社成员表
-    db.exec(/* sql */ `
+      cid TEXT PRIMARY KEY, -- \u5408\u4F5C\u793E\u552F\u4E00id
+      name TEXT NOT NULL, -- \u5408\u4F5C\u793E\u540D\u79F0
+      owner_player_id TEXT NOT NULL, -- \u793E\u957F\u73A9\u5BB6id
+      owner_name_snapshot TEXT NOT NULL DEFAULT '', -- \u793E\u957F\u540D\u79F0\u5FEB\u7167
+      status TEXT NOT NULL DEFAULT 'active', -- \u72B6\u6001\uFF08active/inactive/dissolved\uFF09
+      notice TEXT DEFAULT '', -- \u5408\u4F5C\u793E\u516C\u544A
+      created_at INTEGER NOT NULL, -- \u521B\u5EFA\u65F6\u95F4\u6233
+      updated_at INTEGER NOT NULL, -- \u66F4\u65B0\u65F6\u95F4\u6233
+      fee_bps INTEGER NOT NULL DEFAULT 500, -- \u7A0E\u7387\uFF08\u57FA\u70B9\uFF0C500=5%\uFF09
+      version INTEGER NOT NULL DEFAULT 1 -- \u4E50\u89C2\u9501\u7248\u672C\u53F7
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_coop_members (
-      cid TEXT NOT NULL, -- 合作社id
-      player_id TEXT NOT NULL, -- 成员玩家id
-      player_name_snapshot TEXT NOT NULL DEFAULT '', -- 成员名称快照
-      role TEXT NOT NULL DEFAULT 'member', -- 角色（member/admin/owner）
-      joined_at INTEGER NOT NULL, -- 加入时间戳
-      expires_at INTEGER, -- 成员资格过期时间戳（null=永不过期）
-      status TEXT NOT NULL DEFAULT 'active', -- 状态（active/expired/kicked）
-      version INTEGER NOT NULL DEFAULT 1, -- 乐观锁版本号
-      PRIMARY KEY (cid, player_id), -- 联合主键
-      FOREIGN KEY (cid) REFERENCES sfmc_coops(cid) ON DELETE CASCADE -- 级联删除
-    )`);
-    // 确保每个玩家只有一个active合作社成员记录
-    db.exec(/* sql */ `
-    CREATE UNIQUE INDEX IF NOT EXISTS idx_sfmc_one_active_coop_member ON sfmc_coop_members(player_id) WHERE status='active'`);
-    // 合作社邀请表
-    db.exec(/* sql */ `
+      cid TEXT NOT NULL, -- \u5408\u4F5C\u793Eid
+      player_id TEXT NOT NULL, -- \u6210\u5458\u73A9\u5BB6id
+      player_name_snapshot TEXT NOT NULL DEFAULT '', -- \u6210\u5458\u540D\u79F0\u5FEB\u7167
+      role TEXT NOT NULL DEFAULT 'member', -- \u89D2\u8272\uFF08member/admin/owner\uFF09
+      joined_at INTEGER NOT NULL, -- \u52A0\u5165\u65F6\u95F4\u6233
+      expires_at INTEGER, -- \u6210\u5458\u8D44\u683C\u8FC7\u671F\u65F6\u95F4\u6233\uFF08null=\u6C38\u4E0D\u8FC7\u671F\uFF09
+      status TEXT NOT NULL DEFAULT 'active', -- \u72B6\u6001\uFF08active/expired/kicked\uFF09
+      version INTEGER NOT NULL DEFAULT 1, -- \u4E50\u89C2\u9501\u7248\u672C\u53F7
+      PRIMARY KEY (cid, player_id), -- \u8054\u5408\u4E3B\u952E
+      FOREIGN KEY (cid) REFERENCES sfmc_coops(cid) ON DELETE CASCADE -- \u7EA7\u8054\u5220\u9664
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_sfmc_one_active_coop_member ON sfmc_coop_members(player_id) WHERE status='active'`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_coop_invites (
-      id TEXT PRIMARY KEY, -- 邀请唯一id
-      cid TEXT NOT NULL, -- 合作社id
-      inviter_id TEXT NOT NULL, -- 邀请人玩家id
-      invitee_id TEXT NOT NULL, -- 被邀请人玩家id
-      invitee_name_snapshot TEXT NOT NULL DEFAULT '', -- 被邀请人名称快照
-      role TEXT NOT NULL DEFAULT 'member', -- 邀请角色
-      status TEXT NOT NULL DEFAULT 'pending', -- 状态（pending/accepted/rejected/expired）
-      expires_at INTEGER NOT NULL, -- 邀请过期时间戳
-      created_at INTEGER NOT NULL, -- 创建时间戳
-      FOREIGN KEY (cid) REFERENCES sfmc_coops(cid) ON DELETE CASCADE -- 级联删除
-    )`);
-    // 邀请表索引：按被邀请人+状态+过期时间查
-    db.exec(/* sql */ `
-    CREATE INDEX IF NOT EXISTS idx_sfmc_coop_invites_target ON sfmc_coop_invites(invitee_id,status,expires_at)`);
-    // 合作社账户表（经济系统）
-    db.exec(/* sql */ `
+      id TEXT PRIMARY KEY, -- \u9080\u8BF7\u552F\u4E00id
+      cid TEXT NOT NULL, -- \u5408\u4F5C\u793Eid
+      inviter_id TEXT NOT NULL, -- \u9080\u8BF7\u4EBA\u73A9\u5BB6id
+      invitee_id TEXT NOT NULL, -- \u88AB\u9080\u8BF7\u4EBA\u73A9\u5BB6id
+      invitee_name_snapshot TEXT NOT NULL DEFAULT '', -- \u88AB\u9080\u8BF7\u4EBA\u540D\u79F0\u5FEB\u7167
+      role TEXT NOT NULL DEFAULT 'member', -- \u9080\u8BF7\u89D2\u8272
+      status TEXT NOT NULL DEFAULT 'pending', -- \u72B6\u6001\uFF08pending/accepted/rejected/expired\uFF09
+      expires_at INTEGER NOT NULL, -- \u9080\u8BF7\u8FC7\u671F\u65F6\u95F4\u6233
+      created_at INTEGER NOT NULL, -- \u521B\u5EFA\u65F6\u95F4\u6233
+      FOREIGN KEY (cid) REFERENCES sfmc_coops(cid) ON DELETE CASCADE -- \u7EA7\u8054\u5220\u9664
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
+    CREATE INDEX IF NOT EXISTS idx_sfmc_coop_invites_target ON sfmc_coop_invites(invitee_id,status,expires_at)`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_coop_accounts (
-      cid TEXT PRIMARY KEY, -- 合作社id
-      balance INTEGER NOT NULL DEFAULT 0, -- 账户余额
-      version INTEGER NOT NULL DEFAULT 1, -- 乐观锁版本号
-      updated_at INTEGER NOT NULL, -- 账户更新时间戳
-      FOREIGN KEY (cid) REFERENCES sfmc_coops(cid) ON DELETE CASCADE -- 级联删除
-    )`);
-    // 合作社商店物品表
-    db.exec(/* sql */ `
+      cid TEXT PRIMARY KEY, -- \u5408\u4F5C\u793Eid
+      balance INTEGER NOT NULL DEFAULT 0, -- \u8D26\u6237\u4F59\u989D
+      version INTEGER NOT NULL DEFAULT 1, -- \u4E50\u89C2\u9501\u7248\u672C\u53F7
+      updated_at INTEGER NOT NULL, -- \u8D26\u6237\u66F4\u65B0\u65F6\u95F4\u6233
+      FOREIGN KEY (cid) REFERENCES sfmc_coops(cid) ON DELETE CASCADE -- \u7EA7\u8054\u5220\u9664
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_coop_shop_items (
-      id TEXT PRIMARY KEY, -- 物品唯一id
-      cid TEXT NOT NULL, -- 所属合作社id
-      name TEXT NOT NULL, -- 物品名称
-      item_type TEXT NOT NULL, -- 物品类型标识符（如minecraft:diamond）
-      item_aux INTEGER DEFAULT 0, -- 物品附加值/数据值
-      item_nbt TEXT DEFAULT '', -- 物品NBT数据
-      type INTEGER NOT NULL, -- 物品交易类型（0=收购,1=出售,2=交换）
-      groups TEXT DEFAULT '[]', -- 所属商品分组
-      des TEXT DEFAULT '', -- 物品描述
-      num INTEGER DEFAULT 0, -- 当前库存数量
-      sv INTEGER DEFAULT 0, -- 销售/收购限制
-      money INTEGER DEFAULT 0, -- 单价
-      is_true INTEGER DEFAULT 1, -- 是否上架（1=上架,0=下架）
-      created_at INTEGER NOT NULL, -- 创建时间戳
-      updated_at INTEGER NOT NULL, -- 更新时间戳
-      FOREIGN KEY (cid) REFERENCES sfmc_coops(cid) ON DELETE CASCADE -- 级联删除
-    )`);
-    // 合作社银行流水表
-    db.exec(/* sql */ `
+      id TEXT PRIMARY KEY, -- \u7269\u54C1\u552F\u4E00id
+      cid TEXT NOT NULL, -- \u6240\u5C5E\u5408\u4F5C\u793Eid
+      name TEXT NOT NULL, -- \u7269\u54C1\u540D\u79F0
+      item_type TEXT NOT NULL, -- \u7269\u54C1\u7C7B\u578B\u6807\u8BC6\u7B26\uFF08\u5982minecraft:diamond\uFF09
+      item_aux INTEGER DEFAULT 0, -- \u7269\u54C1\u9644\u52A0\u503C/\u6570\u636E\u503C
+      item_nbt TEXT DEFAULT '', -- \u7269\u54C1NBT\u6570\u636E
+      type INTEGER NOT NULL, -- \u7269\u54C1\u4EA4\u6613\u7C7B\u578B\uFF080=\u6536\u8D2D,1=\u51FA\u552E,2=\u4EA4\u6362\uFF09
+      groups TEXT DEFAULT '[]', -- \u6240\u5C5E\u5546\u54C1\u5206\u7EC4
+      des TEXT DEFAULT '', -- \u7269\u54C1\u63CF\u8FF0
+      num INTEGER DEFAULT 0, -- \u5F53\u524D\u5E93\u5B58\u6570\u91CF
+      sv INTEGER DEFAULT 0, -- \u9500\u552E/\u6536\u8D2D\u9650\u5236
+      money INTEGER DEFAULT 0, -- \u5355\u4EF7
+      is_true INTEGER DEFAULT 1, -- \u662F\u5426\u4E0A\u67B6\uFF081=\u4E0A\u67B6,0=\u4E0B\u67B6\uFF09
+      created_at INTEGER NOT NULL, -- \u521B\u5EFA\u65F6\u95F4\u6233
+      updated_at INTEGER NOT NULL, -- \u66F4\u65B0\u65F6\u95F4\u6233
+      FOREIGN KEY (cid) REFERENCES sfmc_coops(cid) ON DELETE CASCADE -- \u7EA7\u8054\u5220\u9664
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_coop_bank_log (
-      id INTEGER PRIMARY KEY AUTOINCREMENT, -- 流水id（自增）
-      cid TEXT NOT NULL, -- 合作社id
-      actor_id TEXT NOT NULL, -- 操作人玩家id
-      actor_name_snapshot TEXT NOT NULL DEFAULT '', -- 操作人名称快照
-      type INTEGER NOT NULL, -- 流水类型（0=存入,1=取出,2=交易收入,3=交易支出）
-      amount INTEGER NOT NULL, -- 变动金额
-      note TEXT DEFAULT '', -- 备注
-      transaction_id TEXT NOT NULL DEFAULT '', -- 关联事务id
-      created_at INTEGER NOT NULL, -- 创建时间戳
-      FOREIGN KEY (cid) REFERENCES sfmc_coops(cid) ON DELETE CASCADE -- 级联删除
-    )`);
-    // 合作社审计日志表
-    db.exec(/* sql */ `
+      id INTEGER PRIMARY KEY AUTOINCREMENT, -- \u6D41\u6C34id\uFF08\u81EA\u589E\uFF09
+      cid TEXT NOT NULL, -- \u5408\u4F5C\u793Eid
+      actor_id TEXT NOT NULL, -- \u64CD\u4F5C\u4EBA\u73A9\u5BB6id
+      actor_name_snapshot TEXT NOT NULL DEFAULT '', -- \u64CD\u4F5C\u4EBA\u540D\u79F0\u5FEB\u7167
+      type INTEGER NOT NULL, -- \u6D41\u6C34\u7C7B\u578B\uFF080=\u5B58\u5165,1=\u53D6\u51FA,2=\u4EA4\u6613\u6536\u5165,3=\u4EA4\u6613\u652F\u51FA\uFF09
+      amount INTEGER NOT NULL, -- \u53D8\u52A8\u91D1\u989D
+      note TEXT DEFAULT '', -- \u5907\u6CE8
+      transaction_id TEXT NOT NULL DEFAULT '', -- \u5173\u8054\u4E8B\u52A1id
+      created_at INTEGER NOT NULL, -- \u521B\u5EFA\u65F6\u95F4\u6233
+      FOREIGN KEY (cid) REFERENCES sfmc_coops(cid) ON DELETE CASCADE -- \u7EA7\u8054\u5220\u9664
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_coop_audit_logs (
-      id INTEGER PRIMARY KEY AUTOINCREMENT, -- 日志id（自增）
-      cid TEXT NOT NULL, -- 合作社id
-      actor_id TEXT NOT NULL, -- 操作者id
-      target_id TEXT NOT NULL DEFAULT '', -- 被操作目标id
-      action TEXT NOT NULL, -- 操作类型（如create/update/delete/transfer等）
-      before_state TEXT NOT NULL DEFAULT '{}', -- 操作前状态（json）
-      after_state TEXT NOT NULL DEFAULT '{}', -- 操作后状态（json）
-      transaction_id TEXT NOT NULL DEFAULT '', -- 关联事务id
-      created_at INTEGER NOT NULL, -- 日志创建时间戳
-      FOREIGN KEY (cid) REFERENCES sfmc_coops(cid) ON DELETE CASCADE -- 级联删除
-    )`);
-    // 合作社商店分组表
-    db.exec(/* sql */ `
+      id INTEGER PRIMARY KEY AUTOINCREMENT, -- \u65E5\u5FD7id\uFF08\u81EA\u589E\uFF09
+      cid TEXT NOT NULL, -- \u5408\u4F5C\u793Eid
+      actor_id TEXT NOT NULL, -- \u64CD\u4F5C\u8005id
+      target_id TEXT NOT NULL DEFAULT '', -- \u88AB\u64CD\u4F5C\u76EE\u6807id
+      action TEXT NOT NULL, -- \u64CD\u4F5C\u7C7B\u578B\uFF08\u5982create/update/delete/transfer\u7B49\uFF09
+      before_state TEXT NOT NULL DEFAULT '{}', -- \u64CD\u4F5C\u524D\u72B6\u6001\uFF08json\uFF09
+      after_state TEXT NOT NULL DEFAULT '{}', -- \u64CD\u4F5C\u540E\u72B6\u6001\uFF08json\uFF09
+      transaction_id TEXT NOT NULL DEFAULT '', -- \u5173\u8054\u4E8B\u52A1id
+      created_at INTEGER NOT NULL, -- \u65E5\u5FD7\u521B\u5EFA\u65F6\u95F4\u6233
+      FOREIGN KEY (cid) REFERENCES sfmc_coops(cid) ON DELETE CASCADE -- \u7EA7\u8054\u5220\u9664
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_coop_shop_groups (
-      groupid TEXT PRIMARY KEY, -- 分组唯一id
-      displayname TEXT NOT NULL, -- 分组显示名称
-      displaydescribe TEXT DEFAULT '', -- 分组描述
-      icon TEXT DEFAULT '', -- 分组图标
-      type_function TEXT DEFAULT '' -- 分组功能类型
-    )`);
-    // (9 领地（ LAND ）核心表
-    db.exec(/* sql */ `
+      groupid TEXT PRIMARY KEY, -- \u5206\u7EC4\u552F\u4E00id
+      displayname TEXT NOT NULL, -- \u5206\u7EC4\u663E\u793A\u540D\u79F0
+      displaydescribe TEXT DEFAULT '', -- \u5206\u7EC4\u63CF\u8FF0
+      icon TEXT DEFAULT '', -- \u5206\u7EC4\u56FE\u6807
+      type_function TEXT DEFAULT '' -- \u5206\u7EC4\u529F\u80FD\u7C7B\u578B
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_lands (
-      id TEXT PRIMARY KEY, -- 领地唯一id
-      owner_player_id TEXT NOT NULL, -- 领地所有者玩家id
-      owner_name_snapshot TEXT NOT NULL DEFAULT '', -- 所有者名称快照
-      dimension INTEGER NOT NULL, -- 所在维度（0=主世界,1=下界,2=末地）
-      min_x INTEGER NOT NULL, -- 领地范围最小x坐标
-      min_y INTEGER NOT NULL, -- 领地范围最小y坐标
-      min_z INTEGER NOT NULL, -- 领地范围最小z坐标
-      max_x INTEGER NOT NULL, -- 领地范围最大x坐标
-      max_y INTEGER NOT NULL, -- 领地范围最大y坐标
-      max_z INTEGER NOT NULL, -- 领地范围最大z坐标
-      name TEXT NOT NULL DEFAULT '', -- 领地名称
-      status TEXT NOT NULL DEFAULT 'active', -- 领地状态（active/locked/expired/auction）
-      created_at INTEGER NOT NULL, -- 领地创建时间戳
-      updated_at INTEGER NOT NULL, -- 领地更新时间戳
-      expires_at INTEGER, -- 领地过期时间戳（null=永不过期）
-      protection_profile TEXT NOT NULL DEFAULT '{}', -- 保护配置（json）
-      version INTEGER NOT NULL DEFAULT 1, -- 乐观锁版本号
-      purchase_price INTEGER NOT NULL DEFAULT 0, -- 购买价格
-      refund_rate REAL NOT NULL DEFAULT 0.7, -- 退款比例（0~1）
-      tax_rate INTEGER NOT NULL DEFAULT 0, -- 税率（百分比）
-      tax_due_at INTEGER, -- 下一个缴税时间戳
-      tax_frozen INTEGER NOT NULL DEFAULT 0 -- 税务冻结状态（0=正常,1=冻结）
-    )`);
-    // 领地成员表
-    db.exec(/* sql */ `
+      id TEXT PRIMARY KEY, -- \u9886\u5730\u552F\u4E00id
+      owner_player_id TEXT NOT NULL, -- \u9886\u5730\u6240\u6709\u8005\u73A9\u5BB6id
+      owner_name_snapshot TEXT NOT NULL DEFAULT '', -- \u6240\u6709\u8005\u540D\u79F0\u5FEB\u7167
+      dimension INTEGER NOT NULL, -- \u6240\u5728\u7EF4\u5EA6\uFF080=\u4E3B\u4E16\u754C,1=\u4E0B\u754C,2=\u672B\u5730\uFF09
+      min_x INTEGER NOT NULL, -- \u9886\u5730\u8303\u56F4\u6700\u5C0Fx\u5750\u6807
+      min_y INTEGER NOT NULL, -- \u9886\u5730\u8303\u56F4\u6700\u5C0Fy\u5750\u6807
+      min_z INTEGER NOT NULL, -- \u9886\u5730\u8303\u56F4\u6700\u5C0Fz\u5750\u6807
+      max_x INTEGER NOT NULL, -- \u9886\u5730\u8303\u56F4\u6700\u5927x\u5750\u6807
+      max_y INTEGER NOT NULL, -- \u9886\u5730\u8303\u56F4\u6700\u5927y\u5750\u6807
+      max_z INTEGER NOT NULL, -- \u9886\u5730\u8303\u56F4\u6700\u5927z\u5750\u6807
+      name TEXT NOT NULL DEFAULT '', -- \u9886\u5730\u540D\u79F0
+      status TEXT NOT NULL DEFAULT 'active', -- \u9886\u5730\u72B6\u6001\uFF08active/locked/expired/auction\uFF09
+      created_at INTEGER NOT NULL, -- \u9886\u5730\u521B\u5EFA\u65F6\u95F4\u6233
+      updated_at INTEGER NOT NULL, -- \u9886\u5730\u66F4\u65B0\u65F6\u95F4\u6233
+      expires_at INTEGER, -- \u9886\u5730\u8FC7\u671F\u65F6\u95F4\u6233\uFF08null=\u6C38\u4E0D\u8FC7\u671F\uFF09
+      protection_profile TEXT NOT NULL DEFAULT '{}', -- \u4FDD\u62A4\u914D\u7F6E\uFF08json\uFF09
+      version INTEGER NOT NULL DEFAULT 1, -- \u4E50\u89C2\u9501\u7248\u672C\u53F7
+      purchase_price INTEGER NOT NULL DEFAULT 0, -- \u8D2D\u4E70\u4EF7\u683C
+      refund_rate REAL NOT NULL DEFAULT 0.7, -- \u9000\u6B3E\u6BD4\u4F8B\uFF080~1\uFF09
+      tax_rate INTEGER NOT NULL DEFAULT 0, -- \u7A0E\u7387\uFF08\u767E\u5206\u6BD4\uFF09
+      tax_due_at INTEGER, -- \u4E0B\u4E00\u4E2A\u7F34\u7A0E\u65F6\u95F4\u6233
+      tax_frozen INTEGER NOT NULL DEFAULT 0 -- \u7A0E\u52A1\u51BB\u7ED3\u72B6\u6001\uFF080=\u6B63\u5E38,1=\u51BB\u7ED3\uFF09
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_land_members (
-      land_id TEXT NOT NULL, -- 领地id
-      player_id TEXT NOT NULL, -- 成员玩家id
-      player_name_snapshot TEXT NOT NULL DEFAULT '', -- 成员名称快照
-      role TEXT NOT NULL DEFAULT 'admin', -- 成员角色（member/trusted/admin/owner）
-      created_at INTEGER NOT NULL, -- 加入时间戳
-      expires_at INTEGER, -- 成员资格过期时间戳
-      PRIMARY KEY (land_id, player_id), -- 联合主键
-      FOREIGN KEY (land_id) REFERENCES sfmc_lands(id) ON DELETE CASCADE -- 级联删除
-    )`);
-    // 领地权限表
-    db.exec(/* sql */ `
+      land_id TEXT NOT NULL, -- \u9886\u5730id
+      player_id TEXT NOT NULL, -- \u6210\u5458\u73A9\u5BB6id
+      player_name_snapshot TEXT NOT NULL DEFAULT '', -- \u6210\u5458\u540D\u79F0\u5FEB\u7167
+      role TEXT NOT NULL DEFAULT 'admin', -- \u6210\u5458\u89D2\u8272\uFF08member/trusted/admin/owner\uFF09
+      created_at INTEGER NOT NULL, -- \u52A0\u5165\u65F6\u95F4\u6233
+      expires_at INTEGER, -- \u6210\u5458\u8D44\u683C\u8FC7\u671F\u65F6\u95F4\u6233
+      PRIMARY KEY (land_id, player_id), -- \u8054\u5408\u4E3B\u952E
+      FOREIGN KEY (land_id) REFERENCES sfmc_lands(id) ON DELETE CASCADE -- \u7EA7\u8054\u5220\u9664
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_land_permissions (
-      land_id TEXT NOT NULL, -- 领地id
-      permission_key TEXT NOT NULL, -- 权限键（如 buildbreak.interact 等）
-      subject_type TEXT NOT NULL, -- 权限主体类型（player/group/role/all）
-      subject_id TEXT NOT NULL, -- 权限主体id
-      allowed INTEGER NOT NULL DEFAULT 0, -- 是否允许（1=允许,0=拒绝,-1=未设置）
-      updated_at INTEGER NOT NULL, -- 权限更新时间戳
-      PRIMARY KEY (land_id, permission_key, subject_type, subject_id), -- 联合主键
-      FOREIGN KEY (land_id) REFERENCES sfmc_lands(id) ON DELETE CASCADE -- 级联删除
-    )`);
-    // 领地邀请表
-    db.exec(/* sql */ `
+      land_id TEXT NOT NULL, -- \u9886\u5730id
+      permission_key TEXT NOT NULL, -- \u6743\u9650\u952E\uFF08\u5982 buildbreak.interact \u7B49\uFF09
+      subject_type TEXT NOT NULL, -- \u6743\u9650\u4E3B\u4F53\u7C7B\u578B\uFF08player/group/role/all\uFF09
+      subject_id TEXT NOT NULL, -- \u6743\u9650\u4E3B\u4F53id
+      allowed INTEGER NOT NULL DEFAULT 0, -- \u662F\u5426\u5141\u8BB8\uFF081=\u5141\u8BB8,0=\u62D2\u7EDD,-1=\u672A\u8BBE\u7F6E\uFF09
+      updated_at INTEGER NOT NULL, -- \u6743\u9650\u66F4\u65B0\u65F6\u95F4\u6233
+      PRIMARY KEY (land_id, permission_key, subject_type, subject_id), -- \u8054\u5408\u4E3B\u952E
+      FOREIGN KEY (land_id) REFERENCES sfmc_lands(id) ON DELETE CASCADE -- \u7EA7\u8054\u5220\u9664
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_land_invites (
-      id TEXT PRIMARY KEY, -- 邀请唯一id
-      land_id TEXT NOT NULL, -- 领地id
-      inviter_id TEXT NOT NULL, -- 邀请人id
-      invitee_id TEXT NOT NULL, -- 被邀请人id
-      role TEXT NOT NULL, -- 邀请角色
-      expires_at INTEGER NOT NULL, -- 邀请过期时间戳
-      status TEXT NOT NULL DEFAULT 'pending', -- 状态（pending/accepted/rejected/expired）
-      created_at INTEGER NOT NULL, -- 创建时间戳
-      FOREIGN KEY (land_id) REFERENCES sfmc_lands(id) ON DELETE CASCADE -- 级联删除
-    )`);
-    // 领地邀请表索引：按被邀请人+状态+过期时间查
-    db.exec(/* sql */ `
-    CREATE INDEX IF NOT EXISTS idx_sfmc_land_invites_target ON sfmc_land_invites(invitee_id, status, expires_at)`);
-    // 领地操作审计日志表
-    db.exec(/* sql */ `
+      id TEXT PRIMARY KEY, -- \u9080\u8BF7\u552F\u4E00id
+      land_id TEXT NOT NULL, -- \u9886\u5730id
+      inviter_id TEXT NOT NULL, -- \u9080\u8BF7\u4EBAid
+      invitee_id TEXT NOT NULL, -- \u88AB\u9080\u8BF7\u4EBAid
+      role TEXT NOT NULL, -- \u9080\u8BF7\u89D2\u8272
+      expires_at INTEGER NOT NULL, -- \u9080\u8BF7\u8FC7\u671F\u65F6\u95F4\u6233
+      status TEXT NOT NULL DEFAULT 'pending', -- \u72B6\u6001\uFF08pending/accepted/rejected/expired\uFF09
+      created_at INTEGER NOT NULL, -- \u521B\u5EFA\u65F6\u95F4\u6233
+      FOREIGN KEY (land_id) REFERENCES sfmc_lands(id) ON DELETE CASCADE -- \u7EA7\u8054\u5220\u9664
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
+    CREATE INDEX IF NOT EXISTS idx_sfmc_land_invites_target ON sfmc_land_invites(invitee_id, status, expires_at)`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_land_audit_logs (
-      id INTEGER PRIMARY KEY AUTOINCREMENT, -- 日志id（自增）
-      land_id TEXT NOT NULL, -- 领地id
-      actor_id TEXT NOT NULL, -- 操作者id
-      action TEXT NOT NULL, -- 操作类型（如 claim/release/transfer/updat 等）
-      payload TEXT NOT NULL DEFAULT '{}', -- 操作载荷（json）
-      created_at INTEGER NOT NULL, -- 日志创建时间戳
-      FOREIGN KEY (land_id) REFERENCES sfmc_lands(id) ON DELETE CASCADE -- 级联删除
-    )`);
-    // 领地操作请求表（异步操作）
-    db.exec(/* sql */ `
+      id INTEGER PRIMARY KEY AUTOINCREMENT, -- \u65E5\u5FD7id\uFF08\u81EA\u589E\uFF09
+      land_id TEXT NOT NULL, -- \u9886\u5730id
+      actor_id TEXT NOT NULL, -- \u64CD\u4F5C\u8005id
+      action TEXT NOT NULL, -- \u64CD\u4F5C\u7C7B\u578B\uFF08\u5982 claim/release/transfer/updat \u7B49\uFF09
+      payload TEXT NOT NULL DEFAULT '{}', -- \u64CD\u4F5C\u8F7D\u8377\uFF08json\uFF09
+      created_at INTEGER NOT NULL, -- \u65E5\u5FD7\u521B\u5EFA\u65F6\u95F4\u6233
+      FOREIGN KEY (land_id) REFERENCES sfmc_lands(id) ON DELETE CASCADE -- \u7EA7\u8054\u5220\u9664
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_land_operations (
-      request_id TEXT PRIMARY KEY, -- 请求唯一id
-      operation_type TEXT NOT NULL, -- 操作类型（如 claim/release/upgrade 等）
-      actor_id TEXT NOT NULL, -- 操作发起人id
-      land_id TEXT, -- 关联领地id（可选）
-      status TEXT NOT NULL, -- 请求状态（pending/processing/completed/failed）
-      response_json TEXT NOT NULL, -- 操作响应结果（json）
-      created_at INTEGER NOT NULL -- 请求创建时间戳
-    )`);
-    // (10 玩家命令使用统计
-    db.exec(/* sql */ `
+      request_id TEXT PRIMARY KEY, -- \u8BF7\u6C42\u552F\u4E00id
+      operation_type TEXT NOT NULL, -- \u64CD\u4F5C\u7C7B\u578B\uFF08\u5982 claim/release/upgrade \u7B49\uFF09
+      actor_id TEXT NOT NULL, -- \u64CD\u4F5C\u53D1\u8D77\u4EBAid
+      land_id TEXT, -- \u5173\u8054\u9886\u5730id\uFF08\u53EF\u9009\uFF09
+      status TEXT NOT NULL, -- \u8BF7\u6C42\u72B6\u6001\uFF08pending/processing/completed/failed\uFF09
+      response_json TEXT NOT NULL, -- \u64CD\u4F5C\u54CD\u5E94\u7ED3\u679C\uFF08json\uFF09
+      created_at INTEGER NOT NULL -- \u8BF7\u6C42\u521B\u5EFA\u65F6\u95F4\u6233
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_player_command_usage (
-      id INTEGER PRIMARY KEY AUTOINCREMENT, -- 记录id（自增）
-      player_id TEXT NOT NULL, -- 玩家id
-      command TEXT NOT NULL, -- 命令名称（不含/前缀）
-      date TEXT NOT NULL, -- 统计日期（YYYY-MM-DD格式）
-      count INTEGER DEFAULT 0, -- 当日该命令使用次数
-      UNIQUE(player_id, command, date) -- 唯一约束：同一玩家同一命令同一天
-    )`);
-    // (11 经济系统
-    db.exec(/* sql */ `
+      id INTEGER PRIMARY KEY AUTOINCREMENT, -- \u8BB0\u5F55id\uFF08\u81EA\u589E\uFF09
+      player_id TEXT NOT NULL, -- \u73A9\u5BB6id
+      command TEXT NOT NULL, -- \u547D\u4EE4\u540D\u79F0\uFF08\u4E0D\u542B/\u524D\u7F00\uFF09
+      date TEXT NOT NULL, -- \u7EDF\u8BA1\u65E5\u671F\uFF08YYYY-MM-DD\u683C\u5F0F\uFF09
+      count INTEGER DEFAULT 0, -- \u5F53\u65E5\u8BE5\u547D\u4EE4\u4F7F\u7528\u6B21\u6570
+      UNIQUE(player_id, command, date) -- \u552F\u4E00\u7EA6\u675F\uFF1A\u540C\u4E00\u73A9\u5BB6\u540C\u4E00\u547D\u4EE4\u540C\u4E00\u5929
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_economy_price_index (
-      item_type TEXT NOT NULL, -- 物品类型标识符
-      item_aux INTEGER DEFAULT 0, -- 物品附加值/数据值
-      base_buy_price INTEGER NOT NULL DEFAULT 0, -- 基础收购价格
-      base_sell_price INTEGER NOT NULL DEFAULT 0, -- 基础出售价格
-      current_buy_price INTEGER NOT NULL DEFAULT 0, -- 当前收购价格
-      current_sell_price INTEGER NOT NULL DEFAULT 0, -- 当前出售价格
-      elasticity REAL DEFAULT 0.3, -- 价格弹性系数
-      weekly_acquisition_cap INTEGER, -- 周收购上限
-      weekly_acquired INTEGER DEFAULT 0, -- 本周已收购数量
-      week_start INTEGER, -- 本周开始时间戳
-      rarity TEXT DEFAULT 'common', -- 稀有度（common/uncommon/rare/epic/legendary）
-      is_renewable INTEGER DEFAULT 1, -- 是否可再生
-      updated_at INTEGER, -- 索引更新时间戳
-      PRIMARY KEY (item_type, item_aux) -- 联合主键
-    )`);
-    // 经济日常任务表
-    db.exec(/* sql */ `
+      item_type TEXT NOT NULL, -- \u7269\u54C1\u7C7B\u578B\u6807\u8BC6\u7B26
+      item_aux INTEGER DEFAULT 0, -- \u7269\u54C1\u9644\u52A0\u503C/\u6570\u636E\u503C
+      base_buy_price INTEGER NOT NULL DEFAULT 0, -- \u57FA\u7840\u6536\u8D2D\u4EF7\u683C
+      base_sell_price INTEGER NOT NULL DEFAULT 0, -- \u57FA\u7840\u51FA\u552E\u4EF7\u683C
+      current_buy_price INTEGER NOT NULL DEFAULT 0, -- \u5F53\u524D\u6536\u8D2D\u4EF7\u683C
+      current_sell_price INTEGER NOT NULL DEFAULT 0, -- \u5F53\u524D\u51FA\u552E\u4EF7\u683C
+      elasticity REAL DEFAULT 0.3, -- \u4EF7\u683C\u5F39\u6027\u7CFB\u6570
+      weekly_acquisition_cap INTEGER, -- \u5468\u6536\u8D2D\u4E0A\u9650
+      weekly_acquired INTEGER DEFAULT 0, -- \u672C\u5468\u5DF2\u6536\u8D2D\u6570\u91CF
+      week_start INTEGER, -- \u672C\u5468\u5F00\u59CB\u65F6\u95F4\u6233
+      rarity TEXT DEFAULT 'common', -- \u7A00\u6709\u5EA6\uFF08common/uncommon/rare/epic/legendary\uFF09
+      is_renewable INTEGER DEFAULT 1, -- \u662F\u5426\u53EF\u518D\u751F
+      updated_at INTEGER, -- \u7D22\u5F15\u66F4\u65B0\u65F6\u95F4\u6233
+      PRIMARY KEY (item_type, item_aux) -- \u8054\u5408\u4E3B\u952E
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_economy_daily_tasks (
-      id TEXT PRIMARY KEY, -- 任务唯一id
-      item_type TEXT NOT NULL, -- 目标物品类型
-      item_aux INTEGER DEFAULT 0, -- 物品附加值
-      target_qty INTEGER NOT NULL, -- 目标数量
-      filled_qty INTEGER DEFAULT 0, -- 已完成数量
-      unit_reward INTEGER NOT NULL, -- 单位奖励金额
-      created_at INTEGER, -- 任务创建时间戳
-      expires_at INTEGER, -- 任务过期时间戳
-      status TEXT DEFAULT 'active' -- 任务状态（active/completed/expired）
-    )`);
-    // 经济系统全局统计表
-    db.exec(/* sql */ `
+      id TEXT PRIMARY KEY, -- \u4EFB\u52A1\u552F\u4E00id
+      item_type TEXT NOT NULL, -- \u76EE\u6807\u7269\u54C1\u7C7B\u578B
+      item_aux INTEGER DEFAULT 0, -- \u7269\u54C1\u9644\u52A0\u503C
+      target_qty INTEGER NOT NULL, -- \u76EE\u6807\u6570\u91CF
+      filled_qty INTEGER DEFAULT 0, -- \u5DF2\u5B8C\u6210\u6570\u91CF
+      unit_reward INTEGER NOT NULL, -- \u5355\u4F4D\u5956\u52B1\u91D1\u989D
+      created_at INTEGER, -- \u4EFB\u52A1\u521B\u5EFA\u65F6\u95F4\u6233
+      expires_at INTEGER, -- \u4EFB\u52A1\u8FC7\u671F\u65F6\u95F4\u6233
+      status TEXT DEFAULT 'active' -- \u4EFB\u52A1\u72B6\u6001\uFF08active/completed/expired\uFF09
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_economy_stats (
-      id TEXT PRIMARY KEY, -- 统计项id（目前固定为'global'）
-      total_issued INTEGER DEFAULT 0, -- 累计发行货币量
-      total_destroyed INTEGER DEFAULT 0, -- 累计销毁货币量
-      total_supply INTEGER DEFAULT 0, -- 当前总供应量
-      active_accounts INTEGER DEFAULT 0, -- 活跃账户数
-      computed_at INTEGER -- 统计计算时间戳
-    )`);
-    // 经济账户表
-    db.exec(/* sql */ `
+      id TEXT PRIMARY KEY, -- \u7EDF\u8BA1\u9879id\uFF08\u76EE\u524D\u56FA\u5B9A\u4E3A'global'\uFF09
+      total_issued INTEGER DEFAULT 0, -- \u7D2F\u8BA1\u53D1\u884C\u8D27\u5E01\u91CF
+      total_destroyed INTEGER DEFAULT 0, -- \u7D2F\u8BA1\u9500\u6BC1\u8D27\u5E01\u91CF
+      total_supply INTEGER DEFAULT 0, -- \u5F53\u524D\u603B\u4F9B\u5E94\u91CF
+      active_accounts INTEGER DEFAULT 0, -- \u6D3B\u8DC3\u8D26\u6237\u6570
+      computed_at INTEGER -- \u7EDF\u8BA1\u8BA1\u7B97\u65F6\u95F4\u6233
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_economy_accounts (
-      player_id TEXT PRIMARY KEY, -- 玩家id（主键）
-      player_name_snapshot TEXT NOT NULL DEFAULT '', -- 玩家名称快照
-      balance INTEGER NOT NULL DEFAULT 0 CHECK(balance >= 0), -- 账户余额（>=0）
-      version INTEGER NOT NULL DEFAULT 1, -- 乐观锁版本号
-      created_at INTEGER NOT NULL, -- 账户创建时间戳
-      updated_at INTEGER NOT NULL -- 账户更新时间戳
-    )`);
-    // 经济交易流水表
-    db.exec(/* sql */ `
+      player_id TEXT PRIMARY KEY, -- \u73A9\u5BB6id\uFF08\u4E3B\u952E\uFF09
+      player_name_snapshot TEXT NOT NULL DEFAULT '', -- \u73A9\u5BB6\u540D\u79F0\u5FEB\u7167
+      balance INTEGER NOT NULL DEFAULT 0 CHECK(balance >= 0), -- \u8D26\u6237\u4F59\u989D\uFF08>=0\uFF09
+      version INTEGER NOT NULL DEFAULT 1, -- \u4E50\u89C2\u9501\u7248\u672C\u53F7
+      created_at INTEGER NOT NULL, -- \u8D26\u6237\u521B\u5EFA\u65F6\u95F4\u6233
+      updated_at INTEGER NOT NULL -- \u8D26\u6237\u66F4\u65B0\u65F6\u95F4\u6233
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_economy_transactions (
-      id TEXT PRIMARY KEY, -- 交易唯一id
-      transaction_type TEXT NOT NULL, -- 交易类型（transfer/payment/reward/purchase等）
-      actor_id TEXT NOT NULL, -- 交易发起人id
-      source_player_id TEXT, -- 源玩家id（付款方）
-      target_player_id TEXT, -- 目标玩家id（收款方）
-      amount INTEGER NOT NULL CHECK(amount > 0), -- 交易金额（>0）
-      balance_before INTEGER, -- 交易前余额
-      balance_after INTEGER, -- 交易后余额
-      reference_type TEXT NOT NULL DEFAULT '', -- 关联业务类型
-      reference_id TEXT NOT NULL DEFAULT '', -- 关联业务id
-      reason TEXT NOT NULL DEFAULT '', -- 交易原因/备注
-      created_at INTEGER NOT NULL -- 交易时间戳
-    )`);
-    // 经济幂等表（防止重复交易）
-    db.exec(/* sql */ `
+      id TEXT PRIMARY KEY, -- \u4EA4\u6613\u552F\u4E00id
+      transaction_type TEXT NOT NULL, -- \u4EA4\u6613\u7C7B\u578B\uFF08transfer/payment/reward/purchase\u7B49\uFF09
+      actor_id TEXT NOT NULL, -- \u4EA4\u6613\u53D1\u8D77\u4EBAid
+      source_player_id TEXT, -- \u6E90\u73A9\u5BB6id\uFF08\u4ED8\u6B3E\u65B9\uFF09
+      target_player_id TEXT, -- \u76EE\u6807\u73A9\u5BB6id\uFF08\u6536\u6B3E\u65B9\uFF09
+      amount INTEGER NOT NULL CHECK(amount > 0), -- \u4EA4\u6613\u91D1\u989D\uFF08>0\uFF09
+      balance_before INTEGER, -- \u4EA4\u6613\u524D\u4F59\u989D
+      balance_after INTEGER, -- \u4EA4\u6613\u540E\u4F59\u989D
+      reference_type TEXT NOT NULL DEFAULT '', -- \u5173\u8054\u4E1A\u52A1\u7C7B\u578B
+      reference_id TEXT NOT NULL DEFAULT '', -- \u5173\u8054\u4E1A\u52A1id
+      reason TEXT NOT NULL DEFAULT '', -- \u4EA4\u6613\u539F\u56E0/\u5907\u6CE8
+      created_at INTEGER NOT NULL -- \u4EA4\u6613\u65F6\u95F4\u6233
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc_economy_idempotency (
-      actor_id TEXT NOT NULL, -- 操作者id
-      idempotency_key TEXT NOT NULL, -- 幂等键
-      transaction_id TEXT NOT NULL, -- 已处理的交易id
-      response_json TEXT NOT NULL, -- 处理结果（json）
-      created_at INTEGER NOT NULL, -- 记录创建时间戳
-      PRIMARY KEY (actor_id, idempotency_key) -- 联合主键
-    )`);
-    // 经济相关索引
-    db.exec(/* sql */ `
+      actor_id TEXT NOT NULL, -- \u64CD\u4F5C\u8005id
+      idempotency_key TEXT NOT NULL, -- \u5E42\u7B49\u952E
+      transaction_id TEXT NOT NULL, -- \u5DF2\u5904\u7406\u7684\u4EA4\u6613id
+      response_json TEXT NOT NULL, -- \u5904\u7406\u7ED3\u679C\uFF08json\uFF09
+      created_at INTEGER NOT NULL, -- \u8BB0\u5F55\u521B\u5EFA\u65F6\u95F4\u6233
+      PRIMARY KEY (actor_id, idempotency_key) -- \u8054\u5408\u4E3B\u952E
+    )`
+  );
+  db.exec(
+    /* sql */
+    `
     CREATE INDEX IF NOT EXISTS idx_economy_transactions_player ON sfmc_economy_transactions(source_player_id, created_at DESC);
     CREATE INDEX IF NOT EXISTS idx_economy_transactions_target ON sfmc_economy_transactions(target_player_id, created_at DESC);
     CREATE INDEX IF NOT EXISTS idx_sfmc_lands_owner ON sfmc_lands(owner_player_id, status);
-    CREATE INDEX IF NOT EXISTS idx_sfmc_lands_location ON sfmc_lands(dimension, min_x, max_x, min_z, max_z, status)`);
+    CREATE INDEX IF NOT EXISTS idx_sfmc_lands_location ON sfmc_lands(dimension, min_x, max_x, min_z, max_z, status)`
+  );
 }
-//# sourceMappingURL=schema.js.map
+export {
+  initSchema
+};
+//# sourceMappingURL=schema.js.map