feat(mcp): add delivery order query tools (REQ-20260916-0020)

xiaoqu-agent-service/doc/agent-mcp-tools-reference.md

@@ -583,6 +583,38 @@
 
 ---
 
+## 20. delivery.order.list.query
+
+分页查询送货工单，对应旧系统 `POST /delivery/deliveryListByPage`。
+
+- 分类：workorder ｜ 类型：读
+- 数据来源：m2 `delivery_order`。
+- 入参：`deliveryOrderNo`、`sourceOrderNo`、`agentId`、`districtName`、`orderType`、
+  `orderState`、`sendMode`、`applyUserName`、申请/完成日期范围及 `page/rows`。
+- `orderType`：0=装机单送货，1=出库单送货；`orderState`：0=派送中，1=已完成，2=已取消；
+  `sendMode`：0=快递公司，1=自行派送。
+- 申请日期按业务字段 `apply_time` 查询，不沿用旧接口的 `create_time`；申请与完成日期可同时过滤。
+- 行级权限：总部看全部；代理身份可看申请代理或所属代理在自己、直属下级、授权代管范围内的工单，
+  以及授权代管物业和本人参与流程的工单；销售非负责人按其可见物业范围过滤。
+- 返回 `total/page/rows/records`，固定按 ID 倒序；记录同时返回状态、类型、配送方式的码值与文案。
+
+## 21. delivery.order.detail.query
+
+按 `id` 或 `deliveryOrderNo` 查询详情，两者至少传一个；同时传入时必须匹配同一条可见记录。
+
+- 行级权限与列表完全一致；不存在和无权统一返回 `NOT_FOUND_OR_FORBIDDEN`。
+- `record`：送货主单和文案字段。
+- `logistics`：物流公司/单号或派送员信息、物流状态；无物流记录时为 null。
+- `goods`：m2 `install_distribute_details` 配发物品，含物料、SN、数量、出入仓库和商城订单号。
+- `shippingFiles`：m1 `mall_logistics_pic` 发货图片。
+- `processes`：`schedule_state=2` 的流程记录及 m2 `warehouse_in_out_pic` 签收附件，按操作时间、ID 正序。
+- `relatedDocuments`：m2 `install_to_out_warehouse` 关联的出库、入库、调拨或划转单。
+- 所有附件仅返回 `id/fileName/bucket/objectKey`，不拼接公开 URL。
+
+详细设计见 `delivery-order-mcp-tools-design.md`。
+
+---
+
 ## 附录：在线查看工具清单
 
 ```bash