[REQ-20260917-0010] 移机工单 MCP 查询工具（列表+详情） (#20)

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

@@ -680,6 +680,35 @@
 
 ---
 
+## 26. relocation.order.list.query
+
+分页查询移机工单，对应旧系统 `POST /relocationOrder/pageList`。
+
+- 分类：workorder ｜ 类型：读
+- 数据来源：m2 `relocation_order`。
+- 入参：`relocationOrderNo`、`agentId`、`districtName`、`applyUserName`、
+  `maintenanceUserName`、`cooperateUserName`、`orderState`，申请/审核/调度/完成日期范围及 `page/rows`。
+- 状态：0=待提交、1=待审核、2=被驳回、3=调度中、4=作业中、5=已完成、6=已取消。
+- 日期格式为 `yyyy-MM-dd`，结束日期含当天；分页默认 1/20、上限 100，固定按 ID 倒序。
+- 行级权限：总部看全部；代理身份按本代理、授权代管代理/物业过滤；销售非负责人按自己创建及代管代理物业过滤；
+  流程参与者和 `install_order_user.type=2` 的移机/协同人员也可查看。
+
+## 27. relocation.order.detail.query
+
+按 `id` 或 `relocationOrderNo` 查询详情，两者至少传一个；同时传入时必须匹配同一条可见记录。
+
+- 行级权限与列表完全一致；不存在和无权统一返回 `NOT_FOUND_OR_FORBIDDEN`。
+- `record`：移机主单及状态文案。
+- `relocationDetails`：设备、源/目标位置、卫生间类型、执行状态和备注。
+- `maintenanceUsers/cooperateUsers`：当前移机和协同人员。
+- `processes`：`order_type=4`、`schedule_state=2` 且非抄送的流程，按操作时间、ID 正序，并附流程人员。
+- `completionCertificates`：结单流程的 `warehouse_in_out_pic` 凭证，限定
+  `in_out_allocation_type=15`，仅返回 `id/fileName/bucket/objectKey`。
+
+详细设计见 `relocation-order-mcp-tools-design.md`。
+
+---
+
 ## 附录：在线查看工具清单
 
 ```bash