# Wix facade 组合流程

## 更新记录

- 2026-07-16: 创建 facade 组合与依赖说明。
- 2026-07-16: 使用 core 统一客户端上下文并补充命令扩展边界。

## 依赖关系

```text
Base44 Backend Function
  → node_facade_base44_wix
  → node_lib_base44_core
  → node_wix_server /hzhx/wix_server
```

facade 固定服务路径，负责把场景方法转换为：

```json
{
  "QJson": {
    "Fun": "CommandName",
    "Data": {}
  }
}
```

core 负责 Base44 鉴权、路径安全、Header 和 HTTP 传输。

客户端入口由 core `CreateFacadeClientContext` 统一解析，本项目不再重复维护 `ResolveInvokePayload`。

## 与旧包关系

`node_base44_comm` 继续独立维护。新 facade 不依赖旧包，也不改变旧包的 `WixDeviceApi`。业务项目可逐个迁移，不要求同步切换 ThinkSign 能力。

## 命令扩展策略

- 普通命令：加入 `WIX_DEVICE_COMMANDS`，统一生成 `Data => RequestWixDevice`。
- 特殊参数：参考 `QueryTask`、`SendIocpServerData` 做兼容对象转换。
- 通用调用：保留 `WixDeviceApi.Request`，但业务代码应优先使用已登记方法。
- 新路径：如果不再属于 `/hzhx/wix_server`，必须重新审查是否应建立独立 facade。

详细步骤见 [AI 快速开发指南](ai_development.md)。