功能权限矩阵

页面、功能和按钮需要开启的 feature、permission 与 roleName。

本文整理每个功能、页面、按钮需要开启的功能开关和权限。除特别说明外：

• 多个 feature 同时出现时，需要全部开启。
• 多个 permission 或 roleName 同时出现时，通常命中任意一个即可访问。
• 页面入口、按钮显示和后端操作权限可能分层控制；实际可用性以页面内按钮权限和后端权限共同决定。
• roleName 指平台角色名时，可取：SUPER_ADMIN、ADMIN、AI_BUILDER、ANALYTICS_BUILDER、VIEWER、TRIAL。

​

主导航

功能 / 页面	路径	需要开启的 feature	需要的 permission / roleName	说明
Chat	/chat	FEATURE_XPERT	CHAT_VIEW	Chat 入口显示需要同时满足 feature 与权限。
Explore Xperts	/explore	FEATURE_XPERT	XPERT_EDIT	用于浏览/探索 Xpert。
Xpert Workspace	/xpert	FEATURE_XPERT	XPERT_EDIT	进入工作区后，具体读写还受 workspace 能力控制。
Story	/story	无显式主导航开关	STORIES_VIEW	当前入口不在主导航中，但页面访问需要故事查看权限。
Data	/data	子功能分别控制	MODELS_EDIT 或 STORIES_EDIT	父级 Data 至少需要模型编辑或故事编辑之一。
Data / Project	/data/project	FEATURE_PROJECT	STORIES_EDIT	BI 项目入口。
Data / Semantic Model	/data/models	FEATURE_MODEL	MODELS_EDIT	语义模型入口和建模操作。
Indicator App	/indicator-app	FEATURE_INDICATOR + FEATURE_INDICATOR_APP	INDICATOR_MARTKET_VIEW	指标应用入口。
Settings	/settings	FEATURE_SETTING	无统一入口权限	设置页内部每个菜单单独控制。

​

Chat 与智能体

功能 / 页面 / 按钮	路径或入口	需要开启的 feature	需要的 permission / roleName	说明
Common Assistant	/chat/x/common	入口继承 FEATURE_XPERT	入口继承 CHAT_VIEW	通用聊天助手。
ClawXpert	/chat/clawxpert	FEATURE_XPERT + FEATURE_XPERT_CLAWXPERT	无额外 permission	两个 feature 都开启后可进入。
ChatBI	/chat/chatbi	FEATURE_XPERT + FEATURE_XPERT_CHATBI	无额外 permission	两个 feature 都开启后可进入。
Chat 侧边栏 ChatBI	Chat 侧边栏	FEATURE_XPERT_CHATBI	无额外 permission	仅控制入口显示。
Chat 侧边栏 CodeXpert	Chat 侧边栏	FEATURE_XPERT_CODEXPERT	无额外 permission	外链入口。
Chat 侧边栏 DeepResearch	Chat 侧边栏	FEATURE_XPERT_DEEP_RESEARCH	无额外 permission	外链入口。
Change Settings 按钮	Common Assistant 欢迎页	无额外 feature	SUPER_ADMIN 或 ADMIN	跳转到 Assistants 设置。
Common Assistant 配置	Assistants 设置	FEATURE_XPERT	页面入口需要 SUPER_ADMIN 或 ADMIN	系统级助手配置。
Workspace Assistant 配置	Assistants 设置	FEATURE_XPERT	页面入口需要 SUPER_ADMIN 或 ADMIN	Xpert 工作区共享助手配置。
ChatBI Assistant 配置	Assistants 设置	FEATURE_XPERT + FEATURE_XPERT_CHATBI	页面入口需要 SUPER_ADMIN 或 ADMIN	ChatBI 助手配置。
ClawXpert Assistant 配置	用户级 ClawXpert 绑定	FEATURE_XPERT + FEATURE_XPERT_CLAWXPERT	用户级配置	不在系统级 assistant 列表中。

​

设置页

