weaver-e10-builder 1.6.16 → 1.7.0

package/skill-docs/references/common/capability-boundaries.md

@@ -1,36 +1,36 @@
-# 平台与 CLI 能力边界
-
-> 判「不支持」必须带证据（见下方证据等级）。**CLI 没暴露 ≠ 平台不支持**：命令表只能证明执行器没有，不能升级成平台结论。
-
-## 已支持、容易误判为「不支持」的能力
-
-| 能力 | 结论 | 命令 |
-|---|---|---|
-| 移动端菜单（H5） | 支持。移动端与 PC 是**两套独立记录**（同一 `savePublishMenu`，只换 `terminalType`），可独立增删改；也能把 PC 端菜单整体同步到移动端 | 菜单类命令加 `--terminal mobile`；同步用 `menu sync <appId>` |
-
-## 判断「CLI 支不支持」的正确方式
-
-1. 先查 `references/common/ref-cli-commands.md` 的对应命令与参数；
-2. 再跑 `e10-cli <命令> --help` 确认当前版本有没有该选项；
-3. 能只读验证的，做一次只读查询或回读并记录结果；
-4. 仍无法确认时，标「待环境核查」或「未证实」，不要猜；必要时问用户；
-5. 已确认做不到或只能部分做到时，写进 `plan.md` 的 0.1 和「待确认、需补充及无法实现」一节，保持 `[ ]`。
-
-**禁止绕行**：不要为了完成配置临时编写 `.mjs` 脚本调用内部接口，也不要让用户直接操作浏览器或设计器代替命令；确认没有命令时，保留该项未完成状态并说明影响。
-
-## 证据等级（写预检结论 / 边界表时必填）
-
-| 等级 | 含义 | 能否对外说「不支持」 |
-|---|---|---|
-| 实测 | 有平台原始回执，或写后有独立回读 | 可以，注明环境和日期 |
-| 回读字段 | 平台返回体里确有该字段，语义未必实测 | 不能直接判「不支持」 |
-| 命令表 | 只能证明**当前 CLI 没暴露** | **不能**；命令没暴露不等于平台不支持 |
-| 未证实 | 有结论、无证据 | **不能**对外宣称 |
-
-> 「选项表/命令表」只证明执行器没暴露，不能升级成「平台不提供」。需要平台结论时，先补实测或回读证据；没有证据就写「待环境核查」。
-
-## 边界记录格式
-
-| 需求 | 结论 | 证据等级 | 依据 | 影响与处理 |
-|---|---|---|---|---|
-| <需求项> | 可做 / 部分可做 / 做不到 / 待环境核查 | 实测 / 回读字段 / 命令表 / 未证实 | <具体命令、回执或文档> | <保留未完成、替代方式或需用户决定> |
+# 平台与 CLI 能力边界
+
+> 判「不支持」必须带证据（见下方证据等级）。**CLI 没暴露 ≠ 平台不支持**：命令表只能证明执行器没有，不能升级成平台结论。
+
+## 已支持、容易误判为「不支持」的能力
+
+| 能力 | 结论 | 命令 |
+|---|---|---|
+| 移动端菜单（H5） | 支持。移动端与 PC 是**两套独立记录**（同一 `savePublishMenu`，只换 `terminalType`），可独立增删改；也能把 PC 端菜单整体同步到移动端 | 菜单类命令加 `--terminal mobile`；同步用 `menu sync <appId>` |
+
+## 判断「CLI 支不支持」的正确方式
+
+1. 先查 `references/common/ref-cli-commands.md` 的对应命令与参数；
+2. 再跑 `e10-cli <命令> --help` 确认当前版本有没有该选项；
+3. 能只读验证的，做一次只读查询或回读并记录结果；
+4. 仍无法确认时，标「待环境核查」或「未证实」，不要猜；必要时问用户；
+5. 已确认做不到或只能部分做到时，写进 `plan.md` 的 0.1 和「待确认、需补充及无法实现」一节，保持 `[ ]`。
+
+**禁止绕行**：不要为了完成配置临时编写 `.mjs` 脚本调用内部接口，也不要让用户直接操作浏览器或设计器代替命令；确认没有命令时，保留该项未完成状态并说明影响。
+
+## 证据等级（写预检结论 / 边界表时必填）
+
+| 等级 | 含义 | 能否对外说「不支持」 |
+|---|---|---|
+| 实测 | 有平台原始回执，或写后有独立回读 | 可以，注明环境和日期 |
+| 回读字段 | 平台返回体里确有该字段，语义未必实测 | 不能直接判「不支持」 |
+| 命令表 | 只能证明**当前 CLI 没暴露** | **不能**；命令没暴露不等于平台不支持 |
+| 未证实 | 有结论、无证据 | **不能**对外宣称 |
+
+> 「选项表/命令表」只证明执行器没暴露，不能升级成「平台不提供」。需要平台结论时，先补实测或回读证据；没有证据就写「待环境核查」。
+
+## 边界记录格式
+
+| 需求 | 结论 | 证据等级 | 依据 | 影响与处理 |
+|---|---|---|---|---|
+| <需求项> | 可做 / 部分可做 / 做不到 / 待环境核查 | 实测 / 回读字段 / 命令表 / 未证实 | <具体命令、回执或文档> | <保留未完成、替代方式或需用户决定> |

package/skill-docs/references/common/guide-install.md

