核心用法
Nia 是一款面向 AI 代理和开发者的外部知识索引与检索工具，核心价值在于为 LLM 提供结构化、完整、可溯源的上下文，而非网页抓取的碎片化摘要。
典型工作流程
1. 优先检查索引库：使用 ./scripts/sources-list.sh 或 ./scripts/repos-list.sh 确认目标资源是否已索引
2. 已索引资源：通过 search-universal.sh、repos-grep.sh、sources-read.sh 进行精准检索
3. 未索引资源：使用 repos-index.sh 或 sources-index.sh 提交索引任务（耗时 1-5 分钟），完成后即可搜索
4. 未知来源：仅在必要时使用 search-web.sh 或 search-deep.sh 发现 URL，再执行索引
支持资源类型
| 类型 | 索引方式 | 检索能力 |
|------|---------|---------|
| GitHub 仓库 | `owner/repo` + 可选分支 | 文件树浏览、代码 Grep、单文件读取 |
| 技术文档 | 根 URL（自动爬取全站） | 结构化浏览、内容 Grep |
| arXiv 论文 | 论文 ID 或 URL | 全文语义检索 |
| HuggingFace 数据集 | 数据集名称或 URL | 元数据与内容搜索 |
| 软件包（npm/PyPI/Crates/Go） | 包名 + 版本 | 代码级语义搜索 |
高级功能
- Oracle Research（Pro）：自主执行多轮研究任务，自动规划查询路径
- 全局订阅：订阅公开资源变更，保持知识库时效性
显著优点
- 抗幻觉设计：提供完整源代码和文档原文，非网页抓取的截断摘要，从根本上减少 LLM "编造"引用
- 结构化检索：支持类 Git 的操作（tree/grep/read），便于 AI 代理精确定位代码片段
- 多源统一：代码、文档、论文、数据集统一索引，跨源语义搜索
- 确定性工作流：明确的 "先查索引→再索引→最后网页搜索" 优先级，避免重复抓取和 API 浪费
潜在缺点与局限性
- 索引延迟：新增资源需 1-5 分钟索引时间，不适合实时性要求极高的场景
- 存储成本：频繁索引大型仓库（如 Linux 内核）可能产生较高存储费用
- 覆盖盲区：小众或私有资源需手动提交索引，无法直接搜索互联网全域
- Pro 功能门槛：Oracle 深度研究等高级功能需付费订阅
适合人群
- AI 应用开发者：构建需要准确代码引用的 RAG 系统或编码代理
- 科研人员：需要跨论文、数据集、代码库进行系统性文献调研
- 技术文档工程师：维护大型技术文档的知识库，支持智能问答
- 开源维护者：为项目建立可搜索的代码知识库，降低社区答疑成本
常规风险
- API 密钥泄露：
~/.config/nia/api_key明文存储，多用户环境需额外权限控制 - 敏感代码意外索引：提交私有仓库前需确认权限配置，避免意外公开
- 索引内容时效性：订阅功能可缓解，但非实时同步，关键安全补丁需手动刷新索引
- 服务依赖：完全依赖 Nia 云服务可用性，本地无离线缓存机制