feat(mcp): add install order query tools (REQ-20260916-0009)

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

@@ -615,6 +615,39 @@
 
 ---
 
+## 22. install.order.list.query
+
+分页查询装机工单，对应旧系统 `POST /installOrder/pageList`。
+
+- 分类：workorder ｜ 类型：读
+- 数据来源：m2 `install_order`、`install_order_details`。
+- 入参：`installOrderNo`、`mallOrderNo`、`scheduleTransferOrder`、`deliveryOrderNo`、
+  `pickupOrderNo`、`installType`、`orderState`、`agentId`、`districtName`、`applyUserName`、
+  `maintenanceUserName`、`cooperateUserName`、`applyTimeFrom/applyTimeTo`、`page/rows`。
+- 时间范围首版只保留申请日期，格式 `yyyy-MM-dd`，结束日期含当天；不接受自由排序，固定
+  `apply_time DESC, id DESC`。
+- 行级权限：总部看全部；普通代理可看自己、授权代管公司、授权代管物业及本人参与的工单，
+  不包含直属下级代理；销售非负责人只看自己创建及授权代管公司名下物业的工单。
+- 返回 `total/page/rows/records`；每条记录含 `installTypeText`、`orderStateText` 和
+  `totalInstallCount`（本单设备明细安装数量合计）。
+
+## 23. install.order.detail.query
+
+按 `id` 或 `installOrderNo` 查询装机工单详情，两者至少传一个；同时传入时必须匹配同一条可见记录。
+`includeProcess` 默认 true，可关闭流程聚合。
+
+- 行级权限与列表完全一致；不存在与无权访问统一返回 `record=null`，防止枚举。
+- `record/details/totalInstallCount`：主单、设备明细及安装数量合计。
+- `maintenanceUsers/cooperateUsers`：当前装机运维和协同人员。
+- `address`：m1 收货地址；`mallOrder`：m1 商城订单及商品明细聚合。
+- `processes`：已办理且非抄送的流程，按操作时间、ID 正序；附流程人员、配发物品/SN、
+  出入库关联单及图片凭证 URL。
+- `processLimit` 默认 100、最大 500；同时返回 `processTotal/processTruncated`。
+
+详细设计见 `install-order-mcp-tool-design.md`。
+
+---
+
 ## 附录：在线查看工具清单
 
 ```bash