chentianya/Interpreter
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
145 Commits 2 Branches 1 Tag
38202fd21ed51e0229f432d4d42ebf9dda96d246
Commit Graph
19 Commits
Author SHA1 Message Date
Admin 7b4961f7ed 阶段3-5：编译器验证——13 正例源码↔反汇编对照 + --dump-map 
- 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）
 2026-08-26 09:47:24 +08:00
Admin 316b252afc 文档：阶段4-执行侧V2 待办清单（isa 重构/vm 同步/executor/全链路/文档收尾） 2026-08-26 09:33:23 +08:00
Admin f7de78e528 文档：阶段3-语言层V2 计划与待定决策点（L1..L8，逐个解决） 2026-08-25 20:26:00 +08:00
Admin 53df69f4be 文档：阶段1规格总览（V2 主参考）——定案速览 + 三份规范重写任务 + 延后项 
- §1 阶段 1 任务（重写指令与映像/指令配置/stb文件格式）
- §2..5 定案速览：指令编码/数据模型/执行语义/映像格式
- §6 machine.toml V2 schema 方向（N5，阶段 1 内定）
- §7 延后项（N1..N4、C5）；§8 参考文档索引
 2026-08-24 16:18:57 +08:00
Admin 5b10c2c826 文档：新建指令编码.md——RISC-V 式 op+func 编码定案存档 
- 前缀长度组（1/01/001/0001 定 4/8/16/32B）+ op 按组分治
- 字节 1 = [func:4|fmt:4]；func 10 组合（宽度×符号+F32/F64）语义随 op
- fmt 4 位 9 格式（格式合并作废，CALL/CAL 独立）
- 19 类型 → 10 func 编译期映射；BOOL 0/1 编译器强制
- 与 RISC-V 对照表 + 决策历史
 2026-08-24 14:43:16 +08:00
Admin 770e92d109 文档：指令集清单拆分为独立文档（Doc/isa/指令集清单.md），优化文档保留引用 2026-08-24 14:08:34 +08:00
Admin 109f9a7619 文档：编译器优化 V2 草案（编译策略层，与指令集优化.md 分层） 
- §2 V1 现状：FB 内联/FC CALL/CAL_* 三种调用、短路跳转、固定寄存器分配、
  调用约定、跳转回填、常量表去重
- §3 V2 变更：FB 基址寻址消除内联、type 位段驱动语义、槽表/值区布局职责、
  变长发射字节化回填、类型扩展与升宽规则
- §4 待确认（引用指令集优化 §4 编译器相关项）；§5 编译器侧影响面；§6 阶段；§7 决策历史
 2026-08-24 10:53:47 +08:00
Admin b70bea6b54 文档：指令集优化 V2 草案（变长指令/槽表值区/IEC 类型扩展/待确认问题） 
- 动机：opcode 位域化、8B 定宽槽浪费、类型扩展、结构体预留、变长指令
- 已定案：变长指令（长度组在 opcode）、寄存器 8 位编号维持、槽表→值区
  两级模型、宽度编码进 opcode、初值同文件分段、全 32 位寻址、STATOR2
- 待确认：跳转字节化 / type:4 vs 5 / 长度组映射 / I/Q/M 合并 / 结构体范围
  / ST 层类型支持 / 转换规则 / 字面量
- 影响面清单 + 6 阶段实施计划 + 决策历史
 2026-08-24 10:46:25 +08:00
Admin b86a9eaf07 规划指令配置文件（ops.txt）：登记唯一事实来源 + 强校验 + 屏蔽机制。 
- Doc/isa/指令配置.md：格式（全属性必填）、OpTable（解析+与枚举强校验）、
  各端接线（STCompiler --ops 编译路径必填/屏蔽传导；BytecodeExecutor 可选加载/Disabled 故障）、
  加指令/屏蔽流程、7 步执行计划
- FB 注册并入 ops.txt 列为待讨论（未定案）
- 索引登记
 2026-08-21 20:58:17 +08:00
Admin 3c42a72e86 新增指令执行流程文档（12.9 前置）。 
- Doc/vm/指令执行.md：执行模型、帧/调用栈（CALL/RET 复制 r0..r7）、值表示约定、
  8 字节定宽槽访问、29 条指令执行表、跳转语义、cycle_limit 计数、
  CAL_TON/TOF/CTU Δt 推进、五类故障
- line1 MAIN 逐指令推演（I0_0=1、stop=0、急停=0 → Q0_0=1，对照真值表）
- 索引登记
 2026-08-21 19:50:39 +08:00
Admin 17c62f0a1f 新增 .stb 映像文件结构说明（line1 真实字节拆解）。 
- Doc/isa/stb文件格式.md：段布局图、17 字段头表、常量/函数/字节码/FB/数据各段
- 用 line1.stb（184 字节）逐段核对实际值：函数表 2 行、MAIN 指令字节、数据段全局+实例块
- 标注与执行器的关系（sidecar 不含在映像）；索引与 isa README 登记
 2026-08-21 13:40:20 +08:00
