用途:调试和检查 KGF 语言规格。通过查看 token、解析事件和提取出的依赖边,了解 indexion 如何处理某个源文件,适合开发或修改 KGF 规格、验证分词与解析是否正确,以及排查 grep 模式不匹配(用 kgf tokens 查看实际 token 类型)。
主要能力(子命令):indexion kgf list 列出已安装规格;indexion kgf update 从 GitHub 下载最新规格;indexion kgf add <spec-name> 安装单个规格;indexion kgf inspect <file> 一次显示 token、事件和边;indexion kgf tokens <file> 仅显示分词结果;indexion kgf events <file> 仅显示解析事件;indexion kgf edges <file> 仅显示提取的依赖边。
用法与选项:可加 --spec=NAME 指定 KGF 规格,默认自动探测;--kgf-dir=PATH 指定规格目录,默认 kgfs。indexion grep 底层使用 KGF 分词,模式别名(如 pub → KW_pub)来自 KGF 规格的 lex 段。排查示例:先用 indexion kgf tokens src/config/paths.mbt 查看实际 token,再调整 grep 模式,如 indexion grep "KW_pub KW_fn Ident" ...。
常见限制与陷阱:KGF 使用 PEG 解析,规则按首个匹配优先,DocComment 若排在声明规则前会被单独消费;文档与关键字之间常有换行,需用 NL? 允许;事件自底向上触发,子规则先于父规则,需用 bind/$scope 从子到父传数据;token 定义先出现者优先,通用 Operator 会吞掉 =,应先定义 EQ。修改规格后应验证 declares 边中是否包含 doc。其余细节资料未提供。