# extractors.md — web 源码提取工具说明 > **位置**: `$ccWorkDir/dacli/doc/extractors.md` > **目标**: 5 个 extractor 工具, 从 web 源码自动生成 data/*.json ## 1. 概览 | Extractor | 输入 | 输出 | 大小 | 跑时 | |-----------|------|------|------|------| | `component-map.ts` | `web/.../componentMap.ts` | `data/component-map.json` | 60+ jnpfKey | < 1s | | `fields.ts` | `web/.../rightComponents/R*.vue` | `data/field-schemas.json` | 39 控件 | < 5s | | `l1-rules.ts` | `web/.../formValidate.ts` | `data/validation-rules.json` | 14 正则 | < 1s | | `l2-rules.ts` | `web/.../Form.vue` 多个 | `data/l2-rules.json` | 30+ 规则 | < 5s | | `flow.ts` | `web/.../FlowProcess/index.vue` | `data/flow-nodes.json` | 25+ 节点 | < 5s | **一键跑全部**: ```bash node scripts/extract-all.mjs ``` ## 2. component-map.ts 提取 **输入**: `web/apps/jnpf-web-apps-main/src/components/FormGenerator/src/helper/componentMap.ts` **提取内容**: - jnpfKey → tag (e.g. `input` → `JnpfInput`) - 控件元数据 **输出** (`data/component-map.json`): ```json { "input": "JnpfInput", "textarea": "JnpfTextarea", "select": "JnpfSelect", ... } ``` **实现**: ```ts // src/extractors/component-map.ts import { readFileSync, writeFileSync } from 'node:fs' import { resolve } from 'node:path' const SRC = 'web/apps/jnpf-web-apps-main/src/components/FormGenerator/src/helper/componentMap.ts' const OUT = 'src/data/component-map.json' export function extractComponentMap() { const src = readFileSync(resolve(SRC), 'utf-8') const items = [...src.matchAll(/jnpfKey:\s*['"](\w+)['"][\s\S]*?tag:\s*['"]([^'"]+)['"]/g)] const map: Record = {} for (const m of items) map[m[1]] = m[2] writeFileSync(resolve(OUT), JSON.stringify(map, null, 2)) return Object.keys(map).length } ``` ## 3. fields.ts 提取 (核心) **输入**: `web/.../rightComponents/R*.vue` (39 个) **提取**: Rxxx.vue template 里所有 `activeData.` 形式, 得到控件字段集 **输出** (`data/field-schemas.json`): ```json { "input": [ "__config__.defaultValue", "__config__.noShow", "__config__.required", "addonAfter", "addonBefore", "clearable", "disabled", "maxlength", "prefixIcon", "readonly", "showCount", "showPassword", "suffixIcon", "useMask", "useScan" ], "select": [ "__config__.defaultValue", "clearable", "filterable", "multiple", "options", "props" ], ... } ``` **实现**: ```ts // src/extractors/fields.ts import { parse as parseSFC } from '@vue/compiler-sfc' import { readFileSync, readdirSync, writeFileSync } from 'node:fs' import { resolve } from 'node:path' const R_DIR = 'web/.../rightComponents' const COMP_MAP = 'web/.../componentMap.ts' const OUT = 'src/data/field-schemas.json' export function extractFields() { // 1. 读 componentMap (jnpfKey → tag) const cmSrc = readFileSync(COMP_MAP, 'utf-8') const jnpfKeyToTag: Record = {} for (const m of cmSrc.matchAll(/jnpfKey:\s*['"](\w+)['"][\s\S]*?tag:\s*['"]([^'"]+)['"]/g)) { jnpfKeyToTag[m[1]] = m[2] } // 2. 对每个 jnpfKey 找对应 R.vue const schemas: Record = {} for (const key of Object.keys(jnpfKeyToTag)) { const pascal = key.charAt(0).toUpperCase() + key.slice(1) const f = resolve(R_DIR, `R${pascal}.vue`) try { const src = readFileSync(f, 'utf-8') const { descriptor } = parseSFC(src, { filename: `R${pascal}.vue` }) const tmpl = descriptor.template?.content if (!tmpl) continue // 提所有 activeData. const fields = [...new Set( [...tmpl.matchAll(/activeData\.([a-zA-Z_][\w.]*)/g)].map(m => m[1]) )].sort() schemas[key] = fields } catch { /* 文件不存在, 跳过 */ } } writeFileSync(resolve(OUT), JSON.stringify(schemas, null, 2)) return Object.keys(schemas).length } ``` **覆盖率**: - 60+ jnpfKey 中能找 39 个 R 文件 - 14 个 R 文件缺失 (Jnpf/ 目录下的子组件) - input 控件 19 字段 (vs dacli Java 43 字段, 44% 覆盖率) - 整体 60-80% 字段覆盖率, 剩 20-40% 用 baseline 补 ## 4. l1-rules.ts 提取 **输入**: `web/packages/jnpf/utils/src/helpers/formValidate.ts` **提取**: 14 条 L1 正则 (enCode, fullName, field, chinese, bigInt, ...) **输出** (`data/validation-rules.json`): ```json { "enCode": { "msg": "只能输入英文、数字和小数点且小数点不能放在首尾", "rule": "^[a-z0-9]((([a-z0-9])*)|(([a-z0-9]+|\\.)*[a-z0-9]))$/i" }, "fullName": { "msg": "名称不能含有特殊符号", "rule": "^([一-龥a-z0-9])+$/i" }, ... } ``` **实现**: ```ts // src/extractors/l1-rules.ts import { readFileSync, writeFileSync } from 'node:fs' import { resolve } from 'node:path' const SRC = 'web/packages/jnpf/utils/src/helpers/formValidate.ts' const OUT = 'src/data/validation-rules.json' export function extractL1Rules() { const src = readFileSync(resolve(SRC), 'utf-8') const match = src.match(/const regularList\s*=\s*\{([\s\S]*?)\n\}/) if (!match) throw new Error('regularList not found') const rules: Record = {} // 提每条 key 的 msg + rule for (const m of match[1].matchAll(/(\w+):\s*\{[\s\S]*?msg:\s*'([^']+)'[\s\S]*?rule:\s*(\/[^\/]+\/[a-z]*)[\s\S]*?\}/g)) { rules[m[1]] = { msg: m[2], rule: m[3] } } writeFileSync(resolve(OUT), JSON.stringify(rules, null, 2)) return Object.keys(rules).length } ``` ## 5. l2-rules.ts 提取 **输入**: `web/.../views/{module}/Form.vue` 多个 **提取**: `createMessage.error/warning('msg')` + 上下文 **输出** (`data/l2-rules.json`): ```json { "di": [ { "line": 472, "msg": "请输入静态数据", "condition": "type == 2", "dacli": "--static-data" }, { "line": 522, "msg": "请输入SQL查询语句", "condition": "type == 1, activeStep == 1", "dacli": "--sql-query" } ], "dm": [...], "dict": [...], "workflow": [...] } ``` **实现**: ```ts // src/extractors/l2-rules.ts import { parse as parseSFC } from '@vue/compiler-sfc' import { readFileSync, readdirSync, writeFileSync } from 'node:fs' import { resolve } from 'node:path' export function extractL2Rules() { const rules: Record = { di: [], dm: [], dict: [], workflow: [] } // 扫所有 Form.vue const viewsDir = 'web/apps/jnpf-web-apps-main/src/views' const forms = findAllFiles(viewsDir, /Form\.vue$/) for (const f of forms) { const module = f.includes('/dataInterface/') ? 'di' : f.includes('/dataModel/') ? 'dm' : f.includes('/dictionary/') ? 'dict' : f.includes('/flowEngine/') ? 'workflow' : null if (!module) continue const src = readFileSync(f, 'utf-8') const { descriptor } = parseSFC(src) const script = descriptor.scriptSetup?.content || descriptor.script?.content || '' // 提 createMessage.error/warning for (const m of script.matchAll(/createMessage\.(error|warning)\s*\(\s*['"]([^'"]+)['"]/g)) { rules[module].push({ level: m[1], msg: m[2], line: getLineNumber(script, m.index!), source: f.replace(/^.*\/web\//, 'web/'), }) } } writeFileSync(resolve(OUT), JSON.stringify(rules, null, 2)) return Object.values(rules).reduce((a, b) => a + b.length, 0) } ``` ## 6. flow.ts 提取 **输入**: `web/.../components/FlowProcess/src/index.vue` **提取**: `setErrorList(msg, id, title)` 调用 + 节点 type **输出** (`data/flow-nodes.json`): ```json { "addData": { "formId": "必填", "msg": "请选择目标表单" }, "updateData": { "formId": "必填", "ruleList": "必填, 至少 1 条", "msg": "请设置更新条件" }, "typeDecision": { "decisionOptions": "必填", "msg": "节点未完善" }, ... } ``` ## 7. 一键提取 (scripts/extract-all.mjs) ```js #!/usr/bin/env node // scripts/extract-all.mjs import { extractComponentMap } from '../src/extractors/component-map.ts' import { extractFields } from '../src/extractors/fields.ts' import { extractL1Rules } from '../src/extractors/l1-rules.ts' import { extractL2Rules } from '../src/extractors/l2-rules.ts' import { extractFlow } from '../src/extractors/flow.ts' console.log('▶ extractComponentMap:', extractComponentMap(), 'jnpfKey') console.log('▶ extractFields: ', extractFields(), '控件') console.log('▶ extractL1Rules: ', extractL1Rules(), '条') console.log('▶ extractL2Rules: ', extractL2Rules(), '条') console.log('▶ extractFlow: ', extractFlow(), '节点') console.log('✓ 全部提取完成') ``` ## 8. 何时重跑 | 触发 | 行为 | |------|------| | JNPF 升级 | 必跑, 5 分钟看 web 改了哪些 | | 新增 Rxxx.vue | 跑 extract 拿新控件 schema | | 修改 formValidate | 跑 extract 拿新规则 | | 改 componentMap | 跑 extract 拿新映射 | ## 9. 反向链接 - [architecture.md](architecture.md) — 设计 - [plan.md](plan.md) — 6 周路线 - [api.md](api.md) — API - [baseline.md](baseline.md) — 0 差错 - [help-system.md](help-system.md) — 帮助体系