@@ -1,44 +1,44 @@
-# 安装、升级与文档同步
-
-## 版本必须匹配
-
-skill 与 CLI 的版本要一致（见 SKILL.md frontmatter 的 `version`）。版本不一致时，命令、选项和文档可能对不上。
-
-```bash
-e10-cli --version          # 应与 SKILL.md 标注的版本一致
-npm install -g weaver-e10-builder
-```
-
-## CLI 升级
-
-- 一般工具：先 `npm rm -g weaver-e10-builder` 卸掉旧包，再重新安装，避免 bin 残留冲突。
-- WorkBuddy：先直接用 bash 删除旧包目录（不走 npm 删除），再用 npm 纯安装，并指定一个有权限的工作目录作为缓存地址。
-
-## skill 安装 / 升级
-
-先卸旧（旧名 `skill-e10-cli`），再装新：
-
-```bash
-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`
-
-## 文档树同步
-
-1.1.0 起发布的 skill 是**薄指令层**：只带 SKILL.md、`_catalog.md`、actionflows 指令层和 scripts，不含深目录文档树（适配 marketplace 两级目录限制）。完整文档随配套 CLI 的 `skill-docs` 分发。
-
-- 每次 `e10-cli auth status` 会自动探测本机已装 skill（`~/.claude/skills`、`~/.workbuddy/skills`、`~/.codex/skills`）并同步文档；版本一致则跳过。
-- 手动刷新：`e10-cli skill sync`；可 `--target <安装根目录>` 指定其他工具目录。
-- 装完 skill 后看到 references 文档多出/更新、旧文档被清理，都是正常的同步现象，不是装错或重复安装。
-- 读 `references/...` 提示文件不存在 → 先 `e10-cli skill sync`，或确认 skill 已装后重跑 `e10-cli auth status`。
-
-## 文档读取与模板拷贝
-
-- 文档在 skill 目录内（如 `~/.claude/skills/weaver-e10-builder/`），`references/...`、`actionflows/...`、`assets/...` 均相对该目录。
-- 按决策树命中哪个读哪个，不要一次性全部读入。
-- 页面模板用 `e10-cli skill copy [目录]` 拷到工作区（默认当前目录，放出 `references/`、`actionflows/`、`assets/`）。
+# 安装、升级与文档同步
+
+## 版本必须匹配
+
+skill 与 CLI 的版本要一致（见 SKILL.md frontmatter 的 `version`）。版本不一致时，命令、选项和文档可能对不上。
+
+```bash
+e10-cli --version          # 应与 SKILL.md 标注的版本一致
+npm install -g weaver-e10-builder
+```
+
+## CLI 升级
+
+- 一般工具：先 `npm rm -g weaver-e10-builder` 卸掉旧包，再重新安装，避免 bin 残留冲突。
+- WorkBuddy：先直接用 bash 删除旧包目录（不走 npm 删除），再用 npm 纯安装，并指定一个有权限的工作目录作为缓存地址。
+
+## skill 安装 / 升级
+
+先卸旧（旧名 `skill-e10-cli`），再装新：
+
+```bash
+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`
+
+## 文档树同步
+
+1.1.0 起发布的 skill 是**薄指令层**：只带 SKILL.md、`_catalog.md`、actionflows 指令层和 scripts，不含深目录文档树（适配 marketplace 两级目录限制）。完整文档随配套 CLI 的 `skill-docs` 分发。
+
+- 每次 `e10-cli auth status` 会自动探测本机已装 skill（`~/.claude/skills`、`~/.workbuddy/skills`、`~/.codex/skills`）并同步文档；版本一致则跳过。
+- 手动刷新：`e10-cli skill sync`；可 `--target <安装根目录>` 指定其他工具目录。
+- 装完 skill 后看到 references 文档多出/更新、旧文档被清理，都是正常的同步现象，不是装错或重复安装。
+- 读 `references/...` 提示文件不存在 → 先 `e10-cli skill sync`，或确认 skill 已装后重跑 `e10-cli auth status`。
+
+## 文档读取与模板拷贝
+
+- 文档在 skill 目录内（如 `~/.claude/skills/weaver-e10-builder/`），`references/...`、`actionflows/...`、`assets/...` 均相对该目录。
+- 按决策树命中哪个读哪个，不要一次性全部读入。
+- 页面模板用 `e10-cli skill copy [目录]` 拷到工作区（默认当前目录，放出 `references/`、`actionflows/`、`assets/`）。

package/skill-docs/references/common/ref-cli-commands.md

@@ -126,7 +126,7 @@
 | `e10-cli form list-columns attr show\|set <objId> <appId> <listId> --field <fieldId> [--align left\|center\|right] [--remark <文本>] [--plain-text on\|off] [--view-data-detail on\|off] [--formula-type sum,avg\|none] [--formula-range currentPage,allPage] [--fixed on\|off] [--width N] [--width-unit px\|%] [--wrap whole\|auto\|disabled] [--hidden-column on\|off] [--editable 0\|1] [--rich-editor on\|off] [--show-name <名>] [--conversion '<json>'] [--terminal pc/mobile]` | 列属性层（`getListFields`）：对齐、字段注释、纯文本展示、数据超链接、列统计与统计范围、冻结、列宽、换行设置、隐藏列、显示名、可编辑、富文本、显示转换。PC 写入走平台单字段接口 `saveListFieldById`（**两端同时生效**）；`--terminal mobile` 按终端回写，只支持宽度/冻结/换行/隐藏这类独立属性。只改目标列，保存后回读目标列断言 |
 | `e10-cli form list-filter sql get\|set <objId> <appId> <listId> [--sql @sql.json] [--base-sql <sql>] [--dialect "mysql=<sql>"] [--dataset-id <id>]` | **SQL 条件**（`filter.type=sql_where`）：SQL 正文写进独立的 `sqlfragments` 数据集，视图只记数据集 ID。`sql.json` 键：`base` + `mysql/oracle/sqlserver/pg/dm/kingbase/st/oceanbase`（对应平台 `mysqlSql/oracleSql/sqlserverSql/pgSql/dmSql/kingBaseSql/stSql/oceanbaseMysql`）。主表别名 `t1`、明细 `d1`、`{参数}` 为运行时占位；保存后回读视图条件与数据集正文。`--dataset-id` 只切绑定不新建；`--ignore-empty on|off` 写「变量值为空时不参与过滤」（`filterIsNull`：on→false，off→true）。详见 `form/guide-form-view.md` |
 | `e10-cli form list-filter http get\|set <objId> <appId> <listId> --url <url> [--method GET\|POST] [--param name=value] [--header name=value] [--form name=value] [--payload '<json>'] [--ignore-empty on\|off]` | **自定义接口条件**（`filter.type=http`）：URL + 方法 + Params/Headers/Body(form-data 或 JSON)。落库 `data.{method,contentType,url,urlParams[],headers[],formData[],payload}`，`rootStr="自定义接口"`，PC/移动端同写；保存后回读 URL 与方法。详见 `form/guide-form-view.md` |
