Files
dacli/docs/web-patches/_visualDev-api-shim.md
T
sswandClaude a0242714ef docs(v0.11): dacli/docs/web-patches/ 建立 - patch 文档化流程
按 feedback-web-patch-docs.md 规则, 建立 dacli/docs/web-patches/ 目录:

- README.md: 文档化规则 + 当前 patches 状态 + Phase 3 候选 (说明)
- _visualDev-api-shim.md: Phase 1 webapi/visualDev patch (commit d4506fe)
- _buildformdata-formUtils.md: Task 4-10 _buildformdata.ts patch (commit bb3ebaf~fd8ef3b)

Phase 3 候选改造 (formDesign/Form.vue / CreateMenuModal.vue / sysForm/Form.vue)
通过 Phase 1 webapi 间接覆盖 (web 端组件仍调原端点, dacli 用 webapi 调同样端点),
直接抽纯函数价值有限, 暂不执行. 如果未来 BS-48/49/50 反复修, 再启动真正 Phase 3.

升级 web 后, AI 读本目录所有 patch 文档逐个对照, 缺失的重新应用.

Co-Authored-By: Claude <[email protected]>
2026-06-25 13:12:10 +08:00

2.2 KiB

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)

验收方法

# 1. 跑视觉端到端测试
npx tsx dacli/tests/test-webapi-visualdev.ts

# 期望输出:
# ✓ 11 个核心函数可用
# ✓ getVisualDevList 返回数据
# ✓ getInfo 返回数据

# 2. 跑 baseline (API 0 错)
SKIP_PLAYWRIGHT=1 bash dacli/.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 处理)