LightBot: Instructions file for Codex

LightBot - AI Coding Guide

轻量级 Java AI Agent 平台

Tech Stack: SpringBoot + SpringAI + Vue3

---

项目原则

原则	说明
模块化	每个功能域独立模块，边界清晰，可独立演进
AI Native	架构围绕 AI 能力设计，而非传统 CRUD 套壳
Java First	后端统一 Java，不混入 Python / Node
渐进式演进	先单体后拆分，先简单后复杂，不提前设计
低耦合	模块间通过接口通信，禁止直接依赖实现类

---

架构原则

禁止事项

❌ 禁止跨模块直接调用 Service
❌ 禁止 Controller 写业务逻辑
❌ 禁止循环依赖
❌ 禁止硬编码 Prompt
❌ 禁止直接依赖 OpenAI SDK / DashScope SDK
❌ 禁止在业务代码中直接 new RestTemplate 调用模型
❌ 禁止使用拼接SQL语句操作数据库（必须使用 MyBatis-Plus）
❌ 禁止在 Service 中直接操作中间件客户端（必须通过 Util 类）
❌ 禁止 lightbot-server 新增业务 Service、DTO/VO、tool/builtin、service/chat、workflow/*Executor*

必须遵守

✅ 所有模型调用必须通过统一 AI Framework（SpringAI）
✅ 跨模块调用通过 Service 接口；跨域聚合使用 Port 模式（如 Dashboard）；禁止 import ...service.impl.*
✅ 所有 Prompt 必须模板化，存储于配置或数据库
✅ 所有外部依赖通过依赖注入，禁止静态方法调用
✅ 所有数据库操作必须使用 MyBatis-Plus（LambdaQueryWrapper / ServiceImpl）
✅ 所有中间件操作（MinIO/Redis/MQ等）必须封装为 Util 类
✅ 业务核心逻辑必须有注释说明意图

模块结构

架构边界详见 docs/architecture/module-boundaries.md

lightbot/
├── lightbot-common/           # Result、枚举、公共类型
├── lightbot-framework/        # Spring 配置、Redis/MinIO 等中间件 Util
├── lightbot-platform/         # 用户、任务、系统配置、API Key、Dashboard、日志
├── lightbot-ai/               # 模型工厂、Prompt、LLM Trace
├── lightbot-knowledge/        # RAG、文档、图谱、评测
├── lightbot-tool/             # Tool / MCP / Skill / SubAgent 定义与注册
├── lightbot-workflow/         # Workflow DSL、节点处理器、图校验
├── lightbot-agent/            # Agent 运行时（Chat、Workflow 执行、SubAgent）
├── lightbot-server/           # HTTP 入口（Controller、Config、拦截器）
└── lightbot-ui/               # Vue3 前端（独立目录，非 Maven 模块）

依赖规则

common ← framework ← platform ← ai ← knowledge ← tool ← workflow ← agent ← server

lightbot-server    → platform, ai, knowledge, tool, workflow, agent
lightbot-agent     → platform, workflow, knowledge
lightbot-workflow  → tool
lightbot-tool      → knowledge
lightbot-knowledge → ai
lightbot-ai        → framework, platform
lightbot-platform  → framework
lightbot-framework → common