鍩轰簬鐪熷疄 PoE2 鏁版嵁婧愮殑鏅鸿兘鏋勭瓚鎺ㄨ崘涓庨獙璇佺郴缁燂細闆嗘垚 PoE2Scout銆乸oe.ninja銆丳oB2銆丳oE2DB 鍥涘ぇ鏁版嵁婧愶紝缁撳悎 RAG 寮哄寲涓庡灞傜紦瀛橈紝鎻愪緵鍙鐜般€佸彲瀹¤鐨勬瀯绛戠敓鎴愪笌璇勪及娴佺▼銆?
- 鍥涙簮鏁版嵁鏁村悎锛歱oe2scout锛堝競鍦?浠锋牸锛夈€乸oe.ninja锛堟祦琛屾瀯绛?瓒嬪娍锛夈€丳oB2锛堢簿纭绠楋級銆丳oE2DB锛堝畬鏁存父鎴忔暟鎹級銆?
- RAG 澧炲己锛氫互鍥涙簮蹇収涓烘绱㈣鏂欙紝鏀寔鍙拷婧洖绛斾笌鏋勭瓚瑙ｉ噴銆?
- 澶氬眰缂撳瓨锛歚data_storage/` 涓嬫湰鍦扮紦瀛樹笌蹇収锛屼究浜庣绾垮鐜颁笌娴嬭瘯銆?
- GUI 涓?CLI锛氭彁渚涙闈?GUI 涓庡懡浠よ涓ょ鍏ュ彛锛屽紑鍙?楠岃瘉鍙嬪ソ銆?
- 瀹夎渚濊禆
pip install -r dependencies/requirements.txt
# 濡傞渶 GUI锛?
pip install -r dependencies/requirements-gui.txt- 杩愯 orchestrator CLI
python core_ai_engine/poe2_ai_orchestrator.py --help- 涓€閿噰闆嗭紙绀轰緥锛?
python scripts_and_tools/harvest_full.py --league "Rise of the Abyssal" --max-builds 500- 瀹¤涓庢祴璇?
python scripts_and_tools/audit_completeness.py
pytest -q tests_and_validationcore_ai_engine/src/poe2build/ # 鏍稿績閫昏緫锛歝ore/ orchestrator銆乨ata_sources/銆乺ag/
gui_apps/ # GUI 搴旂敤涓庡惎鍔ㄥ櫒
scripts_and_tools/ # 閲囬泦涓庡璁¤剼鏈?
data_storage/ # 缂撳瓨銆佹棩蹇椼€佸揩鐓э紙鑷姩鐢熸垚锛屽彲瀹夊叏娓呯悊锛?
tests_and_validation/ # 鍗曞厓/闆嗘垚/鎬ц兘娴嬭瘯涓庡す鍏?
dependencies/ # 渚濊禆娓呭崟锛坮equirements*.txt锛?
config_files/ # 閰嶇疆涓?.env.example
docs_and_guides/ # 鏂囨。锛堣 CRAWLING_AND_REV_PLAN.md锛?```
## 鏂囨。瀵艰埅
- 鍚庣鏁版嵁鎻愬彇涓?NLG 娴佺▼锛堝惈浼唬鐮佷笌鍛戒护锛夛細`docs_and_guides/BACKEND_DATA_AND_NLG_PIPELINE_CN.md`
## 甯歌闂锛圧EADME 涔辩爜/鏄剧ず寮傚父锛?
- 鏈粨搴撴墍鏈?README/鏂囨。鍧囦负 UTF鈥? 缂栫爜锛涜嫢鍦?Windows 缁堢鏄剧ず涓轰贡鐮侊細
- 浣跨敤 VS Code 鎵撳紑骞跺湪鐘舵€佹爮閫夋嫨鈥淯TF鈥?鈥濈紪鐮侊紱
- 鎴栧湪 PowerShell 涓存椂鍒囨崲缂栫爜锛?
- `chcp 65001`
- `[Console]::OutputEncoding = [System.Text.Encoding]::UTF8`
- `Get-Content -Encoding utf8 README.md | more`
- 寤鸿浣跨敤 Windows Terminal + PowerShell 7锛堥粯璁?UTF鈥?锛夈€?
## 璐＄尞涓庤鑼?
- 浠ｇ爜椋庢牸锛欱lack + isort + flake8锛? 绌烘牸缂╄繘锛孭ublic API 鎻愪緵绫诲瀷娉ㄨВ銆?
- 鎻愪氦淇℃伅锛氭帹鑽?Conventional锛堝 `feat:`, `fix:`, `docs:`锛夛紝淇濇寔鏈€灏忎笖鑱氱劍銆?
- PR 鍓嶈杩愯锛歚pre-commit run -a` 涓庡畬鏁存祴璇曪紱鏁版嵁婧愯涓哄彉鏇撮渶鏇存柊 `docs_and_guides/CRAWLING_AND_REV_PLAN.md` 骞堕€氳繃 `audit_completeness.py`銆?
## 璁稿彲璇?
MIT锛岃瑙?[LICENSE](LICENSE)銆?
## 清理项目
- Windows PowerShell（默认会清空 data_storage/）：
- `pwsh scripts_and_tools/scripts/cleanup_workspace.ps1`
- 跨平台 Python 脚本：
- `python scripts_and_tools/cleanup_workspace.py`
## 容器运行（Docker Compose）
- 启动服务：
```bash
docker compose up --build -d
-
访问 WebUI：在浏览器打开
http://localhost:7860 -
一次性运行 CLI（健康检查与示例生成）：
# 健康检查
docker compose run --rm cli --health
# 快速生成示例（Ranger 清图，预算 15，数量 3）
docker compose run --rm cli --class ranger --goal clear_speed --budget 15 -n 3
# 非交互演示（容器/CI 下避免等待按键）
docker compose run --rm cli --demo --demo-no-prompt- 服务状态与日志：
docker compose ps
docker compose logs --tail=120提示：compose.yaml 将整个 core_ai_engine/ 目录挂载到容器内，修改该目录下的 Python 代码后，重新运行 docker compose run 即可生效，无需 docker compose build。只有当依赖清单或基础镜像变更时才需要重建镜像。