Connapse 是一个开源、可自托管的 AI 智能体知识后端，目标是为 AI 智能体提供持久、可搜索的记忆，避免每次新会话都从零开始、无法访问历史研究与文档的问题。
用途
Connapse 让 AI 智能体能够查询和构建自己的知识库：可以上传文档，也可以将其指向现有的 Amazon S3 存储桶或本地文件系统，然后智能体通过 MCP 工具、REST API 或 CLI 进行查询，获得带来源引用的结构化答案。适合需要知识后端既能被查询又能被构建的 AI 智能体开发者、希望获得符合现有技术栈与云身份的 RAG 平台的 .NET/Azure 团队，以及需要项目隔离知识库、RBAC 与审计追踪的企业团队。
主要能力
- 容器隔离知识：每个项目拥有独立的向量索引、存储连接器和搜索配置，项目、团队或客户之间不会交叉污染。
- 混合搜索：向量相似度与关键词全文搜索相结合，支持可配置的融合策略（凸组合、DBSF、AutoCut）。
- 多提供方 AI：嵌入和 LLM 可在 Ollama、OpenAI、Azure OpenAI、Anthropic 之间切换，支持运行时、按容器更换，无需重启。
- 索引现有存储：连接 MinIO、本地文件系统（实时文件监听）或 Amazon S3（IAM 认证），文件可保留在原处。
- 四种访问方式：Web UI、REST API、CLI（原生二进制）以及面向 Claude 的 MCP 服务器。
- 企业级认证：多层级 RBAC（Cookie + OAuth 2.1 + PAT + JWT），支持 AWS 身份链接；配置身份链接后按 AWS 权限进行逐用户搜索结果过滤（可选，未配置时不受限制）。
- 一键部署：Docker Compose 集成 PostgreSQL + pgvector、MinIO 和可选 Ollama，内置结构化审计日志和速率限制。
- 多格式摄取：PDF、Office 文档、Markdown、纯文本自动解析、分块并生成嵌入。
- 实时处理：后台摄取，通过 SignalR 实时更新进度。
- 运行时配置：按容器更改分块策略、嵌入模型和搜索设置，无需重启。
- 云身份链接：AWS IAM Identity Center（SAML）身份链接；配置后按 AWS 权限进行逐用户过滤（可选，未配置时不受限制）。
- 仅限邀请访问：管理员控制用户注册，四种角色（Admin / Editor / Viewer / Agent）。
- 智能体管理：专门的智能体实体，具备 API 密钥生命周期、作用域权限和审计追踪。
- 审计日志：对上传、删除、容器操作和认证事件进行结构化审计。
- CLI 分发：原生自包含二进制（Windows/Linux/macOS）以及通过 NuGet 的 .NET 全局工具。
- 跨模型搜索：项目中途更换嵌入模型，对旧向量自动从语义回退到混合搜索。
使用方式
- 部署：需要 Docker 与 Docker Compose、.NET 10 SDK（开发用）、可选 Ollama（本地嵌入）。运行 Docker Compose 后，首次启动会拉取镜像（约 2-5 分钟）、初始化 PostgreSQL 与 pgvector 扩展并运行 EF Core 迁移、创建 MinIO 桶、播种管理员账户并启动 Web 应用。
- 与 Claude 等 MCP 客户端集成：在 Web UI 的 Settings → Agent API Keys 创建智能体 API 密钥，然后在客户端配置中加入相应片段（如 claude_desktop_config.json、VS Code 或 Cursor MCP 配置）。MCP 服务器支持 Streamable HTTP 传输，兼容 Claude Desktop、Claude Code、VS Code、Cursor 等客户端。
- CLI：connapse CLI 单独发布在 Destrayon/connapse-cli，支持认证命令（auth login、auth whoami、auth pat）等。
- MCP 工具示例用法：创建容器、上传文档、搜索容器内容、列出文件、获取全文、删除并更新文件、删除文件夹、查看文档与分块统计等。
适用场景
- AI 智能体开发者需要智能体既能查询又能构建知识库。
- .NET / Azure 团队希望 RAG 平台贴合现有技术栈与云身份。
- 企业团队需要项目隔离知识库、RBAC 与审计追踪。
- 不想反复上传文件，希望直接指向现有 Amazon S3 或文件系统存储。
限制
- 项目处于活跃开发中，当前 v0.3.2，正在接近生产就绪，尚未发布 1.0 稳定版。
- Azure Blob Storage 连接器和 Azure AD 云身份链接在 v0.3.0 发布后已被移除（#476），AWS IAM Identity Center 设备认证流程的实现也已移除（#435）；逐用户 AWS 搜索过滤基于 ISearchScopeResolver + AWS S3 Access Grants 重建，为可选且一旦配置 AWS 身份链接即失败关闭；未配置的部署没有逐用户过滤。
- 生产环境需设置强 Identity__Jwt__Secret。
- 上传有文件类型允许列表，最大文件大小取决于服务器配置；文档上传后需要时间嵌入才能被搜索到。
- 常见问题：Docker 未运行或端口冲突导致 localhost:5001 连接被拒；API 密钥仅在创建时显示一次；MCP 客户端配置更改后需重启。
安全与许可
- 安全策略详见 SECURITY.md，包含安全限制与路线图。
- MIT 许可证，允许商业和私人使用，唯一要求是在软件的重要部分中包含版权声明和许可证。
路线图
- v0.4.0：通信连接器（Slack、Discord）。
- v0.5.0：知识平台连接器（Notion、Confluence、GitHub）。
- v1.0.0：生产就绪稳定版。