功能 / 页面	路径	需要开启的 feature	需要的 permission / roleName	说明
Account	/settings/account	无	无	个人账户设置。
AI Copilot	/settings/copilot	FEATURE_COPILOT	COPILOT_EDIT	Copilot 基础配置、示例、用量、用户等。
Data Sources	/settings/data-sources	FEATURE_MODEL	DATA_SOURCE_EDIT	数据源设置入口。
Assistants	/settings/assistants	FEATURE_XPERT	SUPER_ADMIN 或 ADMIN	租户默认配置仅 SUPER_ADMIN 可编辑；组织覆盖配置需要已选择组织。
Chat BI	/settings/chatbi	FEATURE_XPERT + FEATURE_MODEL	MODELS_EDIT	ChatBI 模型设置。
Business Area	/settings/business-area	FEATURE_BUSINESS_AREA	BUSINESS_AREA_EDIT	业务域设置。
Certification	/settings/certification	无	入口显示需要 CERTIFICATION_EDIT；页面访问还依赖 BUSINESS_AREA_EDIT	当前实际需要同时关注这两个权限。
System Integration	/settings/integration	FEATURE_INTEGRATION	INTEGRATION_EDIT	集成列表、新建、查看、编辑。
Users	/settings/users	FEATURE_USER	ALL_ORG_VIEW / ALL_ORG_EDIT / ORG_USERS_VIEW / ORG_USERS_EDIT 任一	用户列表入口；按钮再细分。
Groups	/settings/groups	FEATURE_USER	查看：ORG_USERS_VIEW；编辑：ORG_USERS_EDIT	用户组列表和维护。
Roles	/settings/roles	FEATURE_ROLES_PERMISSION	CHANGE_ROLES_PERMISSIONS	角色与权限维护。
Feature	/settings/features/tenant、/settings/features/organization	无	页面入口：CHANGE_ROLES_PERMISSIONS；读取功能：ALL_ORG_VIEW；更新开关：ALL_ORG_EDIT	租户和组织功能开关维护。
Organizations	/settings/organizations	无	ALL_ORG_VIEW / ALL_ORG_EDIT / ORG_USERS_VIEW / ORG_USERS_EDIT 任一	组织列表和组织详情；按钮再细分。
Email Template	/settings/email-templates	FEATURE_EMAIL_TEMPLATE	VIEW_ALL_EMAIL_TEMPLATES	邮件模板管理。
Custom SMTP	/settings/custom-smtp	FEATURE_SMTP	CUSTOM_SMTP_VIEW	租户或组织 SMTP 配置。
Plugins	/settings/plugins	无	SUPER_ADMIN 或 ADMIN 或 TRIAL	插件设置入口。
Tenant	/settings/tenant	无	SUPER_ADMIN	租户设置、租户技能、租户标签。

​

设置页按钮与操作

功能 / 页面	按钮或操作	需要开启的 feature	需要的 permission / roleName	说明
Users	Batch Import	FEATURE_USER	前端按钮：租户范围 + ALL_ORG_EDIT；实际导入：SUPER_ADMIN 或 ADMIN	批量导入用户。
Users	New	FEATURE_USER	租户范围 + ALL_ORG_EDIT	新建用户。
Users	Invite 按钮	FEATURE_USER	组织范围 + ORG_INVITE_VIEW 或 ORG_INVITE_EDIT	按钮显示条件；真正创建邀请需要 ORG_INVITE_EDIT。
Users	Invite 列表	FEATURE_USER	ORG_INVITE_VIEW 或 ORG_INVITE_EDIT	查看邀请记录。
Users	重发 / 删除邀请	FEATURE_USER	ORG_INVITE_EDIT	邀请维护操作。
Users	修改用户角色	FEATURE_USER	当前用户为 SUPER_ADMIN 或 ADMIN	编辑超级管理员用户还需要超级管理员相关保护权限。
Organizations	新建组织	无	租户范围 + ALL_ORG_EDIT	新建组织。
Organizations	删除组织	无	租户范围 + ALL_ORG_EDIT	删除组织。
Organizations	保存组织基础信息	无	已选组织 + ALL_ORG_EDIT	保存名称、描述、状态等。
Organizations	上传组织头像	无	已选组织 + ALL_ORG_EDIT	修改组织头像。
Organizations	治理字段	无	租户范围 + ALL_ORG_EDIT	currency、timezone、default date 等治理字段。
Organizations	Members 编辑	无	已选组织 + ALL_ORG_EDIT 或 ORG_USERS_EDIT	组织成员维护。
Organizations	Generate Demo	无	前端按钮：已选组织 + ALL_ORG_EDIT；实际生成：SUPER_ADMIN 或 ADMIN 或 TRIAL	生成或刷新组织 demo 数据。
Assistants	租户默认 assistant 配置	FEATURE_XPERT + assistant 对应 feature	SUPER_ADMIN	租户默认助手配置。
Assistants	组织覆盖 assistant 配置	FEATURE_XPERT + assistant 对应 feature	页面入口 SUPER_ADMIN 或 ADMIN，并且已选择组织	组织级覆盖配置。
Xpert Workspace	保存工作区基础设置	FEATURE_XPERT	workspace.capabilities.canManage	不是枚举权限，由 workspace 能力决定。
Xpert Workspace	成员、可见性、删除、归档	FEATURE_XPERT	workspace.capabilities.canManage	owner 或具备管理能力的租户管理员才可操作。
Xpert 授权	组织列表范围	无	有 ALL_ORG_VIEW 可看所有组织；否则只看当前用户所属组织	影响数据范围，不是按钮权限。

