feat: Initial commit of Clutch-IQ project

L1B/README.md

@@ -0,0 +1,37 @@
+# L1B层 - 预留目录
+
+## 用途说明
+
+本目录为**预留**目录,用于未来的Demo直接解析管道。
+
+### 背景
+
+当前数据流:
+```
+output_arena/*/iframe_network.json → L1(raw JSON) → L2(structured) → L3(features)
+```
+
+### 未来规划
+
+L1B层将作为另一条数据管道的入口:
+```
+Demo文件(*.dem) → L1B(Demo解析后的结构化数据) → L2 → L3
+```
+
+### 为什么预留?
+
+1. **数据源多样性**: 除了网页抓取的JSON数据,未来可能需要直接从CS2 Demo文件中提取更精细的数据(如玩家视角、准星位置、投掷物轨迹等)
+2. **架构一致性**: 保持L1A和L1B作为两个平行的原始数据层,方便后续L2层统一处理
+3. **可扩展性**: Demo解析可提供更丰富的空间和时间数据,为L3层的高级特征提供支持
+
+### 实施建议
+
+当需要启用L1B时:
+1. 创建`L1B_Builder.py`用于Demo文件解析
+2. 创建`L1B.db`存储解析后的数据
+3. 修改L2_Builder.py支持从L1B读取数据
+4. 设计L1B schema以兼容现有L2层结构
+
+### 当前状态
+
+**预留中** - 无需任何文件或配置

L1B/RESERVED.md

@@ -0,0 +1,4 @@
+L1B demo原始数据。
+ETL Step 2:
+从demoparser2提取demo原始数据到L1B级数据库中。
+output_arena/*/iframe_network.json -> database/L1B/L1B.sqlite