# S-31 · 城市接线与开工门槛任务书（0.4.1）

依据：docs/52原S-31、docs/66 §11（0.3.5已签收）、docs/70、docs/71本轮S-40网页端交付复核。机主2026-10-29指令：“s40完成了，你检查一下，这是网页端做的，没问题就继续，我自己看没有发现问”。认可本次素材观感，未要求逐条重复确认；仍需诚实保留技术和独立评审门槛。

本书更新docs/52：城市唯一迁移输入为本次已核验S-40源码，不再拼接旧S-28/S-29代码。仅任务版本线标0.4.1，不在本任务改发布版本号；旧文案中“0.4.0应收”不作为本次版本事实。

```text
S-31

【开工第一件事·防截断】核对已有目标：若有未完S31目标则沿用；无未完目标时create_goal（objective=S-31：关闭最终S40独立评审门槛，基于已签收0.3.5，在独立树接入当前S40城市库，交接线源码/测试/截图/预算/迁移与回滚说明）。进度落文件，update_goal只用实际支持的状态接口，大段先写文件再摘要；所有要求完成才complete，不因到时或本次准备完成就标整任务完成。

你是S-31实现主协调者。先完整读本书、docs/52、docs/66 §11、docs/70、docs/71，以及下述交付包README、总报告、迁移增量清单、CITY_API、U1/UX和问题处理表。中文回复，每30分钟写tasks-out/S-31/进度.md。

【一、机主已定与开工门槛】
0.3.5已由机主验收签收，不再要求重验S30。素材沿用当前认可外观，不借接线重做模型；不自动执行所有历史P2。
城市输入包：/vol1/ai/deliverables/files/s40-cbe5c/s40网页端交付.zip
SHA256必须为7d639e732ff6db1c83dc700ac3f313762c73fabc1edc154a25c6343b3ac1ff6d。
该包工程/仅城市子树，不是完整游戏；134独立HTML不是游戏接线源码。读取工程/src/render/city/的19个TS和CITY_API，必须绑定整包及逐文件SHA，不从旧demo或临时修改树猜版本。
阶段0可以立即做：核实owner和目标树占用、隔离解包核验、整理迁移/级别/坐标映射、只读基线测试、准备新树、补真实独立评审。**当前最终U1/UX双独立签字尚未闭环；网页端的两份接手说明不能当成两名独立评审。** 原主安排两名独立只读评审同一冻结快照，U1评认楼/四视图/昼夜/升级与本次已修项，UX评目录/复位/返回/命中/遮挡。出证据与处理表先给机主、交总监复核门槛后，才进入阶段1写接线实现。已有历史评审可作背景，不能冒充当前快照签字。不得因机主说看着没问题而擅自填U1 P0/P1=0，也不反复要求机主重复验模型。

【二、实现要点：在游戏里装配，不做另一个demo】
- 完整游戏基线固定/vol1/ai/projects/wyszz-new/frontend-rebuild-hm035，发布树只读；目标/vol1/ai/projects/wyszz-new/frontend-rebuild-hm042。先检查是否存在及是否有人写，有现有任务不覆盖、不再rsync；空闲且尚不存在才从hm035建立独立树，排除dist/evidence，记录基线SHA与复制命令。不创建第二棵同编号树掩盖冲突。
- 门槛关闭后，将包中整个src/render/city原样搬入目标树，保留源码SHA；CITY_API中“15个TS”笔误在目标树勘误为实盘19，并列文档diff，不改原冻结。宿主只通过buildCity(ctx)装配；适配器处理游戏实体到BlockDesc的转换，不把测试planBlocks(full85)当游戏地块数据，不重写生产内容工厂。
- world层只做装配、可见性、更新、选中与销毁。保留原0.3.5岛体/地块顶面/碰撞/购地边界，保留原几何用于rollback=classic对照；默认只绘城市层。回退是内部诊断路径，不新增玩家重复入口。
- 映射先从实际游戏状态和规则文件提炼：建筑类型、稳定blockId、世界中心坐标、尺寸、街区/建筑/市政厅等级、tier0..4、variant/seed。交映射表及数据来源，不能临时发明经济等级公式或把所有模型设成最高档。包内生产rot按90度取整；若宿主方向含60度，须先证明坐标与朝向适配，不能把60直接传进90取整接口并宣称原样迁移。外层变换/道路连接/车人通行需实际相邻地块证据，不改原岛形或逻辑格子凑画面。确需修改城市库接口先列根因、影响与失败证据，由总监裁决，不能偷偷改模型。
- 交互逐项接回：点楼→正确blockId/抽屉建筑行/特写；开业、升级确认、购地选择、报价、一键买地、目标提示、报告、角色卡与抽屉手风琴保持现有语义。合并网格pickables可能不是85个；广场无代理等事实查实映射，不把代理数强行补成地块数。raycast只传当前有效代理；不可见classic不能幽灵命中；实际最高模型、重建后引用、hall高亮与特写取景都要测。
- 设置沿用单一抽屉“其他”入口：A/B/C画风（默认B）、车流关/低/高（默认低）、行人关/低/高（默认低），立即生效。先查已有实现，避免重复入口/双设置；独立键wyszz.settings.v1，不改游戏存档schema。微信wx存储/网页localStorage，坏值或读写失败按明确默认回退，保留正常/异常验证。仅将已有昼夜能力按现有设计接入，不另增未授权玩家功能。
- 生命周期按CITY_API：一处驱动update(dt)，设置车/人不无谓重建整城；重建后update/pickables/root始终指向新实例，先摘旧再释放；实例dispose释放自有，最后一个共享owner退出再disposeCityMaterials。不得把root空当GPU显存已证实释放。真实统计区分快照city.stats、实时density与renderer含阴影整帧。

【三、写入范围与保护】
实现仅/vol1/ai/projects/wyszz-new/frontend-rebuild-hm042/**；证据仅/vol1/ai/projects/wyszz-new/frontend-rebuild-hm/tasks-out/S-31/**的新批次；临时/tmp/s31/**。原hm035、hm044-city、本次zip/解包冻结证据、其它树只读。
保护经济/契约/存档schema/调试事件清单/land_config_v3.json/岛体函数/版本号，不新增依赖、不联网取资源、不加外部模型或贴图。Node PATH=/mnt/ssd/apps/nodejs_v24/bin:$PATH。只允许为预算测量在隔离输出生成临时web/wechat JS，不登记正式游戏ZIP、不发布、不出码、不提交合并。

【四、分工与玩家视角自检】
同一工作树仅一个实现writer（主对话），同时负责适配器/设置/集成测试；其他协作者不得写实现，不跨树改文件，不嵌套派发，提示词原样转发，主对话抽查关键数字。
- T1只读测试/性能：只写tasks-out/S-31/T1/**，核基线与当前、给失败根因和实际计数，不改断言或凑版本。
- U1独立玩家锐评：只写tasks-out/S-31/U1/**；阶段0先审当前S40冻结，阶段1稳定后再审游戏快照。所有P0/P1/P2带证据、复现和建议；不改代码、不判通过/不通过；先报机主，未裁量不全改。
- UX独立玩家＋手游UX：只写tasks-out/S-31/UX/**；不得与U1/实现者同一评审上下文冒充独立。提交控件存在理由表、≥44×44 CSS px命中、遮挡/重复入口/反馈/返回/文字与数字完整性。明确本轮待裁量项，不擅自勾通过。
实现者先按玩家路径自检“首次进入→点楼→抽屉→开业/升级→特写→退出→购地→切设置→重启→回退对照”。沿用0.3.5原布局，禁止研发术语进入玩家UI。

【五、验证标准与预算】
原55模块测试及本包66专项保留，不删断言、不放宽既有预算；城市子树strict类型检查与完整游戏typecheck分别给结果。新增e2e覆盖真实映射、跨档变形、购地新增/保存重启、切风格/车人0低高/损坏设置、重建新引用、真实选中/特写/回退及资源回收。修bug先留失败用例再最小修改。
在hm035相同环境建立基线，跑docs/52旧功能套件及现行抽屉/开业/升级/取景相关套件；环境红逐条与基线对账，不把L06e/t-island/软件FPS等既有红记通过，也不能把新失败都归环境。缺入口或前提按事实报，不能造一条全绿命令。
游戏内85地块：可见模型三角≤150000、draw calls≤70、材质≤12、桌面城市构建≤300ms；主绘制整帧和阴影整帧另列，纳入岛体/UI的实际成本，不能用模块100052/10/4冒充整个游戏。正式微信game.js增量≤150KB（以同构建配置原始字节差记录，本轮按150000B核验，gzip另列）。基线与目标都用隔离同命令构建，不篡改版本元数据凑差值；若预算超出如实失败，先报告再裁决，不删功能。
五机位×A/B/C、车人档位、满岛俯视、典型小屏抽屉与特写截图，绑定源码/产物/测试SHA；C夜景暗部需当前游戏实图，不能将未验证写已解决。对比classic与city同场景/机位/灯光口径，标清阴影和环境。
任何取景/手势改动交“边界顶手感”＋旋转10s/拖动或缩放10s/静置5s逐帧时间、≥50ms长帧和包围盒/矩阵更新调用计数；不得在操作主循环每帧遍历整城重算包围盒。软件FPS不推断手机60FPS，微信真机/触屏/GPU释放由机主后续测，写未验证。

【六、交付与裁决】
阶段0交门槛清单、最终独立U1/UX和处理表、基线SHA、包源码映射、坐标/等级/点击/生命周期方案与阻塞；未闭环时只交准备成果，不报“接线完成”。
阶段1交相对hm035的可审阅diff/payload及SHA、源码、测试原始日志、失败对照、截图/性能表、迁移说明（来源文件→接入点、tier/坐标/设置映射、回退步骤、资源owner、未验证项）、独立U1/UX与机主待裁量表、总报告。payload前先读并核实现有make-payload工具能力，不能照抄旧脚本打入其它任务文件；保留原功能，不把“源码能构建”当“游戏交互已验收”。
所有最终实体文件deliver-link --tailscale登记，给完整绝对路径、Tailscale主链、Cloudflare备用。总监独立验收及机主游戏真机验收仍分开；本任务不出正式游戏包或二维码。

【七、时间盒与阻塞】
沿用docs/52的8小时任务预算（不是已花耗时），阶段0优先，门槛未闭环不抢写。每30分钟报当前证据/剩余项，卡住>25分钟记根因与可行下一步。先保默认B建筑接入/原功能/选中/设置/车人档位，地标工业如受阻只能明确延期交机主裁量，不悄悄删需求、不假报全部完成。
```
