Files
dacli/docs/skill-audit/api-test.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

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 测试)

  1. 加 dacli log exception/request 章节 (L84 后, API 调试核心)
  2. 加 dacli form update 章节 (L218 后, 改 form schema 必用)
  3. 加 dacli workflow info/update/delete 章节 (L229 后, 流程 CRUD 闭环)
  4. 加 dacli di info/test/update/delete 章节 (L80 后, DI 闭环)
  5. 加 v0.11+ webapi 架构段 (L8 后)

5.2 P1 (同步, 提升 API 测试效率)

  1. 加 dacli apis search --field= 段 (全文, 字段级搜索)
  2. 加 dacli apis tags 段 (全文, 查 API 标签)
  3. 加 dacli role info/update/selector 段 (全文, 权限 API 测试)
  4. 加 dacli menu info/delete 段 (L82 后, 菜单 CRUD)

5.3 P2 (增强, 按需补)

  1. 加 dacli monitor server 段 (全文, 性能监控 API)
  2. 加 dacli user create/delete 段 (L83 后, 用户 CRUD)
  3. 加 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 主代理执行时同步修复