phase1 与当前主线的映射

Abstract

这篇只做一件事：

把 zdocs/phase1/ 那套早期学习文档，挂到现在的 Level 主线树上。

1. 结论

能串起来，而且应该这样串：

• phase1 不是另一套体系
• phase1 是你现在这棵主线树里的局部预习版 / 局部展开版
• 当前主线负责：
  • benchmark 外层
  • 层级
  • 接口
  • BFS 主线
• phase1 负责：
  • debug_tfb_framework.py 这条最小例子的细读
  • Informer / TSL 的局部模型视角

所以正确关系不是：

• 一套旧文档
• 一套新文档

而是：

• 当前主线文档 = 总树
• phase1 文档 = 总树里若干节点的早期局部展开

2. 一张总图

这张图表达的是：

1. phase1 的 6 篇文档不覆盖完整 benchmark
2. 它们主要覆盖的是：
   • 最小例子内层主链
   • Informer / TSL 模型局部
3. 它们应该挂到现在主线树的下面，而不是和主线树并列

3. 文件级映射表

phase1 文档	在当前体系里的位置	对应现在哪些文档
TFB-ModelFactory与Adapter详解.md	最小例子进入模型前的前置层	22、23、30、36
TFB-Step6-forecasting_data_provider详解.md	forecast_fit(...) 内部的数据准备局部	26、29
TFB-Step7-batch生成过程图.md	训练循环里 batch 形成局部	29
TFB-Step8-Step9-init_model与process详解.md	_init_model() 与 _process() 局部	26、29、30
Informer调试流程图.md	Informer 模型内部局部	38 之后的模型 DFS
TSL架构学习文档.md	time_series_library 子库地图	37、38 之后的模型分支树

4. 逐篇解释

4.1 TFB-ModelFactory与Adapter详解.md

这篇讲的是：

• ModelFactory
• adapter
• 参数两步注入

它在当前主线里的位置是：

进入底层模型之前的“模型接入层”。

它不属于 pipeline(...) 的完整外层调度，但属于：

• 当前最小例子 debug_tfb_framework.py
• 以及完整 benchmark 中 “模型如何被统一接入” 的局部基础知识

所以现在读法应该是：

• 把它当成 [[36-完整层级与接口总树]] 里“模型对象是怎么形成的”的补充
• 不要把它当成完整 benchmark BFS 主线的一层

4.2 TFB-Step6-forecasting_data_provider详解.md

这篇讲的是：

• forecasting_data_provider(...)
• DatasetForTransformer
• DataLoader

它在当前主线里的位置是：

训练子块 5B 里的数据准备局部。

也就是现在的：

• [[26-Level6-5B-训练子块-fit_method与forecast_fit]]
• [[29-Level7-forecast_fit训练循环]]

所以它对应的不是一个新的高层，而是：

forecast_fit(...) 内部某一段的展开说明。

4.3 TFB-Step7-batch生成过程图.md

这篇讲的是：

• next(iter(train_loader))
• sample 和 batch 的关系
• __getitem__() 和 DataLoader

它在当前主线里的位置是：

训练循环内部 batch 这一小段的展开说明。

它对应的是：

• [[29-Level7-forecast_fit训练循环]]

所以现在读它，应该带着这个坐标：

它不是一层新主线，而是 Level 7 的局部显微镜。

4.4 TFB-Step8-Step9-init_model与process详解.md

这篇讲的是：

• _init_model()
• _process(...)

它在当前主线里的位置是：

训练线 / 预测线接入真实底层模型之前的共同桥。

它对应的是：

• [[26-Level6-5B-训练子块-fit_method与forecast_fit]]
• [[29-Level7-forecast_fit训练循环]]
• [[30-Level8-_process到DLinear.forward]]

所以这篇仍然有效，而且价值很高。
只是现在它应该被放在：

forecast_fit 已经进入训练循环之后，再作为接口桥去读。

4.5 Informer调试流程图.md

这篇讲的是：

• debug_informer.py
• Informer 内部 tensor
• embedding
• encoder / decoder 前的接口语义

它在当前主线里的位置是：

Informer 模型分支内部的局部图谱。

它对应的是：

• [[38-Informer在完整benchmark中的全链坐标总图]]

所以它不该单独读，而应该在读完 38 之后再读。
正确顺序是：

1. 先明确 Informer 在完整 benchmark 中的坐标
2. 再回来看它内部 tensor 和模块关系

4.6 TSL架构学习文档.md

这篇讲的是：

• time_series_library
• layers
• models
• adapter

它在当前主线里的位置是：

模型分支树的子库级地图。

它对应的是：

• [[37-分支树地图-从1x1到mxn]]
• [[38-Informer在完整benchmark中的全链坐标总图]]

所以它适合作为：

你从 DLinear 切到 Informer，再从 Informer 扩到 PatchTST / iTransformer 时的“模型库地图”。

5. 正确阅读顺序

如果你想把 phase1 真正接到当前主线里，顺序应该是：

1. 先读当前主线总树：

   • [[36-完整层级与接口总树]]
   • [[33-DLinear在完整benchmark中的全链坐标总图]]

2. 再回头吸收 phase1 的最小例子细节：

   • [[zdocs/phase1/TFB-ModelFactory与Adapter详解]]
   • [[zdocs/phase1/TFB-Step6-forecasting_data_provider详解]]
   • [[zdocs/phase1/TFB-Step7-batch生成过程图]]
   • [[zdocs/phase1/TFB-Step8-Step9-init_model与process详解]]

3. 然后切到 Informer 分支：

   • [[38-Informer在完整benchmark中的全链坐标总图]]
   • [[zdocs/phase1/Informer调试流程图]]
   • [[zdocs/phase1/TSL架构学习文档]]

6. 你现在最缺的不是哪篇文档

你现在最缺的不是“再写一篇新高层文档”，而是：

把 phase1 里的局部显微镜，放回当前总树里定位。

也就是：

• 不再把 phase1 当成另一套路线
• 而是当成：
  • 最小例子的局部展开
  • Informer 分支的局部展开

7. 最后压成 5 句话

1. phase1 和当前主线不是两套体系。
2. 当前主线负责总树，phase1 负责局部显微镜。
3. TFB-Step6/7/8/9 属于 debug_tfb_framework.py 和 forecast_fit(...) 局部。
4. Informer调试流程图 和 TSL架构学习文档 属于 Informer / TSL 模型分支局部。
5. 现在最合理的做法，是先用当前主线定位，再回读 phase1 的局部文档。