[REQ-20260918-0004] 撤机工单 MCP 查询工具（列表+详情） (#21)

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

@@ -707,6 +707,34 @@
 
 详细设计见 `relocation-order-mcp-tools-design.md`。
 
+## 28. withdraw.order.list.query
+
+分页查询撤机工单，对应旧系统 `POST /withdrawOrder/pageList`。
+
+- 分类：workorder ｜ 类型：读
+- 数据来源：m2 `withdraw_order`。
+- 入参：`type`、`orderState`、`withdrawOrderNo`、`pickupOrderNo`、`agentId`、`districtName`、
+  `applyUserName`、`maintenanceUserName`、`cooperateUserName`，申请/审核/调度/取货/完成日期范围及 `page/rows`。
+- 类型：0=部分撤机、1=全部撤机；状态：0=待审核、1=被驳回、2=调度中、3=作业中、4=待取回、5=已完成、6=已取消。
+- 日期格式为 `yyyy-MM-dd`，结束日期含当天；分页默认 1/20、上限 100，固定按 ID 倒序。
+  老系统 `finishDate` 过滤误生成不存在的 `finish_date` 列（查询报错），MCP 侧已修正映射到 `finish_time`。
+- 行级权限：总部看全部；代理身份按申请代理/所属代理（本代理+授权代管）、授权代管物业过滤，
+  且本人出现在 `order_process(order_type=1)` 的工单可见；销售非负责人按自己创建及代管代理物业过滤。
+
+## 29. withdraw.order.detail.query
+
+按 `id` 或 `withdrawOrderNo` 查询详情，两者至少传一个；同时传入时必须匹配同一条可见记录。
+
+- 行级权限与列表完全一致（老系统 lookDetails 无权限校验，MCP 侧已补齐）；不存在和无权统一返回 `NOT_FOUND_OR_FORBIDDEN`。
+- `record`：撤机主单（期望/实际撤机日期、撤机理由、联系人、项目地址等）及状态/类型文案。
+- `withdrawDetails`：`withdraw_order_details` 中 `in_count>0` 的实际取回物品明细。
+- `maintenanceUsers/cooperateUsers`：`install_order_user type=1` 的运维/协同人员。
+- `processes`：`order_type=1`、`schedule_state=2` 且非抄送（theme=12）的流程，按操作时间、ID 正序，主题/类型给 code+文案。
+- `certificates`：流程凭证附件，限定 `in_out_allocation_type=12`，仅返回 `id/fileName/bucket/objectKey`。
+- 撤机结单后自动生成取货工单（`pickup_order.type=2`），可用 `pickup.order.list.query` 的 `withdrawOrderNo` 参数串联查取货/入库进度。
+
+详细设计见 `withdraw-order-mcp-tools-design.md`。
+
 ---
 
 ## 附录：在线查看工具清单