f1fe10f22c
- 在知识路由中新增获取指定嵌入模型和聊天模型状态的接口 - 实现获取所有嵌入模型和聊天模型状态的功能 - 更新前端API以支持模型状态检查，增强用户体验 - 优化日志记录格式，提升调试信息的可读性
59 lines
2.9 KiB
Markdown
59 lines
2.9 KiB
Markdown
|
||
# 项目目录结构 (Project Overview)
|
||
|
||
Yuxi-Know 是一个基于知识图谱和向量数据库的智能知识库系统。它通过 FastAPI 提供后端 API，使用 Vue.js 构建前端界面，并利用 Docker Compose 进行整体服务的编排和管理。
|
||
|
||
|
||
```
|
||
Yuxi-Know/
|
||
├── docker/ # Docker 配置文件
|
||
├── scripts/ # 脚本文件，如批量上传等
|
||
├── server/ # 服务端代码（部分）
|
||
├── src/ # 主要源代码目录
|
||
│ ├── agents/ # 智能体应用
|
||
│ ├── config/ # 配置文件
|
||
│ ├── knowledge/ # 知识库相关
|
||
│ ├── models/ # 数据模型
|
||
│ ├── plugins/ # 插件（存放OCR）
|
||
│ ├── static/ # 静态资源（配置文件）
|
||
│ └── utils/ # 工具函数
|
||
├── web/src/ # 前端代码
|
||
│ ├── apis/ # 前端的接口定义
|
||
│ └── views/ # 主要 vue 文件
|
||
└── docker-compose.yml # Docker Compose 配置
|
||
```
|
||
|
||
# 核心服务与容器 (Core Services & Containers)
|
||
|
||
项目使用 Docker Compose 管理多个服务，主要容器名称如下：
|
||
- `api-dev` - FastAPI 后端服务
|
||
- `web-dev` - Vue.js 前端开发服务器
|
||
- `graph` - Neo4j 图数据库
|
||
- `milvus` - 向量数据库，包含 etcd 和 MinIO 依赖
|
||
- `mineru` - 可选的 MinerU OCR 服务（需要 GPU）
|
||
- `paddlex` - 可选的 PaddleX OCR 服务（需要 GPU）
|
||
|
||
## 开发与调试工作流 (Development & Debugging Workflow)
|
||
|
||
本项目完全通过 Docker Compose 进行管理。所有开发和调试都应在运行的容器环境中进行。使用 `docker compose up -d` 命令进行构建和启动。
|
||
|
||
核心原则: 由于 api-dev 和 web-dev 服务均配置了热重载 (hot-reloading)，本地修改代码后无需重启容器，服务会自动更新。应该先检查项目是否已经在后台启动（`docker ps`），具体的可以阅读 [docker-compose.yml](docker-compose.yml).
|
||
|
||
前端开发规范：
|
||
|
||
- API 接口规范：所有的 API 接口都应该定义在 web/src/apis 下面，并继承自 apiGet/apiPost/apiRequest
|
||
- Icon 应该从 @ant-design/icons-vue 或者 lucide-vue-next
|
||
- Vue 中的样式使用 less，并尽量使用[base.css](web/src/assets/css/base.css) 中的颜色。
|
||
- UI风格要简洁，同时要保持一致性，颜色要尽量参考 不要悬停位移，不要过度使用阴影以及渐变色。
|
||
|
||
|
||
后端开发规范：
|
||
|
||
- 项目使用 uv 来管理依赖
|
||
- Python 代码要符合 Python 的规范，尽量使用较新的语法，避免使用旧版本的语法（版本兼容到 3.12+），使用 make lint 检查 lint。使用 make format 来格式化代码。
|
||
|
||
其他：
|
||
|
||
- 如果需要新建说明文档，则保存在 docs/vibe 文件夹下面
|
||
- 测试脚本可以放在 test 文件夹下面，可以从 docker 中启动测试
|