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
2.6 KiB
2.6 KiB
title, tags, aliases, source
| title | tags | aliases | source | |||||||
|---|---|---|---|---|---|---|---|---|---|---|
| 开发指南 |
|
|
开发指南.md |
开发指南
快速开发模式（推荐）
如果需要频繁修改 app 或 frontend 代码，不需要每次都重新构建 Docker 镜像，可以使用本地开发模式。
详细的开发模式说明参见 快速开发模式
方式一：使用 Make 命令（推荐）
# 终端 1：启动基础设施
make dev-start
# 终端 2：启动后端
make dev-app
# 终端 3：启动前端
make dev-frontend
方式二：使用脚本命令
./scripts/dev.sh start # 启动基础设施
./scripts/dev.sh app # 启动后端
./scripts/dev.sh frontend # 启动前端
访问地址
| 服务 | 地址 |
|---|---|
| 前端开发服务器 | http://localhost:5173 |
| 后端 API | http://localhost:8080 |
| PostgreSQL | localhost:5432 |
| Redis | localhost:6379 |
| MinIO Console | http://localhost:9001 |
| Neo4j Browser | http://localhost:7474 |
使用 Air 实现后端热重载
go install github.com/air-verse/air@latest
make dev-app # 检测到 Air 时自动启用热重载
前端独立开发
cd frontend
npm run dev # 连接到 http://localhost:8080 的后端 API
生产环境部署
sh scripts/build_images.sh # 构建所有镜像
sh scripts/start_all.sh # 启动生产环境
常见问题
- 启动 dev-app 时报错连接不到数据库：确保先运行了
make dev-start - 前端 CORS 错误：检查
vite.config.ts中的代理配置 - DocReader 需要重新构建：
sh scripts/build_images.sh -d
更多排查建议参见 常见问题