页面
system.page.* 管理租户自定义首页配置,并为适用成员提供已发布页面。操作流程参见 自定义页面。
查询配置
system.page.list 需要页面访问权限,结果包含状态、资产与适用范围。
sl system page list --keyword shop --limit 20 --json
sl system page list --keyword shop --limit 20 --cursor '<nextCursor>' --json
keyword 可选,最多 200 字符;limit 为 1–100,默认 20。使用返回的原始 nextCursor 翻页,保持筛选条件一致。
创建与编辑
system.page.create 和 system.page.update 需要页面访问及页面管理权限。使用 system.studio.asset.list/get 查询页面资产 UUID,使用组织或角色命令查询主体 UUID。必须选择 Studio 页面资产,不能使用脚本资产或文件 UUID。
创建 page.json:
{
"name": "访客商城",
"description": "购物首页",
"assetId": "<studio-page-asset-uuid>",
"scopes": [
{ "subjectType": "ROLE", "subjectId": "<role-uuid>" }
]
}
sl system page create --definition-file ./page.json --json
sl system page update --page-id '<page-uuid>' --definition-file ./page.json --json
两个命令均从 --definition-json 与 --definition-file 中二选一。
| 字段 | 约束 |
|---|---|
name | 必填,去除首尾空格后 1–200 字符 |
description | 可选,可为 null,最多 2000 字符 |
assetId | 必填,Studio 页面资产 UUID |
scopes | 必填,完整的 1–500 个不重复 {subjectType,subjectId} 数组 |
subjectType | MEMBER、DEPARTMENT、ORGANIZATION 或 ROLE |
subjectId | 所选主体 UUID |
创建后默认 停用。编辑完整替换所有可编辑字段与适用范围,保留启停状态。两个命令均不会发布 Studio 资产。初始管理员始终不生效,通过角色、部门或组织间接命中也不例外。
启用、停用和删除
system.page.status.update 和 system.page.delete 需要页面管理权限。
sl system page status update --page-id '<page-uuid>' --status active --json
sl system page status update --page-id '<page-uuid>' --status inactive --json
sl system page delete --page-id '<page-uuid>' --json
状态仅支持 active 或 inactive。启用中的页面不能删除;删除保留 Studio 资产。配置启用且资产已发布时才会替换成员首页。多个启用且已发布的页面同时适用时,按 created_at 降序、ID 降序选择首个。
查询当前成员适用页面
system.page.home.get 无输入参数,返回 {page: ...} 或 {page: null}。查询当前登录成员适用的启用且已发布首页,不授予管理权限。
sl system page home get --json
system.page.applicability.get 检查指定配置是否适用于当前成员,返回 {pageId, applicable}。该检查要求配置启用并命中范围,不要求资产已经发布,因此不能据此判断页面已可运行。
sl system page applicability get --page-id '<page-uuid>' --json
获取运行页面与执行动作
system.page.runtime.get 加载适用页面的已发布运行内容。system.page.action.execute 以当前成员权限执行该已发布版本声明的动作。
sl system page runtime get --page-id '<page-uuid>' --json
sl system page action execute --page-id '<page-uuid>' --definition-file ./action.json --json
action.json 示例:
{
"versionId": "<current-published-version-uuid>",
"actionName": "getCurrentUser",
"payload": {}
}
versionId 必须为当前已发布版本 UUID。actionName 必须为已声明动作名,长度 1–64,以字母开头,后续允许字母、数字和下划线。payload 为可选对象,默认 {}。发布新版本后重新获取运行内容,不能继续使用旧版本。草稿源码、调用者伪造的身份及管理权限均不能替代当前成员的数据权限。