添加快速索引文件

integration-service/AGENTS.md

@@ -0,0 +1,28 @@
+# Integration Service 模块指引
+
+## 职责边界
+
+- 集中承载百度 OCR、Amazon Logistics/SP-API 等第三方适配器和能力启停状态。
+- 不保存业务主数据，不把第三方 DTO 泄漏为内部领域模型；真实外部调用默认关闭，密钥仅从安全配置注入。
+
+## 快速索引
+
+| 功能 | 入口 |
+|---|---|
+| 应用与配置扫描 | `src/main/java/com/baiyue/integration/IntegrationServiceApplication.java` |
+| `baiyue.integration` 配置 | `config/IntegrationProperties.java` |
+| 内部供应商状态 API | `controller/IntegrationProviderController.java` |
+| 能力状态模型与服务 | `dto/ProviderStatus.java`、`service/ProviderStatusService.java` |
+| 适配器抽象 | `provider/IntegrationProviderAdapter.java` |
+| 百度 OCR | `provider/BaiduOcrAdapter.java` |
+| Amazon | `provider/AmazonLogisticsAdapter.java` |
+| 内部服务令牌 | `security/InternalServiceTokenGuard.java` |
+| 配置测试 | `src/test/java/com/baiyue/integration/config/IntegrationPropertiesTest.java` |
+| 本地/Nacos 配置 | `src/main/resources/application.yml`、`../config/nacos/{local,cn}/integration-service.yml` |
+
+## 修改与验证
+
+- 第三方密钥、Token、请求原文和客户敏感数据不得写入源码或日志；配置应支持按供应商独立关闭。
+- 适配器负责外部协议转换、超时、错误归一化和安全降级；业务编排留在调用方服务。
+- 启用真实调用前补齐超时、重试边界、限流、幂等和可观测性，并避免在测试中访问真实供应商。
+- 从父目录运行 `mvn -pl integration-service -am test`。