weaver-e10-builder 1.0.11-beta → 1.1.0

package/dist/services/workflow-initiator.js

@@ -58,10 +58,10 @@ export async function setInitiatorAll(client, baseUrl, workflowId, nodeId) {
             workflowId, nodeId,
             groupId, isCreate: '1', reserveGroupId,
             itemDatas: [{
-                    isOut: false, isSaveHrmOperator: false, id: '2', groupType: '所有人',
-                    itemName: '', itemLevel: '', endApprovers: '', hrmOperators: '', levelObj: '',
+                    level: '-999~999', isOut: false, isSaveHrmOperator: false, id: '2', groupType: '所有人',
+                    itemName: '', itemLevel: '-999~999', endApprovers: '', hrmOperators: '', levelObj: '',
                     workflowId, nodeId, conditionId: '', orders: '0.00', groupTypeId: '110', isOpen: true,
-                    bigTypeId: 1, condition: '', groupCondition: '', isSuportVirtualId: false,
+                    bigTypeId: 1, condition: '', groupCondition: '', isSuportVirtualId: true,
                     openProjectOrganization: false, isExtendType: 0,
                 }],
             oldGroupName: '所有人', refWorkflowId: '', oldItemDatas,

package/dist/services/workflow-initiator.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-initiator.js","sourceRoot":"","sources":["../../src/services/workflow-initiator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workflow-initiator.js","sourceRoot":"","sources":["../../src/services/workflow-initiator.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "weaver-e10-builder",
-  "version": "1.0.11-beta",
+  "version": "1.1.0",
   "description": "Eteams/Ebuilder CLI — 泛微 OA 命令行工具",
   "type": "module",
   "files": [
     "dist",
-    "ecodecmd"
+    "ecodecmd",
+    "skill-docs"
   ],
   "bin": {
     "e10-cli": "./dist/index.js",
@@ -14,7 +15,9 @@
   "scripts": {
     "dev": "tsx src/index.ts",
     "build": "tsc",
+    "postinstall": "node ./dist/postinstall.js",
     "pack:all": "node scripts/pack-editions.mjs",
+    "sync:docs": "node scripts/sync-skill-docs.mjs",
     "start": "node dist/index.js"
   },
   "dependencies": {

package/skill-docs/SKILL.md

@@ -0,0 +1,263 @@
+---
+name: weaver-e10-builder
+display_name: 泛微E10智能搭建Skill
+display_name_en: E10 Builder
+description: 泛微E10智能搭建skill v2（通用版），辅助编写泛微Ebuilder自定义应用，对应CLI版本1.1.0
+description_zh: 泛微Ebuilder低代码应用智能搭建工具 v2（通用版），辅助编写自定义应用（表单/流程/列表/动作流/权限/分组/编号等），与 e10-cli 配套使用，当前对应 CLI 版本 1.1.0。
+description_en: E10 Ebuilder low-code app builder skill v2 (general) — helps build Weaver E10 custom apps (forms/workflows/lists/actionflows/permissions/groups/numbering) via e10-cli, currently paired with CLI 1.1.0.
+category: coding
+version: 1.1.0
+author: 泛微网络科技股份有限公司
+auto: true
+---
+
+# Ebuilder 智能搭建 Skill
+
+## 安装与升级
+
+本 skill 需与 CLI **版本匹配**（当前对应 CLI `1.1.0`）。版本不一致时命令/文档/选项可能对不上——升级前先对齐：
+
+```shell
+e10-cli --version          # 查 CLI 版本，应与上方 description 标注一致
+
+# CLI 从 npm 装（升级先卸旧包 e10-cli，避免 bin 残留冲突）：
+** 注意 如果你使用的是workbuddy **
+先用 bash 直接删掉旧包目录（不走 npm 的删除），再让 npm 纯安装，必须指定一个有权限的工作目录作为缓存地址
+
+其他工具可以使用 npm rm -g e10-cli
+
+npm install -g weaver-e10-builder
+
+# skill 升级：先卸旧（旧名 skill-e10-cli；删掉的命令文档/actionflows 不会自动清，是"删不干净"主因），再装新
+npx -y skills remove skill-e10-cli
+npx -y skills add ./weaver-e10-builder.zip --skill -y
+```
+
+> 若 `skills remove` 无效，手动删后再 add，安装位置按工具区分：
+> - Claude Code：`rm -rf ~/.claude/skills/skill-e10-cli` → 新 skill 装到 `~/.claude/skills/weaver-e10-builder`
+> - WorkBuddy：`rm -rf ~/.workbuddy/skills/skill-e10-cli` → 新 skill 装到 `~/.workbuddy/skills/weaver-e10-builder`
+
+## 文档与模板取用
+
+**skill 只带指令层；文档/模板随配套 CLI 包发布**（marketplace skill 包限两级目录，深目录文档树走 npm）。
+
+**文档通常已就位，无需手动拷贝**：
+- 每次会话跑 `e10-cli auth status` 时，CLI 自动探测本机已装 skill（`~/.claude/skills`、`~/.workbuddy/skills`、`~/.codex/skills`），把文档树同步进对应 skill 目录（SKILL.md 版本一致则跳过）。装好 skill 后第一次 `auth status` 即可。
+- 手动刷新：`e10-cli skill sync`（可 `--target <安装根目录>` 指定其他工具目录）。
+
+**读取**：文档在 **skill 目录内**（如 `~/.claude/skills/weaver-e10-builder/`），`references/...`、`actionflows/...`、`assets/...` 均相对该目录。按需读取对应文件（决策树命中哪个读哪个，不要一次性全部读入）。
+
+**模板拷贝**：页面模板（assets/sample）用 `e10-cli skill copy [目录]` 拷到工作区（默认当前目录，直接放出 `references/`、`actionflows/`、`assets/`）。
+
+> **读 `references/...` 提示文件不存在** → 本机 skill 文档还没同步 → 先 `e10-cli skill sync`，或确认 skill 已装后重跑 `e10-cli auth status`。
+
+> 文档版本 = CLI 版本（`e10-cli --version`）。升级 CLI 后跑一次 `skill sync`（或 auth status）即可带新文档。
+
+## 核心理念
+
+> **一份需求文档 = 一个 eb 应用。** 需求里的所有表单、流程、菜单、页面都建在**同一个应用**下，不要按功能点/表单拆成多个应用。只有需求明确要求分属不同业务系统时才建多个应用（此时先跟用户确认再动手）。
+
+```
+一份需求文档 → 一个 eb 应用
+ └→ 应用下的资源: 表单 → 流程 → 菜单 → 页面
+     前四个是业务主体
+          页面是最后一步
+```
+
+接到需求不要一上来就写页面代码。先想清楚这一个应用下需要哪些表单、字段怎么设计、流程怎么走。
+
+**CLI 支持以下能力，均为第一轮就能配好的，不要留到"后续再补"：**
+- 字段显隐联动（`form linkage add`）——效果类型：`hide`隐藏 / `show`显示(只读) / `edit`编辑 / `readonly`只读 / `required`必填 / `hideLine`隐藏行（仅表格布局，`hideRow` 兼容）
+- 动作流常量/公式/加减（`--constants` / `--formula` / mapping `+` `-` 前缀）
+- 动作流新建/保留式更新（`actionflow generate` / `actionflow update`）；动作流禁用/删除使用 `workflow action disable|delete|batch-delete`
+- 动作流事件触发（`ApproveTrigger` / `EventFormData` / `EventButton` / `DateTrigger` / `TimeBatchTrigger` / `SimpleScheduler` / `CustomTrigger` / `InnerMQListener`）和内置 MQ 发送动作（`InnerMQSend`）；各触发器按组件类型联动节点/时机，内置 MQ 监听与发送禁止同流
+- 动作流更新保持原触发器不变，固定保存为新版并回读校验；若需改变触发类型、触发表单、触发时机或触发器参数，必须新建动作流
+- 自定义触发与内置 MQ 监听使用平台原生输入参数结构；参数行、根触发器图标和保存后回读结果均纳入正确性检查
+- 动作流标准函数按每个函数的真实参数名、类型、必填规则和枚举配置生成；`code`/`custom` 仍需按平台或租户能力单独处理，函数接口只作使用时的辅助校验
+- 分支条件 AND/OR 嵌套（`workflow save-condition`）
+- 表单相关人员审批（`set-operator --type form`）
+- 复杂编号/年份编号（`form serial-mark`，如 XM-2026-001）
+- 消息提醒动作流（`workflow message create`）
+- 表单布局管理（`form layout read/init/set-read-only/set-required/move/remove-field`）
+- 表单权限管理（`form permission list/add/remove/rebuild`）
+- 表单视图管理（`form view create/list/populate` + `form table-view create`）
+- 视图权限（`form view-permission list/grant/set`）
+- EBuilder 关联字段数据过滤（`form ebuilder-filter get/set/clear`）
+- 字段函数公式（`form formula set/get/list/functions`）
+
+---
+
+## 关于「流程表单 / 工作流程」（非默认路径）
+
+默认一律走 **eb 表单**（低代码应用内，`workflow create`）——本 skill 的主体就是这个路径，不要主动改道。实在不确定的时候，使用UserAsking工具询问用户。通常情况下：工作流程会配表单引擎创建的原生表单。
+
+**只有当用户明确强调「用流程表单 / 工作流程 / 流程中心建流程、不在应用下」时**，才改用 `workflow create-workflow <name> --sub-company <机构>`（`relateForm=0` 自建 / `--form-id` 绑定已有流程表单；表单走 `/api/workflow/core/form/...`；不带 eb 模式的 `source`/`messageParams`）。用户没强调就按 eb 表单走，不要提流程表单。流程表单建好后，加字段 / 明细子表 / 布局用 `wf-form` 系列命令（`wf-form read` / `add-field` / `add-detail-table` / `layout init` / `layout add`），与 eb 表 `form` 命令对齐、机制相同（仅前缀 `/api/workflow/core/form/` 与 `module:'workflow'` 不同）。字段属性（必填/只读/可编辑/独占一行）用 `wf-form field-prop <formId> --required 项目名称 --readonly 审批状态`（getConfig 读→改→initLayout 保存到运行时布局；FLOW 模板默认业务字段只读锁死，建字段后都要跑）。多套布局并存用 `wf-form layout add <formId> --name <布局名> --layout-type FLOW|EXCEL`（流式/表格式，PC/移动端各一套不覆盖）；删布局 `wf-form layout delete <formId> <layoutId>`（emptyNodeLayout 从列表移除）；字段分组用 `wf-form group <formId> --groups '{"基本信息":["字段名"],"系统设置":["字段名"]}'`（折叠容器，对齐 eb 表）。
+
+概念补充：EB应用无法选到表单引擎创建的原生表单。**eb 应用内的流程也有自由流程选项（平台支持），但 CLI 的 `workflow create`（eb）暂不支持（isFree 固定 0）；只有工作流程 `workflow create-workflow` 支持 `--is-free 1`。用户要求 eb 流程自由流转时，须告知 CLI 暂不支持（平台可在浏览器配）。**
+
+概念补充：**表单字段一旦有数据就不能删除了**（`deleteFormField` 会报"当前字段已被布局引用，不允许删除"；先 initLayout 从布局移除再删也删不掉有数据的字段）。因此字段加错了/多余时**不要删，直接从布局隐藏**：getConfig（带 groupFieldIds）→ 把该字段从 Collapse children 里过滤掉 → initLayout 重存，字段定义保留、表单里不再显示。CLI 目前也没有 `wf-form delete-field`（三件套待补）；eb 表 `form delete` 只删整张表单。
+---
+
+## 面向人群
+
+- 本 skill 面向非编程人员。用户不懂技术，不会描述字段类型、数据关系。
+- 你要主动引导，把模糊需求翻译成精确的平台资源设计。
+
+### 工作流
+
+```
+0. 环境确认（每次对话必做）
+   a. 检查当前鉴权：e10-cli auth status（会顺带自动把 skill 文档同步到本机已装 skill）
+   b. 确认文档在 skill 目录内（如 `~/.claude/skills/weaver-e10-builder/references/`）；不在就先 `e10-cli skill sync`
+   c. 用户提到不同系统地址（如"在 xxx 搭建"）→ 必须切换鉴权：
+      - 已有 profile（凭证已存）：e10-cli auth profile use <name>（直接切，无需重新登录）
+      - 新环境：e10-cli auth set --eteamsid "<ETEAMSID>" --base-url <url>
+        （ETEAMSID 从浏览器 DevTools → Application → Cookies 复制；浏览器 OIDC 登录暂未实现，不要用 auth login）
+
+1. 判断需求复杂度
+   ├─ 涉及 2+ 模块（应用/表单/流程/页面）→ 进入步骤 2
+   └─ 简单单步操作（改字段、查数据）→ 直接执行
+
+2. 全局资源设计（复杂需求必经）
+   a. 理解需求，不够清楚的地方反问用户
+   b. 在本地写 `plan.md`，**认真阅读用户提供的实施方案/需求文档**，**参考 `references/common/guide-plan-template.md` 模板格式**，把方案中涉及的所有资源与配置项列清楚（应用/表单/字段/流程/出口条件/联动/权限/编号/台账配置等）。方案里提到的每项都要在 plan 中体现，不能凭记忆遗漏。模板里的 `[ ]` 是待办，做完验证才改 `[x]`——禁止预勾、禁止自创格式。
+   c. 拿计划大纲和用户确认（**此阶段 plan 里所有 `[ ]` 保持未勾**——是待办清单，不是完成清单）
+   d. 用户确认后按大纲**逐项执行、逐项打勾**：每做完一项、验证通过，才把 `[ ]` 改 `[x]` 并填入实际 ID。**完成一条打勾一条**，禁止预勾。
+
+3. 执行搭建（**最多分三段，每段完成停下来让用户确认，确认后才进下一段**）
+   - 段① 应用+角色+全部表单（建表+表内项配齐）→ 确认字段设计 → 段② 流程（先列出口条件清单→逐条创建→`condition list` 回读核对）→ 确认流程 → 段③ 菜单+页面。分段细节与表内项清单见 `references/common/guide-plan-template.md`「执行分段」。
+   - 简单单步需求（改字段、查数据）不分段，直接执行。
+```
+
+**关键约束**：
+- plan.md 强制按 `references/common/guide-plan-template.md` 格式写；规划阶段不调写命令、逐项销号、分段确认、字段一次性建好等规则见模板「规则备忘」
+- 本服务运行于 Windows 环境，注意命令行兼容性
+- 不要多说废话，直接干活。用户等的是结果。
+- **写代码不要犹豫**，按模板直接出完整代码，写完用 `e10-cli check` 验证。错了报错再改。
+- **解析 Word 文档**：用 `e10-cli docx read <文件>` 一键转 markdown + 提取图片，**禁止自己写 python-docx 脚本**。读取后必须逐张 Read `_images/` 目录里的图片做多模态理解，**把分析结果写回 md**（替换图片占位符为实际描述，让文档完整可读）。
+
+---
+
+## 决策树
+
+> **根据用户需求自动加载对应子文档，不要一次性读取全部 reference。**
+>
+> **动作流两种用法**：动作流「生成」一律走 native `e10-cli actionflow generate`（语义 plan → 编译 → preflight → 保存并启用 → 正式回读，event 节点自带流程节点触发绑定，**推荐**）；`e10-cli workflow action` 仅作动作流管理（`list-node`/`clear-node` 查清节点绑定、`delete`/`disable`/`batch-delete` 禁用删除动作流 app）。本表字段赋值/节点附加操作（actionType=0）用 `e10-cli workflow save-action`。
+> ```bash
+> e10-cli actionflow component-list                          # 列已登记组件
+> e10-cli actionflow component-describe <type>               # 读组件契约
+> e10-cli actionflow generate '{"planFile":"@plan.json","appName":"AI-名称"}'  # 生成+保存并启用+正式回读；planFile 必须以 @ 引用文件（@plan.json 或 @绝对路径），CLI 强制要求 @ 前缀
+> e10-cli workflow action list-node <wf> <node>             # 查节点绑定；clear-node 清；delete/disable 删动作流
+> ```
+
+| 用户关键词 | 加载文档 |
+|-----------|---------|
+| 写plan、搭建计划、plan.md、资源梳理、搭建模板、必做项清单 | `references/common/guide-plan-template.md` |
+| 建应用、创建应用、app、应用列表、应用详情、应用目录、app read/list/folder/edit/delete | `references/common/ref-cli-commands.md` |
+| 字段联动、跨表带出赋值、FormDataLinkage、多跳带出、关联客户带出客户类型、field-linkage、Text字段赋值名称 | `references/form/guide-field-linkage.md`（三种联动对比 + 单跳/多跳 + --hops 格式 + Text 字段必须多跳取名称） |
+| 鉴权、登录、ETEAMSID、多环境、profile、切换环境 | `references/auth/guide-auth.md` |
+| 表单数据读写、getSimpleData、withDisplayNames、getFieldOptions、saveFormData、updateFormData | `references/coding/guide-form-crud.md`（前端代码） |
+| form data add、form data list、form data delete、写入数据、查询数据、删除数据 | `references/form/guide-form-data.md` |
+| 编辑回显、handleEdit、getAllData、数据回填 | `references/coding/guide-edit-backfill.md`（前端代码） |
+| 字段联动、显隐联动、条件显示、form linkage | `references/form/guide-form-linkage.md` |
+| 新建表单、form create、字段定义、字段类型、fields.json | `references/form/guide-create-form.md` |
+| 流程、审批、workflow、提交流程、预填 | `references/workflow/guide-workflow.md` |
+| 流程节点、操作者、审批人、连线、添加节点、删除连线、删除节点、delete-node、节点操作者、set-operator、出口名称、link-rename、节点字段权限、field-permission | `references/workflow/guide-workflow.md` |
+| 节点校验、提交校验、node validate、智能审批规则、字面值校验、禁止提交 | `references/common/ref-cli-commands.md` |
+| 分支条件、出口条件、条件JSON、save-condition、连线条件 | `references/workflow/guide-workflow-condition.md` |
+| 动作流、跨表单、写入台账、ActionEbAdd/ActionEbUpdate/ActionEbDelete、提交事件、数据来源、requestId、按流程定位、回写数据ID、回写 | `references/workflow/guide-workflow-action.md`（动作流生成走 `e10-cli actionflow generate`；`workflow action` 仅查/清/删/禁用；本表字段赋值走 `save-action`） |
+| 菜单、导航、左侧菜单、系统页面、待办、已办、流程监控 | `references/menu/system-menus.md` |
+| 角色、角色管理、权限、成员 | `references/common/ref-cli-commands.md` |
+| 新页面、导出、路由、entry.js、asyncImport | `references/coding/guide-page-export.md`（前端代码） |
+| 写页面、页面代码、React编码、组件、entry.js模板 | `references/coding/guide-page-code.md`（前端代码） |
+| CLI命令、打包、build、import、创建应用/表单/菜单 | `references/common/ref-cli-commands.md` |
+| 编译报错、语法不支持、babel | `references/coding/ref-compile-rules.md`（前端代码） |
+| Word文档、docx、需求文档、解析文档 | `e10-cli docx read` 一键转换，禁止自己写脚本 |
+| 新建视图、表格视图、看板、日历、思维导图、form view、台账显示列、显示列、list-columns、搜索条件、排序、list-sort | `references/form/guide-form-view.md` |
+| 视图权限、查看布局、修改共享权限、view permission | `references/form/guide-form-view-permission.md` |
+| EBuilder关联、关联表单、数据过滤设置、ebuilder-filter、EBuilder显示列、ebuilder-columns、去掉系统字段、只留业务字段 | `references/form/guide-ebuilder-filter.md` |
+| 关联浏览筛选、数据范围设置、浏览数据定义、只选启用状态、关联客户过滤、ebuilder-scope | `references/form/guide-ebuilder-scope.md` |
+| 字段分组、分组容器、字段分段、基本信息/合同信息分段、Collapse、Fold、字段归组 | `references/form/guide-create-form.md`（**按需**：用户明确要求字段分组才在 fields.json 写 `group`，默认不加分组） |
+| 独占一行、整行显示、字段换行、singleRow、--single-row | `references/form/guide-create-form.md`（fields.json 字段写 `"singleRow":true`；add-field 用 `--single-row`） |
+| 字段多选、多选、单选、人员多选、部门多选、关联多选、multiple、--multiple | `references/form/guide-create-form.md`（fields.json 写 `"multiple":true`；add-field `--multiple`；edit-field `--multiple`/`--no-multiple`。仅人员/部门/EBuilder/Browser 支持） |
+| 函数公式、字段公式、formula、DAYS、日期差、expressId、公式绑定 | `references/form/guide-form-formula-functions.md`（219 个函数速查矩阵，写 `fields.json` 的 `formula` 或 `form formula set --expression` 时查函数格式/示例；**日期差用 `DAYS(开始,结束)`**） |
+| 显示列批量设置、批量加列、列宽、列顺序、list-columns --set | `references/form/guide-list-columns.md` |
+| 顶部统计、明细统计、付款记录数、list-stats、子表计数 | `references/form/guide-list-stats.md` |
+| 关联页签、关联视图、association、页签显示布局、关联数据筛选、set-filter | `references/form/guide-form-association.md` |
+| 表单按钮、button、自定义按钮、视图按钮、行上、行末下拉、按钮显示位置 | `references/form/guide-form-button.md`（位置配置）；`references/common/ref-cli-commands.md`（其他按钮命令） |
+| 表单权限、permission、数据权限 | `references/common/ref-cli-commands.md` |
+| 消息提醒、消息动作流、workflow message、IM提醒 | `references/common/ref-cli-commands.md` |
+| 编号规则、serial-mark、自动编号、流水号、年份编号、流程编号、numbering | `references/common/ref-cli-commands.md` |
+| 超时处理、退回设置、节点菜单、node timeout、node reject | `references/common/ref-cli-commands.md` |
+| 流程设置、提交确认、签字意见、批量操作、setting | `references/common/ref-cli-commands.md` |
+| 流程存档、定时触发、高级设置、advanced | `references/common/ref-cli-commands.md` |
+| HRM、矩阵、条件矩阵、matrix、映射表 | `references/hrm/guide-matrix.md` |
+
+> 组件文档（Button/Table/Input/Upload 等）在 `references/` 中按文件名查找。完整索引见 `_catalog.md`。
+
+> **表单自带默认台账** — 普通列表需求先查询并复用已有默认台账，记录实际名称/listId；“客户信息表／客户信息”这类简称差异不构成新建理由，默认保留原名，不统一去掉“表”字。仅名称需对齐时应改名而非另建。用户明确要求额外表格视图时，用 `form table-view create` 原子完成 `nListView` 创建、显示列配置和回读；禁止用 `form view create --type tableView` 创建空壳。`formView` 使用 `form view create` 后必须执行 `form view populate`。
+
+---
+
+## 平台架构
+
+- **Ecode** — 存放和运行代码的平台，自定义页面在这里编码、构建、运行
+- **Ebuilder 应用** — 独立的概念，包含表单、流程等元素（与 Ecode 项目不同）
+- **表单自带台账，无需开发** — 每个表单创建后，平台自动生成默认的台账/列表页面，自带搜索、筛选、导出、批量操作。**台账会自动挂入应用菜单，无需手动建菜单。** 这不是一个「功能」，是一个硬规则——建了表单就有台账页面，不需要写一行代码。只有以下场景才需要自定义页面：图表仪表盘、跨表单聚合视图、特殊交互流程、对外公开页面。
+- 所有系统交互命令均通过 `e10-cli` 执行（已全局 link）。auth 文件自动查找，也可 `--auth <path>` 指定。
+- 用户的 userId 是固定的变量 `TEAMS.currentUser.id`，系统里已支持，js 代码里可以直接写。
+
+---
+
+## 平台能力边界（禁止编造）
+
+> **以下能力 CLI 不支持、平台也不支持，AI 禁止声称可以做、禁止输出操作步骤。**
+
+| 不支持的能力 | 说明 |
+|-------------|------|
+| **H5/移动端菜单** | 移动端是独立体系（不同 URL + 不同 pageId），尚未整理，禁止编造 |
+
+> 遇到用户要求以上不支持的能力时，必须明确告知"当前平台/CLI 不支持"，不要给出虚假操作步骤。
+
+---
+
+## 关键数据操作速查
+
+### 表单数据 API
+
+| API | 用途 | 返回内容 |
+|-----|------|---------|
+| `getSimpleData(objId, userId)` | 读 ID、写回 formToSave | 所有特殊字段统一返回 `fieldOptionId`（纯数字串） |
+| `getAllData(objId, userId)` | 提取名称、编辑回显 | 含 `fieldOptionName`，mainTable key 是随机哈希 |
+| `withDisplayNames(rows, map)` | 表格展示：ID → 名称 | 把 Select 的 `valueKey` 映射为中文名 |
+| `getFieldOptions(fieldId, objId)` | 拿下拉选项 | `[{valueKey, name}]` |
+
+### 不同字段类型，名称来源不同
+
+| 字段类型 | getSimpleData 返回 | 展示时名称来源 |
+|---------|-------------------|--------------|
+| Text / Number / Date | `"值"` / `123` / `"2026-01-01"` | 直接展示 |
+| Select / RadioBox / CheckBox | `"1283421826353889337"`（选项 ID） | `getFieldOptions` → `withDisplayNames` 映射 |
+| **Employee** | `"2765550234448235905"`（用户 ID） | `getAllData` 的 `fieldOptionName`，**不是** getFieldOptions |
+| **Department** | `"2765550234448235905"`（部门 ID） | 同上 |
+| FileComponent | `"fileid1,fileid2"`（文件 ID 串） | 上传组件的 `name` |
+
+> 完整数据读写指南见 `references/coding/guide-form-crud.md`（前端代码），编辑回显见 `references/coding/guide-edit-backfill.md`（前端代码）。
+
+---
+
+## 页面编码
+
+> **页面是搭建流程的最后一步。** 写页面代码前，确保应用、表单、流程都已建好。
+
+页面编码规范、entry.js 模板、@weapp/ui 组件清单、编译规则、代码质量检查清单 → 详见 `references/coding/guide-page-code.md`（前端代码）。
+
+---
+
+## 快速参考
+
+- 入口注册 + 新页面导出 → `references/coding/guide-page-export.md`（前端代码）
+- 流程 URL 透传、预填 → `references/workflow/guide-workflow.md`
+- 编译约束（var 声明、不支持的语法）→ `references/coding/ref-compile-rules.md`（前端代码）
+- CLI 命令速查 → `references/common/ref-cli-commands.md`
+- 组件完整索引 → `_catalog.md`

package/skill-docs/actionflows/references/components/calendar/MeetingCreate.md

@@ -0,0 +1,17 @@
+# 创建会议（`MeetingCreate`）
+
+## 何时使用
+
+创建会议并设置会议字段。
+
+## 先查询
+
+查询创建人、召集人、联系人及会议相关选择器对象。
+
+## 不可猜测
+
+人员、会议室、类型、附件等资源必须为真实对象；当前字段赋值按已验证固定值处理。
+
+## 最小计划
+
+`operators`、`meetingType`，以及需求涉及的会议字段。

package/skill-docs/actionflows/references/components/calendar/ScheduleCreate.md

@@ -0,0 +1,17 @@
+# 创建日程（`ScheduleCreate`）
+
+## 何时使用
+
+创建日程、参与人、共享人和地点。
+
+## 先查询
+
+查询创建人、参与人、负责人、会议室和日程类型。
+
+## 不可猜测
+
+人员和资源必须为真实 Browser 对象；标题、时间、内容目前只传已验证固定值。
+
+## 最小计划
+
+`creatorUser`、`title`、`startTime`、`endTime`。

package/skill-docs/actionflows/references/components/document/AttachmentCopy.md

@@ -0,0 +1,17 @@
+# 复制附件（`AttachmentCopy`）
+
+## 何时使用
+
+复制附件到指定目录，可按平台设置创建承载文档。
+
+## 先查询
+
+查询附件、目标目录和操作人。
+
+## 不可猜测
+
+目录与子目录对象必须是真实前端对象。
+
+## 最小计划
+
+`attachment`、`fileFolder`、`operator`。

package/skill-docs/actionflows/references/components/document/AttachmentMove.md

@@ -0,0 +1,17 @@
+# 附件归档（`AttachmentMove`）
+
+## 何时使用
+
+将附件移动到指定文档目录。
+
+## 先查询
+
+查询附件、目标目录及操作人。
+
+## 不可猜测
+
+目录和可选 `fileFolderChild` 必须来自前端真实对象。
+
+## 最小计划
+
+`attachment`、`fileFolder`、`operator`。

package/skill-docs/actionflows/references/components/document/DocumentCopy.md

@@ -0,0 +1,17 @@
+# 文档另存为（`DocumentCopy`）
+
+## 何时使用
+
+把指定文档保存为另一篇新文档。
+
+## 先查询
+
+查询源文档、目标目录与操作人。
+
+## 不可猜测
+
+源文档和目录必须为真实 Browser 对象。
+
+## 最小计划
+
+`documents`、`fileFolder`、`operator`。

package/skill-docs/actionflows/references/components/document/DocumentDelete.md

@@ -0,0 +1,17 @@
+# 删除文档（`DocumentDelete`）
+
+## 何时使用
+
+将文档删除至回收站或按平台允许方式删除。
+
+## 先查询
+
+查询文档和操作人。
+
+## 不可猜测
+
+删除对象必须是当前租户真实文档。
+
+## 最小计划
+
+`documents`、`operator`、`deleteType`。

package/skill-docs/actionflows/references/components/document/DocumentEdit.md

@@ -0,0 +1,17 @@
+# 更新文档（`DocumentEdit`）
+
+## 何时使用
+
+更新文档字段、正文或附件。
+
+## 先查询
+
+查询目标文档、操作人和需要的前端设置 DTO。
+
+## 不可猜测
+
+至少提供一项实际变更；正文、附件流和设置对象只能使用真实 DTO。
+
+## 最小计划
+
+`documentId`、`operatorId` 与一项变更。

package/skill-docs/actionflows/references/components/document/DocumentMove.md

@@ -0,0 +1,17 @@
+# 移动文档（`DocumentMove`）
+
+## 何时使用
+
+将文档移动到目标目录。
+
+## 先查询
+
+查询文档、目录和操作人。
+
+## 不可猜测
+
+目录设置或子目录对象不能伪造。
+
+## 最小计划
+
+`documents`、`fileFolder`、`operator`。

package/skill-docs/actionflows/references/components/document/DocumentPermissionChange.md

@@ -0,0 +1,17 @@
+# 文档权限变更（`DocumentPermissionChange`）
+
+## 何时使用
+
+对文档执行赋权或收权。
+
+## 先查询
+
+查询文档及平台返回的权限对象。
+
+## 不可猜测
+
+固定赋权只能传真实 `SharePermissionBean`；动态赋权传真实上下文公式。
+
+## 最小计划
+
+`docId`、`assignType`，以及对应的 `permissionList` 或 `permissionFormula`。

package/skill-docs/actionflows/references/components/document/DocumentRenewal.md

@@ -0,0 +1,17 @@
+# 续借文档（`DocumentRenewal`）
+
+## 何时使用
+
+发起订阅文档的续借。
+
+## 先查询
+
+查询可续借文档与续借人。
+
+## 不可猜测
+
+文档必须是当前租户真实订阅/文档对象。
+
+## 最小计划
+
+`documentId`、`operatorId`。

package/skill-docs/actionflows/references/components/document/DocumentRevert.md

@@ -0,0 +1,17 @@
+# 还原删除文档（`DocumentRevert`）
+
+## 何时使用
+
+还原已删除文档。
+
+## 先查询
+
+确认已删除文档和操作人。
+
+## 不可猜测
+
+只处理真实回收站文档。
+
+## 最小计划
+
+`documents`、`operator`。

package/skill-docs/actionflows/references/components/document/DocumentSave.md

@@ -0,0 +1,17 @@
+# 新建文档（`DocumentSave`）
+
+## 何时使用
+
+在目标目录新建一篇文档。
+
+## 先查询
+
+查询目录、操作人及文档属性设置 DTO。
+
+## 不可猜测
+
+标题、目录、操作人和 `setting` 缺一不可；正文与附件只接受真实 DTO 或文件引用。
+
+## 最小计划
+
+`docTitle`、`fileFolder`、`operatorId`、`setting`。

package/skill-docs/actionflows/references/components/document/DocumentSubscription.md

@@ -0,0 +1,17 @@
+# 借阅文档（`DocumentSubscription`）
+
+## 何时使用
+
+发起文档借阅。
+
+## 先查询
+
+查询可借阅文档和操作人。
+
+## 不可猜测
+
+文档必须是当前租户真实订阅/文档对象。
+
+## 最小计划
+
+`documents`、`operator`。

package/skill-docs/actionflows/references/components/document/DocumentSubscriptionApprove.md

@@ -0,0 +1,17 @@
+# 文档借阅批准（`DocumentSubscriptionApprove`）
+
+## 何时使用
+
+批准文档借阅。
+
+## 先查询
+
+查询文档与借阅人。
+
+## 不可猜测
+
+借阅人必须为真实 Browser 对象。
+
+## 最小计划
+
+`documents`、`subscriber`。

package/skill-docs/actionflows/references/components/document/DocumentSubscriptionSendBack.md

@@ -0,0 +1,17 @@
+# 文档借阅退回（`DocumentSubscriptionSendBack`）
+
+## 何时使用
+
+处理文档借阅退回。
+
+## 先查询
+
+查询文档与借阅人。
+
+## 不可猜测
+
+不以文档名称或人员名称替代真实对象。
+
+## 最小计划
+
+`documents`、`subscriber`。

package/skill-docs/actionflows/references/components/document/DocumentSubscriptionWithdraw.md

@@ -0,0 +1,17 @@
+# 文档借阅收回（`DocumentSubscriptionWithdraw`）
+
+## 何时使用
+
+收回已借出的文档。
+
+## 先查询
+
+查询文档与借阅人。
+
+## 不可猜测
+
+仅对当前租户真实借阅记录执行。
+
+## 最小计划
+
+`documents`、`subscriber`。

package/skill-docs/actionflows/references/components/document/FileFolderSave.md

@@ -0,0 +1,17 @@
+# 创建文件夹（`FileFolderSave`）
+
+## 何时使用
+
+在指定上级目录创建文件夹。
+
+## 先查询
+
+查询上级目录、操作人及前端返回的子目录定义。
+
+## 不可猜测
+
+`fileFolderChild` 是前端 DTO，不能仅以名称拼造。
+
+## 最小计划
+
+`fileFolder`、`fileFolderChild`、`operator`。