yida-form-permission

name: yida-form-permission description: 宜搭表单权限组管理。查询、新增权限组，配置成员/数据权限/操作权限/字段权限。不适用于：配置页面公开访问分享（应使用 yida-page-config），或配置流程审批节点的字段权限（应使用 yida-process-rule）。

表单权限配置

严格禁止 (NEVER DO)

• 不要在未查询现有权限组的情况下直接创建新权限组（先用 get-permission 查询）
• 字段权限使用 --field-permission 透传宜搭 fieldPermit JSON；修改前必须先 get-permission 查看当前结构
• 不要使用自定义部门或自定义过滤条件（不支持）

严格要求 (MUST DO)

• 修改权限前先用 openyida get-permission 查询现有配置
• action-permission 为完全替换模式，只保留 true 的项，操作前确认影响范围
• 本技能不读写 memory：权限配置通过 CLI 命令写入宜搭平台，不依赖跨会话的 memory 状态

适用场景

用户需要"配置权限"、"设置数据权限"、"添加权限组"、"控制谁能看/改/删数据"时使用。

触发条件

正向触发：

• "配置权限"、"设置数据权限"
• "添加权限组"、"控制谁能看/改/删数据"
• "设置成员权限"、"配置操作权限"、"配置字段权限"

不适用场景（不要触发）：

• 配置流程节点的字段权限（NORMAL/READONLY/HIDDEN）→ yida-process-rule 的 formConfig
• 修改表单字段结构 → yida-create-form-page
• 流程节点中的字段权限（NORMAL/READONLY/HIDDEN）→ yida-process-rule 的 formConfig

危险操作确认

修改 action-permission 会完全替换现有操作权限配置，执行前必须：

1. 展示当前权限配置
2. 展示修改后的权限配置
3. 等待用户确认

查询权限组

openyida get-permission <appType> <formUuid>

更新权限组

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

数据权限 dataRange 可选值

操作权限 key

OPERATE_VIEW、OPERATE_EDIT、OPERATE_DELETE、OPERATE_HISTORY、OPERATE_COMMENT、OPERATE_PRINT、OPERATE_CREATE、OPERATE_BATCH_EDIT、OPERATE_BATCH_EXPORT、OPERATE_BATCH_IMPORT、OPERATE_BATCH_DELETE、OPERATE_BATCH_PRINT、OPERATE_BATCH_DOWNLOAD、OPERATE_BATCH_DOWNLOAD_QRCODE

新增权限组

openyida save-permission <appType> <formUuid> --create --name <名称> [选项]

示例：

openyida save-permission APP_XXX FORM-XXX \
  --create --name "部门数据查看组" \
  --members "54255850977641" \
  --data-permission '{"dataRange":"ORIGINATOR_DEPARTMENT"}' \
  --action-permission '{"operations":{"OPERATE_VIEW":true}}' \
  --field-permission '{"fieldRange":"FORM"}'

字段权限

• 默认结构通常是 { "fieldRange": "FORM" }，表示继承表单设计中组件状态。
• 需要自定义字段权限时，先执行 openyida get-permission <appType> <formUuid> 获取现有权限组中的 fieldPermit，在此基础上修改后传给 --field-permission。
• 更新已有权限组时可在 JSON 顶层带 role，例如 {"role":"DEFAULT","fieldPermit":{"fieldRange":"FORM"}}。

限制

• 不支持自定义部门和自定义过滤条件

异常处理

Agent 错误处理策略

当 Agent 执行本技能遇到错误时，必须遵循以下默认行为：