# Patch: _visualDev-api-shim — v0.11+ Phase 1 webapi 镜像 **状态**: ✅ 已应用 **生效 commit**: `d4506fe` (2026-06-25) **对应 web 端文件**: `web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts` ## 改动原因 dacli 之前用自有 `JnpfClient.postJson('/visualdev/Base', ...)` 调用 web 端 30+ 函数, 每次 JNPF 升级 web 端加新参数/字段, dacli 都漏. 6 周修 50+ 盲点根因都是"复刻漂移". v0.11+ Phase 1: 用 `dacli/src/webapi/_loader.ts` 直接 dynamic import `web/.../api/onlineDev/visualDev.ts` 原版, dacli 调 web 端函数 → 0 漂移. ## 实际改动 ### 新增 dacli 端 (3 文件) | 文件 | 作用 | |------|------| | `dacli/src/webapi/_loader.ts` | 读 web 源 → 替换 import → 写 tmp → dynamic import | | `dacli/src/webapi/_defhttp_shim.ts` | 用 JnpfClient 实现 web 端 defHttp (get/post/put/delete) | | `dacli/src/webapi/visualDev.ts` | 30+ 函数 Proxy re-export | ### web 端零改动 web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts **保持原样**. 通过 `_loader.ts` 的 import 替换: - `from '#/api/request'` → `from '<_defhttp_shim path>'` - 其他保持不变 (visualDev.ts 只 import defHttp) ## 验收方法 ```bash # 1. 跑视觉端到端测试 npx tsx dacli/tests/test-webapi-visualdev.ts # 期望输出: # ✓ 11 个核心函数可用 # ✓ getVisualDevList 返回数据 # ✓ getInfo 返回数据 # 2. 跑 baseline (API 0 错) SKIP_PLAYWRIGHT=1 bash .claude/skills/dacli-ts/examples/baseline/all.sh # 3. 跑 dacli form list (已切换样板命令) dacli form list --limit=3 # 期望: 输出与改 webapi 前完全一致 ``` ## web 升级后如何重应用 web 升级如果: - **visualDev.ts API 没变**: 不需任何操作, `_loader.ts` 会自动 import 最新版本 - **visualDev.ts API 变了** (新增/删除/重命名函数): - 跑 `npx tsx dacli/tests/test-webapi-visualdev.ts`, 看哪个函数不在了 - dacli 端命令按需更新 import (一般不需要动) - 跑 baseline 验证 ## 不需要做的事 - ❌ 不要修改 web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts - ❌ 不要重写 _loader.ts / _defhttp_shim.ts - ❌ 不要把 `from '#/api/request'` 替换写死 (让 _loader.ts 处理)