# 微信 AI 小程序 P0 接入交接单

目标：先交付开发模式准备包，让微信 AI 能推荐服务、查看详情、整理咨询/数据服务草稿；暂不全量开启自动模式。

P1/P2 的只读账户助手和 AI 助手授权中心见 `docs/WECHAT_AI_P1_P2_HANDOFF.md`。

## 已接入能力

- 小程序 `app.json` 输出 `agent.skills`，Skill 名称为 `dlbdi-service`，路径为 `skills/service-assistant`。
- `page-meta.json` 只包含首页、搜索、服务、咨询介绍和资讯等低风险页面。
- Skill 原子接口：
  - `recommendServices`
  - `searchServices`
  - `getServiceDetail`
  - `prepareLeadDraft`
- 后端接口：`POST /api/ai/wechat/assist`。

## 安全边界

- AI 不自动提交咨询申请、数据服务申请、订单、支付单、核销、PC 登录确认、发票申请、账号资料变更。
- `auth/*`、`staff/*`、`checkin/*`、`cart`、`checkout`、`account/settings`、专家后台页面不进入 `page-meta.json`。
- 咨询/数据申请草稿存储在本地 `dlbdi-mini:ai-lead-draft:<key>`，页面只通过 `aiDraftKey` 读取该前缀下的数据。

## 微信后台操作

1. 未拿到内测入口前，只上传包含 AI 配置的准备包，不开启全量自动模式。
2. 拿到入口后，优先开启开发模式并绑定 `dlbdi-service` Skill。
3. 自动模式如需开启，只允许小流量验证服务发现页面，不授权员工、核销、支付、登录确认类流程。

## 验收

```bash
cd miniapp
npm run typecheck
npm run build:weapp
```

构建会自动运行 `npm run verify:ai-config`，检查 `dist/app.json`、`dist/skills/service-assistant`、`dist/page-meta.json` 和高风险页面 allowlist。

后端单元测试：

```bash
cd backend
npm run test:unit
```

## 回滚

- 小程序侧：回滚到上一版不含 `agent.skills` 的上传包，或在微信后台关闭 AI 能力。
- 后端侧：如果需要临时停用 AI 聚合接口，可在网关/反代层封禁 `/api/ai/wechat/assist`；该接口无写业务数据副作用。
- 回滚前保留后端请求日志、微信开发者工具截图、相关订单/申请记录，便于排查误触发。
