咏庆德云数据栈 · 全站结构树

1. 一屏看懂：一级栏目地图

看不懂全站时先看这一屏：每个格子是一级栏目，数字由树现算。点卡片直接跳到树里对应分支。

上面每个数字都从树现算，不是手填的。点任意卡片，会跳到下方树里对应的分支并展开到页面层。

当前真实页面清单（自动同步，不是手抄）

这一栏由生成器直接读 router/index.ts、main.py 的 PAGE_ROUTES、prerender.py 的 STATIC_PAGES 与 public/*.html 得出。网站新增或删除页面，重新生成就会自动跟着变，不需要有人记得往树里补节点。

共 32 个真实页面（自动清单）· 32 个在人工树里能匹配到 URL · 0 个匹配不到。匹配只说明树里记过这个地址，不等于逐项核对过当前页面；参数页（含 :）按路由模式列出，不造示例链接。

2. 六层粒度怎么定义

L4 就是页面里那种「块」，L5 是块里能单独改动的最小单元。全树所有叶子都落在 L5，没有停在半路的浅层叶子。

全站统一 6 层：L0 站点 → L1 一级栏目 → L2 页面 → L3 区块 → L4 模块（块 / 卡片）→ L5 最小控件与字段。这棵树是导航树 / 文档树，不是数据库外键：同一个页面若从两个分支都能抵达，树里照列，但指向同一个 URL。

下面第 3 节的逐层细节来自 2026-11 对站点的一次人工浏览记录，不是自动抓取的当前 DOM：层级与控件位置是实测的，但节点文本里的具体数值、日期、人名和节目单条目是那次页面显示的内容快照，会过期，看当前数字请回站内对应页面。

哪些页面真实存在，以上方「当前真实页面清单」为准 —— 它由生成器直接读路由与页面单一源得出，网站加页面重新生成就自动出现，不依赖这份人工观测。清单里「树中有 URL」只表示人工树记过这个地址，不等于逐项核对过当前页面；匹配不到的会标「树中无 URL」。

3. 全站树：逐层下钻

4. 最小控件字典

全树的 L5 控件基本由下面这些类型组合而成。代号只用于归纳，树里逐项写的是实际控件名与字段。

5. 这棵树怎么维护

树的 URL 会与 router/index.ts 的 SPA 路由、main.py 的 PAGE_ROUTES、prerender.py 的 STATIC_PAGES、以及 web-src/public/*.html 做双向比对：树里写了不存在的地址会红；线上新增了页面却没进树，CI 也会红。确实不该进树的（重定向、跳转壳、验证文件等）要在 route_policy.exempt 里逐条写明理由。