chenxin
9dafb8fe72
- proto（engine/proto/liushen/v1）：LingtaiEngine 九方法——GetEngineInfo（版本协商/能力位）、TransformMarkdown、RebuildExport（UNIMPLEMENTED 明示随 WP-03）、OpenStream 双向流、CheckBudget、RerankRecall、EvaluatePolicy、ValidateUrl、CheckStateTransition；RunStatus 枚举与契约一致 - 服务端参考实现（engine/server/lingtai_server.py）：进程内直链 nanobind 引擎核心——双形态同核同 golden；开发档 127.0.0.1 明文（生产 mTLS，文案明示）；状态转换表按 agent-runtime 第 3 节 - 集成测试 6 项：进程内随机端口起服——版本协商、双形态 golden（服务输出==进程内引擎输出，ADR-017 核心不变量首次实证）、双向流 envelope 序号单调、决策表/URL/状态机、RebuildExport UNIMPLEMENTED 明确拒绝（不伪造） - Makefile：lingtai-proto（stub 再生）与 lingtai-server（启动服务）目标 - 注：C++ 原生二进制（hunjing-lingtai-server）随交叉编译矩阵交付；Python 参考实现保证 proto 与语义先行锁定 - 测试 102 项全绿（+6）；ruff/mypy 干净
107 lines
3.7 KiB
Makefile
107 lines
3.7 KiB
Makefile
# 默认目标：显示帮助
|
||
.DEFAULT_GOAL := help
|
||
|
||
# ===== 后端（Python / FastAPI，uv 管理） =====
|
||
|
||
.PHONY: backend-setup
|
||
backend-setup: ## 安装后端依赖（uv sync）
|
||
cd backend && uv sync
|
||
|
||
.PHONY: backend-dev
|
||
backend-dev: ## 启动后端开发服务（127.0.0.1:8000）
|
||
cd backend && uv run uvicorn app.main:app --reload --host 127.0.0.1 --port 8000
|
||
|
||
.PHONY: backend-test
|
||
backend-test: ## 运行后端测试（pytest）
|
||
cd backend && uv run pytest
|
||
|
||
.PHONY: backend-lint
|
||
backend-lint: ## 后端静态检查（ruff + mypy）
|
||
cd backend && uv run ruff check . && uv run mypy app
|
||
|
||
# ===== 灵台引擎（C++23 / CMake） =====
|
||
|
||
.PHONY: engine-build
|
||
engine-build: ## 构建灵台引擎（CMake + Ninja/Makefile）
|
||
cmake -S engine -B engine/build -DCMAKE_BUILD_TYPE=Release && cmake --build engine/build
|
||
|
||
.PHONY: engine-test
|
||
engine-test: ## 运行灵台引擎测试（ctest）
|
||
cmake -S engine -B engine/build -DCMAKE_BUILD_TYPE=Debug && cmake --build engine/build && ctest --test-dir engine/build --output-on-failure
|
||
|
||
# ===== 数据库（PostgreSQL 统一，ADR-024） =====
|
||
|
||
.PHONY: docker-up
|
||
docker-up: ## 启动本地 PostgreSQL（docker compose）
|
||
docker compose -f docker/docker-compose.yml up -d
|
||
|
||
.PHONY: docker-down
|
||
docker-down: ## 停止本地 PostgreSQL
|
||
docker compose -f docker/docker-compose.yml down
|
||
|
||
.PHONY: backend-migrate
|
||
backend-migrate: ## 执行数据库迁移（Alembic upgrade head）
|
||
cd backend && uv run alembic upgrade head
|
||
|
||
# ===== 契约（OpenAPI 3.1 单一真源） =====
|
||
|
||
.PHONY: openapi-lint
|
||
openapi-lint: ## 校验 OpenAPI 契约（redocly lint + bundle）
|
||
npx --yes @redocly/cli@latest lint openapi/openapi.yaml --config openapi/redocly.yaml && npx --yes @redocly/cli@latest bundle openapi/openapi.yaml -o openapi/bundled.json
|
||
|
||
.PHONY: generate
|
||
generate: openapi-lint ## 生成代码（TypeScript 类型等）
|
||
cd frontend && npm run generate:api
|
||
|
||
# ===== 灵台引擎 gRPC 服务（ADR-017 双形态） =====
|
||
|
||
.PHONY: lingtai-proto
|
||
lingtai-proto: ## 重新生成 gRPC stub（proto 变更后执行）
|
||
cd backend && uv run python -m grpc_tools.protoc -I../engine/proto \
|
||
--python_out=../engine/server/generated \
|
||
--grpc_python_out=../engine/server/generated \
|
||
liushen/v1/liushen.proto
|
||
|
||
.PHONY: lingtai-server
|
||
lingtai-server: ## 启动灵台引擎独立服务（开发档 127.0.0.1:50051；生产须 mTLS）
|
||
cd backend && uv run python ../engine/server/lingtai_server.py
|
||
|
||
# ===== 前端与桌面（Next.js / Tauri v2） =====
|
||
|
||
.PHONY: frontend-setup
|
||
frontend-setup: ## 安装前端依赖
|
||
cd frontend && npm install
|
||
|
||
.PHONY: frontend-dev
|
||
frontend-dev: ## 启动前端开发服务（127.0.0.1:3000）
|
||
cd frontend && npm run dev
|
||
|
||
# ===== 自托管与备份（WP-14） =====
|
||
|
||
.PHONY: selfhost-up
|
||
selfhost-up: ## 启动自托管档（API + PostgreSQL，docker compose）
|
||
docker compose -f docker/docker-compose.app.yml up -d --build
|
||
|
||
.PHONY: selfhost-down
|
||
selfhost-down: ## 停止自托管档
|
||
docker compose -f docker/docker-compose.app.yml down
|
||
|
||
.PHONY: db-dump
|
||
db-dump: ## 备份数据库到 backups/hunjing-<时间戳>.sql.gz
|
||
@mkdir -p backups
|
||
@docker exec hunjing-postgres pg_dump -U hunjing -d hunjing | gzip > backups/hunjing-$$(date +%Y%m%d-%H%M%S).sql.gz
|
||
@echo "备份完成：backups/"
|
||
|
||
.PHONY: db-restore
|
||
db-restore: ## 从最新备份恢复（DB=备份文件路径，make db-restore FILE=backups/xxx.sql.gz）
|
||
@gzip -dc $(FILE) | docker exec -i hunjing-postgres psql -U hunjing -d hunjing
|
||
@echo "恢复完成"
|
||
|
||
# ===== 帮助 =====
|
||
|
||
.PHONY: help
|
||
help: ## 显示本帮助
|
||
@echo "Hunjing 统一命令入口（详见各目标 ## 说明）"
|
||
@echo
|
||
@grep -E '^[a-zA-Z_-]+:.*?## ' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf " \033[36m%-16s\033[0m %s\n", $$1, $$2}'
|