-| `e10-cli form list-config get\|set <objId> <appId> <listId> [选项...] [--terminal pc/mobile] [--pc-only]` | 视图设置（`getNListConfig` 顶层键），选项按平台面板分组：基本信息（`--show-title`/`--hide-checkbox`/`--default-display-edit-modal`/`--operate-column-fixed`/`--spread-top-button`/`--prefix-column`/`--field-choose-width-fixed`/`--quick-search-textarea`/`--sub-form-main`/`--sub-form-show-empty`/`--head-merge`/`--page-size`；数据列表插件另有 `--title`/`--hide-table-header`/`--operate-btn-fixed`/`--group '<json>'`/`--superior '<json>'`）、网格（`--grid-row|col|width|height` + `-type`）、显示数据（`--permission-scope`/`--data-range-type`/`--list-data-range`/`--show-follow`/`--read-state`/`--set-top|type|rule`）、批量（`--batch-add|edit` + `-fields`/`--batch-edit-value`/`--can-delete`）、展示模式（`--open-child-list`/`--sup-field`/`--expand-level`/`--expand-num-limit`/`--expand-page-type`/`--enable-group`/`--group-field`/`--group-enable-count`/`--only-display-data-group`）。只改点名键、其余原样回写，保存后只回读被改的键；`get` 额外展示操作按钮摘要（只读，不写 `buttonConfig`）。键名与平台「视图设置」面板的配置项一一对应 |
+| `e10-cli form list-config get\|set <objId> <appId> <listId> [选项...] [--terminal pc/mobile] [--pc-only]` | 视图设置（`getNListConfig`），选项按平台面板分组：基本信息（`--show-title`/`--hide-checkbox`/`--default-display-edit-modal`/`--default-display-edit-modal-permission '<json>'`/`--operate-column-fixed`/`--spread-top-button`/`--prefix-column`/`--field-choose-width-fixed`/`--quick-search-textarea`/`--sub-form-main`/`--sub-form-show-empty`/`--head-merge`/`--page-size`；数据列表插件另有 `--title`/`--hide-table-header`/`--operate-btn-fixed`/`--group '<json>'`/`--superior '<json>'`）、网格（`--grid-row|col|width|height` + `-type`）、显示数据（**数据范围落 `dataset.ebuilderDataConfig.dataSetup`**：`--data-permission ALL\|HAVE_PERMISSION_DATA` / `--data-type ALL\|FORM\|APPROVE` / `--list-data-range <值>` / `--data-setup '<整对象>'`；旧的 `--data-range-type`/`--permission-scope` 已废弃并报迁移提示。另有 `--show-follow`/`--read-state`/`--set-top|type|rule`）、批量（`--batch-add|edit` + `-fields`/`--batch-edit-value`/`--can-delete`；字段数组按 `fieldId` 子集回读，平台补全键不误报）、展示模式（`--open-child-list`→`superiorField.enable`、`--sup-field`、`--expand-level`/`--expand-num-limit` 落 `superiorField` 内、`--group-field`/`--group-enable-count`/`--only-display-data-group`；分组用 `--group` 整对象，`--enable-group` 布尔已删除）。只改点名键、其余原样回写，保存后只回读被改的键；`get` 额外展示操作按钮摘要（只读，不写 `buttonConfig`）。`--set-top-rule` 支持简化 `conditions` 入参并由 CLI 生成平台标准条件树 |
 | `e10-cli form list-unit <objId> <appId> <listId> <fieldId> <后缀> [--prefix <前缀>] [--clear] [--pc-only]` | 设置台账列显示**单位**（后缀/前缀）。平台无字段级单位属性，靠列表列配置 `showTrans.ruleConfig.suffix/prefix` 实现。如 `form list-unit ... <fieldId> "（元）"` 让列显示单位；`--clear` 清除 |
 | `e10-cli form list-format <objId> <appId> <listId> <fieldId> [--thousandths] [--no-thousandths] [--decimal <n>] [--clear] [--pc-only]` | 查看/设置台账列**千分位/小数位**（Number/Money 列）。不加参数显示当前；`--thousandths` 开千分位（列 `format:"THOUSANDS"`）、`--no-thousandths` 关、`--decimal <n>` 小数位数（`decimalLength`）、`--clear` 清除恢复默认。与 `list-unit`（单位，走 `showTrans`）是两套不同机制。**自动保留移动端配置** |
 | `e10-cli form list-click <objId> <appId> <listId> <fieldId> [--target <formObjId>] [--open-mode <模式>] [--win-size <尺寸>] [--clear] [--pc-only]` | 设置台账列**点击跳转**。`--open-mode` 支持当前页面/新窗口/弹出窗口/右侧滑出/右侧推出；`--win-size` 仅用于滑出/推出，具体数值按需求填写：百分比使用 `%`（0～100），像素使用 `px`，两种单位不可混用。缺省 `800px` |
@@ -150,14 +150,14 @@
 | `e10-cli form list-event <objId> <appId> <listId> [--add-page '<json>'] [--add-field '<json>'] [--open-mode <模式>] [--modal-width <pct>] [--modal-height <pct>] [--win-size <pct>] [--clear] [--pc-only]` | 查看/配置**行事件**（点击行数据 NewPage 打开表单布局）。`--add-page '{"pageId":"1/<objId>","pageName":"新建数据","openMode":"右侧滑出"}'` 选页面方式（pageId 缺省 `1/<objId>` 新建布局，`0/<objId>`=显示布局）、`--add-field '{"urlFieldId":"字段id"}'` 选字段方式（URL取自行内字段值，urlFieldText/Type自动补）、`--clear` 清空。**打开方式** `--open-mode`（或在 JSON 里写 `openMode`）：当前页面/新窗口/弹出窗口/右侧滑出(缺省)/右侧推出；弹出/滑出/推出 用 `--modal-width`/`--modal-height`（缺省 50%），滑出/推出 用 `--win-size`（缺省 100%）。走 saveNListConfig config.eventGroup（明文 JSON，config+mConfig 都写）。**自动保留移动端配置** |
 | `e10-cli form list-group <objId> <appId> <listId> [--enable --group-field <fieldId> [--group-size N]] [--disable] [--pc-only]` | 查看/配置**启用分组**（台账按某字段分组聚合显示）。`--enable --group-field <分组字段id> [--group-size N 默认100]` 启用/换分组字段、`--disable` 禁用（保留 groupField/groupSize 仅 enable=false）。走 saveNListConfig config.enableGroup（对象，持久化，不走 layout/save LZW）。**自动保留移动端配置** |
 | `e10-cli form list-hierarchy <objId> <appId> <listId> [--enable --parent-field <名称或fieldId> [--expand-level N]] [--disable] [--pc-only]` | 查看/配置**上下级树形展示**。上级字段必须是主表中单选、关联当前表单自身的 EBuilder 字段（常见名称“上级类型”）；与普通 `list-group` 分组聚合不是同一能力。走 `saveNListConfig config.superiorField`，保存后独立回读并自动保留移动端配置 |
