TODO: drop the finished items, add what the last rounds turned up

Done and removed: the desk calculator (examples/calc.r8asm -- 62585 characters at
11 bits, three implementations agree, width matrix in tests/widths.ps1), the INP
whole-cell semantic fix, and the reference machine's support for tapes above
64k.  In their place, under "interactive computing": the RPN stack (fixed depth,
because .tp is an assembly time constant -- 16 deep is about 12k of tape, 200 deep
would be 100k per push), the terminal tape (prompt, echo, line editing, one
session per `;   in` header), and clb_puts / printf so a program can print a
sentence.

New tail: ROT-8-viz still has zero tests, and its old fixed-buffer read_tape is
now unused; INS_SIZE is a historical constant next to ROT8_MAX_TAPE (16M
instructions).
This commit is contained in:
dsh committed 2026-11-17 16:14:42 +08:00
1 parent ba5a8a465d
commit 1200880d4d
1 file changed
+25 -15
+25 -15
View File
@@ -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 里可以说明一句。