🎉 feat: 建立阶段 0 工程骨架与 OpenAPI 契约机器化（WP-01 起步）

- Makefile：统一命令入口（backend/engine/docker/openapi/generate，含 make help）
- backend：FastAPI + uv 最小工程，统一错误体（契约第 7 节）、ADR-015 平台 ID 生成与校验（uuid-utils）；pytest 7 项、ruff、mypy strict、启动冒烟全部通过
- engine：灵台引擎 C++23/CMake 骨架，按 Lingtai C ABI 契约实现 lingtai.h（13 个 HjStatus、版本协商、句柄表防二次释放、线程局部错误上下文）；doctest 5 用例通过，nm 验证仅导出 hj_* 符号
- openapi：OpenAPI 3.1 单一真源初始版（错误体/分页/Money/首批平台 ID/ContentBlock 全 21 类型/流事件 envelope），Redocly lint 0 错误、bundle 通过
- frontend：Next.js 最小骨架，openapi-typescript 生成 API 类型并通过 strict tsc
- docker：hunjing-postgres（pgvector:17）compose；.env.example 与 config 示例
- ADR-025：登记测试与契约工具链（doctest/libFuzzer/Redocly/openapi-typescript/uuid-utils）
- desktop：Tauri v2 占位与初始化说明（WP-10 启动）

Makefile

@@ -0,0 +1,72 @@
+# 默认目标：显示帮助
+.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
+
+# ===== 前端与桌面（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
+
+# ===== 帮助 =====
+
+.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}'