-| `e10-cli form list-permission <objId> <appId> <listId> [--add-all] [--add-user <userId> --name <name>] [--add-role <roleId> [--name <name>]] [--add-matrix <矩阵id> --name <name>] [--share-level <n>] [--seclevel <min>-<max>] [--add-raw '<json>'] [--remove <id>] [--remove-all] [--clear]` | 查看/配置**台账视图权限**（谁能查看这个台账）。`--add-all` 所有人（自动把空 dataid 与 0 视为同一主体，避免重复）、`--add-user` 人员、`--add-role` 角色、`--add-matrix` 矩阵（同 `form permission archive` 的矩阵条件参数：`--matrix-condition` / `--matrix-condition-relation` / `--matrix-condition-comp-type` / `--matrix-condition-raw`）。`--remove <id>` 删除指定权限；`--remove-all` 删除全部“所有人”，与 `--add-all` 同用可清理重复后只保留一条；`--clear` 清空全部。保存走 `list/permission/save` 全量覆盖并回读。另支持共享级别和安全级别范围 |
+| `e10-cli form list-permission <objId> <appId> <listId> [--add-all] [--add-user <userId> --name <name>] [--add-dept <deptId> [--name <名称>]] [--add-role <roleId> [--name <name>]] [--add-matrix <矩阵id> --name <name>] [--share-level <n>] [--seclevel <min>-<max>] [--add-raw '<json>'] [--remove <id>] [--remove-all] [--clear]` | 查看/配置**台账视图权限**（谁能查看这个台账）。`--add-all` 所有人（自动把空 dataid 与 0 视为同一主体，避免重复）、`--add-user` 人员、`--add-dept` 部门（`--name` 缺省自动取部门名；保存后强制回读，回读不到会报错并建议改用 `--add-raw`）、`--add-role` 角色、`--add-matrix` 矩阵（同 `form permission archive` 的矩阵条件参数）。`--remove <id>` 删除指定权限；`--remove-all` 删除全部“所有人”，与 `--add-all` 同用可清理重复后只保留一条；`--clear` 清空全部。保存走 `list/permission/save` 全量覆盖并回读。另支持共享级别和安全级别范围 |
 | `e10-cli form list-search-group <objId> <appId> <listId> [--add <字段名或fieldId>] [--add-custom <名称>] [--custom @配置.json] [--archive on\|off] [--position 0\|1] [--display 平铺\|下拉] [--show-archive on\|off] [--option-order default\|field] [--no-show-count] [--count-update] [--only-with-data] [--date-granularity <列表>] [--default-group <粒度> --default-value <起,止>] [--options <列表>] [--default-options <列表>] [--remove <fieldId>] [--clear] [--pc-only]` | 查看/配置**分类搜索**（台账顶部/下拉的分类筛选）。`--add` 收**字段名或 fieldId**，已在里面则按本次参数**重建那条**（改配置走它）—— 本次没给的选项一律回到缺省，所以只改一项时要把想留着的一起给全。支持四类：**选项类**(Select/RadioBox/CheckBox)、**浏览框类**(Ebuilder/Browser/Employee/Department)、**日期类**(DateComponent)、**系统字段**(创建者/数据ID 这类)。`--position` **0=顶部(缺省)/1=左侧(下拉样式)**（平台枚举 Top="0"、Left/DropDown="1"）；`--display` 是「显示方式」：`平铺` 写 `tabStyle="tab"`、`下拉` 写 `"select"`（缺省下拉）；`--show-archive on|off` 控制「显示封存的选项」`showArchiveOption`（缺省 on）。`--add-custom <名称>` 添加**自定义分类**（`componentKey=GroupCustom`）：id 由前端生成 18 位数字、`fieldId=GroupCustom_<id>`（平台没有创建接口），分类值 `listGroupSets` 初始为空、之后在设计器里配置；同名分类再执行即更新（保留原 id），可用 `--remove <名称|id|fieldId>` 删除；`--option-order` 浏览框的选项排序（default 默认排序 / field 按字段属性设置）；`--no-show-count` 关掉统计数字，`--count-update` 让统计数字**随搜索结果更新**（选项/浏览框/日期可用，缺省只在进入台账时统计一次）；`--only-with-data` **仅显示有数据的选项**（**只有**选项/浏览框类有这个键，日期与系统字段用不了；这个键**勾上才出现**，不勾整个键都没有）；`--date-granularity` 日期粒度（全年/半年/季度/月，缺省全要）；`--options` / `--default-options` 控制选项类**哪些选项出现 / 哪些默认选中**。日期类的**默认值**用 `--default-group <粒度>` + `--default-value "起,止"`（两个**必须一起给**；平台存的是一条 `{value,group}` 的默认值，并把它对应的粒度标成默认勾上）。**仅主表字段，不支持明细（产品边界，传明细报错）**。走 saveNListConfig `config.searchConditions.groupFilters`（视图级明文） |
 | `e10-cli form nlist apply <objId> <appId> <listId> <template>` | 配置**列表式视图**（台账）的显示列：模板是二维数组（行 → 列），列项可绑表单字段（`fieldId`）或做**自定义文本**列（不给 `fieldId`、给 `html`，里面用 `{{字段名}}` 插入表单字段）。自动读移动端槽位一并写入。`show` 查看当前配置。⚠ 仅对列表式(NList)生效，表格式用 `form table-view`。详见 `form/guide-list-custom-text.md` |
 | `e10-cli form nlist add-field\|remove-field <objId> <appId> <listId> <fieldId...> [--form-id <id>]` | **增量**改列表式/卡片视图显示字段：追加的字段各占一行，移除时同时清 `listField` 与 `cardLayout.grid`；已有布局原样保留（不重建模板）。隐藏主键 `id=5` 恒保留。PC 与移动端一次提交，两端回读 |
 | `e10-cli form view list <objId> <appId> [--with-comps]` | 列出表单全部视图。`--with-comps` 额外拉每个视图布局 comps 数、标出空视图（NList 数据视图会显示「读取失败」，正常） |
-| `e10-cli form view rename <objId> <appId> <viewId> <新名称>` | 修改视图名称并回读。**表单视图与台账各走一条接口**（台账与卡片视图走 `viewlist/buttonEvent` 的编辑动作，报文 `viewType` 分别为 `nListView`/`cardView`；其余视图走 `layout/rename`），命令按类型自动选。保留原视图 ID 和配置。需求名称与默认名称不一致时统一用此命令，不新建重复视图 |
+| `e10-cli form view rename <objId> <appId> <viewId> <新名称>` | 修改视图名称并回读。**只有 `formView` 走 `layout/rename`；cardView / 台账 / 看板 / 日历 / 思维导图 / 多维等全部走 `viewlist/buttonEvent` 的编辑动作**。`viewType` 有两套词汇：台账 `getViewlist` 里是 `NList`，`buttonEvent` 只认 `nListView`（命令自动归一）；其余原样透传真实类型（日历、看板传成 `nListView` 会 500）。删除同规则，且删除后回读会做有限次重试（平台异步删除）。保留原视图 ID 和配置 |
 | `e10-cli form view delete <objId> <appId> <viewId>` | 删除视图（表单视图 / 台账 / **卡片视图** / 看板等，按类型自动选接口；台账与卡片视图走 `viewlist/buttonEvent`）。⚠ **不可逆、无回收站**。先回读定位目标，删完**再回读确认确实没了**才算成功 |
