🐾 AI 宠物寄养管家台 · Pet Boarding

DSH（deepseek-harness-java）Java Native Plugin 场景案例 P87 寄养房型查询 / 看护师查询 / 寄养下单 / 寄养单查询 / 运营统计 + AI 流式对话

项目简介

「毛孩子假日酒店」宠物寄养门店的 AI 管家台。前台通过右侧 AI 对话窗即可完成房型报价、看护师推荐、寄养登记、寄养单查询与当日业绩统计，AI 全程调用 pet-copilot-f4 Java Native 插件的 5 个工具，流式回复。

五个 AI 工具

工具	说明	REST API
room_list	5 种房型：标准猫舍 68 / 豪华猫寓 128 / 标准犬舍 88 / 豪华犬墅 158 / VIP 尊享房 268（元/天）	GET /api/rooms
keeper_list	3 位持证看护师（猫语者·小橘 / 犬训师·大壮 / 夜班侠·阿珍），评分与在管量	GET /api/keepers
book	寄养登记（主人/电话/宠物/房型/天数），下单前 AI 复述要素确认	POST /api/book
order_info	寄养单查询（PB8001 格式），状态：已入住/寄养中/已接回	GET /api/order?orderId=
stats	总单量/已入住/寄养中/已接回/收入/分房型分看护分布/运营建议	GET /api/stats

业务规则

• 房型：标准猫舍（¥68/天）、豪华猫寓（¥128/天 含逗猫陪玩）、标准犬舍（¥88/天 含遛狗）、豪华犬墅（¥158/天 含洗澡）、VIP 尊享房（¥268/天 管家 1 对 1 + 直播监控）
• 时长优惠：7 天以上 9 折、14 天以上 85 折、同主人第二只宠物 8 折
• 服务承诺：入住当天拍适应照、每日 20 点推送视频日报、提前接回按实际天数结算
• 安全红线：疫苗必须齐全且近期无异常症状；发情期母宠与孕宠不收；节假日需提前 3 天预订

AI 对话演示

技术架构

浏览器 ──SSE──> Spring Boot(ab-app :18126)
                   │  AssistantController（StreamingResponseBody 透传）
                   ▼
              DSH Harness(:8090) /api/agent/stream
                   │  agentId = pet-copilot-f4
                   ▼
        PetBoardingPlugin（Java Native，in-process 加载）
                   │  5 × AbstractTool ──HTTP──> AbController
                   ▼
              AbStore（内存数据中心，PB8001+ 单号序列）

• ab-app：Spring Boot 3.2.5 业务应用，REST + 静态页面 + SSE 代理
• ab-plugin：AbstractHarnessPlugin 插件，SPI 注册，5 个 AbstractTool 经 HTTP 调用 ab-app
• 数值容错：Controller 对 LLM 传参做 Number/String 双格式解析
• PRE_TOOL_USE hook：全工具审计埋点

快速开始

# 1. 构建插件
cd pet-boarding && mvn clean package

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

# 3. 安装并激活插件
cp ab-plugin/target/ab-plugin-1.0.0-SNAPSHOT.jar ~/.dsh/standalone/plugins/pet-copilot-f4.jar
curl -X POST http://127.0.0.1:8090/api/harness/plugins/install -H 'Content-Type: application/json' \
  -d '{"pluginId":"pet-copilot-f4","displayName":"AI 宠物寄养管家","pluginVersion":"1.0.0","runtimeType":"JAVA_NATIVE","sourcePath":"/Users/fuzhengwei/.dsh/standalone/plugins/pet-copilot-f4.jar","entrypoint":"cn.xiaofuge.ab.plugin.PetBoardingPlugin"}'
curl -X POST http://127.0.0.1:8090/api/harness/plugins/activate -H 'Content-Type: application/json' -d '{"pluginId":"pet-copilot-f4"}'

# 4. 打开管家台
open http://127.0.0.1:18126

E2E 测试：python3 pet_e2e.py（经 DSH /api/agent/stream 验证 5 个工具，5/5 PASS）

目录结构

pet-boarding/
├── pom.xml                    # 根聚合 pom
├── ab-app/                    # 业务应用（端口 18126）
│   └── src/main/java/cn/xiaofuge/ab/app/
│       ├── PetBoardingApplication.java
│       ├── AbStore.java       # 房型/看护师/寄养单/统计
│       ├── AbController.java  # REST 接口
│       └── AssistantController.java  # SSE 代理
├── ab-plugin/                 # DSH 插件
│   └── src/main/java/cn/xiaofuge/ab/plugin/PetBoardingPlugin.java
└── pet_e2e.py                 # 端到端测试

---

更多场景案例见 dsh-java-plugin-skills。