导管
通过私有知识库使您的人工智能工具更加智能
您的文件。你的AI,你的控制。
  ](https://github.com/amlandas/Conduit-AI-Intelligence-Hub/releases/latest) ](https://github.com/amlandas/Conduit-AI-Intelligence-Hub/discussions)
______________________________________________________________________
Conduit将您的本地文档转换为 私人知识库 这使得Claude Desktop、ChatGPT、Perplexity等人工智能工具以及Claude Code、Cursor、Copilot、Kiro和Gemini CLI等人工智能编码助手变得更加智能。
一切都是本地的。 任何文档或工件都不会离开您的机器。
为什么选择Conduit?
人工智能工具功能强大,但它们在以下方面存在困难:
- 上下文膨胀:输入过多信息会淹没人工智能
- 缺少上下文:信息不足会导致幻觉
- 隐私问题:敏感文件不应离开您的机器
Conduit通过以下方式解决了这个问题:
- 智能检索:RAG(检索增强生成)和KAG(知识增强生成)找到了正确的上下文
- 本地优先:所有处理都在您的机器上进行-文档永远不会离开
- MCP集成:适用于任何支持的AI工具 模型上下文协议
______________________________________________________________________
快速入门(5分钟)
通过CLI安装(推荐)
curl -fsSL https://raw.githubusercontent.com/amlandas/Conduit-AI-Intelligence-Hub/main/scripts/install.sh | bash安装程序处理一切:
- 安装Conduit CLI和守护程序
- 设置容器运行时(Podman/Docker)
- 通过Ollama安装AI模型
- 配置矢量数据库(Qdrant)和知识图(FalkorDB)
- 用Claude代码自动配置MCP服务器
验证安装
# Restart terminal, then:
conduit doctor添加您的文档
# Add a folder to your knowledge base
conduit kb add ~/Documents/my-project --name "My Project"
# Sync documents (indexes for search)
conduit kb sync
# Test search
conduit kb search "how does authentication work"就是这样! 你的人工智能工具现在可以访问你的私人知识库。
______________________________________________________________________
运作原理
┌─────────────────────────────────────────────────────────────────────┐
│ Your Local Machine │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────────────────────────┐ │
│ │ Your Docs │ ──────► │ Conduit │ │
│ │ (PDF, MD, │ │ ┌────────────────────────────┐ │ │
│ │ Code, etc.) │ │ │ RAG: Semantic + Keyword │ │ │
│ └──────────────┘ │ │ KAG: Knowledge Graph │ │ │
│ │ └────────────────────────────┘ │ │
│ └───────────────┬──────────────────┘ │
│ │ │
│ │ MCP Protocol │
│ ▼ │
│ ┌────────────────────────────────────────────────────────────┐ │
│ │ AI Tools (via MCP Server) │ │
│ │ Claude Code │ Cursor │ Claude Desktop │ ChatGPT │ etc. │ │
│ └────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────┘关键技术
| 组件 | 目的 |
|---|---|
| 检索增强生成 (检索增强生成) | 使用向量搜索查找语义相似的文档 |
| 卡格 (知识增强生成) | 为多跳推理构建知识图 |
| 主控程序 (模型上下文协议) | AI工具访问外部数据的标准协议 |
| Qdrant | 用于语义搜索的矢量数据库(在容器中本地运行) |
| FalkorDB 的 | 知识图的图形数据库(在容器中本地运行) |
| 奥拉玛 | 用于嵌入和实体提取的局部AI模型 |
______________________________________________________________________
CLI 参考
Conduit是CLI首选工具。有关完整的命令参考,请参见 CLI命令索引.
基本命令
# Setup & Health
conduit doctor # Run diagnostics
conduit status # Show system status
# Knowledge Base
conduit kb add
# Add document folder
conduit kb sync # Index documents
conduit kb search # Search your knowledge base
conduit kb list # List all sources
conduit kb stats # Show statistics
# MCP Server
conduit mcp status # Verify MCP server is configured
conduit mcp configure # Configure MCP for Claude Code搜索模式
# Hybrid search (default) - combines keyword + semantic
conduit kb search "authentication flow"
# Semantic search - finds by meaning
conduit kb search "securing user login" --semantic
# Keyword search - exact matches
conduit kb search "OAuth2 client_id" --fts5知识图查询
# Extract entities from your documents
conduit kb kag-sync
# Query relationships
conduit kb kag-query "Kubernetes"
conduit kb kag-query "authentication" --entities OAuth,JWT --max-hops 2______________________________________________________________________
MCP服务器集成
Conduit会自动为您的知识库创建一个MCP服务器,并为Claude Code配置它。
克劳德代码(自动配置)
运行后 conduit kb sync,您的知识库在Claude Code中自动可用。
其他人工智能工具(手动配置)
添加到AI工具的MCP配置中:
{
"mcpServers": {
"conduit-kb": {
"command": "conduit",
"args": ["mcp", "kb"]
}
}
}配置位置:
- 克劳德桌面:
~/Library/Application Support/Claude/claude_desktop_config.json - 光标:
.cursor/mcp.json - VS Code:
.vscode/settings.json(根据mcp.servers)
可用的MCP工具
| 工具 | 说明 |
|---|---|
kb_search | 混合搜索(语义+关键字) |
kb_search_with_context | 使用合并的结果和引用进行搜索 |
kb_list_sources | 列出索引文档源 |
kb_get_document | 检索完整文档内容 |
kb_stats | 知识库统计 |
kag_query | 查询实体知识图 |
______________________________________________________________________
安装选项
CLI安装(推荐)
# Standard install
curl -fsSL https://raw.githubusercontent.com/amlandas/Conduit-AI-Intelligence-Hub/main/scripts/install.sh | bash
# Custom options
curl -fsSL ... | bash -s -- --install-dir ~/.local/bin # Custom location
curl -fsSL ... | bash -s -- --skip-model # Skip AI model download
curl -fsSL ... | bash -s -- --no-kag # Skip knowledge graph setup
curl -fsSL ... | bash -s -- --verbose # Verbose output手动安装
git clone https://github.com/amlandas/Conduit-AI-Intelligence-Hub.git
cd Conduit-AI-Intelligence-Hub
make build
sudo cp bin/conduit bin/conduit-daemon /usr/local/bin/
conduit setup桌面应用程序(实验)
注: 桌面应用程序目前处于试验阶段,正在积极开发中。CLI是使用Conduit的推荐方式。
对于喜欢图形界面的用户,请从以下网址下载DMG 发布.
Desktop App Details
下载
- 苹果硅(M1/M2/M3/M4):
Conduit-x.x.x-arm64.dmg
macOS安全说明
首次启动时,您可能会看到“Conduit.app已损坏”。运行:
xattr -cr /Applications/Conduit.app特性(实验)
- 具有实时状态的仪表板
- 基于RAG调优的知识库管理
- KAG搜索界面
- 设置和配置
______________________________________________________________________
支持的文档格式
| 类别 | 格式 |
|---|---|
| 文档 | .md, .txt, .rst |
| 代码 | .go, .py, .js, .ts, .java, .rs, .rb, .c, .cpp, .h, .cs, .swift, .kt |
| 脚本 | .sh, .bash, .zsh, .ps1, .bat |
| 配置 | .json, .yaml, .yml, .xml, .toml, .ini |
| 数据 | .csv, .tsv |
| 文件 | .pdf, .doc, .docx, .odt, .rtf |
______________________________________________________________________
卸载
建议通过CLI卸载:
# Preview what will be removed
conduit uninstall --dry-run --all
# Uninstall (keeps your data)
conduit uninstall --keep-data
# Full uninstall (removes everything)
conduit uninstall --all备份方法 (如果CLI不可用):
curl -fsSL https://raw.githubusercontent.com/amlandas/Conduit-AI-Intelligence-Hub/main/scripts/uninstall.sh | bash______________________________________________________________________
故障排除
快速诊断
conduit doctor # Comprehensive health check
conduit status # System status overview常见问题
语义搜索显示0个向量:
conduit qdrant status # Check Qdrant
conduit kb sync --rebuild-vectors # Rebuild vectorsMCP服务器不工作:
conduit mcp status # Check MCP configuration
conduit mcp configure # Reconfigure首次运行时KAG提取缓慢: 首次使用时加载提取模型(~4GB)。启用预加载 ~/.conduit/conduit.yaml:
kb:
kag:
preload_model: true有关更多故障排除,请参阅 已知问题.
______________________________________________________________________
文档
______________________________________________________________________
贡献
我们欢迎捐款!请查看 贡献.md 作为指导方针。
______________________________________________________________________
需求
安装程序会自动处理这些问题:
| 要求 | 版本 | 注释 |
|---|---|---|
| 计划支持macOS或Linux | - | Windows |
| Podman或Docker | 4.0+/2010+ | 容器运行时 |
| Ollama | 最新消息 | 本地AI模型 |
______________________________________________________________________
隐私和安全
- 100%本地:所有文件和处理都保留在您的机器上
- 无遥测:Conduit不给家里打电话
- 沙盒容器:Qdrant和FalkorDB在独立的容器中运行
- 只读MCP:人工智能工具只能读取,不能修改你的知识库
______________________________________________________________________
许可证
MIT许可证-请参阅 许可证 了解详情。
______________________________________________________________________
致谢
内置:
- Qdrant -矢量数据库
- FalkorDB 的 -图形数据库
- 奥拉玛 -本地AI模型
- 模型上下文协议 -AI工具集成
______________________________________________________________________
Conduit v1.0 — Private Knowledge Base for AI Tools
