fc300bb4c7ea439c2712a6e9a305a53ac8caa23c
v0.11d+ Phase 2.2 闭环 (镜像 + web/backend 行号标注):
**新增 _validate_dm.ts (3 step, 镜像 web dataModel/Form.vue:42-242 + 后端 DbTableController.java:92-112)**:
- step 0 基础信息: 镜像 web dataModel/Form.vue:42-61 schemas
- table 必填 + maxlength 50
- table 正则 (镜像 L50 /(^_([A-Z0-9]_?)*$)|(^[A-Z](_?[A-Z0-9])*_?$)/i)
- tableName 必填 + maxlength 50
- step 1 字段定义: 镜像 web dataModel/Form.vue:174-209 exist() + L213/L215-216 + L19-26 options
- 字段数 ≥ 1 (镜像 L213)
- 至少 1 个 primaryKey (镜像 L215-216)
- 字段 vmodel 正则 (镜像 L184, 含 /i flag 允许大写)
- dataType 白名单 {varchar, int, datetime, decimal, bigint, text} (镜像 L19-26)
- decimal dataLength 格式 ^\d+(?:,\d*)?$ (镜像 L185, 197)
- 字段不重复 (镜像 L191-196)
- fieldName 必填 (镜像 L202-206)
- step 2 关键字+唯一性: 镜像后端 DbTableController.java:92-112 checkName
- Java 关键字 (后端 GenerateConstant.getJavaKeyword 子集)
- SQL 关键字 (后端 GenerateConstant.getSqlKeyword 子集)
- 表名重复 (后端 EXIST001 预校验)
**create.ts 集成**:
- 新增 runDmStepMachine() 在发 API 前聚合校验, 失败 → 1 次报所有错 (AI 不用试错)
- --help + installAiHelpHook 同步标注 web dataModel/Form.vue + 后端 DbTableController 行号
**端到端验证 (tdd10, 9/9 预期匹配)**:
1. 成功路径 (table 合法 + 1 字段 + primaryKey) → 3/3 ✓
2. SQL 关键字 'select' → step 2 拦截
3. 字段数=0 → step 1 拦截 (请至少添加一个字段)
4. 无 primaryKey → step 1 拦截 (请选择一个字段作为主键)
5. 非法 dataType 'xml' → step 1 拦截 (白名单 6 种)
6. F_NAME 字段 → 3/3 ✓ (镜像 web /i flag 行为)
7. 字段重复 → step 1 拦截 (第2行列名已重复)
8. decimal dataLength='abc' → step 1 拦截
9. 表名重复 → step 2 拦截 (EXIST001 预校验)
**关键新发现** (drift 防御):
1. web dm designer 位置: dataModel/Form.vue (不是 sysForm/Form.vue, 那是 form回传)
2. '请在数据库中添加对应的数据表' 实际是 getDbTableModel 抛 (export 端点), 不是 create 误报
3. 字段正则 /i flag: web 允许大写开头字段, dacli 必须镜像
4. 预存 webapi shim bug: loadDataModel.createDataModel 返回 undefined, 范围外 (待后续专项)
**MEMORY**: 新建 dacli-dm-create-step-machine-2026-06-26.md 记录设计意图 + 行号 + 反模式
Co-Authored-By: Claude <[email protected]>
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:
- 直接复用 web 源码 — 30 分钟跑 extract 脚本拿 53 控件 schema, 不手抄
- Playwright Node.js 集成 —
@playwright/test与 dacli 同进程, 0 视觉差验证 - 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 评估后再决定。
反向链接
- prompt.md — 完整任务说明书
- doc/architecture.md — 设计决策
- doc/plan.md — 6 周路线
- doc/baseline.md — 0 差错验证
- doc/api.md — 完整 API
- doc/extractors.md — 提取工具
- doc/help-system.md — 帮助体系
- .claude/skills/dacli-ts/SKILL.md — AI 技能主入口
- .claude/skills/dacli-ts/references/ — 6+ 文档
- .claude/skills/dacli-ts/examples/ — 7+ 脚本
- ../ddcc/ — 上一轮实验 (验证可行性)
生成时间: 2026-06-12 作者: Claude (M3) + 用户 核心目标: 74 张官方示例 API 0 错 + 浏览器 0 视觉差
Languages
TypeScript
99.4%
Shell
0.4%
Python
0.2%