2026-W37 周报

1．本周工作进展：

    a. 【主线】TeleportController 结构重构
       模块：传送 / TeleportController
       需求：TeleportController 原文件 3526 行，职责混合、回调嵌套；目标是在保持既有行为的前提下按职责拆分，控制器只保留门面与编排入口。
       实现细节：抽出 TeleportPresentation、TeleportGroundProbe、TeleportSameSceneFlow、TeleportSequenceFlow、TeleportSeq3Binder、TeleportTransitionFlow。
       公共 API（接口）、协议、事件、超时、Seq3、sweep=false 等时序保护保持不变；事件回调与 resolver（完成回调）统一使用固定的 private readonly 箭头函数，消除临时匿名完成回调，保证注册、注销与完成通知使用稳定引用。
       结果：控制器由 3526 行降至 467 行，新增模块职责清楚，表现、地面探测、同图流程、序列流程、Seq3 绑定与转场流程各自独立。
       验收：Prettier（格式检查）通过；ESLint（静态规则检查）0 个错误；npm run tsc-native 通过；7 个 JavaScript（脚本）产物已更新。PIE（编辑器内运行）功能回归待测。

    b. 【关卡工具】多人传送 Action 编辑器配置支持
       模块：编辑器 Scheme（配置结构）· 多人传送 Action
       需求：现有传送 Action 只按单点处理，多人执行时会重叠。为 SetEntityPos、TeleportLevel、TeleportDungeon 增加“半径内随机 / 阵型”两种落点模式，并补齐统一朝向、黑屏类型和阵型指示编辑。
       实现细节：SetEntityPos 保持根级可选 LandingConfig：随机模式保存 Radius，阵型点相对 PositionVariable；旧 ScatterRadius 可自动修复迁入随机模式并删除旧字段。TeleportLevel、TeleportDungeon 的“传送类型”新增 MultiLanding（多人落点）：顶层共用 TargetPosition；随机模式内配置 Position + Radius，阵型模式不配置目标点，直接保存世界坐标 FormationPoints 与世界旋转 FormationRotations。阵型点新增时按 120cm 蛇形 X/Y 偏移，从候选点上方 400cm 向下检测至下方 1000cm，命中后只修正 Z；位置与旋转回写统一保留两位小数。随机半径默认值为 500cm。三个 Action 均支持可选 BlackScreenType；另为 SetPlayerPos 增加“建议使用 SetEntityPos”提示，并开放 TeleportDungeon 在玩法行为树中的配置入口。
       结果：三类 Action 已覆盖半径随机与阵型多人落点；TeleportLevel、TeleportDungeon 通过独立 MultiLanding 类型与其他四种传送类型隔离，旧数据可自动迁移。阵型人数不写死 8 人，新增点避免默认重叠与埋地。
       验收：相关 TypeScript（脚本）文件通过 Prettier（格式检查）；重复声明和重复字段已清理。完整 tsc-native 当前被两个无关 GM 接口缺失阻塞，使用项目 compile-skip-diagnostic 成功生成产物；LevelPlay.js、TeleportLanding.js、Action.js 已核对 MultiLanding、默认半径 500、两位小数、旧配置迁移、阵型偏移与贴地逻辑。

    c. 【主线】b1179677，燧火域关卡屏蔽主动传送
       模块：关卡 · 传送限制
       需求：对关卡 40065008、40065015、40065015 屏蔽传送功能，无法从这些地图主动传送到其他地图。


2．下周工作计划：
    a. 完成同图无缝、跨图 Seq（序列）、淡入淡出、复活、连续传送、试用角色 / 换装场景的 PIE（编辑器内运行）回归。
    b. 回归发现问题时只修复重构引入的行为差异，不扩展需求。

3．待讨论的问题/需要分享的内容：
    无。