-| `e10-cli form view create <objId> <appId> <视图名> [--type formView\|cardView\|kanbanView\|calendarView\|mindMapView\|multiView] [--terminal PC\|MOBILE] [--layout-type FLOW\|EXCEL] [--detail <明细名>] [--sub-form-id <明细subFormId>]` | 给**已有表单**添加视图。`formView` 创建后是空布局，需续跑 `form view populate` 填字段；`cardView` 走精简 body（不带 layoutType），创建后必须在 `cardView.detail` 回读到，否则报错提示抓 createView 报文；`kanbanView`/`calendarView`/`mindMapView`/`multiView` 建视图实体。**multiView 数据维度**：缺省主表；明细表维度用 `--detail <明细名>`（按名解析）或 `--sub-form-id <明细subFormId>`（直传），传值即明细维度（`subFormMain:true`）。**台账(NList)视图**用 `form table-view create`，不在此命令 |
+| `e10-cli form view create <objId> <appId> <视图名> [--type formView\|cardView\|kanbanView\|calendarView\|mindMapView\|multiView] [--terminal PC\|MOBILE] [--layout-type FLOW\|EXCEL] [--detail <明细名>] [--sub-form-id <明细subFormId>]` | 给**已有表单**添加视图。`formView` 创建后是空布局，需续跑 `form view populate` 填字段；`cardView` 走精简 body（**不带 terminalType / layoutType**，带 terminalType 会平台 500），创建后必须在 `cardView.detail` 回读到，否则报错提示抓 createView 报文；cardView 不能挂设计器组件（数字面板等），需要组件请用 EB 页面或台账的列表式/卡片布局；`kanbanView`/`calendarView`/`mindMapView`/`multiView` 建视图实体。**multiView 数据维度**：缺省主表；明细表维度用 `--detail <明细名>`（按名解析）或 `--sub-form-id <明细subFormId>`（直传），传值即明细维度（`subFormMain:true`）。**台账(NList)视图**用 `form table-view create`，不在此命令 |
 | `e10-cli form view populate <objId> <appId> <viewId>` | 把已有字段按布局类型填入 formView。视图为空则整份填；**视图已有字段时只补缺**——只补视图里还没有的字段，已有组件的排版与属性一个不动（重跑幂等）。表单新增字段后要让它出现在某个视图里，也走这条 |
 | `e10-cli form message list <appId> [--obj-id <objId>] [--keyword <kw>] [--page-size <n>] [--page-index <n>]` | 列出**消息提醒**（表单数据变动时提醒人）。不传 `--obj-id` 列出整个应用的；传了**在本地按表单收口**（平台那条过滤参数不生效）。详见 `references/form/guide-form-message.md` |
 | `e10-cli form message get <appId> <triggerId> [--obj-id <objId>]` | 查看单条消息提醒，含**推送渠道**与提醒对象。渠道不在列表与详情返回里，命令额外读一次补上 |
@@ -762,3 +762,21 @@ e10-cli workflow action list-node <wf> <nodeId>
 普通页面源码：`designer source read <pageId> --terminal pc|mobile [--out file]`；`designer source check --js-file page.js --css-file page.css` 离线检查；`designer source set <pageId> --terminal pc|mobile --js-file page.js --css-file page.css [--apply]` 默认预览，`--clear-js/--clear-css` 显式清空；`designer source sdk [--query 方法名] [--id 接口ID] [--out file]` 查询接口文档。见 [页面源码指南](../ebuilder-designer/page-source/page-source-guide.md) 及 [完整 SDK 索引](../ebuilder-designer/page-source/sdk-index.md)。
 
 页面事件：`designer event schema` 查询动作及码表；`get/set/enable/remove <pageId> [--comp id] [--collection name --item id] --terminal pc|mobile|both` 定位页面、组件或子项；写命令使用 `--trigger CLICK|DIDMOUNT`，`set --config @action.json` 替换唯一动作，`enable --value true|false` 启停，`--apply` 保存。`lookup --kind page|esb|logic|device|person|sign --id id` 读取资源；`condition-create <pageId> --comp id --where-file file [--apply]` 独立创建刷新过滤条件。完整配置见 [事件指南](../ebuilder-designer/events/guide-events.md)。
+
+组件权限：`designer permission schema/lookup/get/fields` 查询本入口配置、组织对象及来源字段；`common add/update/remove/clear <pageId> --comp id --scope use|disabled --terminal pc|mobile` 配置普通范围；`matrix add/update/remove/clear` 配置矩阵/EB表单相关使用范围。增改用 `--config @file`，修改删除用最新 `--rule shareKey|id`，默认预览，`--apply` 保存。完整方法见 [组件权限指南](../ebuilder-designer/component-permission.md)。
+
+移动端标签栏：`designer tabbar schema/get/set/add/update/remove/order`。菜单事件用 `designer event --collection items --item id --terminal mobile`；详见 [标签栏指南](../ebuilder-designer/guide-tabbar.md)。
+
+列表高级配置：`designer list advanced get/fields/set <pageId> --comp id --terminal pc|mobile`，set 使用 `--config @file [--apply]`；行点击事件使用 `designer event --trigger CLICKDATA`。见 [列表高级配置](../ebuilder-designer/guide-list.md)。
+
+列表交互设置：`designer list controls filter/order/search/button`，各组 --help 查看动作；按钮事件使用 `designer event --collection listButtons --item id`。见 [列表搜索与按钮指南](../ebuilder-designer/guide-list.md)。
+
+列表展示：`designer list advanced presentation <pageId> --comp id --terminal pc|mobile --config @file [--apply]`。见 [列表展示指南](../ebuilder-designer/guide-list.md)。
+
+列表运行设置：`designer list advanced runtime <pageId> --comp id --terminal pc|mobile --config @file [--apply]`，分页、刷新、滚动、无数据展示、预加载、延迟加载及视图切换，见 [统一列表指南](../ebuilder-designer/guide-list.md)。
+
+自定义页面组件：`designer custom-page schema/get/targets/content/title/button/rule/visibility/config`；写入指定 `--comp`、`--terminal pc|mobile`、`--config @file [--apply]`。帮助事件使用 `designer event --collection customPageButtons --item id --trigger CLICK`。详见 [自定义页面组件](../ebuilder-designer/guide-custom-page.md)。
+
+事件顺序动作与递归条件：`designer event set --config @sequence.json` 使用 `{actions:[...]}` 或 `{nativeActions:[...]}`；`designer event action add/update/remove/enable/order`、`branch add/update/remove/enable/order` 支持按 ID 和 `--parent` 编辑；候选用 `event fields/targets` 查询。见 [事件指南](../ebuilder-designer/events/guide-events.md)。
+
+普通页面管理：`page rename <pageId> --name ... [--apply]`、`page copy <pageId> --name ... [--group-id id] [--apply]`、`page transfer <pageId> --app-id ... [--apply]`；`page groups/transfer-targets --app-id ...` 查询候选。`page delete <pageIds...>` 保留默认直接执行方式，`--preview` 只预览。详见 [普通页面管理](../ebuilder-designer/guide-page-management.md)。

package/skill-docs/references/components/ref-component-common.md

