# 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 ` | ⚠️ 需标注 @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 ` 已标记 @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=` 缺失: codegen 失败时定位 - `dacli apis search --field=` 缺失: 查 ssw-{app_code} 业务 API 字段 (PascalCase 实体类) ## 4. 优先级修复清单 ### P0 必修 (主流程命令) 1. **行 56**: `dacli form validate ` 标注 @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 全部产出