docbrain

项目状态：客户端源码开放，服务端闭源。 DocBrain 运行在你的网络边界一侧的所有代码——docbrain CLI 和 IDE MCP 服务器——都在本仓库的 crates/ 目录下，采用 MIT 许可，在公开 CI 中构建和测试——本仓库中的其他一切也是如此。你可以审计你的环境中到底运行着什么、什么会离开你的环境。服务端以免费的生产 Docker 镜像发布（BSL 1.1 允许生产使用），附带完整的 Helm charts、完整配置、威胁模型以及所有用于生产自托管的文档。服务端源码暂时保持闭源——我们原本计划在 2026 年上半年发布，但错过了那个日期，在确定能实现之前我们不会再公布新日期。如果闭源服务端对你来说不可接受，这是一个理性的立场，我们尊重这一点：DocBrain 如何赢得信任。贡献方式：客户端 crate 的代码 PR，以及文档、配置和 bug 报告。服务端源码发布时，将采用 Business Source License 1.1 许可。

问题

每个组织都依赖那些从未被写下来的知识运转：会议中的决定、某人在凌晨 2 点找到的修复方案、只有一个人知道的变通方法。它们存在于 PR、聊天讨论串、工单和人们的头脑中。当那个人换团队或离职时，多年的上下文就随他们一起离开了。

那些"索引你的文档并加个聊天机器人"的工具解决的是错误的一半问题：它们只是让你检索过时、不完整的 wiki 稍微快一点。真正驱动你组织运转的知识从一开始就没有被捕获。而且随着 AI 生成代码、变更和流畅文档的速度超过任何人类能吸收的速度，这个问题正在变得更糟——你的代理也会阅读那些文档。更多的文档很容易。你的组织能够信任的文档才是稀缺的东西。

Related MCP server: MCPDocSearch

DocBrain 的工作原理

DocBrain 在知识产生的那一刻、在源头捕获知识：

  Someone merges a change      ──→  decisions, caveats, procedures extracted
  A team works through chat    ──→  the answer, distilled from the thread
  A deploy goes out            ──→  what changed and why
  On-call resolves an incident ──→  the fix and the root cause
  Any other system you run     ──→  ingested via the Connector SDK

从第一天起它也会向后读取。 把它指向你已经使用多年的系统——归档的 Slack 频道、已关闭的工单、已合并的拉取请求、自 2022 年以来没人打开过的 wiki——它会在原地以只读方式摄取这些内容。你的第一个答案可能来自一个没人记得是谁写的讨论串。无需迁移任何内容，也无需任何人重新归档任何东西。

捕获的片段会经过置信度评分，连接成一个记忆，并组合成带有逐条论断出处的文档。草稿在发布前会经过人工审核。然后 DocBrain 让结果保持诚实：随着现实变化，进行新鲜度跟踪、矛盾检测和过时提醒。提出一个问题，得到一个带引用的答案——或者一个诚实的"我不知道"，而不是猜测。

快速开始

git clone https://github.com/docbrain-ai/docbrain.git && cd docbrain
./scripts/setup.sh    # interactive wizard: picks provider, sets keys, starts services

或者手动操作：

cp .env.example .env   # set LLM_PROVIDER and API keys
docker compose up -d

# Get the auto-generated admin API key
docker compose exec server cat /app/admin-bootstrap-key.txt

# Open the web dashboard
open http://localhost:3001

# Or ask a question via API
curl -H "Authorization: Bearer <key>" \
     -H "Content-Type: application/json" \
     -d '{"question":"How do I deploy to production?"}' \
     http://localhost:3001/api/v1/ask

完整设置指南：docs/quickstart.md

教会你的代理

如果你的团队使用 Claude Code 或 Cursor，docbrain-mcp 服务器已经为你的代理提供了捕获工具——大多数团队只是从未告诉代理使用它们。在你的 CLAUDE.md 中加三行，就能把每次调试会话变成文档：