@@ -1,98 +1,98 @@
-# 组件通用属性与样式
-
-> 适用 `@weapp/ui` 全部组件：属性与样式这部分是共通的，单看这一份即可。组件各自的专有属性见同目录下的组件文档。
-
-## 一、每个组件都有的属性（BaseProps）
-
-| 属性 | 类型 | 说明 |
-|---|---|---|
-| `className` | string | 挂到组件根节点，用来加自己的样式作用域 |
-| `style` | CSSProperties | 合并到组件根节点的行内样式 |
-| `customRender` | `(ctx, element) => ReactNode` | 包一层或整体替换组件的渲染结果 |
-| `overlayClassName` | string | 浮层样式名。**只有部分组件实现**（Radio / Checkbox / Menu / At / BreadCrumb 等），用前确认该组件是否支持 |
-| `prefixCls` | string | class 前缀。**不要用来改样式**：less 里的前缀是编译期写死的，改它只会换类名，样式表仍指向 `.ui-*` |
-| `weaComId` | string | 组件标识，一般不用 |
-| `children` | ReactNode | 子节点 |
-
-`customRender` 的第一个参数是组件实例，用来读取组件状态；返回的节点会**直接替代**原渲染结果，所以包裹时记得把 `element` 放回去：
-
-```jsx
-<Browser
-  module="hrm"
-  type="resource"
-  customRender={function (ctx, element) {
-    return <div className="my-browser-wrap">{element}</div>;
-  }}
-/>
-```
-
-## 二、表单类组件的通用属性（FormProps）
-
-表单类组件（Input / Select / Checkbox / Radio / Switch / Upload / Browser 等）在 BaseProps 之外还有：
-
-| 属性 | 类型 | 说明 |
-|---|---|---|
-| `readOnly` | boolean | 只读，只显示值、不加载输入工具 |
-| `disabled` | boolean | 禁用 |
-| `required` | boolean | 必填 |
-| `passport` | boolean | 加密显示为 `********` |
-| `placeholder` | string | 占位提示 |
-| `rule` | string \| function | 校验规则 |
-| `showRequiredMark` | boolean | 是否显示必填标记 |
-| `fieldId` / `fieldName` | string \| number | 隐藏域标识 |
-
-## 三、样式：四层钩子
-
-按可靠性从高到低，优先用上面的：
-
-| 层 | 手段 | 作用范围 |
-|---|---|---|
-| 变量层 | 在**页面根节点**重声明 CSS 变量（`--primary` 等） | 整个页面子树 |
-| 组件根层 | `className` / `style` | 组件根节点 |
-| 内容层 | `customRender` / 组件的 `bodyRender`、`customRenderItem` | 组件内部指定位置 |
-| 浮层专用 | `overlayClassName`、组件的弹层属性（如 `browserDialogProps`） | 该组件的弹层 |
-
-```jsx
-// 页面根节点声明变量，只影响这个页面
-<div className="my-page" style={{ '--primary': '#2f6fed', '--border-radius-md': '8px' }}>
-  ...
-</div>
-```
-
-**不要把变量写在 `:root` 上** —— 那会改掉整个平台的样式。
-
-## 四、浮层不在页面 DOM 里
-
-弹窗、下拉这类浮层通过 Portal 挂到 `body` 下的 `.ui-dialog-portal`：
-
-- 页面根节点上声明的 CSS 变量和后代选择器**都够不到浮层**；
-- 部分组件的弹层会继承组件上的 `className`（例如 Browser 把属性透传给内部 Dialog），所以同一个 className 有时会同时命中根节点和弹层；
-- 需要单独控制弹层时，用该组件的弹层属性或 `overlayClassName`，不要靠 DOM 层级猜；
-- 层级由变量控制：`--dialog-zindex`、`--popover-zindex`、`--modal-zindex`、`--toast-zindex`、`--picker-zindex` 等。
-
-## 五、常用 CSS 变量
-
-| 类别 | 变量 |
-|---|---|
-| 主色与状态色 | `--primary`、`--success`、`--warning`、`--danger`、`--info` |
-| 文字色 | `--main-fc`、`--regular-fc`、`--secondary-fc`、`--placeholder-fc`、`--link-fc` |
-| 背景 | `--bg-white`、`--bg-base`、`--bg-weak`、`--bg-gray` |
-| 边框与圆角 | `--border-color`、`--diviling-line-color`、`--border-solid`、`--border-radius-xs/sm/md/lg` |
-| 间距 | `--h-spacing-xs/sm/md/lg/xl`、`--v-spacing-xs/sm/md/lg/xl` |
-| 字号与行高 | `--font-size-sm/md/lg/base/heading`、`--line-height-base`、`--line-height-sm` |
-| 密度 | `--hd`（1px 换算单位，组件按它缩放） |
-
-## 六、不要做的事
-
-- 不用 `.ui-browser__xxx` 这类**内部 class** 覆盖样式，也不读 `weId`、不依赖 DOM 层级 —— 平台升级就会断；
-- 不改 `prefixCls` 指望换一套样式；
-- 不把 CSS 变量写到 `:root` 或 `body`；
-- 不编造组件或 props，列表见 `guide-page-code.md` 第六节。
-
-## 七、自检
-
-- [ ] 组件根节点上的样式走 `className` / `style`，没有去写内部 class
-- [ ] CSS 变量声明在页面根节点，没有写到 `:root`
-- [ ] 需要改弹层时用了组件的弹层属性，没有去猜 DOM 结构
-- [ ] `customRender` 包裹时把 `element` 渲染回去了
-- [ ] 没有依赖 `prefixCls` 改样式
+# 组件通用属性与样式
+
+> 适用 `@weapp/ui` 全部组件：属性与样式这部分是共通的，单看这一份即可。组件各自的专有属性见同目录下的组件文档。
+
+## 一、每个组件都有的属性（BaseProps）
+
+| 属性 | 类型 | 说明 |
+|---|---|---|
+| `className` | string | 挂到组件根节点，用来加自己的样式作用域 |
+| `style` | CSSProperties | 合并到组件根节点的行内样式 |
+| `customRender` | `(ctx, element) => ReactNode` | 包一层或整体替换组件的渲染结果 |
+| `overlayClassName` | string | 浮层样式名。**只有部分组件实现**（Radio / Checkbox / Menu / At / BreadCrumb 等），用前确认该组件是否支持 |
+| `prefixCls` | string | class 前缀。**不要用来改样式**：less 里的前缀是编译期写死的，改它只会换类名，样式表仍指向 `.ui-*` |
+| `weaComId` | string | 组件标识，一般不用 |
+| `children` | ReactNode | 子节点 |
+
+`customRender` 的第一个参数是组件实例，用来读取组件状态；返回的节点会**直接替代**原渲染结果，所以包裹时记得把 `element` 放回去：
+
+```jsx
+<Browser
+  module="hrm"
+  type="resource"
+  customRender={function (ctx, element) {
+    return <div className="my-browser-wrap">{element}</div>;
+  }}
+/>
+```
+
+## 二、表单类组件的通用属性（FormProps）
+
+表单类组件（Input / Select / Checkbox / Radio / Switch / Upload / Browser 等）在 BaseProps 之外还有：
+
+| 属性 | 类型 | 说明 |
+|---|---|---|
+| `readOnly` | boolean | 只读，只显示值、不加载输入工具 |
+| `disabled` | boolean | 禁用 |
+| `required` | boolean | 必填 |
+| `passport` | boolean | 加密显示为 `********` |
+| `placeholder` | string | 占位提示 |
+| `rule` | string \| function | 校验规则 |
+| `showRequiredMark` | boolean | 是否显示必填标记 |
+| `fieldId` / `fieldName` | string \| number | 隐藏域标识 |
+
+## 三、样式：四层钩子
+
+按可靠性从高到低，优先用上面的：
+
+| 层 | 手段 | 作用范围 |
+|---|---|---|
+| 变量层 | 在**页面根节点**重声明 CSS 变量（`--primary` 等） | 整个页面子树 |
+| 组件根层 | `className` / `style` | 组件根节点 |
+| 内容层 | `customRender` / 组件的 `bodyRender`、`customRenderItem` | 组件内部指定位置 |
+| 浮层专用 | `overlayClassName`、组件的弹层属性（如 `browserDialogProps`） | 该组件的弹层 |
+
+```jsx
+// 页面根节点声明变量，只影响这个页面
+<div className="my-page" style={{ '--primary': '#2f6fed', '--border-radius-md': '8px' }}>
+  ...
+</div>
+```
+
+**不要把变量写在 `:root` 上** —— 那会改掉整个平台的样式。
+
+## 四、浮层不在页面 DOM 里
+
+弹窗、下拉这类浮层通过 Portal 挂到 `body` 下的 `.ui-dialog-portal`：
+
+- 页面根节点上声明的 CSS 变量和后代选择器**都够不到浮层**；
+- 部分组件的弹层会继承组件上的 `className`（例如 Browser 把属性透传给内部 Dialog），所以同一个 className 有时会同时命中根节点和弹层；
+- 需要单独控制弹层时，用该组件的弹层属性或 `overlayClassName`，不要靠 DOM 层级猜；
+- 层级由变量控制：`--dialog-zindex`、`--popover-zindex`、`--modal-zindex`、`--toast-zindex`、`--picker-zindex` 等。
+
+## 五、常用 CSS 变量
+
+| 类别 | 变量 |
+|---|---|
+| 主色与状态色 | `--primary`、`--success`、`--warning`、`--danger`、`--info` |
+| 文字色 | `--main-fc`、`--regular-fc`、`--secondary-fc`、`--placeholder-fc`、`--link-fc` |
+| 背景 | `--bg-white`、`--bg-base`、`--bg-weak`、`--bg-gray` |
+| 边框与圆角 | `--border-color`、`--diviling-line-color`、`--border-solid`、`--border-radius-xs/sm/md/lg` |
+| 间距 | `--h-spacing-xs/sm/md/lg/xl`、`--v-spacing-xs/sm/md/lg/xl` |
+| 字号与行高 | `--font-size-sm/md/lg/base/heading`、`--line-height-base`、`--line-height-sm` |
+| 密度 | `--hd`（1px 换算单位，组件按它缩放） |
+
+## 六、不要做的事
+
+- 不用 `.ui-browser__xxx` 这类**内部 class** 覆盖样式，也不读 `weId`、不依赖 DOM 层级 —— 平台升级就会断；
+- 不改 `prefixCls` 指望换一套样式；
+- 不把 CSS 变量写到 `:root` 或 `body`；
+- 不编造组件或 props，列表见 `guide-page-code.md` 第六节。
+
+## 七、自检
+
+- [ ] 组件根节点上的样式走 `className` / `style`，没有去写内部 class
+- [ ] CSS 变量声明在页面根节点，没有写到 `:root`
+- [ ] 需要改弹层时用了组件的弹层属性，没有去猜 DOM 结构
+- [ ] `customRender` 包裹时把 `element` 渲染回去了
+- [ ] 没有依赖 `prefixCls` 改样式

