# 一条命令拉起：Hub(8020) + 温度模拟器(--init-temp 31) + 空调模拟器 + 审计面板(18080)
#             + 自动预热 get_weather + 就绪检查
powershell -ExecutionPolicy Bypass -File scripts\demo_start.ps1

# 含 LLM 环节（加分项）：额外预热本地 Ollama 模型（加载权重 + 常驻显存）
powershell -ExecutionPolicy Bypass -File scripts\demo_start.ps1 -Ollama

# 断网降级模式（本地 MQTT broker + 本地 Mock 天气 API，核心功能完全不变）
powershell -ExecutionPolicy Bypass -File scripts\demo_start.ps1 -Offline -Ollama

# 彩排 / 无人值守（写 logs/*.log，不弹窗口）+ 五幕自动评分
powershell -ExecutionPolicy Bypass -File scripts\demo_start.ps1 -Offline -LogToFile
python -m scripts.demo_rehearsal --label "复现"

# 0) 环境：Python 3.12+（实测 3.14）
pip install -r requirements.txt          # 运行时依赖（版本已锁定，复现演示环境）
pip install -r requirements-dev.txt      # 开发/测试/文档辅助（含上面全部 + pytest 等）

# 1) 启动 Hub（MCP Gateway :8000，SQLite 持久化自动恢复）
python main.py

# 2) 另开两个终端，启动 IoT 模拟设备（公共 broker，免本地安装）
python -m adapters.mqtt_adapter.simulator --init-temp 31   # 温度传感器
python -m adapters.mqtt_adapter.sim_ac                     # 空调控制器

# 3) Agent 上场（三选一）
python -m agent.llm_agent --ollama   # LLM 模式·本地 Ollama：自然语言目标 → ReAct 闭环（无需 API Key）
python -m agent.llm_agent            # LLM 模式·云端：需 API Key（见下）
python -m agent.demo_agent           # 链路演示：工具发现 → 调用 → 注入/越权/限流拦截

# 4) 审计界面（浏览器打开）
python -m web.audit_dashboard      # http://127.0.0.1:18080

$env:HUB_API_TOKEN = "your-secret-token"
python main.py                # 再次启动，鉴权生效

# A. 本地 Ollama（推荐现场演示：不依赖外网，无需 API Key）
python -m agent.llm_agent --ollama --url http://127.0.0.1:8020

# B. 云端 API
set DEEPSEEK_API_KEY=sk-xxx        # 或 LLM_API_KEY / DASHSCOPE_API_KEY
set LLM_BASE_URL=https://api.deepseek.com/v1   # 可选，默认 DeepSeek
set LLM_MODEL=deepseek-chat                      # 可选

docker compose -f deploy/docker-compose.yml up -d --build
# Gateway: http://localhost:8000/mcp · EMQX UI: http://localhost:18083 (admin/uniagent)

uniagent-hub/
├── core/                  # 核心层
│   ├── unispec/           #   UniSpec v0.3.0 模型与校验
│   ├── registry/          #   工具注册中心（SQLite WAL 持久化）
│   ├── gateway/           #   MCP 网关（JSON-RPC 2.0 + Guard 横切管道）
│   ├── guard/             #   参数校验 / 注入拦截 / 三维限流 / 审计
│   ├── workflow/          #   工作流引擎（拓扑排序 + 自研安全表达式，零 eval）
│   └── cli_gen/           #   CLI 反向生成器
├── adapters/              # 适配器层（统一 discover/list_tools/call_tool 协议）
│   ├── cli_adapter/       #   CLI 工具（subprocess shell=False + 白名单，跨平台模板）
│   ├── mqtt_adapter/      #   IoT 设备（自动发现 + 状态缓存 + 写回执）
│   ├── rest_adapter/      #   REST API（OpenAPI 导入 + SSRF 防护）
│   ├── script_adapter/    #   本地脚本（路径沙箱）
│   └── database_adapter/  #   数据库（SQLite 只读查询 + 受限写，B9）
├── agent/                 # Demo Agent（LLM 可插拔 + 脚本降级）
├── web/audit_dashboard/   # 审计 Web 界面（FastAPI + 纯 HTML）
├── generated_cli/        # CLI 反向生成产物（8 个脚本）
├── scripts/              # 一键演示启动 / 预热 / 彩排评分 / Ollama 预热 / 本地 broker / Mock API
├── demo_fallback/        # 演示降级素材（预录视频位 + 应急预案）
├── deploy/                # Dockerfile.hub + docker-compose.yml
├── docs/                  # PRD / 规范 / 架构 / API 契约 / 测试报告 / 证据 / 演示脚本
├── tests/                 # 216 项测试（unit / integration / 适配器契约 / 安全）
└── main.py                # 启动入口

存在性(1001) → 权限(1003) → 限流(1004) → 参数校验/注入拦截(1002/1007) → 执行 → 审计