When we resolve an error or discover non-obvious behavior, call
docbrain_suggest_capture for the files involved. If a gap exists, draft a
3–5 line capture and ask me to approve it before calling docbrain_annotate.

你的代理修复了某个问题，检查组织是否已经知道它，并且——在你批准后——把缺失的内容归档到审核队列中。知识只在唯一免费的时刻被捕获：修复后的几秒钟内。完整指南，包括 Cursor 设置和隐私模型：docs/agents.md

你能得到什么

• 从 13 个内置来源捕获 — Confluence、Slack、Teams、GitHub、GitLab、Jira、PagerDuty、Linear、OpsGenie、Rootly、Zendesk、Intercom 和本地文件，外加一个语言无关的 Connector SDK 用于其他任何来源。摄取指南 →

• 带引用的提问 — 混合向量 + 关键词搜索，置信度评分的答案；低置信度时会提出澄清问题而不是猜测。API →

• docbrain generate — 按需生成文档，基于你自己的 runbook、事故、讨论串和 PR，带有逐条论断出处，对于知识无法回答的内容会诚实地给出 needs_input。生成指南 →

• 每份文档的质量门禁 — 结构、风格（你的风格指南，自动执行）和语义评分；未评分的任何内容都不会进入系统。风格策略 →

• 审核工作流和所有权 — 多阶段审批、空间所有者、SLA 和治理仪表板，让文档有问责制。治理 → · 审核 →

• 自动驾驶 — 将未回答的问题聚类为缺口，生成有依据的修复草稿，并将其路由到人工审核。没有监督，任何内容都不会发布。自动驾驶 →

• 实时智能 — 在你提问的那一刻读取已连接的系统，然后将其与索引历史在一个带引用的答案中协调。可写工具在发现时即被丢弃，因此它永远不具备更改任何内容的能力。MCP 工具 →

• 新鲜度和矛盾检测 — 过时文档被标记，冲突文档被浮现，级联过时在依赖文档之间被追踪。知识智能 →

• 学习流水线（可选，默认关闭） — 对答案的反馈可以在你的语料库上微调嵌入模型，让检索学会在你的代码库中"相似"意味着什么。版本在提升前会经过质量门禁，如果出现回退会自动回滚。完全运行在你的基础设施上。学习 →

• 预测智能 — 从新成员入职前 30 天提出的问题中检测入职缺口、季节性查询预测，以及代码变更触发的文档审核。知识智能 →

• 源系统 ACL 镜像 — Confluence 限制、Slack 频道成员资格和仓库可见性在查询时强制执行。访问控制 →

• RBAC、SSO、审计日志 — 4 级角色、GitHub/GitLab/OIDC SSO、按空间隔离。RBAC →

• 你的团队工作的任何地方 — Web 仪表板、Slack 命令、CLI、CI 钩子，以及适用于 Claude Code、Cursor 和任何兼容 MCP 的编辑器的 MCP 工具。Slack →

架构

graph TB
    subgraph "Capture Layer"
        CI["CI/CD Pipelines"]
        IDE["IDE (MCP)"]
        SLACK["Slack / Teams"]
        WEB["Web UI"]
        CLI["CLI"]
        API_EXT["External APIs"]
    end

    subgraph "DocBrain Server (Rust / Axum)"
        FRAG["Fragment Router"]
        QUAL["Quality Pipeline"]
        CLUST["Clustering Engine"]
        COMP["Composition Engine"]
        REV["Review Workflows"]
        RAG["RAG Pipeline"]
        AUTO["Autopilot"]
        GOV["Governance"]
        EVT["Event Bus + Webhooks"]
    end

    subgraph "Storage"
        PG["PostgreSQL"]
        OS["OpenSearch<br/><i>vector + keyword</i>"]
        RD["Redis"]
    end

    CI & IDE & SLACK & WEB & CLI & API_EXT --> FRAG
    FRAG --> QUAL --> CLUST --> COMP --> REV
    WEB & CLI & SLACK --> RAG
    RAG & AUTO & GOV --> PG & OS
    EVT --> PG

