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。