stock-trading AGENTS.md

交互语言要求

1. 强制使用中文：所有回答、思考过程、输出内容必须使用中文
2. 代码除外：代码本身和特殊专有名词（如类名、方法名、API 名称）使用英文
3. 展示思考过程：在回答问题时，需要展示分析和推理过程

补充强化（必须遵守）

1. 不得直接粘贴英文原始输出：包括但不限于后台 Agent、外部文档、命令行输出等；如包含英文内容，必须先用中文进行归纳/翻译后再输出。
2. 面向用户的最终输出必须中文：允许在代码块、类名/方法名/API 名称、URL、HTTP Header 等专有名词处使用英文。
3. “展示思考过程”的边界：以“结论 → 证据 → 推理 → 验证步骤 → 规避方案”的结构化方式说明；避免输出无关的内部草稿或逐字推演。

---

AGENTS.md - AI 股票交易系统开发指南

项目结构

本项目采用前后端分离架构，包含以下两个主要部分：

stock-trading/
├── backend/                        # Java Spring Boot 单体应用
│   ├── src/main/java/com/stock/
│   │   ├── config/                # 全局配置
│   │   ├── dataCollector/        # 数据采集
│   │   ├── modelService/         # AI 模型（LSTM、情感分析）
│   │   ├── strategyAnalysis/    # 策略分析
│   │   ├── tradingExecutor/     # 交易执行（含 job 调度）
│   │   ├── event/、handler/、logging/、service/
│   │   └── ...
│   └── pom.xml
│
├── frontend-v2/                    # React + Vite 前端
│   ├── src/pages/、components/、layouts/、store/、locales/
│   ├── package.json、vite.config.ts
│   └── ...
│
├── models/sentiment/               # 情感模型（TorchScript，Git LFS）
├── docs/                           # 文档（00~04 模块需求与设计）
├── .tmp/                           # 临时文件（不提交）
├── docker-compose.yml
└── pom.xml

临时文件约定：项目根目录下的 .tmp/ 用于存放所有临时文件和中间脚本。Agent 生成的一次性脚本、临时输出、中间结果等均应放在此目录，且该目录已加入 .gitignore，不纳入版本控制。

构建与运行命令

Backend (Java/Maven)

工作目录: backend/

# 启动应用 (Spring Boot)
mvn spring-boot:run

# 构建打包 (跳过测试)
mvn clean package -DskipTests

# 编译代码
mvn compile

Frontend (React/Vite)

工作目录: D:\ai-stock-trading\frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 构建生产版本
npm run build

# 代码检查 (Lint)
npm run lint

测试说明

本项目不维护自动化测试（无单元测试、集成测试）。原因与说明见 README - 关于测试。构建时使用 mvn package -DskipTests 跳过测试。

代码规范

Java (Backend)

• 版本: Java 17, Spring Boot 3.2.x
• 风格:
  • 类名 PascalCase, 方法/变量 camelCase, 常量 UPPER_SNAKE_CASE
  • 使用 Lombok (@Data, @Slf4j, @RequiredArgsConstructor) 简化代码
  • Controller 返回统一泛型对象 Response<T>
• 分包策略: 按业务领域分包 (dataCollector, modelService 等)，而非按层分包。
• 错误处理: 使用全局异常处理 (@ControllerAdvice)，禁止吞掉异常。