Files
claude-config/skills/ssw-loop/references/command-reference.generated.md
T
sswandClaude cff2e32e44 feat(ssw-loop): P7 — generated command reference + drift-check
- 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]>
2026-07-24 11:47:32 +08:00

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)

按关键词全文搜索 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 输出

按字段名搜索 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 输出

print

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)

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")