sswandClaude d79cdac174 feat(form): preview 命令 - 输出 standalone HTML 浏览器打开即可 (AI 场景增强, 非 web 镜像)
v0.11d+ Phase 3.2 闭环 (AI 场景增强, 不是 web 1:1 镜像):

⚠️ 重要前提: web 端 formDesign 没有专门 FormPreview 组件
  - 搜索 web/.../FormPreview* 仅找到其他域 (PrintDesign/dataInterface/dataModel/sysForm 等)
  - formDesign 的'预览'是 FormGenerator 组件复用 (同样的 formData + columnData, 不同使用模式)
  - 计划 §2.5.1 表说'镜像 web FormPreview 组件' 不准确, 必须先读源码确认

**新增 form/preview.ts (~300 行)**:
- 拉 form schema (走 webapi loadVisualDev.getInfo)
- 生成 single standalone HTML:
  - List 视图 (table + columnData.columnList, 镜像 web List 组件)
  - Detail 视图 (form fields + formData.fields, 镜像 web FormGenerator 组件, read-only)
  - 嵌入 form schema JSON (details/summary, 调试用)
  - 内联 CSS (no-spa-page 风格, 无 CDN, AI 离线可用)

**字段渲染映射** (镜像 web FormGenerator getData 行为):
- 简单控件: input/textarea/inputNumber/select/radio/checkbox/switch/date/time → 对应 HTML 控件
- 复杂控件: popupSelect/popupTableSelect/relationForm/upload/autoComplete → <span class='placeholder'>[X: 复杂控件, preview 不渲染]</span> (诚实标记, 不假装)
- 容器/按钮: divider/card/collapse/button → 简单对应
- 默认 fallback: placeholder

**集成 form/index.ts** (v0.11d+ 新子命令):
- import buildFormPreviewCommand
- cmd.addCommand(buildFormPreviewCommand())

**命令格式**:
  dacli form preview --id=<id> [--out=./preview.html] [--json]
  默认输出: ./form-preview-<id>.html
  --json: 仅输出 schema JSON, 不生成 HTML (调试用)

**端到端验证 (tdd10, 6/6 通过)**:
1. 完整 form (备件领用): HTML 文件生成, 5 字段渲染
2. 简单 form (培训记录): webType=1 仅表单, 0 列
3. --json 模式 (设备巡检): schema dump 正确, 7 字段
4. 不存在 formId: 404 报错
5. HTML 文件检查: 备件名称/类型/数量 input 正确渲染
6. webType=2 form (设备巡检): 7 列 + 7 字段完整渲染

**关键新发现** (drift 防御):
1. web 端 formDesign 无 FormPreview 组件 (是 FormGenerator 复用)
2. JNPF formData 实际是 JSON 字符串 (后端表 longtext) → 必须 parseJson
3. webType 决定 columnList 数量: webType=1=0 列, webType=2=≥1 列
4. 复杂控件 (popup/relationForm) 标 placeholder (诚实, 不假装)
5. standalone HTML 必须内联 CSS (no-spa-page 风格, AI 离线可用)

**MEMORY**: 新建 dacli-form-preview-2026-06-26.md (含完整设计意图 + 反模式 + 复盘 'web 不做 = dacli 必须 AI 场景补充' 原则)

**原则 (复盘)**: AI 场景补充 ≠ 1:1 镜像. web 没做的功能 (form preview), dacli 必须有.

Co-Authored-By: Claude <[email protected]>
2026-06-26 20:56:59 +08:00

dacli — TS 版 dacli (当前主用)

位置: $ccWorkDir/dacli/(原 test/dacli/, 2026-06-12 升级到顶层独立项目) 目标: TypeScript 重写 dacli,直接复用 JNPF web 源码 + 0 差错验证 状态: v0.7 (8 父命令 / 26+ 子命令,启动 < 500ms) 总目标: workSystem 85 + developSystem 29 = 114 张官方示例 API 0 错 + 浏览器 0 视觉差

这是什么

dacli 是 JNPF 平台的 CLI 工具,让 AI/开发者用命令行代替浏览器拖拽,自动化配置 JNPF 平台。

Java 版 (docs/dacli/ssw-dacli/) 已废弃,源码归档备查(无 target/,需手动 mvn package 跑 jar)。

TS 版 (本项目) 是当前主用 CLI:

  1. 直接复用 web 源码 — 30 分钟跑 extract 脚本拿 53 控件 schema, 不手抄
  2. Playwright Node.js 集成 — @playwright/test 与 dacli 同进程, 0 视觉差验证
  3. AI 友好帮助体系 — --ai-help 输出 markdown, SKILL.md 教 AI 何时用

两件套交付

交付物 位置 用途
dacli CLI 工具 src/ 给 AI/开发者用, 执行命令
.claude/skills/dacli-ts/SKILL.md .claude/skills/dacli-ts/ 教 AI 何时用哪个命令

