# 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 ` → `dacli form import` → 重建后**结构 0 差** - ✅ Playwright 打开原版与复刻版,**截图视觉 0 差** - ✅ 所有字段、按钮、列表列正确渲染 - ✅ 表单可正常提交、菜单可正常跳转、工作流可正常发起 ## 快速开始 ```bash cd $ccWorkDir/dacli npm install # 装依赖 npx playwright install chromium # 装浏览器 (baseline 验证用) node scripts/extract-all.mjs # 提取 web 源码到 data/*.json npx tsx src/cli.ts login --appCode=tds # 登录 tds npx tsx src/cli.ts form list # 列已有表单 ``` ## 跑 baseline 一键回归 ```bash # 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/ # 嵌套子命令 │ ├── core/ # 基础设施 │ ├── extractors/ # web 源码提取 │ ├── data/ # 提取 JSON │ └── schema/ # FieldBuilder │ ├── .claude/skills/dacli-ts/ # ⭐ AI 专用 skill │ ├── SKILL.md # 主入口 │ ├── references/ # 6+ 文档 │ └── examples/ # 7+ 可复用脚本 │ ├── 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/ # extract-all / verify-baseline └── .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](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](prompt.md) — 完整任务说明书 - [doc/architecture.md](doc/architecture.md) — 设计决策 - [doc/plan.md](doc/plan.md) — 6 周路线 - [doc/baseline.md](doc/baseline.md) — 0 差错验证 - [doc/api.md](doc/api.md) — 完整 API - [doc/extractors.md](doc/extractors.md) — 提取工具 - [doc/help-system.md](doc/help-system.md) — 帮助体系 - [.claude/skills/dacli-ts/SKILL.md](.claude/skills/dacli-ts/SKILL.md) — AI 技能主入口 - [.claude/skills/dacli-ts/references/](.claude/skills/dacli-ts/references/) — 6+ 文档 - [.claude/skills/dacli-ts/examples/](.claude/skills/dacli-ts/examples/) — 7+ 脚本 - [../ddcc/](../ddcc/) — 上一轮实验 (验证可行性) --- **生成时间**: 2026-06-12 **作者**: Claude (M3) + 用户 **核心目标**: **74 张官方示例 API 0 错 + 浏览器 0 视觉差**