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 文案变更)
8.2 KiB
8.2 KiB
Skill Audit: api-test
审计目标: /home/ubuntu/ccWorkDir/.claude/skills/api-test/SKILL.md
审计时间: 2026-06-25
审计者: .claude/ skill 审计子代理 (Batch H)
对照基准: dacli v0.11+ 已重构命令 + 30+ NEW-CMD (见 v0.11-next-steps-plan.md §11.4)
1. 技能定位
JNPF API 集成测试 - curl + jq 调 JNPF 后端, dacli 提供登录态和业务命令封装
2. 命令引用清单 (按行号)
| 行号 | 命令 | 上下文 | 状态 |
|---|---|---|---|
| 20 | dacli app login --account=admin --password=123456 --appCode=tds |
登录 | ✅ 有效 |
| 21 | dacli app status |
查登录态 | ✅ 有效 |
| 34-35 | jq -r .token/.appCode $ccWorkDir/.dacli-token/token.json |
读 token | ✅ 有效 |
| 38-40 | curl ... -H "App-Code: ..." -H "Authorization: ..." |
调 API | ✅ 有效 |
| 47-67 | curl -X POST/PUT/DELETE |
CRUD 测试 | ✅ 有效 |
| 78 | dacli form list |
等价于 dacli test list |
✅ 有效 |
| 79 | dacli form info <id> (位置参数) |
查表单 | ✅ 有效 |
| 80 | dacli form create --fullName=... --enCode=... --type=... |
创建表单 | ✅ 有效 |
| 81-84 | dacli form list / dacli menu list / dacli user list / dacli tool logs |
业务命令 | ✅ 有效 |
| 93-110 | curl + jq 提取字段 |
通用模式 | ✅ 有效 |
| 120-128 | dacli form create + curl 验证 |
组合模式 | ✅ 有效 |
| 131-141 | bash 循环测 |
脚本模式 | ✅ 有效 |
| 146-153 | curl + 状态码检测 |
token 过期检测 | ✅ 有效 |
| 152 | dacli app login --account=admin --password=<密码> --appCode=$APP_CODE |
重新登录 | ✅ 有效 |
| 162-163 | playwright -s=dacli open/eval |
UI 测试 | ✅ 有效 |
| 166-168 | curl 验证数据 |
API 验证 | ✅ 有效 |
| 177-179 | dacli app login --account=admin --password=123456 --appCode=tds |
登录 | ✅ 有效 |
| 186-188 | curl 检查登录态 |
检查模式 | ✅ 有效 |
| 204-224 | 完整 CRUD 流程 | 端到端示例 | ✅ 有效 |
| 210 | dacli form info <form_id> |
查表单 | ✅ 有效 |
| 213-216 | dacli form create --fullName=... --enCode=test_form --type=1 --webType=2 |
创建表单 | ✅ 有效 |
| 218 | dacli form release <form_id> |
发布表单 | ✅ 有效 |
| 221-224 | curl 验证 |
API 验证 | ✅ 有效 |
| 229-231 | dacli workflow list/launch |
工作流测试 | ✅ 有效 |
命令总数: 30+ 处 dacli + curl 引用
3. v0.11+ 已重构命令引用检测
3.1 已重构/已 webapi 化命令
| 命令 | 当前引用 | 实际状态 (v0.11+) | 影响 |
|---|---|---|---|
dacli app login |
L20, L152, L179 | v0.11+ 仍有效 | 无影响 |
dacli app status |
L21 | v0.11+ 仍有效 | 无影响 |
dacli form list |
L78, L81, L207 | v0.11+ webapi 化 | 无影响 |
dacli form info |
L79, L210 | v0.11+ webapi 化 | ✅ 已用位置参数 |
dacli form create |
L80, L120, L213 | v0.11+ webapi 化 (c98bf2b) |
无影响 |
dacli form release |
L218 | v0.11+ webapi 化 | 无影响 |
dacli menu list |
L82 | v0.11+ webapi 化 (c7b24eb) |
无影响 |
dacli user list |
L83 | v0.11+ webapi 化 (7224156) |
✅ 标注 v0.7+ |
dacli tool logs |
L84 | v0.11+ 仍有效 | 无影响 |
dacli workflow list |
L229 | v0.11+ webapi 化 (5ec47e3+4669e35) | 无影响 |
dacli workflow launch |
L231 | v0.11+ 仍有效 | 无影响 |
3.2 旧端点引用
未发现旧端点引用 (所有命令已 webapi 化或仍有效)
3.3 已废弃命令引用
未发现已 @deprecated 命令引用 (L8 已明确移除 dacli test 旧命令, ✅)
3.4 旧端点 + 旧模式引用
| 引用 | 状态 | 备注 |
|---|---|---|
| L8 标注 "dacli test" 已废弃 | ✅ 已标注 | 正确反映 v0.11+ 状态 |
| L78-84 表格 (旧 dacli test → 新写法) | ✅ 已同步 | 表格已完整映射 |
4. 缺 NEW-CMD 章节
4.1 严重缺失的 v0.11+ 新命令 (P0)
| 缺失命令 | 应在位置 | 缺失原因 |
|---|---|---|
dacli form update |
L218 后 (form release 之后) | API 测试时改 form schema 必用 |
dacli log exception |
L84 后 (tool logs 之后) | API 调试必看后端异常 |
dacli log request |
同上 | API 请求日志 |
dacli workflow info/update/delete |
L229 后 | 工作流 CRUD 闭环 |
dacli di info/test/update/delete |
全文未提 | 数据接口 CRUD 闭环 |
dacli role info/update/selector |
全文未提 | 权限相关 API 测试 |
| `dacli menu info/delete | L82 后 | 菜单管理 |
dacli apis tags |
全文未提 | 查 API 标签 |
dacli apis search --field= |
全文未提 | 字段级搜索 |
dacli monitor server |
全文未提 | 性能监控 API |
4.2 缺 v0.11+ 架构说明章节
应在 L8 后加 1 段:
> 📦 **dacli v0.11+ webapi 镜像架构 (2026-06-25)**:所有 form/menu/dict/dm/role/log/monitor/schedule/msg/di/workflow/user 命令已 webapi 化 (18 模块, 100+ 函数), 0 复刻 0 漂移。API 测试时优先用 dacli 业务命令, 必要时辅以 curl + jq 验证返回结构。
5. 优先级修复清单
5.1 P0 (必修, 阻塞 API 测试)
- 加
dacli log exception/request章节 (L84 后, API 调试核心) - 加
dacli form update章节 (L218 后, 改 form schema 必用) - 加
dacli workflow info/update/delete章节 (L229 后, 流程 CRUD 闭环) - 加
dacli di info/test/update/delete章节 (L80 后, DI 闭环) - 加 v0.11+ webapi 架构段 (L8 后)
5.2 P1 (同步, 提升 API 测试效率)
- 加
dacli apis search --field=段 (全文, 字段级搜索) - 加
dacli apis tags段 (全文, 查 API 标签) - 加
dacli role info/update/selector段 (全文, 权限 API 测试) - 加
dacli menu info/delete段 (L82 后, 菜单 CRUD)
5.3 P2 (增强, 按需补)
- 加
dacli monitor server段 (全文, 性能监控 API) - 加
dacli user create/delete段 (L83 后, 用户 CRUD) - 加
dacli doc toc/search段 (全文, 文档搜索)
6. 具体修复建议 (示例)
6.1 L84 后加 log exception 段 (P0)
# v0.11+ 新增 (P0 必读): 后端异常日志 (API 调试核心)
dacli log exception --lines=20
dacli log exception --keyword="<form_id_or_api_path>" # 按关键字过滤
dacli log request --lines=10 # API 请求日志
6.2 L218 后加 form update 段 (P0)
# v0.11+ form 改名 / 增量改 schema (无需 export→改→import)
dacli form update <form_id> --fullName="新名"
dacli form update <form_id> --enCode="new_code" --autoRelease
6.3 L229 后加 workflow info/update/delete 段 (P0)
# v0.11+ workflow CRUD 闭环
dacli workflow info <flow_id> # 查详情
dacli workflow update <flow_id> --fullName="新名" # 改名
dacli workflow delete <flow_id> --yes # 删
6.4 L8 后加 v0.11+ 架构段 (P0)
> 📦 **dacli v0.11+ webapi 镜像架构 (2026-06-25)**:所有 form/menu/dict/dm/role/log/monitor/schedule/msg/di/workflow/user 命令已 webapi 化 (18 模块, 100+ 函数), 0 复刻 0 漂移。API 测试时优先用 dacli 业务命令, 必要时辅以 curl + jq 验证返回结构。L1+L2 防御已覆盖 22 条高频盲点。
6.5 扩展 L78-84 表格 (P1)
加以下行:
旧 dacli test ... |
新写法 |
|---|---|
dacli test workflow list |
dacli workflow list |
dacli test di info |
dacli di info <id> (v0.11+ 新增) |
dacli test di test |
dacli di test <id> --params='...' (v0.11+ 新增) |
dacli test log exception |
dacli log exception (v0.11+ 新增) |
7. 整体评价
健康度: 中等偏高
- 30+ 处 dacli + curl 引用, 模式清晰
- L8 已正确标注 v0.11+ 变更 (移除
dacli test) - L78-84 表格已正确映射旧→新命令
- 缺 10+ 个 v0.11+ 新命令 (P0 缺失较多)
- 缺 v0.11+ webapi 架构说明
- 位置参数已用
<id>而非--id=(✅) - 未引用已废弃命令 (✅)
- 未引用旧端点 (✅)
修复预计工作量: 1-1.5 小时
- P0 必修 5 项: 1 小时
- P1 同步 4 项: 20 分钟
- P2 增强 3 项: 10 分钟
建议: 标记为 P0 必修, 在 Phase 3 Batch H 主代理执行时同步修复