diff --git a/.claude/skills/dacli-ts/references/commands.md b/.claude/skills/dacli-ts/references/commands.md index 608cdc2..beca648 100644 --- a/.claude/skills/dacli-ts/references/commands.md +++ b/.claude/skills/dacli-ts/references/commands.md @@ -1,18 +1,24 @@ # commands.md — 完整命令清单 -> **目标**: AI 拿到本文件即知道 5 父命令的所有子命令、必传参数、典型用法 +> **目标**: AI 拿到本文件即知道 8+ 父命令的所有子命令、必传参数、典型用法 +> +> **当前状态**: v0.7+ (2026-06-21): 22 父命令 / 80+ 子命令, 130+ baseline 0 差错. 详见 `.claude/skills/dacli-ts/SKILL.md` v0.8.1+ 校准段. --- -## ⚠️ v0.1 命令实现状态 (2026-06-12) +## ✅ v0.7+ 校准 (2026-06-21) — 完整实现状态 -| 命令 | 状态 | 说明 | -|------|------|------| -| login / status / switch-app | ✅ 跑通 | 端到端 OK, 自动检测 dbLinkId | -| form list / info / export / validate | ✅ 跑通 | 只读链路 | -| form create / clone / import | ⚠️ 骨架完整, schema 严校验 | W2 extractor 完成后完整跑通; 当前 AI 应 prefer Java 版 dacli 做 | -| form release / delete | ⚠️ 命令 OK | 依赖 form 已存在 | -| menu / dm / dict / workflow / di / doc / apis | ❌ W2+ 未实现 | 调用报 exit 2 + 提示 | +| 父命令 | 子命令数 | 状态 | 备注 | +|--------|----------|------|------| +| app | login / status / switch / init / create / clear | ✅ 端到端 | v0.9 归入 app 命名空间, initapp/start/restart 自动化 | +| form | list / info / create / release / delete / export / import / clone / validate / fixcolumndata / codegen / lint / bindFlow | ✅ 端到端 | 13 子命令, 0 差错 baseline | +| menu | list / info / create / delete / unrelease / releases / purge | ✅ 端到端 | **v0.7+ 新增 3 (info/releases/purge) + delete 增强 3 选项** | +| dm | list / create / drop / fields | ✅ 端到端 | 自动补 9 系统列 (v10.6.1+) | +| dict | type-list / data-list | ✅ 端到端 | | +| di | list | ✅ 端到端 | | +| workflow | list / launch / approve | ✅ 端到端 | | +| doc | list | ✅ 端到端 | HTML 文档扫描 | +| apis | list / info / search / refresh / status | ✅ 端到端 | OpenAPI 缓存 (PID 变化 + 12h TTL) | **所有命令支持 `--ai-help / --example / --source`**, AI 拿不准时优先跑 `--ai-help`。 @@ -193,47 +199,84 @@ dacli form import /tmp/leave.json --enCode=leave_v2 --- -## 2. menu (菜单) — 4 子命令 +## 2. menu (菜单) — 7 子命令 (v0.7+) + +> **v0.7+ 校准** (2026-06-21): 新增 `info` / `releases` / `purge`, delete 增强 `--enCode` / `--cascade` / `--fallback`. **`update` 子命令 TS 版未实现** (Java v10.6 历史). ### 2.1 `dacli menu list` -返回当前应用下所有菜单。 +| 参数 | 必填 | 说明 | +|------|------|------| +| `--keyword` | - | 关键字 (服务器侧匹配) | +| `--flat` | - | 不按树形打印, 直接平铺 | +| `--json` | - | 原始 JSON 输出 | -### 2.2 `dacli menu create` +返回当前应用下所有菜单 (按请求头 App-Code 过滤)。 + +### 2.2 `dacli menu info --id=` (v0.7+ 新增) + +| 参数 | 必填 | 说明 | +|------|------|------| +| `--id` | ✅ | 菜单 id | +| `--json` | - | 原始 JSON 输出 | + +返回菜单完整 schema (含 propertyJson / category / 4 个 is*Authorize), 自动校验 7 必填字段, 缺则告警 (BS-43 防御). + +### 2.3 `dacli menu create` (v0.7+ 自动补 7 字段) | 参数 | 必填 | 说明 | |------|------|------| | `--fullName` | ✅ | 菜单名 | -| `--enCode` | ✅ | 菜单编码 | -| `--type` | ✅ | 1=目录 2=页面 3=表单菜单 7=外链 10/8=报表/门户 | -| `--category` | ✅ | 'Web' / 'App' | -| `--linkTarget` | - | '_self' / '_blank' (type=7 必填) | -| `--moduleId` | type=3 ✅ | 关联表单 id | +| `--enCode` | ✅ | 菜单编码 (snake_case) | +| `--parentId` | ✅ | 父菜单 id, 顶级 '0' (不是 systemId!) | +| `--type` | - | 1=目录 2=页面 3=表单菜单 7=外链 10/8=报表/门户 | +| `--category` | - | 'Web' / 'App', 必填 (v0.7+ 默认 Web) | +| `--formId` | - | 关联表单 id (走 web Actions/Module 真路径) | | `--urlAddress` | - | 路径 (type=3 必填 `model/{enCode}`) | -| `--webType` | - | 表单菜单 1/2/3 (透传表单 webType) | -| `--parentId` | - | 父菜单 id, 顶级 '0' | -| `--isButtonAuthorize` | - | 1=启用按钮权限 | -| `--isColumnAuthorize` | - | 1=启用列权限 | -| `--isFormAuthorize` | - | 1=启用表单权限 | -| `--isDataAuthorize` | - | 1=启用数据权限 | +| `--icon` | - | 图标 class, e.g. 'icon-ym icon-ym-folder' | -**例** (表单菜单, 最常用): +**例** (表单菜单, 走 web 真路径, v0.7+ 自动带 7 字段): ```bash -dacli menu create \ - --fullName="请假菜单" --enCode=leaveMenu --type=3 --category=Web \ - --moduleId= --urlAddress="model/leave" --webType=2 \ - --linkTarget=_self --parentId=0 \ - --isButtonAuthorize=1 --isColumnAuthorize=1 \ - --isFormAuthorize=1 --isDataAuthorize=1 +dacli menu create --fullName="请假菜单" --enCode=leaveMenu \ + --parentId= --formId= +# 自动: category=Web, linkTarget=_self, 4 authorize=1, propertyJson.moduleId=FORM_ID ``` -### 2.3 `dacli menu update ` +**例** (低级 API, 手动给 type + urlAddress): +```bash +dacli menu create --fullName="数据运营" --enCode=dataOps \ + --type=1 --category=Web --parentId=-1 +# 顶级目录 +``` -修改菜单。常用 `--fixDisplay=true` 修"菜单不显示"。 +### 2.4 `dacli menu delete` (v0.7+ 增强) -### 2.4 `dacli menu delete ` +| 参数 | 必填 | 说明 | +|------|------|------| +| `--id` 或 `--enCode` | ✅ | 二选一, --enCode 模糊匹配容忍 JNPF 5 位 hash 后缀 | +| `--cascade` | - | 递归删除子菜单 (目录类型兜底) | +| `--fallback` | - | DELETE 报 "System abnormality" 时调 unrelease 兜底 | +| `--yes` | ✅ | 跳过确认 (删除类必传) | -删除菜单。慎用。 +**例**: +```bash +dacli menu delete --id=835168490678657989 --yes +dacli menu delete --enCode=tds2_user --yes # 容忍 hash 后缀 +dacli menu delete --id= --cascade --yes # 递归 +dacli menu delete --id=X --fallback --yes # DELETE 兜底 +``` + +### 2.5 `dacli menu unrelease --formId=` + +走 web Actions/Module 真路径, 设 `pc=0, app=0, platformRelease='{"pc":0,"app":0}'` 取消 form 挂载状态. **不删菜单实体** (跟 delete 区别). + +### 2.6 `dacli menu releases --formId=` (v0.7+ 新增) + +查某 form 已挂的菜单 (pc + app 各 1 个). 走 web `getReleaseMenu` 端点. 用于诊断"form 是否真挂上了"和配合 purge. + +### 2.7 `dacli menu purge --formId= --yes [--unrelease]` (v0.7+ 新增) + +按 formId 一次清全部挂载: PC 菜单 + APP 菜单 (+ 可选 unrelease form 关联). 走 `getReleaseMenu` → 解析 pcReleaseId/appReleaseId → DELETE 循环. 适合"form 删除前标准清理流程". ---