Admin eb6829b9b9 新增 STCompiler 使用说明文档。 
- 构建 / 用法（-o 产出 .stb）/ 退出码 / line1 示例
- project.toml 字段表、ST 子集支持范围与 v1 限制清单
- 编译管线五类错误前缀与示例；样例与测试索引；当前状态
- compiler/README 与 Doc/索引 登记
 2026-08-21 11:55:36 +08:00
Admin d296a9215e 规划 12.8 寄存器码：存储布局、指令模式、8 片执行计划。 
- 寄存器码.md：帧/数据区布局（FB 实例块持久化）、短路编跳转、函数帧约定（结果 r0）
- 用户 FB 调用内联展开定案；内建 CAL_TON/TOF/CTU
- 8 片计划：骨架→I/Q/M→短路→IF→WHILE→算术→CALL→FB+line1 全链路
- 索引.md 登记
 2026-08-21 11:30:43 +08:00
Admin 9cd4997a3a 实现 12.7 类型检查：表达式类型、语句规则、FUNCTION 禁写全局。 
- Typecheck.h/cpp：三型（BOOL/INT/TIME）求值，AND/OR/NOT 只吃 BOOL、算术只吃 INT（TIME 无算术）、比较同型、IF/WHILE 条件必须 BOOL
- FUNCTION 禁写全局（含经 VAR_EXTERNAL）——用例 14 点亮；函数名赋值=返回类型
- FB 命名实参匹配字段类型；FB 实例不能当值
- typecheck_test：23 断言（用例 14 + 8 类负例 + 13 个正例），ctest 8/8
 2026-08-21 11:26:55 +08:00
Admin 6f02c18bbb 实现 12.6 符号表与链接：全局定槽、引用解析、循环检测。 
- Linker.h/cpp：收集导出（仅 gvl 文件顶层 VAR_GLOBAL、声明顺序定槽、重复名拒绝）
- VAR_EXTERNAL 接同一槽、类型一致；FB 实例必须先声明；字段存在性校验；函数调用图 DFS 环检测
- io.var 必须在 GVL；内建 TON/TOF/CTU 布局冻结；用户 FB 字段 = input/output/var（external 不是字段）
- 函数名赋值 = 结果值写入（用例 13 约定）；dump_symbols 打印 name kind type address file
- linker_test：51 断言（用例 09/10/11/12/16/19 + line1/17 正例），ctest 7/7；20 用例扫描 15 绿 5 按期望拒
 2026-08-21 11:14:03 +08:00
Admin 4ba44459e2 实现 12.5 递归下降语法：AST + 拒绝清单。 
- Parser.h/cpp：POU 外壳（PROGRAM/FUNCTION/FUNCTION_BLOCK）、变量段、语句（赋值/IF/WHILE/FB 调用）、表达式优先级爬升（NOT/AND/OR 短路/比较/算术/函数调用/负号）
- Unit 结构：顶层 VAR_GLOBAL 段（GVL 文件形态）+ POU 列表
- 拒绝：VAR_IN_OUT/REF/CLASS/ANY 等保留名、链式比较、FB 字段赋值、顶层非 GVL 段
- THEN/DO 补入关键字表（12.5 修订，同步 12.1 与词法文档）
- parser_test：98 断言（line1 三文件 AST、FUNCTION 调用、IF/WHILE/TON、9 类负例），ctest 6/6
 2026-08-21 11:07:34 +08:00
Admin d4e2c1ae7c 实现 12.4 词法：25 关键字、小写折叠、TIME 字面量、lex error。 
- Lexer.h/cpp：关键字表（大小写不敏感折小写）、(* *) 注释不嵌套、整数/T# 段式字面量、最长匹配符号
- token 带 source_file + 行列（起始位置，修了消费后行列的偏差）
- lexer_test：75 断言（line1 三文件 token 流 21/34/27、大小写、符号、注释、行列、5 类负例）
- Doc/compiler/词法.md：设计文档 + 执行计划
 2026-08-21 10:51:45 +08:00
Admin 7c855b1618 文档同步双可执行架构：STCompiler + BytecodeExecutor。 
- 12.10 重写为两条命令：STCompiler 编译出 .stb + sidecar，BytecodeExecutor 加载执行
- 12.0 删独立 stc.exe，12.13 依赖方向改为 STCompiler/BytecodeExecutor
- 指令与映像.md 新增「映像文件（.stb）与 sidecar」节，I/O 绑定不进映像
- host/ 改名 executor/，宿主入口.md 重写为执行器入口.md
- README / tests / examples / isa README 同步
 2026-08-19 13:59:50 +08:00
AdminandCursor e4cdaf4717 把各模块说明从 README 拆到 Doc，并用索引替代 Doc/README。 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-08-18 17:18:40 +08:00