# PA_Agent 本地快照笔记（Market 工作区）

- **源**: https://github.com/rosemarycox5334-debug/PA_Agent
- **本地**: `E:\market\tools\upstream\PA_Agent`
- **Commit**: `d4952c589cd5380a02eeaf51e4d251d9fd55e1ee`（2026-07-18, shallow clone）
- **规模**: ~11MB · 282 `.py` · AGPL-3.0
- **状态（2026-07-19）**: E 盘 venv 已装 · 8765 已挂桥接页 · **不交易** · 实盘锁保持

## 安装

```text
venv: E:\market\tools\upstream\PA_Agent\.venv
pip:  pip install -e .  （缓存 E:\tmp\pip-cache）
冒烟: import pa_agent + PyQt6 + route_strategy_files OK
启动桌面: start_market_gui.bat  或  .venv\Scripts\python.exe -m pa_agent.main
```

## Market OS 入口（8765）

| 入口 | 说明 |
|------|------|
| http://127.0.0.1:8765/#pa-agent | 主站侧栏嵌入 |
| http://127.0.0.1:8765/pa-agent/ | 独立页 |
| GET `/api/pa-agent` | 安装/GUI/路径状态 |
| GET `/api/pa-agent/route?cycle_position=…&direction=…&patterns=h2,wedge` | 纯函数路由 demo |
| GET `/api/pa-agent/prompts` | prompt 文件列表 |
| GET `/api/pa-agent/notes` | 本笔记 |
| POST `/api/pa-agent/launch` | 启动桌面 PyQt6 GUI |

桥接实现：`E:\Empire\trading\dashboard\pa_agent_bridge.py`  
看板：`E:\market\apps\pa-agent\index.html`

**门禁**：`may_trigger_trade=false` · `live_execution_locked=true` · 阶段 `sim_live`  
**不**把 LLM 两阶段分析结果自动写入 sim 买单（需另做人工/策略评审）。

## 入口（源码）

| 路径 | 作用 |
|------|------|
| `pa_agent/main.py` | PyQt6 启动 |
| `run.py` / `start_pa_agent.bat` / `start_market_gui.bat` | 便捷启动 |
| `pa_agent/orchestrator/two_stage.py` | 诊断→决策主编排 |
| `pa_agent/ai/router.py` | `route_strategy_files` 纯函数路由 |
| `prompt_engineering/*.txt` | Brooks 风格 PA 策略知识库 |
| `config/settings.example.json` | 配置样例（首次桌面设置 API Key） |

## 路由冒烟

```
tight_channel + bullish + [h2,wedge] → 6 files
spike + bearish + [mtr]             → 4 files
trading_range + [barbwire]          → 3 files
extreme_tr / unknown                → 0 files（不下单）
```

## 边界

- GUI 完整分析在桌面；8765 做状态/路由/一键启动
- AGPL-3.0：对外分发改动版需开源对应代码
- 数据源 UI 主推 MT5/TV；A 股源代码有、界面默认隐藏