Admin
7b4961f7ed
- STCompiler --dump-map：编译后打印变量/槽映射（函数局部 r 寄存器、 全局 slot/off/type/func、实例 slot/off/fb/size/字段偏移） - CodegenMap 输出结构（codegen_project 可选参数） - 修复参数循环 bug（i+1<argc 漏掉末尾单参数选项） - 结构自检（临时 stbcheck）：13 用例寄存器/func/跳转/槽/长度全部通过 - 13 正例逐条对照全部通过，产出 Doc/compiler/用例反汇编对照.md - 已知缺陷记录：LREAL 字面量装载按 REAL（TODO）
3.7 KiB
3.7 KiB
文档索引
设计文档，不是编译目标。全工程定案在根下；各 CMake 模块一个文件夹，文件名标明用途。
doc/
索引.md
初步计划.md
isa/指令与映像.md
isa/stb文件格式.md
isa/指令配置.md
isa/指令集优化.md
isa/指令集清单.md
isa/指令编码.md
isa/阶段1规格总览.md
isa/阶段4-执行侧V2.md
compiler/编译管线.md
compiler/STCompiler使用说明.md
compiler/词法.md
compiler/语法.md
compiler/符号表与链接.md
compiler/类型检查.md
compiler/寄存器码.md
compiler/编译器优化.md
compiler/阶段3-语言层V2.md
compiler/用例反汇编对照.md
vm/扫描周期.md
vm/指令执行.md
executor/执行器入口.md
| 路径 | 内容 |
|---|---|
初步计划.md |
全工程定案：子集 ST、toml、执行模型、第 12 节阶段 |
isa/指令与映像.md |
指令、映像、定宽类型、饱和；规范以此为准 |
isa/stb文件格式.md |
.stb 结构说明（用 line1 真实字节拆解） |
isa/指令配置.md |
ops.txt：指令登记唯一事实来源、OpTable、屏蔽机制 |
isa/指令集优化.md |
V2 草案：变长指令、槽表/值区、IEC 类型扩展、待确认问题 |
isa/指令集清单.md |
V2 草案：全功能指令清单（10 类 ~55 条，核心/扩展/预留） |
isa/指令编码.md |
V2 定案：RISC-V 式 op + func 编码（前缀长度组 / func 10 组合 / 19 类型映射） |
isa/阶段1规格总览.md |
V2 阶段 1 主参考：全部定案速览 + 三份规范文档重写任务 + N5 schema 方向 |
isa/阶段4-执行侧V2.md |
阶段 4/5 待办：isa 重构 + vm 同步 + 全链路收尾清单 |
compiler/编译管线.md |
编译器边界与管线 |
compiler/STCompiler使用说明.md |
构建、用法、工程文件、ST 子集、错误类别 |
compiler/词法.md |
12.4 词法：关键字表、token、大小写、TIME 字面量 |
compiler/语法.md |
12.5 语法：AST 结构、文法、拒绝清单 |
compiler/符号表与链接.md |
12.6 符号表与链接：数据区定址、FB 布局、错误类别 |
compiler/类型检查.md |
12.7 类型检查：表达式类型、语句规则、错误类别 |
compiler/寄存器码.md |
12.8 寄存器码：布局、指令模式、内联 FB、8 片计划 |
compiler/编译器优化.md |
V2 草案：编译策略现状（FB 内联/短路/寄存器分配）+ V2 方向（FB 共享体/类型驱动/变长发射） |
compiler/阶段3-语言层V2.md |
阶段 3 计划：语言层 V2（Lexer/Parser/Typecheck/Linker）+ 待定决策点 L1..L8 |
compiler/用例反汇编对照.md |
编译器验证：13 正例源码 ↔ 反汇编逐条对照结论 |
vm/扫描周期.md |
扫描周期与 VM 边界 |
vm/指令执行.md |
12.9 指令执行流程：帧/调用栈、指令表、定时器、故障 |
executor/执行器入口.md |
可执行入口：加载 .stb + sidecar，跑扫描周期 |
代码目录里的 README 只作入口；类型、指令、映像以 isa/指令与映像.md 为准。