用途:Semantic 是零依赖 Go 库,把自然语言查询匹配到无障碍树元素。本技能用于开发与贡献该项目,包括改源码、加功能、修缺陷、跑测试、准备 PR。
主要能力:提供词法匹配(Jaccard 相似度、同义词、角色加权)、稠密向量余弦相似度、特征哈希嵌入器(零依赖、无模型、无网络),以及 combined 融合匹配器;recovery 子包提供语义重匹配、按标签页 LRU 的 IntentCache 与失败分类。库无状态、线程安全。
使用方式:开发前先跑 ./dev doctor;改代码后 ./dev test 做快速单测,提交前 ./dev check(fmt+vet+lint+test race),开 PR 前 ./dev pr(check+e2e+lint corpus+bench)。质量回归用 ./dev baseline check,性能回归用 ./dev runtime;有意变更质量时经评审后 ./dev baseline update。调权重用 ./dev tune 再 ./dev bench。基准指标含 MRR、P@1、Hit@3;测试用例加到 tests/benchmark/corpus/*/queries.json,用 ./dev lint corpus 校验。
架构:semantic.go 为公共 API,internal/ 隐藏实现(types、engine),recovery/ 为公开子包,cmd/semantic 为 CLI,cmd/semantic-bench 为基准 CLI。公开符号仅 ElementMatcher、Embedder、ElementDescriptor、ElementMatch、FindOptions、FindResult 及若干构造函数与函数。
限制:资料未提供收费、价格、平台支持范围与具体效果数据;发布流程涉及 npm 版本、git tag、GoReleaser 与 homebrew tap,细节以项目实际为准。