yawan
f7fc992f57
Anydoc / anydoc parser engine (push) Canceled after 0s
App / Format, vet, test, and build (push) Canceled after 0s
CLI / test (macos-latest / go 1.26) (push) Canceled after 0s
CLI / test (ubuntu-latest / go 1.26) (push) Canceled after 0s
CLI / test (windows-latest / go 1.26) (push) Canceled after 0s
Build and Push Docker Image / build-ui (push) Canceled after 0s
Build and Push Docker Image / build-docreader (push) Canceled after 0s
Build and Push Docker Image / build-sandbox (push) Canceled after 0s
Build and Push Docker Image / build-app (amd64, linux/amd64, ubuntu-latest) (push) Canceled after 0s
Build and Push Docker Image / build-app (arm64, linux/arm64, ubuntu-24.04-arm) (push) Canceled after 0s
DocReader / Python tests and Go client tests (push) Canceled after 0s
Build & Publish (dsh-weknora) / Typecheck, test, pack (push) Canceled after 0s
Build & Publish (dsh-weknora) / End-to-end inside dsh (pinned) (push) Canceled after 0s
Build & Publish (dsh-weknora) / End-to-end inside dsh (latest, advisory) (push) Canceled after 0s
Frontend / Test, type-check, and build (push) Canceled after 0s
Go Lint Cache / warm lint cache (.) (push) Canceled after 0s
Go Lint Cache / warm lint cache (cli) (push) Canceled after 0s
Go Lint Cache / warm lint cache (client) (push) Canceled after 0s
Build & Publish (mcp-server) / Test (Python 3.10) (push) Canceled after 0s
Build & Publish (mcp-server) / Test (Python 3.11) (push) Canceled after 0s
Build & Publish (mcp-server) / Test (Python 3.12) (push) Canceled after 0s
Build & Publish (mcp-server) / Test (Python 3.13) (push) Canceled after 0s
Build and Push Docker Image / merge (push) Canceled after 0s
Build & Publish (dsh-weknora) / Publish to npm (push) Canceled after 0s
Build & Publish (mcp-server) / Build sdist + wheel (push) Canceled after 0s
Build & Publish (mcp-server) / Publish to PyPI (push) Canceled after 0s
85 lines
2.1 KiB
Markdown
85 lines
2.1 KiB
Markdown
---
|
|
title: 快速开发模式
|
|
tags: [开发部署, 开发, 热更新, Air]
|
|
aliases: [快速开发, QuickDev, dev模式]
|
|
source: 快速开发模式说明.md
|
|
---
|
|
|
|
# 快速开发模式
|
|
|
|
解决开发流程中，每次修改 `app`（后端）或 `frontend`（前端）代码后，都需要打包 Docker 镜像的问题，实现这两个模块的热更新。
|
|
|
|
> 本页是 [开发指南](../开发部署/开发指南.md) 的补充，提供更详细的架构说明
|
|
|
|
## 使用方法
|
|
|
|
### 方式 1：Make 命令（推荐）
|
|
|
|
```bash
|
|
make dev-start # 终端 1：启动基础设施
|
|
make dev-app # 终端 2：启动后端
|
|
make dev-frontend # 终端 3：启动前端
|
|
```
|
|
|
|
### 方式 2：开发脚本
|
|
|
|
```bash
|
|
./scripts/dev.sh start # 终端 1
|
|
./scripts/dev.sh app # 终端 2
|
|
./scripts/dev.sh frontend # 终端 3
|
|
```
|
|
|
|
### 方式 3：一键启动
|
|
|
|
```bash
|
|
./scripts/quick-dev.sh
|
|
```
|
|
|
|
### 使用 Air 实现后端热重载
|
|
|
|
```bash
|
|
go install github.com/air-verse/air@latest
|
|
make dev-app # 自动检测 Air 并使用
|
|
```
|
|
|
|
## 架构对比
|
|
|
|
### 开发模式
|
|
|
|
```
|
|
本地后端 App (:8080) ← 本地前端 UI (:5173) → Docker 基础设施容器
|
|
(PostgreSQL/Redis/MinIO/Neo4j/DocReader)
|
|
```
|
|
|
|
- 后端/前端在本地直接运行，修改后秒级生效
|
|
- 基础设施仍使用 Docker 容器
|
|
|
|
### 生产模式
|
|
|
|
```
|
|
容器后端 App (:8080) ← 容器前端 UI (:80) → 基础设施容器
|
|
```
|
|
|
|
- 所有服务均运行在 Docker 容器中
|
|
- 每次修改需要重新构建镜像
|
|
|
|
## 效率对比
|
|
|
|
| 方式 | 每次修改耗时 |
|
|
|------|------------|
|
|
| 旧方式（重建镜像） | 2-5 分钟 |
|
|
| 新方式（本地开发） | 后端 5-10 秒，前端实时热重载 |
|
|
|
|
## 相关主题
|
|
|
|
- [开发指南](../开发部署/开发指南.md) — 完整的开发环境搭建指南
|
|
- [常见问题](../运维排障/常见问题.md) — 开发模式相关问题排查
|
|
|
|
---
|
|
|
|
## 反向链接
|
|
|
|
- [Home](../Home.md) — Wiki 首页导航
|
|
- [开发指南](../开发部署/开发指南.md) — 完整开发指南（本页的补充说明）
|
|
- [常见问题](../运维排障/常见问题.md) — 开发模式相关故障排查
|