管家婆 H3 ERP 微信开单
概述
本技能实现 WorkBuddy 通过微信/IM 指令远程操控管家婆 H3 ERP 系统完成开单、查询等业务操作。核心技术路线为 Playwright MCP Server 浏览器自动化，控制本地运行的管家婆 H3 Web版（http://localhost/HHERP/）。
触发条件
当用户发送以下类型指令时激活本技能：
- 开单/下单相关：「开单 客户:XX 商品:XX 数量:200」「帮我新建一个销售订单」「下个单给XX公司」
- 查询相关：「查订单 SO-xxx」「查库存 XX商品」「查一下XX客户的信息」
- 修改相关：「修订单 SO-xxx 数量 300」「加单 SO-xxx 产品A 50套」
- 汇总相关：「汇总今日销售」
核心工作流
阶段 1：指令解析与验证
- 从用户消息中提取关键字段：客户名、商品名、数量、单价、备注
- 验证字段完整性 — 如有缺失，向用户追问缺项
- 加载
references/gjp-h3-reference.md查阅客户列表和商品分类，确认客户/商品是否存在于系统中 - 如客户/商品名称模糊匹配到多个结果，列出选项让用户确认
阶段 2：交互确认（核心环节 — 必须执行）
在执行任何 ERP 写入操作之前，必须先向用户展示订单摘要并等待确认。
确认消息格式：
======================
[*] 订单摘要确认
======================
单据类型：销售订单
客 户：{客户名称}
商 品：{商品名称}（规格：{规格}）
数 量：{数量} {单位}
单 价：Y{单价}
合 计：Y{合计金额}
仓 库：{仓库名称}
支付方式：{支付方式}
备 注：{备注}
======================
[?] 该订单是否确认开单？
[OK] 「确认开单」或回复「1」 --- 立即写入管家婆H3
[~] 「修改」+ 内容，如「修改 数量 300」
[X] 「取消」 --- 放弃本次开单
======================
用户回复规则：
- 回复「确认开单」/「1」-> 进入阶段3执行开单
- 回复「修改 XXX」-> 更新对应字段并重新展示确认
- 回复「取消」-> 放弃流程，不做任何ERP操作
- 5分钟无回复-> 自动取消，提示用户
阶段 3：Playwright 操作 ERP 开单
使用 Playwright MCP 工具按以下步骤操作管家婆 H3 Web版：
步骤 1 — 确保已登录
- browser_navigate -> http://localhost/HHERP/Account/Login
- 如果在登录页面：选择账套 -> 选择管理员 -> 点击登录
- 如果已登录（显示主界面）：继续下一步
步骤 2 — 导航到销售订单
- 点击左侧菜单「销售管理」展开子菜单
- 点击「销售订单」进入订单页面
步骤 3 — 填写客户信息
- 点击「购买单位」输入框
- 输入客户名称关键词
- 点击搜索按钮打开选择弹窗
- 在弹窗中搜索客户 -> 双击选中目标客户
步骤 4 — 添加商品明细
- 点击第1行商品编号单元格
- 点击搜索按钮打开商品选择弹窗
- 在弹窗中搜索商品名称 -> 双击进入分类子层 -> 双击具体商品选中
- 回到订单表单
步骤 5 — 填写数量和单价
- 点击数量单元格 -> 输入数量 -> 按 Tab 键确认
- Tab 到单价字段 -> 输入单价 -> 按 Tab 键确认
- 确认金额自动计算正确
步骤 6 — 保存单据
- 点击底部「保存单据(S)」按钮
- 等待保存成功提示
步骤 7 — 截图确认
- 保存成功后截图记录单据编号
- 读取页面上的单据编号
阶段 4：结果回复
开单完成后，向用户发送结果：
[OK] 订单已成功开单！
[#] 订单号：{单据编号}
[Y] 订单金额：Y{金额}
[D] 开单时间：{时间}
[~] 交货状态：待发货
如需查看订单详情，回复「查订单 {单据编号}」
如操作失败，发送错误提示和手动操作建议。
常用快捷指令
| 指令 | 功能 | 操作路径 |
|---|---|---|
| 开单 | 创建销售订单 | 销售管理 -> 销售订单 -> 填写并保存 |
| 查订单 | 查询订单状态 | 综合查询 -> 销售查询 |
| 查库存 | 查询商品库存 | 库存管理 -> 库存查询 |
| 加单 | 已有订单加购 | 查到订单 -> 修改明细 |
| 修订单 | 修改订单明细 | 查到订单 -> 修改字段 |
| 备货 | 确认订单备货 | 销售出库 |
| 出库 | 执行出库单 | 销售管理 -> 销售出库 |
| 汇总 | 查询当日销售汇总 | 综合查询 -> 销售汇总 |
异常处理
| 异常场景 | 处理方式 |
|---|---|
| 库存不足 | 告知当前可用量，询问「强制开单」或「取消」 |
| 客户不存在 | 列出相似客户供选择，或要求确认客户名称 |
| 欠款客户 | 提示欠款金额，确认是否继续 |
| 价格异常 | 标注异常，确认是否使用特殊价 |
| ERP 无响应 | 提示操作失败，建议检查ERP连接，提供手动操作指引 |
Playwright MCP 配置要点
- 连接器名称: playwright
- 浏览器: chrome（已通过 npx playwright install chrome 安装）
- 核心工具: browser_navigate, browser_snapshot, browser_click, browser_type, browser_take_screenshot, browser_press_key
- 元素定位: 使用 browser_snapshot 获取页面元素 ref，然后用 ref 进行点击/输入操作
- 双击选择: 客户选择和商品选择弹窗中，需要双击目标行才能选中
- 商品分类: 商品按品牌分层，需要逐层双击进入子分类才能找到具体商品
- Tab 导航: 在订单明细表中，按 Tab 键在数量/单价/金额等字段间切换
注意事项
- 开单执行过程中，保持微信/IM 活跃状态
- 确认请求 5 分钟超时自动取消
- 计算机必须处于开机且 ERP 已登录状态
- Playwright 操作前先用 snapshot 确认当前页面状态，避免在错误页面操作
- 正式环境建议启用操作日志，便于追踪异常
- 首次使用建议用测试客户数据验证流程
Resources
references/
- gjp-h3-reference.md — 管家婆H3 ERP 系统信息、核心表结构、商品分类、客户列表、操作路径速查
