build: establish unified project entry

This commit is contained in:
QiuSW
2026-08-03 18:55:32 +08:00
parent 637c341b95
commit 4f4a95a55e
6 changed files with 276 additions and 181 deletions
+71 -52
View File
@@ -1,69 +1,88 @@
#!/usr/bin/env bash
# cmbuyer 标准启动与验证入口(Unix shell 版),与 init.ps1 等价,二选一。
#
# 注意:本项目的构建与验证工具链只在 Windows 侧(Go SDK、Python 环境、Android SDK)。
# 在 WSL 中运行本脚本通常会因缺少工具链而失败——这是预期行为,不是 bug。
# 正式验证请在 Windows PowerShell 运行 ./init.ps1。
# 双产品目录为 admin/(采购服务,Go)与 client/(采购工具,Python);分别以 go.mod 与
# requirements.txt 作为初始化哨兵,不能只按空目录存在判断。
#
# T-001 / T-002 / T-003 落地后补全命令,并同步:
# docs/03-tech-stack.md、docs/00-ai-start-here.md、docs/current-state.md
# cmbuyer Unix shell 统一安装、验证与启动入口。
# 本脚本与 init.ps1 保持同一门禁语义;在 WSL 缺少 Windows 侧工具链时必须明确失败,
# 不得将跳过或 bash 语法通过误报为 Windows 产品验收。
set -euo pipefail
cd "$(dirname "$0")"
export GOTOOLCHAIN=local
pending=()
fail() {
echo "错误:$*" >&2
exit 1
}
require_directory() {
local path="$1"
local name="$2"
[[ -d "$path" ]] || fail "$name 目录不存在:$path。请先完成对应初始化任务。"
}
require_file() {
local path="$1"
local name="$2"
[[ -f "$path" ]] || fail "$name 不存在:$path。请先完成对应初始化任务。"
}
require_command() {
local name="$1"
local hint="$2"
command -v "$name" >/dev/null 2>&1 || fail "缺少 $name。$hint"
}
run_step() {
local description="$1"
shift
echo "==> $description"
"$@" || fail "$description 失败。"
}
confirm_python311_or_newer() {
local executable="$1"
local context="$2"
"$executable" -c 'import sys; raise SystemExit(0 if sys.version_info >= (3, 11) else 1)' \
|| fail "$context 必须使用 Python 3.11+。不会自动覆盖既有虚拟环境;请手工删除 client/.venv 后重试。"
}
echo "==> 当前目录: $(pwd)"
require_directory admin "采购服务 admin"
require_file admin/go.mod "采购服务哨兵 admin/go.mod"
require_directory client "采购工具 client"
require_file client/requirements.txt "采购工具哨兵 client/requirements.txt"
require_file client/pyproject.toml "采购工具打包配置 client/pyproject.toml"
require_command go "请安装 Go 1.23+ 后重试。"
# ------------------------------------------------------- 采购服务(admin/,Go)
if [ -f admin/go.mod ]; then
echo "==> 采购服务:admin/ 同步依赖"
( cd admin && go mod download )
echo "==> 采购服务:admin/ 静态检查"
( cd admin && go vet ./... )
echo "==> 采购服务:admin/ 测试"
( cd admin && go test ./... )
client_python="client/.venv/bin/python"
if [[ -e client/.venv ]]; then
[[ -d client/.venv ]] || fail "client/.venv 不是目录。不会覆盖该路径,请人工处理后重试。"
require_file "$client_python" "既有 client/.venv Python"
confirm_python311_or_newer "$client_python" "既有 client/.venv"
else
echo "==> 采购服务:admin/go.mod 不存在,跳过。先做 T-001(初始化 admin/ Go 骨架)。"
pending+=("T-001 初始化采购服务 admin/ Go 骨架")
require_command python3 "请安装 Python 3.11+ 后重试。"
confirm_python311_or_newer python3 "python3"
run_step "创建 Python 3.11+ 采购工具虚拟环境" python3 -m venv client/.venv
require_file "$client_python" "新建 client/.venv Python"
confirm_python311_or_newer "$client_python" "新建 client/.venv"
fi
# ---------------------------------------------------- 采购工具(client/,Python)
if [ -f client/requirements.txt ]; then
echo "==> 采购工具:client/ 同步依赖"
( cd client \
&& { [ -d .venv ] || python3 -m venv .venv; } \
&& .venv/bin/python -m pip install -q -r requirements.txt )
echo "==> 采购工具:client/ 语法检查"
( cd client && .venv/bin/python -m compileall -q src tests )
echo "==> 采购工具:client/ 测试"
( cd client && .venv/bin/python -m unittest discover -s tests -t . )
else
echo "==> 采购工具:client/requirements.txt 不存在,跳过。先做 T-002(初始化 client/ Python 骨架)。"
pending+=("T-002 初始化采购工具 client/ Python 骨架")
fi
run_step "验证采购工具虚拟环境 Python" "$client_python" -c 'import sys; print(sys.version); raise SystemExit(0 if sys.version_info >= (3, 11) else 1)'
# ------------------------------------------------------------------ 文档自检
echo "==> 校验 agent 上下文清单"
python3 scripts/validate_agent_context.py
( cd admin && run_step "采购服务:admin/ 同步依赖" go mod download )
( cd admin && run_step "采购服务:admin/ 测试" go test ./... )
( cd admin && run_step "采购服务:admin/ 静态检查" go vet ./... )
( cd admin && run_step "采购服务:admin/ 构建" go build ./... )
( cd client && run_step "采购工具:以 editable 方式安装" .venv/bin/python -m pip install -e . )
( cd client && run_step "采购工具:验证已安装包" .venv/bin/python -c 'import cmbuyer_client; print(cmbuyer_client.__version__)' )
( cd client && run_step "采购工具:测试" .venv/bin/python -m unittest discover -s tests -t . )
( cd client && run_step "采购工具:语法检查" .venv/bin/python -m compileall -q src tests scripts )
run_step "校验 agent 上下文清单" "$client_python" scripts/validate_agent_context.py
# -------------------------------------------------------------------- 汇总
echo
if [ ${#pending[@]} -gt 0 ]; then
echo "==> 尚未初始化的部分:"
for item in "${pending[@]}"; do echo " - $item"; done
echo
echo "当前仓库只有文档。按 docs/06-tasks.md 领取上述任务后再运行本脚本。"
exit 3
fi
echo "==> 启动命令"
echo " 采购服务:cd admin && go run ./cmd/server"
echo " 采购工具:cd client && .venv/bin/python src/main.py"
echo "==> 基线验证通过。启动命令:"
echo " 采购服务:cd admin && go run ./cmd/server"
echo " 采购工具:cd client && .venv/bin/python -m cmbuyer_client"
echo
echo "基础验证失败时先修基线,不要在坏的起点上继续叠新功能。"
echo "真机连接与设备验收只能由人工完成,agent 不得据此把任务标为 DONE。"
echo "WSL / Unix shell 仅在本机工具链齐备时能通过;这不构成 Windows 或真机验收。"