liliu-z/stashbase

StashBase – 面向 AI 代理的本地优先知识库

是什么 – StashBase 是一个开源桌面应用程序（macOS、Windows、Linux），可将你计算机上的文件转换为可搜索、可链接的 Markdown 维基，供 AI 代理作为上下文使用。原始文档完全不受影响；生成的维基页面是普通 Markdown 文件，由你拥有。

核心功能

• 自动维基创建 – 通过集成的代理（默认为 OpenQuill，或 Claude Code / Codex）请求“从文件夹构建维基”。代理将生成 index.md 和支持页面，并链接回原始文件。
• 语义搜索 – 基于从 PDF、DOCX、图像（OCR）和音频/视频转录中提取的文本进行语义检索。关键词搜索开箱即用；语义搜索使用你配置的提供方（如 OpenAI、OpenRouter 等）的嵌入向量。
• 聊天驱动工作流 – 内置聊天窗口允许你与代理对话，请求维基更新，询问材料相关问题，并让代理实时编辑页面。
• 本地优先数据模型 – 所有源文件和维基页面均保留在你的磁盘上。只有提取的文本和向量索引由应用存储；从库中删除文件夹不会丢失任何原始文件。
• MCP（模型-客户端-协议）兼容性 – 应用暴露一个配置，外部 MCP 客户端可使用，因此你可以将其他基于 LLM 的工具连接到同一库。

如何获取

• macOS（Apple Silicon） – brew install --cask liliu-z/stashbase/stashbase
• Windows（x64） – 从最新发布页面下载 .exe 文件。
• Linux – 下载适用于 x86_64 的 .deb 或 AppImage 文件。
• 你也可以使用 Node 24+、pnpm 和 Python 3.10+ 从源码构建（完整命令列表见 README）。

典型工作流

1. 打开包含笔记、研究 PDF、代码文档等的文件夹。
2. 在聊天中请求代理为该文件夹“构建维基”。
3. 代理创建 wiki/index.md 和其他主题页面，并链接回原始文件。
4. 搜索库（关键词或语义）或提出后续问题；代理可将源文件与聊天并排打开，并在你学习过程中持续改进维基。

为何重要 – 许多 AI 助手工具要求你复制粘贴或上传文档。StashBase 让你将所有内容保留在本地，提供持久且可编辑的知识库，并在不移动数据的情况下，提供与云服务相同的向量检索体验。

状态与社区 – 早期 alpha 版本；项目正在积极征求关于代理工作流、搜索质量及跨平台稳定性的反馈。支持可通过 Discord 和 GitHub 问题追踪器获取。

许可证 – Apache 2.0。