规则:未完成项只许减少,不许增加。
- 台账不存在 → 建立(写入当前计数)并提示,exit 0
- 当前 > 台账 → 失败并提示"未完成项增加了 K",exit 1
- 当前 ≤ 台账 → 通过;若减少则**收紧**台账(N → M)
为什么减少即收紧:否则债务可先降后升,棘轮形同虚设;
收紧后回退到旧数量同样失败(测试第 4 步验证)。
台账格式 {"count":N,"words":[…]},记录词集使"口径变更"可审计。
为什么用棘轮而非硬门禁:硬门禁(必须为 0)会让存量债立刻红一片、逼人关检查;
棘轮做到"老账不追、新账必拦",与防疲劳机制的结论一致。
呈现面复核:expr_display / view 把遮蔽渲染为 [描述](实现)、桩为 [描述](),
实测 view output 页面含 access(;未做桩徽章——桩已是显眼形状,再加装饰是噪音。
测试:四步集成用例(建账 → 增加失败 → 减少收紧 → 回退再次失败);
全量 605 passed / 0 failed(M7 后 604 + 1)。
文档:doc/design/change-m8-ratchet.md
测试夹具(金样例)
金样例与集成测试同处 tests/,用子目录区分类别。设计见 examples-and-tests.md。
| 路径 | 内容 |
|---|---|
structure/ |
函数、调用、分支、循环、表、导入、位置实参 |
keywords/ |
print、布尔与 and/or/not |
markup-v03/ |
Markup v0.3 草案金样例(#[ignore] 至旗标落地;见目录 README) |
errors/ |
期望失败(诊断文案) |
gold.rs |
集成测试:跑上述夹具并比对 stdout / stderr |
cargo test
marqdo run tests/structure/hello.mq.md
marqdo view tests
marqdo catalog tests -o .marqdo
面向访客的可执行介绍在 public/(不含 errors/),见 user-site.md。