其他
用 Nia 跨 3000+ 包语义搜索库文档与代码示例(需…
当需要快速查找 npm/PyPI/Crates/Go 某个包的 API 用法、依赖注入等语义问题或具体代码模式时,用 Nia 命令行工具做语义或正则检索。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
用 Nia 跨 3000+ 包语义搜索库特定
解决思路
- 在包内做语义搜索:执行 `uv run python -m runtime.harness scripts/mcp/nia_docs.py --package <包名> --query "<自然语言查询>"`,例如 `--package fastapi --query "dependency injection"`。
- 需要指定注册表时追加 `--registry`,可选值为 `npm`、`py_pi`、`crates`、`go_modules`,默认是 `npm`;例如 `--package pydantic --registry py_pi --query "validators"`、`--package react --registry npm --query "hooks patterns"`。
- 需要精确匹配代码片段时用 `--grep` 传正则表达式,例如 `--package sqlalchemy --grep "session.execute"`、`--package express --grep "app.use"`。
- 不确定目标包、想在所有已索引来源中做通用检索时用 `--search "<关键词>"`,例如 `--search "error handling middleware"`。
- 用 `--limit` 控制返回结果条数(默认 5),避免结果过多。
- 调用前确保环境变量中有 `NIA_API_KEY`,或在 `mcp_config.json` 中配置好 `nia` server。
适用边界 · 注意事项
- 没有 NIA_API_KEY、也未在 mcp_config.json 中配置 nia server 时无法调用。
- 需要查询未被 Nia 索引的私有包或非 npm/py_pi/crates/go_modules 的注册表时不适用。