Files
dacli/docs/web-patches/_visualDev-api-shim.md
T
ssw 06aed3830c chore(v0.11+): 合并 dacli/.claude/skills/dacli-ts 到父 .claude/skills/ + Phase 3 Batch F 审计
用户拍板 (2026-06-25): 为避免重复, 把 dacli 子项目的 dacli-ts skill 移到父 .claude/skills/ 下作为实体目录 (而非原 symlink), 同时删 dacli/CLAUDE.md 和 dacli/.claude/ 目录.

变更:
1. 删除整个 dacli/.claude/ 目录 (30 个文件, 包含 settings.local.json + dacli-ts skill 全部内容)
2. 删除 dacli/CLAUDE.md (内容已并入父 CLAUDE.md)
3. 父 .claude/skills/dacli-ts 替换 symlink 为实体目录 (从 dacli/.claude/skills/dacli-ts 复制)
4. 更新 4 处文档引用 (dacli/.claude/skills/dacli-ts → .claude/skills/dacli-ts, dacli/CLAUDE.md 标注合并)
5. Phase 3 Batch F 5 个主流程 skill 审计报告 (新增 docs/skill-audit/):
   - dacli-ts.md — P0 必修 3 项 (补 30+ NEW-CMD + webapi 18 模块 + form validate deprecation)
   - ssw-h5dev-flow.md — P0 必修 5 项 (doc toc/search + form update + selector + log exception)
   - design-jnpf-execute.md — P0 必修 6 项 (删 _blindspots.ts 引用 + 补 webapi + 4 NEW-CMD)
   - form-development.md — P0 必修 3 项 (删 form msrelation 误用 + 补 form update + webapi 段)
   - form-fix.md — P0 必修 3 项 (删 dacli form fix 误用 10+ 处 + 补 form clone/update 流程)

Batch G-J 子代理审计待下一轮执行 (见 plan §12.3).

下一步: 执行 Phase 3 P0 必修 (按 audit 报告) → Phase 4 历史残留清理 → Phase 5 baseline 验证
2026-06-25 15:53:06 +08:00

64 lines
2.2 KiB
Markdown

# 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 处理)