XH ERP 用户与商品管理助手
通过 MCP 工具 call_service 调用后端 ERP 服务，实现用户查询/修改与商品新增/查询。
前置条件：配置 MCP 服务
本 Skill 依赖 MCP 服务才能调用 ERP 后端接口，请先完成以下配置：
第一步：添加 MCP 服务
- 打开 WorkBuddy，点击左侧导航栏的 「专家·技能·连接器」
- 顶部切换到 「连接器」 标签页
- 点击右上角 「自定义连接器」 按钮
- 在弹出的 MCP 服务管理窗口中，点击右上角 「配置 MCP」 按钮
- 在 JSON 配置编辑器中，粘贴以下配置（请替换地址和 API Key）：
{
"mcpServers": {
"xh-mcp": {
"url": "http://你的服务地址/mcp",
"headers": {
"X-API-Key": "你的API Key"
}
}
}
}
- 把
url替换为服务提供方给你的实际地址 - 把
X-API-Key替换为你的专属 Key（向服务提供方申请，切勿与他人共用） - 点击 「保存」
- 返回 MCP 列表，找到
xh-mcp条目，点击 「信任」 完成首次授权 - 状态变为绿色（已连接）即配置成功
> ⚠️ 如果 Skill 已安装但 AI 提示"找不到工具"或"调用失败"，请先检查此步骤的 MCP 连接是否正常（列表中 xh-mcp 是否显示绿色）。
第二步：验证连接
配置完成后，可以在对话中说"列出可用路由"或"list_routes"，如果返回服务列表说明 MCP 已就绪，可以开始使用下方功能。
路由说明
erp-base：用户管理服务xh-erp-product-php：商品管理服务- 调用前可执行
list_routes确认路由可达
一、用户管理（服务路由：erp-base）
1. 查询用户列表
- 接口：
POST /web/users/getUserList - 调用：
call_service(serviceNameOrUrl="erp-base", method="POST", path="/web/users/getUserList", body=<JSON>, headers="") - body 示例：
{"pageNum":1,"pageSize":10,"name":"张三"}
- 参数：
pageNum（页码，默认1）、pageSize（每页条数，默认10）、name（用户名模糊，可选）、phone（手机号，可选）、status（状态，可选）
2. 修改用户信息
- 接口：
POST /web/users/editUser - 调用：
call_service(serviceNameOrUrl="erp-base", method="POST", path="/web/users/editUser", body=<JSON>, headers="") - body 示例：
{"id":123,"name":"李四","phone":"13800000000","status":1}
- 参数：
id（必填）、name、phone、status等需修改字段
3. 修改用户名
- 接口：
POST /web/users/editUserName - body：
{"id":123,"userName":"new_name"}
4. 修改真实姓名
- 接口：
POST /web/users/editUserRealName - body：
{"id":123,"realName":"李四"}
二、商品管理（服务路由：xh-erp-product-php）
1. 新增/编辑商品 SPU
- 接口：
POST /ReceptionApi/ProductsSpu/addProductSpu - 调用：
call_service(serviceNameOrUrl="xh-erp-product-php", method="POST", path="/ReceptionApi/ProductsSpu/addProductSpu", body=<JSON>, headers="") - body 示例：
{
"spuName": "测试商品",
"brandId": 1,
"categoryId": 10,
"mainImage": "https://example.com/img.jpg",
"status": 1,
"skuList": [
{"skuName": "红色款", "price": 99.9, "stock": 100}
]
}
- 说明：有
id为编辑，无id为新增
2. 查询商品 SPU 列表
- 接口：
POST /ReceptionApi/ProductsSpu/getProductSpuList - body：
{"pageNum":1,"pageSize":10,"spuName":"测试"}
3. 获取 SPU 编辑数据
- 接口：
POST /ReceptionApi/ProductsSpu/getEditProductSpu - body：
{"id":123}
三、通用调用规则
- 必须传 body：所有接口均为 POST + JSON body，body 必须是合法 JSON 字符串。
- 卖家身份：
headers留空即可，网关自动透传卖家编码；如需指定可传{"X-API-Key":"xxx"}。 - 结果处理：返回
{"code":200,"data":...,"msg":"..."}，code=200成功，将data按表格/摘要展示；失败向用户说明msg。 - 读写区分："查询/查看"走查询类接口；"新增/添加/修改/编辑"走写入类接口，写入前向用户确认关键参数。
四、对话示例
用户：查一下手机号 13800000000 的用户
1. 调用 call_service(erp-base, POST, /web/users/getUserList, {"pageSize":10,"phone":"13800000000"})
2. 用表格展示 id、姓名、手机号、状态
用户：新增一个商品叫"测试商品"，价格 99
1. 向用户确认分类、品牌等必填信息
2. 调用 call_service(xh-erp-product-php, POST, /ReceptionApi/ProductsSpu/addProductSpu, {"spuName":"测试商品","skuList":[{"price":99}]})
3. 展示返回结果
