yida-form-permission

表单权限配置

适用范围

用户要求查询或修改表单权限组、成员范围、数据范围、操作权限或字段权限时使用本技能。

当前 CLI 只查询和保存 FORM_PACKAGE_VIEW 权限组。平台模型还包含 FORM_PACKAGE_START，本技能不管理该类型。查询会按每页 20 条安全翻页；达到安全上限、分页重复或响应结构不完整时 fail-closed，不把不完整列表当作全量结果。

铁律

1. 目标必须唯一：优先使用查询结果中的 packageUuid，通过 --package-uuid 精确更新；未提供 UUID 时才按 DEFAULT、MANAGER 或 MATRIX 匹配。匹配 0 个或多个、分页无法完整结束时停止。 packageUuid 只属于本次查询的 formUuid；多表单配置必须逐表查询，禁止跨表单复用。
2. 未知操作键必须保留：目标组的 operatePermit 包含 CLI 白名单外键时，停止 action-permission 修改；修改其他维度时原样保留整个 operatePermit。
3. 成员替换必须展示损失：执行 --all-members 或 --matrix 前展示完整 roleData before/after 和会移除的 DEPARTMENT、ROLE、PARAM、MANAGER 等条目。CLI 要求确认时，用户确认后追加 --confirm-member-replace。
4. 整块保存必须先确认：action-permission 会整块替换为 operations 中值为 true 的白名单键；执行前展示完整 before/after。
5. 平台状态是真相源：本技能不使用 memory 保存权限状态；CLI 保存前完整查询、只写一次，保存后按 packageUuid 精确回读。目标维度不一致或非目标维度漂移时报 verify failed；无法恢复 create UUID、精确目标暂不可见或回读失败时报 verify unknown，两者都不得宣称成功或直接重放写入。

标准流程

1. 查询：运行 openyida get-permission <appType> <formUuid>，记录目标组名称、packageUuid 和四个权限维度。
2. 差异预览：输出明确的 before 与 after；未修改的 roleData、dataPermit、operatePermit、fieldPermit 标记为“保持原值”。
3. 确认：向用户确认唯一目标、成员损失、操作权限整块替换和数据范围变化。
4. 写入：只传需要修改的维度，更新时追加 --package-uuid <packageUuid>，执行一次 save-permission。
5. 重查验证：CLI 会自动按 packageUuid 做 canonical readback，并返回 verification.status=verified 才算成功；Agent 可再用精确查询复核。failed 或 unknown 时停止且不重放。

新增权限组也先查询现有配置并展示新组的完整 after，再确认、写入和重查。

命令

查询全部查看权限组，或按 packageUuid 精确过滤：

openyida get-permission <appType> <formUuid>
openyida get-permission <appType> <formUuid> --package-uuid <packageUuid>

更新唯一权限组：

openyida save-permission <appType> <formUuid> --package-uuid <packageUuid> [选项]

选项	作用
--package-uuid <packageUuid>	精确选择已有权限组；不能与 --create 同时使用
--data-permission <json>	修改 dataPermit；顶层可带 role 选择目标组
--action-permission <json>	整块替换 operatePermit；顶层可带 role
--field-permission <json>	修改真实 fieldPermit；顶层可带 role
--members <userIds>	替换 PERSONS 条目并保留其他 roleData 条目
--all-members	把成员维度替换为 DEFAULT/ALL
--matrix <json>	把成员维度替换为指定矩阵；与 --members、--all-members 互斥
--confirm-member-replace	确认会删除复合 roleData 的成员替换