package/skill-docs/references/ebuilder-designer/component-permission.md

@@ -0,0 +1,131 @@
+# 页面组件权限
+
+## 功能介绍
+
+组件权限控制页面内单个组件的使用范围，以及使用范围内的禁用范围。普通范围按人员、部门、分部、角色、岗位等组织对象授权；矩阵相关范围从矩阵或 EB 表单的数据中取得人员，可进一步筛选来源数据。
+
+页面整体使用权限使用 `page permission`；组件权限使用 `designer permission`。列表的数据权限决定可读取哪些数据，不能用组件隐藏或禁用代替数据权限。事件中的显示/隐藏动作也独立于组件权限。
+
+配置入口是普通页面设计器中选中组件后的权限设置。PC 与移动端分别维护，两个终端组件 ID 不相同。命令每次指定一个终端，另一终端需用其组件 ID 单独配置。
+
+## 命令与配置流程
+
+```sh
+e10-cli designer permission schema
+e10-cli designer permission lookup --type department --id <departmentId>
+e10-cli designer permission get <pageId> --comp <compId> --terminal pc
+e10-cli designer permission fields <pageId> --source-type matrix --source-id <matrixId>
+e10-cli designer permission fields <pageId> --source-type ebuilder_form --source-id <objId>
+e10-cli designer permission common add <pageId> --comp <compId> --scope use --config @permission.json
+e10-cli designer permission common add <pageId> --comp <compId> --scope use --config @permission.json --apply
+```
+
+先读取组件和配置表，再查询真实对象/来源字段，生成配置，预览后添加 `--apply` 保存。配置参数支持内联 JSON 或 `@文件`，文件更适合复杂条件。
+
+普通规则提供 `common add/update/remove/clear`，`--scope use|disabled`，默认 `use`。矩阵及表单规则提供 `matrix add/update/remove/clear`，仅用于使用范围。所有写命令均支持 `--terminal pc|mobile`，默认 `pc`。
+
+修改或删除普通规则用 `--rule <shareKey>`；矩阵规则用 `--rule <id>`，未保存草稿可使用 `uuid`。ID 必须取自最新 `get` 或保存返回值。平台可能重建规则 ID，不能长期缓存旧 ID。
+
+`update` 未提供的属性保留原值；主体类型更换需删除原行再新增。`clear` 只清空指定范围，不清空其他范围。空范围是撤销该项限制，不能当作拒绝所有人的表达式；实际展示还受页面权限及组件行为影响。
+
+## 普通范围
+
+| `type` | 含义 | 对象 ID |
+|---|---|---|
+| `resource` | 人员 | 人员 ID |
+| `department` | 部门 | 部门 ID |
+| `subcompany` | 分部 | 分部 ID |
+| `role` | 角色 | 角色 ID |
+| `position` | 岗位 | 岗位 ID |
+| `all` | 所有人 | 省略 |
+| `allExternal` | 所有外部人 | 省略 |
+
+群组使用 `type: "group"` 和群组 ID；指定外部联系人使用 `type: "external"` 和外部联系人 ID。两者均可配置普通使用范围或禁用范围。群组基础权限类型为 `1411`，外部联系人为 `110`。每个入口仍读取自身 schema，仅在该入口提供此主体类型时允许新增。
+
+普通配置的可用属性如下；仅向对应主体传入属性。
+
+| 属性 | 说明 |
+|---|---|
+| `id` | 单个真实对象 ID；对象名称由浏览接口取得 |
+| `attributes` | 部门、分部：`subordinate` 包含下级、`include_superior` 含上级、`partTimeStaff` 包含兼职；传 `[]` 清空 |
+| `roleLevel` | 角色：`4` 所有级别、`3` 分部及总部、`0` 总部、`1` 分部、`2` 部门 |
+| `positionLevel` | 岗位：`1` 总部、`2` 指定分部、`3` 指定部门 |
+| `subcompanies` | 岗位级别为 `2` 时必填，分部 ID 数组 |
+| `departments` | 岗位级别为 `3` 时必填，部门 ID 数组 |
+| `positionAttributes` | 岗位：`partTimeStaff` 包含兼职；传 `[]` 清空 |
+| `security` | 安全级别 `{ "min": 0, "max": 100 }`；需环境启用并符合范围 |
+
+`subordinate` 与 `include_superior` 不能同时设置；可各自与 `partTimeStaff` 组合。
+
+`schema` 返回本组件权限入口的可用主体、附加选项、安全级别能力和 `disableAll`。不能拿组合页签或页面整体权限的选项替代。禁用所有人仅在 `disableAll=true` 时允许；所有外部人可用于禁用范围。
+
+```json
+{
+  "type": "position",
+  "id": "<positionId>",
+  "positionLevel": "3",
+  "departments": ["<departmentId>"],
+  "positionAttributes": ["partTimeStaff"]
+}
+```
+
+## 矩阵及 EB 表单相关范围
+
+一条规则包含来源 `source`、取值 `values` 和可选筛选条件 `condition`。来源为矩阵时使用矩阵 ID；来源为 EB 表单时使用 objId，不是 formId、布局 ID 或组件 ID。
+
+```json
+{
+  "source": { "type": "matrix", "id": "<matrixId>" },
+  "values": [
+    { "field": "<ownerColumnId>", "relation": "SELF" },
+    { "field": "<assistantColumnId>", "relation": "IMMEDIATE_SUPERIOR" }
+  ],
+  "condition": {
+    "logic": "and",
+    "children": [
+      { "field": "<departmentColumnId>", "operator": "eq", "value": [{ "id": "<departmentId>", "name": "部门名称" }] }
+    ]
+  }
+}
+```
+
+表单来源写为 `{"type":"ebuilder_form","id":"<objId>"}`，其他结构相同。`fields` 返回可用取值列和条件字段，不能任意使用目标页面字段。
+
+取值当前开放人员类型字段：`SELF` 本人、`IMMEDIATE_SUPERIOR` 直接上级、`IMMEDIATE_SUBORDINATE` 直接下属。同一字段可选择多个关系，也可选择多个取值字段。`values` 至少一行。更换来源时同时重新提供 `values` 和 `condition`；`condition:null` 撤销筛选，省略则保留原筛选。
+
+## 筛选条件
+
+条件组使用 `{"logic":"and|or","children":[...]}`，可混合嵌套；最多 12 层、500 个节点。叶子为 `{"field":"字段ID","operator":"操作符","value":值}`。单个叶子自动包装为 AND 组。
+
+| 操作 | 写入码 | 可用别名 |
+|---|---|---|
+| 等于 | `eq` | `eq` |
+| 不等于 | `neq` | `notEq` |
+| 属于 | `aggregate` | `in` |
+| 不属于 | `unaggregate` | `notIn` |
+| 为空 | `empty` | `isNull` |
+| 不为空 | `nempty` | `isNotNull` |
+
+人员、部门、分部的固定值为真实浏览对象数组，包括 `eq`、`neq`，例如 `[{"id":"<id>","name":"显示名称"}]`。文本及当前支持的 Ebuilder 条件值为字符串。为空/不为空省略 `value`，不接受右侧值。数值、日期及其他尚未开放的取值协议会报错，不能以任意 JSON 绕过。`fieldRef` 字段引用简写暂不开放。
+
+角色级别修改同时更新原生级别镜像，岗位级别变更同时更新机构取值并清除旧级别机构；命令自动处理这些字段，无需手工拼装。部门、分部及岗位的原生权限类型会随附加属性变化，不能固定复用读取到的 `permissionTargetType`。
+
+原生保存树使用 `relationship:"0"` 表示 AND、`"1"` 表示 OR；与页面事件条件码表不同。命令使用 `and/or` 自动转换。权限条件的值形状应按本入口字段处理，不能从其他浏览范围配置推断。
+
+## 保存与回读
+
+普通范围位于组件 `config.rights`，禁用范围位于 `config.disableRights`，矩阵及表单范围位于 `config.matrixRights`。矩阵的人员关系和筛选树在原生协议中分别序列化为 `matrixValueRelation`、`matrixConditionData`。
+
+命令读取完整布局，在局部修改权限后保存，保留另一终端、其他组件、事件、源码及原布局元数据。页面已有软锁或预检期间发生变化时停止覆盖。保存后重新读取，比较对象、级别、组织属性、安全范围及矩阵条件等授权含义，同时检查无关内容。平台生成的规则 ID、时间和对象展示元数据不作为失败依据。不要自行重算 `rightCompIds`。
+
+平台回读成功表示配置保存完整。组件是否可见、是否可操作还需要使用对应身份在前台检查；管理员设计器预览不能替代不同身份下的使用效果检查。
+
+群组与指定外部联系人：普通权限配置使用 `{"type":"group","id":"<groupId>"}` 或 `{"type":"external","id":"<externalId>"}`，适用于使用范围和禁用范围。以当前入口 schema 的可用类型为准；对象由当前入口浏览接口解析，不能跨环境复用 ID。
+
+群组的权限主体码为 `group`，浏览对象接口类型为 `channel`；外部联系人两处均为 `external`。CLI 自动转换浏览类型，不要将主体码直接拼成群组浏览接口。
+
+## 部门与分部对象解析
+
+组件使用范围、禁用范围、`designer permission lookup`、岗位指定部门/分部以及列表按钮 `--subjects` 复用同一个对象解析入口。优先读取 `/api/ebuilder/designer/common/browser/destData/{department|subcompany}`；请求失败、业务失败或未唯一匹配目标时，依次使用 HRM 通用 `destData` 和 HRM `data` 分页列表，按真实 ID 精确匹配。列表结果转换为权限需要的浏览对象，不能用名称代替 ID。
+
+仅部门、分部使用该兜底；人员、角色、岗位主体、群组及外部联系人的解析失败仍报原错误。岗位主体本身与岗位级别中的部门/分部分别查询。列表扫描受账号可见范围影响，默认每页 200 条、最多 100 页；所有路径都查不到时明确报错，不伪造对象写入。PC 与移动端复用同一解析方法，终端的权限保存分别维护。