Admin
53df69f4be
- §1 阶段 1 任务（重写指令与映像/指令配置/stb文件格式） - §2..5 定案速览：指令编码/数据模型/执行语义/映像格式 - §6 machine.toml V2 schema 方向（N5，阶段 1 内定） - §7 延后项（N1..N4、C5）；§8 参考文档索引
52 lines
3.1 KiB
Markdown
52 lines
3.1 KiB
Markdown
# 文档索引
|
||
|
||
设计文档，不是编译目标。全工程定案在根下；各 CMake 模块一个文件夹，文件名标明用途。
|
||
|
||
```text
|
||
doc/
|
||
索引.md
|
||
初步计划.md
|
||
isa/指令与映像.md
|
||
isa/stb文件格式.md
|
||
isa/指令配置.md
|
||
isa/指令集优化.md
|
||
isa/指令集清单.md
|
||
isa/指令编码.md
|
||
isa/阶段1规格总览.md
|
||
compiler/编译管线.md
|
||
compiler/STCompiler使用说明.md
|
||
compiler/词法.md
|
||
compiler/语法.md
|
||
compiler/符号表与链接.md
|
||
compiler/类型检查.md
|
||
compiler/寄存器码.md
|
||
compiler/编译器优化.md
|
||
vm/扫描周期.md
|
||
vm/指令执行.md
|
||
executor/执行器入口.md
|
||
```
|
||
|
||
| 路径 | 内容 |
|
||
|---|---|
|
||
| [`初步计划.md`](初步计划.md) | 全工程定案：子集 ST、toml、执行模型、第 12 节阶段 |
|
||
| [`isa/指令与映像.md`](isa/指令与映像.md) | 指令、映像、定宽类型、饱和；**规范以此为准** |
|
||
| [`isa/stb文件格式.md`](isa/stb文件格式.md) | `.stb` 结构说明（用 line1 真实字节拆解） |
|
||
| [`isa/指令配置.md`](isa/指令配置.md) | ops.txt：指令登记唯一事实来源、OpTable、屏蔽机制 |
|
||
| [`isa/指令集优化.md`](isa/指令集优化.md) | **V2 草案**：变长指令、槽表/值区、IEC 类型扩展、待确认问题 |
|
||
| [`isa/指令集清单.md`](isa/指令集清单.md) | **V2 草案**：全功能指令清单（10 类 ~55 条，核心/扩展/预留） |
|
||
| [`isa/指令编码.md`](isa/指令编码.md) | **V2 定案**：RISC-V 式 op + func 编码（前缀长度组 / func 10 组合 / 19 类型映射） |
|
||
| [`isa/阶段1规格总览.md`](isa/阶段1规格总览.md) | **V2 阶段 1 主参考**：全部定案速览 + 三份规范文档重写任务 + N5 schema 方向 |
|
||
| [`compiler/编译管线.md`](compiler/编译管线.md) | 编译器边界与管线 |
|
||
| [`compiler/STCompiler使用说明.md`](compiler/STCompiler使用说明.md) | 构建、用法、工程文件、ST 子集、错误类别 |
|
||
| [`compiler/词法.md`](compiler/词法.md) | 12.4 词法：关键字表、token、大小写、TIME 字面量 |
|
||
| [`compiler/语法.md`](compiler/语法.md) | 12.5 语法：AST 结构、文法、拒绝清单 |
|
||
| [`compiler/符号表与链接.md`](compiler/符号表与链接.md) | 12.6 符号表与链接：数据区定址、FB 布局、错误类别 |
|
||
| [`compiler/类型检查.md`](compiler/类型检查.md) | 12.7 类型检查：表达式类型、语句规则、错误类别 |
|
||
| [`compiler/寄存器码.md`](compiler/寄存器码.md) | 12.8 寄存器码：布局、指令模式、内联 FB、8 片计划 |
|
||
| [`compiler/编译器优化.md`](compiler/编译器优化.md) | **V2 草案**：编译策略现状（FB 内联/短路/寄存器分配）+ V2 方向（FB 共享体/类型驱动/变长发射） |
|
||
| [`vm/扫描周期.md`](vm/扫描周期.md) | 扫描周期与 VM 边界 |
|
||
| [`vm/指令执行.md`](vm/指令执行.md) | 12.9 指令执行流程：帧/调用栈、指令表、定时器、故障 |
|
||
| [`executor/执行器入口.md`](executor/执行器入口.md) | 可执行入口：加载 `.stb` + sidecar，跑扫描周期 |
|
||
|
||
代码目录里的 README 只作入口；类型、指令、映像以 `isa/指令与映像.md` 为准。
|