tajiaoyezi 参与了项目的全流程设计、编码、提供思路
Linux.Do 社区 (真诚 、友善 、团结 、专业)
优雅地用 AI 书写知识，精准地提问 Write Knowledge with AI Elegantly, Ask Precisely
面向知识工作者的开源 AI 知识管理平台 — 集优雅富文本编辑、结构化知识库与可溯源 RAG 问答于一体
🌐 产品介绍 · 📖 文档中心 · 🚀 快速开始 · 💬 社区讨论 · English
|
基于 Plate.js 52 的块状富文本，支持标题、代码、表格、Mermaid、LaTeX、Excalidraw、Mind Map、AI 改写等 50+ 插件。 |
树形目录组织、增量索引、公开分享链接、文章 / 节点级权限控制，支持 Markdown 双向转换。 |
|
Query Analysis → Hybrid Retrieval → Fusion Ranking → Conditional Rerank 四段流水线，支持范围控制与反馈闭环。 |
回答附带原文片段与来源链接，每一句话都能追溯到知识库节点；多通道检索（Vector + BM25 + Title + Path）。 |
💡 在线产品介绍：https://dosphere.wl.do/ — 浏览完整功能截图与设计理念
| 优雅编辑器 | 结构化知识库 |
|---|---|
 |
 |
| RAG 问答与溯源 | 公开分享与访问统计 |
 |
 |
📋 前置要求：Docker 24+ · Docker Compose v2+ · 4GB 可用内存（Docker Desktop 建议分配 ≥ 6GB，以容纳前端构建内存峰值）· 端口 8080/3000/5432/9200 空闲
git clone https://github.com/LittleBunVerse/Dosphere.git
cd Dosphere
make bootstrap # 自动检查环境 → 生成 .env → 启动 → 健康验证git clone https://github.com/LittleBunVerse/Dosphere.git
cd Dosphere
[ -f .env ] || cp .env.example .env # 首次复制，已存在则保留你的配置
docker compose up -d # 拉镜像并启动| 入口 | 地址 |
|---|---|
| 🌐 前端 | http://localhost:8080 |
| ⚙️ 后端 API | http://localhost:3000 |
| 📧 演示账号 | demo@example.com / demo123456 |
更多启动方式（GHCR 镜像 / 本地源码 / 故障排查）见 Quick Start →
flowchart LR
User([用户]) --> FE[前端 Nginx<br/>React + Plate.js]
FE -->|/api/*| BE[后端 Gin<br/>Go 1.24]
BE --> PG[(PostgreSQL<br/>业务数据)]
BE --> ES[(Elasticsearch<br/>向量 + BM25)]
BE -->|SSE 流| FE
BE -.HTTPS.-> AI{AI Provider<br/>OpenAI / 兼容 / SiliconFlow}
subgraph "AI 检索流水线"
QA[Query Analysis] --> HR[Hybrid Retrieval]
HR --> FR[Fusion Ranking]
FR --> CR[Conditional Rerank]
end
BE -.-> QA
classDef store fill:#fff4e6,stroke:#ff8c00
classDef ai fill:#e6f7ff,stroke:#1890ff
class PG,ES store
class AI,QA,HR,FR,CR ai
技术栈一览：
| 层 | 技术 |
|---|---|
| 前端 | React 19 · Vite 7 · TypeScript · Plate.js 52 · shadcn/ui · Tailwind 4 · @ai-sdk/react · ssgoi |
| 后端 | Go 1.24 · Gin · pgx · trpcagent (Agent 框架) |
| 数据 | PostgreSQL 16 · Elasticsearch 8.17（向量 384 维） |
| AI | OpenAI / OpenAI Compatible / SiliconFlow · Hybrid Retrieval · Conditional Rerank |
| 部署 | Docker Compose · Nginx · GHCR 镜像 |
完整架构详见 docs/architecture/overview.md →
| 主题 | 链接 |
|---|---|
| 🚀 快速开始 | Quick Start · 本地开发 · 演示账号 |
| 🏛 架构 | 总览 · 后端分层 · 前端结构 · 数据模型 |
| ⚙️ 配置 | 环境变量 · AI 模型接入 · 加密配置 |
| 🛠 运维 | 备份恢复 · Schema 迁移 · 版本升级 · 生产部署 |
| 📚 指南 | 常见问题 FAQ · 故障排查 · 贡献指南 |
🌟 强烈推荐：项目全景梳理与技术问答 — 一文读懂 Dosphere 的全部架构
make help # 查看所有命令
make bootstrap # 首次启动向导（推荐）
make up # 启动全栈
make down # 停止服务（保留数据）
make logs # 实时日志
make health # 健康检查
make secrets # 生成强随机加密密钥
make backup # 备份 PG + ES
make reset # ⚠️ 重置演示数据
make dev-deps # 仅启动 PG + ES（本地开发后端时用）完整命令列表见 Makefile 或运行 make help。
⚠️ 演示版默认不内置任何模型凭证，必须自行配置后才能使用 AI 对话与向量检索。
| 方案 | 适合 | 成本 |
|---|---|---|
| SiliconFlow | 国内访问，新手友好 | 免费额度 + 按量付费 |
| Groq | 极速推理 | 免费额度 |
| Ollama | 完全本地、隐私敏感 | 0（自建算力） |
| OpenAI | 性能与生态最优 | 按量付费（需代理） |
详细接入步骤（含 API Key 加密机制）见 AI 模型接入 →
- Plate.js 富文本编辑器
- PostgreSQL + Elasticsearch 双存储
- 多 Provider AI 模型支持
- 多通道检索 + Conditional Rerank
- Docker Compose 一键部署
- 完整中英文文档体系
- 多架构镜像（amd64 + arm64 / 即将支持 Mac M 芯片原生）
- JWT / Redis 鉴权（替代当前内存 SaToken，支持多副本）
- 协作编辑（基于 Yjs / CRDT）
- Helm Chart（Kubernetes 部署）
- 插件系统（自定义 retrieval channel / artifact 类型）
社区建议与投票请到 Discussions。
我们欢迎一切形式的贡献 — 代码、文档、设计、测试、Issue、Discussion。
MIT License © 2026 Dosphere Contributors
你可以自由使用、修改、分发本项目（包括商用），但需保留版权声明与 License。