housekeeping-cleaning · AI 家政保洁管家（DSH Java Native Plugin 场景案例 P69）

基于 deepseek-harness-java（DSH） Java Native Plugin 机制构建的连锁家政保洁智能管家：服务查询、保洁师查询、预约下单、订单跟踪、运营统计，一个 Agent 全搞定。

✨ 功能一览

能力	说明
🧹 服务查询	4 项服务（日常保洁 128 / 深度保洁 358 / 开荒保洁 598 / 擦窗 158）价格与时长
👩‍🔧 保洁师查询	3 位保洁师擅长领域与评分（4.8–5.0）
📝 预约下单	AI 先复述服务、价格、地址、上门时间，经确认后办理，按擅长自动派单
📦 订单查询	订单号查服务 / 地址 / 保洁师 / 金额 / 状态
📊 运营统计	总单量 / 待上门 / 营收 / 分服务分布 / 派单与营销建议

🖼️ 界面预览

截图	说明
	运营看板首屏：总单量 / 待上门 / 营收 + 服务项目列表
	AI 预约下单：确认后办理（订单号 K8005，分配刘阿姨）
	AI 订单查询：K8005 详情（服务/保洁师/时间/状态）
	AI 运营统计：订单分布 / 收入 / 运营建议

🏗️ 项目结构

housekeeping-cleaning/
├── pom.xml                 # Maven 聚合工程（p-app + p-plugin）
├── p-app/                  # Spring Boot 业务应用（端口 18108）
│   └── src/main/java/cn/xiaofuge/j/app/
│       ├── CleaningApplication.java # 启动类
│       ├── JStore.java              # 数据中心（服务/保洁师/订单）
│       ├── JController.java         # REST 接口（5 端点）
│       └── AssistantController.java # 页面消息 SSE 代理到 DSH
└── p-plugin/               # DSH Java Native 插件（agentId: cleaning-copilot）
    └── src/main/java/cn/xiaofuge/j/plugin/
        └── CleaningPlugin.java      # 5 个 AI 工具 + 系统提示词 + Hook

🔧 AI 工具集（5 个）

工具名	功能	关键约束
service_list	服务项目查询	含保洁师擅长与评分
cleaner_list	保洁师列表	姓名/擅长/评分
book	预约下单	必须先复述要素经顾客确认后才能调用；按服务类型自动派单
order_info	订单查询	服务/地址/保洁师/金额/状态
stats	运营统计	提供派单与营销建议

🚀 快速开始

# 1. 构建业务应用
mvn clean package -DskipTests

# 2. 启动应用（端口 18108）
SERVER_PORT=18108 java -jar p-app/target/p-app-1.0.0-SNAPSHOT.jar

# 3. 插件 jar 放入 DSH 插件目录
cp p-plugin/target/p-plugin-1.0.0-SNAPSHOT.jar ~/.dsh/standalone/plugins/cleaning-copilot.jar

# 4. 注册插件（DSH 运行中）
curl -X POST http://127.0.0.1:8090/api/harness/plugins/install \
  -H 'Content-Type: application/json' \
  -d '{"pluginId":"cleaning-copilot","displayName":"AI 家政保洁管家","pluginVersion":"1.0.0","runtimeType":"JAVA_NATIVE","sourcePath":"'$HOME'/.dsh/standalone/plugins/cleaning-copilot.jar","entrypoint":"cn.xiaofuge.j.plugin.CleaningPlugin"}'

# 5. 激活插件
curl -X POST http://127.0.0.1:8090/api/harness/plugins/activate \
  -H 'Content-Type: application/json' -d '{"pluginId":"cleaning-copilot"}'

# 6. 启动 DSH standalone（如未运行）
cd ~/.dsh/standalone && java -Dspring.profiles.active=standalone -Dserver.port=8090 \
  -jar ~/.dsh/skills/dsh-java-plugin-skills/runtime/deepseek-harness-java-app.jar

打开 http://127.0.0.1:18108 即可开始对话。

🌐 REST 接口

方法	路径	说明
GET	/api/services	服务项目列表（含保洁师信息）
GET	/api/cleaners	保洁师列表
POST	/api/book	预约下单 {customer, service, address, time}
GET	/api/order?orderId=	订单查询
GET	/api/stats	运营统计
POST	/api/assistant/stream	AI 对话 SSE 代理

✅ E2E 验证（agent_stream.sh 端到端）

#	用户消息	调用工具	结果
1	有什么保洁服务？价格	service_list	✅ 4 项服务价格时长 + 保洁师
2	有哪些保洁师	cleaner_list	✅ 3 位保洁师擅长与评分
3	帮林先生约日常保洁（含确认语）	book	✅ 订单号 K8004，分配 A01 张阿姨
4	查订单 K8001	order_info	✅ 黄先生 / 日常保洁 / 待上门
5	今天运营情况	stats	✅ 3 单 / ¥644 / 建议

🔑 技术要点

• DSH Java Native Plugin：AbstractHarnessPlugin + AbstractTool，工具以 plugin__cleaning-copilot__<name> 暴露给 LLM
• 系统提示词注入：registerSystemPrompt 固化「下单前必须复述要素确认」「贵重物品建议收纳」「高层擦窗安全提示」等业务红线
• PRE_TOOL_USE Hook：所有工具调用注入审计上下文
• SSE 透传：页面消息经 AssistantController 代理到 DSH /api/agent/stream（agentId=cleaning-copilot，超时 180s）
• 自动派单：深度保洁→A02 刘阿姨，开荒/擦窗→A03 陈阿姨，日常→A01 张阿姨

📄 License

MIT