ARTICLE · 1327355
DocsGPT 私有化文档 AI Agent 平台
极客深潜录 · GEEK DEEP DIVE
DocsGPT 私有化文档 AI Agent 平台
让 AI 基于你的文档回答问题，答案可溯源，数据不出你的环境
18.3k GitHub Stars | 2.2k+ Forks | Python 主语言 | 6+ 支持向量库 |
➤ 企业要的不是"会聊天的 AI"，而是"答得有出处、数据不出门"的 AI。
答案要能溯源到具体文档，数据又不能离开自有环境——这两件事同时做到，正是 DocsGPT 的立身之本。
CHAPTER 01
项目定位与痛点
企业想让 AI 基于内部文档回答问题，两难立刻浮现：把文档喂给公网大模型，合规部门第一个不答应；自己从零搭一套 RAG，解析、向量化、检索、引用标注每一环都是工程活，更别提后续的权限、配额与审计。
DocsGPT 定位为基于文档的私有化开源 AI Agent 平台：把文档、站点与连接的应用变成带来源引用的 AI Agent 和可视化工作流，API、Worker、数据库、向量库全部跑在你自己的环境里，MIT 协议开源。
企业的两难 答案要可溯源，数据不能离开自有环境；公网模型不敢喂，自建 RAG 工程量大且难持续维护。 | DocsGPT 的答案 全栈私有化部署（支持 air-gapped 隔离网），每个回答引用来源文档，guardrails 兜底安全。 |
CHAPTER 02
核心亮点解读
四个亮点串成一条主线：答案可信、编排可视、触达全渠道、部署全私有。
答案带来源 每个回答引用其来源文档；guardrails 可标记、脱敏或阻断 PII、密钥、提示注入与非溯源答案。 | 可视化工作流 拖拽式 builder（React Flow）串联 Agent、条件、状态与沙箱代码节点，Agent 一键发布。 |
全渠道输出 script 标签或 React 包嵌入网站的 chat/search widget、OpenAI 兼容 /v1 API、MCP server 供 Claude/Cursor 检索知识，另有 Discord/Slack/Telegram 机器人与 CLI。 | 私有化设计 API、Worker、Postgres、Redis、向量库与文件全在自有环境，支持 air-gapped 部署；SSO、团队角色、用量配额与审计日志全部 MIT 开源。 |
CHAPTER 03
架构拆解
技术栈是 Flask + flask-restx、Celery + RedBeat、PostgreSQL、Redis 与多种向量库，前端 React + Vite + Redux Toolkit。落到架构上是五层堆栈：集成层在最上承接各种消费端，数据层在最下托底。
| Layer 1 集成层 |
OpenAI 兼容 API 对外 /v1 标准接口 | MCP server 供 Claude/Cursor 检索 | Discord/Slack/Telegram 聊天机器人接入 | DocsGPT CLI 命令行操作入口 |
↓
| Layer 2 前端层 |
React Web 应用 Vite + Redux Toolkit | chat/search widget 网站嵌入组件 | workflow builder React Flow 拖拽编排 |
↓
| Layer 3 服务层 |
DocsGPT API Flask/ASGI 服务 | Celery 任务 异步任务调度 | sandbox 沙箱 代码节点隔离执行 | schedules/webhooks 定时与事件入口 |
↓
| Layer 4 核心层 |
Worker 摄取与向量化 | parser + retriever 多格式解析与检索 | graphrag 图谱检索增强 | guardrails PII 与注入防护 | llm 模型调用封装 |
↓
| Layer 5 数据层 |
PostgreSQL 业务数据与配置 | Redis 缓存与任务队列 | 向量库 FAISS/pgvector/Qdrant/Milvus | 文件存储 原始文档存放 |
[INFO] 架构细节
知识源靠 connectors 连接 Google Drive、SharePoint、Confluence、GitHub、S3 并保持定时同步；解析层支持 PDF、Office、网页、音频等多种格式，可选 docling 引擎；本地模型可用 Ollama/vLLM，六种向量库按需切换。
CHAPTER 04
快速上手
环境要求
| 组件 | 要求 |
一键安装四步走
安装 CLI（macOS / Linux） 一条 curl 命令完成安装。 | |
Windows 用户 用 irm 命令安装 PowerShell 版安装器。 | |
启动全部服务 docsgpt up 一条命令拉起 API、Worker、数据库与向量库。 | |
确认状态并访问 docsgpt status 检查健康度，浏览器打开 http://localhost:7091。 |
[WARNING] 上线前必读
把 DocsGPT 暴露到本机以外之前，先阅读官方架构指南与安全清单（security checklist），并按需启用 guardrails；团队协作场景用 token 与花费配额约束用量，避免知识库被无限制消费。
CHAPTER 05
结语
私有化部署、答案可溯源、安全有兜底、集成无死角——DocsGPT 把企业知识问答做成了开箱即用的平台。
它适合三类人：对数据合规有硬要求的企业团队、想给自家产品加文档问答的开发者，以及需要给 Claude/Cursor 这类工具喂私有知识库的极客。1.8 万星标背后，是"文档 AI 必须私有化"这个判断正在被越来越多人接受。
极客深潜录 · GEEK DEEP DIVE
