# S-40 · 逐模块拆分、命名与机主逐项验收任务书

机主决定（2026-10-28）：现有模块素材挺好；先把每个模块单独拆开并命名，由机主挨个验收。本任务不代表原U1/UX问题获准全部修复，也不代表S-40整单已经通过。

将以下代码块全文转交**原S-40实现主对话**。总监不亲自派子智能体，不改实现。

```text
S-40（续作：逐模块拆分、命名与机主逐项验收）

【开工第一件事·防截断】先核对原持久目标：未完成则沿用并记录本轮范围；原目标完成或不存在时，用create_goal建立“逐模块盘点、稳定命名、独立离线HTML、素材目录、逐项验收表、截图与独立评审”的持久目标，不覆盖未完成目标。里程碑先落文件再摘要；update_goal仅按工具实际支持的状态更新，进度写文件，不虚构API；全部交付完成才complete，机主素材验收状态仍写待验。

你是原S-40实现主协调者。工作树固定：/vol1/ai/projects/wyszz-new/frontend-rebuild-hm044-city。中文回复。先读docs/65、68最新§6以后、69及本书，再通读src/render/city的工厂、tier/variant/seed、实例化与材质所有权。核实原owner是否仍在写，同一工作树不得并行另开写任务，不重rsync。

【一、机主已定】
现有素材保留原形，先拆开看、逐个验收。采用“完整可复用素材”粒度，不把每片窗、每层楼、每个三角形拆成素材。不得借此重建建筑、重配色、重做夜景或执行原U1全量整改；独立展示所必需的相机/目录交互在本轮范围内。素材展示≠游戏接线≠整单通过。

【二、实现要点】
1. 先交真实盘点：住宅、商业、市政厅、公园、地标、工业按源码实际tier与不同几何variant分条；树/路灯/长椅/花坛、轿车/厢式车、行人等按实际存在且可复用的种类拆出；道路/地块/广场/岸线等查实后纳入。仅颜色或seed位置变化不重复计几何素材；seed若改变真实形态，记录变化维度、代表值与选择理由，不穷举无限seed。材质、灯光、布局算法作为支持项另列，不混入模型总数。每个源码工厂/素材组须对应“已拆分/支持项/重复别名/未能拆出及原因”，不得漏项或凭预想报总数。
2. 稳定编号＋中文名称＋来源映射。编号示例RES-T0-V00、COM-T2-V00、HALL-T4-V00、PROP-TREE-01，仅作命名模板，不是已确认库存。每个真实档位至少独立一项；tier0保留T0，不擅自改成Lv1。中文名按实物命名（类别＋层级/形态），不得把厂房硬叫有码头，不用F5/A1/契约等研发词。记录源文件、工厂、参数、variant、seed、几何/材质来源、所属组与依赖；颜色风格A/B/C作为同一素材的展示配置，不乘三虚增素材数。编号发布后稳定，不因排序或中文改名重编号。
3. 每项独立文件：输出modules/<稳定编号>-<中文短名>.html，单文件内联、可file://离线打开，无CDN/网络依赖；页面只实例化当前素材及必要的中性展示环境，不能把整城藏起来冒充独立素材。现有InstancedMesh允许按原geometry/material/instanceMatrix提取单实例并正确应用变换，保持原形、比例和色彩；不得照图另造近似模型，不为导出而侵入生产工厂。原模型自带底座/花园保留并在清单注明；额外展台单独标记且不计模型统计。工厂无法独立调用时在展示工具层适配，困难如实列明。格式以独立HTML满足本轮验收，不擅自把任务扩大成GLB/贴图资产管线。
4. 一个离线总目录index.html：分类、搜索、编号/中文名、缩略图、上一项/下一项、进度N/总数、一键回到目录；点击素材能打开对应本地HTML，所有相对路径都在交付zip中。每项还给真正登记的直接下载链接，不能拼接虚假URL。默认B白天、中性背景和稳定seed；提供正面/背面/侧面/俯视预设、旋转、缩放与复位，不自动旋转。A/B/C昼夜仅作可选对照，控制统一，不强迫机主反复切换才能看清。支持项不做无效按钮。让机主看到“编号＋名称＋模型”，长名可换行，数字不省略，控制区不遮主体。
5. 每项正面/背面/侧面/俯视各一张截图；统一光照规则/机位方向，按实际包围盒适配大小并保留比例与尺寸信息，不截顶、不悬浮、不穿展台。缩略图选能辨认形态的机位，不能只截图而没有可旋转的独立HTML。
6. 素材清单.json作为唯一映射来源，导出素材总表.md及验收表.csv（UTF-8 BOM）。字段含编号、中文名、分类、tier、variant、seed、源工厂/文件、尺寸、模块三角/绘制/材质数、HTML相对路径、四视图路径、真实下载链接、验收状态、机主意见。计数用实际几何与实例计算，模型/展台/阴影整帧分列。状态默认“待机主验收”，取值待验/通过/修改/暂缓；评审者不得代机主填通过。另给反馈格式：“编号｜通过/修改/暂缓｜意见”。

【三、只许写】
实现单一writer负责：/vol1/ai/projects/wyszz-new/frontend-rebuild-hm044-city/tools/city-catalog/**、/vol1/ai/projects/wyszz-new/frontend-rebuild-hm044-city/test/city-catalog*.mjs；报告与正式成果写/vol1/ai/projects/wyszz-new/frontend-rebuild-hm/tasks-out/S-40/逐模块验收/**；临时产物只写/tmp/s40-catalog/**。原src/render/city/**只读，原tools/city-demo/**与旧截图/评审/性能证据只读，禁止静默替换旧快照。先记录受保护源文件sha，交付前复核一致。
禁止改hm035及其它树、app/ui/world/camera、经济/存档/版本号；禁止游戏接线、微信出码、游戏打包、新依赖和联网资源。允许打包本轮HTML素材目录zip。Node用export PATH=/mnt/ssd/apps/nodejs_v24/bin:$PATH。

【四、实现分工与独立评审】
原主先核实占用，沿用原owner；本轮全树仅一名实现writer负责展示工具/测试/产物构建，其他协作者只读或写各自报告域，不嵌套派发。提示词原样转发，路径写死；主对话抽查模块计数、尺寸与来源，不把“已命名”当“已验收”。
- 独立U1“玩家视角锐评”：只写逐模块验收/U1/**，不改代码、不判通过/不通过。看命名是否认得出、模型是否独立完整、档位与变体是否可辨、四视图有无漏面/截断、机主能否按编号准确反馈。P0/P1/P2均给模块编号、证据、复现、建议；同类惯例只可有来源地引用，否则写未验证。报告先给机主，机主决定改不改，不自动修模型。
- 独立UX“玩家＋手游UX”：只写逐模块验收/UX/**，核验搜索/分类/上一下项/返回/复位/错误反馈、可点目标至少44×44 CSS px、命名可读和主体无遮挡；提交控件存在理由表、尺寸与遮挡实测。与U1可并行只读评审同一冻结快照，不能由实现者冒充独立评审。
玩家视角自检：原实现先完整走一遍“解压→目录→选模块→四视图→旋转缩放→复位→下一项→返回”，再交独立评审。新发现问题先报机主；本任务已明确的功能缺失先补齐，不把未裁量U1全量问题当授权。

【五、验收标准】
- 完整盘点映射到真实源码，模型数由脚本输出；模块ID唯一，清单、文件、截图、链接一一对应，无漏档、重复ID、错名、断链；不事先拍脑袋承诺总数。
- 脚本遍历每项独立HTML：可离线加载、实际当前素材ID正确、无其他城市场景混入、无外网请求/pageerror，缺失或失败均列项，不只抽测第一项。
- 所有模块四视图齐全，当前编号与截图绑定hash；机主逐个可看、可旋转、可复位、可按编号反馈。默认画面主体完整、无背景楼群干扰。
- 相机专项：反复到缩放/旋转边界的顶手感证据，写清限制值、越界余量与复位终态；持续旋转10s、缩放/拖动10s、静置5s，交逐帧时间、≥50ms长帧与每帧包围盒/矩阵重算调用计数；与原demo基线逐项比较，软渲染FPS不当真机结论，触屏真机写未验证。高成本包围盒遍历不得无证据进主循环。
- 原四套city测试保留自跑，既有55项不删不弱化；工具逻辑缺陷先留失败复现/测试，再修。新增测试验证真实映射、离线完整性、切项资源释放与复位行为，不写恒true断言。原src和旧交付hash保持一致。
- 实现自检、独立U1/UX与处理决定表齐；U1/UX待裁量项不填0，机主尚未逐项签收不能写“素材全部通过”。总监独立复验后才下技术裁决。

【六、交付】
逐模块验收目录内交index.html、modules/*.html、素材清单.json、素材总表.md、验收表.csv、截图/**、命名与源码映射.md、独立U1/UX、处理决定表.md、测试与性能证据、总报告.md、SHA256SUMS，以及可直接解压离线使用的完整zip。SHA覆盖源码基线/工具/HTML/截图/清单，同一轮冻结；发布链接导出表放manifest之外，避免含自身hash或zip链接的循环构建，报告绑定该manifest。绝对路径不得假装用户本地可点。
所有独立HTML、目录zip及交付报告用/vol1/ai/_scripts/deliver-link <绝对路径> <标题> <说明> --tailscale登记；回复先给目录zip和总表，再给真实逐模块下载索引，Tailscale主、Cloudflare备用。绝不只给长截图墙或让机主逐个输入URL参数。机主验收状态待验，不打游戏包、不出码。

【七、时间盒与优先级】
本轮时间盒4小时（任务预算，非耗时实测），每30分钟写逐模块验收/进度.md；卡住超过20分钟记根因与缺项，不删需求。先保证建筑逐档独立HTML/稳定命名/目录可用，再补道具与场景模块、四视图和独立评审；分批可先交，但必须报已交/总数/未交清单，整任务保持未完成。原模块素材不重做。
```