两者缺一不可: 没 skill 工具躺地上, 没工具 skill 纸上谈兵。

0 差错定义

0 差错 = API 0 错 + 浏览器 0 视觉差。

层面 含义 工具
API 0 错 所有 dacli 命令返回 200/业务成功 vitest + 集成测试
UI 0 视觉差 复刻的表单/菜单浏览器渲染与原版像素级一致 Playwright Node.js

0 差错基线: 74 张官方示例 (developSystem 21 + workSystem 53)。 dacli 对这 74 张必须做到:

  • ✅ dacli form export <id> → dacli form import → 重建后结构 0 差
  • ✅ Playwright 打开原版与复刻版,截图视觉 0 差
  • ✅ 所有字段、按钮、列表列正确渲染
  • ✅ 表单可正常提交、菜单可正常跳转、工作流可正常发起

快速开始

cd $ccWorkDir/dacli
npm install                                      # 装依赖
npx playwright install chromium                  # 装浏览器 (baseline 验证用)
# v0.11+ 无需 extract 脚本: webapi/ 直接 dynamic import web 端源码
npx tsx src/cli.ts app login --appCode=tds       # 登录 tds
npx tsx src/cli.ts form list                     # 列已有表单

跑 baseline 一键回归

# 74 张一键回归 (API + UI)
bash .claude/skills/dacli-ts/examples/baseline/all.sh

# 仅 API 层 (快, 跳过 Playwright)
SKIP_PLAYWRIGHT=1 bash .claude/skills/dacli-ts/examples/baseline/all.sh

目录结构

dacli/                           # 顶层独立项目 ($ccWorkDir/dacli)
├── prompt.md                     # 任务说明书 (开发这个项目的 AI 看的)
├── README.md                     # 本文件 (项目入口)
├── package.json
├── tsconfig.json
├── playwright.config.ts          # Playwright 配置
│
├── src/                          # ⭐ dacli CLI 工具
│   ├── cli.ts
│   ├── commands/                 # 24 父命令 / 116 子命令
│   ├── core/                     # 基础设施 (client/kit/help/log)
│   ├── webapi/                   # ⭐ v0.11+ webapi 镜像 (18 模块, 100+ 函数)
│   ├── data/                     # FieldBuilder JSON (component-map / field-schemas / ...)
│   └── schema/                   # FieldBuilder
│
├── ../.claude/skills/dacli-ts/   # ⭐ AI 专用 skill (父项目, v0.11+ 已合并)
│   ├── SKILL.md                  # 主入口
│   ├── references/               # 8 专题文档
│   └── examples/                 # 14 可复用脚本
│
├── doc/                          # 人类详细文档
│   ├── architecture.md
│   ├── plan.md                   # 6 周路线
│   ├── baseline.md               # 0 差错验证
│   ├── api.md
│   ├── extractors.md
│   └── help-system.md
│
├── tests/                        # Playwright + vitest
│   ├── e2e/baseline/             # 114 张 baseline
│   ├── e2e/api/
│   ├── e2e/visual/
│   └── unit/
│
├── screenshots/                  # 截图 (gitignored)
├── scripts/                      # seed-tds-baseline.ts
└── .dacli-cache.db               # SQLite 缓存

6 周路线

Week 任务 必达
W0 准备 doc + skill ✅ 已完成
W1 脚手架 login + form list/create tds/dev/work 都能登录
W2 提取 5 个 extractor + Playwright data/*.json 全部就位
W3 developSystem 21 张 baseline 21/21 API 0 错
W4 workSystem 53 张 baseline 53/53 API 0 错
W5 帮助体系 --ai-help + doc/apis 镜像 Java 版
W6 skill 完整 AI 自检 + 文档 AI 1 次对话完成请假流程

详见 doc/plan.md。

与 Java 版的关系

维度 Java 版 (生产) TS 版 (实验)
稳定 ⭐⭐⭐⭐⭐ (6 月打磨) ⭐⭐
AI 友好 ⭐⭐⭐ ⭐⭐⭐⭐⭐
Schema 真相 53 builder 硬编码 data/*.json 自动
Baseline 40 form 74 form
Playwright ssw-e2e-test (Python) @playwright/test (Node)
启动 100ms native < 500ms tsx
定位 生产 实验

v1 不替代。v2 评估后再决定。

反向链接


生成时间: 2026-06-12 作者: Claude (M3) + 用户 核心目标: 74 张官方示例 API 0 错 + 浏览器 0 视觉差

S
Description
dacli CLI — JNPF 平台 AI 驱动开发工具 (TS 版 v0.7)
Readme
3.9 MiB
0 Stars 1 Watchers 0 Forks
Languages
TypeScript 99.4%
Shell 0.4%
Python 0.2%