# Wix facade AI 快速开发指南

## 更新记录

- 2026-07-16: 建立 QJson 命令扩展和收尾审查流程。

## 权威来源和阅读顺序

1. `node_wix_server` 真实 QJson handler、Fun 分发和参数读取代码。
2. `src/wix_service.js` 的命令目录和特殊方法。
3. `docs/api/wix.md`、`test/wix.test.js`。
4. core 的 `docs/fun/ai_facade_development.md`。

旧 `node_base44_comm` 只用于兼容对照，不能证明后台 Fun 当前存在。

## 命令分类

- 普通命令：接收一个 Data 对象，加入 `WIX_DEVICE_COMMANDS`。
- 特殊兼容命令：支持标量或对象，使用 `BuildFieldObject`。
- 动态命令：调用 `Request(Fun, Data, ExtraQJson)`，只适合后台已确认存在但尚未固化的方法。

## 不可突破的边界

- 路径默认只有 `/hzhx/wix_server`。
- 不在包里读取环境变量或绑定主程序配置路径。
- 不把 ThinkSign、Supabase 或其他后台命令混入本包。
- 不把后台业务 `result` 擅自改写成 core `Success`。
- 不复制 fetch、Base44 鉴权、超时或客户端入口解析。

## 新命令步骤

1. 从服务端确认准确 Fun、Data 字段、可选值和响应。
2. 判断普通命令还是特殊参数兼容。
3. 实现最小映射，保留后台 wire 字段。
4. 测试 QJson.Fun、Data、ExtraQJson 覆盖顺序和错误输入。
5. 更新 API、usage、composition、status 和 logs。

## 收尾命令

```bat
install.bat
run-test.bat
npm pack --dry-run
```

真实联调需要记录服务版本、Fun、请求样例和结果。未经用户确认不修改版本、不提交、不建 tag。

## 相关文档

- [公共 API](../api/wix.md)
- [组合流程](composition.md)
- [项目状态](../project-status.md)