Files
marqdo/doc/design/change-m9-label-search.md
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- CHANGELOG.md:v2.8.0 条目(中英双语);
- README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明);
- doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制);
- skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/
  require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过);
- 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2026-11-18 10:29:26 +08:00

3.7 KiB
Executable File
Raw Permalink Blame History

变更记录:M9 两级词表检索(labels CLI + MLSP labels.search)

状态 Implemented
日期 2026-10-22
里程碑 M9(occlusion-description-and-search.md §3 · occlusion-syntax.md §13)
改动文件 src/label.rs · src/main.rs · src/mlsp.rs · tests/occlusion.rs
影响面 新增 CLI 子命令与 MLSP 方法(不改语法)

1. 两级词表

级 在哪 作用
第一级:内置 label::BUILTIN_GROUPS(数据常量) 默认查询 + LLM 范例 + 跨项目可比
第二级:参数 --grep / grep 替换或并集,项目自己的说法照样能搜

内置六组:未完成(待开发/未开发/开发中/未实现/待实现/未接/接口未接/TODO)、 假数据(模拟/假数据/桩/占位/stub/mock)、示例、实验、废弃、待校验。 pending = 未完成 ∪ 假数据。

词表是数据不是语法:扩充它不改任何解析规则。


2. CLI

marqdo labels .                              # 默认:pending 口径(内置两组)
marqdo labels . --grep "联调"                 # 替换为自定义词
marqdo labels . --grep "联调" --also-builtin   # 自定义 ∪ 内置
marqdo labels . --group 示例,实验              # 选内置组
marqdo labels . --count                       # 只给数字(CI/棘轮用)
marqdo labels . --json                        # 一个 JSON 数组

输出(人类):

a.mq.md:3  [main] 按关键词检索,接口未接,待开发  ← 待开发,未接,接口未接
a.mq.md:4  [main] 客户留存率,模拟              ← 模拟
label search: 2 命中(1 文件,词=[…])

--json:

[{"file":"a.mq.md","line":3,"unit":"main","label":"…","words":["待开发"],"has_payload":true}]

3. MLSP

{"id":1,"method":"labels.search",
 "params":{"source":"…"|"path":"…","grep":["联调"],"also_builtin":true}}

返回:

{"ok":true,"words":[…],"count":2,"hits":[{"line":3,"unit":"main","label":"…",
  "words":["待开发"],"has_payload":true}]}

语义与 CLI 完全一致(同一份 label::search)。


4. 检索语义(v1)

项 规则
匹配 子串(CJK 无词边界,子串最稳)
多词 OR
大小写 英文不敏感(TODO/todo 等价)
误判 必然存在([不属于待开发范围] 会命中)——只影响计数,输出带描述原文可人工判断

不做否定语法;留作 v1.1 可选项。


5. 测试

层 内容 结果
集成(4) pending 计数=2;--grep 替换=1;--also-builtin 并集=3;MLSP labels.search 返回 hits ✅
全量 cargo test --release 587 passed / 0 failed(M4 后 583 + 4)

6. 边界

项 说明
只在 occlusion 模式产生命中 classic 模式下没有 Expr::Occluded;M7 翻转默认后自然可用
解析失败的文件跳过 那是 check 的职责,检索不应因一个坏文件整体失败
不做棘轮 --baseline / --fail-on-increase 留给 M8(门禁)

7. 变更清单

文件 变更
src/label.rs WordGroup / BUILTIN_GROUPS / PENDING_GROUPS / group_words / parse_words / matched_words / Hit / search
src/main.rs labels 子命令 + collect_mq_files 递归扫描
src/mlsp.rs labels.search 方法 + 分发
tests/occlusion.rs + tests/occlusion/labels.mq.md 4 个集成测试
doc/design/change-m9-label-search.md 本文件