Files
dacli/docs/skill-audit/code-generator.md
T
ssw d99ed45585 fix(v0.11+) Phase 5: 修 TS 类型错误 + Phase 3 Batch G-J skill audit (26 文件)
TS 修复 (3 个文件):
- src/commands/dm/create.ts:151 - r 类型加 data?: unknown (createDataModel 响应含 data)
- src/commands/form/selector.ts:91 - note (单数) → notes (AiHelp type)
- src/commands/user/list.ts:46 - 完整 UserResponse 类型 (含 list + data.list + code + msg)

验证: npx tsc --noEmit 0 error (src/), vitest 282/289 PASS (7 fail 为 ai-help 文案变更,非回归).

Phase 3 Batch G-J skill audit 产出 26 个 audit 文件:
- Batch G (5): workflow-development / menu-configuration / data-interface (严重过时) / data-management / data-screen
- Batch H (5): troubleshooting / ssw-test / no-spa-page / backend-dev / api-test
- Batch I (5): code-generator / frontend-dev / jnpf-browser-automation / platform-mechanism / mmx-cli
- Batch J (6): ssw-pack-init / ssw-e2e-test / webapp-testing (0 改动) / basic-standards / CLAUDE.md-audit / dacli-ts-update
- Batch F (5, 上轮): dacli-ts / ssw-h5dev-flow / design-jnpf-execute / form-development / form-fix

关键发现:
- data-interface ⚠️ 严重过时: 仍标 'di create/preview TS 版未实现' (错误, 已 webapi 化)
- data-screen ⚠️ 缺 v2 修正: bigscreen/report 是独立子项目
- 父 CLAUDE.md 缺 v0.11+ 完整段 (~30 行: 18 webapi + 30+ NEW-CMD + 3 端点修复 + 已删文件)

baseline 验收 (Phase 5):
- SKIP_PLAYWRIGHT=1 全跑 (728s): 54 PASS / 8 FAIL / 24 SKIP
- 8 fail 均为 form schema 真实问题 (按钮栏缺), 非 dacli regression
- vitest 282/289 PASS (7 fail 为 ai-help 文案变更)
2026-06-25 16:38:18 +08:00

81 lines
4.3 KiB
Markdown

