跳到主要内容

zgg-cli 更新日志

v1.0.1​

新增​

  • 视图配置查询命令：zgg view list / zgg view detail，支持查询视图配置信息。

v1.0.0​

新增​

  • 权限组（role）命令组：zgg role list/get/create/update/delete/members，覆盖用户端菜单权限组全链路管理。
    • role create 支持自动生成字段权限（fieldAuths）、批量成员配置及模板克隆。
    • role update 采用读-改-写合并模式，避免覆盖未知字段。
  • 权限组接口客户端封装（走 front_url）。
  • 设计与搭建技能补充权限组（role）配置能力说明。

v0.7.0​

新增​

  • 审批流程（approval）功能：zgg approval deploy 命令，支持通过 ADF 定义文件部署审批流程。
    • ADF 定义文件解析模块、语义校验模块（孤儿节点可达性检查等）。
    • ADF 转 flow 结构生成器。
    • 审批流接口客户端封装。
  • Profile 双端地址拆分：ops_url（运营端）/ front_url（应用端），审批等应用端接口走 front_url；旧版仅含 base_url 的配置自动迁移。
  • 初始配置简化为只保留 prod 单 profile。

修复​

  • 审批人改用用户 id 而非员工 id，修复节点基础属性面板空白。
  • 员工手机号查询改为严格匹配，移除首条回退。
  • 仪表盘天际线填充后向下拉伸补洞，消除矮卡片下方空洞。

v0.6.6​

维护性发布，无功能性变更。

v0.6.5​

新增​

  • 仪表盘布局算法升级：改为天际线填充算法，支持 w/h 尺寸覆盖，提升排版紧凑度。
  • zgg-solution-designer 功能实施清单改为单文档并强化生成硬约束。

v0.6.4​

新增​

  • zgg-solution-designer 技能：两阶段三确认门工作流（需求素材 → 建设方案 → 功能实施清单），含建设方案模板、功能实施清单模板、行业标准库（含工程行业标准）、素材结构解析与疑问澄清指引。
  • zgg-system-builder 适配 solution-designer 清单输入格式。
  • 智能助手 WDL 新增 AI 大模型节点（ai_generate_json）。
  • zgg update 自动重新链接 skills 到 workbuddy 目录。

变更​

  • 移除 npm 分发渠道，统一改为火山引擎 TOS 分发。

v0.6.3​

新增​

  • 表单字段配置全量对齐平台：
    • 字段通用属性层（只读/隐藏/宽度/提示等 12 项）+ 配置严格校验。
    • 选项类配置（对象选项/彩色/progress 显示/关联选项来源 metaFieldOption）。
    • 文本掩码/扫码、数字千分位与范围、日期格式与默认当前时间。
    • 子表单结构化配置、按钮/AI 按钮事件配置、栅格配置、成员选择范围。
    • 关联类填充/初始化/排序/默认值/自动刷新与汇总操作符全集、级联排序。
    • 上传大小开关与水印、签名重签、流水号规则结构化、定位扩展配置。
  • zgg form field-schema 命令：字段配置 schema 查询（CLI + Agent 模式）。

修复​

  • 12 项平台键形对齐（componentName 映射、metaFieldOption、defaultValue、initFieldValues、sumFields、pageSize、textInputMask 等）。
  • 掩码 rule 结构校验；summary 子表单汇总不再静默回退。

v0.6.2​

新增​

  • 表单字段支持数据过滤条件（dataFilter）配置。

v0.6.1​

新增​

  • 表单业务规则（fieldDisplayRules）配置能力。

v0.6.0​

新增​

  • 统一公式系统：86 个内置函数注册表、词法/语法分析器（支持函数/数组/多行）、AST 编译器、字段解析器（参数规则/黑名单/类型推导）。
    • 公式接入五大场景：表单字段默认值、表单提交校验规则（--validates）、智能助手字段赋值（= 前缀，valueType=rely）、数据工厂 map 计算字段、聚合表。
    • 聚合表公式切换到统一引擎，删除私有解析器。
  • zgg formula check：公式校验与编译预览。
  • zgg formula functions：内置函数目录查询。

修复​

  • 字符串字面量 token 补单引号；公式 token name 预分配为组件实际 key。
  • GETUSER 在数据工厂场景补入黑名单。
  • RobotDetailRequest 的 robot_id 序列化为 robotId。

v0.5.3​

新增​

  • skills 拆分策略改为用户选择执行方式，默认不拆分。

v0.5.2​

文档更新：明确文件夹按业务模块分层与按需创建规则。无功能性变更。

v0.5.1​

新增​

  • 文件夹创建 type 安全校验：新增 verify_dir_in_type 校验函数，view/robot/dataflow/aggregate/dashboard 的 create/deploy 接入同 type 校验，避免目录类型错配。
  • zgg folder create-dataflow 命令。
  • folders 标题一致性校验扩展到 7 个模块 key。

v0.5.0​

新增​

  • 聚合表（aggregate）功能：zgg aggregate 命令族、.zat.json DSL 定义、DSL 结构校验器、公式解析器（运算符+常量）、DSL → view.component 生成器、聚合表 API 客户端。
  • zgg folder create-aggregate 子命令。
  • 项目状态一致性校验。

变更​

  • 移除 aggregate delete 命令，防止 AI 误删。

v0.4.2​

新增​

  • 单位 ID 统一从当前目录 .zgg/config.json 读取，禁止参考登录用户单位 ID。
  • 智能助手支持跨字段的 && / || 组合分支条件。

修复​

  • auth status 不再返回 companyId 和 companyName。

v0.4.1​

新增​

  • 数据工厂节点扩展：
    • map（字段设置）节点 + 公式解析器。
    • union（追加合并）、group（分组汇总）、rowToCol（行转列）节点。
  • 智能助手公众号通知支持跳转链接配置。

