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

4.3 KiB

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 同步 (非阻塞)

  1. 行 14 dacli form codegen --ai-help 链接: 确认这是 dacli 全局 ai-help 参数 (Picocli 自动生成)
  2. 行 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 全部产出