open-webui/oikb

解决的问题

oikb 是一个专为自动保持 Open WebUI 知识库更新而设计的同步工具。通过将各种外部数据源连接到 Open WebUI，它消除了手动上传文件到知识库的工作，确保 LLM 能够访问最新信息。

工作原理

该工具使用增量 SHA-256 差分比对，确保仅上传新增或修改的文件。整个过程分为四个步骤：

1. 扫描源数据并计算校验和。
2. 将清单发送到 Open WebUI 的 /sync/diff 端点。
3. 删除过时的文件并创建缺失的目录。
4. 仅上传已更改的文件。

适用人群

使用 Open WebUI（版本 0.9.6+）并跨多个平台（如 GitHub、Confluence 或 S3）管理大量文档、代码或研究数据的用户，希望在无需手动更新的情况下将这些数据集成到 AI 知识库中。

主要亮点

• 广泛连接性：支持 46 个连接器，涵盖代码仓库、云存储、维基、工单系统、消息应用和研究工具（如 Zotero）等类别。
• 边缘情况管理：提供包含/排除通配符和文件大小限制的过滤器，精确控制同步内容。
• 生产就绪的守护进程：提供长期运行的调度器，支持 HTTP API、Prometheus 指标、健康检查，以及通过 Slack 或 PagerDuty 的故障通知。
• LLM 触发同步：可作为 OpenAPI 工具服务器添加到 Open WebUI，使 LLM 本身能够触发同步并检查状态。
• 灵活部署方式：支持 CLI、Docker、Docker Compose 和 GitHub Actions。