​

BI 与数据功能

功能 / 页面 / 操作	需要开启的 feature	需要的 permission / roleName	说明
数据源列表查看	FEATURE_MODEL	DATA_SOURCE_VIEW	查看数据源列表。
数据源创建 / 编辑 / 删除	FEATURE_MODEL	DATA_SOURCE_EDIT	数据源维护。
数据源类型同步	无	SUPER_ADMIN 或 ADMIN	同步内置数据源类型。
语义模型入口	FEATURE_MODEL	MODELS_EDIT	/data/models 页面入口。
语义模型列表 API	FEATURE_MODEL	ADMIN	后端模型列表存在管理员角色限制。
语义模型 XMLA 查询	FEATURE_MODEL	MODELS_VIEW	还要求模型已开放 XMLA，且通过模型查看授权。
语义模型缓存清理	FEATURE_MODEL	MODELS_EDIT	删除模型缓存。
Project	FEATURE_PROJECT	STORIES_EDIT	/data/project 入口。
Story 查看	无显式主导航开关	STORIES_VIEW	/story 页面访问。
Story 编辑 / Project 能力	FEATURE_PROJECT	STORIES_EDIT	BI 项目和故事编辑能力。
Business Area 设置	FEATURE_BUSINESS_AREA	BUSINESS_AREA_EDIT	业务域维护。
Certification 设置	无	CERTIFICATION_EDIT + BUSINESS_AREA_EDIT 需共同关注	入口显示和页面访问权限当前分属两个权限。
Indicator App	FEATURE_INDICATOR + FEATURE_INDICATOR_APP	INDICATOR_MARTKET_VIEW	指标应用入口。
指标查看	FEATURE_INDICATOR	INDICATOR_VIEW	指标查看类能力。
指标编辑	FEATURE_INDICATOR	INDICATOR_EDIT	指标维护类能力。
Data Factory	FEATURE_DATA_FACTORY	DATA_FACTORY_VIEW / DATA_FACTORY_EDIT	当前主要是权限与 feature 枚举，入口使用情况需要结合具体页面。

​

AI 后端能力

功能 / 操作	需要开启的 feature	需要的 permission / roleName	说明
Copilot 创建、启用/禁用、更新	FEATURE_COPILOT	COPILOT_EDIT	Copilot 管理。
Copilot 统计	FEATURE_COPILOT	COPILOT_EDIT	对话、用户、消息、token 等统计。
Copilot Provider 创建 / 更新	FEATURE_COPILOT	COPILOT_EDIT	模型供应商配置。
Copilot User 列表 / renew	FEATURE_COPILOT	COPILOT_EDIT	Copilot 用户管理。
Knowledgebase 列表 / 统计	FEATURE_COPILOT_KNOWLEDGEBASE 或知识库入口所在功能	KNOWLEDGEBASE_EDIT	知识库编辑和统计。
Xpert 列表 / 下拉选项 / 统计	FEATURE_XPERT	XPERT_EDIT	Xpert 管理与统计。
Workspace 全量列表	FEATURE_XPERT	XPERT_EDIT	管理型 workspace 查询。
Workspace 读取	FEATURE_XPERT	workspace.capabilities.canRead	根据 owner/member、scope、tenant shared 等计算。
Workspace 运行	FEATURE_XPERT	workspace.capabilities.canRun	根据 workspace 能力计算。
Workspace 写入	FEATURE_XPERT	workspace.capabilities.canWrite	根据 workspace 能力计算。
Workspace 管理	FEATURE_XPERT	workspace.capabilities.canManage	成员、可见性、删除、归档等管理操作。
Agent view extension	FEATURE_XPERT	XPERT_EDIT	智能体视图扩展。
Sandbox view extension	FEATURE_XPERT	XPERT_EDIT	沙箱视图扩展。
Project view extension	FEATURE_XPERT	CHAT_VIEW 或 XPERT_EDIT	项目视图扩展。
Knowledgebase view extension	知识库相关功能	KNOWLEDGEBASE_EDIT	知识库视图扩展。

