SAG-Wiki - 面向人与智能体的轻量本地知识库
SAG-Wiki 是 Zleap-AI 维护的 MIT 许可本地知识库，为人和编码智能体提供文件索引、检索与可溯源问答。据项目自述，索引与检索不调用 LLM，桌面端安装包 14 MB，并提供 CLI 与可安装的 Agent Skill。
SAG-Wiki 是一个面向个人用户与编码智能体的轻量本地知识库项目，由 Zleap-AI 维护，采用 MIT 许可证。它要解决的问题很具体：把本地文件夹里的文档、笔记和代码变成可检索、可提问、且答案能回溯到原文出处的知识库。据项目自述，它的索引与检索过程不调用 LLM，也不需要单独安装数据库，因此适合希望把资料留在本机、又想让智能体读到同一份知识的人。项目同时提供桌面应用和命令行两种形态，前者面向日常阅读与提问，后者面向终端用户和 Claude Code、Codex、OpenCode 这类编码智能体。
维护者与状态
项目仓库位于 GitHub，维护者为 Zleap-AI。仓库创建于 2026-10-18，最后一次提交在 2026-11-11，最新 release 为 v0.2.9，发布于 2026-11-11。截至 2026-11-11，仓库星标数为 1013。项目另有一个官网入口，用于了解产品与文档。
从时间线看，这是一个相当新的项目：创建到最新版本不足一个月，版本号已推进到 0.2.x，说明迭代节奏较快。读者在评估时应注意版本仍处于 0.x 阶段，接口与行为可能随版本变化。
主要能力
以下能力描述均来自项目自述（README 与官网文案），未经独立验证。
- 本地文件索引与快速搜索：添加一个文件夹即可让文档、笔记和代码进入索引，文件保留在原始位置。据项目说明，快速搜索完全在本地完成，不需要 API key。
- 不依赖 LLM 的索引与检索：项目称索引与检索阶段不调用 LLM、不做 embedding，因此准备知识的过程没有模型调用成本。据项目自述，索引一百万字符约需 200 毫秒，桌面安装包约 14 MB——这两个数字来自项目自述，本站未做复现。
- SAG2 证据检索：项目称其自研的 SAG2 检索方法通过 Jev 证据打分与查询时扩展，跨文档定位支撑段落。项目自述该方法在效果上优于 RAG、GraphRAG 等方案，相关基准与复现代码在其配套的 SAG-Benchmark 中；这些对比结论属于项目方主张。
- 带引用的问答：在 Chat 中用
@选择文件提问，点击引用可查看支撑答案的原文段落。生成答案时才使用 LLM，需要自行配置答案模型与 API key。 - 文档阅读与编辑：支持阅读和编辑 Markdown、预览 HTML、浏览相关文档，也可在终端中搜索。
- 格式转换：PDF、Office、EPUB 开箱即可转换；图像识别与音视频转写属于可选组件，按需下载。
- 文件变更跟踪：据项目说明，它会监视本地文件变化并更新索引。
- 智能体接入：提供 CLI 与可安装的 Skill，让编码智能体访问同一份知识库。
使用入口
仓库地址：Zleap-AI/SAG-Wiki；官网：sag-wiki.zleap.com。
桌面端：从最新 release 下载 macOS DMG 或 Windows 版本，macOS 上拖入 Applications 即可。打开后在侧边栏切到 Folders，点击文件夹管理旁的 + 添加要搜索的目录，索引完成后即可在 Search 中查找段落并预览原文。
命令行：需要 Node.js 18 或更高版本，执行：
npm install -g @zleap-ai/sag
据项目说明，npm 包内含 macOS Apple Silicon 与 Windows x64 的二进制，无需 Rust 工具链或源码编译；安装 CLI 不会同时安装桌面应用。常用命令包括 sag add 添加目录、sag check 确认索引就绪、sag "问题" . -m 5 执行检索。
智能体接入：项目给出的方式是把 Skill 安装到对应目录——Codex 为 ~/.agents/skills/sag/，Claude Code 为 ~/.claude/skills/sag/，OpenCode 为 ~/.config/opencode/skills/sag/，然后新开一个会话，在目标项目中添加文件夹并确认索引完成。
语义检索需要配置 Jev 服务：在 Settings → Models 中选择 Custom 并填入模型名与 base URL（例如 http://127.0.0.1:8000/v1），不需要鉴权时选择 No authentication。CLI 对应写法为：
sag config --url http://127.0.0.1:8000/v1 --model YOUR_MODEL --auth none
据项目说明，该服务需实现 Jev 的 state、questions 与 answers.*.noul 协议。
许可与限制
许可证为 MIT。项目自述软件本身免费开源，但外部服务费用取决于所选服务商。
需要留意的边界条件：
- 原始文件留在本机，但据项目说明，深入检索与问答会把必要的问题、文档段落或上下文发送到用户自行配置的服务，隐私边界取决于所配置的服务商。
- 文件索引与快速搜索无需 API key；SAG2 语义检索需要配置 Jev 服务，带引用的问答还需要额外的答案模型与 key。也就是说，完整体验并非零配置。
- CLI 的 npm 包目前只提供 macOS Apple Silicon 与 Windows x64 二进制，其他平台需参考开发指南自行构建。
- 安装包体积不含可选的文档转换组件与按需下载的识别模型。
- 项目处于 0.x 阶段，最新版本为 v0.2.9，功能与配置方式可能随版本调整。
关于检索效果的对比结论与性能数字，均出自项目自述，读者如需采信，建议查阅其配套基准与复现代码。