仓库残留会误导对现状的判断
一、五类强误导信号
| 信号 | 为什么误导 |
|---|---|
prototypes/ 里留着完整 HTML 模板 | 看起来像真实模板，slot 还完整，容易被当成运行时模板来排查 |
| 历史文档仍在描述「已上线三套内置模板」 | 历史上下文被当成当前事实 |
单测里构造的假数据行 id 就是 professional/classic/modern | 像内置模板注册表，其实只是模拟的 DB row |
旧 migration 的 templateId DEFAULT 'professional' | 默认值虽已 drop，搜索时仍会看到痕迹 |
目录名仍叫 lib/templates | 本身没问题，但配合上面几条就形成「有本地模板系统」的错觉 |
二、要记住的现状表述
运行时模板只来自数据库表。
prototypes/是历史原型 / 参考文件，不参与渲染。professional/classic/modern若存在，也是数据库 row 的 id，不是本地模板分支。
三、可迁移的判断
- 「代码里有什么」≠「运行时用什么」。 判断当前架构要查运行时数据源（DB row、真实请求返回），仓库里的文件只能证明「曾经这样」。
- 历史残留越多，越要显式写一条「现状事实」来抵消——否则每个新来的 agent（或人）都会重踩一次。
- 自己也要认账：这次被
prototypes误导过，之后排查页面模板直接查 DB 的html/css。
相关
- 面板多出的固定区块先查数据源再改前端 —— 同一取向：先看数据链路，再改渲染
- 以前能用最近坏了先查自己改了什么 —— 另一种「默认假设」导致的误判
- 先定位归属层再动手 —— 本条是该骨架在「读代码」场景的实例