DeepV-Ki

AI-Powered Wiki Generator for Code Repositories

一键将代码仓库转换为美观、交互式的 Wiki 文档 | 智能架构分析 | RAG 代码问答

中文 | English

DeepV-Ki 是一个由 AI 驱动的开源 Wiki 生成器，旨在解决代码文档维护难、阅读难的问题。只需输入仓库 URL，DeepV-Ki 就会自动分析代码结构、生成详细文档、绘制架构图表（Mermaid），并构建一个支持 RAG（检索增强生成）问答的交互式知识库。

无论是 GitHub、GitLab 还是 Bitbucket，DeepV-Ki 都能帮助开发者快速理解复杂的代码库。

• Python 3.12+ (后端)
• Node.js 18+ (前端)
• pnpm (前端包管理)
• uv (Python 包管理，推荐)

git clone https://github.com/OrionStarAI/DeepV-Ki.git
cd DeepV-Ki

复制示例配置文件并填入必要的 API Key（如 OpenAI 或 GitLab 配置）：

cp .env.example .env
# 编辑 .env 文件
# 必填: OPENAI_API_KEY (或其他 LLM Key)
# 选填: GITLAB_CLIENT_ID (如果需要 OAuth)

我们提供了统一的开发环境启动脚本：

./start_dev.sh

启动成功后访问：

• 前端: http://localhost:3000
• 后端 API: http://localhost:8001/docs

DeepV-Ki 支持灵活的环境变量配置，主要配置项如下：

🔗 详细指南：遇到配置问题？请查看 GitLab OAuth 配置指南。

完整的环境变量列表及说明请参考 .env.example 文件。

项目采用现代化的前后端分离架构：

• Backend (api/): 基于 FastAPI 和 Python。负责 Wiki 生成核心逻辑、RAG 系统 (AdalFlow + FAISS)、任务队列和 Git 操作。
• Frontend (frontend/): 基于 Next.js 15 和 React 19。提供现代化的 UI、Mermaid 图表渲染和流式交互体验。

graph TD
    User[用户] --> Frontend[Next.js 前端]
    Frontend --> Backend[FastAPI 后端]
    Backend --> LLM[LLM 服务 OpenAI/Gemini]
    Backend --> VectorDB[FAISS 向量库]
    Backend --> Git[Git 服务 GitHub/GitLab]

• Backend: Python 3.12, FastAPI, Uvicorn, AdalFlow, FAISS
• Frontend: TypeScript, Next.js 15, React 19, Tailwind CSS 4, Mermaid.js
• DevOps: Docker, uv, pnpm

我们非常欢迎社区贡献！如果您有好的想法或发现了 Bug，请：

1. Fork 本仓库
2. 创建您的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交您的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启一个 Pull Request

本项目采用 MIT 许可证。

This project is evolving towards an AI-driven development workflow:

• Issues define tasks
• AI agents (e.g., dvcode) implement features
• Pull Requests are reviewed by humans and AI
• Code evolves through iterative collaboration

This is an experimental step toward AI-native software engineering.