Преглед изворни кода

feat:修改README.md文档,新增mac命令

yangxiaolong пре 1 месец
родитељ
комит
075c4291a3
1 измењених фајлова са 59 додато и 1 уклоњено
  1. 59 1
      README.md

+ 59 - 1
README.md

@@ -52,6 +52,29 @@ pnpm install --frozen-lockfile
 Set-Location ..
 ```
 
+macOS:
+
+```bash
+test -f backend/.env
+uv run --project backend python -c 'import sys; assert sys.version_info[:2] == (3, 12); print(sys.version)'
+nc -z 127.0.0.1 3306
+nc -z 127.0.0.1 6379
+
+cd backend
+uv run python -m zbt.commands.init_databases --root-user root
+uv run alembic -c alembic.ini --name alembic_core upgrade head
+uv run alembic -c alembic.ini --name alembic_agent upgrade head
+uv run alembic -c alembic.ini --name alembic_analytics upgrade head
+uv run python -m zbt.commands.seed
+uv run python -m zbt.commands.seed_business_data
+uv run python -m zbt.commands.build_analytics
+uv run python -m zbt.commands.verify_seed
+
+cd ../frontend
+pnpm install --frozen-lockfile
+cd ..
+```
+
 基础种子包含管理员、角色、产品、业务员和推广码;业务种子生成多状态、多时间、多人员归因的订单、支付和保单数据。
 
 ## 启动
@@ -62,6 +85,20 @@ Set-Location ..
 .\scripts\dev.ps1
 ```
 
+macOS(两个终端):
+
+```bash
+# 终端一
+cd backend
+uv run uvicorn zbt.main:app --host 127.0.0.1 --port 8000 --reload
+```
+
+```bash
+# 终端二
+cd frontend
+pnpm dev
+```
+
 - H5:http://127.0.0.1:5173
 - 管理后台:http://127.0.0.1:5174
 - API 文档:http://127.0.0.1:8000/docs
@@ -89,6 +126,13 @@ uv run python -m zbt.commands.evaluate_agents --suite smoke
 uv run python -m zbt.commands.evaluate_agents --suite full
 ```
 
+macOS:
+
+```bash
+uv run python -m zbt.commands.evaluate_agents --suite smoke
+uv run python -m zbt.commands.evaluate_agents --suite full
+```
+
 两套评测均调用真实 DeepSeek、真实业务工具和真实 HTTP 接口,并检查回答、工具覆盖和 Trace 关联;配置 LangSmith 密钥后,基准样本与自动评分会同步到 LangSmith。
 
 ## 质量门禁
@@ -97,5 +141,19 @@ uv run python -m zbt.commands.evaluate_agents --suite full
 .\scripts\test.ps1
 ```
 
-该脚本执行后端测试、Ruff、mypy、前端类型检查与双端生产构建。真实 MySQL/Redis 集成测试以及真实模型评测单独执行,避免普通代码检查意外消耗模型额度。
+macOS:
 
+```bash
+cd backend
+uv sync --locked
+uv run pytest
+uv run ruff check .
+uv run mypy src/zbt
+
+cd ../frontend
+pnpm install --frozen-lockfile
+pnpm typecheck
+pnpm build
+```
+
+该脚本执行后端测试、Ruff、mypy、前端类型检查与双端生产构建。真实 MySQL/Redis 集成测试以及真实模型评测单独执行,避免普通代码检查意外消耗模型额度。