hy-app-monitor/localbox/AGENTS.md

AGENTS Rules

localbox部署 只负责本地部署和本地联调。chatapp3 的线上部署已经迁移到 hy-app-monitor。

仓库结构

• 仓库根目录保留统一入口 ./deploy.sh
• 本地脚本和 compose 文件都放在仓库根目录
• local-infra/ 只存放本地 MySQL / RocketMQ 初始化文件
• .env.local 放在仓库根目录
• var/ 只存放本地缓存和构建产物，不提交到仓库
• 默认自动识别 ../../chatapp3/chatapp3-java 和 ../../chatapp3/chatapp3-golang；路径不同再用环境变量覆盖

必须遵守

• 只使用仓库根目录 ./deploy.sh 作为推荐入口
• 本地构建依赖 chatapp3-java 和 chatapp3-golang sibling 仓库
• Java 私有 Maven 包只来自 chatapp3-java/maven_private
• 所有新增能力都必须服务于本地启动、本地构建、本地检查、本地重启或本地 Nacos 配置发布

禁止

• 禁止重新引入 gitea/、tencent-prod/、Jenkins、发布控制台、Harbor、远程部署、回滚、云侧同步相关代码
• 禁止重新引入 .env.prod、发布编排、线上 Nacos 发布、TAT、COS 等链路
• 禁止新增与本地部署无关的目录、脚本或入口