- references/command-reference.generated.md: 190 dacli commands from --help tree (auto-generated by dacli/scripts/gen-command-reference.ts; do not hand-edit) - scripts/check_command_drift.py: assert template dacli --flags exist in the reference (advisory); whitespace-preceded flag match avoids CSS/anchor false positives - dacli-doc-pattern.md: point subagents at the generated reference (single source of truth) Verified: drift-check green — 37 template options all present, 0 drift. Co-Authored-By: Claude <[email protected]>
91 KiB
dacli 命令参考 (generated, dacli v0.1.0)
ssw-loop 子代理引用本文件而非内联命令语法 (永不漂移)。 共 190 条命令。
form
dacli form list
列出当前应用的所有表单 (BS-53 v0.12+: 默认显示 STATE 列, --state 支持 2, --summary 输出分布). AI 干活前先跑 --summary 看 state 健康度
- 选项:
--keyword <k>— 关键字 (匹配 fullName/enCode)--state <s>— 过滤 state (0|1|2)--limit <n>— 最多取 N 条 (默认 100) (默认 100)--verbose— 完整输出 (含 API 调用过程日志)--json— 原始 JSON--summary— 输出 state 分布汇总 (不列明细)
dacli form info
拉表单完整 schema. clone 前先 info 看结构
- 参数:
id— 表单 id - 选项:
--summary— 只打概要 (id/enCode/state/type/webType/dbLinkId/字段数)--json— BS-新1: 解码 formData/columnData/tables escaped JSON, 直接 jq (无需 Python 二次解码)--bindings— 打印 formData 字段的拍平绑定 (field/jnpfKey/dataType/dictionaryType/required)--verbose— 完整输出 (含 step machine、API 调用等过程日志)
dacli form create
创建表单. 推荐 --ai 一条命令完成 (NCPF 后端 LLM 自动生成 enCode/fullName/fields), 业务建议 dm→form 两步走.
- 选项:
--fullName <n>— 中文名 (--ai 自动填, 否则必填)--enCode <e>— 英文编码 (--ai 自动填, 否则必填)--type <t>— 1=自定义(formDesign) 2=系统(sysForm) 3=接口 4=视图 (默认 "1")--webType <w>— 1=仅表单 2=表单+列表(默认) 3=树+表单 4=数据视图 (默认 "2")--category <c>— 分类 id (form list 看真实值; 镜像 web Form.vue:60-66 必填; 推荐每个 appCode 派独立 category, 通用复用 8f65bbe3bce341c8b3625d93544a044a=crmOrder 业务表单)--dbLinkId <id>— db link id (type≠4 时必传, 默认从 token.dbLinkId)--fields <json>— formData.fields JSON 数组 (--ai 自动填)--tables <json>— tables JSON 数组 (type=1/2 必传)--enableFlow <0|1>— 是否绑工作流 (默认 "0")--flowId <id>— 工作流 id (enableFlow=1 时必传)--autoRelease— 建完立刻发布 (type=4 自动跳过)--autoTable— 从 --fields 自动推导 --tables JSON (web formDesign Form.vue 行为一致; 覆盖 --tables)--autoCreateMenu— 发布后自动挂菜单 (需传 --menuParentId, 避免浏览器验证找不到 list 页)--menuParentId <id>— 挂菜单的父目录 id (--autoCreateMenu 时必传; 走 dacli menu list --keyword=... 拿)--no-relation-form-auto— 关闭 relationForm 字段自动注入 (v0.11h+ BS-18 fix, 默认 ON; 用于 *_code 等业务编码字段被误判为关系字段时)--table <name>— 绑现有物理表 (镜像 web 选表自动生成字段; 不需要 --ai 描述, 不需要 --fields)--ai <desc>— 白皮书 5.10.1 AI 快速建表 — 自然语言描述, 平台 LLM 生成 enCode/fullName/fields (走 NCPF backend /api/visualdev/ai/form, v0.12+ 默认 autoRelease=true)--ai-field <desc>— 白皮书 5.10.2 AI 推荐字段 — 自然语言描述, 平台 LLM 推荐单字段, 只输出建议不建表单--no-smart-props— 关闭 --ai smartProps 自动选配 (默认 ON, AI 选填组件属性)--no-verify— 跳过浏览器层验证--verify <mode>— 失败模式: warn (默认, v0.12+ jxcj) | block (默认 "warn")--verify-timeout <ms>— 浏览器验证超时 (默认 60s) (默认 "60000")--via <path>— 创建路径: api (默认, 走 POST /visualdev/Base) | ui (走 playwright 模拟人类操作, API 失败时兜底) (默认 "api")--json— 原始 JSON 输出--verbose— 完整输出 (含 step machine、API 调用等过程日志)--column-naming <style>— columnList 命名规范: auto | snake | f_prefix (默认 snake, JNPF 标准) (默认 "snake")
dacli form update
表单修改 (高需求 P0 NEW-CMD, 改 schema/字段/enCode, PUT 语义). 解决之前需 export → 改 → import 的无原子性.
- 选项:
--id <id>— 表单 id--fullName <n>— 中文名--enCode <e>— 英文编码 (BS-49 唯一, 重名会失败)--category <c>— 表单分类 id--dbLinkId <d>— 业务库 id (BS-48 必须有效)--enableFlow <0|1>— 是否启用流程 (BS-44)--flowId <f>— 流程模板 id (enableFlow=1 必填)--type <t>— 类型 1=表单 2=列表 3=树 4=视图--webType <w>— 前端类型 1=表单 2=列表--fields <json>— 字段 JSON 数组 (v0.11+ 支持 增量改字段, 格式同 create)--autoRelease— PUT 后自动重新发布 (BS-53 防护, 默认 true) (默认 true)--no-autoRelease— 不自动发布, 仅 PUT--releaseOnly— 仅重新发布, 不 PUT (state 0/2 → 1)--expected-enCode <e>— 期望的 enCode (与 getInfo 对比, 防止覆盖外部修改)--expected-state <s>— 期望的 state (0/1/2, 防止覆盖外部修改)--force— 跳过 dirty check, 强制覆盖 (慎用!)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli form release
把表单从 state=0|2 切到 state=1, 前端列表才能看到 (BS-53: state=2 = 已发布被编辑过, 自动重新发布)
- 参数:
id— 表单 id - 选项:
--soft— 发布失败不退出 (用于 type=4)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli form delete
删除表单. 不可恢复, 加 --yes 跳过确认. --cascade 级联删关联菜单.
- 参数:
id— 表单 id - 选项:
--yes— 跳过确认--cascade— 级联删关联菜单 (避免 BS-43)
dacli form export
导出表单完整 schema + 物理表 schema 到文件 (v0.7 解 #15). 用于 baseline 复刻 / 备份 / 跨应用迁移
- 参数:
id— 表单 id - 选项:
--out <path>— 输出文件路径 (默认 ./.json)--no-physical— 不带物理表 schema (默认会带, 兼容旧版导出)
dacli form import
从 JSON 导入表单. v0.7 默认 --autoTable 在目标库重建物理表, 解 #15.
- 参数:
file— 表单 JSON 路径 - 选项:
--enCode <e>— 新 enCode (默认原值 + _clone)--fullName <n>— 新 fullName (默认原值)--dbLinkId <id>— 新业务库 id (默认 token.dbLinkId, 跨应用迁移强烈推荐传)--table <name>— 新主表名 (默认 enCode 小写, 避免目标库重名)--release— 导入后立刻发布--autoTable— 导入前重建物理表 (默认 true, --no-autoTable 跳过) (默认 true)--no-autoTable— 不重建物理表 (老 export 没 _physicalSchema 时)--no-verify— 跳过浏览器层验证 (默认硬阻塞)--verify <mode>— 失败模式: block (默认) | warn (默认 "block")--verify-timeout <ms>— 浏览器验证超时 (默认 60s) (默认 "60000")
dacli form codegen
表单代码生成 (白皮书 5.5) — 调平台 CodePreview, 写到本地目录, 参考 aibridge CodeGenerator
- 参数:
formId— form id (要先 release, state=1) - 选项:
--company <code>— 企业代码 (aibridge company_code, 默认 ssw; 模块名 = ${company}-${module}, 包名 = ${company}.${module}) (默认 "ssw")--module <name>— 应用代码 (aibridge app_code, 默认取 form.enCode; 模块名 = ${company}-${module})--modulePackage <pkg>— 模块包名 (默认 ${company}.${module},如 ssw.tds) — 写到 Java package 行--description <desc>— 功能描述 (写到类注释)--dbLinkId <id>— 数据源 id (走业务库, 默认从 token.dbLinkId)--mainClassName <name>— 主表类名 (PascalCase, 默认从 enCode 自动转换: jxcj_develop_project → JxcjDevelopProject)--enCode <e>— v0.12+ BS-New-9: 显式指定 form enCode (Controller @RequestMapping 路径用, 默认取 opts.module)--enableFlow <0|1>— 是否启用流程 0/1 (默认 "0")--out <path>— 输出目录 (默认 ./generated/${company}-${module}/)--flat— 关闭多模块归类 (旧版兼容: 文件直接写到 outDir 根, 不分 entity/biz/controller)--separate-controller— Controller 输出到独立 ${moduleArtifactId}-controller/ 子目录 (旧版行为, 默认合并到 biz)--multi-module-pom— 生成 4 个 pom.xml 占位 (parent + entity/biz/controller, 严格按 aibridge §POM 依赖规则; 与 --flat 互斥)--module-only <list>— 只导出指定模块 (all 默认, 或 entity/biz/controller 逗号分隔, 用于单模块测试/编译) (默认 "all")--auto-alias— (默认开) 写 base_visual_alias, JNPF 用别名生成 PascalCase 类名 (默认 true)--alias-file <path>— 从 JSON 文件读 alias 表 (格式: [{table,aliasName,fields?}])--alias <json>— 直接传 alias JSON 字符串 (与 --alias-file 二选一)--no-web— 不生成 web/ (web Vue 3) 前端代码, 默认生成--no-uniapp— 不生成 uniapp/ (移动端) 前端代码, 默认生成--web-base <path>— web 输出基准路径 (默认 web/apps/jnpf-web-apps-main/src/views/ssw/{appCode})--uniapp-base <path>— uniapp 输出基准路径 (默认 uniapp/pages/ssw/{appCode})--auto-menu— 生成完直接调 menu create 挂菜单--json— 原始 JSON 输出 (file tree)
dacli form bindFlow
表单绑工作流 (BS-New-4: form 端 flowId + workflow start node formId 双向持久化).
- 选项:
--formId <f>— 表单 id--flowId <w>— 工作流模板 id--json— 原始 JSON 输出
dacli form selector
功能 (form) 下拉框, AI 创建菜单 / 工作流 / select 字段时必跑.
- 选项:
--keyword <k>— 按编码/名称搜索--type <t>— 表单类型 (1=仅表单 2=表单+列表 3=表单列表(树) 4=数据视图)--webType <w>— 前端类型 (1=表单 2=表单+列表)--enableFlow <f>— 是否工作流 (0/1)--category <c>— 表单分类--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli form preview
输出 form standalone HTML 预览, 浏览器打开即可, 无需 JNPF/nginx. AI 场景增强 (web 没专门 FormPreview 组件, 是 FormGenerator 复用)
- 选项:
--id <id>— 表单 id--out <file>— 输出 HTML 文件路径 (默认 ./form-preview-.html) (默认 "./form-preview-${id}.html")--json— 输出 schema JSON 而不生成 HTML (调试用)
dacli form fix-entity
P0 修复: entity 加 @TableId + Service 加 jnpf-origin null check (jnpf 雪花 id 必需, jxcj 2026-06-29 实战教训).
- 选项:
--table <name>— 只修指定表 (默认修所有)--dir <path>— 自定义目录 (优先级最高, 覆盖自动扫描)--type <type>— 修类型 entity|biz|all (默认 all) (默认 "all")--dry-run— 只显示不写文件
dacli form audit
审计表单业务盲点 (BS-新61~64: select 空字典 / input FK / 数字范围 / formRules 缺失) — 镜像 web FormGenerator + JNPF VisualdevController 后端 schema 检测
- 选项:
--formId <id>— 审计单 form (按 formId, 优先于 --enCode)--enCode <code>— 审计单 form (按 enCode, 用当前 app 列表查 formId)--all— 审计当前 app 所有已发布 form--check <type>— 只查指定类型 (select-dict | input-fk | number-range | form-rules | field-regex | column-list | relation-modelid | required | webtype), 默认全查--json— JSON 输出 (供脚本处理)
dm
dacli dm list
列出指定业务库的所有数据模型表. dbLinkId=0 是主库 (平台库).
- 选项:
--dbLinkId <id>— 业务库 id (默认从 token.dbLinkId)--keyword <k>— 按表名模糊搜索--page <p>— 页码 (默认 "1")--pageSize <s>— 每页条数 (默认 "50")--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli dm create
在指定业务库建物理表. fields JSON 必含 field/fieldName/dataType/dataLength. v0.11d+ 加 step machine 校验 (3 step 镜像 web dataModel/Form.vue + 后端 DbTableController.checkName, 聚合错误, AI 不用去浏览器试错)
- 选项:
--table <name>— 表名 (snake_case)--tableName <cn>— 表中文名--fields <json>— 字段定义 JSON 数组--dbLinkId <id>— 业务库 id (默认从 token.dbLinkId)--strip-app-code [val]— 自动去 appCode 前缀 (默认 true; --no-strip-app-code 保留前缀, BS-55 修复)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli dm drop
删除物理表. ⚠️ 不可恢复.
- 选项:
--table <name>— 表名--dbLinkId <id>— 业务库 id--yes— 跳过确认--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli dm fields
查指定物理表的所有字段定义.
- 选项:
--table <name>— 表名--dbLinkId <id>— 业务库 id--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dict
dacli dict typeList
列出所有字典类型 (默认递归展平 children, BS-New-6 ON).
- 选项:
--keyword <k>— 按编码/名称搜索 (客户端过滤)--recursive— 递归展平 children 树 (默认 ON, 显示所有子分类) (默认 true)--no-recursive— 只显示顶层 2 项 (旧行为)--tree— 显示原始树形结构 (含缩进, 调试用)--verbose— 完整输出 (含 API 调用过程日志)--json— 原始 JSON 输出
dacli dict typeCreate
创建字典类型 (含可选 items 批量建). 端到端 1 条命令替代 web UI 手敲. v0.11d+ 加 step machine 校验 (3 step 镜像 web dict/components/Form.vue + 后端 DictionaryTypeController.create, BS-47 唯一性预校验, 聚合错误)
- 选项:
--enCode <e>— 字典编码 (英文, 唯一)--fullName <n>— 字典名 (中文)--parentId <p>— 父字典 id, 不传则建顶级 (默认 "0") (默认 "0")--category <c>— 分类: 0=业务 1=系统 (默认 0) (默认 "0")--isTree <0|1>— 是否树形 (默认 0) (默认 "0")--sortCode <s>— 排序, 数字越大越靠后 (默认 0) (默认 "0")--items <json>— 字典项 JSON 数组 [{enCode, fullName, sortCode?}, ...] (可选)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出
dacli dict typeUpdate
字典类型修改 (改名/分类/树形/排序). PUT 语义, 未传保留.
- 选项:
--id <id>— 字典类型 id--fullName <n>— 字典名--enCode <e>— 字典编码--category <c>— 分类 (0=业务 1=系统)--isTree <0|1>— 是否树形--sortCode <s>— 排序--expected-enCode <e>— v0.11e+ Phase A2: 校验 enCode 未变 (防 AI session 误覆盖)--expected-state <s>— v0.11e+ Phase A2: 校验 enabledMark 未变--force— v0.11e+ Phase A2: 跳过 dirty check--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli dict typeDelete
字典类型删除 (级联删字典项)
- 选项:
--id <id>— 字典类型 id--yes— 跳过确认--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli dict dataList
看字典数据. --typeId 看单类型, 不传 --all 拿全部.
- 选项:
--typeId <id>— 字典类型 id (不传则返回全部)--all— 等价于不传 typeId 调 /All--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli dict dataCreate
往已存在字典类型追加字典项 (单条/批量, 自动跳过重复).
- 选项:
--typeId <id>— 字典类型 id--enCode <e>— 字典项编码 (单条模式必填)--fullName <n>— 字典项名 (单条模式必填)--parentId <p>— 父字典项 id (默认 0) (默认 "0")--sortCode <s>— 排序 (默认 0) (默认 "0")--items <json>— 批量 JSON 数组 [{enCode, fullName, sortCode?}, ...] (与 --enCode/--fullName 互斥)--skip-duplicate— 跳过已存在 enCode/fullName 的项 (避免 EXIST001/EXIST002 报错, 默认 ON) (默认 true)--no-skip-duplicate— 强制创建, 遇重复返错误 (旧行为)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli dict dataUpdate
字典项修改 (改名/排序/启用). PUT 语义, 未传保留.
- 选项:
--id <id>— 字典项 id--enCode <e>— 字典项编码--fullName <n>— 字典项名--sortCode <s>— 排序--enabledMark <0|1>— 启用/禁用--expected-enCode <e>— v0.11e+ Phase A2: 校验 enCode 未变 (防 AI session 误覆盖)--force— v0.11e+ Phase A2: 跳过 dirty check--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli dict dataDelete
字典项删除
- 选项:
--id <id>— 字典项 id--yes— 跳过确认--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
menu
dacli menu list
列出当前 app 的菜单树 (按请求头 App-Code 过滤).
- 选项:
--keyword <k>— 按名称搜索--flat— 不按树形打印, 直接平铺--include-actions— 也列出 form 通过 Actions/Module 自动注册的菜单 (visualdev/Base 表, 不在 system/Menu 树里; 默认 ON, --no-include-actions 关闭) (默认 true)--no-include-actions— 不列 form-driven 菜单 (只列 system/Menu 树)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli menu info
拉菜单完整 schema. 用于诊断"菜单创建了但侧边栏不显示"等问题 (BS-43/BS-50 防御).
- 选项:
--id <id>— 菜单 id--json— 原始 JSON 输出
dacli menu create
创建菜单. 挂表单菜单 (--formId) 走 web 真路径 Actions/Module, 后端自动处理所有字段. v0.11d+ 加 step machine 校验 (4 step 镜像 web Form.vue + 后端 ModuleController.create, 聚合错误, AI 不用去浏览器试错)
- 选项:
--fullName <n>— 菜单中文名 (Mode A: 不传则自动从 form.info.fullName 拿; Mode B: 必填)--enCode <e>— 菜单英文编码 (默认=fullName)--formId <f>— 关联 form id (挂表单菜单时给 → 走 Actions/Module)--pcParents <ids>— 挂表单时桌面端父菜单 id 列表 (逗号分隔, 默认 "0" 顶级)--appParents <ids>— 挂表单时移动端父菜单 id 列表 (逗号分隔, 默认空 = 不发布)--no-pc— 挂表单时不发布桌面端 (默认 true)--app— 挂表单时发布移动端 (默认 false)--parentId <p>— 低级模式: 父菜单 id (默认 "-1")--type <t>— 低级模式 type: 1=目录 2=Vue扩展 3=VisualDev 7=外链 (默认 "1")--urlAddress <u>— 低级模式: URL--icon <i>— 低级模式: 图标--moduleId <id>— 低级模式: propertyJson.moduleId (默认空, 走 D-9/D-12 自动填)--sortCode <n>— 低级模式: sortCode 排序 (默认 0) (默认 "0")--category <c>— 菜单分类 (Web | App, 默认 Web) (默认 "Web")--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出
dacli menu update
菜单修改 (B-20 NEW-CMD). 改 urlAddress/enCode/propertyJson (镜像 web Menu/Form.vue handleSubmit). 杀手特性 --formEnCode 一键同步 form enCode 改名后的菜单 urlAddress.
- 选项:
--id <id>— 菜单 id (推荐位置参数 menuId)--fullName <n>— 中文名--enCode <e>— 英文编码 (BS-49 平台唯一)--urlAddress <u>— URL (type=3 通常 model/<form_enCode>)--pageAddress <p>— 页面地址 (默认 = urlAddress)--parentId <p>— 父菜单 id--type <t>— type 1=目录 2=Vue 3=VisualDev 7=外链 11=表单回传--icon <i>— 图标--moduleId <id>— propertyJson.moduleId (关联 form id, type=3/9 必填)--formEnCode <e>— 关联 form 的 enCode (dacli 自动查 form id 填 moduleId + 拼 pageAddress=model/)--category <c>— Web | App (默认 "Web")--propertyJson <json>— 直接覆盖 propertyJson JSON (高级)--expected-enCode <e>— 期望的 enCode (与 getInfo 对比, BS-49 防覆盖)--force— 跳过 dirty check, 强制覆盖 (慎用!)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli menu delete
删除菜单. v0.7+ 支持 --enCode (容错 hash 后缀) / --cascade (递归子菜单) / --fallback (失败兜底).
- 选项:
--id <id>— 菜单 id (与 --enCode 互斥)--enCode <e>— 菜单 enCode (走 list 模糊匹配, 容错 JNPF 5 位 hash 后缀)--cascade— 递归删除子菜单--fallback— DELETE 失败时自动调 unrelease--yes— 跳过确认--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli menu unrelease
取消 form 的菜单发布. 用于 dacli menu delete 失败时兜底 (DELETE /api/system/Menu/X 报 System abnormality).
- 选项:
--formId <f>— 表单 id--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli menu releases
查 form 已挂的菜单 (走 web 真实端点 getReleaseMenu, 之前 dacli 缺).
- 选项:
--formId <f>— 表单 id--json— 原始 JSON 输出
dacli menu purge
按 formId 删除所有挂载菜单 (PC+APP). 走 getReleaseMenu → DELETE 真实删菜单, vs unrelease 只重置 form 关联.
- 选项:
--formId <f>— 表单 id--unrelease— 同时调 unrelease 清 form 关联状态--yes— 跳过确认--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
di
dacli di list
列出所有数据接口 (弹窗选择/下拉补全/关联表单用).
- 选项:
--keyword <k>— 搜索--currentPage <p>— 页码 (默认 "1")--pageSize <s>— 每页 (默认 "50")--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli di info
数据接口详情 (含 request/response schema + 参数).
- 选项:
--id <id>— 数据接口 id--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli di test
数据接口测试调用. AI 验证 DI 配置正确性 (链路, 鉴权, 返回值).
- 选项:
--id <id>— 数据接口 id--data <json>— 请求参数 JSON (默认空 {}) (默认 "{}")--dry-run— 仅显示将发送的 body, 不实际调用 (调试用)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli di update
数据接口修改 (改 schema/path/参数). PUT 语义, 未传字段保留原值. v0.11d+ 加 step machine 校验 (3 step 镜像 web dataInterface/Form.vue + 后端 DataInterfaceController.update, BS-47 唯一性预校验, 聚合错误)
- 选项:
--id <id>— 数据接口 id--fullName <n>— 中文名--enCode <e>— 英文编码--categoryId <c>— 分类 id--action <a>— 动作 (type=1 必填): 1=增加 2=修改 3=查询 4=删除--url <u>— 接口路径/URL--expected-enCode <e>— v0.11e+ Phase A2: 校验 enCode 未变 (防 AI session 误覆盖)--expected-state <s>— v0.11e+ Phase A2: 校验 enabledMark 未变--force— v0.11e+ Phase A2: 跳过 dirty check--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli di delete
数据接口删除. 引用该 DI 的 form 会失效.
- 选项:
--id <id>— 数据接口 id--yes— 跳过确认--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli di create
新建数据接口 (v0.11d+ webapi 化 + step machine 校验). 镜像 web dataInterface/Form.vue + 后端 DataInterfaceController.create
- 选项:
--fullName <n>— 名称 (必填, maxlength 50)--enCode <e>— 编码 (必填, maxlength 50, ⚠️ web 端无正则, 不加校验)--category <c>— 分类 id (必填, TreeSelect)--type <t>— 类型: 1=SQL操作 2=静态数据 3=API操作 (默认 2) (默认 "2")--action <a>— 动作 (type=1 必填): 1=增加 2=修改 3=查询 4=删除--sortCode <s>— 排序 0-999999 (默认 0) (默认 "0")--enabledMark <0|1>— 状态 (默认 1) (默认 "1")--hasPage <0|1>— 分页 (默认 0, type=3 常用)--isPostPosition <0|1>— 鉴权 (默认 0) (默认 "0")--description <d>— 说明--from-json-file <f>— 从 JSON 文件读取完整 body (含 dataConfigJson/fieldJson/parameterJson 等, 替代空 placeholder)--fieldJson <json>— 字段映射 JSON 数组字符串 (BS-drift-DI-1 修, 透传 baseline fieldJson)--parameterJson <json>— 参数映射 JSON 数组字符串 (BS-drift-DI-2 修, 透传 baseline parameterJson)--dataConfigJson <json>— 数据源配置 JSON 字符串 (BS-drift-DI-3 修, 透传 baseline 真实 SQL/API 配置)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli di copy
复制数据接口 (v0.15+ 镜像 web copy)
- 选项:
--id <id>— 源 DI id--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli di export
导出数据接口 (v0.15+ 镜像 web exportData)
- 选项:
--id <id>— DI id--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
workflow
dacli workflow list
看流程模板 (--category) 或 我的待办 (--todo 1/2/3).
- 选项:
--category <c>— 模板分类--todo <type>— 我的待办 (1=待审批 2=已审批 3=抄送), 启用此模式时 category 忽略 (默认 "0")--pageSize <s>— 每页 (默认 "50")--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出
dacli workflow info
流程模板详情. AI 引用 workflow id 验证 (P0 闭环). v0.12+ 优先 getFlowInfo 返回完整信息 (含 flowXml/flowNodes/enabledMark/flowId).
- 选项:
--id <id>— 流程模板 id--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出--include-internals— 输出 webapi 内部调试字段 (_fullInfoLoaded/_flowIdUsed/_enabledMarkFromList)
dacli workflow create
新建流程模板 (v0.12+ BS-新27: 6 步 webapi 路径, 镜像 web AiCreateModal 端到端可用)
- 选项:
--fullName <n>— 中文名 (必填)--enCode <e>— 英文编码 (必填或 auto: 从 fullName 生成 snake_case)--category <c>— 分类 id (必填, 跑dacli workflow selector看真实值, 或直接传中文 "项目管理")--type <t>— 流程类型 (0=标准 1=简流, 默认 0) (默认 "0")--flowXml <xml>— BPMN xml (--ai 自动填; 用户直传跳过 AI)--flowConfig <json>— flowConfig JSON 字符串--iconBackground <color>— 图标背景色 (默认 #108ee9) (默认 "#108ee9")--icon <i>— 流程图标 (默认 icon-ym icon-ym-flow) (默认 "icon-ym icon-ym-flow")--sortCode <n>— sortCode 排序 (默认 0) (默认 "0")--showType <n>— 显示位置 (0=全局 1=流程 2=菜单, 默认 0) (默认 "0")--startFormId <id>— 绑定的 formId (绑到 start 节点 formId, 镜像 web 选表单步骤)--layoutThreshold <n>— isLayoutNeeded 重叠阈值 (0-1, 默认 0.8 = 80% 触发 autoLayout) (默认 "0.8")--ai <desc>— AI 创建流程 — 自然语言描述, 走 web 端 getAiInfo 拿 flowXml--auto-authorize— 创建后自动给当前角色授权--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出
dacli workflow update
流程模板修改 (PUT 语义). v0.12+ Bug 2 修: --enabledMark=1 走 saveFlow; Bug 3 修: --startFormId 绑 start node 表单
- 选项:
--id <id>— 流程模板 id--fullName <n>— 中文名--enCode <e>— 英文编码--category <c>— 分类 id--enabledMark <0|1>— 启用/禁用--description <d>— 描述--startFormId <id>— 绑定 start node 的表单 id (配合 --enabledMark=1 使用)--expected-enCode <e>— v0.11e+ Phase A2: 校验 enCode 未变 (防 AI session 误覆盖)--expected-state <s>— v0.11e+ Phase A2: 校验 enabledMark 未变--force— v0.11e+ Phase A2: 跳过 dirty check--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli workflow delete
流程模板删除. 引用该流程的 form 会失效.
- 选项:
--id <id>— 流程模板 id--yes— 跳过确认--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli workflow launch
发起一个流程实例. 需 form.enableFlow=1.
- 选项:
--flowId <id>— 流程模板 id--formId <id>— 绑定的表单 id--data <json>— 表单数据 JSON 字符串 (解析后塞进 formData 字段)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli workflow approve
审批流程节点. 0=同意 1=不同意 2=退回.
- 选项:
--operatorId <id>— 审批节点 id (operatorId)--status <0|1|2>— 0=同意 1=不同意 2=退回 (默认 "0")--opinion <text>— 审批意见--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli workflow decision
决策流参数 (白皮书 5.6.5) — 漏斗/覆盖/规则集/评分卡/交叉表/异常, 是 template 的子配置
- 参数:
templateId— 模板 id, 不传且无 --list 则报错 - 选项:
--list— 列所有 template, 标记是否含决策流节点--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli workflow selector
流程模板下拉框, AI 创建菜单挂工作流 (type=4) 时必跑.
- 选项:
--keyword <k>— 按编码/名称搜索--category <c>— 流程分类--formType <t>— 表单类型过滤 (0=全部 1=在线表单 2=系统表单)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli workflow tasks
查我的流程任务 (待签/待办/已办/抄送 4 类)
- 选项:
--category <1|2|3|4>— 任务分类 1=待签 2=待办 3=已办 4=抄送 (默认 2) (默认 "2")--flowId <id>— 按流程模板 id 过滤--keyword <kw>— 按关键字模糊搜索 (流程名/发起人/单号)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli workflow sync-form
BS-新27 同步 workflow formData + form.workflowEnabled (修 jxcj TC-B 5 fail modal-not-opened)
- 选项:
--flowId <id>— 工作流模板 id (jnpf flowable templateId)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
doc
dacli doc list
列 HTML/MD 文档, AI 上下文恢复时先看 list 再 cat 关键 section.
- 选项:
--dir <d>— 扫描目录 (默认 docs/) (默认 "docs")--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli doc get
读 HTML 文档 section 纯文本. 上下文恢复核心 (CLAUDE.md 强调 token 降低 80%).
- 选项:
--file <f>— HTML/MD 文件路径 (相对 $ccWorkDir 或 cwd)--section <s>— 按 section id 切片 (HTML: e.g. h2_3 / MD: 标题文字 e.g. 当前任务)--from <n>— 起始行号 (1-based, 需配合 --lines) (默认 "1")--lines <n>— 行数 (默认 -1 = 全文, 仅 --from/--lines 模式) (默认 "-1")--strip-mermaid— 去除 Mermaid 代码块 (默认 false)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli doc toc
列 HTML 文件 section 清单 (P0 上下文恢复核心), AI 精准切片避免全文 Read
- 选项:
--file <f>— HTML/MD 文件路径 (相对 docs/ 或绝对)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli doc search
按关键词全文搜索 HTML 文档, 避免 get 全文再 grep 的 token 浪费
- 选项:
--file <f>— HTML/MD 文件路径--keyword <kw>— 搜索关键词 (支持正则)--context <n>— 上下文行数 (默认 3) (默认 "3")--strip-mermaid— 去除 Mermaid 代码块--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
apis
dacli apis list
列 JNPF 平台全量 API. AI 干活前先 --tag 查相关业务接口.
- 选项:
--tag <t>— 按 tag 过滤 (e.g. visualdev / system / workflow)--method <m>— 按 HTTP method 过滤 (GET/POST/...)--keyword <k>— 按 path 或 summary 搜索--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli apis info
查单个 API 详情. 递归解析 $ref 展开 schema (含 ActionResult.data 内层), 写后端/调 API 必备.
- 参数:
pathMethod— API 路径: "GET /api/xxx" 或 "/api/xxx" (默认 GET) - 选项:
--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli apis refresh
强制重拉 /v3/api-docs, 忽略 12h TTL. JNPF 升级/新增 API 后必跑.
dacli apis status
查 OpenAPI 缓存状态. 诊断"list 看不到新 API"——看 ageMs / pathCount.
- 选项:
--json— 原始 JSON 输出
dacli apis search
按字段名搜索 API (P0 字段盲猜痛点, AI 知道 f_xxx 但不知道哪个 API 接受)
- 选项:
--field <f>— 字段名 (如 f_user_name, 默认模糊匹配)--exact— 精确匹配字段名--limit <n>— API 列表最大条数 (默认 50) (默认 "50")--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli apis tags
列 OpenAPI 所有 tag + 每个 tag 下的 API 数量. AI 引导.
- 选项:
--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
datasource
dacli datasource list
列出当前应用所有数据源 (MySQL/SQLServer/Oracle/PostgreSQL 等)
- 选项:
--keyword <k>— 按名称/编码模糊搜索--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli datasource create
新建数据源 (数据库连接配置)
- 选项:
--fullName <name>— 数据源名称--enCode <code>— 数据源编码 (全英文)--dbType <type>— 数据库类型: MySQL/SQLServer/Oracle/PostgreSQL/DM/KingbaseES--host <host>— 主机名--port <port>— 端口--user <user>— 用户名--password <pwd>— 密码--serviceName <name>— 库名 (MySQL/SQLServer/PostgreSQL/KingbaseES 必填)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli datasource test
测试数据源连接 (按 --id 拉配置, 或直接给参数)
- 选项:
--id <id>— 已存在数据源 id (用其配置)--dbType <t>— 数据库类型 (--id 不传时必填)--host <h>— 主机 (--id 不传时必填)--port <p>— 端口--user <u>— 用户名--password <pwd>— 密码--serviceName <n>— 库名--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli datasource delete
删除数据源 (硬删, 无回收)
- 选项:
--id <id>— 数据源 id--yes— 跳过确认--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
report
dacli report list
列出报表 (走 webapi 镜像, 端点 /api/Report 端口 32000)
- 选项:
--keyword <k>— 按名称模糊搜索--currentPage <p>— 页码 (默认 "1")--pageSize <s>— 每页 (默认 "50")--category <c>— [已弃用] 按分类过滤, 改用 --keyword=<分类名/enCode>--type <t>— [已弃用] 按报表类型过滤, 改用 --keyword=<类型>--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli report info
查看报表详情 (走 webapi 镜像, 端点 /api/Report/{id} 端口 32000)
- 选项:
--id <id>— 报表 id--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli report templates
报表选择器 (web 等价: 菜单/下拉/树形展示用, 端点 /api/Report/Selector)
- 选项:
--json— 原始 JSON 输出
dacli report create
新建报表模板 (jnpf 6.x 6.2.0, 走独立报表服务 /api/Report 端口 32000)
- 选项:
--fullName <n>— 报表名称 (镜像 web Form.vue field:fullName)--enCode <e>— 英文编码 (镜像 web Form.vue field:enCode, BS-56 字符限制)--category <c>— 分类 (镜像 web Form.vue field:category) (默认 "报表示例")--description <d>— 说明 (镜像 web Form.vue field:description)--sortCode <s>— 排序码 (镜像 web Form.vue field:sortCode, 0-999999) (默认 "0")--cells <json>— 模板内容 cells (镜像 web Form.vue field:cells, JSON 字符串) (默认 "{"cells":[]}")--snapshot <s>— 模板快照 (镜像 web Form.vue field:snapshot)--from-json-file <f>— 从 JSON 文件读 baseline 完整 schema (含 cells/snapshot, BS-新40 修复)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli report update
修改报表模板 (镜像 web 端 updateReport, jnpf-datareport-univer 微服务 /api/Report/{id})
- 选项:
--id <id>— 报表 id--fullName <n>— 新报表名称--enCode <e>— 新英文编码--category <c>— 新分类--description <d>— 新说明--sortCode <s>— 新排序码 (0-999999)--cells <json>— 新模板内容 cells (JSON 字符串)--snapshot <s>— 新模板快照--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli report save
保存报表设计 (v0.16+ 新增, 替代 release --type=0)
- 选项:
--id <id>— 报表 id--cells <json>— 设计 cells JSON 字符串 (必传, saveVersion 入参)--dataSets <json>— 数据集列表 JSON 数组字符串--columnList <json>— 列定义 JSON 数组字符串--queryList <json>— 查询参数 JSON 数组字符串--versionId <id>— 版本 id (留空则创建新版本)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli report publish
发布+部署报表 (v0.16+ 新增, 替代 release --type=1)
- 选项:
--id <id>— 报表 id--cells <json>— 设计 cells JSON 字符串 (type=1 必传, 后端校验)--dataSets <json>— 数据集列表 JSON 数组字符串--columnList <json>— 列定义 JSON 数组字符串--queryList <json>— 查询参数 JSON 数组字符串--versionId <id>— 版本 id (留空则创建新版本)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli report release
发布/保存报表设计 (BS-新116, jyzs 2026-07-02 实战补 release 子命令, 走 webapi/report.saveVersion 镜像 web 端 saveVersion)
- 选项:
--id <id>— 报表 id--type <0|1>— 类型: 0=保存设计 (推荐 save) 1=发布+部署 (推荐 publish), 默认 1 (默认 "1")--cells <json>— 设计 cells JSON 字符串 (type=1 必传)--dataSets <json>— 数据集列表 JSON 数组字符串--columnList <json>— 列定义 JSON 数组字符串--queryList <json>— 查询参数 JSON 数组字符串--versionId <id>— 版本 id (留空则创建新版本)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli report delete
删除报表 (BS-新116 配套, 镜像 web report.ts:30 delReport, jnpf-datareport-univer /api/Report/{id})
- 选项:
--id <id>— 报表 id--cascade— 级联清理: 删报表 + 删挂的菜单 (f_module_type=report)--yes— 跳过 TTY 确认 (强制删除)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
portal
dacli portal list
列出门户 (门户设计器产物)
- 选项:
--keyword <k>— 按名称/编码模糊搜索--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli portal info
查看门户的完整 schema (含布局/组件)
- 选项:
--id <id>— 门户 id--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli portal create
新建门户 (首页/工作台设计器产物)
- 选项:
--fullName <name>— 门户名称--enCode <code>— 门户编码--category <cat>— 分类: 字典 businessType 的 id/enCode/fullName (留空自动派生, 推荐留空)--platform <p>— 平台: Web/App/PC (默认 "Web")--type <t>— 门户类型: 0=页面 1=外链 (镜像 Form.vue:55-67)--platformType <t>— 平台类型: 0=门户设计 1=配置路径 (镜像 Form.vue:75-87)--link <url>— 外链 URL (type=1 必填, 镜像 Form.vue:90-105)--description <d>— 门户描述 (镜像 PortalCrForm.description)--customUrl <url>— 配置路径 (镜像 PortalCrForm.customUrl, platformType=1)--appCustomUrl <url>— 应用配置路径 (镜像 PortalCrForm.appCustomUrl)--linkType <n>— 链接类型 (镜像 PortalCrForm.linkType, 0/1) (默认 "0")--formData <json>— 门户布局 formData (JSON 字符串, 镜像 PortalCrForm.formData)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli portal release
发布门户 (state 0→1, 必传 pc/app/platformRelease 三参; BS-109 自动检测 pcModuleParentId)
- 选项:
--id <id>— 门户 id--pc <0|1>— PC 端是否发布 (1=发布, 0=不发布, 默认 1) (默认 "1")--app <0|1>— App 端是否发布 (1=发布, 0=不发布, 默认 0) (默认 "0")--pcSystemId <id>— PC 端 systemId (BS-109, 不传从 ctx.currentSystemId 取)--pcModuleParentId <id>— PC 端菜单父级 id (BS-109, 不传自动检测顶级菜单)--appSystemId <id>— App 端 systemId (BS-109)--appModuleParentId <id>— App 端菜单父级 id (BS-109, 不传自动检测顶级菜单)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli portal set-default
设为默认门户 (BS-110 jyzs 2026-07-02; 注意: setDefaultPortal 收 menu id 不是 portal id, 命令内部自动转换)
- 选项:
--portalId <id>— 门户 id (推荐; 内部 portal.id → menu.id)--menuId <id>— 菜单 id (PortalDataController.setDefault 直接收这个)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
bigscreen
dacli bigscreen list
列出大屏 (大屏设计器产物)
- 选项:
--keyword <k>— 按名称/编码模糊搜索--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli bigscreen info
查看大屏详情
- 选项:
--id <id>— 大屏 id--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli bigscreen create
新建大屏 (jnpf 6.x 6.2.0, 走 datascreen-vue3 webapp /api/visual/save 端口 32000)
- 选项:
--fullName <name>— 大屏名称 (镜像 web visual.js addObj: visual.title)--enCode <code>— 大屏编码 (镜像 web visual.js addObj)--category <cat>— 分类: 1=数据大屏 2=仪表盘 (镜像 web visual.js addObj: visual.category)--password <p>— 访问密码 (镜像 web visual.js addObj: visual.password) (默认 "")--status <s>— 状态 0/1 (镜像 web visual.js addObj: visual.status) (默认 "1")--width <n>— 宽度 (镜像 web visual.js addObj: config.detail.width) (默认 "1920")--height <n>— 高度 (镜像 web visual.js addObj: config.detail.height) (默认 "1080")--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli bigscreen update
大屏修改. 改 fullName/enCode/category, PUT 语义 + v0.11e+ dirty check.
- 选项:
--id <id>— 大屏 id--fullName <n>— 大屏名--enCode <e>— 大屏编码--category <c>— 分类 (1=数据大屏 2=仪表盘)--expected-enCode <e>— v0.11e+ Phase A2: 校验 enCode 未变 (防 AI session 误覆盖)--force— v0.11e+ Phase A2: 跳过 dirty check--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli bigscreen delete
大屏删除
- 选项:
--id <id>— 大屏 id--yes— 跳过确认--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli bigscreen release
发布大屏 (state 0→1, 菜单可挂)
- 选项:
--id <id>— 大屏 id--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli bigscreen construct
构造大屏 (v0.13+ 镜像 web 端 save formdata 镜像 + 内置模板/用户 JSON/单组件添加, 端到端一气呵成)
- 选项:
--fullName <name>— 大屏名称 (镜像 web visual.js addObj: visual.title)--enCode <code>— 大屏编码 (镜像 web visual.js addObj, ENCODE_REGEXP 校验)--category <cat>— 分类: 1=数据大屏 2=仪表盘--template <t>— 内置模板: base=空大屏 (默认 9 组件 demo) (默认 "base")--from-template <name>— 官方模板 (Phase 5+ 扩展, 暂等同 --template=base)--from-json <file>— 用户设计 JSON (含 baseConfig + nav 两段)--prop <name>— 组件 prop (多次: --prop=bar --prop=text) (默认 [])--x <n>— 组件 x 坐标 (单组件默认 0)--y <n>— 组件 y 坐标 (单组件默认 0)--w <n>— 组件宽度 (默认 400)--h <n>— 组件高度 (默认 300)--dataType <n>— 数据源类型 0-7 (镜像 build.vue:666-689)--url <u>— 数据源 URL (dataType=1/3/5/6)--sql <s>— 数据源 SQL (dataType=2)--value <v>— 数据源 value (dataType=0/4)--width <n>— 大屏宽度 (默认 1920)--height <n>— 大屏高度 (默认 1080)--backgroundUrl <u>— 缩略图 URL (web visual.js put-file/screenShot 上传后回填)--status <s>— 状态 0/1 (默认 1=已发布, --no-release 时无效) (默认 "1")--validate-only— 只校验, 不创建--no-release— 创建后不发布 (默认 ON 发布)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
app
dacli app list
列出所有应用 (JNPF 多 app 生命周期, 不同于当前登录 appCode). v3.0+ 走 webapi/system.getSystemList
- 选项:
--keyword <k>— 按名称/编码模糊搜索--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli app info
查看应用详情 (含 systemId/系统配置等). v3.0+ 走 webapi/system.getInfo
- 选项:
--id <id>— 应用 id--json— 原始 JSON 输出
dacli app init
应用初始化 (健康检查 + system 缺失检测; v3.0+ 移除 --restart)
- 选项:
--appCode <code>— 应用 code (不传则用当前登录)--auto-recover— v0.11e+ B-2: 检测到 base_system 缺失时自动调 app create 重建--appName <name>— auto-recover 时传给 app create 的中文名 (默认 "未知应用")
dacli app create
真·创建 JNPF 应用 (System+DB+DataSource+授权+重登, 端到端 0 差错). v3.0+ step 1/4 走 webapi/system 镜像
- 选项:
--appCode <code>— 应用编码 (英文, 唯一)--appName <name>— 应用中文名称--dbName <db>— 数据库名 (默认同 appCode)--account <a>— 管理员账号 (默认 admin) (默认 "admin")--password <p>— 管理员密码 (默认 123456) (默认 "123456")--force-rebuild— 已存在时强制删旧 datasource 重建--skip-grant— 跳过 saveAppAuthorization--skip-db— 跳过 ssw-common 真建 DB (用户已建好)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli app clear
清除 JNPF 应用的本地资源 + 数据库记录. DB 操作走 ssw-common POST /api/ssw/db/clear (PG/MySQL 自动适配), 文件备份到 docs/{app}/history-bak/{ts}/.
- 选项:
--appCode <code>— 要清除的应用代码 (e.g. tds, tds2)--dry-run— 只预览, 不实际删除/备份 (任何环境可用, 无需 TTY)--skip-db— 跳过数据库清理 (仅清理本地文件 + 构建配置)--no-restart— 清理后不询问 create 重建 (默认询问 Y/N)--clean-docs— v3.0+ P1-2d: 同时把 docs/{app}/ 整体移到 history-bak/docs/ (含 8+ MD + _assets/test_logs/screenshots 子目录). 默认 false 保持向后兼容, docs 是设计依据建议保留--workspace <dir>— 工程根目录 (默认 $ccWorkDir 或 cwd)--verbose— 完整输出 (含 dry-run 详细预览)--json— 原始 JSON 输出 (--dry-run + --json 给 AI 解析清单; 真实执行时仍走人类 TTY)--only <list>— 只清这些范围 (逗号分隔: workflow,di,portal,print,report,schedule,dict,biz,form; 例: --only=workflow,di 跨 app 清残留)--scope <preset>— 预设范围: all (默认, 全清) | conservative (只 form+dict+biz, 不动 workflow/di/portal 全局资源)--no-include-workflow— 不包含 workflow_template 等 23 张 (默认 true)--no-include-di— 不包含 base_data_interface 等 5 张 (默认 true)--no-include-portal— 不包含 base_portal 等 3 张 (默认 true)--no-include-print— 不包含 base_print_template 等 3 张 (默认 true)--no-include-report— 不包含 report_template (默认 true)--no-include-schedule— 不包含 base_schedule 等 3 张 (默认 true)--no-include-dict— 不包含 base_dictionary_type + data (默认 true)--no-include-biz— 不包含业务库 RENAME (默认 true)--include-ghost— P1-2e 2026-07-23: 启用 ghost 模式, 清理跨 systemId 残留 (高危, 默认 false; 适用于删+重建同名 app 后清理旧 enCode)
dacli app login
登录 JNPF, 把 token 写到 ~/.dacli-token/token.json (默认 home, 可由 DACLI_TOKEN_DIR env 覆盖), 后续命令自动复用
- 选项:
--account <a>— 账号 (默认 "admin")--password <p>— 密码 (明文; 96 字符 hex 视为已加密) (默认 "123456")--appCode <c>— 应用代码 (testspace 推荐=测试场 | jxcj=业务 | developSystem/workSystem=只读 baseline) (默认 "testspace")--baseUrl <u>— JNPF API 根地址 (含 /api)--no-check-system— 跳过 base_system 存在性检测 (默认 ON, v0.11e+ Phase E)--verbose— 完整输出 (含 base_system 检测等过程日志)
dacli app logout
退出登录 (走 webapi/auth.logoutApi + 清本地 token). v3.0+ 新增 (审计 P2 补缺)
- 选项:
--no-remote-logout— 跳过 web logoutApi, 仅清本地 token (断网/无后端场景)--json— 原始 JSON 输出
dacli app status
显示当前登录状态. 写脚本前先跑一下确认登录态
- 选项:
--json— 以 JSON 输出 (便于脚本)--no-check-system— 跳过 base_system 存在性检测 (默认 ON, v0.11e+ Phase E)
dacli app switch
切换当前应用, 重新登录并覆盖本地 token. baseline 复刻常用
- 选项:
--appCode <c>— 目标应用代码--account <a>— 账号--password <p>— 密码
dacli app context
输出当前应用环境快照 (appCode/dbLinkId/token 状态/enCode/表/菜单). AI 新会话第一步先跑此命令, 所有参数从此快照取, 不要猜测.
- 选项:
--json— 单行 JSON 输出 (AI 友好)--verbose— 完整输出 (含 loadAppContext 内部 API 调用日志)--app <appCode>— 覆盖 token 中的 appCode (供快速切换测试)
dacli app use
一体化命令 (v3.0+ P1): switch + context + CurrentUser, AI 工作流一步到位
- 参数:
appCode— 目标应用代码 (testspace=测试场 | jxcj=业务 | developSystem/workSystem=只读 baseline, 禁止改) - 选项:
--account <a>— 账号 (默认从当前 token 读, 否则 admin)--password <p>— 密码 (默认 123456)--no-current-user— 跳过 CurrentUser 验证 (默认走, 服务器端确认 token+appCode+用户)--json— 原始 JSON 输出
dacli print list
列出打印模板 (绑 form 数据, 套打)
- 选项:
--keyword <k>— 按名称/编码模糊搜索--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli print info
查看打印模板详情
- 选项:
--id <id>— 打印模板 id--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli print create
新建打印模板 (绑 form 数据, 套打)
- 选项:
--fullName <name>— 打印模板名称 (maxlength 100, web printDev 特殊)--enCode <code>— 打印模板编码 (formValidate 正则, BS-56)--category <cat>— 分类: 1=系统打印 2=表单打印--formId <id>— 绑定的 form id (category=2 时必填, v3 新增)--commonUse <0|1>— 常用标记 (Switch, 默认 0, =1 时 icon 必填) (默认 "0")--icon <name>— 图标 (commonUse=1 时必填, v3 条件校验)--visibleType <1|2>— 发布范围 (1=公开 2=权限设置, 仅 commonUse=1 时校验) (默认 "1")--description <desc>— 说明 (Textarea)--sortCode <n>— 排序码 (0-999999) (默认 "0")--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli print update
修改打印模板 (v0.15+ 镜像 web 端 updatePrintDev)
- 选项:
--id <id>— 打印模板 id--fullName <n>— 中文名--enCode <e>— 英文编码--category <c>— 分类 id--type <t>— 类型 (1=简单打印 2=设计器打印 3=模板打印)--sortCode <s>— 排序 0-999999 (默认 "0")--enabledMark <0|1>— 启用 (默认 1) (默认 "1")--commonUse <0|1>— 常用 (默认 0, type=2 时必填) (默认 "0")--visibleType <0|1|2>— 可见范围 (0=全部 1=本角色 2=本部门, 默认 0) (默认 "0")--icon <i>— 图标 (commonUse=1 时必填)--formId <id>— 绑定的表单 id (type=2 必填)--description <d>— 说明--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli print delete
删除打印模板 (v0.15+ 镜像 web delPrintDev)
- 选项:
--id <id>— 打印模板 id--yes— 跳过 TTY 确认 (强制删除)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
role
dacli role list
列出角色 (权限载体, P1 权限三角核心)
- 选项:
--keyword <k>— 按名称/编码模糊搜索--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli role info
角色详情. AI 创建角色后验证 (P0 闭环, v0.11+ webapi).
- 选项:
--id <id>— 角色 id--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli role create
新建角色 (P1 权限三角核心). v0.11d+ 加 step machine 校验 (3 step 镜像 web role/Form.vue + 后端 RoleController.create, BS-47 唯一性预校验, 约束字段联动校验, 聚合错误). v0.11e+ Phase A3 加 --user-ids 跨命令事务 (建角色后批量绑用户, 镜像 web roleRelationService.create).
- 选项:
--fullName <name>— 角色名称--enCode <code>— 角色编码--type <t>— 角色类型: 0=全局 1=业务 (默认 "0")--user-ids <ids>— 关联用户 id 列表 (逗号分隔, 例: 1,2,3). v0.11e+ Phase A3 跨命令事务 (镜像 web roleRelationService.create)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli role update
角色修改 (改 fullName/enCode/enabledMark/description). PUT 语义, 未传字段保留原值.
- 选项:
--id <id>— 角色 id--fullName <n>— 中文名--enCode <e>— 英文编码--enabledMark <0|1>— 启用/禁用--description <d>— 描述--expected-enCode <e>— v0.11e+ Phase A2: 校验 enCode 未变 (防 AI session 误覆盖)--expected-state <s>— v0.11e+ Phase A2: 校验 enabledMark 未变--force— v0.11e+ Phase A2: 跳过 dirty check--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli role delete
删除角色 (isSystem=1 系统内置角色不可删)
- 选项:
--id <id>— 角色 id--yes— 跳过确认--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli role assign
给角色赋用户 (或从角色删用户, v0.15+ webapi 镜像 web roleRelation.ts addRoles/removeRoles)
- 选项:
--roleId <id>— 角色 id--userIds <ids>— 用户 id 列表 (逗号分隔)--action <a>— add=加用户, remove=删用户 (默认 "add")--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli role selector
角色下拉框. AI 选角色 id 必需 (form 配置 / menu 授权).
- 选项:
--type <t>— 角色类型 (0=全局 1=部门)--isSystem <0|1>— 是否系统内置--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
user
dacli user info
用户信息查询 (v3.0+ 双入口: 无 id 走 CurrentUser, 有 id 走 web getUserInfo)
- 参数:
id— 用户 id (省略则查 CurrentUser) - 选项:
--backend <0|1>— 后台管理端标志 (CurrentUser 用, 0=前台 1=后台, 默认 1) (默认 "1")--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli user list
列出用户 (P1 权限三角 2 号, 登录主体)
- 选项:
--keyword <k>— 按账号/姓名/手机模糊搜索--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli user create
新建用户 (P1 权限三角 2 号)
- 选项:
--account <a>— 账号 (登录名)--realName <n>— 真实姓名--password <p>— 明文密码 (后端会自动 md5 加密)--organizeId <id>— 所属组织 id (决策 7: 必须)--gender <g>— 性别: 1=男 2=女 3=未知 (默认 "1")--enabledMark <m>— 状态: 0=禁用 1=启用 2=锁定 (默认 "1")--sortCode <n>— 排序 (默认 "0")--description <d>— 说明--roleId <id>— v0.11e+ Phase C1: 角色 id (PS012 必填, 镜像 web user/Form.vue)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli user update
编辑用户 (admin 操作, PUT /Users/{id} + v0.11e+ dirty check)
- 选项:
--id <uid>— 用户 id--fields <json>— 要更新的字段 JSON, 如 {"realName":"新名","email":"x@y"}--expected-account <a>— v0.11e+ Phase A2: 校验 account 未变 (防 AI 误覆盖)--force— v0.11e+ Phase A2: 跳过 dirty check--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli user delete
删除用户 (isAdministrator=1 不可删)
- 选项:
--id <id>— 用户 id--yes— 跳过确认--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli user resetPwd
重置用户密码 (admin 操作, 镜像 web 端 ResetPassword.vue)
- 选项:
--id <id>— 用户 id--password <p>— 新明文密码 (dacli 自动 md5 加密, 跟后端 web 端行为一致)--account <a>— 账号 (可选, 默认从 user info 拿)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli user unlock
解除用户锁定 (admin 操作)
- 选项:
--id <uid>— 用户 id--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli user batch-state
批量启/禁/锁用户 (admin 操作)
- 选项:
--ids <list>— 用户 id 列表, 逗号分隔--state <n>— 状态: 0=禁用 1=启用 2=锁定--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli user batch-delete
批量删除用户 (admin 操作)
- 选项:
--ids <list>— 用户 id 列表, 逗号分隔--yes— 跳过确认--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli user batch-set-position
批量设置用户岗位 (admin 操作)
- 选项:
--userIds <list>— 用户 id 列表, 逗号分隔--positionIds <list>— 岗位 id 列表, 逗号分隔--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli user get-position
查询用户岗位 (admin 操作, 返回岗位数组)
- 选项:
--id <uid>— 用户 id--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli user set-position
设置用户岗位 (admin 操作, 全量替换)
- 选项:
--id <uid>— 用户 id--positionIds <list>— 岗位 id 列表, 逗号分隔 (替换原岗位)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli user workHandover
工作交接 (admin 操作, 默认全交接)
- 选项:
--fromUserId <uid>— 移交人 id--toUserId <uid>— 接收人 id--excludeTasks— 排除流程待办--excludeFlows— 排除流程实例--excludeApps— 排除我的应用--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli user socials-unbind
解绑社交账号 (admin 操作)
- 选项:
--userId <uid>— 用户 id--socialsId <sid>— 社交账号 entity.id (web 端 entity.id)--list— 列出该用户的所有社交账号绑定, 不解绑--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli user online-kick
强制下线某 token (admin/self 操作, 防自踢)
- 选项:
--token <t>— 要踢的 token (从 onlineUser 列表获取)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli user changepwd
修改当前用户密码 (self 操作, 简化: 仅需旧密码+新密码)
- 选项:
--oldPassword <p>— 旧密码 (明文)--newPassword <p>— 新密码 (明文)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli user baseinfo
修改当前用户个人资料 (self 操作, 通用入口)
- 选项:
--fields <json>— 要更新的字段 JSON, 如 {"mobilePhone":"138...","email":"x@y","realName":"新名"}--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli user auth-groups
查用户权限分组 (admin 操作, 返回角色/岗位/组织树)
- 选项:
--userId <uid>— 用户 id--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli user auth-list
查用户具体权限 (admin 操作, 7 类: 菜单/按钮/列表/表单/数据/流程/打印)
- 选项:
--userId <uid>— 用户 id--objectId <id>— object id (从 auth-groups 拿)--objectType <t>— object 类型: role | position | organize--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
org
dacli org list
列出组织树 (P1 权限三角 3 号)
- 选项:
--parentId <id>— 从指定父节点展开 (默认根 "0") (默认 "0")--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli org tree
组织树形结构 (单层展示)
- 选项:
--parentId <id>— 从指定父节点展开 (默认 "0" 根) (默认 "0")--maxDepth <n>— 最大递归深度 (默认 "3")--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli org create
新建组织 (v0.11e+ Phase D1 + step machine 校验, 镜像 web organize/Form.vue + 后端 OrganizeController + PS013/PS036)
- 选项:
--fullName <name>— 组织名称--enCode <code>— 组织编码--parentId <pid>— 上级组织 id (顶级传 -1)--category <c>— 组织类型: 0=公司 1=部门 2=小组--enabledMark <m>— 0/1 启用 (默认 "1")--sortCode <s>— 排序 (默认 "0")--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
msg
dacli msg noticeList
列出通知公告 (站内信, msgCenter)
- 选项:
--keyword <k>— 按名称/编码模糊搜索--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli msg noticeCreate
新建通知公告 (草稿, 用 notice-release 发布)
- 选项:
--fullName <name>— 通知标题--enCode <code>— 通知编码--body <text>— 通知正文 (可选)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli msg noticeUpdate
通知公告修改. 改 fullName/enCode/body/category, PUT 语义 + v0.11e+ dirty check.
- 选项:
--id <id>— 公告 id--fullName <n>— 公告名--enCode <e>— 英文编码--body <text>— 公告内容--category <c>— 分类 (1=系统 2=业务)--expected-enCode <e>— v0.11e+ Phase A2: 校验 enCode 未变--force— v0.11e+ Phase A2: 跳过 dirty check--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli msg noticeDelete
通知公告删除
- 选项:
--id <id>— 公告 id--yes— 跳过确认--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli msg noticeSend
发送/发布通知 (决策 8: 通道 site/email/sms/webhook/dingTalk/weCom)
- 选项:
--id <id>— 通知 id--type <t>— 通道: site=站内信 (默认) | email=邮件 | sms=短信 | webhook=Webhook | dingTalk=钉钉 | weCom=企微 (默认 "site")--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli msg templateList
列出消息模板 (站内信/邮件/短信 模板)
- 选项:
--keyword <k>— 按名称/编码模糊搜索--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli msg templateCreate
新建消息模板 (修复 v0.10 错误端点)
- 选项:
--fullName <name>— 模板名称--enCode <code>— 模板编码 (全平台唯一)--category <c>— 分类 (1=系统 2=业务) (默认 "1")--content <text>— 模板内容 (可选)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli msg templateUpdate
消息模板修改
- 选项:
--id <id>— 模板 id--fullName <n>— 模板名--enCode <e>— 英文编码--category <c>— 分类 (1=系统 2=业务)--content <text>— 模板内容--enabledMark <0|1>— 启用/禁用--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli msg templateDelete
消息模板删除
- 选项:
--id <id>— 模板 id--yes— 跳过确认--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
schedule
dacli schedule list
列定时任务 (JNPF 6.2 端点 bug, 兜底用 info/log 单点查)
- 选项:
--json— 原始 JSON 输出
dacli schedule info
查看定时任务详情 (Quartz cron + 执行配置)
- 选项:
--id <id>— 定时任务 id--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli schedule create
新建定时任务 (Quartz cron, 决策 9: 与工作流区别)
- 选项:
--fullName <name>— 任务名称--enCode <code>— 任务编码--executeType <t>— 执行类型 (e.g. SQL/JavaScript/...)--executeContent <c>— 执行内容 (SQL 脚本/JS 代码)--cron <expr>— cron 表达式 (e.g. "0 0 0 * * ?")--startTime <iso>— v0.11e+ Phase C1: 开始时间 (ISO 格式, SYS131 校验)--endTime <iso>— v0.11e+ Phase C1: 结束时间 (ISO 格式, SYS131 校验)--enabledMark <m>— v0.11e+ Phase C1: 0/1 (默认 "1")--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli schedule update
定时任务修改 (改 cron/executeContent/enabledMark, v0.11+ webapi + v0.11e+ dirty check + step machine)
- 选项:
--id <id>— 任务 id--fullName <n>— 任务名--enCode <e>— 英文编码--cron <c>— cron 表达式 (如 "0 0 * * * ?")--startTime <iso>— v0.11e+ Phase C1: 开始时间 (ISO 格式)--endTime <iso>— v0.11e+ Phase C1: 结束时间 (ISO 格式, SYS131)--executeContent <c>— 执行内容 (Quartz class 全名 + 参数)--enabledMark <0|1>— 启用/禁用 (JNPF 无独立 pause/resume API, 用此替代)--expected-enCode <e>— v0.11e+ Phase A2: 校验 enCode 未变--force— v0.11e+ Phase A2: 跳过 dirty check--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli schedule delete
定时任务删除. 任务调度会停.
- 选项:
--id <id>— 任务 id--yes— 跳过确认--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli schedule trigger
手动触发定时任务 (不等 cron, 立即跑)
- 选项:
--id <id>— 定时任务 id--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli schedule log
查看定时任务执行日志
- 选项:
--id <id>— 定时任务 id--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
monitor
dacli monitor server
服务器状态 (CPU/内存/磁盘/JVM, AI 性能诊断最高优先级). v0.11+ webapi.
- 选项:
--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli monitor online
在线用户监控 (当前登录的用户)
- 选项:
--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli monitor sql
SQL 监控 (数据接口调用日志)
- 选项:
--id <id>— 数据接口 id--json— 原始 JSON 输出
dacli monitor flow
流程监控 (待办/运行中流程)
- 选项:
--json— 原始 JSON 输出
log
dacli log login
登录日志
- 选项:
--keyword <k>— 按账号/姓名模糊搜索--json— 原始 JSON 输出
dacli log operate
操作日志
- 选项:
--keyword <k>— 按账号/姓名模糊搜索--json— 原始 JSON 输出
dacli log exception
异常日志 (Java 异常堆栈, AI 调试后端错误核心入口).
- 选项:
--keyword <k>— 按账号/异常名/URL 模糊搜索--limit <n>— 最多取 N 条 (默认 20) (默认 "20")--json— 原始 JSON 输出
dacli log request
请求日志 (API 调用审计). 排查 API 调用失败 / IP 异常.
- 选项:
--keyword <k>— 按账号/URL 模糊搜索--limit <n>— 最多取 N 条 (默认 20) (默认 "20")--json— 原始 JSON 输出
dacli log last
查看最近一次 dacli 命令日志 (v2.0+, v2.3+ 加 --kind)
- 选项:
--detail— 显示完整详情 (含回滚命令、原始请求/响应)--level <l>— 只看特定级别: silent / fix (assertive) / suggest--kind <k>— 按 kind 过滤 (v2.3+): warn / skip-force / ai-login / <id 前缀如 BS-DC P1-7>--raw— 输出原始 JSON
integration
dacli integration emailTest
邮件测试发送 (修复 v0.10 假 PASS 端点)
- 选项:
--configId <id>— AccountConfig id (从 integration configList 获取)--email <e>— 目标邮箱 (必填, 必填收件人) (默认 "[email protected]")--title <t>— 测试邮件标题 (默认 "Test from dacli")--content <c>— 测试邮件内容 (默认 "This is a test email sent by dacli.")--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli integration smsTest
短信测试发送 (修复 v0.10 假 PASS 端点)
- 选项:
--configId <id>— AccountConfig id--phone <n>— 目标手机号 (默认 "13800138000")--templateId <t>— 短信模板 ID (覆盖 config 默认模板)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli integration webhookTest
Webhook 测试发送 (修复 v0.10 假 PASS 端点)
- 选项:
--configId <id>— AccountConfig id (已配置 webhook 账号)--url <u>— 临时 webhook URL (不依赖 config, 单独测试)--payload <p>— JSON payload (字符串) (默认 "{}")--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
storage
dacli storage list
列出 application-{profile}.yml 中 file-storage 配置的所有后端 (含 enable-storage / default 状态)
- 选项:
--profile <p>— spring profile (默认 dev) (默认 "dev")--yml <path>— 显式指定 yml 路径 (覆盖 --profile 默认推断)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli storage info
显示某 platform 的详细配置 (access-key / secret-key 等敏感字段自动脱敏)
- 参数:
platform— platform 实例名, 如 local-plus-1 / aliyun-oss-1 / minio-1 - 选项:
--profile <p>— spring profile (默认 dev) (默认 "dev")--yml <path>— 显式指定 yml 路径--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli storage test
测试存储后端连通性 — 走 JNPF /api/file/Uploader/{type} 上传 1KB 测试文件
- 参数:
platform— 可选 platform 实例名, 不传则测所有 enableStorage=true 的 - 选项:
--profile <p>— spring profile (默认 dev) (默认 "dev")--yml <path>— 显式 yml 路径--type <t>— 只测某 type, 如 aliyun-oss/minio (默认全测启用的)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli storage use
切换 file-storage.default-platform — 改 yml + 备份 + 提示手动重启
- 参数:
platform— 目标 platform 实例名, 如 minio-1 / aliyun-oss-1 - 选项:
--profile <p>— spring profile (默认 dev) (默认 "dev")--yml <path>— 显式 yml 路径--no-backup— 跳过备份 (不推荐)--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli storage backup
显式备份 application-{profile}.yml 到 .history/ 目录
- 选项:
--profile <p>— spring profile (默认 dev) (默认 "dev")--yml <path>— 显式 yml 路径
dacli storage diff
跟 git HEAD 对比 application-{profile}.yml — 看 storage use 改了什么
- 选项:
--profile <p>— spring profile (默认 dev) (默认 "dev")--yml <path>— 显式 yml 路径
test
dacli test run
跑 form API 测试 (POST/GET/PUT/DELETE + 跨表 join + 业务规则, 默认走真实业务数据)
- 选项:
--formId <id>— 目标 form id--output <file>— 输出报告文件路径 (默认 stdout)--keep-data— 保留测试数据不删 (默认 ON, 留数据供 TC-B 浏览器验证) (默认 true)--no-keep-data— 跑完立即 DELETE 清理 (test fixture 旧行为)--real-data— 真实业务数据模式 (字段语义化默认值 + 关联表真实 ID lookup, 默认 ON) (默认 true)--no-real-data— 关闭真实业务数据模式, 退回 test fixture (向后兼容 v0.11e)--real-fields <json>— 自定义真实业务数据 JSON (优先级最高, 例: '{"f_team_name":"数据先锋队"}')--relation-form-lookup— relationForm 字段自动从关联表拉真实 ID (而非跳过, 默认 ON) (默认 true)--no-relation-form-lookup— 关闭 relationForm 自动 lookup--relation-form-sample <n>— 关联表拉前 N 条数据作为 sample (默认 1, 最大 5) (默认 "1")--join-check— POST 后跑跨表 join 校验, 验证外键字段可查到关联表记录--join-rules <json>— join 规则 JSON (例: '[{"fkField":"f_team_id","targetEnCode":"jxcj_team","checkField":"f_team_name"}]')--business-rules <json>— 业务规则 JSON (例: '[{"field":"f_team_size","rule":">=3","msg":"团队人数下限 3 人"}]')--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出
dacli test generate
生成浏览器 E2E 脚本 (playwright bash, 覆盖 vmodel bind bug)
- 选项:
--formId <id>— 目标 form id--output <file>— 输出脚本路径 (默认 stdout)--appCode <code>— 应用编码 (默认从 token.json 读)
dacli test render
源码渲染验证 (替代浏览器验证) — 读 vue 渲染契约 + 调 API, 检查字段完整性 (~2s)
- 选项:
--module <m>— 模块名: dict | form | di | menu | portal | workflow | role | msg | schedule | monitor | user | log | report | bigscreen--typeId <id>— 字典类型 id (dict module 验证数据时必填)--id <id>— 实体 id (验证单条数据时用, menu module 验证单条菜单 propertyJson schema)--formId <id>— 表单 id (form module 必填)--json— 原始 JSON 输出--no-required-field-check— 关闭必填字段 vmodel 完整性校验 (默认 ON)--no-relation-form-data-check— 关闭 relationForm 弹窗数据可达性校验 (默认 ON, 默认 WARN 模式)--relation-form-data-strict— 弹窗数据为空时返回 FAIL 而非 WARN (默认 OFF=WARN)--no-column-list-required— 关闭 columnList 列配置完整性校验 (默认 ON, webType≠1)--no-jnpfkey-valid-check— 关闭 jnpfKey 有效性校验 (镜像 web FormGenerator 白名单, 默认 ON)--no-dict-bind-valid-check— 关闭字典绑定有效性校验 (dictionaryType 在 dict 表存在, 默认 ON)--no-label-complete-check— 关闭 formItem label 完整性校验 (非空 + 唯一, 默认 ON)--no-required-control-type-check— 关闭必填字段控件类型校验 (必填不能在 switch/button 容器, 默认 ON)--no-column-list-subtable-check— 关闭 columnList 子表字段引用校验 (tableFieldXXX-F_* 引用错配, 默认 ON)
dacli test browser
浏览器真实行为验证 (v0.21+ TC-B, 跟 render 互补) — 用 playwright 跑 DOM 实际渲染, 7 检查 (form/workflow)
- 选项:
--module <m>— 模块名: form | workflow (后续扩展 dict/di/menu/portal/report/bigscreen)--id <id>— 实体 id (workflow module 可选, 不传只跑 UI 检查; form module 用 --formId 别名)--formId <id>— 表单 id (form module 必填, 向后兼容别名, 等同 --id)--appCode <app>— 应用 code (默认 workSystem, testspace 也可) (默认 "workSystem")--baseUrl <url>— 后端 base URL (默认 "http://nginx")--no-snapshot— 不存储 storage snapshot (每次重新 login)--json— 原始 JSON 输出
selfcheck
dacli selfcheck
v0.11d+ 强制纪律自检 (镜像 CLAUDE.md §2.7.1 自检清单 8 项). AI 场景补充, 非 web 镜像. 防止改前漏读 web/backend 源码 / 漏写 MEMORY / --help 漏 "镜像" / SKILL.md 漏 v0.11d+ 段.
- 参数:
files— 要检查的 TS 文件路径 (可多个) - 选项:
--json— 原始 JSON 输出
drift-check
dacli drift-check
v0.11e+ Phase D2 漂移检测 (web 端重构 / 后端变更 / 校验规则变化). AI 场景补充, 非 web 镜像
- 选项:
--days <n>— 检查最近 N 天的 drift (默认 "7")--json— 原始 JSON 输出
coverage
dacli coverage
v0.11e+ Phase D2 覆盖率报告 (5 大机制镜像率 + 命令级详情 + 优先级分组). AI 场景补充, 非 web 镜像
- 选项:
--json— 原始 JSON 输出--detailed— 显示命令级详情
kb
dacli kb init
Initialize ssw_kb schema (idempotent)
dacli kb list
List all KB domains
- 选项:
--verbose— 完整输出 (含 step machine、API 调用等过程日志)--json— 原始 JSON 输出 (不受 --verbose 影响, 始终输出 JSON)
dacli kb show
Show full KB content for a domain
- 参数:
domain— Domain name (e.g. dacli)
dacli kb search
Full-text search via tsvector (BM25-like ranking)
- 参数:
query— Search query string - 选项:
-d, --domain <domain>— Filter by domain-l, --limit <n>— Limit results (默认 "10")--all— Include expired/archived entries--json— Output as JSON
dacli kb map
Show domain ↔ source file mapping
dacli kb audit
Audit KB health (type: stale, default)
- 参数:
type— Audit type
dacli kb add
Add a new KB domain (interactive)
- 参数:
domain— Domain name (e.g. dacli)
dacli kb entry
Add an entry to a domain (interactive)
- 参数:
domain— Domain name - 选项:
-s, --section <section>— Section name (默认 "关键决策")-c, --content <content>— Content (markdown)-e, --expires-on <date>— Expiry date (YYYY-MM-DD)
dacli kb update
Update entry content/section
- 参数:
id— Entry id - 选项:
-s, --section <section>— New section-c, --content <content>— New content-e, --expires-on <date>— New expiry date
dacli kb remove
Permanently delete an entry
- 参数:
id— Entry id - 选项:
-f, --force— Skip confirmation
dacli kb expire
Set expiry date on an entry
- 参数:
id— Entry id - 选项:
-o, --on <date>— Expiry date (YYYY-MM-DD)
dacli kb renew
Update last_reviewed = NOW() (reset staleness timer)
- 参数:
id— Entry id
dacli kb archive
Archive an entry (hidden from active_entries view)
- 参数:
id— Entry id - 选项:
-r, --reason <reason>— Archive reason
dacli kb deprecate
Deprecate an entry (link to replacement)
- 参数:
id— Entry id (the one being deprecated) - 选项:
-r, --replaced-by <new_id>— New entry id that replaces this--reason <reason>— Deprecation reason
dacli kb rebuild-fts
Force rebuild search_vector for all entries (trigger fallback)
dacli kb serve
Start REST API server for KB (optional, cross-process)
- 选项:
-p, --port <port>— HTTP port (默认 "4100")