修复​

  • map 公式解析器边界问题、公式括号配对校验、MapField 顶层 title 字段对齐前端编辑态契约。

v0.4.0​

新增​

  • 数据工厂（dataflow）功能：zgg dataflow 命令族与 deploy 编排、Agent dispatch。
    • .zdf.json DSL 解析结构、校验器（11 条规则）。
    • input / filter / join / output 四类转换器与自动布局。
    • /dataflow/mgr/* API 客户端封装。

v0.3.4​

新增​

  • zgg folder 新增智能助手/仪表盘目录创建命令。
  • 关联数据字段新增 chooseMode 与 displayMode 约束校验。

v0.3.3​

修复​

  • 智能助手 action 节点字段赋值使用字段 key 时正确解析 fieldTitle。

v0.3.2​

修复​

  • 智能助手过滤条件字段元数据丢失问题。

v0.3.1​

新增​

  • zgg-system-builder 总入口 skill：统一系统搭建入口。
  • zgg skills link 支持 --only / --exclude 精细化链接控制。
  • zgg update 更新 skills 时清理旧 skill 目录。
  • 仪表盘风格预设注入子组件卡片与图表色值；未识别组件累计一次性 warning。
  • 智能助手 branch 节点支持非空/为空条件（nnil/nil）。

变更​

  • skills 目录结构调整：表单/视图/导航/仪表盘/智能助手搭建参考迁移到 reference 目录。

v0.3.0​

新增​

  • 仪表盘（dashboard）功能：
    • 6 种基础组件生成器 + 地图（标记地图/轨迹地图）+ 甘特图 + 散点图 + 雷达图 + 双轴图 + 进度图。
    • 布局容器与嵌套、筛选与联动。
    • 装饰组件（文本/倒计时/内嵌/轮播图）、交互组件（按钮组/流程/图文列表/导航图）。
  • 仪表盘风格预设：6 种内置风格，--style 参数 + list-styles 子命令，支持页面与组件递归注入风格。

修复​

  • 补全 dashboard JSON 后端反序列化必备字段、fast_filter 条件、work_task/button_group 运行时强依赖字段等。

v0.2.5​

新增​

  • 智能助手按日期字段触发器（timer_field）：WDL 反序列化、转换、静态校验。

修复​

  • dev 默认 url 改为 https。

v0.2.4​

新增​

  • 智能助手节点扩展：子工作流（subflow_package / subflow_collection）、流程参数（flow_param_update）、render_json 输出节点。
  • WDL 加入 config.flowParams 流程参数定义。
  • deploy 按触发器类型路由创建接口；新增 trigger_package / subflow_collection 触发器。

v0.2.3​

变更​

  • 标准化 skills 目录结构。

v0.2.2​

新增​

  • 智能助手扩展触发器：五类触发器转换（webhook/click 等），click 触发器 deploy 时自动绑定表单按钮。
  • HTTP 请求节点、JSON 解析节点、代码块节点支持。

修复​

  • 触发器默认配置、webhook 数组字段校验、HTTP 请求边界校验等多项节点字段引用解析问题。

v0.2.1​

维护性发布，无功能性变更。

v0.2.0​

新增​

  • 智能助手自动化配置（robot）功能：WDL 类型定义、验证器、表达式解析器、rpaFlow 转换框架，含 Trigger/Query/Action/Notice 转换器。

修复​

  • 通知节点 msgNodeFields 生成、分支节点与触发节点多项问题。

v0.1.8​

修复​

  • 安装脚本处理不存在 .zshrc 文件的情况。

v0.1.7​

新增​

  • zgg update 自升级命令。
  • 实体子表（entity_subform）字段类型完整支持：预处理模块、组件生成逻辑、get_form_list API。
  • 安装脚本改为从火山引擎 TOS 下载，支持 latest.txt 版本读取。

修复​

  • entity_subform get_form_list 响应结构不匹配；禁止 entity_subform 嵌套在子表内部。

v0.1.6 / v0.1.5 / v0.1.4​

维护性发布，无功能性变更。

v0.1.3​

新增​

  • 浏览器登录自动获取 token。
  • Windows 安装文档和脚本。

v0.1.2​

维护性发布，无功能性变更。

v0.1.1​

新增​

  • token 多后端存储：keyring（系统钥匙串）/ inline（明文配置）/ env（环境变量）三种方式。
  • 工作区配置模块（WorkspaceConfig）：require_company_id 支持工作区配置优先级并显示来源；登录时自动初始化工作区配置。
  • 标签页字段（TabConfig）：表单生成器支持标签页字段生成，append_fields 支持标签页内字段引用。
  • profile 添加 company_name 字段，登录时同步写入。

修复​

  • 关联查询字段默认显示多条；登录初始化只检查当前目录；save() 保留原配置文件未知字段。

v0.1.0（初始版本）​

新增​

  • CLI 基础框架：命令解析、交互式 Agent 模式、AI 友好输出与错误处理。
  • 多 Profile 配置管理：支持 dev/prod 等多环境切换。
  • 登录认证模块：密码登录、token 登录、浏览器登录。
  • 表单命令：表单创建与查询、表单数据保存、form generate-json（字段 key/类型映射/JSON 生成）、form append-fields（字段追加，支持增量 key 复用）。
  • 10 种高级字段类型支持。
  • summary 字段：跨表单解析与本地缓存（summary_resolver 模块）。
  • 文件夹操作命令：create-nav / create-form / create-view folder。
  • 视图实例化与导航挂载：自动解析 admin_user_id，打通表单-视图-导航创建全流程。
  • npm 分发与安装、zgg skills link 命令及跨平台安装脚本。