diff --git a/TODO.md b/TODO.md index 45c87c4..d1119e8 100644 --- a/TODO.md +++ b/TODO.md @@ -4,15 +4,21 @@ **从哪开始**;做完就删掉(历史在 git log 里)。`SPEC.md` §12 那张"已经确认走不通"的表是 **结论**,不是待办,别混进来。 -## 交互式计算 +已经做完、从这份清单里移出去的:桌上计算器(`examples/calc.r8asm`,11 位 62585 字符、三方 +一致、位宽矩阵见 `tests/widths.ps1`)、`INP` 整格写入的语义修正、参考虚拟机支持 >64k 纸带。 -* **桌上计算器**(`examples/calc.r8asm`):输入 `12+34=` 输出 `46`,支持 `+ - * /`。 - 条件已经齐了:`inp` 在三个 VM 里都有实现、`tape_run`/`derive` 能用 `-i` 脚本化喂输入、 - 例程头部能声明 `; in ...`;数字用 `clb_undigits` 攒、回打用 `clb_digits`、 - 四则用 `clb_add_nc` / `clb_mul` / `clb_divmod`(都穷举验证过)。 - 要设计的是**字符分派**:`'0'..'9'`(0x30..0x39)bit4 是 1,`'*' '+' '-' '/'` - (0x2A..0x2F)bit4 是 0 —— 一次 `ror` + `biz` 就能分开;运算符再按 `t = C - 0x2A` - 的小整数链式比较。先写 `drv/calc_lex.r8asm` 单点验证分派,再拼整机。 +## 交互计算(下一步) + +* **RPN 栈**:现在的计算器是两寄存器(`A` 累加器 + `P` 待结算操作数),**没有栈**。 + `.tp` 是汇编期常量,所以只能做"固定 N 格 + 整体挪位"的假栈:每次 push ≈ N 个 `copy` + (约 500 字符/格)。65536 的纸带预算下 **16 深**可行(~12k 字符),4 深最划算;理论上 + 259 格内存能到 200 层,但一次 push 要 10 万字符,不现实。起点:把 `calc.r8asm` 的 `A/P` + 换成 4 格窗口先跑通,再看要不要 16。 +* **终端纸带**:提示符 + 逐字符回显 + 行编辑(退格打印 `\b \b`)+ 命令分派。零件都在 + `drv/calc_*`(分派、数字攒取、显示、四则)——缺的是"长驻循环 + 落行 + 会话结束"。 + 验收用头部 `; in` 喂一整段会话,`examples_test` 会自动跑。 +* **文本输出**:`clb_puts`(把连续 cell 当字符串打出来)+ 迷你 `printf`(`%d` `%c` `%s`)。 + 有了它,例程能打印整句话而不是光秃秃的数字,终端纸带也用得上。 ## 工具 @@ -23,17 +29,14 @@ (现在"`.tp` 行走占七成"还是估的)。 * **`%synth --verify`**:把 `.r8forge_cache/` 里每条结果按对应表的所有输入重跑一遍, 给"缓存已入库"兜底 —— 一条坏条目会让每次构建静默用错块。 -* **CI**:暂时不做。本地的 `ctest --test-dir build -j 4` 已经接好(8 条,9 秒),但 act_runner 的 - 镜像里没有 cmake,装包(哪怕换了国内源)也跑不通,先本地跑。 - **ROT-8-viz 仍然零测试**:串行默认 / `-n` / 几何 / 7E1 全靠手测,而它是权威虚拟机 —— - 哪天要补测试,先补它。 +* **CI**:暂时不做。本地 `ctest --test-dir build -j 4`(8 条,9 秒)和 `tests/widths.ps1` + (位宽矩阵,约 20 分钟)都能手动跑;act_runner 的镜像装不出 cmake,先放着。 + **ROT-8-viz 仍然零测试**:串行默认 / `-n` / 几何 / 7E1 全靠手测 —— 哪天真要接 CI,先补它。 * **`src/r8asm.cc:154`** 有个上游留下的 `// TODO: FILL THE BLANK`(`ROT8_NODE` 宏的 children 是空的)。那是继承来的实现,先记着,别顺手改。 -## 文本与画面 +## 画面 -* **`clb_puts` + 迷你 `printf`**:现在只能一个 cell 一个字符地打,缺"把一段 cell 当字符串 - 打出来"和 `%d`/`%c`/`%s` 的格式化,例程就能打印整句话而不是光秃秃的数字。 * **把 259 格当帧缓冲**:串行下 `\r`(0x0D)能原地重绘,1 bit/cell 的 16×16 位图或 8×8 生命游戏都能塞进纸带,`rot8_test --live` 里直接看它动。 @@ -51,3 +54,10 @@ * **`clb_digits` 的布局**:13 格草稿跨得很开,`.tp` 行走占了纸带的大头;重排草稿格应该能 明显缩短(未实测)。 * **`clb_divmod` 里那个 495 字符的提交 `copy`**:还是全展开的,可以想压缩的办法。 + +## 顺手清掉的小尾巴 + +* viz 的 `read_tape`(固定缓冲那版)在 `vm_test.c` 改用 `read_tape_alloc` 之后应该没人用了: + 要么删掉,要么在头注释里标 deprecated。 +* viz 的 `INS_SIZE` 现在只是历史常量(真正的上限是 `ROT8_MAX_TAPE` = 16 M 条指令), + README 里可以说明一句。