Rust 服务器、PostgreSQL、OpenSearch、Redis。完整设计：docs/architecture.md

安全

DocBrain 完全运行在你的基础设施中，对你的来源只读。你选择模型在哪里运行：通过 Ollama 完全本地（零外泄）、你自己的云账户（Bedrock、Azure、Vertex——你的 KMS、你的审计追踪），或提供商 API。文档、嵌入和索引永远不会离开你的网络；只有查询和相关块到达你选择的 LLM。

API 密钥经过 Argon2 哈希，每个端点都强制执行 RBAC，速率限制按密钥设置，管理操作有审计日志。你安装的客户端代码在 crates/ 中是开源的。完整的威胁模型——11 个已分析的攻击向量和一份操作员检查清单——已发布：THREAT_MODEL.md

LLM 提供商（14 个）： Anthropic、OpenAI、AWS Bedrock、Ollama、Google Gemini、Vertex AI、Azure OpenAI、DeepSeek、Groq、Mistral、xAI、OpenRouter、Together AI、Cohere。提供商设置 →

部署

# Docker Compose — everything behind a single origin at localhost:3001
docker compose up -d

# Kubernetes
helm install docbrain ./helm/docbrain \
  --set llm.provider=anthropic \
  --set llm.anthropicApiKey=sk-ant-...

Kubernetes 指南 → · 配置 →

文档

观看实际效果

▶ 快速开始，未剪辑录制 — 安装 → 摄取 → 带引用的答案 → generate 将原始值班笔记变成一份引用其来源的 runbook。90 秒，已发布的镜像，100% 本地模型，没有任何排练。

独立评估

我们让 Atlassian 自己的 AI 助手将其自身与 DocBrain 进行比较，并发布了未经编辑的完整回复——包括它胜出的部分。

"DocBrain 的'捕捉从未被写下的知识'正在解决一个我根本无法解决的问题。" ——Rovo，在回答直接对比提示时

Rovo 的优势：原生 Atlassian 集成、现有 Atlassian Cloud 团队零配置、广泛的工作执行能力，以及 300 万+用户。完整记录 →

我们尚未证明的事情

一个建立在拒绝夸大承诺之上的项目，也不应该对自己夸大其词。

• 服务器是闭源的。 在你的网络内部运行的客户端是 MIT 许可且可审计的，位于 crates/ 中。服务器尚未发布。我们原定于 2026 年上半年完成，但未能如期，在确定之前我们不会公布新的日期。

• 我们不发布实测准确率基准。 Grounding 在内部进行测量，并作为每个模型升级的关卡，但在真实客户语料库上完成测量并能够同时发布方法论之前，本 README 中不会出现任何数字。

• 自托管并非我们独有。 存在开源替代方案，其中一些在检索方面确实做得很好——有些的许可证比我们更宽松。它们做不到的是捕捉从未被写下的知识。请以此评判我们。

• 我们的证据基础在软件团队方面最为扎实。 该机制可推广到支持、运营及其他业务领域；但已发布的统计数据并未在所有领域进行测量，我们也不会暗示并非如此。

社区

• GitHub Issues： Bug 报告和功能请求

• GitHub Discussions： 问题和社区讨论

• 邮箱： hello@docbrainapi.com

贡献

我们欢迎贡献。客户端工具源码（crates/）接受代码 PR；服务端贡献以文档、配置和 Bug 报告的形式最为合适。请参阅贡献指南。

安全报告

如需报告安全漏洞，请参阅 SECURITY.md。请不要提交公开 issue。

许可证

本仓库采用 MIT 许可证——docbrain CLI、MCP 服务器、Helm charts、配置、示例和文档。

DocBrain 服务器二进制文件和容器镜像根据 Business Source License 1.1 分发。允许生产使用，但不得将 DocBrain 作为托管服务提供。如需替代许可：licensing@docbrainapi.com。

行为准则

贡献者公约行为准则。如有问题请发送至 hello@docbrainapi.com。