cflmy
719b7a8d82
docs(design): 修正标签定位 — 描述是自由文本,内置词只做检索不做语法
按用户修正重写 occlusion-tags-and-stubs.md:
1. `[]` 里是**纯粹的描述文字,对执行零作用**;编译器不解析,只在其内**检索**
(供统计、清单、LLM 待办)。写成 `[某个功能,没开发完成]()` 完全合法。
2. **标签不是语法**,是内置词;想被统计就顺手写上 `[某个功能,没开发完成。待开发]()`。
3. 标签的作用是"让人和模型多看一眼",不是审批、不是门禁——所以标在任何地方都无害。
识别规则改为检索语义:
- 结尾识别([搜索接入,待开发] / [搜索接入-待开发] / [功能待开发])
- 显式括号识别(【待开发】可出现在任意位置)
- 句中裸词不识别(避免误判)
- **识别不到不报错、不提示**(描述自由,机器只是"看见了就记一笔")
撤回上一版的错误判断:原把 `[税率-待开发](0.1)` 列为反例是错的。
标在已知常量上也无害——多四个字换来一次深入检查与阅读,按用户判断**收益优先**。
仅保留不报警的提醒:stubs --changed / --uncounted 展示债务构成,避免数字被撑大后失去参考。
空载荷语义调整:描述非空时 `()` 可空(返回 None),并**自动计入 `stubs --uncounted`**
(未标注的桩也会被看见),不再把"必须有内置词"作为语法门槛。
桩豁免 stale 保持(待开发/模拟/废弃,以及空载荷),并补"防忘去标签"的兜底:
stubs --changed + 会话汇总里的 stubs_touched(一次性,不催)。
实现点相应改为"检索层":parse 原样保存描述字符串;src/label.rs 为检索器;
Tag 为闭集枚举但词表可扩(后续支持 frontmatter 自定义),**不影响任何语法规则**;
check 只保留两条硬规则(label.missing 描述为空、label.ref_dangling 引用悬空)。
同步 occlusion-syntax.md(增补措辞 + M9 改为"检索层")与 doc/README.md 索引。未改代码。
2026-10-22 14:14:15 +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:14:15 +08:00
2026-10-22 14:14:15 +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