​

平台设置能力

功能 / 操作	需要开启的 feature	需要的 permission / roleName	说明
角色新增 / 修改 / 删除 / 恢复	FEATURE_ROLES_PERMISSION	CHANGE_ROLES_PERMISSIONS	角色维护。
角色权限启停	FEATURE_ROLES_PERMISSION	CHANGE_ROLES_PERMISSIONS	权限矩阵维护；SUPER_ADMIN 权限受保护。
Feature 查询	无	ALL_ORG_VIEW	查询租户/组织功能开关。
Feature 更新	无	ALL_ORG_EDIT	更新租户/组织功能开关。
Feature 升级	无	SUPER_ADMIN	系统级 feature 升级/补齐。
组织列表 / 分页 / 统计	无	ALL_ORG_VIEW 或 ALL_ORG_EDIT	租户级组织管理。
组织详情	无	ALL_ORG_VIEW / ALL_ORG_EDIT / ORG_USERS_VIEW / ORG_USERS_EDIT 任一	还受当前组织范围限制。
用户列表 / 分页 / 统计	FEATURE_USER	ALL_ORG_VIEW 或 ALL_ORG_EDIT	租户级用户管理。
用户搜索	FEATURE_USER	ORG_USERS_VIEW / ORG_USERS_EDIT / ALL_ORG_VIEW / ALL_ORG_EDIT 任一	搜索范围受组织上下文影响。
用户详情	FEATURE_USER	自己；或 PROFILE_EDIT / ORG_USERS_VIEW / ORG_USERS_EDIT / ALL_ORG_VIEW / ALL_ORG_EDIT 任一	非本人还需要通过组织范围校验。
用户创建 / 删除	FEATURE_USER	ALL_ORG_EDIT	租户级用户维护。
用户更新 / 重置密码	FEATURE_USER	自己可用 PROFILE_EDIT；管理他人需要 ALL_ORG_EDIT 或 SUPER_ADMIN_EDIT	超级管理员用户有额外保护。
删除全部用户数据	无	ACCESS_DELETE_ALL_DATA	高危操作。
用户组查看	FEATURE_USER	ORG_USERS_VIEW	用户组列表和详情。
用户组维护	FEATURE_USER	ORG_USERS_EDIT	新增、编辑、成员维护、删除。
邀请查看	FEATURE_USER	ORG_INVITE_VIEW 或 ORG_INVITE_EDIT	邀请列表。
邀请维护	FEATURE_USER	ORG_INVITE_EDIT	创建、重发、删除邀请。
集成维护	FEATURE_INTEGRATION	INTEGRATION_EDIT	系统集成。
邮件模板	FEATURE_EMAIL_TEMPLATE	VIEW_ALL_EMAIL_TEMPLATES	邮件模板页面。
SMTP	FEATURE_SMTP	CUSTOM_SMTP_VIEW	自定义 SMTP。
Tenant 设置	无	SUPER_ADMIN	租户级设置。
Plugins	无	SUPER_ADMIN 或 ADMIN 或 TRIAL	插件入口。

​

roleName 相关说明

使用场景	roleName 含义	影响
平台角色	SUPER_ADMIN、ADMIN、AI_BUILDER、ANALYTICS_BUILDER、VIEWER、TRIAL	控制页面入口、按钮显示和后端角色权限。
邀请用户	被邀请用户的目标平台角色	邀请创建本身需要 ORG_INVITE_EDIT。
CSV 批量导入用户	导入用户的目标平台角色	导入操作本身需要 SUPER_ADMIN 或 ADMIN。
SSO 登录	第三方登录/注册时的默认角色上下文	不直接等同于页面按钮权限。
飞书登录	飞书配置中的默认角色上下文	不直接等同于页面按钮权限。
语义模型 / OLAP	模型查询角色或 Mondrian role	这是模型访问角色，不是平台 RolesEnum。
语义模型访问控制	模型内部 role name	控制模型数据访问，不是平台导航权限。
插件用户权限	插件默认用户角色	插件权限上下文使用。