# MCP 排舱单号字段文案统一设计 ## 背景 `query_order_exact` 使用 `outbound_number` 和 `outbound_numbers` 查询 `fms_outbound.outbound_number`。当前工具说明将该字段称为“出库单号”,但业务页面 使用的准确名称是“排舱单号”,容易使 AI 和员工误解字段含义。 ## 目标 - 对外说明统一使用“排舱单号”。 - 明确该字段不是海外仓出库单号,减少号码类型误判。 - 保持现有接口和查询行为不变。 ## 方案 保留 `outbound_number` 和 `outbound_numbers` 字段名,因为它们已经与数据库字段、 Python Gateway、PHP 校验及查询逻辑对齐。仅修改以下文案和回归断言: 1. `outbound_number` 说明改为单个排舱单号精准查询,并提示不是海外仓出库单号。 2. `outbound_numbers` 说明改为多个排舱单号批量精准查询。 3. 工具总说明中的“出库单号”改为“排舱单号”。 4. 工具元数据测试断言同步改为“排舱单号”,并验证区分海外仓出库单号的提示。 5. 项目文档记录本次业务术语修正。 ## 不在范围内 - 不修改数据库字段名。 - 不修改 MCP 入参或返回字段名。 - 不修改 PHP 查询、校验和权限逻辑。 - 不把 `outbound_date_start`、`outbound_date_end` 的“出库日期”改为“排舱日期”; 日期字段与本次单号术语修正不是同一业务概念。 ## 验证 - 运行 `tests.test_query_order_exact_tool`,确认工具元数据文案正确。 - 运行 Python Gateway 全量单元测试,确认字段结构和调用行为无回归。 - 搜索 `query_order_exact` 相关说明,确认不再将 `outbound_number(s)` 标注为 “出库单号”。