核心用法
Nia 是专为 AI Agent 设计的代码与知识检索基础设施，通过 repos-* 和 sources-* 脚本工具链实现确定性工作流：先检查已索引资源（repos-list.sh/sources-list.sh），若存在则直接检索（search-universal.sh、repos-grep.sh、sources-read.sh），若不存在则先执行索引（repos-index.sh/sources-index.sh），最后才退回到网络搜索。支持 GitHub 仓库、文档站点、arXiv 论文、HuggingFace 数据集四类核心数据源，并提供包级代码搜索（npm/PyPI/crates.io/Go）与 Oracle 自主研究代理（Pro 版）。
显著优点
准确性优先：强制"Nia-First"工作流确保优先使用完整源码而非截断的网页摘要，从根本上减少 LLM 幻觉。
灵活标识系统：支持 UUID、显示名称、URL 三种形式识别同一资源，降低使用门槛。
混合检索能力：search-universal.sh 结合向量语义搜索与 BM25 关键词匹配，实现跨仓库/跨文档的发现能力。
生态覆盖广：原生支持科研文献（arXiv）、ML 数据集（HuggingFace）、多语言包管理器，适合技术研究与开发场景。
潜在局限
依赖外部 API：所有功能需调用 https://apigcp.trynia.ai/v2，存在服务可用性与网络延迟风险。
索引耗时：首次索引需 1-5 分钟，不支持实时增量更新，对高频变更代码库不够友好。
Pro 功能门槛：深度研究（search-deep.sh）与 Oracle 自主代理为付费功能，免费层有使用配额限制。
适合人群
- 构建代码问答 Agent 的开发者与 AI 工程师
- 需要检索最新技术文档/论文的研究人员
- 希望减少 RAG 幻觉、提升上下文质量的 LLM 应用团队
常规风险
- API 密钥需本地存储（
~/.config/nia/api_key），存在本地文件权限管理风险 - 索引第三方仓库可能涉及代码授权与合规问题
- 网络搜索回退机制（
search-web.sh）可能引入未经验证的信息源