- 启动后端 uvicorn(:8000, --reload, 0.0.0.0) + 前端 next dev(:3000),setsid 独立进程组 - 停止按 pidfile + 监听端口双定位,整进程组清理(无子进程残留,实测残留 0) - 端口探测 ss 优先(lsof 在该环境对 socket 不可靠) - status/logs/restart;支持 API_PORT/WEB_PORT/BACKEND_API_URL 覆盖 - 日志落 logs/,pid 落 .run/(均已 gitignore);USAGE §5 增加用法
- pyqlib(0.9.8.dev32 源码安装)验证:import / 数据落盘 / storage 底层读回 / Alpha158 / LGBModel 均通过(scripts/qlib_verify.py 可重复) - 记录格式要点:小写 instrument、instruments 3 列、provider_uri 需 {'day': path} 字典 - 如实记录未打通项:D.features→训练→回测高层链路仍待 QlibEngine 实现(建议按官方 dump 规则落盘) - 项目回归保持 81 passed / ruff clean
- AGENT.md / docs/ARCHITECTURE.md 约束与架构文档入库(README 覆盖远端模板) - 根级配置:.gitignore / .env.example / config.yaml(密钥只走 .env,不入库) - 目录占位:data(parquet/qlib/raw/normalized) / experiments / docker / frontend/web / scripts