feat(area): consolidate 5 v1 area modules into feature-area v2

[Tanya7z]

概要

按用户 2026-07-21 已批准的决定 —— "把 peace/fly/survival 这三个模块合在一起成为 area 模块" —— 将 5 个基于区域的 v1 模块合并为单一 v2 模块 feature-area:

v1 模块	旧目录	归入
feature-area-fly	modules/packages/fly/	flyLifecycle
feature-area-creative	modules/packages/creative/	creativeLifecycle
feature-area-survival	modules/packages/survival/	survivalLifecycle
feature-area-peace	modules/packages/peace/	peaceLifecycle
feature-clean	modules/packages/clean/	cleanLifecycle

遵循 HANDOFF.md(§5 land 模板 + §6 迁移流程 + clean-break 约束)与 docs/dev/manifest-contract.zh.md 的 v2 协议。

设计

• 单一 ModuleRegistry.register(modules/packages/feature-area/sapi/src/index.ts),内部委派给 5 个子生命周期,每个可通过统一配置独立启停。
• 统一配置 configs/area.json:areas[].features.<name> 布尔位控制每个区域启用哪些子功能;某功能在任意区域被开启即视为激活。全程经 SDK config.get 读取,不再使用 legacy ConfigManager.getAreas()。
• manifest v2:services.provides = area.byName / area.byPoint;permissions = config:read:area;无 routes/migrations/handlers 等 v1 字段。

跨模块依赖说明

• creative ↔ survival(同模块内耦合):survival 依据 creative 的连锁开关 isCreativeChainEnabled()(等价 v1 CreativeArea.enable)与创造区判定强制生存。合并后改为同包内直接引用,消除原 v1 的 @sfmc/module-creative 跨包依赖。
• clean(语义差异):clean 扫全服掉落物并收纳到唯一回收箱阵列,并非"区域范围"。约定 features.clean 作为总开关;回收箱几何 / kill_list / 阈值改从 area.json 的 clean 配置块读取(原 v1 依赖 ConfigManager.getClean()/getGrid()/getSetting(),现全部走 SDK config)。
• peace 实体定义(peace_skeleton/spider/zombie.json)迁入 feature-area/resource_pack/entities/,避免功能丢失。

验证

cd db-server && npm run build(先 npm run build --workspace @sfmc/sdk)后启动 db-server,启动日志:

[manifest v2] loaded 5 modules; provides 14 services
[manifest v2] enabled: feature-afk, feature-area, feature-land, feature-spawn-protect

GET /api/sfmc/modules/catalog 确认:feature-area 存在 = true;5 个旧 id = [](全部消失)。

备注

• modules/packages/feature-area/sapi/src/index.ts 的 id: "feature-area" 会触发一个已知 typecheck 报错(ModuleId 字面量联合类型未含该 id)——这与已合并的 afk / land / spawn-protect 完全一致,属既有模式,未改动 SDK。
• modules/_manifests/module-manifests.json 是 schemaVersion 1 的历史构建产物,v2 启动不读取,按既有迁移惯例未改动。

  

[cursor]

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.