From e984111aa71a7056eba6029646844ddab7dd961d Mon Sep 17 00:00:00 2001 From: ssw Date: Sun, 21 Jun 2026 18:17:48 +0800 Subject: [PATCH] =?UTF-8?q?skills:=20workflow/di/apis/doc/portal/bigscreen?= =?UTF-8?q?/codegen=20=E5=91=BD=E4=BB=A4=E6=A0=A1=E5=87=86=E5=88=B0=20v0.7?= =?UTF-8?q?+=20=E5=AE=9E=E9=99=85=20(=E7=AC=AC=202=20=E8=BD=AE=20-=20.clau?= =?UTF-8?q?de=20=E9=83=A8=E5=88=86)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit dacli-ts skill 是 symlink → ../../dacli/.claude/skills/dacli-ts, 在 dacli 仓库单独 commit. 修复 (9 文件): - skills/workflow-development/SKILL.md (frontmatter + 6 子命令 → 5): - 删 reject / pending, 改 --status=1 / --todo=1 - workflow create 加 --flowXml 必传 + --ai - launch 加 --formId 必传 - approve 改 --operatorId + --status (0/1/2 同意/不同意/退回) - 加 decision 5.6.5 段 - skills/data-interface/SKILL.md (3 → 1 子命令): 删 di create/preview, Python 兜底 - skills/data-screen/SKILL.md: portal/bigscreen 拆独立命令, 加 info/release - skills/ssw-pack-init/SKILL.md: 顶层 dacli codegen → dacli form codegen - skills/data-management/SKILL.md: di create 改 'TS 只读 + 兜底' - skills/api-test/SKILL.md: workflow pending → --todo=1 - skills/form-development/SKILL.md: workflow create 顺序加 v0.7+ 校准 - CLAUDE.md: apis 5 段示例 + doc 5 段示例 全删, 改 list + 警告段 - hooks/skill-matcher.js: 'dacli di create/list/preview' → 'TS 只读, 走 JNPF 后台 + Python 兜底' 剩余'旧命令'引用全在 ❌ TS 版不支持 警告段, 保留作为防御文档. Co-Authored-By: Claude --- CLAUDE.md | 40 ++++------------ hooks/skill-matcher.js | 2 +- skills/api-test/SKILL.md | 8 ++-- skills/data-interface/SKILL.md | 49 ++++++++++--------- skills/data-management/SKILL.md | 2 +- skills/data-screen/SKILL.md | 45 ++++++++++++------ skills/form-development/SKILL.md | 2 +- skills/ssw-pack-init/SKILL.md | 10 ++-- skills/workflow-development/SKILL.md | 71 ++++++++++++++++------------ 9 files changed, 124 insertions(+), 105 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 16cf1ea..46539ef 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -41,9 +41,9 @@ > > **嵌套类重构 (2026-06-05)**:所有父命令(form/role/datasource/org/dict/user/file/menu/workflow/di/dm/portal/report)的子命令合并为 `static nested class`,文件数大幅减少。详见 `docs/dacli/h5doc-plan.md` Phase 0。 > -> **dacli doc 新增 (2026-06-05)**:HTML 文档缓存子命令(`dacli doc list/get/scan/refresh/clear`),AI 读取 plan.html 等 token 降低 80%。详见 `.claude/skills/dacli-doc-cache/SKILL.md`。 +> **dacli doc (v0.7+)**: HTML 文档扫描, **仅 1 子命令** `list` (TS 版无 get/scan/refresh/clear). AI 读取 plan.html 走 `Read` 工具直接读 HTML 文件, 或 `python3 -c "import re; print(re.sub('<[^>]+>',' ',open('docs/{app}/plan.html').read()))"`. 详见 `.claude/skills/dacli-ts/SKILL.md`. > -> **dacli apis 新增 (2026-06-05)**:JNPF Swagger/OpenAPI 查询(`dacli apis list/info/search/refresh/status`),从 `/v3/api-docs` 拉取 1000+ API 写本地缓存(PID 变化 + 12h TTL 自动失效)。详见 `.claude/skills/dacli-architecture/SKILL.md`。 +> **dacli apis (v0.7+)**: JNPF Swagger/OpenAPI 查询, **仅 1 子命令** `list` (TS 版无 info/search/refresh/status). 写本地缓存 (PID 变化 + 12h TTL 自动失效). 详见 `.claude/skills/dacli-architecture/SKILL.md`. > > **架构演进 (2026-06-06)**:1) **Redis → SQLite 迁移**(`SqliteCacheService` 替代 `RedisCacheService`,缓存文件 `~/.dacli/cache.db`,无需外部 Redis 容器);2) **GraalVM Native 编译**(启动 800ms→100ms,输出 `target/dacli` 原生二进制);3) **dacli tool codegraph 新增**(基于 `codegraph.db` 静态分析 JNPF 源码,7 子命令:search/calls/trace/impact/contains/implements/route)。 > @@ -79,30 +79,20 @@ dacli form import --enCode=X --name=Y # 导入表单 (从备份恢复) dacli menu list dacli tool logs --level=error --lines=50 dacli apis list --tag=visualdev # 查 JNPF API 列表 -dacli apis info "GET /api/visualdev/Base/list" # 查 API 中文字段 +dacli apis info "GET /api/visualdev/Base/list" # 查 API 中文字段 (v0.7+ ❌ TS 版无, 改用 list --keyword 过滤) dacli tool codegraph search "UserController" -k class # 查 JNPF 源码 dacli tool codegraph trace "X::Controller::a" "Y::Service::b" # 跟调用链 dacli app clear --app-code=tds --dry-run # 清除应用 (备份→history_bak 库; 实跑需 TTY+双重确认) dacli help ``` -### dacli doc 命令(HTML 文档缓存,AI 读取 token 降低 80%) +### dacli doc 命令(HTML 文档扫描, v0.7+ 仅 1 子命令) ```bash -# 列文档索引(结构 + section 列表) +# 列文档索引(结构 + section 列表, v0.7+ 唯一子命令) dacli doc list --dir=docs/tds - -# 读取章节纯文本(核心命令) -dacli doc get --file=docs/tds/plan.html -dacli doc get --file=docs/tds/design.html --section=arch -dacli doc get --file=docs/tds/plan.html --from=10 --lines=50 - -# 扫描建索引(自动触发,无需手动) -dacli doc scan --dir=docs/tds - -# 强制刷新 / 清除缓存 -dacli doc refresh --dir=docs/tds -dacli doc clear --file=docs/tds/plan.html +# ❌ TS 版 v0.7+ 无 dacli doc get / scan / refresh / clear +# 真替代: 用 Read 工具直接读 HTML, 或 python3 抽纯文本 ``` **适用场景**:上下文恢复时读取 plan.html/design.html/testcase.html,替代直接 `Read` 整个 HTML。 @@ -113,21 +103,11 @@ dacli doc clear --file=docs/tds/plan.html 从 JNPF `/v3/api-docs` 拉取全量 OpenAPI(含 1000+ API + 1159 个 schema),写本地缓存(PID 变化或 12h TTL 自动失效),AI 一次性掌握 JNPF 平台所有 API 拓扑。 ```bash -# 列出接口(按 tag/method/keyword 过滤) +# 列出接口(按 tag/method/keyword 过滤, v0.7+ 唯一子命令) dacli apis list --tag=visualdev dacli apis list --method=GET --keyword=用户 - -# 查单个 API 详情(参数/响应/中文字段) -dacli apis info "GET /api/visualdev/Base/list" -dacli apis info "POST /api/permission/Users" -# 输出含 resolvedSchemas: {requestBody: {schemaName, definition(中文字段)}, responses: {200: {data: {...}}}} - -# 关键字搜索 -dacli apis search "登录" - -# 缓存状态 / 强制刷新 -dacli apis status -dacli apis refresh +# ❌ TS 版 v0.7+ 无 dacli apis info / search / refresh / status +# 真替代: 拿全列表后用 jq/python 过滤 ``` **适用场景**:写后端 / 调 API / 排查接口字段时直接查,避免手敲 curl 试探。 diff --git a/hooks/skill-matcher.js b/hooks/skill-matcher.js index a9b4e96..b9dd2a7 100644 --- a/hooks/skill-matcher.js +++ b/hooks/skill-matcher.js @@ -57,7 +57,7 @@ const ironLawTriggers = [ /\bsqlite\b.*select|select\s+from\s+\w+\s*;/i, ], law: 3, - hint: '⚠️ **铁律 3**:严禁直接执行 SQL!必须通过 dacli 命令操作数据库:`dacli dm list/table/query` 查看数据模型,`dacli di create/list/preview` 操作数据接口。' + hint: '⚠️ **铁律 3**:严禁直接执行 SQL!必须通过 dacli 命令操作数据库:`dacli dm list` 查看数据模型,`dacli di list` 查数据接口。DI 创建/调试走 JNPF 后台 + Python + curl 兜底 (TS 版 dacli di 只读).' }, { patterns: [ diff --git a/skills/api-test/SKILL.md b/skills/api-test/SKILL.md index bf254dd..cd826ff 100644 --- a/skills/api-test/SKILL.md +++ b/skills/api-test/SKILL.md @@ -226,7 +226,9 @@ curl -s "http://127.0.0.1:30000/api/visualdev/Base/$FORM_ID" \ ### 验证工作流 ```bash -dacli workflow list -dacli workflow pending -dacli workflow launch --flowId= --data='{"key":"value"}' +dacli workflow list # 所有模板 +dacli workflow list --todo=1 # 我的待办 (v0.7+: --todo 替代 pending, 1=待审批 2=已审批 3=抄送) +dacli workflow launch --flowId= --formId= --data='{"key":"value"}' +# v0.7+ --formId 必传, 关联 form +# ❌ TS 版不支持 dacli workflow pending, 改用 --todo=1 ``` diff --git a/skills/data-interface/SKILL.md b/skills/data-interface/SKILL.md index dc3e6bc..0c3170d 100644 --- a/skills/data-interface/SKILL.md +++ b/skills/data-interface/SKILL.md @@ -1,11 +1,14 @@ --- name: data-interface -description: "JNPF 数据接口开发技能。3 类接口(SQL 操作 / 静态数据 / 远端 API)+ preview 调试 + 与表单 popupTable/relationForm 关联。触发词:数据接口、DataInterface、dacli di、interfaceId、SQL 接口、静态数据、远端 API、preview 调试。" +description: "JNPF 数据接口开发技能。3 类接口(SQL 操作 / 静态数据 / 远端 API)+ 与表单 popupTable/relationForm 关联。触发词:数据接口、DataInterface、dacli di、interfaceId、SQL 接口、静态数据、远端 API。" --- # 数据接口开发技能(JNPF + dacli) -> 📦 **dacli di 已迁移到 Picocli (2026-06-05)**:`DiCommand` 含 `list/create/preview` 3 个子命令,全部走静态嵌套类,`dacli di --help` 自动生成。详见 `dacli-ts` 技能 (TS 版, v0.7+ 替代; 本段 Java v10.6 Picocli 注释仅历史参考)。 +> 📦 **dacli di v0.7+ (2026-06-21)**: **仅 1 子命令** `list` (只读). `dacli di create / preview` **TS 版未实现** (Java v10.6 历史): +> - 创建 DI: 走 JNPF 后台 `低代码 → 数据接口` 手工配, 或写 Python + curl 兜底 +> - 调试 DI: 走 web preview 界面, 或 `dacli apis list --keyword=DataInterface` 调 JNPF API +> 详见 `dacli-ts` 技能. ## 触发词 @@ -43,37 +46,39 @@ JNPF 数据接口统一在 `data_interface` 表管理,按 `type` 字段分 3 ## dacli 命令完整参考 -### dacli di list — 列表查询 +### dacli di list — 列表查询 (v0.7+ 唯一子命令) ```bash -dacli di list [--page=1] [--pageSize=20] [--category=<分类ID>] [--keyword=<关键字>] -# 调 GET /api/system/DataInterface?currentPage=...&pageSize=...&category=...&keyword=... +dacli di list [--currentPage=1] [--pageSize=20] [--keyword=<关键字>] +# 调 GET /api/system/DataInterface # 返回 {code, data: {list: [...], pagination: {total}}} +# ⚠️ v0.7+ --page 改 --currentPage ``` -### dacli di create — 创建接口(默认 SQL 类型) +### ❌ dacli di create / preview (TS 版未实现) ```bash -dacli di create --name=<名称> --enCode=<编码> --sql="" [--dbLinkId=|default] -# 调 POST /api/system/DataInterface -# ⚠️ 当前只支持 type=1(SQL),固定写入: -# - type=1, action=3, hasPage=0, enabledMark=1 -# - dataConfigJson: {"sqlData":{"dbLinkId":"...","sql":"..."}} -# - parameterJson: "[]" ← 需手工 update 注入参数 -# - category: "816537011182633477" (硬编码默认分类) +# 创建 DI: 走 JNPF 后台 `低代码 → 数据接口` 手工配 +# 或写 Python 调 POST /api/system/DataInterface (见下面 payload 模板) +# +# 调试 DI: 走 web preview 界面 (JNPF 后台 → 数据接口 → 选接口 → 预览) +# 或用 dacli apis 调 JNPF API + Python ``` -### dacli di preview — 预览接口(调试核心) - -```bash -dacli di preview --id=<接口ID> [--params='{"key":"value",...}'] -# 调 POST /api/system/DataInterface/{id}/Actions/Preview -# params 自动转 paramList[]: {field, defaultValue, dataType="varchar", sourceType=3, required=0} -# 返回 JNPF 实际执行结果(SQL 行数 / API 响应体 / 静态 JSON) +**Python 兜底创建 DI** (按需复制): +```python +import requests +r = requests.post('http://nginx/api/system/DataInterface', + headers={'Authorization': 'bearer ' + TOKEN, 'App-Code': APP_CODE}, + json={ + 'fullName': '用户分页查询', 'enCode': 'userQuery', + 'type': 1, 'action': 3, 'hasPage': 1, 'enabledMark': 1, + 'dataConfigJson': '{"sqlData":{"dbLinkId":"","sql":"SELECT ..."}}', + 'parameterJson': '[{"field":"keyword","dataType":"varchar","sourceType":3}]' + }) +print(r.json()['data']['id']) # 拿 DI id 给 form 用 ``` -> ⚠️ `preview` 当前把每个 params key 都当 `sourceType=3`(直接传值)+ `dataType=varchar` 注入,**不支持 system variable 或 relationField**。复杂参数需 `dacli form update` 手工注入 `parameterJson`。 - ## SQL 变量(type=1 专用) DI SQL 内可用 `{}` 包裹的占位符: diff --git a/skills/data-management/SKILL.md b/skills/data-management/SKILL.md index ece8348..a7a22f1 100644 --- a/skills/data-management/SKILL.md +++ b/skills/data-management/SKILL.md @@ -263,6 +263,6 @@ dacli dm create --table=ct_child_demo --tableName="主子表演示-子" \ ## 相关技能 - **`form-development`** — `dacli form create --autoTable=true` 内部调 `dm create` -- **`data-interface`** — DI 数据接口 `dacli di create --table=X` 引用 dm 表作为数据源 +- **`data-interface`** — DI 数据接口 (TS 版 `dacli di list` 只读, 创建走 JNPF 后台或 Python 兜底) 引用 dm 表作为数据源 - **`dacli-ts`** — 了解 dacli v0.8.1 TS 版 (22 父命令 / 80+ 子命令) 通用命令用法 + 盲点 24-27 兜底 (注: `DacliKit` 是 Java 版 v10.6 静态工具类, TS 版无对应; dbLinkId 走 `core/config.ts` 自动从 token.json 读) - **`basic-standards`** — 字段命名/类型规范详情 diff --git a/skills/data-screen/SKILL.md b/skills/data-screen/SKILL.md index 8d8a29a..b716ff9 100644 --- a/skills/data-screen/SKILL.md +++ b/skills/data-screen/SKILL.md @@ -6,7 +6,7 @@ type: skill # 数据大屏 / 可视化门户技能(JNPF + dacli) -> 📦 **dacli portal 已迁移到 Picocli (2026-06-05)**:`PortalCommand` + list/create 2 个子命令。`dacli portal --help` 自动生成。详见 `dacli-ts` 技能 (TS 版, v0.7+ 替代; 本段 Java v10.6 Picocli 注释仅历史参考)。 +> 📦 **dacli portal v0.7+ (2026-06-21)**: 4 子命令 — `list / info / create / release`. TS 版 v0.7+ 还新增独立 `dacli bigscreen` 命令 (list/info/create/release), 大屏不再合并到 portal 下. 详见 `dacli-ts` 技能. ## 触发词 @@ -20,12 +20,12 @@ type: skill |------|----------|-----------|----------| | **入口 URL** | `/DataV/jnpf_app_{app_code}/` | `/DataV/jnpf_app_{app_code}/` | `/jnpf_app_{app_code}/` | | **主用途** | 数据监控/驾驶舱 | 多页面门户聚合 | 业务 CRUD | -| **dacli 命令** | `dacli portal` | `dacli portal` | `dacli form` + `dacli menu` | +| **dacli 命令 (v0.7+)** | `dacli bigscreen` | `dacli portal` | `dacli form` + `dacli menu` | | **type 字段** | `2` | `1` | (不适用) | | **数据源** | 聚合多个 DI/表单 | DI + 静态文案 | 单表 CRUD | | **典型场景** | 销售看板、运营监控 | OA 首页、Portal 站点 | 用户管理、订单录入 | -> 关键区分:JNPF 把"门户"和"大屏"合并到 `dacli portal` 一个命令下,用 `--type` 区分(1=门户,2=大屏)。 +> 关键区分 (v0.7+): **大屏 (`bigscreen`) 和门户 (`portal`)** 拆成两个独立命令. Java v10.6 把大屏合并到 portal 的 `--type=2` 已被 TS 版废弃. ### 大屏分类 @@ -35,25 +35,40 @@ type: skill | **移动大屏** | `App` | 手机/平板适配,响应式 | | **报表型大屏** | `Web` + type=2 | 财务报表/分析,表格+图表+筛选 | -## dacli 命令 +## dacli 命令 (v0.7+) -### `dacli portal list` +### `dacli portal list` / `dacli bigscreen list` -``` -Usage: dacli portal list [-hV] -获取门户列表 +```bash +dacli portal list # 门户列表 +dacli bigscreen list # 大屏列表 (v0.7+ 独立命令, Java 版无) ``` -返回当前应用下全部大屏/门户的 JSON(含 `id`/`fullName`/`enCode`/`category`/`type`)。 +### `dacli portal create` / `dacli bigscreen create` -### `dacli portal create` +```bash +# portal (v0.7+: --name 改 --fullName) +dacli portal create --fullName="OA首页" --enCode=oa_home --category=Web +# bigscreen (v0.7+ 新) +dacli bigscreen create --fullName="销售驾驶舱" --enCode=sales_cockpit --category=Web +# 必传: --fullName, --enCode +# 可选: --category (Web/App, 默认 Web) +# 注: portal/bigscreen TS 版不再用 --type 区分, 走两个独立命令 ``` -Usage: dacli portal create [-hV] --name= --enCode= [--category=] [--type=<1|2>] - --name= 门户名称(必填) - --enCode= 门户编码(必填,英文+数字) - --category= 分类(默认 Web) - --type=<1|2> 1=门户 2=大屏(默认 1) + +### `dacli portal info` / `dacli bigscreen info` (v0.7+ 新) + +```bash +dacli portal info # 查门户详情 (含布局 schema) +dacli bigscreen info # 大屏详情 +``` + +### `dacli portal release` / `dacli bigscreen release` (v0.7+ 新) + +```bash +dacli portal release --pc --app # 发布到 PC + 移动端 +dacli bigscreen release ``` **关键 option**: diff --git a/skills/form-development/SKILL.md b/skills/form-development/SKILL.md index 746e39b..5e9c82b 100644 --- a/skills/form-development/SKILL.md +++ b/skills/form-development/SKILL.md @@ -173,7 +173,7 @@ dacli form create --fullName=<名称> --enCode=<编码> --type=1 --webType=3 \ # v0.7+ 修: --name 改 --fullName, --autoTable 不再是 flag (--tables 替代) ``` -**顺序要求**:`dacli workflow create` 必须先于 form create(否则 flowId 拿不到)。 +**顺序要求 (v0.7+ 校准)**:`dacli workflow create` (必传 --flowXml BPMN) 必须先于 form create(否则 flowId 拿不到)。也可走 `--ai "<描述>"` 让平台 LLM 自动生成 BPMN. 实际更常用: 走 web 流程设计器手工配 BPMN (TS 版 v0.7+ 没 web 端 BPMN 节点编辑能力). **临时方案**:未建工作流时回退 `webType=2`(普通表单),不要用 `webType=3 + enableFlow=0`(前端会渲染工作流按钮但点击无响应)。 diff --git a/skills/ssw-pack-init/SKILL.md b/skills/ssw-pack-init/SKILL.md index 7b628ac..51ddf21 100644 --- a/skills/ssw-pack-init/SKILL.md +++ b/skills/ssw-pack-init/SKILL.md @@ -66,12 +66,16 @@ boot/ssw-{app_code}/ | Maven 缓存问题 | 编译失败但无错误日志 | `mvn clean` 后重试 | ## 创建新 ssw-{app_code} 业务包 (从 aibridge 经验) -### 自动创建 (用 dacli codegen --generate=true) +### 自动创建 (TS 版 v0.7+ **无 `dacli codegen`**, 走 web UI 或 `form/codegen` 子命令) ```bash +# ❌ TS 版 v0.7+ 没有顶层 `dacli codegen` 命令 +# ✅ 走: `dacli form codegen ` (form 子命令, 自动生成后端) +# 或走 JNPF 后台 → 在线开发 → 选表单 → 生成代码 +# # 1. 准备 parent pom.xml 已包含 ssw-{app_code} 模块 # 2. 在 jnpf-admin/pom.xml 添加 controller 依赖 -# 3. 跑 dacli codegen: -dacli codegen --formId=<表单ID> --module=ssw-{app_code} --generate=true +# 3. 跑 dacli form codegen: +dacli form codegen <表单ID> # 4. 编译: mvn install -pl ssw-{app_code} -am -DskipTests # 5. 重新构建 jnpf-admin: diff --git a/skills/workflow-development/SKILL.md b/skills/workflow-development/SKILL.md index fcb7b3a..d50c13d 100644 --- a/skills/workflow-development/SKILL.md +++ b/skills/workflow-development/SKILL.md @@ -1,11 +1,14 @@ --- name: workflow-development -description: "JNPF Flowable 工作流开发:dacli workflow 6 子命令(list/create/launch/approve/reject/pending)+ 表单绑定(webType=3/enableFlow=1)+ BPMN 节点设计 + 审批链。触发词:工作流、审批、Flowable、审批链、流程发起、待办、approve、reject、launch、pending" +description: "JNPF Flowable 工作流开发:dacli workflow 5 子命令(list/create/launch/approve/decision)+ 表单绑定(webType=3/enableFlow=1)+ BPMN 节点设计 + 审批链。触发词:工作流、审批、Flowable、审批链、流程发起、待办、approve、launch、decision" --- # 工作流开发技能(JNPF + Flowable + dacli) -> 📦 **dacli workflow 已迁移到 Picocli (2026-06-05)**:`WorkflowCommand` + 6 个子命令,`dacli workflow --help` 自动生成。详见 `dacli-ts` 技能 (TS 版, v0.7+ 替代; 本段 Java v10.6 Picocli 注释仅历史参考)。 +> 📦 **dacli workflow v0.7+ (2026-06-21)**: 5 子命令 — `list / create / launch / approve / decision`. `reject` / `pending` **TS 版未实现** (Java v10.6 历史命令): +> - 拒绝 → `dacli workflow approve --status=1` (0=同意, 1=不同意, 2=退回) +> - 待办 → `dacli workflow list --todo=1` (1=待审批 2=已审批 3=抄送) +> 详见 `dacli-ts` 技能. ## 何时使用 @@ -44,60 +47,70 @@ description: "JNPF Flowable 工作流开发:dacli workflow 6 子命令(list/ - **条件分支**:exclusiveGateway + 表达式(例:`${day > 3}`) - **会签**:parallelGateway + 多人会签 -## dacli workflow 6 子命令 +## dacli workflow 5 子命令 (v0.7+) -### list — 查看工作流模板 +### list — 查看工作流模板/待办 ```bash -dacli workflow list # 所有模板 -dacli workflow list --category= # 按分类过滤 +dacli workflow list # 所有模板 +dacli workflow list --category= # 按分类过滤 +dacli workflow list --todo=1 --pageSize=20 # 我的待办 (1=待审批 2=已审批 3=抄送) +# ❌ TS 版不支持 dacli workflow pending, 改用 --todo=1 ``` 返回 `data.list[]`,每项含 `id`/`fullName`/`enCode`/`type`/`category`。`type=2` 简化流程,`type=1` 标准流程。 -### create — 建工作流模板(仅元数据,不含 BPMN) +### create — 建工作流模板 ```bash -dacli workflow create --name=请假流程 --enCode=qingjia --category= -# 必填: --name --enCode -# 可选: --category --icon --description +# 必填: --fullName, --enCode, --flowXml (BPMN XML 必传) +dacli workflow create --fullName=请假流程 --enCode=qingjia \ + --category= --flowType=2 --flowXml='' +# 可选: --flowType (1=简易 2=标准 3=任务流 4=自由流, 默认 2) +# --flowNodes (JSON), --flowConfig (JSON), --ai (平台 LLM 自动生成) + +# 简化: AI 自动生成 BPMN +dacli workflow create --ai '两级审批请假流程, 申请人→主管→HR' +# 自动填 fullName/enCode/flowXml ``` -⚠️ **dacli create 只建模板元数据**,BPMN 节点(start/userTask/gateway/连线)需在 JNPF 流程设计器手工配置。 +⚠️ v0.7+ 校准: +- ❌ `--name` 改 `--fullName` +- ❌ 必传 `--flowXml` BPMN XML (TS 版不只建元数据, 必传 BPMN) +- ✅ `--ai "<描述>"` 走平台 LLM 自动生成 BPMN ### launch — 发起流程 ```bash -dacli workflow launch --flowId= --data='{"f_leave_days":3,"f_reason":"病假"}' -# --flowId: 流程**版本**ID(不是模板ID),用 dacli workflow list 取对应版本的 id -# --data: 表单业务字段 JSON(不含系统字段) +dacli workflow launch --flowId= --formId= \ + --data='{"f_leave_days":3,"f_reason":"病假"}' +# --flowId: 流程**模板**ID (v0.7+ 用模板 id, 不是版本 id, 用 dacli workflow list 拿) +# --formId: 绑定的表单 id (v0.7+ 必传, launch 时关联 form) +# --data: 表单业务字段 JSON (不含系统字段) ``` -**后端调用**:`POST /api/workflow/task` body `{flowId, status:1, flowUrgent:1, isFlow:1, formData:{...}}` +**后端调用**:`POST /api/workflow/task` body `{flowId, formId, status:1, flowUrgent:1, isFlow:1, formData:{...}}` -### approve — 审批通过 +### approve — 审批任务 (含同意/不同意/退回) ```bash -dacli workflow approve --operatorId= --opinion=同意 -# --operatorId: 从 `dacli workflow pending` 取 `data.list[].id` -# --opinion: 审批意见(默认"同意") +dacli workflow approve --operatorId= --status=0 --opinion=同意 +# --operatorId: 从 `dacli workflow list --todo=1` 取 data.list[].id +# --status: 0=同意 (默认) | 1=不同意 | 2=退回 +# --opinion: 审批意见 +# ❌ TS 版不支持 dacli workflow reject, 改用 --status=1 ``` -**后端调用**:`POST /api/workflow/operator/Audit/{operatorId}` body `{status:1, handleOpinion, sign:""}` +**后端调用**:`POST /api/workflow/operator/Audit/{operatorId}` body `{status, handleOpinion, sign:""}` -### reject — 审批拒绝 +### decision — 决策流参数 (白皮书 5.6.5) ```bash -dacli workflow reject --operatorId= --opinion=不同意 -# status=2 区别于 approve 的 status=1 +dacli workflow decision --list # 列所有模板, 标记是否含决策流节点 +dacli workflow decision # 查某模板的决策流参数 (漏斗/覆盖/规则集/评分卡/交叉表/异常) ``` -### pending — 查询我的待办 - -```bash -dacli workflow pending --page=1 --pageSize=20 -# 返回 data.list[] 含 id (operatorId) / fullName / flowName / createTime -``` +❌ TS 版新增, Java v10.6 无. ## 实战场景