cflmy
fac68e85ea
docs(design): 遮蔽语法总纲(实施依据)— 示例先行 + M0–M8 实施计划
按用户定调:不把 []() 写成「循环/表格取元/函数调用」的语法,而是写成
**遮蔽语法(occlusion syntax)**:用叙述显示逻辑、用括号承载实现,
解决"刻意语法设计导致文档不可读",并依靠链接特性使知识过期可被检查。
一、示例先行(六个)
1 嵌套取值:三层 [1]([苹果]([水果类](货架))) → [水果类里苹果的第 1 项价格](at(at(at(货架,水果类),苹果),1))
2 长表达式打断叙述 → [应缴税额](...) 让句子完整
3 抽象层次混杂 → 论证留在叙述,算法退居括号
4 循环来源不可见 → - [从篮子里取出的每个果子](遍历 篮子 为 果)
5 **带空格函数名(已实测)**:> 加一 号 31 ❌ unknown function 加一;
括号调用 加一 号(31 ) ✅ 32 —— 因为 callee = 第一个 '(' 之前的全部文本,空格不再是切词依据
6 反例:描述=实现时不该遮蔽
二、核心定理(本文档的理论支点)
**遮蔽创造信任负债**:把实现藏起来,读者就必须相信描述;
不遮蔽时描述过期无伤大雅,遮蔽后描述过期=文档变假。
所以「新鲜度校验」不是附加功能,而是遮蔽语法的**合法性来源**与代价。
三、场景按动机分类(不按语法分类)
A 不可读 / B 打断叙述 / C 层次混杂 / D 来源不明 / E 名称受限。
D 与 E 是遮蔽顺带解决的问题,不是目的;按动机写才能覆盖未来没想到的不可读情形。
四、语法规范:[] 永不执行、() 唯一执行;空标签 label.missing(error);
() 内用现有表达式文法,callee 允许空格;取元改为 at/get(纯度);
循环 - [描述](遍历 集合 为 变量),变量名从 [] 搬进 ()。
五、两种遮蔽关系,**都要查**
显式遮蔽([]())与**隐式遮蔽(叙述段 + 紧接 > 调用)**——
按用户要求把 > 调用也纳入过期检查:取上方紧邻叙述段为描述,
其反引号实体须出现在实参/callee;无叙述或无反引号则跳过(零噪音)。
六、新鲜度机制:L1 引用一致性(零依赖)+ T1 会话内(repair_apply 前后版对比)
+ **会话末一次性汇总(用户要求做)**:{labels_stale_seen, fixed, outstanding, items};
能力自述与无 git 降级(沙箱 exec=false / WASM 均可用)。
七、实施计划 M0–M8(每个里程碑含目标/改动文件/关键点/测试/验收/回滚)
M0 语义冻结 / M1 () 内调用增强() 终止·逗号·嵌套·空格 callee)/ M2 遮蔽语法 /
M3 at·get 与循环 / M4 L1 / M5 隐式遮蔽 / M6 T1+汇总 / M7 迁移与版本门 / M8 呈现与门禁。
**顺序建议 M0→M1→M2→M4→M6→M5→M3→M7→M8**:先让"断言+复核+修复"跑通,
再动 506 处迁移(中间态最痛)。
八、迁移实测规模:取元 506 处/136 文件,循环 44 处/24 文件,可执行方括号调用 0
(189 行是 lib/* 的 Caller 说明,不执行)。旧形必须 syntax.legacy_index 硬报错
(同形换义最危险),并用 label.provisional 承接机械迁移,避免 506 处全红。
九、测试计划与风险登记:单元/金样/回归 554/双后端/迁移差异/反向验证/环境矩阵/性能;
硬要求"每个新检查必须证明它会响"。
十、附环境前置(踩过的坑):scripts/dev-env.sh + build-web-plugin.sh;
$HOME 不可写 → zig 缓存重定向;/tmp 是 noexec → TMPDIR 必须可执行。
基线 cargo test 554/0;check 对 59 文件 0 warning/0 error,任何里程碑不得变差。
同步在 doc/README.md 登记 5 份新设计文档。未改代码。
2026-10-22 14:03:31 +08:00
..
2026-09-04 16:57:43 +08:00
2026-08-28 15:54:47 +08:00
2026-10-22 13:06:57 +08:00
2026-09-24 20:05:25 +08:00
2026-10-22 13:40:02 +08:00
2026-09-14 11:33:11 +08:00
2026-09-04 09:11:36 +08:00
2026-08-07 13:28:32 +08:00
2026-09-14 11:33:11 +08:00
2026-10-22 13:06:57 +08:00
2026-09-28 16:44:39 +08:00
2026-10-22 11:59:14 +08:00
2026-09-14 10:16:48 +08:00
2026-09-14 15:33:45 +08:00
2026-09-14 13:03:03 +08:00
2026-09-24 20:05:25 +08:00
2026-09-07 20:15:36 +08:00
2026-09-28 16:44:39 +08:00
2026-09-13 20:38:53 +08:00
2026-09-10 14:47:43 +08:00
2026-08-28 17:47:59 +08:00
2026-08-28 16:06:11 +08:00
2026-09-28 16:44:39 +08:00
2026-10-16 11:47:28 +08:00
2026-10-16 11:11:54 +08:00
2026-09-17 09:28:28 +08:00
2026-09-17 09:28:28 +08:00
2026-09-07 22:14:51 +08:00
2026-09-07 16:13:22 +08:00
2026-09-07 15:50:33 +08:00
2026-09-24 20:07:59 +08:00
2026-08-12 14:40:55 +08:00
2026-08-12 13:59:51 +08:00
2026-08-12 13:59:51 +08:00
2026-09-07 10:53:56 +08:00
2026-08-28 15:54:47 +08:00
2026-08-28 15:54:47 +08:00
2026-10-16 17:33:24 +08:00
2026-09-17 21:00:10 +08:00
2026-08-28 10:33:05 +08:00
2026-09-13 15:09:45 +08:00
2026-08-25 14:58:46 +08:00
2026-09-18 16:01:40 +08:00
2026-09-18 10:17:39 +08:00
2026-09-17 20:58:21 +08:00
2026-09-17 20:54:02 +08:00
2026-09-28 11:06:38 +08:00
2026-10-15 15:28:46 +08:00
2026-10-18 01:39:36 +08:00
2026-10-18 14:51:12 +08:00
2026-10-22 13:14:03 +08:00
2026-10-22 12:46:13 +08:00
2026-10-22 12:46:13 +08:00
2026-08-13 10:03:21 +08:00
2026-08-13 10:03:21 +08:00
2026-08-06 17:52:33 +08:00
2026-10-22 13:40:02 +08:00
2026-09-22 19:03:03 +08:00
2026-09-14 11:38:24 +08:00
2026-10-22 12:53:03 +08:00
2026-10-15 15:28:46 +08:00
2026-09-24 19:51:24 +08:00
2026-08-18 11:20:46 +08:00
2026-10-18 12:42:15 +08:00
2026-10-18 12:42:15 +08:00
2026-08-18 11:20:46 +08:00
2026-10-22 14:03:31 +08:00
2026-10-16 11:47:28 +08:00
2026-10-22 12:53:03 +08:00
2026-10-22 11:52:27 +08:00
2026-09-14 15:33:45 +08:00
2026-09-14 10:16:48 +08:00
2026-10-22 11:52:27 +08:00
2026-10-22 13:49:03 +08:00
2026-09-07 20:27:19 +08:00
2026-09-09 09:14:18 +08:00
2026-09-07 20:02:43 +08:00
2026-10-18 00:43:31 +08:00
2026-09-09 09:27:06 +08:00
2026-09-07 20:10:12 +08:00
2026-09-07 20:15:36 +08:00
2026-09-09 09:22:00 +08:00
2026-08-13 10:03:21 +08:00
2026-09-07 20:32:58 +08:00
2026-09-07 20:37:28 +08:00
2026-10-15 15:28:46 +08:00
2026-09-09 09:42:13 +08:00
2026-09-09 09:04:29 +08:00
2026-09-09 09:42:13 +08:00
2026-09-07 20:10:12 +08:00
2026-09-07 20:02:43 +08:00
2026-09-07 20:15:36 +08:00
2026-09-09 09:42:13 +08:00
2026-08-11 09:45:08 +08:00
2026-09-14 11:38:24 +08:00
2026-09-07 20:27:19 +08:00
2026-09-09 09:22:00 +08:00
2026-09-09 09:14:18 +08:00
2026-10-15 15:45:52 +08:00
2026-09-14 11:33:11 +08:00
2026-10-22 13:52:26 +08:00
2026-09-01 09:59:03 +08:00
2026-09-01 10:06:56 +08:00
2026-09-18 09:02:53 +08:00
2026-10-15 14:13:42 +08:00
2026-10-15 13:12:53 +08:00
2026-10-15 20:36:12 +08:00
2026-10-15 13:12:53 +08:00
2026-10-15 13:12:53 +08:00
2026-09-14 13:39:12 +08:00
2026-10-15 20:36:12 +08:00
2026-10-15 14:13:42 +08:00
2026-10-15 14:13:42 +08:00
2026-08-07 09:41:53 +08:00
2026-08-07 09:41:53 +08:00
2026-10-22 13:49:03 +08:00
2026-08-29 10:35:13 +08:00
2026-09-04 13:43:35 +08:00
2026-09-28 11:36:45 +08:00