weaver-e9-builder-cli

重要声明：本 CLI 当前仅用于开发、测试、演示和能力验证，禁止在生产环境中使用。

CLI 会直接调用 E9 接口创建或修改应用、表单、字段、流程、节点、操作者、连线及其他配置。不同 E9 环境的版本、权限和接口行为可能存在差异，使用前必须在隔离的非生产环境中完成验证，并做好必要的数据备份和人工复核。

面向泛微 Ecology 9（E9）的工作流与建模应用自动搭建及验证 CLI —— 脚本化、可复现、可回读校验。

CLI 是独立 npm 包，可单独使用。配合 weaver-e9-builder Skill（Claude Code 智能体）使用时，可根据需求文档或自然语言描述自动分析搭建目标、制定计划并执行验证。

安装

npm install -g weaver-e9-builder-cli

安装后验证：

e9-cli --version
e9-cli auth status

配置

e9-cli auth config profile prod                    # 切/建环境
e9-cli auth config set baseUrl http://<E9地址>:8080
e9-cli auth config set username sysadmin
e9-cli auth set-password                           # 交互输入密码（不回显）
e9-cli auth login                                  # 浏览器手工登录获取 Cookie
e9-cli auth status                                 # 确认 Cookie 可用
e9-cli app list                                    # 验证连接

⚠ 不支持命令行 --pwd（会进 shell history/进程列表/AI 对话记录）。用 e9-cli auth set-password 交互输入，或在 AI 助手终端执行 ! e9-cli auth set-password。

命令速查

| 命令 | 作用 | |---|---| | e9-cli auth login/status/logout/cookie/config | 鉴权管理（浏览器登录、Cookie、多 profile） | | e9-cli app list/create/info/update/delete | 应用管理 | | e9-cli role list/create/apply/delete/member/right | 角色+成员+权限+人员/部门/分部/岗位查询 | | e9-cli org departments/people | 组织查询（分部下部门树、人员搜索） | | e9-cli matrix list/info/data list/create/delete/data set | 审批矩阵结构与数据；节点绑定见 workflow node operator matrix | | e9-cli model create/info/delete | 建模台账（主表+明细+布局+查询列表一站式） | | e9-cli model form field list/add/edit | 建模字段管理（查询/追加/编辑） | | e9-cli model layout/defaultvalue/button/linkage/fieldtrigger | 建模布局/默认值/按钮/联动 | | e9-cli model repeat-validation/import-settings/index/remind/tree | 校验/导入/索引/提醒/浏览树 | | e9-cli workflow type create | 流程分组单独创建 | | e9-cli workflow create/info/delete | 流程创建（表单+节点+操作者+连线+分支+布局） | | e9-cli workflow list/search/tree | 流程列表/搜索/分组树 | | e9-cli workflow node operator add/add-field/list/delete-group/matrix/delete-rows | 操作者（人员/部门/角色/矩阵/表单字段） | | e9-cli workflow flow branch/link/topology | 分支条件/连线修复/拓扑提取 | | e9-cli workflow form field-trigger apply | 流程字段值带出 | | e9-cli workflow flow diagram info/plan/apply/auto/restore | 流程图排版与连线路由 | | e9-cli workflow layout formula/check/remind/annex-set | 公式/编辑锁/提醒/附件 | | e9-cli workflow node linkage/settings/operate/validation | 节点属性联动/设置/附加操作/提交校验 | | e9-cli workflow form field list/info/add/edit/edit-batch | 流程表单字段；list 可用 --form-id 查询独立表单 | | e9-cli workflow layout html/template/info/field/rename/copy/style | 流程布局（初始化、字段属性原地修改、重命名、模板套用、样式） | | e9-cli workflow numbering set / e9-cli model numbering | 流程编号 / 建模编号 | | e9-cli workflow node validation fields/list/add/enable/delete | 节点字段校验 | | e9-cli workflow form group set/list | 字段分组；配置外分组将被删除时需 --confirm | | e9-cli model query-list create/info/enable/disable/delete | 查询列表创建与管理 | | e9-cli model query-list stat list/add/disable/position | 统计卡片与统一显示位置 | | e9-cli model query-list batch list/set | 批量操作设置 | | e9-cli model query-list row-click list/add/update | 行点击事件 | | e9-cli model query-list link/display/search/quicksearch | 字段链接/显示列/搜索列 | | e9-cli model query-list codeblock save/get | 查询列表代码块（ModeList） | | e9-cli model browser create/list/delete/fieldset | 建模自定义浏览框 | | e9-cli w2m save/info/delete | 流程转数据（insert/update，精确删同节点同时机） | | e9-cli menu list/add | 门户菜单（顶层/子级，--customid 绑定查询列表） | | e9-cli workflow codeblock gen/show/get/apply/check/decode、e9-cli model codeblock gen/show/get/apply/check/decode | 前端代码块（WfForm/ModeForm） | | e9-cli ecode scaffold/inspect/check | ecode 本地前端扩展工程生成、识别与静态检查；不操作远端 ecode 管理页面 | | e9-cli docx read | Word 转 Markdown（含表格/图片/Visio 拓扑） | | e9-cli build phase1/track/resume/state | 基础搭建/逐项销号/断点续作/状态 | | e9-cli util cleanup | 运维清理（先预览再 --confirm） | | e9-cli reconcile | 远端对账找缺口 |

典型搭建流程

按真实依赖拓扑顺序：

1. auth login — 登录目标环境
2. org departments / role list / matrix list / app list — 盘点已有资源
3. workflow type create 或 build phase1 — 创建流程分组/应用/角色/矩阵
4. model create — 创建数据源台账（被浏览框引用）
5. model browser create — 创建建模浏览框（基于数据源台账）
6. model create — 创建业务台账（引用浏览框的字段）
7. model query-list create + model query-list display/search/stat — 查询列表+显示列+搜索+统计
8. workflow create — 创建流程（表单+字段+节点+操作者+连线+分支+布局初始化）
9. 规则配置（按依赖顺序逐项写入+读回）：
   • workflow form field-trigger apply — 字段联动
   • workflow node linkage add — 属性联动
   • workflow form row-rule/column-rule — 行/列规则
   • workflow numbering set — 自动编号
   • workflow node validation add — 提交前校验
   • workflow codeblock gen/apply 或 model codeblock gen/apply — 代码块
   • workflow remind、workflow node operate、workflow node settings — 提醒/附加操作/节点设置
   • workflow attachment set — 附件设置
10. w2m save — 流程转数据（归档 insert + 创建 update）
11. menu add --customid — 门户菜单绑定查询列表
12. build track 逐项销号 + reconcile 远端对账

每一步写入后立即读回验证。

环境变量

| 变量 | 默认 | 作用 | |---|---|---| | E9_REQUEST_TIMEOUT_MS | GET 15s / POST 30s | E9 请求超时 | | E9_NO_REAUTH | 未设 | 设 1 时鉴权失效不弹浏览器重登（cron/无显示环境） | | E9_OPLOG | 未设 | 设 0 关闭操作日志 |

License

MIT