毛孩子美容会所 · AI 管家（P100 / petgroom-ao）

基于 DSH Java Native Plugin 的宠物美容智能运营示例：Spring Boot 业务应用 + Java 原生插件，把美容预约业务注册为 DSH Agent 工具，主人在聊天页即可完成查服务、挑美容师、预约、查单等全流程。

功能总览

能力	工具	说明
服务列表	service_list	5 项服务价格与内容，含月卡折扣
美容师列表	groomer_list	3 位美容师风格与在约单量
美容预约	appoint	主人/宠物/服务/美容师，自动计价
美容单查询	order_info	单号 PG1001 起，状态：已预约→美容中→已完成
运营统计	stats	总单量/收入/分服务分美容师分布/运营建议

业务规则

• 服务（元）：基础洗护 88 / 精致造型 158 / 皮肤药浴 198 / SPA 疗愈 238 / 全套美容 328
• 美容师：首席·琳达 M01 / 造型师·大米 M02 / 疗愈师·小棉 M03
• 权益：月卡 9 折；首次到店送免洗 paw 泡泡；全程视频可视，完成后发视频；应激宠物有静音房
• 服务提醒：到店前 2 小时禁食禁水
• 状态机：已预约 → 美容中 → 已完成

预约演示

一句话预约，AI 复述主人/宠物/服务/价格/美容师后下单，返回 PG 单号：

架构

浏览器 ──SSE──> ao-app (Spring Boot :18139)
                  │  AssistantController 代理 /api/agent/stream
                  ▼
              DSH standalone (:8090)  Agent: petgroom-ao
                  │  Java Native Plugin (in-process)
                  ▼
              PetGroomPlugin ──HTTP──> ao-app REST
              /api/services /api/groomers /api/appoint /api/order /api/stats

• ao-app：cn.xiaofuge.ao.app，业务存储内置于 AoController（内存种子数据），REST + SSE 代理 + 梦幻紫系 index.html
• ao-plugin：cn.xiaofuge.ao.plugin.PetGroomPlugin，继承 AbstractHarnessPlugin，注册 5 个 AbstractTool，SPI + plugin.yaml 加载

快速开始

# 1. 构建
mvn clean package -DskipTests

# 2. 启动业务应用（端口 18139）
java -jar ao-app/target/ao-app-1.0.0-SNAPSHOT.jar --server.port=18139

# 3. 安装并激活插件
cp ao-plugin/target/ao-plugin-1.0.0-SNAPSHOT.jar ~/.dsh/standalone/plugins/petgroom-ao.jar
curl -X POST http://127.0.0.1:8090/api/harness/plugins/install -H 'Content-Type: application/json' \
  -d '{"pluginId":"petgroom-ao","displayName":"毛孩子美容会所插件","pluginVersion":"1.0.0","runtimeType":"JAVA_NATIVE","sourcePath":"'"$HOME"'/.dsh/standalone/plugins/petgroom-ao.jar","entrypoint":"cn.xiaofuge.ao.plugin.PetGroomPlugin"}'
curl -X POST http://127.0.0.1:8090/api/harness/plugins/activate -H 'Content-Type: application/json' -d '{"pluginId":"petgroom-ao"}'

# 4. 打开聊天页
open http://127.0.0.1:18139

端到端验证

python3 petgroom_ao_e2e.py
# ===== petgroom-ao E2E: 5/5 PASS =====

覆盖：服务报价、美容师列表、美容预约（PG 单号）、美容单查询、运营统计 5 条链路。

目录结构

petgroom-ao/
├── pom.xml                # 父工程 pet-grooming-ao
├── ao-app/                # 业务应用 (Spring Boot, :18139)
├── ao-plugin/             # DSH 插件（5 工具）
├── docs/shots/            # 5 张 UI 演示图
└── petgroom_ao_e2e.py     # E2E 验证脚本

---

DSH Java Native Plugin 场景案例 P100（收官） · 2026-09-25