# code-generator SKILL.md 审计报告 (2026-06-25)
> **审计依据**: v0.11+ dacli webapi 镜像 18 模块 + 30+ NEW-CMD (form codegen 已 webapi 化 commit `938c31d`)
## 1. 命令引用清单 (skill 中所有 dacli 调用)
| 行号 | 命令 | 状态 | 备注 |
|------|------|------|------|
| 3 | `dacli form codegen (v0.11+)` | ✅ 有效 | 已 webapi 化 (commit `938c31d`) |
| 14 | `dacli form codegen --ai-help` | ⚠️ 待确认 | `--ai-help` 是 dacli 全局 ai 帮助参数 |
| 21 | `dacli form create` (发布 state=1) | ✅ 有效 | |
| 28-34 | `dacli form codegen` 完整参数 | ✅ 有效 | `--auto-alias` 默认 ON, `--mainClassName` 自动推导 |
| 39 | `dacli form codegen 808986025610185477 --module=tds` | ✅ 有效 | |
| 42 | `dacli form codegen 839112829108748357 --module=jxcj --mainClassName=DevelopProject` | ✅ 有效 | |
| 45 | `dacli form codegen ... --no-web --no-uniapp` | ✅ 有效 | |
| 48-50 | `for FID in $(dacli form list --json \| jq -r '.[].id'); do dacli form codegen $FID --module=jxcj; done` | ⚠️ 需补 form update | 批量场景应补 `dacli form update` 增量改 schema |
| 55 | `dacli form list` (看 STATE 字段) | ✅ 有效 | |
| 56 | `dacli form validate <id>` | ⚠️ 需标注 @deprecated | webapi 化后已自动保证 schema 完整性, 此命令标记 @deprecated |
| 154 | `--no-auto-alias` 关闭别名 | ✅ 有效 | |
| 155 | `dacli dm create --table=jxcj_xxx` (自动去前缀) | ✅ 有效 | |
| 159 | `dacli app login` | ✅ 有效 | |
## 2. v0.11+ 已重构/已删命令引用检测
### ✅ form codegen 已 webapi 化 (commit `938c31d`)
- skill 标题与内容已明确标注 v0.11+, 一致性良好
- PascalCase 化: `--auto-alias` 默认 ON + 默认从 enCode 推导 mainClassName
- per-model web/uniapp 输出 (`$CCWORKDIR/{web,uniapp}/.../ssw/{appCode}/{ModelName}/`)
### ✅ ssw-common 共享 MapperConfig (BS-14 集中化)
- 行 108-128 详细说明了 `SswMapperConfig` + `ssw-common-biz` 依赖
- 业务包零 MapperConfig 配置
### ⚠️ form validate 仍引用 (行 56)
- `dacli form validate <id>` 已标记 @deprecated (v0.11+ webapi 镜像已自动保证 schema 完整性)
- skill 应标注 "已 deprecated, 可选保留作为运行时校验"
### ⚠️ 缺 form update NEW-CMD 提示
- v0.11+ 新增 `dacli form update` (commit `801a204`), 用于增量改 schema
- code-generator 场景 (form 已建 → codegen 前) 可用 `form update` 调整
## 3. 缺 NEW-CMD 章节 (对照 §11.4 NEW-CMD 完成清单)
| 父命令 | 缺 | 关联场景 | commit |
|--------|-----|----------|--------|
| form | `form update` | 批量 codegen 前调整 schema | `801a204` |
| log | `log exception` | codegen 失败时调试 | `59a6b4a` |
| apis | `apis search --field=` | 查 ssw-{app} API 字段 | `7b8f9b1` |
| doc | `doc toc`, `doc search` | 查 ssw-{app_code}/docs/ | `5f663eb` |
**重点**:
- `dacli form update` 缺失: code-generator 批量场景需要 (e.g. 28 form 批量 codegen 前先 update 字段)
- `dacli log exception --keyword=<formId>` 缺失: codegen 失败时定位
- `dacli apis search --field=` 缺失: 查 ssw-{app_code} 业务 API 字段 (PascalCase 实体类)
## 4. 优先级修复清单
### P0 必修 (主流程命令)
1. **行 56**: `dacli form validate <id>` 标注 @deprecated 提示
- 添加注释: "v0.11+ webapi 镜像已自动保证 schema 完整性, 此命令标记 @deprecated"
2. **行 48-50** 批量 codegen 场景: 补 `dacli form update` 用法
- 场景: 28 form 批量前先 update 调整字段
- 建议加 1 段 "批量 codegen 前 update 流程"
3. **顶部 v0.11+ 段**: 补 "v0.11+ Phase 2 完成 30+ NEW-CMD" 链接
- `dacli form update` (commit `801a204`) 是高需求命令
- codegen 失败时 `dacli log exception` 调试
### P1 同步 (非阻塞)
4. **行 14** `dacli form codegen --ai-help` 链接: 确认这是 dacli 全局 ai-help 参数 (Picocli 自动生成)
5. **行 154** `--no-auto-alias` 应补充: "v0.11+ 默认 ON, 关闭后类名带 appCode 前缀"
### P2 仅检查 (无变化)
- PascalCase 化 + ssw-common MapperConfig 段已完善, 无需修改
- per-model web/uniapp 输出路径已准确
## 5. 总结
- **现状**: code-generator 是 v0.11+ 标杆 skill, 准确反映 webapi 化 + PascalCase 化
- **P0 必修 3 项**: form validate deprecation 标注 + form update 补段 + NEW-CMD 链接
- **影响范围**: 修 3 处即可对齐 v0.11+ Phase 2 全部产出