auto(9ffa0cdb9ebf): session end @ 2026-06-21T17:53:52 (+1f)

This commit is contained in:
ssw committed 2026-06-21 17:53:53 +08:00
1 parent 25dcb66c39
commit fc8f218061
1 file changed
+77 -34
+77 -34
View File
@@ -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=<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=<form-id> --urlAddress="model/leave" --webType=2 \
--linkTarget=_self --parentId=0 \
--isButtonAuthorize=1 --isColumnAuthorize=1 \
--isFormAuthorize=1 --isDataAuthorize=1
dacli menu create --fullName="请假菜单" --enCode=leaveMenu \
--parentId=<DIR_ID> --formId=<FORM_ID>
# 自动: category=Web, linkTarget=_self, 4 authorize=1, propertyJson.moduleId=FORM_ID
```
### 2.3 `dacli menu update <id>`
**例** (低级 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>`
| 参数 | 必填 | 说明 |
|------|------|------|
| `--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=<DIR_ID> --cascade --yes # 递归
dacli menu delete --id=X --fallback --yes # DELETE 兜底
```
### 2.5 `dacli menu unrelease --formId=<FORM_ID>`
走 web Actions/Module 真路径, 设 `pc=0, app=0, platformRelease='{"pc":0,"app":0}'` 取消 form 挂载状态. **不删菜单实体** (跟 delete 区别).
### 2.6 `dacli menu releases --formId=<FORM_ID>` (v0.7+ 新增)
查某 form 已挂的菜单 (pc + app 各 1 个). 走 web `getReleaseMenu` 端点. 用于诊断"form 是否真挂上了"和配合 purge.
### 2.7 `dacli menu purge --formId=<FORM_ID> --yes [--unrelease]` (v0.7+ 新增)
按 formId 一次清全部挂载: PC 菜单 + APP 菜单 (+ 可选 unrelease form 关联). 走 `getReleaseMenu` → 解析 pcReleaseId/appReleaseId → DELETE 循环. 适合"form 删除前标准清理流程".
---