# dacli 源码分析报告 (2026-06-25) **目的**: 分析 `web/apps/jnpf-web-apps-main/src/views/**/*.vue` 页面操作逻辑, 识别 dacli 当前命令未覆盖的 AI 工作流缺口. ## 1. 分析范围 | 模块 | views 子目录 | dacli 命令 | 状态 | |------|-------------|-----------|------| | 表单设计 | onlineDev/formDesign | form (24 子命令) | ✅ 已覆盖 | | 数据建模 | dataCenter/dataModel | dm (4 子命令) | ✅ 已覆盖 (但缺 addFields/update) | | 数据连接 | dataCenter/dataSource | datasource (4) | ✅ 已覆盖 | | 菜单管理 | permission/menu | menu (7) | ✅ 已覆盖 | | 用户管理 | permission/user | user (18) | ✅ 已覆盖 | | 角色管理 | permission/role | role (4) | ✅ 已覆盖 | | 组织/职位 | permission/organize | org (3) | ✅ 已覆盖 | | 字典 | sysData/dictionary | dict (4) | ✅ 已覆盖 | | 报表 | onlineDev/report | report (3) | ⚠️ 缺 webapi 镜像 | | 门户 | onlineDev/visualPortal | portal (4) | ⚠️ 缺 webapi 镜像 | | 大屏 | onlineDev/dataV | bigscreen (4) | ⚠️ 缺 webapi 镜像 | | 数据接口 | dataCenter/dataInterface | di (1) | ⚠️ 缺 webapi 镜像 | | 工作流 | workFlow/ | workflow (5) | ⚠️ 缺 webapi 镜像 | | 消息 | msgCenter/ | msg (3) | ⚠️ 缺 webapi 镜像 | | 定时任务 | teamwork/schedule | schedule (5) | ⚠️ 缺 webapi 镜像 | | 打印 | onlineDev/printDev | print (3) | ⚠️ 缺 webapi 镜像 | | 日志 | sysLog/ | log (2) | ⚠️ 缺 webapi 镜像 | | 监控 | monitor/ | monitor (3) | ⚠️ 缺 webapi 镜像 | | 报表 | onlineDev/dataReport | report (合并) | ⚠️ 缺 webapi 镜像 | ## 2. 核心页面操作逻辑分析 ### 2.1 formDesign/Form.vue (3 步骤创建流程) ```js // handleSubmit() 关键逻辑: async function handleSubmit() { if (state.activeStep < 1) { // 步骤 0: 基础信息 const values = await validate(); state.dataForm = { ...state.dataForm, ...values }; handleRequest(); } else if (state.activeStep === 1) { // 步骤 1: 表单设计 generatorRef.getData().then((res) => { state.formData = res.formData; state.dataForm.formData = JSON.stringify(state.formData); handleRequest(); }); } else { // 步骤 2: 列表设计 if (state.dataForm.webType == 1) return handleRequest(); columnDesignRef.getData().then((res) => { state.columnData = res.columnData; handleRequest(); }); } } function handleRequest() { const query = { ...state.dataForm, tables: JSON.stringify(state.tables), formData: state.dataForm.formData, columnData: state.dataForm.columnData, appColumnData: state.dataForm.appColumnData, }; const formMethod = state.dataForm.id ? update : create; formMethod(query); } ``` **关键发现**: - **submit 时 formData/columnData/tables 都是 JSON 字符串** (后端期望) - **id 存在走 update, 否则 create** — dacli 没暴露 update 命令 - **webType == 1 跳过列表设计** — dacli 已支持 (autoTable) - **maxStep = webType == 4 ? 1 : 2** — type=4 视图只 1 步 (基础+设计, 无列表) ### 2.2 dataCenter/dataModel/Form.vue ```js async function handleSubmit() { const tableInfo = { ...dataForm.value, ...values }; const tableFieldList = hasTableData.value ? fieldList.value.filter((o) => !o.disabled) : fieldList.value; const query = { tableFieldList: tableFieldList.map((o) => ({ ...o, primaryKey: o.primaryKey ? 1 : 0, // boolean → 1/0 allowNull: o.allowNull ? 1 : 0, identity: o.identity && o.primaryKey ? 1 : 0, })), tableInfo, }; const formMethod = hasTableData.value ? addTableFields : dataForm.value.table ? update : create; formMethod(unref(linkId), query); } ``` **关键发现**: - **三态 formMethod**: addTableFields (有表加字段) / update (有表名) / create (新建) - dacli dm 命令**只有 create**, 缺 update / addFields - **boolean → 1/0 转换是必须的** (dacli v10.6.1 已自动) ### 2.3 permission/menu/Form.vue (创建菜单) ```js import { getDataReportSelector, getDataVSelector, getPortalSelector, getReportSelector, getVisualDevSelector, getFlowSelector } from '#/api/...'; ``` **关键发现**: - 创建菜单时需要知道**有哪些目标可挂**: form / report / portal / datav / flow - 每个目标都对应一个 `xxxSelector` API - **AI 痛点**: 必须先 list 这些资源才知道选哪个 ### 2.4 sysData/dictionary/Form.vue ```js const query = { ...values, id: id.value, dictionaryTypeId: typeId.value }; const formMethod = id.value ? update : create; formMethod(query).then((res) => { baseStore.setDictionaryList(); // 刷新 web 端全局缓存 closeModal(); }); ``` **关键发现**: - 创建/修改字典数据项, dictionaryTypeId 是父级类型 - dacli dict 有 typeCreate/typeUpdate, 但**没暴露 dictData 创建** (字典项) ## 3. AI 工作流缺口 (按优先级) ### 3.1 缺口 P0 (高频, 必须补) | 缺口 | 影响 AI 操作 | 解决 | |------|-------------|------| | 没有 `formSelector` 类命令 | 创建菜单 / 工作流挂表单时, 不知道有哪些 form 可选 | 加 `dacli form selector --json` | | 没有 `reportSelector` 类命令 | 同上 (报表挂载) | 加 `dacli report list` | | 没有 `portalSelector` 类命令 | 同上 (门户挂载) | 加 `dacli portal list` | | 没有 `dictSelector` 类命令 | 表单 select 字段配置字典 | 加 `dacli dict typeList` | | 没有 `flowSelector` 类命令 | 菜单挂工作流 | 加 `dacli workflow list` | ### 3.2 缺口 P1 (中频, 应补) | 缺口 | 解决 | |------|------| | 没有 form update 命令 | 加 `dacli form update ` (webapi/update) | | 没有 dm addFields / dm update 命令 | 加 `dacli dm addFields` / `dacli dm update` | | 没有 dictData CRUD | 加 `dacli dict dataList/dataCreate/dataUpdate` | ### 3.3 缺口 P2 (低频, 可缓) | 缺口 | 解决 | |------|------| | msg / schedule / print / monitor 等 | 镜像 webapi 后再补命令 | ## 4. 实施路径 (按 AI 痛点驱动) ### 阶段 1: 镜像高频 selector 类 webapi (半天) ```ts // 新增 webapi 模块 dacli/src/webapi/selectors.ts // formSelector + reportSelector + portalSelector + flowSelector + dictSelector ``` ### 阶段 2: 新增 selector 命令 (半天) ```bash dacli form selector --type=1 --keyword=员工 --json dacli report list --json dacli portal list --json dacli workflow list --json dacli dict typeList --json ``` ### 阶段 3: 写 skill (1 小时) dacli/.claude/skills/dacli-ai-workflow/SKILL.md: - 提示 AI 在不同业务场景下该用什么命令 - 高频组合: 创建 menu 前先 form selector ### 阶段 4: 用官方示例验证 跑 developSystem / workSystem 验证: - 创建菜单挂某个 form: `dacli form selector --json` → `dacli menu create --formId=...` - 字典挂载: `dacli dict typeList --json` → 表单 select 字段 - 工作流挂载: `dacli workflow list --json` → `dacli menu create --type=4`