# node_facade_base44_wix 项目状态

## 更新记录

- 2026-07-16: 创建 Wix 独立 facade。
- 2026-07-16: 完成公共客户端装配迁移和 AI 文档收尾。

## 项目定位

- 当前版本：`1.0.0`
- 项目类型：`node_facade_xx` 应用组合封装库
- npm 包名：`node_facade_base44_wix`
- 上游服务：`node_wix_server /hzhx/wix_server`
- 基础依赖：`node_lib_base44_core@^1.0.0`

本项目从 `node_base44_comm` 的 Wix 设备能力整理而来，但不修改、不替换也不依赖 `node_base44_comm`。

## 对外能力

- `CreateWixProxy`：创建只允许 Wix 服务路径的 Base44 代理。
- `CreateWixClient`：创建 Wix 场景客户端。
- `Client.WixDeviceApi.Request`：调用任意明确的 QJson Fun。
- `QueryTask`、`SendIocpServerData` 特殊参数适配。
- Soracom、节目下发、NOVA、固件和存储相关命令。

## 模块列表

- `wix_proxy`：固定 `/hzhx/wix_server` 白名单代理。
- `wix_client`：客户端组合。
- `wix_service`：QJson 构造、命令目录和特殊参数适配。
- `service_paths / messages`：固定路径和错误文本。

## 目录结构

```text
node_facade_base44_wix/
├─ src/                 # Wix QJson 场景组合
├─ test/                # mock 后台测试
├─ examples/            # 可运行示例
├─ docs/api/
├─ docs/fun/
├─ docs/logs/
├─ index.js
├─ install.bat
├─ run-test.bat
└─ publish-npm.bat
```

## 配置边界

- 后台地址必须通过 `ApiBaseUrl` 传入。
- 项目不读取环境变量，不写死真实服务地址。
- 默认只允许 `/hzhx/wix_server`。
- 额外鉴权 Header 可通过 core 的 `StaticHeaders` 或 `BuildHeaders` 传入。

## 验证状态

2026-07-16 已完成本地验证：

```bat
install.bat                 # 本地 core 安装通过，0 个安全漏洞
run-test.bat                # 静态检查和全部 mock 测试通过
node examples/basic_usage.js # 通过
npm pack --dry-run          # 通过，16 个发布文件
```

真实 `node_wix_server` 和 Base44 Function 联调尚未执行，需要发布 core/facade 后在目标环境验证。

## 待完成能力

- 使用真实 `node_wix_server` 验证所有已登记 Fun。
- 用户确认后决定是否为新增兼容能力调整 minor 版本。
- 推送 Gitee 后完成 Base44 Function 固定 ref 云端验证。

## 已知问题

- 通用 `Request(Fun, ...)` 无法在本地判断后台是否支持该 Fun，调用前必须以真实服务端代码为准。
- facade 保留后台业务响应，调用方需要检查 `result`。