From cff2e32e44ec3eacff70d10be67b29c6b0a38e1d Mon Sep 17 00:00:00 2001 From: ssw Date: Fri, 24 Jul 2026 11:47:32 +0800 Subject: [PATCH] =?UTF-8?q?feat(ssw-loop):=20P7=20=E2=80=94=20generated=20?= =?UTF-8?q?command=20reference=20+=20drift-check?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 --- .../references/command-reference.generated.md | 1870 +++++++++++++++++ .../ssw-loop/references/dacli-doc-pattern.md | 6 + .../ssw-loop/scripts/check_command_drift.py | 52 + 3 files changed, 1928 insertions(+) create mode 100644 skills/ssw-loop/references/command-reference.generated.md create mode 100644 skills/ssw-loop/scripts/check_command_drift.py diff --git a/skills/ssw-loop/references/command-reference.generated.md b/skills/ssw-loop/references/command-reference.generated.md new file mode 100644 index 0000000..5b984df --- /dev/null +++ b/skills/ssw-loop/references/command-reference.generated.md @@ -0,0 +1,1870 @@ + +# 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 ` — 关键字 (匹配 fullName/enCode) + - `--state ` — 过滤 state (0|1|2) + - `--limit ` — 最多取 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 ` — 中文名 (--ai 自动填, 否则必填) + - `--enCode ` — 英文编码 (--ai 自动填, 否则必填) + - `--type ` — 1=自定义(formDesign) 2=系统(sysForm) 3=接口 4=视图 (默认 "1") + - `--webType ` — 1=仅表单 2=表单+列表(默认) 3=树+表单 4=数据视图 (默认 "2") + - `--category ` — 分类 id (form list 看真实值; 镜像 web Form.vue:60-66 必填; 推荐每个 appCode 派独立 category, 通用复用 8f65bbe3bce341c8b3625d93544a044a=crmOrder 业务表单) + - `--dbLinkId ` — db link id (type≠4 时必传, 默认从 token.dbLinkId) + - `--fields ` — formData.fields JSON 数组 (--ai 自动填) + - `--tables ` — tables JSON 数组 (type=1/2 必传) + - `--enableFlow <0|1>` — 是否绑工作流 (默认 "0") + - `--flowId ` — 工作流 id (enableFlow=1 时必传) + - `--autoRelease` — 建完立刻发布 (type=4 自动跳过) + - `--autoTable` — 从 --fields 自动推导 --tables JSON (web formDesign Form.vue 行为一致; 覆盖 --tables) + - `--autoCreateMenu` — 发布后自动挂菜单 (需传 --menuParentId, 避免浏览器验证找不到 list 页) + - `--menuParentId ` — 挂菜单的父目录 id (--autoCreateMenu 时必传; 走 dacli menu list --keyword=... 拿) + - `--no-relation-form-auto` — 关闭 relationForm 字段自动注入 (v0.11h+ BS-18 fix, 默认 ON; 用于 *_code 等业务编码字段被误判为关系字段时) + - `--table ` — 绑现有物理表 (镜像 web 选表自动生成字段; 不需要 --ai 描述, 不需要 --fields) + - `--ai ` — 白皮书 5.10.1 AI 快速建表 — 自然语言描述, 平台 LLM 生成 enCode/fullName/fields (走 NCPF backend /api/visualdev/ai/form, v0.12+ 默认 autoRelease=true) + - `--ai-field ` — 白皮书 5.10.2 AI 推荐字段 — 自然语言描述, 平台 LLM 推荐单字段, 只输出建议不建表单 + - `--no-smart-props` — 关闭 --ai smartProps 自动选配 (默认 ON, AI 选填组件属性) + - `--no-verify` — 跳过浏览器层验证 + - `--verify ` — 失败模式: warn (默认, v0.12+ jxcj) | block (默认 "warn") + - `--verify-timeout ` — 浏览器验证超时 (默认 60s) (默认 "60000") + - `--via ` — 创建路径: api (默认, 走 POST /visualdev/Base) | ui (走 playwright 模拟人类操作, API 失败时兜底) (默认 "api") + - `--json` — 原始 JSON 输出 + - `--verbose` — 完整输出 (含 step machine、API 调用等过程日志) + - `--column-naming